Criar androidForWorkCompliancePolicy

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para o uso de produção.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Crie um novo objeto androidForWorkCompliancePolicy .

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA L5 (DOD) China operada pela 21Vianet

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) DeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

POST /deviceManagement/deviceCompliancePolicies

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Aceitar application/json

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON para o objeto androidForWorkCompliancePolicy.

A tabela a seguir mostra as propriedades necessárias ao criar o androidForWorkCompliancePolicy.

Propriedade Tipo Descrição
roleScopeTagIds String collection Lista de Marcas de Escopo para esta instância de Entidade. Herdada de deviceCompliancePolicy
id String Chave da entidade. Herdada de deviceCompliancePolicy
createdDateTime DateTimeOffset DateTime em que o objeto foi criado. Herdada de deviceCompliancePolicy
description String O administrador forneceu a descrição da Configuração do dispositivo. Herdada de deviceCompliancePolicy
lastModifiedDateTime DateTimeOffset DateTime da última modificação do objeto. Herdada de deviceCompliancePolicy
displayName String O administrador forneceu o nome da Configuração do dispositivo. Herdada de deviceCompliancePolicy
version Int32 Versão da configuração do dispositivo. Herdada de deviceCompliancePolicy
passwordRequired Boolean Exige uma senha para desbloquear o dispositivo.
passwordMinimumLength Int32 Comprimento mínimo da senha. Valores válidos de 4 a 16
passwordRequiredType androidRequiredPasswordType Tipo de caracteres em senha. Os valores possíveis são: deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex, any.
requiredPasswordComplexity androidRequiredPasswordComplexity Indica a complexidade de senha do dispositivo necessária no Android. Um deles: NONE, LOW, MEDIUM, HIGH. Esta é uma nova API direcionada para a API do Android 12+. Os valores possíveis são: none, low, medium, high.
passwordMinutesOfInactivityBeforeLock Int32 Minutos de inatividade antes que uma senha seja necessária.
passwordExpirationDays Int32 Número de dias antes da expiração da senha. Valores válidos de 1 a 365
passwordPreviousPasswordBlockCount Int32 Número de senhas anteriores para bloquear. Valores válidos de 1 a 24
passwordSignInFailureCountBeforeFactoryReset Int32 Número de falhas de entrada permitidas antes da redefinição de fábrica. Valores válidos de 1 a 16
workProfilePasswordExpirationInDays Int32 Número de dias antes da expiração da senha do perfil de trabalho. Valores válidos de 1 a 365
workProfilePasswordMinimumLength Int32 Tamanho mínimo da senha do perfil de trabalho. Valores válidos de 4 a 16
workProfileInactiveBeforeScreenLockInMinutes Int32 Minutos de inatividade antes que a tela atinja o tempo limite.
workProfilePreviousPasswordBlockCount Int32 Número de senhas de perfil de trabalho anteriores a serem bloqueadas. Valores válidos de 0 a 24
workProfilePasswordRequiredType androidForWorkRequiredPasswordType Tipo de senha de perfil de trabalho que é necessária. Os valores possíveis são: deviceDefault, lowSecurityBiometric, required, atLeastNumeric, numericComplex, atLeastAlphabetic, atLeastAlphanumeric, alphanumericWithSymbols.
workProfileRequiredPasswordComplexity androidRequiredPasswordComplexity Indica a complexidade de senha do perfil de trabalho necessária no Android. Um deles: NONE, LOW, MEDIUM, HIGH. Essa é uma nova API direcionada ao Android 12+. Os valores possíveis são: none, low, medium, high.
workProfileRequirePassword Booliano A senha é necessária ou não para o perfil de trabalho
securityPreventInstallAppsFromUnknownSources Boolean Exige que os dispositivos não permitam a instalação de aplicativos de origens desconhecidas.
securityDisableUsbDebugging Boolean Desabilite a depuração USB em dispositivos Android.
securityRequireVerifyApps Boolean Exige que o recurso de verificação de aplicativos Android esteja ativado.
deviceThreatProtectionEnabled Boolean Exige que os dispositivos tenham habilitada a proteção contra ameaças.
deviceThreatProtectionRequiredSecurityLevel deviceThreatProtectionLevel Exige o nível mínimo de risco de Proteção contra Ameaças Móveis para indicar falta de conformidade. Os valores possíveis são: unavailable, secured, low, medium, high, notSet.
securityBlockJailbrokenDevices Boolean Os dispositivos não devem ser violados ou com modificações root.
osMinimumVersion String Versão mínima do Android.
osMaximumVersion String Versão máxima do Android.
minAndroidSecurityPatchLevel String Nível mínimo de patch de segurança Android.
storageRequireEncryption Boolean Exige criptografia em dispositivos Android.
securityRequireSafetyNetAttestationBasicIntegrity Booliano Exija que o dispositivo passe o marcar de integridade básica do Play Integrity.
securityRequireSafetyNetAttestationCertifiedDevice Booliano Exija que o dispositivo passe o marcar de integridade do dispositivo Play Integrity.
securityRequireGooglePlayServices Boolean Exige que os Google Play Services sejam instalados e habilitados no dispositivo.
securityRequireUpToDateSecurityProviders Boolean Exige que o dispositivo tenha provedores de segurança atualizados. O dispositivo exigirá que os Google Play Services sejam habilitados e atualizados.
securityRequireCompanyPortalAppIntegrity Boolean Exige que o dispositivo passe na verificação de integridade de tempo de execução de aplicativo cliente do Portal da Empresa.
securityRequiredAndroidSafetyNetEvaluationType androidSafetyNetEvaluationType Exija um tipo de avaliação safetynet específico para conformidade. Os valores possíveis são: basic e hardwareBacked.

