Attributi dei livelli di accesso

I livelli di accesso definiscono vari attributi utilizzati per filtrare le richieste effettuate a determinate risorse. La tabella seguente elenca gli attributi supportati dai livelli di accesso e fornisce ulteriori dettagli su ciascun attributo.

Quando crei o modifichi un livello di accesso utilizzando lo strumento a riga di comando gcloud, devi formattare gli attributi in YAML. Questa tabella include la sintassi YAML per ogni attributo e i valori validi. Sono inclusi anche i link alle informazioni di riferimento REST e RPC per ciascun attributo.

Per saperne di più sui livelli di accesso e su YAML, consulta l'esempio di YAML per un livello di accesso.

Puoi includere i seguenti attributi nel tuo livello di accesso:

• Subnet IP

• Posizioni geografiche

• Dipendenze livello di accesso

• Principals

• Policy per i dispositivi

Attributi
Subnet IP	Descrizione Verifica se una richiesta proviene da uno o più blocchi CIDR IPv4 e/o IPv6 specificati. Quando specifichi più di una subnet IP, i valori inseriti vengono combinati utilizzando un operatore OR quando viene valutata la condizione. La richiesta deve corrispondere a uno dei valori specificati affinché la condizione restituisca il valore true. YAML ipSubnetworks Valori validi Un elenco di uno o più blocchi CIDR IPv4 e/o IPv6. Riferimento API REST RPC
Posizioni geografiche	Descrizione Verifica se una richiesta proviene da una posizione geografica specifica. Le posizioni geografiche sono identificate dai corrispondenti codici ISO 3166-1 alpha-2. Attenzione:l'origine di una richiesta è determinata dalla geolocalizzazione dell'indirizzo IP da cui ha avuto origine la richiesta. Per questo motivo, l'attributo posizione geografica funziona solo per le richieste provenienti da un indirizzo IP pubblico. Poiché gli indirizzi IP privati non possono essere geolocalizzati, i livelli di accesso che richiedono una posizione geografica rifiuteranno sempre le richieste provenienti da indirizzi IP privati e non supportano le richieste effettuate utilizzando l'accesso privato Google. Quando specifichi più di una posizione geografica, i valori inseriti vengono valutati con la logica OR. L'accesso viene concesso agli utenti che si trovano in una delle posizioni geografiche specificate. Nota:se un utente si connette alle tue risorse tramite una VPN, Gestore contesto accesso determina l'accesso in base alla posizione geografica derivata dell'indirizzo IP pubblico del server VPN, anziché alla posizione fisica effettiva dell'utente. Di conseguenza, se l'indirizzo IP del server VPN corrisponde a una regione consentita, la richiesta è consentita, indipendentemente dalla posizione fisica dell'utente. Per contribuire a migliorare la sicurezza negli ambienti con requisiti di sicurezza elevati, ti consigliamo di integrare le regole basate sulla regione con indicatori aggiuntivi, come la conformità dei dispositivi. YAML regions Valori validi Un elenco di uno o più codici ISO 3166-1 alpha-2. Riferimento API REST RPC
Dipendenze livello di accesso	Descrizione Controlla se una richiesta soddisfa i criteri di uno o più livelli di accesso. YAML requiredAccessLevels Valori validi Un elenco di uno o più livelli di accesso esistenti formattati come segue: accessPolicies/POLICY-NAME/accessLevels/LEVEL-NAME Dove: POLICY-NAME è il nome numerico della policy di accesso della tua organizzazione. LEVEL-NAME è il nome del livello di accesso che vuoi aggiungere come dipendenza. Riferimento API REST RPC
Principals	Descrizione Controlla se una richiesta proviene da un utente o un account di servizio specifico. Questo attributo può essere incluso nelle condizioni solo quando crei o modifichi un livello di accesso utilizzando lo strumento a riga di comando gcloud o l'API Gestore contesto accesso. Se hai creato un livello di accesso utilizzando la console Google Cloud , puoi utilizzare uno dei metodi menzionati in precedenza per aggiungere principal a quel livello di accesso. YAML members Valori validi Un elenco di uno o più account utente o service account, formattati come segue: user: EMAIL serviceAccount: EMAIL Dove: EMAIL è l'email corrispondente all'utente o al account di servizio che vuoi includere nel livello di accesso. I gruppi non sono supportati. Riferimento API REST RPC
Policy per i dispositivi	Requisiti Per utilizzare gli attributi delle policy per i dispositivi con i dispositivi mobili, devi configurare MDM per la tua organizzazione. Per utilizzare gli attributi delle policy per i dispositivi con altri dispositivi, deve essere attivata la verifica degli endpoint. Descrizione Una policy per i dispositivi è una raccolta di attributi che vengono utilizzati per filtrare le richieste in base alle informazioni sul dispositivo da cui ha avuto origine la richiesta. Ad esempio, gli attributi delle policy per i dispositivi vengono utilizzati insieme a Identity-Aware Proxy per supportare l'accesso sensibile al contesto. YAML devicePolicy Valori validi devicePolicy è un elenco di uno o più attributi delle policy per i dispositivi. Sono supportati i seguenti attributi: Richiedi blocco schermo Crittografia dello spazio di archiviazione Richiedi approvazione amministratore Richiedi dispositivo di proprietà dell'azienda Policy del sistema operativo Solo alcuni attributi delle policy per i dispositivi possono essere utilizzati con i dispositivi mobili. La riga Supporta i dispositivi mobili indica se un attributo può essere utilizzato con i dispositivi mobili. Riferimento API REST RPC Attributi dei criteri dispositivo Richiedi blocco schermo Descrizione Controlla se su un dispositivo è attivo il blocco schermo. Supporta i dispositivi mobili Sì YAML requireScreenlock Valori validi true false Se omesso, il valore predefinito è false. Riferimento API REST RPC Crittografia dello spazio di archiviazione Descrizione Controlla se il dispositivo è criptato, non criptato o non supporta la crittografia dello spazio di archiviazione. Supporta i dispositivi mobili Sì Importante: affinché un dispositivo iOS soddisfi l'attributo di crittografia dello spazio di archiviazione, sul dispositivo deve essere attivato il blocco schermo. YAML allowedEncryptionStatuses Valori validi Uno o più dei seguenti valori: ENCRYPTION_UNSUPPORTED ENCRYPTED UNENCRYPTED Riferimento API REST RPC Richiedi approvazione amministratore Descrizione Controlla se il dispositivo è stato approvato da un amministratore. Supporta i dispositivi mobili Sì YAML requireAdminApproval Valori validi true false Se omesso, il valore predefinito è false. Riferimento API Nessuno Richiedi dispositivo di proprietà aziendale Descrizione Controlla se il dispositivo è di proprietà della tua azienda. Supporta i dispositivi mobili Sì YAML requireCorpOwned Valori validi true false Se omesso, il valore predefinito è false. Riferimento API Nessuno Policy del sistema operativo Descrizione Controlla se un dispositivo utilizza un sistema operativo specificato. Inoltre, puoi specificare una versione minima del sistema operativo che un dispositivo deve utilizzare. Se crei una policy di ChromeOS, puoi anche specificare che deve essere un ChromeOS verificato . Quando selezioni più di un sistema operativo, i valori selezionati vengono valutati con l'operatore OR. L'accesso viene concesso agli utenti che hanno uno dei sistemi operativi specificati. Supporta i dispositivi mobili Sì YAML osConstraints Valori validi osConstraints è un elenco che deve includere una o più istanze di osType. osType può essere accoppiato a un'istanza di minimumVersion, ma minimumVersion non è obbligatorio. osType deve includere un elenco di uno o più dei seguenti valori: DESKTOP_MAC DESKTOP_WINDOWS DESKTOP_CHROME_OS DESKTOP_LINUX IOS ANDROID GOOGLEBOOK_OS minimumVersion è facoltativo. Se utilizzata, deve essere inclusa con osType. minimumVersion deve includere una versione minima formattata come MAJOR.MINOR.PATCH. Ad esempio: 10.5.301. Se specifichi DESKTOP_CHROME_OS per osType, puoi includere facoltativamente requireVerifiedChromeOs. I valori validi per requireVerifiedChromeOs sono: true false Se specifichi IOS o ANDROID per osType, puoi includere facoltativamente qualsiasi attributo della policy per i dispositivi che supporta i dispositivi mobili. Riferimento API REST RPC