REST Resource: enterprises.policies

Risorsa: criterio

Una risorsa criterio rappresenta un gruppo di impostazioni che regolano il comportamento di un dispositivo gestito e delle app installate.

Rappresentazione JSON
{
  "name": string,
  "version": string,
  "applications": [
    {
      object (ApplicationPolicy)
    }
  ],
  "maximumTimeToLock": string,
  "screenCaptureDisabled": boolean,
  "cameraDisabled": boolean,
  "keyguardDisabledFeatures": [
    enum (KeyguardDisabledFeature)
  ],
  "defaultPermissionPolicy": enum (PermissionPolicy),
  "persistentPreferredActivities": [
    {
      object (PersistentPreferredActivity)
    }
  ],
  "openNetworkConfiguration": {
    object
  },
  "systemUpdate": {
    object (SystemUpdate)
  },
  "accountTypesWithManagementDisabled": [
    string
  ],
  "addUserDisabled": boolean,
  "adjustVolumeDisabled": boolean,
  "factoryResetDisabled": boolean,
  "installAppsDisabled": boolean,
  "mountPhysicalMediaDisabled": boolean,
  "modifyAccountsDisabled": boolean,
  "safeBootDisabled": boolean,
  "uninstallAppsDisabled": boolean,
  "statusBarDisabled": boolean,
  "keyguardDisabled": boolean,
  "minimumApiLevel": integer,
  "statusReportingSettings": {
    object (StatusReportingSettings)
  },
  "bluetoothContactSharingDisabled": boolean,
  "shortSupportMessage": {
    object (UserFacingMessage)
  },
  "longSupportMessage": {
    object (UserFacingMessage)
  },
  "passwordRequirements": {
    object (PasswordRequirements)
  },
  "wifiConfigsLockdownEnabled": boolean,
  "bluetoothConfigDisabled": boolean,
  "cellBroadcastsConfigDisabled": boolean,
  "credentialsConfigDisabled": boolean,
  "mobileNetworksConfigDisabled": boolean,
  "tetheringConfigDisabled": boolean,
  "vpnConfigDisabled": boolean,
  "wifiConfigDisabled": boolean,
  "createWindowsDisabled": boolean,
  "networkResetDisabled": boolean,
  "outgoingBeamDisabled": boolean,
  "outgoingCallsDisabled": boolean,
  "removeUserDisabled": boolean,
  "shareLocationDisabled": boolean,
  "smsDisabled": boolean,
  "unmuteMicrophoneDisabled": boolean,
  "usbFileTransferDisabled": boolean,
  "ensureVerifyAppsEnabled": boolean,
  "permittedInputMethods": {
    object (PackageNameList)
  },
  "stayOnPluggedModes": [
    enum (BatteryPluggedMode)
  ],
  "recommendedGlobalProxy": {
    object (ProxyInfo)
  },
  "setUserIconDisabled": boolean,
  "setWallpaperDisabled": boolean,
  "choosePrivateKeyRules": [
    {
      object (ChoosePrivateKeyRule)
    }
  ],
  "alwaysOnVpnPackage": {
    object (AlwaysOnVpnPackage)
  },
  "frpAdminEmails": [
    string
  ],
  "deviceOwnerLockScreenInfo": {
    object (UserFacingMessage)
  },
  "dataRoamingDisabled": boolean,
  "locationMode": enum (LocationMode),
  "networkEscapeHatchEnabled": boolean,
  "bluetoothDisabled": boolean,
  "complianceRules": [
    {
      object (ComplianceRule)
    }
  ],
  "blockApplicationsEnabled": boolean,
  "installUnknownSourcesAllowed": boolean,
  "debuggingFeaturesAllowed": boolean,
  "funDisabled": boolean,
  "autoTimeRequired": boolean,
  "permittedAccessibilityServices": {
    object (PackageNameList)
  },
  "appAutoUpdatePolicy": enum (AppAutoUpdatePolicy),
  "kioskCustomLauncherEnabled": boolean,
  "androidDevicePolicyTracks": [
    enum (AppTrack)
  ],
  "skipFirstUseHintsEnabled": boolean,
  "privateKeySelectionEnabled": boolean,
  "encryptionPolicy": enum (EncryptionPolicy),
  "usbMassStorageEnabled": boolean,
  "permissionGrants": [
    {
      object (PermissionGrant)
    }
  ],
  "playStoreMode": enum (PlayStoreMode),
  "setupActions": [
    {
      object (SetupAction)
    }
  ],
  "passwordPolicies": [
    {
      object (PasswordRequirements)
    }
  ],
  "policyEnforcementRules": [
    {
      object (PolicyEnforcementRule)
    }
  ],
  "kioskCustomization": {
    object (KioskCustomization)
  },
  "advancedSecurityOverrides": {
    object (AdvancedSecurityOverrides)
  },
  "personalUsagePolicies": {
    object (PersonalUsagePolicies)
  },
  "autoDateAndTimeZone": enum (AutoDateAndTimeZone),
  "oncCertificateProviders": [
    {
      object (OncCertificateProvider)
    }
  ],
  "crossProfilePolicies": {
    object (CrossProfilePolicies)
  },
  "preferentialNetworkService": enum (PreferentialNetworkService),
  "usageLog": {
    object (UsageLog)
  },
  "cameraAccess": enum (CameraAccess),
  "microphoneAccess": enum (MicrophoneAccess),
  "deviceConnectivityManagement": {
    object (DeviceConnectivityManagement)
  },
  "deviceRadioState": {
    object (DeviceRadioState)
  },
  "credentialProviderPolicyDefault": enum (CredentialProviderPolicyDefault),
  "printingPolicy": enum (PrintingPolicy)
}
Campi
name

string

Il nome del criterio nel modulo enterprises/{enterpriseId}/policies/{policyId}.

version

string (int64 format)

La versione del criterio. Questo è un campo di sola lettura. La versione viene incrementata ogni volta che il criterio viene aggiornato.

applications[]

object (ApplicationPolicy)

Criterio applicato alle app. Può contenere al massimo 3000 elementi.

maximumTimeToLock

string (int64 format)

Tempo massimo in millisecondi per l'attività utente fino al blocco del dispositivo. Il valore 0 indica che non ci sono restrizioni.

screenCaptureDisabled

boolean

Indica se l'acquisizione schermo è disattivata.

cameraDisabled
(deprecated)

boolean

Se cameraAccess è impostato su un valore diverso da CAMERA_ACCESS_UNSPECIFIED, ciò non ha alcun effetto. In caso contrario, questo campo controlla se le videocamere sono disattivate: se il valore è true, tutte le videocamere sono disattivate, altrimenti sono disponibili. Per i dispositivi completamente gestiti, questo campo si applica a tutte le app sul dispositivo. Per i profili di lavoro, questo campo si applica solo alle app al suo interno e l'accesso alla fotocamera per le app esterne al profilo non è interessato.

keyguardDisabledFeatures[]

enum (KeyguardDisabledFeature)

Disattivate le personalizzazioni di blocco tastiera, ad esempio i widget.

defaultPermissionPolicy

enum (PermissionPolicy)

Il criterio di autorizzazione predefinito per le richieste di autorizzazione di runtime.

persistentPreferredActivities[]

object (PersistentPreferredActivity)

Attività del gestore di intent predefinito.

openNetworkConfiguration

object (Struct format)

Configurazione di rete del dispositivo. Per ulteriori informazioni, consulta la sezione Configurazione delle reti.

systemUpdate

object (SystemUpdate)

Il criterio di aggiornamento del sistema, che controlla come vengono applicati gli aggiornamenti del sistema operativo. Se il tipo di aggiornamento è WINDOWED, la finestra di aggiornamento verrà applicata automaticamente anche agli aggiornamenti dell'app Google Play.

accountTypesWithManagementDisabled[]

string

Tipi di account che non possono essere gestiti dall'utente.

addUserDisabled

boolean

Indica se l'aggiunta di nuovi utenti e profili è disabilitata.

adjustVolumeDisabled

boolean

Indica se la regolazione del volume principale è disattivata. Viene inoltre disattivato l'audio del dispositivo.

factoryResetDisabled

boolean

Indica se il ripristino dei dati di fabbrica dalle impostazioni è disabilitato.

installAppsDisabled

boolean

Indica se l'installazione delle app da parte dell'utente è disattivata.

mountPhysicalMediaDisabled

boolean

Indica se l'utente che monta supporti esterni fisici è disabilitato.

modifyAccountsDisabled

boolean

Indica se l'aggiunta o la rimozione di account è disattivata.

safeBootDisabled
(deprecated)

boolean

Indica se il riavvio del dispositivo in Avvio protetto è disabilitato.

uninstallAppsDisabled

boolean

Indica se la disinstallazione utente delle applicazioni è disabilitata. Questo impedisce la disinstallazione delle app, anche quelle rimosse utilizzando applications

statusBarDisabled
(deprecated)

boolean

Indica se la barra di stato è disattivata. Vengono disattivati le notifiche, le impostazioni rapide e altri overlay sullo schermo che consentono di uscire dalla modalità a schermo intero. OBSOLETO. Per disattivare la barra di stato su un dispositivo kiosk, utilizza InstallType KIOSK o kioskCustomLauncherEnabled.

keyguardDisabled

boolean

Se il valore è true, viene disattivata la schermata di blocco per i display principali e/o secondari.

minimumApiLevel

integer

Il livello API Android minimo consentito.

statusReportingSettings

object (StatusReportingSettings)

Impostazioni dei report sullo stato

bluetoothContactSharingDisabled

boolean

Indica se la condivisione dei contatti Bluetooth è disattivata.

shortSupportMessage

object (UserFacingMessage)

Un messaggio visualizzato all'utente nella schermata delle impostazioni qualora la funzionalità sia stata disattivata dall'amministratore. Se supera i 200 caratteri, il messaggio potrebbe essere troncato.

longSupportMessage

object (UserFacingMessage)

Un messaggio mostrato all'utente nella schermata delle impostazioni degli amministratori del dispositivo.

passwordRequirements
(deprecated)

object (PasswordRequirements)

Requisiti per le password. Il campo passwordRequirements.require_password_unlock non deve essere impostato. OBSOLETO - Utilizza passwordPolicies.

Nota:

I valori di PasswordQuality basati sulla complessità, ovvero COMPLEXITY_LOW, COMPLEXITY_MEDIUM e COMPLEXITY_HIGH, non possono essere utilizzati qui. Impossibile utilizzare unifiedLockSettings qui.

wifiConfigsLockdownEnabled
(deprecated)

boolean

OBSOLETO - Utilizza wifiConfigDisabled.

bluetoothConfigDisabled

boolean

Indica se la configurazione del Bluetooth è disabilitata.

cellBroadcastsConfigDisabled

boolean

Indica se la configurazione di cell broadcast è disabilitata.

credentialsConfigDisabled

boolean

Indica se la configurazione delle credenziali utente è disabilitata.

mobileNetworksConfigDisabled

boolean

Indica se la configurazione delle reti mobili è disabilitata.

tetheringConfigDisabled
(deprecated)

boolean

Indica se la configurazione del tethering e di hotspot portatili è disabilitata. Se il criterio tetheringSettings viene impostato su un valore diverso da TETHERING_SETTINGS_UNSPECIFIED, questa impostazione viene ignorata.

vpnConfigDisabled

boolean

Indica se la configurazione della VPN è disabilitata.

wifiConfigDisabled
(deprecated)

boolean

Indica se la configurazione delle reti Wi-Fi è disabilitata. Funzionalità supportata sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda. Per i dispositivi completamente gestiti, l'impostazione di questa opzione su true rimuove tutte le reti configurate e conserva solo quelle configurate utilizzando openNetworkConfiguration. Per i profili di lavoro sui dispositivi di proprietà dell'azienda, le reti configurate esistenti non sono interessate e l'utente non può aggiungere, rimuovere o modificare le reti Wi-Fi. Se il criterio configureWifi viene impostato su un valore diverso da CONFIGURE_WIFI_UNSPECIFIED, questa impostazione viene ignorata. Nota:se non è possibile stabilire una connessione di rete al momento dell'avvio e la configurazione del Wi-Fi è disabilitata, verrà mostrato l'escape hatch di escape per aggiornare il criterio relativo ai dispositivi (vedi networkEscapeHatchEnabled).

createWindowsDisabled

boolean

Consente di indicare se la creazione di finestre oltre alle finestre delle app è disattivata.

networkResetDisabled

boolean

Indica se la reimpostazione delle impostazioni di rete è disattivata.

outgoingBeamDisabled

boolean

Consente di disattivare l'utilizzo della tecnologia NFC per trasmettere dati dalle app.

outgoingCallsDisabled

boolean

Indica se le chiamate in uscita sono disattivate.

removeUserDisabled

boolean

Indica se la rimozione di altri utenti è disattivata.

shareLocationDisabled

boolean

Indica se la Condivisione della posizione è disattivata. L'app shareLocationDisabled è supportata sia per i dispositivi completamente gestiti sia per i profili di lavoro personali.

smsDisabled

boolean

Indica se l'invio e la ricezione di SMS sono disattivati.

unmuteMicrophoneDisabled
(deprecated)

boolean

Se microphoneAccess è impostato su un valore diverso da MICROPHONE_ACCESS_UNSPECIFIED, ciò non ha alcun effetto. In caso contrario, questo campo consente di controllare se i microfoni sono disattivati: se il valore è true, tutti i microfoni sono disattivati, altrimenti saranno disponibili. Questa opzione è disponibile solo sui dispositivi completamente gestiti.

usbFileTransferDisabled
(deprecated)

boolean

Indica se il trasferimento di file tramite USB è disabilitato. Questa opzione è supportata solo sui dispositivi di proprietà dell'azienda.

ensureVerifyAppsEnabled
(deprecated)

boolean

Indica se la verifica delle app è attivata forzatamente.

permittedInputMethods

object (PackageNameList)

Se presenti, sono consentiti solo i metodi di inserimento forniti dai pacchetti in questo elenco. Se questo campo è presente, ma l'elenco è vuoto, sono consentiti solo i metodi di immissione di sistema.

stayOnPluggedModes[]

enum (BatteryPluggedMode)

La batteria collegata alle modalità per cui il dispositivo rimane acceso. Quando usi questa impostazione, ti consigliamo di cancellare maximumTimeToLock in modo che il dispositivo non si blocchi automaticamente mentre rimane acceso.

recommendedGlobalProxy

object (ProxyInfo)