Resposta

Se for bem-sucedido, esse método retornará um 201 Created código de resposta e um objeto androidForWorkCompliancePolicy no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

POST https://graph.microsoft.com/beta/deviceManagement/deviceCompliancePolicies
Content-type: application/json
Content-length: 1735

{
  "@odata.type": "#microsoft.graph.androidForWorkCompliancePolicy",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "passwordRequired": true,
  "passwordMinimumLength": 5,
  "passwordRequiredType": "alphabetic",
  "requiredPasswordComplexity": "low",
  "passwordMinutesOfInactivityBeforeLock": 5,
  "passwordExpirationDays": 6,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "workProfilePasswordExpirationInDays": 3,
  "workProfilePasswordMinimumLength": 0,
  "workProfileInactiveBeforeScreenLockInMinutes": 12,
  "workProfilePreviousPasswordBlockCount": 5,
  "workProfilePasswordRequiredType": "lowSecurityBiometric",
  "workProfileRequiredPasswordComplexity": "low",
  "workProfileRequirePassword": true,
  "securityPreventInstallAppsFromUnknownSources": true,
  "securityDisableUsbDebugging": true,
  "securityRequireVerifyApps": true,
  "deviceThreatProtectionEnabled": true,
  "deviceThreatProtectionRequiredSecurityLevel": "secured",
  "securityBlockJailbrokenDevices": true,
  "osMinimumVersion": "Os Minimum Version value",
  "osMaximumVersion": "Os Maximum Version value",
  "minAndroidSecurityPatchLevel": "Min Android Security Patch Level value",
  "storageRequireEncryption": true,
  "securityRequireSafetyNetAttestationBasicIntegrity": true,
  "securityRequireSafetyNetAttestationCertifiedDevice": true,
  "securityRequireGooglePlayServices": true,
  "securityRequireUpToDateSecurityProviders": true,
  "securityRequireCompanyPortalAppIntegrity": true,
  "securityRequiredAndroidSafetyNetEvaluationType": "hardwareBacked"
}

Resposta

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1907

{
  "@odata.type": "#microsoft.graph.androidForWorkCompliancePolicy",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "id": "a8d667bd-67bd-a8d6-bd67-d6a8bd67d6a8",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "displayName": "Display Name value",
  "version": 7,
  "passwordRequired": true,
  "passwordMinimumLength": 5,
  "passwordRequiredType": "alphabetic",
  "requiredPasswordComplexity": "low",
  "passwordMinutesOfInactivityBeforeLock": 5,
  "passwordExpirationDays": 6,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "workProfilePasswordExpirationInDays": 3,
  "workProfilePasswordMinimumLength": 0,
  "workProfileInactiveBeforeScreenLockInMinutes": 12,
  "workProfilePreviousPasswordBlockCount": 5,
  "workProfilePasswordRequiredType": "lowSecurityBiometric",
  "workProfileRequiredPasswordComplexity": "low",
  "workProfileRequirePassword": true,
  "securityPreventInstallAppsFromUnknownSources": true,
  "securityDisableUsbDebugging": true,
  "securityRequireVerifyApps": true,
  "deviceThreatProtectionEnabled": true,
  "deviceThreatProtectionRequiredSecurityLevel": "secured",
  "securityBlockJailbrokenDevices": true,
  "osMinimumVersion": "Os Minimum Version value",
  "osMaximumVersion": "Os Maximum Version value",
  "minAndroidSecurityPatchLevel": "Min Android Security Patch Level value",
  "storageRequireEncryption": true,
  "securityRequireSafetyNetAttestationBasicIntegrity": true,
  "securityRequireSafetyNetAttestationCertifiedDevice": true,
  "securityRequireGooglePlayServices": true,
  "securityRequireUpToDateSecurityProviders": true,
  "securityRequireCompanyPortalAppIntegrity": true,
  "securityRequiredAndroidSafetyNetEvaluationType": "hardwareBacked"
}