Vigencia de tokens configurable en la Plataforma de identidad de Microsoft (versión preliminar)
Puede especificar la vigencia de un token de acceso, identificador o SAML emitido por la Plataforma de identidad de Microsoft. La vigencia de los tokens se puede configurar para todas las aplicaciones de la organización, para aplicaciones multiinquilino (multiorganización) o para entidades de servicio. Actualmente no se admite la configuración de la vigencia de los tokens para las entidades de servicio de identidad administrada.
En Microsoft Entra ID, un objeto de directiva representa un conjunto de reglas que se exigen en algunas o todas las aplicaciones de una organización. Cada tipo de directiva tiene una estructura única con un conjunto de propiedades que se aplican a los objetos a los que están asignadas.
Puede designar una directiva como la directiva predeterminada para su organización. La directiva se aplicará a cualquier aplicación que resida en la organización, siempre y cuando no la reemplace una directiva con una prioridad más alta. También puede asignar una directiva a aplicaciones específicas. El orden de prioridad varía según el tipo de directiva.
Para obtener ejemplos, lea Configuración de la vigencia de los tokens.
Nota:
La directiva de vigencia del token configurable solo se aplica a los clientes móviles y de escritorio que tienen acceso a los recursos SharePoint Online y OneDrive para la Empresa, y no se aplica a las sesiones del explorador web. Para administrar la vigencia de las sesiones del explorador web para SharePoint Online y OneDrive para la Empresa, use la característica de vigencia de sesiones de acceso condicional. Consulte el blog de SharePoint Online para más información sobre cómo configurar los tiempos de expiración de sesiones inactivas.
Nota:
Es posible que desee aumentar la duración del token para que un script se ejecute durante más de una hora. Muchas bibliotecas de Microsoft, como el SDK de PowerShell de Microsoft Graph, amplían la duración del token según sea necesario y no es necesario realizar cambios en la directiva de token de acceso.
Requisitos de licencia
El uso de esta característica requiere una licencia Microsoft Entra ID P1. Para obtener la licencia correcta para sus requisitos, consulte Comparación de las características con disponibilidad general de las ediciones Gratis y Prémium.
Los clientes con licencias de Microsoft 365 Empresa también tienen acceso a características de acceso condicional.
Directivas de vigencia para los tokens de acceso, SAML e identificador
Las directivas de vigencia de tokens se pueden establecer para los tokens de acceso, SAML y de identificador.
Tokens de acceso
Los clientes utilizan tokens de acceso para acceder a un recurso protegido. Solo se puede utilizar un token de acceso para una combinación específica de usuario, cliente y recurso. Los tokens de acceso no se pueden revocar y son válidos hasta su expiración. Un individuo maltintencionado que haya obtenido un token de acceso puede usarlo durante toda su vigencia. El ajuste de la vigencia de un token de acceso es un balance entre la mejora del rendimiento del sistema y el aumento de la cantidad de tiempo que el cliente conserva el acceso después de que la cuenta de usuario está deshabilitada. Se consigue un rendimiento mejorado del sistema al reducir el número de veces que un cliente necesita adquirir un token de acceso nuevo.
La duración predeterminada de un token de acceso es variable. Cuando se emite, a la duración predeterminada de un token de acceso se le asigna un valor aleatorio que oscila entre 60 y 90 minutos (75 minutos de media). La duración predeterminada también varía en función de la aplicación cliente que solicite el token o de si el acceso condicional está habilitado en el inquilino. Para obtener más información, vea Vigencia del token de acceso.
Tokens de SAML
Muchas aplicaciones SaaS basadas en web usan tokens SAML, que se obtienen mediante el punto de conexión del protocolo SAML2 de Microsoft Entra ID. También se consumen mediante aplicaciones que usan WS-Federation. La duración predeterminada del token es de 1 hora. Desde la perspectiva de una aplicación, el período de validez del token se especifica mediante el valor NotOnOrAfter del elemento <conditions …>
en el token. Una vez finalizado el período de validez del token, el cliente debe iniciar una nueva solicitud de autenticación, que a menudo se satisfará sin iniciar sesión de forma interactiva como resultado del token de sesión de inicio de sesión único (SSO).
El valor de NotOnOrAfter se puede cambiar mediante el parámetro AccessTokenLifetime
en un TokenLifetimePolicy
. Se establecerá en la duración configurada en la directiva, si la hay, más un factor de sesgo de reloj de cinco minutos.
Tenga en cuenta que la confirmación de asunto NotOnOrAfter especificada en el elemento <SubjectConfirmationData>
no se ve afectada por la configuración de la vigencia del token.
Tokens de identificador
Los tokens de identificador se pasan a los clientes nativos y de sitios web. Los tokens de identificador contienen información de perfil de un usuario. Un token de identificador se enlaza a una combinación específica de usuario y cliente. Los tokens de identificador se consideran válidos hasta que expiran. Normalmente, una aplicación web relaciona la vigencia de la sesión de un usuario en la aplicación con la vigencia del token de identificador emitido para el usuario. Puede ajustar la vigencia de un token de identificador para controlar la frecuencia con la que la aplicación web expira la sesión de la aplicación y requiere que el usuario se vuelva a autenticar en la Plataforma de identidad de Microsoft (de forma silenciosa o interactiva).
Directivas de vigencia para los tokens de actualización y los tokens de sesión
No se pueden establecer directivas de vigencia de tokens para tokens de actualización y tokens de sesión. Para obtener información sobre la duración, el tiempo de espera y la revocación de los tokens de actualización, consulte Actualización de tokens.
Importante
A partir del 30 de enero de 2021, no puede configurar la vigencia de los tokens de actualización ni de sesión. Microsoft Entra ya no respeta la configuración de los tokens de actualización y de sesión en las directivas existentes. Los nuevos tokens emitidos después de que los tokens existentes hayan expirado ahora se establecen en la configuración predeterminada. Después de la retirada de la configuración de los tokens de actualización y de sesión, todavía podrá configurar la vigencia de los tokens de acceso, SAML y de identificador.
La duración del token existente no se cambiará. Una vez expirado, se emitirá un nuevo token basado en el valor predeterminado.
Si necesita seguir definiendo el período de tiempo antes de que se pida al usuario que vuelva a iniciar sesión, configure la frecuencia de inicio de sesión en el acceso condicional. Para obtener más información sobre el acceso condicional, consulte Configuración de la administración de las sesiones de autenticación con el acceso condicional.
Propiedades de vigencia de tokens configurables
Una directiva de vigencia del token es un tipo de objeto de directiva que contiene reglas de vigencia del token. Esta directiva controla cuánto tiempo se consideran válidos los tokens de acceso, SAML y de identificador para este recurso. Las directivas de vigencia de tokens no se pueden establecer para los tokens de actualización y sesión. Si no se establece ninguna directiva, el sistema aplica el valor de vigencia predeterminado.
Propiedades de la directiva de duración del token de SAML2, de id. y de acceso
Reducir la vigencia de los tokens de acceso disminuye el riesgo de que un individuo malintencionado use un token de acceso o de identificador durante un período de tiempo prolongado. (Estos tokens no se pueden revocar). El inconveniente es que afecta negativamente al rendimiento, ya que los tokens tendrán que reemplazarse con más frecuencia.
Para obtener un ejemplo, consulte Creación de una directiva para inicio de sesión web.
La configuración de los tokens de SAML2, de id. y de acceso se ve afectada por las siguientes propiedades y sus correspondientes valores establecidos:
- Propiedad: duración del token de acceso
- Cadena de propiedad de directiva: AccessTokenLifetime
- Afecta a: tokens de acceso, de id. y de SAML2
- Valor predeterminado:
- Tokens de acceso: el valor predeterminado varía en función de la aplicación cliente que solicite el token. Por ejemplo, los clientes compatibles con la evaluación de acceso continuo (CAE) que negocian sesiones compatibles con CAE, tendrán una vigencia de token de larga duración (hasta 28 horas).
- Tokens de id., tokens de SAML2: 1 hora
- Mínimo: 10 minutos
- Máximo: 1 día
Propiedades de las directivas de vigencia de los tokens de actualización y de sesión
La configuración de los tokens de actualización y sesión se ve afectada por las siguientes propiedades y sus correspondientes valores establecidos. Después de la retirada de la configuración de los tokens de actualización y de sesión el 30 de enero de 2021, Microsoft Entra ID solo aceptará los valores predeterminados que se describen a continuación. Si decide no usar el acceso condicional para administrar la frecuencia de inicio de sesión, los tokens de actualización y de sesión se establecerán en la configuración predeterminada en esa fecha y ya no podrá cambiar su vigencia.
Propiedad | Cadena de propiedad de directiva | Afecta a | Valor predeterminado |
---|---|---|---|
Tiempo máximo de inactividad del token de actualización | MaxInactiveTime | Tokens de actualización | 90 días |
Antigüedad máxima del token de actualización (un solo factor) | MaxAgeSingleFactor | Tokens de actualización (para los usuarios) | Hasta que se revoca |
Antigüedad máxima del token de actualización (varios factores) | MaxAgeMultiFactor | Tokens de actualización (para los usuarios) | Hasta que se revoca |
Antigüedad máxima del token de sesión (un solo factor) | MaxAgeSessionSingleFactor | Tokens de sesión (persistentes y no persistentes) | Hasta que se revoca |
Antigüedad máxima del token de sesión (varios factores) | MaxAgeSessionMultiFactor | Tokens de sesión (persistentes y no persistentes) | Hasta que se revoca |
Los tokens de sesión no persistentes tienen un tiempo de inactividad máximo de 24 horas, mientras que los tokens de sesión persistentes tienen un tiempo de inactividad máximo de 90 días. Cada vez que se utilice el token de sesión SSO dentro de su período de validez, este se amplía otras 24 horas o 90 días. Si el token de sesión SSO no se usa dentro de su período de inactividad máximo, se considerará caducado y ya no se aceptará. Los cambios realizados en estos períodos predeterminados deben hacerse mediante acceso condicional.
Puede usar PowerShell para buscar las directivas que se verán afectadas por la retirada. Use los cmdlets de PowerShell para ver todas las directivas creadas en su organización o para averiguar qué aplicaciones están vinculadas a una directiva específica.
Evaluación y prioridades de directivas
Puede crear y, a continuación, asignar una directiva de vigencia del token a una aplicación específica y a su organización. Se pueden aplicar varias directivas a una aplicación específica. La directiva de vigencia del token que entra en vigor sigue estas reglas:
- Si una directiva se asigna explícitamente a la organización, se aplica.
- Si no hay ninguna directiva que se asigne explícitamente a la organización, se aplicará la directiva asignada a la aplicación.
- Si no se ha asignado ninguna directiva a la organización o el objeto de aplicación, se aplican los valores predeterminados. (Consulte la tabla que aparece en Propiedades de vigencia de tokens configurables).
La validez de un token se evalúa en el momento en el que se usa. La directiva con la prioridad más alta en la aplicación a la que se accede es la que se aplica.
Todos los intervalos de tiempo usados aquí tienen formato según el objeto TimeSpan de C#: D.HH:MM:SS. Por lo tanto, 80 días y 30 minutos sería 80.00:30:00
. La D inicial puede eliminarse si es cero, por lo que 90 minutos sería 00:90:00
.
Referencia de la API REST
Puede configurar directivas de vigencia de tokens y asignarlas a aplicaciones mediante Microsoft Graph. Para más información, consulte el tokenLifetimePolicy
tipo de recurso y sus métodos asociados.
Referencia de cmdlets
Estos son los cmdlets del SDK de PowerShell de Microsoft Graph.
Administración de directivas
Los comandos siguientes se pueden usar para administrar directivas.
Cmdlet | Descripción |
---|---|
New-MgPolicyTokenLifetimePolicy | Crea una nueva directiva. |
Get-MgPolicyTokenLifetimePolicy | Obtiene todas las directivas de vigencia del token o una directiva especificada. |
Update-MgPolicyTokenLifetimePolicy | Actualiza una directiva existente. |
Remove-MgPolicyTokenLifetimePolicy | Elimina la directiva especificada. |
Directivas de aplicación
Los cmdlets siguientes se pueden usar para directivas de aplicación.
Cmdlet | Descripción |
---|---|
New-MgApplicationTokenLifetimePolicyByRef | Vincula la directiva especificada a una aplicación. |
Get-MgApplicationTokenLifetimePolicyByRef | Obtiene las directivas asignadas a una aplicación. |
Remove-MgApplicationTokenLifetimePolicyByRef | Quita una directiva de una aplicación. |
Pasos siguientes
Para obtener más información, lea los ejemplos configuración de la vigencia de los tokens.