Criar androidForWorkCompliancePolicy
Namespace: microsoft.graph
Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; a utilização de produção não é suportada.
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 .
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government 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. |
| Application | 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 do pedido, forneça uma representação JSON para o objeto androidForWorkCompliancePolicy.
A tabela seguinte mostra as propriedades necessárias quando cria o androidForWorkCompliancePolicy.
| Propriedade | Tipo | Descrição |
|---|---|---|
| roleScopeTagIds | String collection | Lista de Etiquetas de Âmbito 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 carateres na palavra-passe. Os valores possíveis são: deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex, any. |
| requiredPasswordComplexity | androidRequiredPasswordComplexity | Indica a complexidade necessária da palavra-passe do dispositivo no Android. Um de: NENHUM, BAIXO, MÉDIO, ALTO. Esta é uma nova API direcionada para a API Android 12 e superior. 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 início de sessão permitidas antes da reposição de fábrica. Valores válidos de 1 a 16 |
| workProfilePasswordExpirationInDays | Int32 | Número de dias antes de a palavra-passe do perfil de trabalho expirar. Valores válidos de 1 a 365 |
| workProfilePasswordMinimumLength | Int32 | Comprimento mínimo da palavra-passe 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 palavras-passe de perfil de trabalho anteriores a bloquear. Valores válidos de 0 a 24 |
| workProfilePasswordRequiredType | androidForWorkRequiredPasswordType | Tipo de palavra-passe 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 necessária da palavra-passe do perfil de trabalho no Android. Um de: NENHUM, BAIXO, MÉDIO, ALTO. Esta é uma nova API direcionada para o Android 12+. Os valores possíveis são: none, low, medium, high. |
| workProfileRequirePassword | Booliano | A palavra-passe é 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 | Exigir que o dispositivo transmita a integridade básica da Integridade da Reprodução marcar. |
| securityRequireSafetyNetAttestationCertifiedDevice | Booliano | Exigir que o dispositivo transmita a marcar integridade do dispositivo da Integridade da Reprodução. |
| 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 | Exigir um tipo de avaliação SafetyNet específico para conformidade. Os valores possíveis são: basic e hardwareBacked. |
Resposta
Se for bem-sucedido, este método devolve 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"
}