En esta página, se detallan los objetos y atributos que se usan para compilar las expresiones de Common Expression Language (CEL) para los niveles de acceso personalizados. Se incluyen ejemplos.
En esta sección, se enumeran los atributos admitidos por el objeto levels.
Atributos
level name
Tipo
boolean
Descripción
level name corresponde al nombre de un nivel de acceso existente.
Cuando se usa, también se deben cumplir las condiciones del nivel de acceso especificado, además de los otros requisitos de tu nivel de acceso personalizado.
Ejemplo:
levels.allow_corp_ips
En el que allow_corp_ips es el nombre de un nivel de acceso.
Atributo device
En esta sección, se enumeran los atributos admitidos por el objeto device.
Atributos
encryption_status
Tipo
enum
Descripción
Describe el estado de encriptación del dispositivo.
Valores de enumeración
enum DeviceEncryptionStatus {
// The encryption status of the device is not specified or not known.
ENCRYPTION_UNSPECIFIED == 0;
// The device does not support encryption.
ENCRYPTION_UNSUPPORTED == 1;
// The device supports encryption, but is currently unencrypted.
UNENCRYPTED == 2;
// The device is encrypted.
ENCRYPTED == 3;
}
Indica si el administrador del dominio aprobó el dispositivo.
Ejemplo:
device.is_admin_approved_device == true
is_corp_owned_device
Tipo
boolean
Descripción
Si el dispositivo es propiedad de la organización
Ejemplo:
device.is_corp_owned_device == true
is_secured_with_screenlock
Tipo
boolean
Descripción
Indica si el dispositivo tiene habilitada la función de bloqueo de pantalla.
Ejemplo:
device.is_secured_with_screenlock == true
os_type
Tipo
enum
Descripción
Identifica el sistema operativo que usa el dispositivo.
Valores de enumeración
enum OsType {
// The operating system of the device is not specified or not known.
OS_UNSPECIFIED == 0;
// A desktop Mac operating system.
DESKTOP_MAC == 1;
// A desktop Windows operating system.
DESKTOP_WINDOWS == 2;
// A desktop Linux operating system.
DESKTOP_LINUX == 3;
// An Android operating system.
ANDROID == 4 ;
// An iOS operating system.
IOS == 5;
// A desktop ChromeOS operating system.
DESKTOP_CHROME_OS == 6;
}
El objeto vendors se usa para acceder a los datos proporcionados por proveedores externos de seguridad y administración de extremos. Cada proveedor puede propagar tres atributos de nivel superior compartidos: is_compliant_device, is_managed_device y device_health_score.
Además, los proveedores pueden proporcionar sus propias claves y valores
a los que se hace referencia mediante el atributo data.
Las claves disponibles para el atributo data varían
de proveedor a proveedor. Asegúrate de ser coherente cuando compares el valor clave de la expresión de política. Por ejemplo, si esperas que el valor de la clave sea una string o un valor booleano, asegúrate de compararlo con una string o un valor booleano en la expresión de política correspondiente. Ten en cuenta que cuando el valor es un número entero, debes compararlo con un número doble en la expresión de la política.
Se administra el navegador, a nivel del perfil o a nivel del perfil, y lo hace la empresa con el dominio correcto.
Se considera que un navegador está administrado si las políticas se administran y se envían de manera centralizada, y que el dominio del navegador o perfil administrado coincide con el dominio esperado en el servidor.
Comprueba si el sistema operativo del dispositivo es al menos una versión determinada. Te recomendamos que uses esta función con el atributo device.os_type.
Ejemplo:
device.versionAtLeast("10.0") == true
certificateBindingState(origin, device)
Tipo
(Peer, DeviceType) -> integer
Descripción
Verifica si el certificado de cliente asociado con el origen coincide con el dispositivo y si informa el estado.
El estado que muestra la función puede ser uno de los siguientes:
En este ejemplo, se representa un nivel de acceso que requiere que se cumplan las siguientes condiciones para permitir una solicitud:
Se cumple una de las siguientes condiciones:
El dispositivo desde el cual se originó la solicitud usa un sistema operativo Windows de escritorio y es propiedad de tu organización.
El dispositivo que originó la solicitud usa una computadora con sistema operativo Mac, el administrador del dominio lo aprueba, y tiene, al menos, MacOS 10.11.
En este ejemplo, se representa un nivel de acceso que requiere que se cumpla la siguiente condición para permitir una solicitud:
La función de extensión certificateBindingState determina que el certificado que se presenta en el momento de la solicitud coincide con uno de los certificados de dispositivo que se registró cuando se inscribió el dispositivo en la verificación de extremos.
