context almacena información contextual sobre la transacción de autenticación actual, como la dirección IP, la aplicación o la ubicación del usuario.
Si cambia el contenido del token mediante el objeto context dentro de una regla, los cambios estarán disponibles en los tokens una vez que todas las reglas hayan terminado de ejecutarse. Si su aplicación también requiere o el consentimiento del usuario, se le solicitará al usuario antes de que los cambios en el token estén disponibles.
Propiedades
context.
| Propiedad | Descripción |
|---|---|
context.tenant | Una cadena que contiene el nombre del inquilino. |
context.clientID | El ID de cliente de la aplicación en la que el usuario inicia sesión. |
context.clientName | El nombre de la aplicación (tal como se define en el panel). |
context.clientMetadata | Un objeto para almacenar otras propiedades de la aplicación. Sus claves y valores son cadenas. |
context.connectionID | Una cadena que contiene el identificador único de la conexión. |
context.connection | El nombre de la conexión que se utiliza para autenticar al usuario (por ejemplo: twitter o some-g-suite-domain) |
context.connectionStrategy | El tipo de conexión. Para una conexión social, connectionStrategy === connection. En las conexiones empresariales, la estrategia será waad (Windows Azure AD), ad (Active Directory/LDAP), auth0 (conexiones de base de datos), etc. |
context.connectionOptions | Un objeto que representa las opciones definidas en la conexión. connectionOptions.tenant_domain es una cadena que contiene el dominio que se utiliza para la autenticación cuando se usa una conexión empresarial.connectionOptions.domain_aliases es una matriz que contiene los dominios opcionales registrados como alias, además del dominio principal (especificado en la propiedad connectionOptions.tenant_domain). |
context.connectionMetadata | Objeto que representa los metadatos definidos en la conexión. Sus claves y valores son cadenas. |
context.samlConfiguration | Un objeto que controla el comportamiento de los endpoints de SAML y WS-Fed. Útil para el mapeo avanzado de claims y el enriquecimiento de tokens (solo disponible para los protocolos samlp y wsfed). |
context.protocol | El protocolo de autenticación. Valores posibles:
|
context.riskAssessment | Un objeto que contiene puntuaciones específicas (bajo, medio, alto, neutro) para los evaluadores de intentos de inicio de sesión de alto riesgo. Consulte Personalice la MFA adaptativa con Rules. |
context.stats | Un objeto que contiene estadísticas específicas del usuario, como stats.loginsCount. Tenga en cuenta que ninguna de las variables de contador devueltas como parte del objeto stats se incrementa durante la autenticación silenciosa (como cuando prompt=none). También hay situaciones en las que las variables de contador pueden incrementarse y, aun así, una Rule o un conjunto de Rules no se ejecuten, como en el caso de una autenticación entre orígenes correcta seguida de una solicitud de token fallida. |
context.sso | Este objeto contendrá información sobre la transacción de inicio de sesión único (SSO) (si está disponible)
|
context.accessToken | Un objeto que representa las opciones definidas en el Token de acceso. Puede usar este objeto para agregar claims personalizados con espacio de nombres al Token de acceso. context.accessToken.scope se puede usar para cambiar los alcances que devuelve el Token de acceso. Cuando se proporciona, es un arreglo que contiene permisos como cadenas. Los claims personalizados se incluirán en el Token de acceso después de que se hayan ejecutado todas las Rules. |
context.idToken | Un objeto que representa las opciones definidas en el ID Token. Se usa para agregar claims personalizadas con espacio de nombres al ID Token. Las claims personalizadas se incluirán en el ID Token una vez que se hayan ejecutado todas las Rules. |
context.multifactor | Un objeto que representa la configuración de MFA utilizada para implementar MFA contextual. |
context.redirect | El objeto que se usa para implementar la redirección de un usuario desde una regla. |
context.sessionID | Un identificador interno de la sesión de autenticación. El valor solo se conserva si se usa prompt=none en la solicitud de autorización. Tenga en cuenta que el ID de sesión puede cambiar después de la ejecución de la regla en otros flujos, por lo que el valor disponible en context.sessionID podría no coincidir con el nuevo ID de sesión que recibirá el usuario. Esto significa que este valor solo tiene sentido cuando se usa prompt=none. |
context.request | Un objeto que contiene información útil sobre la solicitud. También puede establecerse como undefined. Tiene las siguientes propiedades:
|
context.primaryUser | El id único de la cuenta principal del usuario. Se usa para vincular cuentas de usuario de varios proveedores de identidad. |
context.authentication | Un objeto que contiene información relacionada con la transacción de autenticación con las siguientes propiedades:methods: una matriz de objetos que contiene los métodos de autenticación que un usuario ha completado durante su sesión. Por ejemplo, un usuario que ha completado una autenticación basada en contraseña seguida de MFA puede tener los siguientes métodos:json lines [ { "name": "pwd", "timestamp": 1434454643024 }, { "name": "mfa", "timestamp": 1534454643881 } ] Los objetos de método contienen las siguientes propiedades:
context.authentication.methods en la Rule Require MFA once per session. |
context.authorization | Un objeto que contiene información relacionada con la transacción de autorización con las siguientes propiedades:
|
context.organization | Objeto que contiene información relacionada con la organización. Incluye las siguientes propiedades:
|