Il proxy HTTP globale indipendente dalla rete. In genere i proxy devono essere configurati per rete in openNetworkConfiguration. Tuttavia, per configurazioni insolite come un filtro interno generale, può essere utile un proxy HTTP globale. Se il proxy non è accessibile, l'accesso alla rete potrebbe non funzionare. Il proxy globale è solo un suggerimento e alcune app potrebbero ignorarlo.

setUserIconDisabled

boolean

Indica se la modifica dell'icona utente è disattivata.

setWallpaperDisabled

boolean

Indica se la modifica dello sfondo è disabilitata.

choosePrivateKeyRules[]

object (ChoosePrivateKeyRule)

Regole per determinare l'accesso delle app alle chiavi private. Per ulteriori dettagli, consulta ChoosePrivateKeyRule. Questo campo deve essere vuoto se un'applicazione ha un ambito di delega CERT_SELECTION.

alwaysOnVpnPackage

object (AlwaysOnVpnPackage)

Configurazione per una connessione VPN sempre attiva. Utilizzalo con vpnConfigDisabled per impedire la modifica di questa impostazione.

frpAdminEmails[]

string

Indirizzi email degli amministratori del dispositivo per la protezione dal ripristino dei dati di fabbrica. Quando vengono ripristinati i dati di fabbrica, uno di questi amministratori dovrà accedere con l'indirizzo email e la password dell'Account Google per sbloccarlo. Se non viene specificato nessun amministratore, il dispositivo non fornirà la protezione dal ripristino dei dati di fabbrica.

deviceOwnerLockScreenInfo

object (UserFacingMessage)

Le informazioni del proprietario del dispositivo da mostrare nella schermata di blocco.

dataRoamingDisabled

boolean

Indica se i servizi di dati in roaming sono disattivati.

locationMode

enum (LocationMode)

Il livello di abilitazione del rilevamento della posizione.

networkEscapeHatchEnabled

boolean

Indica se l'escape hatch di rete è abilitato. Se non è possibile stabilire una connessione di rete al momento dell'avvio, l'escape hatch richiede all'utente di connettersi temporaneamente a una rete per aggiornare il criterio relativo ai dispositivi. Dopo l'applicazione del criterio, la rete temporanea verrà dimenticata e il dispositivo continuerà ad avviarsi. In questo modo non è possibile connettersi a una rete se non esiste una rete adatta nell'ultimo criterio e il dispositivo si avvia in un'app in modalità di blocco attività o se l'utente non riesce a raggiungere le impostazioni del dispositivo.

Nota: l'impostazione di wifiConfigDisabled su true sostituirà questa impostazione in circostanze specifiche. Consulta wifiConfigDisabled per ulteriori dettagli. Se imposti configureWifi su DISALLOW_CONFIGURING_WIFI, questa impostazione verrà ignorata in circostanze specifiche. Consulta DISALLOW_CONFIGURING_WIFI per ulteriori dettagli.

bluetoothDisabled

boolean

Indica se il Bluetooth è disattivato. Preferisci questa impostazione rispetto a bluetoothConfigDisabled perché bluetoothConfigDisabled può essere ignorato dall'utente.

complianceRules[]
(deprecated)

object (ComplianceRule)

Regole che dichiarano quali azioni di mitigazione intraprendere quando un dispositivo non è conforme alle sue norme. Se le condizioni per più regole sono soddisfatte, vengono intraprese tutte le azioni di mitigazione per le regole. Esiste un limite massimo di 100 regole. Utilizza invece le regole di applicazione dei criteri.

blockApplicationsEnabled
(deprecated)

boolean

Indica se l'installazione di applicazioni diverse da quelle configurate in applications è bloccata. Se questo criterio viene configurato, le applicazioni che erano installate in base a un criterio precedente, ma che non sono più visualizzate nel criterio, vengono disinstallate automaticamente.

installUnknownSourcesAllowed
(deprecated)

boolean

Questo campo non ha effetto.

debuggingFeaturesAllowed
(deprecated)

boolean

Indica se l'utente può attivare le funzionalità di debug.

funDisabled

boolean

Indica se l'utente è autorizzato a divertirsi. Consente di stabilire se disattivare o meno il gioco Easter egg nelle Impostazioni.

autoTimeRequired
(deprecated)

boolean

Indica se è richiesta l'ora automatica, che impedisce all'utente di impostare manualmente data e ora. Se viene impostato autoDateAndTimeZone, questo campo viene ignorato.

permittedAccessibilityServices

object (PackageNameList)

Specifica i servizi di accessibilità consentiti. Se il campo non viene configurato, è possibile utilizzare qualsiasi servizio di accessibilità. Se il campo viene configurato, possono essere utilizzati solo i servizi di accessibilità in questo elenco e il servizio di accessibilità integrato del sistema. In particolare, se il campo viene lasciato vuoto, possono essere utilizzati solo i servizi di accessibilità integrati del sistema. Questa opzione può essere impostata sui dispositivi completamente gestiti e sui profili di lavoro. Quando viene applicata a un profilo di lavoro, influisce sia sul profilo personale sia sul profilo di lavoro.

appAutoUpdatePolicy

enum (AppAutoUpdatePolicy)

Alternativa consigliata: l'autoUpdateMode, impostato per ogni app, offre una maggiore flessibilità in merito alla frequenza di aggiornamento.

Quando autoUpdateMode è impostato su AUTO_UPDATE_POSTPONED o AUTO_UPDATE_HIGH_PRIORITY, questo campo non ha effetto.

Il criterio di aggiornamento automatico delle app, che consente di stabilire quando è possibile applicare gli aggiornamenti automatici delle app.

kioskCustomLauncherEnabled

boolean

Indica se l'Avvio app kiosk personalizzato è attivo. La schermata Home viene sostituita con un'Avvio app che blocca il dispositivo per le app installate tramite l'impostazione applications. Le app vengono visualizzate in una singola pagina in ordine alfabetico. Utilizza kioskCustomization per configurare ulteriormente il comportamento del dispositivo kiosk.

androidDevicePolicyTracks[]
(deprecated)

enum (AppTrack)

Questa impostazione non è supportata. Qualsiasi valore viene ignorato.

skipFirstUseHintsEnabled

boolean

Segnala per saltare i suggerimenti al primo utilizzo. L'amministratore aziendale può attivare il suggerimento di sistema affinché le app ignorino il tutorial per gli utenti e altri suggerimenti introduttivi al primo avvio.

privateKeySelectionEnabled

boolean

Consente di mostrare la UI su un dispositivo per consentire a un utente di scegliere un alias di chiave privata se non esistono regole corrispondenti in ChoosePrivateKeyRules. Per i dispositivi con versioni precedenti ad Android P, l'impostazione di questa opzione potrebbe rendere vulnerabili le chiavi aziendali. Questo valore non avrà effetto se un'applicazione ha un ambito di delega CERT_SELECTION.

encryptionPolicy

enum (EncryptionPolicy)

Se la crittografia è abilitata

usbMassStorageEnabled
(deprecated)

boolean

Indica se l'archivio USB è abilitato. Deprecato.

permissionGrants[]

object (PermissionGrant)

Autorizzazioni esplicite o rifiuti di gruppi per tutte le app. Questi valori sostituiscono i defaultPermissionPolicy.

playStoreMode

enum (PlayStoreMode)

Questa modalità consente di stabilire quali app rendere disponibili per l'utente nel Play Store e il comportamento del dispositivo quando le app vengono rimosse dal criterio.

setupActions[]

object (SetupAction)

Azione da intraprendere durante la procedura di configurazione. È possibile specificare al massimo un'azione.

passwordPolicies[]

object (PasswordRequirements)

Criteri relativi ai requisiti delle password. È possibile impostare criteri diversi per il profilo di lavoro o per i dispositivi completamente gestiti impostando il campo passwordScope nel criterio.

policyEnforcementRules[]

object (PolicyEnforcementRule)

Regole che definiscono il comportamento quando un determinato criterio non può essere applicato sul dispositivo

kioskCustomization

object (KioskCustomization)

Impostazioni che controllano il comportamento di un dispositivo in modalità kiosk. Per attivare la modalità kiosk, imposta kioskCustomLauncherEnabled su true o specifica un'app nel criterio con installType KIOSK.

advancedSecurityOverrides

object (AdvancedSecurityOverrides)

Impostazioni di sicurezza avanzate. Nella maggior parte dei casi, queste impostazioni non sono necessarie.

personalUsagePolicies

object (PersonalUsagePolicies)

Criteri che gestiscono l'utilizzo personale su un dispositivo di proprietà dell'azienda.

autoDateAndTimeZone

enum (AutoDateAndTimeZone)

Indica se sono abilitati automaticamente data, ora e fuso orario su un dispositivo di proprietà dell'azienda. Se è impostato, autoTimeRequired viene ignorato.

oncCertificateProviders[]

object (OncCertificateProvider)

Questa funzionalità non è disponibile a livello generale.

crossProfilePolicies

object (CrossProfilePolicies)

Criteri di più profili applicati al dispositivo.

preferentialNetworkService

enum (PreferentialNetworkService)

Consente di stabilire se attivare o meno il servizio di rete preferito nel profilo di lavoro. Ad esempio, un'organizzazione potrebbe aver stipulato un contratto con un operatore secondo cui tutti i dati di lavoro provenienti dai dispositivi dei suoi dipendenti verranno inviati tramite un servizio di rete dedicato all'uso aziendale. Un esempio di servizio di rete preferenziale supportato è la sezione enterprise sulle reti 5G. Questa operazione non ha alcun effetto sui dispositivi completamente gestiti.

usageLog

object (UsageLog)

Configurazione del logging delle attività del dispositivo.

cameraAccess

enum (CameraAccess)

Consente di controllare l'utilizzo della videocamera e se l'utente ha accesso al pulsante di attivazione/disattivazione di accesso alla videocamera.

microphoneAccess

enum (MicrophoneAccess)

Consente di controllare l'utilizzo del microfono e se l'utente ha accesso all'opzione di attivazione/disattivazione di accesso al microfono. Si applica solo ai dispositivi completamente gestiti.

deviceConnectivityManagement

object (DeviceConnectivityManagement)

Include i controlli per la connettività dei dispositivi, ad esempio Wi-Fi, accesso ai dati USB, connessioni da tastiera/mouse e altro ancora.

deviceRadioState

object (DeviceRadioState)

Copre i controlli per lo stato della radio, come Wi-Fi, Bluetooth e altro.

credentialProviderPolicyDefault

enum (CredentialProviderPolicyDefault)

Consente di stabilire quali app possono fungere da fornitori di credenziali su Android 14 e versioni successive. Queste app memorizzano le credenziali. Consulta questo e questo per i dettagli. Vedi anche credentialProviderPolicy.

printingPolicy

enum (PrintingPolicy)

Campo facoltativo. Consente di stabilire se consentire o meno la stampa. Questa funzionalità è supportata sui dispositivi con Android 9 e versioni successive. .

ApplicationPolicy

Criterio per una singola app. Nota: non è possibile modificare la disponibilità delle applicazioni su un determinato dispositivo utilizzando questo criterio se il criterio installAppsDisabled è attivo. Il numero massimo di applicazioni che puoi specificare per ogni criterio è 3000.

Rappresentazione JSON
{
  "packageName": string,
  "installType": enum (InstallType),
  "lockTaskAllowed": boolean,
  "defaultPermissionPolicy": enum (PermissionPolicy),
  "permissionGrants": [
    {
      object (PermissionGrant)
    }
  ],
  "managedConfiguration": {
    object
  },
  "disabled": boolean,
  "minimumVersionCode": integer,
  "delegatedScopes": [
    enum (DelegatedScope)
  ],
  "managedConfigurationTemplate": {
    object (ManagedConfigurationTemplate)
  },
  "accessibleTrackIds": [
    string
  ],
  "connectedWorkAndPersonalApp": enum (ConnectedWorkAndPersonalApp),
  "autoUpdateMode": enum (AutoUpdateMode),
  "extensionConfig": {
    object (ExtensionConfig)
  },
  "alwaysOnVpnLockdownExemption": enum (AlwaysOnVpnLockdownExemption),
  "workProfileWidgets": enum (WorkProfileWidgets),
  "credentialProviderPolicy": enum (CredentialProviderPolicy),
  "installConstraint": [
    {
      object (InstallConstraint)
    }
  ],
  "installPriority": integer
}
Campi
packageName

string

Il nome del pacchetto dell'app. Ad esempio, com.google.android.youtube per l'app YouTube.

installType

enum (InstallType)

Il tipo di installazione da eseguire.

lockTaskAllowed
(deprecated)

boolean

Indica se l'app può bloccarsi in modalità a schermo intero. OBSOLETO. Usa InstallType KIOSK o kioskCustomLauncherEnabled per configurare un dispositivo dedicato.

defaultPermissionPolicy

enum (PermissionPolicy)

Il criterio predefinito per tutte le autorizzazioni richieste dall'app. Se specificato, sostituisce il criterio defaultPermissionPolicy a livello di criterio che viene applicato a tutte le app. Non sostituisce il permissionGrants che si applica a tutte le app.

permissionGrants[]

object (PermissionGrant)

Concessioni o rifiuti di autorizzazioni esplicite per l'app. Questi valori sostituiscono i defaultPermissionPolicy e permissionGrants, che si applicano a tutte le app.

managedConfiguration

object (Struct format)

Configurazione gestita applicata all'app. Il formato della configurazione dipende dai valori di ManagedProperty supportati dall'app. Ogni nome di campo nella configurazione gestita deve corrispondere al campo key di ManagedProperty. Il valore del campo deve essere compatibile con type del ManagedProperty:

typeValore JSON
BOOLtrue o false
STRINGstringa
INTEGERnumero
CHOICEstringa
MULTISELECTarray di stringhe
HIDDENstringa
BUNDLE_ARRAYarray di oggetti

disabled

boolean

Indica se l'app è disattivata. Se questa opzione è disattivata, i dati dell'app vengono comunque conservati.

minimumVersionCode

integer

La versione minima dell'app in esecuzione sul dispositivo. Se impostato, il dispositivo tenta di aggiornare l'app almeno a questo codice di versione. Se l'app non è aggiornata, il dispositivo conterrà un valore NonComplianceDetail con nonComplianceReason impostato su APP_NOT_UPDATED. L'app deve essere già pubblicata su Google Play con un codice di versione superiore o uguale a questo valore. È possibile specificare un codice di versione minimo per criterio per un massimo di 20 app.

delegatedScopes[]

enum (DelegatedScope)

Gli ambiti delegati all'app da Android Device Policy. Forniscono privilegi aggiuntivi per le applicazioni a cui vengono applicati.

managedConfigurationTemplate

object (ManagedConfigurationTemplate)

