Atributos de nivel de acceso

Los niveles de acceso definen varios atributos que se usan para filtrar las solicitudes realizadas a ciertos recursos. En la siguiente tabla, se enumeran los atributos que admiten los niveles de acceso y se proporcionan detalles adicionales sobre cada atributo.

Cuando creas o modificas un nivel de acceso con la herramienta de línea de comandos de gcloud, debes dar formato a los atributos en YAML. En esta tabla, se incluye la sintaxis YAML para cada atributo y los valores válidos. También se incluyen vínculos a la información de referencia de REST y RPC para cada atributo.

A fin de obtener más información sobre los niveles de acceso y YAML, consulta el ejemplo de YAML para un nivel de acceso.

Puedes incluir los siguientes atributos en tu nivel de acceso:

Atributos

Subredes de IP

Descripción

Comprueba si una solicitud proviene de uno o más bloques CIDR de IPv4 o IPv6 que especifiques.

No puedes incluir rangos de IP privados para este atributo. Por ejemplo, 192.168.0.0/16 o 172.16.0.0/12.

Cuando especificas más de una subred IP, los valores que ingresas se combinan con un operador OR cuando se evalúa la condición. La solicitud debe coincidir con cualquiera de los valores que especifiques para que la condición se evalúe como verdadera.

YAML ipSubnetworks
Valores válidos Una lista de uno o más bloques CIDR IPv4 o IPv6.
Referencia de la API

regiones

Descripción

Comprueba si una solicitud se originó de una región específica. Las regiones se identifican con los códigos ISO 3166-1 alpha-2 correspondientes.

Cuando especificas más de una región, los valores que ingresas son ORD cuando se evalúa la condición. Se otorga acceso a los usuarios si se encuentran en una de las regiones especificadas.

YAML regions
Valores válidos Una lista de uno o más códigos ISO 3166-1 alpha-2.
Referencia de la API Ninguna

Dependencia de nivel de acceso

Descripción

Verifica si una solicitud cumple con los criterios de uno o más niveles de acceso.

YAML requiredAccessLevels
Valores válidos

Una lista de uno o más niveles de acceso existentes con el siguiente formato:

accessPolicies/POLICY-NAME/accessLevels/LEVEL-NAME

Donde:

  • POLICY-NAME es el nombre numérico de la política de acceso de tu organización.
  • LEVEL-NAME es el nombre del nivel de acceso que deseas agregar como dependencia.
Referencia de la API

Principales

Descripción

Comprueba si una solicitud proviene de un usuario específico o de una cuenta de servicio.

Este atributo solo se puede incluir en las condiciones cuando se crea o modifica un nivel de acceso con la herramienta de línea de comandos de gcloud o la API de Access Context Manager. Si creaste un nivel de acceso con la consola de Google Cloud, se puede usar cualquiera de los métodos mencionados anteriormente para agregar principales a ese nivel de acceso.

YAML members
Valores válidos

Una lista de una o más cuentas de usuario o de servicio, con el siguiente formato:

  • user: EMAIL
  • serviceAccount: EMAIL

Donde:

  • EMAIL es el correo electrónico que corresponde al usuario o la cuenta de servicio que deseas incluir en el nivel de acceso.

No se admiten los grupos.

Referencia de la API

Política de dispositivo

Requisitos

Para usar los atributos de la política de dispositivo con dispositivos móviles, debes configurar la MDM en tu organización.

Para usar los atributos de política de dispositivo con otros dispositivos, se debes habilitar la Verificación de extremos.

Descripción

Una política de dispositivo es una colección de atributos que se usan para filtrar solicitudes según la información del dispositivo en el que se originó.

Por ejemplo, los atributos de política de dispositivo se usan junto con Identity-Aware Proxy para admitir el acceso adaptado al contexto.

YAML devicePolicy
Valores válidos

devicePolicy es una lista de uno o más atributos de las políticas del dispositivo. Los siguientes atributos son compatibles:

Solo se pueden usar ciertos atributos de la política de dispositivo con los dispositivos móviles. En la fila Compatible con dispositivos móviles, se identifica si un atributo se puede usar con dispositivos móviles.

Referencia de la API
Atributos de la política de dispositivo
Exigir bloqueo de pantalla
Descripción

Comprueba si un dispositivo tiene habilitado el bloqueo de pantalla.

Compatibilidad con dispositivos móviles
YAML requireScreenlock
Valores válidos
  • true
  • false

Si se omite, el valor predeterminado es false.

Referencia de la API
Encriptación de almacenamiento
Descripción Comprueba si el dispositivo está encriptado, no encriptado o no es compatible con la encriptación de almacenamiento.
Compatibilidad con dispositivos móviles

YAML allowedEncryptionStatuses
Valores válidos

Uno o más de los siguientes valores:

  • ENCRYPTION_UNSUPPORTED
  • ENCRYPTED
  • UNENCRYPTED
Referencia de la API
Exigir aprobación del administrador
Descripción Comprueba si un administrador aprobó el dispositivo.
Compatibilidad con dispositivos móviles
YAML requireAdminApproval
Valores válidos
  • true
  • false
  • Si se omite, el valor predeterminado es false.

Referencia de la API Ninguna
Exigir dispositivo propiedad de la empresa
Descripción Comprueba si el dispositivo es propiedad de tu empresa.
Compatibilidad con dispositivos móviles
YAML requireCorpOwned
Valores válidos
  • true
  • false
  • Si se omite, el valor predeterminado es false.

Referencia de la API Ninguna
Políticas del SO
Descripción

Comprueba si un dispositivo usa un sistema operativo especificado. Además, puedes especificar una versión mínima de un SO que debe usar un dispositivo.

Si creas una política de ChromeOS, también puedes especificar que debe ser un ChromeOS verificado .

Cuando seleccionas más de un sistema operativo, los valores que seleccionas son ORd cuando se evalúa la condición. Se otorga acceso a los usuarios si tienen uno de los sistemas operativos que especifiques.

Compatibilidad con dispositivos móviles
YAML osConstraints
Valores válidos

osConstraints es una lista que debe incluir una o más instancias de osType. osType se puede vincular con una instancia de minimumVersion, pero minimumVersion no es obligatorio.

  • osType debe incluir una lista de uno o más de los siguientes valores:

    • DESKTOP_MAC
    • DESKTOP_WINDOWS
    • DESKTOP_CHROME_OS
    • DESKTOP_LINUX
    • IOS
    • ANDROID
  • minimumVersion es opcional. Si se usa, debe incluirse en osType.

    minimumVersion debe incluir una versión mínima con el formato MAJOR.MINOR.PATCH.

    Por ejemplo: 10.5.301.

  • Si especificas DESKTOP_CHROME_OS para osType, tienes la opción de incluir requireVerifiedChromeOs.

    Los valores válidos para requireVerifiedChromeOs son los siguientes:

    • true
    • false
  • Si especificas IOS o ANDROID para osType, puedes incluir de manera opcional cualquier atributo de política de dispositivo que admita dispositivos móviles.

Referencia de la API