Il modello di configurazioni gestite per l'app, salvato dall'iframe delle configurazioni gestite. Questo campo viene ignorato se è impostato managedConfiguration.

accessibleTrackIds[]

string

Elenco degli ID dei canali dell'app a cui può accedere un dispositivo appartenente all'azienda. Se l'elenco contiene più ID canale, i dispositivi riceveranno la versione più recente tra tutti i canali accessibili. Se l'elenco non contiene ID canale, i dispositivi avranno accesso solo al canale di produzione dell'app. Ulteriori dettagli su ogni traccia sono disponibili in AppTrackInfo.

connectedWorkAndPersonalApp

enum (ConnectedWorkAndPersonalApp)

Consente di stabilire se l'app può comunicare con se stessa nei profili di lavoro e personale di un dispositivo, soggetto al consenso dell'utente.

autoUpdateMode

enum (AutoUpdateMode)

Consente di controllare la modalità di aggiornamento automatico dell'app.

extensionConfig

object (ExtensionConfig)

Configurazione per attivare questa app come app di estensione, con la possibilità di interagire con Android Device Policy offline.

Questo campo può essere impostato al massimo per un'app.

alwaysOnVpnLockdownExemption

enum (AlwaysOnVpnLockdownExemption)

Specifica se il networking dell'app è consentito quando la VPN non è connessa e alwaysOnVpnPackage.lockdownEnabled è attivo. Se il criterio viene impostato su VPN_LOCKDOWN_ENFORCED, il networking per l'app non è consentito; se il criterio viene impostato su VPN_LOCKDOWN_EXEMPTION, il networking per l'app è consentito. Funzionalità supportata solo sui dispositivi con Android 10 e versioni successive. Se non è supportato dal dispositivo, questo conterrà un NonComplianceDetail con nonComplianceReason impostato su API_LEVEL e un fieldPath. Se questo non è applicabile all'app, il dispositivo conterrà un NonComplianceDetail con nonComplianceReason impostato su UNSUPPORTED e un fieldPath. Il campo fieldPath è impostato su applications[i].alwaysOnVpnLockdownExemption, dove i è l'indice del pacchetto nel criterio applications.

workProfileWidgets

enum (WorkProfileWidgets)

Specifica se l'app installata nel profilo di lavoro può aggiungere widget alla schermata Home.

credentialProviderPolicy

enum (CredentialProviderPolicy)

Campo facoltativo. Indica se l'app può agire come fornitore di credenziali su Android 14 e versioni successive.

installConstraint[]

object (InstallConstraint)

Campo facoltativo. I vincoli per l'installazione dell'app. Puoi specificare un massimo di un InstallConstraint. Più vincoli vengono rifiutati.

installPriority

integer

Campo facoltativo. Tra le app con installType impostato su:

controlla la priorità relativa dell'installazione. Il valore 0 (predefinito) indica che l'app non ha la priorità sulle altre app. Per valori compresi tra 1 e 10.000, un valore inferiore indica una priorità più elevata. I valori al di fuori dell'intervallo da 0 a 10.000 inclusi vengono rifiutati.

InstallType

Il tipo di installazione da eseguire per un'app. Se setupAction fa riferimento a un'app, deve avere impostato installType su REQUIRED_FOR_SETUP, altrimenti la configurazione non andrà a buon fine.

Enum
INSTALL_TYPE_UNSPECIFIED Non specificato. Il valore predefinito è AVAILABLE.
PREINSTALLED L'app viene installata automaticamente e può essere rimossa dall'utente.
FORCE_INSTALLED L'app viene installata automaticamente indipendentemente dal periodo di manutenzione impostato e non può essere rimossa dall'utente.
BLOCKED L'app è bloccata e non può essere installata. Se l'app è stata installata in base a un criterio precedente, verrà disinstallata. Questa operazione blocca anche la funzionalità dell'app istantanea.
AVAILABLE L'app è disponibile per l'installazione.
REQUIRED_FOR_SETUP L'app viene installata automaticamente e non può essere rimossa dall'utente e impedirà il completamento della configurazione fino al termine dell'installazione.
KIOSK L'app viene installata automaticamente in modalità kiosk ed è impostata come intent di casa preferito e autorizzata per la modalità di blocco attività. La configurazione del dispositivo non sarà completata finché l'app non sarà installata. Dopo l'installazione, gli utenti non potranno rimuovere l'app. Puoi impostare questo installType per una sola app per criterio. Se nel criterio è presente, la barra di stato verrà disattivata automaticamente.

PermissionPolicy

Il criterio per concedere richieste di autorizzazione alle app.

Enum
PERMISSION_POLICY_UNSPECIFIED Norma non specificata. Se non viene specificato alcun criterio per un'autorizzazione a qualsiasi livello, per impostazione predefinita viene utilizzato il comportamento PROMPT.
PROMPT Chiedi all'utente di concedere un'autorizzazione.
GRANT

Concedi automaticamente un'autorizzazione.

Su Android 12 e versioni successive, le autorizzazioni relative a Manifest.permission.READ_SMS e ai sensori seguenti possono essere concesse solo sui dispositivi completamente gestiti:

DENY Negare automaticamente un'autorizzazione.

PermissionGrant

Configurazione di un'autorizzazione Android e stato di concessione corrispondente.

Rappresentazione JSON
{
  "permission": string,
  "policy": enum (PermissionPolicy)
}
Campi
permission

string

Il gruppo o l'autorizzazione Android, ad esempio android.permission.READ_CALENDAR o android.permission_group.CALENDAR.

policy

enum (PermissionPolicy)

Il criterio per concedere l'autorizzazione.

DelegatedScope

Ambiti di delega che un altro pacchetto può acquisire da Android Device Policy. Forniscono privilegi aggiuntivi per le applicazioni a cui vengono applicati.

Gli ambiti possono essere applicati a più applicazioni, ad eccezione di SECURITY_LOGS e NETWORK_ACTIVITY_LOGS, che possono essere delegate a una sola app alla volta.

Enum
DELEGATED_SCOPE_UNSPECIFIED Nessun ambito della delega specificato.
CERT_INSTALL Concede l'accesso per l'installazione e la gestione dei certificati.
MANAGED_CONFIGURATIONS Concede l'accesso alla gestione delle configurazioni gestite.
BLOCK_UNINSTALL Concede l'accesso per bloccare la disinstallazione.
PERMISSION_GRANT Concede l'accesso al criterio di autorizzazione e allo stato di concessione delle autorizzazioni.
PACKAGE_ACCESS Concede l'accesso allo stato di accesso al pacchetto.
ENABLE_SYSTEM_APP Concede l'accesso per abilitare le app di sistema.
NETWORK_ACTIVITY_LOGS Concede l'accesso ai log delle attività di rete. Consente all'applicazione delegata di chiamare i metodi setNetworkLoggingEnabled, isNetworkLoggingEnabled e retrieveNetworkLogs. Questo ambito può essere delegato al massimo a un'applicazione. Opzione supportata per i dispositivi completamente gestiti con Android 10 e versioni successive. Opzione supportata per un profilo di lavoro su Android 12 e versioni successive. Se la delega è supportata e impostata, NETWORK_ACTIVITY_LOGS viene ignorato.
SECURITY_LOGS Concede l'accesso ai log di sicurezza. Consente all'applicazione delegata di chiamare i metodi setSecurityLoggingEnabled, isSecurityLoggingEnabled, retrieveSecurityLogs e retrievePreRebootSecurityLogs. Questo ambito può essere delegato al massimo a un'applicazione. Opzione supportata per i dispositivi completamente gestiti e di proprietà dell'azienda con un profilo di lavoro su Android 12 e versioni successive. Se la delega è supportata e impostata, SECURITY_LOGS viene ignorato.
CERT_SELECTION Concede l'accesso alla selezione di certificati KeyChain per conto della richiesta di app. Una volta concessa l'autorizzazione, l'applicazione delegata inizierà a ricevere DelegatedAdminReceiver#onChoosePrivateKeyAlias. Consente all'applicazione delegata di chiamare i metodi grantKeyPairToApp e revokeKeyPairFromApp. Può esserci al massimo un'app con questa delega. Il campo choosePrivateKeyRules deve essere vuoto e privateKeySelectionEnabled non ha alcun effetto se la selezione del certificato viene delegata a un'applicazione.

ManagedConfigurationTemplate

Il modello di configurazioni gestite per l'app, salvato dall'iframe delle configurazioni gestite.

Rappresentazione JSON
{
  "templateId": string,
  "configurationVariables": {
    string: string,
    ...
  }
}
Campi
templateId

string

L'ID del modello di configurazioni gestite.

configurationVariables

map (key: string, value: string)

Facoltativo, una mappa contenente le variabili di configurazione <key, value> definite per la configurazione.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ConnectedWorkAndPersonalApp

Consente di stabilire se l'app può comunicare con se stessa in più profili, soggetto al consenso dell'utente.

Enum
CONNECTED_WORK_AND_PERSONAL_APP_UNSPECIFIED Non specificato. Il valore predefinito è CONNECTED_WORK_AND_PERSONAL_APPS_DISALLOWED.
CONNECTED_WORK_AND_PERSONAL_APP_DISALLOWED Predefinita. Impedisce all'app di comunicare con più profili.
CONNECTED_WORK_AND_PERSONAL_APP_ALLOWED Consente all'app di comunicare tra profili dopo aver ricevuto il consenso dell'utente.

AutoUpdateMode

Consente di stabilire la modalità di aggiornamento automatico dell'app. Se un utente del dispositivo apporta manualmente modifiche alle impostazioni del dispositivo, queste scelte vengono ignorate da AutoUpdateMode in quanto hanno la precedenza.

Enum
AUTO_UPDATE_MODE_UNSPECIFIED Non specificato. Il valore predefinito è AUTO_UPDATE_DEFAULT.
AUTO_UPDATE_DEFAULT

La modalità di aggiornamento predefinita.

L'app viene aggiornata automaticamente con priorità bassa per ridurre al minimo l'impatto sull'utente.

L'app viene aggiornata quando vengono soddisfatti tutti i seguenti vincoli:

  • Il dispositivo non è in uso.
  • Il dispositivo è connesso a una rete unmetered.
  • Il dispositivo è in carica.
  • L'app da aggiornare non è in esecuzione in primo piano.

Il dispositivo riceve una notifica relativa a un nuovo aggiornamento entro 24 ore dalla sua pubblicazione da parte dello sviluppatore. Trascorso questo periodo, l'app viene aggiornata la volta successiva che vengono soddisfatti i vincoli sopra indicati.

AUTO_UPDATE_POSTPONED

L'app non viene aggiornata automaticamente per un massimo di 90 giorni dal momento in cui diventa obsoleta.

90 giorni dopo che l'app diventa obsoleta, l'ultima versione disponibile viene installata automaticamente con priorità bassa (vedi AUTO_UPDATE_DEFAULT). Una volta aggiornata, l'app non viene aggiornata di nuovo automaticamente per 90 giorni dopo che diventa nuovamente obsoleta.

L'utente può comunque aggiornare manualmente l'app dal Play Store in qualsiasi momento.

AUTO_UPDATE_HIGH_PRIORITY

L'app viene aggiornata il prima possibile. Nessun vincolo applicato.

Il dispositivo viene avvisato appena possibile di un nuovo aggiornamento non appena diventa disponibile.

ExtensionConfig

Configurazione per attivare un'app come estensione, con la possibilità di interagire con Android Device Policy offline. Per Android 13 e versioni successive, le app di estensioni sono esenti dalle limitazioni relative alla batteria, quindi non verranno inserite nel bucket con restrizioni di standby delle app. Le app con estensioni sono inoltre protette contro la cancellazione dei dati da parte degli utenti o la chiusura forzata dell'applicazione, anche se gli amministratori possono continuare a usare clear app data command nelle app delle estensioni, se necessario per Android 13 e versioni successive.

Rappresentazione JSON
{
  "signingKeyFingerprintsSha256": [
    string
  ],
  "notificationReceiver": string
}
Campi
signingKeyFingerprintsSha256[]

string

Hash SHA-256 con codifica esadecimale del certificato di firma dell'app dell'estensione. Sono valide solo le rappresentazioni di stringhe esadecimali di 64 caratteri.

Se non specificata, la firma del nome del pacchetto corrispondente viene ottenuta dal Play Store.

Se questo elenco è vuoto, la firma dell'app dell'estensione sul dispositivo deve corrispondere alla firma ottenuta dal Play Store affinché l'app possa comunicare con Android Device Policy.

Se questo elenco non è vuoto, la firma dell'app dell'estensione sul dispositivo deve corrispondere a una delle voci dell'elenco affinché l'app possa comunicare con Android Device Policy.

Nei casi d'uso in produzione, è consigliabile lasciare vuoto questo campo.

notificationReceiver

string

Nome completo della classe di servizio del destinatario per Android Device Policy per informare l'app dell'estensione di eventuali aggiornamenti dello stato dei comandi locali.

AlwaysOnVpnLockdownExemption

Consente di stabilire se un'app è esente dall'impostazione alwaysOnVpnPackage.lockdownEnabled.

Enum
ALWAYS_ON_VPN_LOCKDOWN_EXEMPTION_UNSPECIFIED Non specificato. Il valore predefinito è VPN_LOCKDOWN_ENFORCED.
VPN_LOCKDOWN_ENFORCED L'app rispetta l'impostazione di blocco della VPN sempre attiva.
VPN_LOCKDOWN_EXEMPTION L'app è esente dall'impostazione di blocco della VPN sempre attiva.

WorkProfileWidgets

Consente di stabilire se un'applicazione di profilo di lavoro può aggiungere widget alla schermata Home.

Enum
WORK_PROFILE_WIDGETS_UNSPECIFIED Non specificato. Il valore predefinito è workProfileWidgetsDefault
WORK_PROFILE_WIDGETS_ALLOWED I widget dei profili di lavoro sono consentiti. Ciò significa che l'applicazione potrà aggiungere widget alla schermata Home.
WORK_PROFILE_WIDGETS_DISALLOWED I widget del profilo di lavoro non sono consentiti. Ciò significa che l'applicazione non potrà aggiungere widget alla schermata Home.

CredentialProviderPolicy

Indica se l'app può agire come fornitore di credenziali su Android 14 e versioni successive.

Enum
CREDENTIAL_PROVIDER_POLICY_UNSPECIFIED Non specificato. Il comportamento è regolato da credentialProviderPolicyDefault.
CREDENTIAL_PROVIDER_ALLOWED L'app è autorizzata a fungere da fornitore di credenziali.

InstallConstraint

Tra le app con InstallType impostato su:

definisce un insieme di limitazioni per l'installazione dell'app. È necessario impostare almeno uno dei campi. Se vengono impostati più campi, tutti i vincoli devono essere soddisfatti per poter installare l'app.

Rappresentazione JSON
{
  "networkTypeConstraint": enum (NetworkTypeConstraint),
  "chargingConstraint": enum (ChargingConstraint),
  "deviceIdleConstraint": enum (DeviceIdleConstraint)
}
Campi
networkTypeConstraint

enum (NetworkTypeConstraint)

Campo facoltativo. Vincolo del tipo di rete.

chargingConstraint

enum (ChargingConstraint)

Campo facoltativo. Vincolo di addebito.

deviceIdleConstraint

enum (DeviceIdleConstraint)

Campo facoltativo. Vincolo di inattività del dispositivo.

NetworkTypeConstraint

Vincolo del tipo di rete.

Enum
NETWORK_TYPE_CONSTRAINT_UNSPECIFIED Non specificato. Il valore predefinito è INSTALL_ON_ANY_NETWORK.
INSTALL_ON_ANY_NETWORK Qualsiasi rete attiva (Wi-Fi, cellulare e così via).
INSTALL_ONLY_ON_UNMETERED_NETWORK Qualsiasi rete non a consumo (ad esempio Wi-Fi).

ChargingConstraint

Vincolo di addebito.

Enum
CHARGING_CONSTRAINT_UNSPECIFIED Non specificato. Il valore predefinito è CHARGING_NOT_REQUIRED.
CHARGING_NOT_REQUIRED Non è necessario che il dispositivo sia in carica.
INSTALL_ONLY_WHEN_CHARGING Il dispositivo deve essere in carica.

DeviceIdleConstraint

Vincolo di stato di inattività del dispositivo.

Enum
DEVICE_IDLE_CONSTRAINT_UNSPECIFIED Non specificato. Il valore predefinito è DEVICE_IDLE_NOT_REQUIRED.
DEVICE_IDLE_NOT_REQUIRED Non è necessario che il dispositivo sia inattivo: l'app può essere installata mentre l'utente interagisce con il dispositivo.
INSTALL_ONLY_WHEN_DEVICE_IDLE Il dispositivo deve essere inattivo.

KeyguardDisabledFeature

Funzionalità di keyguard (schermata di blocco) che possono essere disattivate.

Enum
KEYGUARD_DISABLED_FEATURE_UNSPECIFIED Questo valore viene ignorato.
CAMERA Disattiva la fotocamera su schermate protette con blocco tastiera (ad esempio PIN).
NOTIFICATIONS Disattiva la visualizzazione di tutte le notifiche su schermate protette con blocco tastiera.
UNREDACTED_NOTIFICATIONS Disattiva le notifiche non oscurate nelle schermate protette del blocco tastiera.
TRUST_AGENTS Ignora lo stato dell'agente di attendibilità nelle schermate sicure del blocco tastiera.
DISABLE_FINGERPRINT Disattiva il sensore di impronte digitali nelle schermate protette del blocco tastiera.
DISABLE_REMOTE_INPUT Sui dispositivi con Android 6 e versioni precedenti, disattiva l'inserimento di testo nelle notifiche su schermate sicure con il blocco tastiera. Non ha alcun effetto su Android 7 e versioni successive.
FACE Disattiva l'autenticazione facciale nelle schermate protette del blocco tastiera.
IRIS Disattiva l'autenticazione dell'iris nelle schermate protette del blocco tastiera.
BIOMETRICS Disattiva tutte le autenticazioni biometriche nelle schermate protette del blocco tastiera.
SHORTCUTS Disattiva tutte le scorciatoie nella schermata protetta con blocco tastiera su Android 14 e versioni successive.
ALL_FEATURES Disattiva tutte le personalizzazioni correnti e future del blocco tastiera.

PersistentPreferredActivity

Un'attività predefinita per la gestione degli intent che corrispondono a un determinato filtro per intent. Nota:per configurare un kiosk, utilizza InstallType per KIOSK anziché utilizzare le attività preferite permanenti.

Rappresentazione JSON
{
  "receiverActivity": string,
  "actions": [
    string
  ],
  "categories": [
    string
  ]
}
Campi
receiverActivity

string

L'attività che dovrebbe essere il gestore dell'intent predefinito. Deve essere un nome di componente Android, ad esempio com.android.enterprise.app/.MainActivity. In alternativa, il valore può essere il nome del pacchetto di un'app, per cui Android Device Policy sceglie un'attività appropriata dell'app per gestire l'intento.

actions[]

string

Le azioni di intent da trovare nel filtro. Se nel filtro sono incluse delle azioni, l'azione di un intent deve essere uno di questi valori affinché possa corrispondere. Se non viene inclusa alcuna azione, l'azione intent viene ignorata.

categories[]

string

Le categorie di intent da trovare nel filtro. Un intent include le categorie richieste, che devono essere tutte incluse nel filtro per poter corrispondere. In altre parole, l'aggiunta di una categoria al filtro non influisce sulla corrispondenza, a meno che non sia specificata nell'intent.

SystemUpdate

Configurazione per la gestione degli aggiornamenti di sistema

Rappresentazione JSON
{
  "type": enum (SystemUpdateType),
  "startMinutes": integer,
  "endMinutes": integer,
  "freezePeriods": [
    {
      object (FreezePeriod)
    }
  ]
}
Campi
type

enum (SystemUpdateType)

Il tipo di aggiornamento di sistema da configurare.

startMinutes

integer

Se il tipo è WINDOWED, l'inizio del periodo di manutenzione, misurato come il numero di minuti dopo la mezzanotte nell'ora locale del dispositivo. Questo valore deve essere compreso tra 0 e 1439 inclusi.

endMinutes

integer

Se il tipo è WINDOWED, la fine del periodo di manutenzione, misurato come il numero di minuti dopo la mezzanotte nell'ora locale del dispositivo. Questo valore deve essere compreso tra 0 e 1439 inclusi. Se questo valore è inferiore a startMinutes, il periodo di manutenzione comprende la mezzanotte. Se il periodo di manutenzione specificato è inferiore a 30 minuti, il periodo effettivo viene esteso di 30 minuti oltre l'ora di inizio.

freezePeriods[]

object (FreezePeriod)

Un periodo di tempo con ripetizione annuale in cui gli aggiornamenti di sistema over-the-air (OTA) vengono posticipati per bloccare la versione del sistema operativo in esecuzione su un dispositivo. Per evitare il blocco permanente del dispositivo, ogni periodo di blocco deve essere separato da almeno 60 giorni.

SystemUpdateType

Il tipo di configurazione dell'aggiornamento di sistema.

Enum
SYSTEM_UPDATE_TYPE_UNSPECIFIED Segui il comportamento di aggiornamento predefinito del dispositivo, che in genere richiede all'utente di accettare gli aggiornamenti di sistema.
AUTOMATIC Installa automaticamente non appena sarà disponibile un aggiornamento.
WINDOWED

Installa automaticamente entro un periodo di manutenzione giornaliera. Questa operazione configura anche le app di Google Play in modo che vengano aggiornate all'interno della finestra. Questa opzione è vivamente consigliata per i dispositivi kiosk perché è l'unico modo in cui le app bloccate permanentemente in primo piano possono essere aggiornate da Play.

Se il criterio autoUpdateMode viene impostato su AUTO_UPDATE_HIGH_PRIORITY per un'app, il periodo di manutenzione viene ignorato per l'app e viene aggiornato il prima possibile, anche al di fuori del periodo di manutenzione.

POSTPONE Rimanda l'installazione automatica fino a un massimo di 30 giorni. Questo criterio non influisce sugli aggiornamenti della sicurezza (ad esempio le patch di sicurezza mensili).

FreezePeriod

Un periodo di blocco del sistema. Quando l'orologio di un dispositivo rientra nel periodo di blocco, tutti gli aggiornamenti di sistema in arrivo (incluse le patch di sicurezza) vengono bloccati e non installati.

Quando il dispositivo si trova al di fuori di eventuali periodi di blocco impostati, viene applicato il normale comportamento di criterio (automatico, con finestra o posticipato).

Gli anni bisestili vengono ignorati nei calcoli dei periodi di blocco, in particolare:

  • Se il 29 febbraio è impostato come data di inizio o di fine di un periodo di blocco, il periodo inizierà o terminerà il 28 febbraio.
  • Quando nell'orologio di sistema di un dispositivo viene indicato il 29 febbraio, viene considerato il 28 febbraio.
  • Durante il calcolo del numero di giorni in un periodo di blocco o del tempo tra due periodi di blocco, il 29 febbraio viene ignorato e non conteggiato come giorno.

Nota: affinché i periodi di blocco abbiano effetto, non è possibile specificare SystemUpdateType come SYSTEM_UPDATE_TYPE_UNSPECIFIED, perché i periodi di blocco richiedono l'indicazione di un criterio definito.

Rappresentazione JSON
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Campi
startDate

object (Date)

La data di inizio (inclusa) del periodo di blocco. Nota: non è necessario impostare year. Ad esempio, {"month": 1,"date": 30}.

endDate

object (Date)

La data di fine (inclusa) del periodo di blocco. Non deve essere successiva a 90 giorni dalla data di inizio. Se la data di fine è antecedente a quella di inizio, il periodo di blocco viene considerato alla fine dell'anno. Nota: non è necessario impostare year. Ad esempio, {"month": 1,"date": 30}.

Data

Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:

  • Una data completa, con valori di anno, mese e giorno diversi da zero.
  • Un mese e un giorno con zero anno (ad esempio, un anniversario).
  • Un anno a sé, con un mese e uno zero.
  • Un anno e un mese, con un giorno zero (ad esempio, la data di scadenza di una carta di credito).

Tipi correlati:

Rappresentazione JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.

month

integer

Mese di un anno. Il valore deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza giorno e mese.

day

integer

Giorno di un mese. Il valore deve essere compreso tra 1 e 31 ed essere valido per l'anno e il mese oppure 0 per specificare un anno e un mese in cui il giorno non sia significativo.

StatusReportingSettings

Impostazioni che controllano il comportamento dei report di stato.

Rappresentazione JSON
{
  "applicationReportsEnabled": boolean,
  "deviceSettingsEnabled": boolean,
  "softwareInfoEnabled": boolean,
  "memoryInfoEnabled": boolean,
  "networkInfoEnabled": boolean,
  "displayInfoEnabled": boolean,
  "powerManagementEventsEnabled": boolean,
  "hardwareStatusEnabled": boolean,
  "systemPropertiesEnabled": boolean,
  "applicationReportingSettings": {
    object (ApplicationReportingSettings)
  },
  "commonCriteriaModeEnabled": boolean
}
Campi
applicationReportsEnabled

boolean

Indica se i report sulle app sono attivati.

deviceSettingsEnabled

boolean

Indica se i report sulle impostazioni del dispositivo sono attivati.

softwareInfoEnabled

boolean

Indica se i report sulle informazioni sul software sono attivi.

memoryInfoEnabled

boolean

Indica se i report sugli eventi di memoria sono attivi.

networkInfoEnabled

boolean

Indica se i report sulle informazioni sulla rete sono attivi.

displayInfoEnabled

boolean

Se i report sui display sono attivati. I dati dei report non sono disponibili per i dispositivi di proprietà personale con profili di lavoro.

powerManagementEventsEnabled

boolean

Indica se attivare o meno i report sugli eventi di gestione dell'alimentazione. I dati dei report non sono disponibili per i dispositivi di proprietà personale con profili di lavoro.

hardwareStatusEnabled

boolean

Indica se i report sullo stato dell'hardware sono attivati. I dati dei report non sono disponibili per i dispositivi di proprietà personale con profili di lavoro.

systemPropertiesEnabled

boolean

Indica se i report sulle proprietà del sistema sono abilitati.

applicationReportingSettings

object (ApplicationReportingSettings)

Impostazioni di reporting delle applicazioni. Applicabile solo se applicationReportsEnabled è true.

commonCriteriaModeEnabled

boolean

Indica se i report Common Criteria Mode sono attivati.

ApplicationReportingSettings

Impostazioni che controllano il comportamento dei report delle applicazioni.

Rappresentazione JSON
{
  "includeRemovedApps": boolean
}
Campi
includeRemovedApps

boolean

Indica se le app rimosse sono incluse nei report sulle applicazioni.

PackageNameList

Un elenco di nomi di pacchetti.

Rappresentazione JSON
{
  "packageNames": [
    string
  ]
}
Campi
packageNames[]

string

Un elenco di nomi di pacchetti.

BatteryPluggedMode

Modalità per collegare la batteria.

Enum
BATTERY_PLUGGED_MODE_UNSPECIFIED Questo valore viene ignorato.
AC La fonte di alimentazione è un caricabatterie CA.
USB La fonte di alimentazione è una porta USB.
WIRELESS La fonte di alimentazione è wireless.

ProxyInfo

Informazioni di configurazione per un proxy HTTP. Per un proxy diretto, imposta i campi host, port e excludedHosts. Per un proxy di script PAC, imposta il campo pacUri.

Rappresentazione JSON
{
  "host": string,
  "port": integer,
  "excludedHosts": [
    string
  ],
  "pacUri": string
}
Campi
host

string

L'host del proxy diretto.

port

integer

La porta del proxy diretto.

excludedHosts[]

string

Per un proxy diretto, gli host per cui il proxy viene ignorato. I nomi host possono contenere caratteri jolly come *.example.com.

pacUri

string

L'URI dello script PAC utilizzato per configurare il proxy.

ChoosePrivateKeyRule

Consente di controllare l'accesso delle app alle chiavi private. La regola determina quale chiave privata, se presente, Android Device Policy concede all'app specificata. L'accesso viene concesso quando l'app chiama KeyChain.choosePrivateKeyAlias (o eventuali sovraccarichi) per richiedere un alias di chiave privata per un determinato URL, oppure per regole non specifiche dell'URL (ovvero se urlPattern non è impostato o se è impostata la stringa vuota o .*) su Android 11 e versioni successive, in modo che l'app possa prima chiamare KeyChain.getPrivateKey, senza dover prima chiamare KeyChain.getPrivateKey.KeyChain.choosePrivateKeyAlias

Quando un'app chiama KeyChain.choosePrivateKeyAlias se più di una corrispondenza choosePrivateKeyRules corrisponde, l'ultima regola corrispondente definisce l'alias chiave da restituire.

Rappresentazione JSON
{
  "urlPattern": string,
  "packageNames": [
    string
  ],
  "privateKeyAlias": string
}
Campi
urlPattern

string

Il pattern URL da abbinare all'URL della richiesta. Se non viene impostato o vuoto, corrisponde a tutti gli URL. Viene utilizzata la sintassi delle espressioni regolari di java.util.regex.Pattern.

packageNames[]

string

I nomi dei pacchetti a cui si applica la regola. L'hash del certificato di firma di ogni app viene verificato in base all'hash fornito da Play. Se non vengono specificati nomi di pacchetto, l'alias viene fornito a tutte le app che chiamano KeyChain.choosePrivateKeyAlias o eventuali sovraccarichi (ma non senza chiamare KeyChain.choosePrivateKeyAlias, anche su Android 11 e versioni successive). Qualsiasi app con lo stesso UID Android di un pacchetto specificato qui avrà accesso quando chiamerà KeyChain.choosePrivateKeyAlias.

privateKeyAlias

string

L'alias della chiave privata da utilizzare.

AlwaysOnVpnPackage

Configurazione per una connessione VPN sempre attiva.

Rappresentazione JSON
{
  "packageName": string,
  "lockdownEnabled": boolean
}
Campi
packageName

string

Il nome del pacchetto dell'app VPN.

lockdownEnabled

boolean

Non consente il networking quando la VPN non è connessa.

LocationMode

Il livello di attivazione del rilevamento della posizione sul profilo di lavoro e sui dispositivi completamente gestiti.

Enum
LOCATION_MODE_UNSPECIFIED Il valore predefinito è LOCATION_USER_CHOICE.
HIGH_ACCURACY

Su Android 8 e versioni precedenti sono attivi tutti i metodi di rilevamento della posizione, inclusi GPS, reti e altri sensori. Su Android 9 e versioni successive, equivale a LOCATION_ENFORCED.

SENSORS_ONLY

Su Android 8 e versioni precedenti sono attivi solo il GPS e altri sensori. Su Android 9 e versioni successive, equivale a LOCATION_ENFORCED.

BATTERY_SAVING

Su Android 8 e versioni precedenti, è attivo solo il fornitore di servizi di geolocalizzazione della rete. Su Android 9 e versioni successive, equivale a LOCATION_ENFORCED.

OFF

Su Android 8 e versioni precedenti, la precisione e l'impostazione della geolocalizzazione sono disattivate. Su Android 9 e versioni successive, equivale a LOCATION_DISABLED.

LOCATION_USER_CHOICE L'impostazione di geolocalizzazione non è limitata sul dispositivo. Nessun comportamento specifico viene impostato o applicato.
LOCATION_ENFORCED Attiva l'impostazione di geolocalizzazione sul dispositivo.
LOCATION_DISABLED Disattiva l'impostazione di geolocalizzazione sul dispositivo.

ComplianceRule

Una regola che dichiara le azioni di mitigazione da intraprendere quando un dispositivo non è conforme ai relativi criteri. Per ogni regola, esiste sempre un'azione attenuante implicita per impostare policyCompliant su false per la risorsa Device e visualizzare un messaggio sul dispositivo che indica che il dispositivo non è conforme al criterio. Se vuoi, puoi anche intraprendere altre azioni di mitigazione, a seconda dei valori dei campi nella regola.

Rappresentazione JSON
{
  "disableApps": boolean,
  "packageNamesToDisable": [
    string
  ],

  // Union field condition can be only one of the following:
  "nonComplianceDetailCondition": {
    object (NonComplianceDetailCondition)
  },
  "apiLevelCondition": {
    object (ApiLevelCondition)
  }
  // End of list of possible types for union field condition.
}
Campi
disableApps

boolean

Se è impostata su true, la regola include un'azione di mitigazione per disabilitare le app in modo che il dispositivo venga effettivamente disattivato, ma i dati delle app vengono conservati. Se sul dispositivo è in esecuzione un'app in modalità di attività bloccata, questa viene chiusa e viene visualizzata una UI che mostra il motivo della non conformità.

packageNamesToDisable[]

string

Se impostata, la regola include un'azione di mitigazione per disabilitare le app specificate nell'elenco, ma i dati delle app vengono conservati.

Campo di unione condition. La condizione che, se soddisfatta, attiva le azioni di mitigazione definite nella regola. Deve essere impostata esattamente una delle condizioni. condition può essere solo uno dei seguenti:
nonComplianceDetailCondition

object (NonComplianceDetailCondition)

Una condizione che viene soddisfatta se ne esiste qualsiasi corrispondente NonComplianceDetail per il dispositivo.

apiLevelCondition

object (ApiLevelCondition)

Condizione che viene soddisfatta se il livello API Android Framework sul dispositivo non soddisfa un requisito minimo.

NonComplianceDetailCondition

Una condizione della regola di conformità che sia soddisfatta se esiste qualsiasi condizione corrispondente a NonComplianceDetail per il dispositivo. Un NonComplianceDetail corrisponde a un NonComplianceDetailCondition se tutti i campi impostati all'interno di NonComplianceDetailCondition corrispondono ai campi NonComplianceDetail corrispondenti.

Rappresentazione JSON
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string
}
Campi
settingName

string

Il nome dell'impostazione del criterio. Si tratta del nome di un campo JSON di un campo Policy di primo livello. Se non viene configurato, questa condizione corrisponderà a qualsiasi nome dell'impostazione.

nonComplianceReason

enum (NonComplianceReason)

Il motivo per cui il dispositivo non è conforme all'impostazione. Se non viene impostata, questa condizione corrisponde a qualsiasi motivo.

packageName

string

Il nome del pacchetto dell'app non conforme. Se non viene impostata, questa condizione corrisponderà a qualsiasi nome pacchetto.

ApiLevelCondition

Una condizione della regola di conformità che viene soddisfatta se il livello API Android Framework sul dispositivo non soddisfa un requisito minimo. Può esistere una sola regola con questo tipo di condizione per ogni criterio.

Rappresentazione JSON
{
  "minApiLevel": integer
}
Campi
minApiLevel

integer

Il livello API minimo desiderato di Android Framework. Se il dispositivo non soddisfa il requisito minimo, questa condizione è soddisfatta. Deve essere maggiore di zero.

AppAutoUpdatePolicy

Alternativa consigliata: l'autoUpdateMode, impostato per ogni app, offre una maggiore flessibilità in merito alla frequenza di aggiornamento.

Quando autoUpdateMode è impostato su AUTO_UPDATE_POSTPONED o AUTO_UPDATE_HIGH_PRIORITY, questo campo non ha effetto.

Il criterio di aggiornamento automatico delle app, che consente di stabilire quando è possibile applicare gli aggiornamenti automatici delle app.

Enum
APP_AUTO_UPDATE_POLICY_UNSPECIFIED Il criterio di aggiornamento automatico non è impostato. Equivalente a CHOICE_TO_THE_USER.
CHOICE_TO_THE_USER L'utente può controllare gli aggiornamenti automatici.
NEVER Le app non vengono mai aggiornate automaticamente.
WIFI_ONLY Le app vengono aggiornate automaticamente solo tramite Wi-Fi.
ALWAYS Le app vengono aggiornate automaticamente in qualsiasi momento. Potrebbero essere applicati dei costi per i dati.

AppTrack

Un canale di rilascio dell'app Google Play.

Enum
APP_TRACK_UNSPECIFIED Questo valore viene ignorato.
PRODUCTION Il canale di produzione, che fornisce l'ultima release stabile.
BETA Il canale beta, che fornisce l'ultima release beta.

EncryptionPolicy

Tipo di crittografia

Enum
ENCRYPTION_POLICY_UNSPECIFIED Questo valore viene ignorato, ovvero non è richiesta la crittografia
ENABLED_WITHOUT_PASSWORD È richiesta la crittografia, ma non è necessaria alcuna password per l'avvio
ENABLED_WITH_PASSWORD Crittografia richiesta con password per l'avvio

PlayStoreMode

Valori possibili per il criterio relativo alla modalità Play Store.

Enum
PLAY_STORE_MODE_UNSPECIFIED Non specificato. Il valore predefinito è WHITELIST.
WHITELIST Sono disponibili soltanto le app incluse nel criterio e quelle non incluse nel criterio verranno disinstallate automaticamente dal dispositivo.
BLACKLIST Tutte le app sono disponibili e tutte le app che non devono essere presenti sul dispositivo devono essere contrassegnate esplicitamente come "BLOCCATE" nel criterio applications.

SetupAction

Un'azione eseguita durante la configurazione.

Rappresentazione JSON
{
  "title": {
    object (UserFacingMessage)
  },
  "description": {
    object (UserFacingMessage)
  },

  // Union field action can be only one of the following:
  "launchApp": {
    object (LaunchAppAction)
  }
  // End of list of possible types for union field action.
}
Campi
title

object (UserFacingMessage)

Titolo dell'azione.

description

object (UserFacingMessage)

Descrizione di questa azione.

Campo di unione action. L'azione da eseguire durante la configurazione. action può essere solo uno dei seguenti:
launchApp

object (LaunchAppAction)

Un'azione per avviare un'app. L'app verrà avviata con un intent contenente un extra con la chiave com.google.android.apps.work.clouddpc.EXTRA_LAUNCHED_AS_SETUP_ACTION impostata sul valore booleano true per indicare che si tratta di un flusso di azione di configurazione. Se SetupAction fa riferimento a un'app, il valore installType corrispondente nel criterio dell'applicazione deve essere impostato su REQUIRED_FOR_SETUP, altrimenti la configurazione non andrà a buon fine.

LaunchAppAction

Un'azione per avviare un'app.

Rappresentazione JSON
{

  // Union field launch can be only one of the following:
  "packageName": string
  // End of list of possible types for union field launch.
}
Campi
Campo di unione launch. La descrizione dell'azione di avvio da eseguire launch può essere solo una delle seguenti:
packageName

string

Nome del pacchetto dell'app da avviare

PolicyEnforcementRule

Una regola che definisce le azioni da intraprendere se un dispositivo o un profilo di lavoro non è conforme al criterio specificato in settingName. In caso di più corrispondenze o di più regole di applicazione applicate, verrà eseguita un'unione con l'azione più grave intrapresa. Tuttavia, tutte le regole attivate vengono comunque monitorate: ciò include il tempo di attivazione iniziale e tutti i dettagli associati alla non conformità. Nel caso in cui venga soddisfatta la regola di applicazione più grave, verrà applicata la successiva azione più appropriata.

Rappresentazione JSON
{
  "blockAction": {
    object (BlockAction)
  },
  "wipeAction": {
    object (WipeAction)
  },

  // Union field trigger can be only one of the following:
  "settingName": string
  // End of list of possible types for union field trigger.
}
Campi
blockAction

object (BlockAction)

Un'azione per bloccare l'accesso ad app e dati su un dispositivo di proprietà dell'azienda o in un profilo di lavoro. Questa azione attiva anche una notifica rivolta all'utente con informazioni (ove possibile) su come risolvere il problema di conformità. Nota: è necessario specificare anche wipeAction.

wipeAction

object (WipeAction)

Un'azione per reimpostare un dispositivo di proprietà dell'azienda o eliminare un profilo di lavoro. Nota: è necessario specificare anche blockAction.

Campo di unione trigger. Condizione che attiverà questa regola. trigger può essere solo uno dei seguenti:
settingName

string

Il criterio di primo livello da applicare. Ad esempio, applications o passwordPolicies.

BlockAction

Un'azione per bloccare l'accesso ad app e dati su un dispositivo completamente gestito o in un profilo di lavoro. Questa azione attiva anche un dispositivo o un profilo di lavoro per visualizzare una notifica rivolta all'utente con informazioni (ove possibile) su come risolvere il problema di conformità. Nota: è necessario specificare anche wipeAction.

Rappresentazione JSON
{
  "blockAfterDays": integer,
  "blockScope": enum (BlockScope)
}
Campi
blockAfterDays

integer

Numero di giorni in cui il criterio non è conforme prima che il dispositivo o il profilo di lavoro venga bloccato. Per bloccare immediatamente l'accesso, imposta il valore su 0. blockAfterDays deve essere inferiore a wipeAfterDays.

blockScope

enum (BlockScope)

Specifica l'ambito di questo BlockAction. Si applica solo ai dispositivi di proprietà dell'azienda.

BlockScope

Specifica l'ambito di BlockAction. Si applica solo ai dispositivi di proprietà dell'azienda.

Enum
BLOCK_SCOPE_UNSPECIFIED Non specificato. Il valore predefinito è BLOCK_SCOPE_WORK_PROFILE.
BLOCK_SCOPE_WORK_PROFILE L'azione di blocco viene applicata solo alle app nel profilo di lavoro. Le app nel profilo personale non sono interessate.
BLOCK_SCOPE_DEVICE L'azione di blocco viene applicata all'intero dispositivo, incluse le app nel profilo personale.

WipeAction

Un'azione per reimpostare un dispositivo di proprietà dell'azienda o eliminare un profilo di lavoro. Nota: è necessario specificare anche blockAction.

Rappresentazione JSON
{
  "wipeAfterDays": integer,
  "preserveFrp": boolean
}
Campi
wipeAfterDays

integer

Numero di giorni in cui il criterio non è conforme prima che il dispositivo o il profilo di lavoro vengano cancellati. wipeAfterDays deve essere maggiore di blockAfterDays.

preserveFrp

boolean

Se i dati di protezione del ripristino dei dati di fabbrica vengono conservati sul dispositivo. Questa impostazione non si applica ai profili di lavoro.

KioskCustomization

Impostazioni che controllano il comportamento di un dispositivo in modalità kiosk. Per attivare la modalità kiosk, imposta kioskCustomLauncherEnabled su true o specifica un'app nel criterio con installType KIOSK.

Rappresentazione JSON
{
  "powerButtonActions": enum (PowerButtonActions),
  "systemErrorWarnings": enum (SystemErrorWarnings),
  "systemNavigation": enum (SystemNavigation),
  "statusBar": enum (StatusBar),
  "deviceSettings": enum (DeviceSettings)
}
Campi
powerButtonActions

enum (PowerButtonActions)

Imposta il comportamento di un dispositivo in modalità kiosk quando un utente tiene premuto (pressione prolungata) il tasto di accensione.

systemErrorWarnings

enum (SystemErrorWarnings)

Specifica se le finestre di dialogo di errore di sistema per le app che hanno subito un arresto anomalo o che non rispondono sono bloccate in modalità kiosk. Se viene bloccato, il sistema forza l'interruzione dell'app come se l'utente scegliesse l'opzione "Chiudi app" nella UI.

systemNavigation

enum (SystemNavigation)

Consente di specificare quali funzionalità di navigazione sono attive (ad esempio, Home e Panoramica) in modalità kiosk.

statusBar

enum (StatusBar)

Consente di specificare se le informazioni sul sistema e le notifiche sono disattivate in modalità kiosk.

deviceSettings

enum (DeviceSettings)

Consente di specificare se l'app Impostazioni è consentita in modalità kiosk.

PowerButtonActions

Imposta il comportamento di un dispositivo in modalità kiosk quando un utente tiene premuto (pressione prolungata) il tasto di accensione.

Enum
POWER_BUTTON_ACTIONS_UNSPECIFIED Non specificato, il valore predefinito è POWER_BUTTON_AVAILABLE.
POWER_BUTTON_AVAILABLE Il menu del tasto di accensione (ad es. Spegni, Riavvia) viene mostrato quando un utente preme a lungo il tasto di accensione di un dispositivo in modalità kiosk.
POWER_BUTTON_BLOCKED Il menu del tasto di accensione (ad es. Spegni, Riavvia) non viene visualizzato quando un utente preme a lungo il tasto di accensione di un dispositivo in modalità kiosk. Nota: in questo modo gli utenti potrebbero non essere in grado di spegnere il dispositivo.

SystemErrorWarnings

Specifica se le finestre di dialogo di errore di sistema per le app che hanno subito un arresto anomalo o che non rispondono sono bloccate in modalità kiosk.

Enum
SYSTEM_ERROR_WARNINGS_UNSPECIFIED Non specificato, il valore predefinito è ERROR_AND_WARNINGS_MUTED.
ERROR_AND_WARNINGS_ENABLED Vengono visualizzate tutte le finestre di dialogo di errore di sistema, come App non risponde (ANR) e Arresto anomalo.
ERROR_AND_WARNINGS_MUTED Tutte le finestre di dialogo di errore di sistema, come App non risponde (ANR) e Arresto anomalo, sono bloccate. Quando è bloccato, il sistema forza l'interruzione dell'app come se l'utente chiudesse l'app dalla UI.

SystemNavigation

Consente di specificare quali funzionalità di navigazione sono attive (ad esempio, Home e Panoramica) in modalità kiosk.

Enum
SYSTEM_NAVIGATION_UNSPECIFIED Non specificato, il valore predefinito è NAVIGATION_DISABLED.
NAVIGATION_ENABLED I pulsanti Home e Panoramica sono attivi.
NAVIGATION_DISABLED I pulsanti Home e Panoramica non sono accessibili.
HOME_BUTTON_ONLY È attivato solo il pulsante Home.

StatusBar

Consente di specificare se le informazioni sul sistema e le notifiche sono disattivate in modalità kiosk.

Enum
STATUS_BAR_UNSPECIFIED Non specificato, il valore predefinito è INFO_AND_NOTIFICATIONS_DISABLED.
NOTIFICATIONS_AND_SYSTEM_INFO_ENABLED

Le informazioni sul sistema e le notifiche vengono visualizzate sulla barra di stato in modalità kiosk.

Nota: per applicare questo criterio, il pulsante Home del dispositivo deve essere attivato utilizzando kioskCustomization.systemNavigation.

NOTIFICATIONS_AND_SYSTEM_INFO_DISABLED Le informazioni sul sistema e le notifiche sono disattivate in modalità kiosk.
SYSTEM_INFO_ONLY Nella barra di stato vengono mostrate solo le informazioni sul sistema.

DeviceSettings

Consente di specificare se un utente può accedere all'app Impostazioni del dispositivo in modalità kiosk.

Enum
DEVICE_SETTINGS_UNSPECIFIED Non specificato, il valore predefinito è SETTINGS_ACCESS_ALLOWED.
SETTINGS_ACCESS_ALLOWED L'accesso all'app Impostazioni è consentito in modalità kiosk.
SETTINGS_ACCESS_BLOCKED L'accesso all'app Impostazioni non è consentito in modalità kiosk.

AdvancedSecurityOverrides

Impostazioni di sicurezza avanzate. Nella maggior parte dei casi, queste impostazioni non sono necessarie.

Rappresentazione JSON
{
  "untrustedAppsPolicy": enum (UntrustedAppsPolicy),
  "googlePlayProtectVerifyApps": enum (GooglePlayProtectVerifyApps),
  "developerSettings": enum (DeveloperSettings),
  "commonCriteriaMode": enum (CommonCriteriaMode),
  "personalAppsThatCanReadWorkNotifications": [
    string
  ],
  "mtePolicy": enum (MtePolicy)
}
Campi
untrustedAppsPolicy

enum (UntrustedAppsPolicy)

Il criterio per le app non attendibili (app di origini sconosciute) applicato al dispositivo. Sostituisce installUnknownSourcesAllowed (deprecated).

googlePlayProtectVerifyApps

enum (GooglePlayProtectVerifyApps)

Indica se è applicata la verifica di Google Play Protect. Sostituisce ensureVerifyAppsEnabled (deprecato).

developerSettings

enum (DeveloperSettings)

Consente di gestire l'accesso alle impostazioni sviluppatore: opzioni sviluppatore e avvio protetto. Sostituisce safeBootDisabled (deprecato) e debuggingFeaturesAllowed (deprecato).

commonCriteriaMode

enum (CommonCriteriaMode)

modalità dei controlli Common Criteria: standard di sicurezza definiti nel documento Common Criteria for Information Technology Security Evaluation (CC). L'attivazione della modalità Common Criteria aumenta alcuni componenti di sicurezza su un dispositivo, tra cui la crittografia AES-GCM delle chiavi a lungo termine Bluetooth e gli archivi di configurazioni Wi-Fi.

Avviso: la modalità Common Criteria applica un modello di sicurezza rigoroso, generalmente richiesto solo per i prodotti IT utilizzati nei sistemi di sicurezza nazionale e in altre organizzazioni altamente sensibili. L'utilizzo standard del dispositivo potrebbe risentirne. Abilitata solo se necessario.

personalAppsThatCanReadWorkNotifications[]

string

App personali che possono leggere le notifiche del profilo di lavoro utilizzando NotificationListenerService. Per impostazione predefinita, nessuna app personale (ad eccezione delle app di sistema) può leggere le notifiche di lavoro. Ciascun valore nell'elenco deve essere un nome pacchetto.

mtePolicy

enum (MtePolicy)

Campo facoltativo. Consente di controllare Memory Tagging Extension (MTE) sul dispositivo. Per applicare le modifiche al criterio MTE, è necessario riavviare il dispositivo.

UntrustedAppsPolicy

Il criterio per le app non attendibili (app di origini sconosciute) applicato al dispositivo. Sostituisce installUnknownSourcesAllowed (deprecated).

Enum
UNTRUSTED_APPS_POLICY_UNSPECIFIED Non specificato. Il valore predefinito è DISALLOW_INSTALL.
DISALLOW_INSTALL Predefinita. Non consentire installazioni di app non attendibili sull'intero dispositivo.
ALLOW_INSTALL_IN_PERSONAL_PROFILE_ONLY Per i dispositivi con profili di lavoro, consenti le installazioni di app non attendibili solo nel profilo personale del dispositivo.
ALLOW_INSTALL_DEVICE_WIDE Consenti installazioni di app non attendibili su tutto il dispositivo.

GooglePlayProtectVerifyApps

Indica se è applicata la verifica di Google Play Protect. Sostituisce ensureVerifyAppsEnabled (deprecato).

Enum
GOOGLE_PLAY_PROTECT_VERIFY_APPS_UNSPECIFIED Non specificato. Il valore predefinito è VERIFY_APPS_ENFORCED.
VERIFY_APPS_ENFORCED Predefinita. Forza l'attivazione della verifica delle app.
VERIFY_APPS_USER_CHOICE Consente all'utente di scegliere se attivare o meno la verifica delle app.

DeveloperSettings

Consente di gestire l'accesso alle impostazioni sviluppatore: opzioni sviluppatore e avvio protetto. Sostituisce safeBootDisabled (deprecato) e debuggingFeaturesAllowed (deprecato).

Enum
DEVELOPER_SETTINGS_UNSPECIFIED Non specificato. Il valore predefinito è SVILUPPATORI_IMPOSTAZIONI_DISABLED.
DEVELOPER_SETTINGS_DISABLED Predefinita. Disattiva tutte le impostazioni sviluppatore e impedisce all'utente di accedervi.
DEVELOPER_SETTINGS_ALLOWED Consente tutte le impostazioni sviluppatore. L'utente può accedere alle impostazioni e, facoltativamente, configurarle.

CommonCriteriaMode

modalità dei controlli Common Criteria: standard di sicurezza definiti nel documento Common Criteria for Information Technology Security Evaluation (CC). L'attivazione della modalità Common Criteria aumenta alcuni componenti di sicurezza su un dispositivo, tra cui la crittografia AES-GCM delle chiavi a lungo termine Bluetooth e gli archivi di configurazioni Wi-Fi.

Avviso: la modalità Common Criteria applica un modello di sicurezza rigoroso, generalmente richiesto solo per i prodotti IT utilizzati nei sistemi di sicurezza nazionale e in altre organizzazioni altamente sensibili. L'utilizzo standard del dispositivo potrebbe risentirne. Abilitata solo se necessario. Se la modalità Common Criteria viene disattivata dopo essere stata attivata in precedenza, tutte le reti Wi-Fi configurate dall'utente potrebbero andare perse e tutte le reti Wi-Fi configurate dall'azienda che richiedono l'input dell'utente potrebbero dover essere riconfigurate.

Enum
COMMON_CRITERIA_MODE_UNSPECIFIED Non specificato. Il valore predefinito è common_CRITERIA_MODE_DISABLED.
COMMON_CRITERIA_MODE_DISABLED Predefinita. Disattiva la modalità Common Criteria.
COMMON_CRITERIA_MODE_ENABLED Attiva la modalità Common Criteria.

MtePolicy

Consente di controllare Memory Tagging Extension (MTE) sul dispositivo.

Enum
MTE_POLICY_UNSPECIFIED Non specificato. Il valore predefinito è MTE_USER_CHOICE.
MTE_USER_CHOICE L'utente può scegliere di attivare o disattivare la funzionalità MTE sul dispositivo, se supporta questa funzionalità.
MTE_ENFORCED

La funzionalità MTE è attiva sul dispositivo e l'utente non può modificare questa impostazione. Questa opzione può essere impostata sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda. Viene segnalato un nonComplianceDetail con MANAGEMENT_MODE per altre modalità di gestione. Viene segnalato un valore nonComplianceDetail con DEVICE_INCOMPATIBLE se il dispositivo non supporta la funzionalità MTE.

Funzionalità supportata su Android 14 e versioni successive. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 14.

MTE_DISABLED

La funzionalità MTE è disattivata sul dispositivo e l'utente non può modificare questa impostazione. Si applica solo ai dispositivi completamente gestiti. In altri casi, viene segnalata una nonComplianceDetail con MANAGEMENT_MODE. Viene segnalato un valore nonComplianceDetail con DEVICE_INCOMPATIBLE se il dispositivo non supporta la funzionalità MTE.

Funzionalità supportata su Android 14 e versioni successive. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 14.

PersonalUsagePolicies

Criteri che controllano l'utilizzo personale su un dispositivo di proprietà dell'azienda con un profilo di lavoro.

Rappresentazione JSON
{
  "cameraDisabled": boolean,
  "screenCaptureDisabled": boolean,
  "accountTypesWithManagementDisabled": [
    string
  ],
  "maxDaysWithWorkOff": integer,
  "personalPlayStoreMode": enum (PlayStoreMode),
  "personalApplications": [
    {
      object (PersonalApplicationPolicy)
    }
  ]
}
Campi
cameraDisabled

boolean

Se il valore è true, la fotocamera è disattivata nel profilo personale.

screenCaptureDisabled

boolean

Se il valore è true, l'acquisizione di schermate è disattivata per tutti gli utenti.

accountTypesWithManagementDisabled[]

string

Tipi di account che non possono essere gestiti dall'utente.

maxDaysWithWorkOff

integer

Consente di stabilire per quanto tempo il profilo di lavoro può rimanere disattivato. La durata minima deve essere di almeno 3 giorni. Altri dettagli sono riportati di seguito:

  • Se la durata è impostata su 0, la funzionalità viene disattivata.
  • Se la durata è impostata su un valore inferiore alla durata minima, la funzionalità restituisce un errore.
Nota:se vuoi evitare che i profili personali vengano sospesi durante lunghi periodi di inattività, puoi impostare temporaneamente un valore elevato per questo parametro.

personalPlayStoreMode

enum (PlayStoreMode)

Utilizzato insieme all'personalApplications per stabilire in che modo consentire o bloccare le app nel profilo personale.

personalApplications[]

object (PersonalApplicationPolicy)

Criterio applicato alle applicazioni nel profilo personale.

PlayStoreMode

Utilizzato insieme all'personalApplications per stabilire in che modo consentire o bloccare le app nel profilo personale.

Enum
PLAY_STORE_MODE_UNSPECIFIED Non specificato. Il valore predefinito è BLOCKLIST.
BLACKLIST

Tutte le app del Play Store possono essere installate nel profilo personale, ad eccezione di quelle per cui installType è BLOCKED in personalApplications.

BLOCKLIST Tutte le app del Play Store possono essere installate nel profilo personale, ad eccezione di quelle per cui installType è BLOCKED in personalApplications.
ALLOWLIST Nel profilo personale è possibile installare soltanto le app specificate esplicitamente in personalApplications con installType impostato su AVAILABLE.

PersonalApplicationPolicy

Criteri per le app nel profilo personale di un dispositivo di proprietà dell'azienda con un profilo di lavoro.

Rappresentazione JSON
{
  "packageName": string,
  "installType": enum (InstallType)
}
Campi
packageName

string

Il nome del pacchetto dell'applicazione.

installType

enum (InstallType)

Il tipo di installazione da eseguire.

InstallType

Tipi di comportamenti di installazione che possono avere un'applicazione di profilo personale.

Enum
INSTALL_TYPE_UNSPECIFIED Non specificato. Il valore predefinito è AVAILABLE.
BLOCKED L'app è bloccata e non può essere installata nel profilo personale. Se l'app è stata precedentemente installata nel dispositivo, verrà disinstallata.
AVAILABLE L'app può essere installata nel profilo personale.

AutoDateAndTimeZone

Indica se sono stati attivati automaticamente data, ora e fuso orario su un dispositivo di proprietà dell'azienda.

Enum
AUTO_DATE_AND_TIME_ZONE_UNSPECIFIED Non specificato. Il valore predefinito è AUTO_DATE_AND_TIME_ZONE_USER_CHOICE.
AUTO_DATE_AND_TIME_ZONE_USER_CHOICE La data, l'ora e il fuso orario automatici sono liberi dell'utente.
AUTO_DATE_AND_TIME_ZONE_ENFORCED Applica automaticamente data, ora e fuso orario al dispositivo.

OncCertificateProvider

Questa funzionalità non è disponibile a livello generale.

Rappresentazione JSON
{
  "certificateReferences": [
    string
  ],

  // Union field endpoint can be only one of the following:
  "contentProviderEndpoint": {
    object (ContentProviderEndpoint)
  }
  // End of list of possible types for union field endpoint.
}
Campi
certificateReferences[]

string

Questa funzionalità non è disponibile a livello generale.

Campo di unione endpoint.

Questa funzionalità non è disponibile a livello generale. endpoint può essere solo uno dei seguenti:

contentProviderEndpoint

object (ContentProviderEndpoint)

Questa funzionalità non è disponibile a livello generale.

ContentProviderEndpoint

Questa funzionalità non è disponibile a livello generale.

Rappresentazione JSON
{
  "uri": string,
  "packageName": string,
  "signingCertsSha256": [
    string
  ]
}
Campi
uri

string

Questa funzionalità non è disponibile a livello generale.

packageName

string

Questa funzionalità non è disponibile a livello generale.

signingCertsSha256[]

string

obbligatorio. Questa funzionalità non è disponibile a livello generale.

CrossProfilePolicies

Controlla i dati del profilo di lavoro a cui è possibile accedere dal profilo personale e viceversa. Viene segnalato un nonComplianceDetail con MANAGEMENT_MODE se il dispositivo non ha un profilo di lavoro.

Rappresentazione JSON
{
  "showWorkContactsInPersonalProfile": enum (ShowWorkContactsInPersonalProfile),
  "crossProfileCopyPaste": enum (CrossProfileCopyPaste),
  "crossProfileDataSharing": enum (CrossProfileDataSharing),
  "workProfileWidgetsDefault": enum (WorkProfileWidgetsDefault),
  "exemptionsToShowWorkContactsInPersonalProfile": {
    object (PackageNameList)
  }
}
Campi
showWorkContactsInPersonalProfile

enum (ShowWorkContactsInPersonalProfile)

Indica se le app personali possono accedere ai contatti memorizzati nel profilo di lavoro.

Vedi anche exemptionsToShowWorkContactsInPersonalProfile.

crossProfileCopyPaste

enum (CrossProfileCopyPaste)

Se il testo copiato da un profilo (personale o di lavoro) può essere incollato nell'altro profilo.

crossProfileDataSharing

enum (CrossProfileDataSharing)

Se i dati di un profilo (personali o di lavoro) possono essere condivisi con le app dell'altro profilo. In particolare, controlla la semplice condivisione di dati tramite intent. La gestione di altri canali di comunicazione tra più profili, ad esempio la ricerca di contatti, il copia e incolla o le app personali e di lavoro collegate, viene configurata separatamente.

workProfileWidgetsDefault

enum (WorkProfileWidgetsDefault)

Specifica il comportamento predefinito per i widget del profilo di lavoro. Se il criterio non specifica workProfileWidgets per un'applicazione specifica, si comporterà in base al valore specificato qui.

exemptionsToShowWorkContactsInPersonalProfile

object (PackageNameList)

Elenco di app escluse dall'impostazione ShowWorkContactsInPersonalProfile. Affinché possa essere impostato, è necessario impostare ShowWorkContactsInPersonalProfile su uno dei seguenti valori:

Funzionalità supportata su Android 14 e versioni successive. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 14.

ShowWorkContactsInPersonalProfile

Indica se le app personali possono accedere ai contatti del profilo di lavoro, incluse le ricerche dei contatti e le chiamate in arrivo

Nota: quando un'app personale accede a un contatto di lavoro, non è possibile garantire che rimanga nella stessa app, poiché il contatto potrebbe essere condiviso o trasferito a qualsiasi altra app, a seconda del comportamento dell'app consentita.

Enum
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_UNSPECIFIED

Non specificato. Il valore predefinito è SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED.

Se questo criterio è impostato, non è necessario impostare exemptionsToShowWorkContactsInPersonalProfile.

SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED

Impedisce alle app personali di accedere ai contatti del profilo di lavoro e di cercare i contatti di lavoro.

Se questa impostazione è impostata, le app personali specificate in exemptionsToShowWorkContactsInPersonalProfile vengono inserite nella lista consentita e possono accedere direttamente ai contatti del profilo di lavoro.

Funzionalità supportata su Android 7.0 e versioni successive. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 7.0.

SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED

Predefinita. Consente alle app nel profilo personale di accedere ai contatti del profilo di lavoro, incluse le ricerche dei contatti e le chiamate in arrivo.

Se questa impostazione è impostata, le app personali specificate in exemptionsToShowWorkContactsInPersonalProfile vengono inserite nella lista bloccata e non possono accedere direttamente ai contatti del profilo di lavoro.

Funzionalità supportata su Android 7.0 e versioni successive. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 7.0.

SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED_EXCEPT_SYSTEM

Impedisce alla maggior parte delle app personali di accedere ai contatti del profilo di lavoro, incluse le ricerche dei contatti e le chiamate in arrivo, ad eccezione delle app Telefono, Messaggi e Contatti predefiniti OEM. Né le app Telefono, Messaggi e Contatti configurate dall'utente né altre app di sistema o di riproduzione installate potranno inviare query direttamente ai contatti di lavoro.

Se questa impostazione è impostata, le app personali specificate in exemptionsToShowWorkContactsInPersonalProfile vengono inserite nella lista consentita e possono accedere ai contatti del profilo di lavoro.

Funzionalità supportata su Android 14 e versioni successive. Se il criterio viene impostato su un dispositivo con versione di Android inferiore alla 14, il comportamento viene reimpostato su SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED e viene segnalato un nonComplianceDetail con API_LEVEL.

CrossProfileCopyPaste

Se il testo copiato da un profilo (personale o di lavoro) può essere incollato nell'altro profilo.

Enum
CROSS_PROFILE_COPY_PASTE_UNSPECIFIED Non specificato. Il valore predefinito è COPY_FROM_WORK_TO_PERSONAL_DISALLOWED
COPY_FROM_WORK_TO_PERSONAL_DISALLOWED Predefinita. Impedisce agli utenti di incollare dati nel testo del profilo personale copiato dal profilo di lavoro. Il testo copiato dal profilo personale può essere incollato nel profilo di lavoro, mentre il testo copiato dal profilo di lavoro può essere incollato nel profilo di lavoro.
CROSS_PROFILE_COPY_PASTE_ALLOWED Il testo copiato in uno dei due profili può essere incollato nell'altro profilo.

CrossProfileDataSharing

Se i dati di un profilo (personali o di lavoro) possono essere condivisi con le app dell'altro profilo. In particolare, controlla la semplice condivisione di dati tramite intent. La gestione di altri canali di comunicazione tra più profili, ad esempio la ricerca di contatti, il copia e incolla o le app personali e di lavoro collegate, viene configurata separatamente.

Enum
CROSS_PROFILE_DATA_SHARING_UNSPECIFIED Non specificato. Il valore predefinito è DATA_SHARING_FROM_WORK_TO_PERSONAL_DISALLOWED.
CROSS_PROFILE_DATA_SHARING_DISALLOWED Impedisce la condivisione dei dati dal profilo personale al profilo di lavoro e dal profilo di lavoro al profilo personale.
DATA_SHARING_FROM_WORK_TO_PERSONAL_DISALLOWED Predefinita. Impedisce agli utenti di condividere i dati del profilo di lavoro con le app del profilo personale. I dati personali possono essere condivisi con le app di lavoro.
CROSS_PROFILE_DATA_SHARING_ALLOWED I dati di entrambi i profili possono essere condivisi con l'altro profilo.

WorkProfileWidgetsDefault

Consente di stabilire se le applicazioni del profilo di lavoro possono aggiungere widget alla schermata Home, dove non sono definiti criteri specifici per le app. In caso contrario, le norme specifiche dell'app avranno la priorità.

Enum
WORK_PROFILE_WIDGETS_DEFAULT_UNSPECIFIED Non specificato. Il valore predefinito è WORK_PROFILE_WIDGETS_DEFAULT_DISALLOWED.
WORK_PROFILE_WIDGETS_DEFAULT_ALLOWED I widget dei profili di lavoro sono consentiti per impostazione predefinita. Ciò significa che se il criterio non specifica workProfileWidgets come WORK_PROFILE_WIDGETS_DISALLOWED per l'applicazione, potrà aggiungere widget alla schermata Home.
WORK_PROFILE_WIDGETS_DEFAULT_DISALLOWED I widget del profilo di lavoro non sono consentiti per impostazione predefinita. Ciò significa che se il criterio non specifica workProfileWidgets come WORK_PROFILE_WIDGETS_ALLOWED per l'applicazione, non sarà possibile aggiungere widget alla schermata Home.

PreferentialNetworkService

Consente di stabilire se attivare o meno il servizio di rete preferito nel profilo di lavoro. Per ulteriori dettagli, consulta preferentialNetworkService.

Enum
PREFERENTIAL_NETWORK_SERVICE_UNSPECIFIED Non specificato. Il valore predefinito è PREFERENTIAL_NETWORK_SERVICES_DISABLED.
PREFERENTIAL_NETWORK_SERVICE_DISABLED Il servizio di rete preferito è disattivato nel profilo di lavoro.
PREFERENTIAL_NETWORK_SERVICE_ENABLED Il servizio di rete preferito è abilitato nel profilo di lavoro.

UsageLog

Consente di controllare i tipi di log delle attività del dispositivo raccolti dal dispositivo e segnalati tramite la notifica Pub/Sub.

Rappresentazione JSON
{
  "enabledLogTypes": [
    enum (LogType)
  ],
  "uploadOnCellularAllowed": [
    enum (LogType)
  ]
}
Campi
enabledLogTypes[]

enum (LogType)

Specifica i tipi di log attivati. Tieni presente che gli utenti riceveranno messaggi sul dispositivo quando è abilitata la registrazione dell'utilizzo.

uploadOnCellularAllowed[]

enum (LogType)

Specifica quali tipi di log attivati possono essere caricati tramite dati mobili. Per impostazione predefinita, i log vengono messi in coda per il caricamento quando il dispositivo si connette a una rete Wi-Fi.

LogType

I tipi di log delle attività del dispositivo segnalati dal dispositivo.

Enum
LOG_TYPE_UNSPECIFIED Questo valore non è utilizzato.
SECURITY_LOGS Consente la registrazione degli eventi di sicurezza sul dispositivo, ad esempio quando la password del dispositivo viene inserita in modo errato o quando viene montato un dispositivo di archiviazione rimovibile. Consulta UsageLogEvent per una descrizione completa degli eventi di sicurezza registrati. Opzione supportata per i dispositivi completamente gestiti su Android 7 e versioni successive. Opzione supportata per i dispositivi di proprietà dell'azienda con un profilo di lavoro su Android 12 e versioni successive, in cui vengono registrati solo gli eventi di sicurezza del profilo di lavoro. Può essere sostituito dall'ambito delegato dell'applicazione SECURITY_LOGS
NETWORK_ACTIVITY_LOGS Attiva il logging degli eventi di rete sul dispositivo, come ricerche DNS e connessioni TCP. Consulta UsageLogEvent per una descrizione completa degli eventi di rete registrati. Opzione supportata per i dispositivi completamente gestiti su Android 8 e versioni successive. Opzione supportata per i dispositivi di proprietà dell'azienda con un profilo di lavoro su Android 12 e versioni successive, su cui vengono registrati solo gli eventi di rete del profilo di lavoro. Può essere sostituito dall'ambito delegato dell'applicazione NETWORK_ACTIVITY_LOGS

CameraAccess

Consente di controllare l'utilizzo della videocamera e se l'utente ha accesso al pulsante di attivazione/disattivazione di accesso alla videocamera. L'opzione di attivazione/disattivazione dell'accesso alla fotocamera è disponibile su Android 12 e versioni successive. In linea di principio, la possibilità di disattivare la fotocamera si applica a livello di dispositivo sui dispositivi completamente gestiti e solo all'interno del profilo di lavoro sui dispositivi con un profilo di lavoro. La possibilità di disattivare l'opzione di attivazione/disattivazione di accesso alla fotocamera si applica solo ai dispositivi completamente gestiti, nel qual caso viene applicata a livello di dispositivo. Per informazioni specifiche, consulta i valori di enumerazione.

Enum
CAMERA_ACCESS_UNSPECIFIED Se cameraDisabled è true, equivale a CAMERA_ACCESS_DISABLED. In caso contrario, equivale a CAMERA_ACCESS_USER_CHOICE.
CAMERA_ACCESS_USER_CHOICE Il campo cameraDisabled è ignorato. Questo è il comportamento predefinito del dispositivo, in quanto sono disponibili tutte le videocamere. Su Android 12 e versioni successive, l'utente può utilizzare il pulsante di attivazione/disattivazione di accesso alla fotocamera.
CAMERA_ACCESS_DISABLED

Il campo cameraDisabled è ignorato. Tutte le videocamere del dispositivo sono disattivate (per i dispositivi completamente gestiti l'impostazione si applica a livello di dispositivo, mentre per i profili di lavoro si applica solo al profilo di lavoro).

Non sono presenti restrizioni esplicite sul pulsante di accesso alla fotocamera su Android 12 e versioni successive: sui dispositivi completamente gestiti, l'opzione di attivazione/disattivazione di accesso alla fotocamera non ha effetto perché tutte le videocamere sono disattivate. Sui dispositivi con un profilo di lavoro, questa opzione di attivazione/disattivazione non ha alcun effetto sulle app del profilo di lavoro, ma interessa le app esterne al profilo.

CAMERA_ACCESS_ENFORCED Il campo cameraDisabled è ignorato. Sono disponibili tutte le fotocamere sul dispositivo. Sui dispositivi completamente gestiti con Android 12 e versioni successive, l'utente non può utilizzare il pulsante di attivazione/disattivazione di accesso alla fotocamera. Sui dispositivi non completamente gestiti o che eseguono Android 11 o versioni precedenti, questo valore equivale a CAMERA_ACCESS_USER_CHOICE.

MicrophoneAccess

Sui dispositivi completamente gestiti, consente di controllare l'utilizzo del microfono e se l'utente ha accesso all'opzione di attivazione/disattivazione di accesso al microfono. Questa impostazione non ha effetto sui dispositivi non completamente gestiti. L'opzione di attivazione/disattivazione dell'accesso al microfono è disponibile su Android 12 e versioni successive.

Enum
MICROPHONE_ACCESS_UNSPECIFIED Se unmuteMicrophoneDisabled è true, equivale a MICROPHONE_ACCESS_DISABLED. In caso contrario, equivale a MICROPHONE_ACCESS_USER_CHOICE.
MICROPHONE_ACCESS_USER_CHOICE Il campo unmuteMicrophoneDisabled è ignorato. Questo è il comportamento predefinito del dispositivo: il microfono del dispositivo è disponibile. Su Android 12 e versioni successive, l'utente può utilizzare il pulsante di attivazione/disattivazione di accesso al microfono.
MICROPHONE_ACCESS_DISABLED

Il campo unmuteMicrophoneDisabled è ignorato. Il microfono del dispositivo è disattivato (per i dispositivi completamente gestiti questa impostazione viene applicata a livello di dispositivo).

L'opzione di attivazione/disattivazione dell'accesso al microfono non ha alcun effetto perché il microfono è disattivato.

MICROPHONE_ACCESS_ENFORCED Il campo unmuteMicrophoneDisabled è ignorato. Il microfono del dispositivo è disponibile. Sui dispositivi con Android 12 e versioni successive, l'utente non può utilizzare l'opzione di attivazione/disattivazione di accesso al microfono. Sui dispositivi con Android 11 o versioni precedenti, il valore equivale a MICROPHONE_ACCESS_USER_CHOICE.

DeviceConnectivityManagement

Include i controlli per la connettività dei dispositivi, ad esempio Wi-Fi, accesso ai dati USB, connessioni da tastiera/mouse e altro ancora.

Rappresentazione JSON
{
  "usbDataAccess": enum (UsbDataAccess),
  "configureWifi": enum (ConfigureWifi),
  "wifiDirectSettings": enum (WifiDirectSettings),
  "tetheringSettings": enum (TetheringSettings)
}
Campi
usbDataAccess

enum (UsbDataAccess)

Consente di stabilire quali file e/o dati possono essere trasferiti tramite USB. Funzionalità supportata solo sui dispositivi di proprietà dell'azienda.

configureWifi

enum (ConfigureWifi)

Consente di gestire i privilegi di configurazione Wi-Fi. A seconda dell'opzione impostata, l'utente avrà un controllo completo, limitato o nullo per la configurazione delle reti Wi-Fi.

wifiDirectSettings

enum (WifiDirectSettings)

Consente di gestire la configurazione e l'utilizzo delle impostazioni Wi-Fi Direct. Funzionalità supportata sui dispositivi di proprietà dell'azienda con Android 13 e versioni successive.

tetheringSettings

enum (TetheringSettings)

Consente di gestire le impostazioni del tethering. In base al valore impostato, all'utente è vietato l'utilizzo di diverse forme di tethering, in parte o del tutto.

UsbDataAccess

Consente di stabilire quali file e/o dati possono essere trasferiti tramite USB. Non influisce sulle funzioni di ricarica. Funzionalità supportata solo sui dispositivi di proprietà dell'azienda.

Enum
USB_DATA_ACCESS_UNSPECIFIED Non specificato. Il valore predefinito è DISALLOW_USB_FILE_TRANSFER.
ALLOW_USB_DATA_TRANSFER Sono consentiti tutti i tipi di trasferimenti di dati USB. usbFileTransferDisabled viene ignorato.
DISALLOW_USB_FILE_TRANSFER Il trasferimento di file tramite USB non è consentito. Sono consentiti altri tipi di connessioni dati USB, come mouse e tastiera. usbFileTransferDisabled viene ignorato.
DISALLOW_USB_DATA_TRANSFER Se impostato, tutti i tipi di trasferimenti di dati USB sono vietati. Opzione supportata per i dispositivi con Android 12 o versioni successive con USB HAL 1.3 o versioni successive. Se l'impostazione non è supportata, verrà impostato DISALLOW_USB_FILE_TRANSFER. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 12. Viene segnalato un valore nonComplianceDetail con DEVICE_INCOMPATIBLE se il dispositivo non dispone di USB HAL 1.3 o versioni successive. usbFileTransferDisabled viene ignorato.

ConfigureWifi

Consente di gestire i privilegi di configurazione Wi-Fi. A seconda dell'opzione impostata, l'utente avrà un controllo completo, limitato o nessun controllo per la configurazione delle reti Wi-Fi.

Enum
CONFIGURE_WIFI_UNSPECIFIED Non specificato. Il valore predefinito è ALLOW_CONFIGURING_WIFI, a meno che wifiConfigDisabled non sia impostato su true. Se wifiConfigDisabled è impostato su true, questo equivale a DISALLOW_CONFIGURING_WIFI.
ALLOW_CONFIGURING_WIFI L'utente può configurare il Wi-Fi. wifiConfigDisabled viene ignorato.
DISALLOW_ADD_WIFI_CONFIG L'aggiunta di nuove configurazioni Wi-Fi non è consentita. L'utente può passare solo tra le reti già configurate. Funzionalità supportata su Android 13 e versioni successive, sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda. Se l'impostazione non è supportata, viene configurata ALLOW_CONFIGURING_WIFI. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13. wifiConfigDisabled viene ignorato.
DISALLOW_CONFIGURING_WIFI Non consente di configurare le reti Wi-Fi. L'impostazione wifiConfigDisabled viene ignorata quando viene configurato questo valore. Funzionalità supportata sui dispositivi completamente gestiti e sul profilo di lavoro sui dispositivi di proprietà dell'azienda, su tutti i livelli API supportati. Per i dispositivi completamente gestiti, questa impostazione rimuove tutte le reti configurate e conserva solo quelle configurate utilizzando il criterio openNetworkConfiguration. Per i profili di lavoro sui dispositivi di proprietà dell'azienda, le reti configurate esistenti non sono interessate e l'utente non può aggiungere, rimuovere o modificare le reti Wi-Fi. Nota:se non è possibile stabilire una connessione di rete al momento dell'avvio e la configurazione del Wi-Fi è disabilitata, verrà mostrato l'escape hatch di escape per aggiornare il criterio relativo ai dispositivi (vedi networkEscapeHatchEnabled).

WifiDirectSettings

Consente di gestire le impostazioni Wi-Fi Direct. Funzionalità supportata sui dispositivi di proprietà dell'azienda con Android 13 e versioni successive.

Enum
WIFI_DIRECT_SETTINGS_UNSPECIFIED Non specificato. Il valore predefinito è ALLOW_WIFI_DIRECT
ALLOW_WIFI_DIRECT L'utente può utilizzare Wi-Fi Direct.
DISALLOW_WIFI_DIRECT L'utente non è autorizzato a utilizzare Wi-Fi Direct. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13.

TetheringSettings

Consente di stabilire fino a che punto l'utente può utilizzare diverse forme di tethering, ad esempio il tethering Wi-Fi, il tethering Bluetooth e così via.

Enum
TETHERING_SETTINGS_UNSPECIFIED Non specificato. Il valore predefinito è ALLOW_ALL_TETHERING, a meno che tetheringConfigDisabled non sia impostato su true. Se tetheringConfigDisabled è impostato su true, questo equivale a DISALLOW_ALL_TETHERING.
ALLOW_ALL_TETHERING Consente di configurare e utilizzare tutte le forme di tethering. tetheringConfigDisabled viene ignorato.
DISALLOW_WIFI_TETHERING Non consente all'utente di utilizzare il tethering Wi-Fi. Funzionalità supportata sui dispositivi di proprietà dell'azienda con Android 13 e versioni successive. Se l'impostazione non è supportata, verrà impostato ALLOW_ALL_TETHERING. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13. tetheringConfigDisabled viene ignorato.
DISALLOW_ALL_TETHERING Non consente tutte le forme di tethering. Funzionalità supportata sui dispositivi completamente gestiti e sul profilo di lavoro sui dispositivi di proprietà dell'azienda, su tutte le versioni di Android supportate. L'impostazione tetheringConfigDisabled viene ignorata.

DeviceRadioState

Controlli per le impostazioni della radio del dispositivo.

Rappresentazione JSON
{
  "wifiState": enum (WifiState),
  "airplaneModeState": enum (AirplaneModeState),
  "ultraWidebandState": enum (UltraWidebandState),
  "cellularTwoGState": enum (CellularTwoGState),
  "minimumWifiSecurityLevel": enum (MinimumWifiSecurityLevel)
}
Campi
wifiState

enum (WifiState)

Consente di controllare lo stato attuale della rete Wi-Fi e se l'utente può cambiarlo.

airplaneModeState

enum (AirplaneModeState)

Consente di stabilire se l'utente può attivare o meno la modalità aereo.

ultraWidebandState

enum (UltraWidebandState)

Controlla lo stato dell'impostazione della banda ultralarga e se l'utente può attivarla o disattivarla.

cellularTwoGState

enum (CellularTwoGState)

Consente di stabilire se l'utente può attivare o meno l'impostazione della rete dati 2G.

minimumWifiSecurityLevel

enum (MinimumWifiSecurityLevel)

Il livello di sicurezza minimo richiesto delle reti Wi-Fi a cui può connettersi il dispositivo.

WifiState

Consente di stabilire se il Wi-Fi è attivo o meno come stato e se l'utente può modificarlo. Funzionalità supportata sui dispositivi di proprietà dell'azienda con Android 13 e versioni successive.

Enum
WIFI_STATE_UNSPECIFIED Non specificato. Il valore predefinito è WIFI_STATE_USER_CHOICE
WIFI_STATE_USER_CHOICE L'utente può attivare/disattivare il Wi-Fi.
WIFI_ENABLED Il Wi-Fi è attivo e l'utente non è autorizzato a disattivarlo. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13.
WIFI_DISABLED Il Wi-Fi è disattivato e l'utente non è autorizzato ad attivarlo. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13.

AirplaneModeState

Consente di controllare lo stato della modalità aereo e se l'utente può attivarla o disattivarla. Funzionalità supportata su Android 9 e versioni successive. Funzionalità supportata sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda.

Enum
AIRPLANE_MODE_STATE_UNSPECIFIED Non specificato. Il valore predefinito è AIRPLANE_MODE_USER_CHOICE.
AIRPLANE_MODE_USER_CHOICE L'utente può attivare o disattivare la modalità aereo.
AIRPLANE_MODE_DISABLED Modalità aereo disattivata. L'utente non è autorizzato ad attivare la modalità aereo. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 9.

UltraWidebandState

Consente di controllare lo stato dell'impostazione della banda ultralarga e se l'utente può attivarla o disattivarla. Funzionalità supportata su Android 14 e versioni successive. Funzionalità supportata sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda.

Enum
ULTRA_WIDEBAND_STATE_UNSPECIFIED Non specificato. Il valore predefinito è ULTRA_WIDEBAND_USER_CHOICE.
ULTRA_WIDEBAND_USER_CHOICE L'utente può attivare o disattivare la banda ultralarga.
ULTRA_WIDEBAND_DISABLED La banda ultralarga è disattivata. L'utente non può attivare la banda ultralarga tramite le impostazioni. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 14.

CellularTwoGState

Consente di controllare lo stato dell'impostazione della rete dati 2G e se l'utente può attivarla o disattivarla. Funzionalità supportata su Android 14 e versioni successive. Funzionalità supportata sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda.

Enum
CELLULAR_TWO_G_STATE_UNSPECIFIED Non specificato. Il valore predefinito è CELLULAR_TWO_G_USER_CHOICE.
CELLULAR_TWO_G_USER_CHOICE L'utente può attivare o disattivare la rete 2G cellulare.
CELLULAR_TWO_G_DISABLED Rete dati 2G disattivata. L'utente non è autorizzato ad attivare la rete 2G cellulare tramite le impostazioni. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 14.

MinimumWifiSecurityLevel

Definisce i diversi livelli minimi di sicurezza Wi-Fi richiesti per connettersi alle reti Wi-Fi. Funzionalità supportata su Android 13 e versioni successive. Funzionalità supportata sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda.

Enum
MINIMUM_WIFI_SECURITY_LEVEL_UNSPECIFIED Il valore predefinito è OPEN_NETWORK_SECURITY, quindi il dispositivo potrà connettersi a tutti i tipi di reti Wi-Fi.
OPEN_NETWORK_SECURITY Il dispositivo potrà connettersi a tutti i tipi di reti Wi-Fi.
PERSONAL_NETWORK_SECURITY Il livello di sicurezza minimo richiesto è una rete personale, ad esempio WEP o WPA2-PSK. Il dispositivo non potrà connettersi a reti Wi-Fi aperte. Questo valore è più restrittivo di OPEN_NETWORK_SECURITY. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13.
ENTERPRISE_NETWORK_SECURITY Il livello di sicurezza minimo richiesto è una rete EAP aziendale. Il dispositivo non potrà connettersi alla rete Wi-Fi al di sotto di questo livello di sicurezza. Questo valore è più restrittivo di PERSONAL_NETWORK_SECURITY. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13.
ENTERPRISE_BIT192_NETWORK_SECURITY Il livello di sicurezza minimo richiesto è una rete aziendale a 192 bit. Il dispositivo non potrà connettersi alla rete Wi-Fi al di sotto di questo livello di sicurezza. Questo valore è più restrittivo di ENTERPRISE_NETWORK_SECURITY. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13.

CredentialProviderPolicyDefault

Consente di stabilire quali app possono fungere da fornitori di credenziali su Android 14 e versioni successive. Queste app memorizzano le credenziali. Consulta questo e questo per i dettagli. Vedi anche credentialProviderPolicy.

Enum
CREDENTIAL_PROVIDER_POLICY_DEFAULT_UNSPECIFIED Non specificato. Il valore predefinito è CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED.
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED Le app con credentialProviderPolicy non specificato non sono autorizzate a fungere da provider di credenziali.
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED_EXCEPT_SYSTEM Le app con credentialProviderPolicy non specificato non sono autorizzate a fungere da provider di credenziali, ad eccezione dei provider di credenziali predefiniti dell'OEM. I provider di credenziali predefiniti OEM sono sempre autorizzati ad agire come provider di credenziali.

PrintingPolicy

Consente di stabilire se consentire o meno la stampa. Questa funzionalità è supportata sui dispositivi con Android 9 e versioni successive.

Enum
PRINTING_POLICY_UNSPECIFIED Non specificato. Il valore predefinito è PRINTING_ALLOWED.
PRINTING_DISALLOWED La stampa non è consentita. Viene segnalato un valore nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 9.
PRINTING_ALLOWED La stampa è consentita.

Metodi

delete

Elimina un criterio.

get

Recupera un criterio.

list

Elenca le norme per una determinata impresa.

patch

Consente di aggiornare o creare un criterio.