Configuración del cifrado de tokens SAML de Microsoft Entra

Artículo
11/26/2024

Nota:

El cifrado de tokens es una característica de Microsoft Entra ID P1 o P2. Para obtener más información sobre las ediciones, características y precios de Microsoft Entra, consulte precios de Microsoft Entra.

El cifrado de tokens SAML habilita el uso de aserciones SAML cifradas con una aplicación que lo admite. Cuando se configura para una aplicación, Microsoft Entra ID cifra las aserciones de SAML que emite para esa aplicación. Cifra las aserciones de SAML mediante la clave pública obtenida de un certificado almacenado en Microsoft Entra ID. La aplicación debe usar la clave privada coincidente para cifrar el token antes de que se pueda usar como prueba de la autenticación del usuario conectado.

El cifrado de las aserciones de SAML entre Microsoft Entra ID y la aplicación proporciona una garantía adicional de que el contenido del token no se puede interceptar y que los datos personales o corporativos no se comprometen.

Incluso sin el cifrado de tokens, los tokens SAML de Microsoft Entra nunca se transmiten por la red sin cifrar. Microsoft Entra ID requiere que los intercambios de solicitud/respuesta de token se realicen a través de canales HTTPS/TLS cifrados para que las comunicaciones entre el IDP, el explorador y la aplicación se realicen en vínculos cifrados. Considere el valor del cifrado de tokens para su situación en comparación con la sobrecarga de administrar más certificados.

Para configurar el cifrado de tokens, debe cargar un archivo de certificado X.509 que contenga la clave pública en el objeto de aplicación de Microsoft Entra que representa la aplicación.

Para obtener el certificado X.509, puede descargarlo desde la propia aplicación. También puede obtenerlo del proveedor de la aplicación cuando el proveedor de la aplicación proporciona claves de cifrado. Si la aplicación espera que proporcione una clave privada, puede crearla mediante herramientas de criptografía. La parte de la clave privada se carga en el almacén de claves de la aplicación y el certificado de clave pública coincidente cargado en Microsoft Entra ID.

Microsoft Entra ID usa AES-256 para cifrar los datos de aserción SAML.

Requisitos previos

Para configurar el cifrado de tokens SAML, necesita:

Una cuenta de usuario de Microsoft Entra. Si no la tiene, puede crear una cuenta gratis.
Uno de los siguientes roles: Administrador de aplicaciones en la nube, Administrador de aplicaciones o propietario de la entidad de servicio.

Sugerencia

Los pasos de este artículo pueden variar ligeramente en función del portal desde donde comienza.

Configuración del cifrado de tokens SAML para aplicaciones empresariales

En esta sección se describe cómo configurar el cifrado de tokens SAML para una aplicación empresarial. Estas aplicaciones se configuran desde el panel Aplicaciones empresariales del Centro de administración de Microsoft Entra, ya sea desde la Galería de aplicaciones o desde una aplicación que no pertenece a la galería. En el caso de las aplicaciones registradas a través de la experiencia de Registros de aplicaciones, siga las instrucciones de Configuración de cifrado de tokens SAML para aplicaciones registradas.

Para configurar el cifrado de tokens SAML para aplicaciones empresariales, siga estos pasos:

Obtenga un certificado de clave pública que coincida con una clave privada configurada en la aplicación.

Cree un par de claves asimétrico para usarlo en el cifrado. O bien, si la aplicación suministra una clave pública para usarlo en el cifrado, siga las instrucciones de la aplicación para descargar el certificado X.509.

La clave pública se debe almacenar en un archivo de certificado X.509 en formato .cer. Puede copiar los contenidos del archivo de certificado a un editor de texto y guardarlo como archivo .cer. El archivo de certificado debe contener únicamente la clave pública y no la clave privada.

Si la aplicación usa una clave que ha creado para la instancia, siga las instrucciones que proporciona la aplicación para instalar la clave privada que la aplicación usará para descifrar los tokens del inquilino de Microsoft Entra.
Agregue el certificado a la configuración de la aplicación en Microsoft Entra ID.

Configurar el cifrado de tokens en el Centro de administración de Microsoft Entra

Puede agregar el certificado público a la configuración de la aplicación dentro del Centro de administración de Microsoft Entra.

Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.
Vaya a Identidad> Aplicaciones>aplicaciones para empresas> Todas las aplicaciones.
Escriba el nombre de la aplicación existente en el cuadro de búsqueda y seleccione la aplicación existente en los resultados de la búsqueda.
En la página de la aplicación, seleccione Cifrado de tokens.

Nota:

La opción Cifrado de tokens solo está disponible para aplicaciones SAML que se hayan configurado desde el panel Aplicaciones empresariales de Centro de administración de Microsoft Entra, ya sea desde la Galería de aplicaciones o desde una aplicación que no pertenece a la galería. Para otras aplicaciones, esta opción está deshabilitada.
En la página Token encryption (Cifrado de tokens), seleccione Import Certificate (Importar certificado) para importar el archivo .cer que contiene el certificado X.509 público.
Una vez que se importa el certificado y la clave privada se configura para usarla en el lado de la aplicación, para activar el cifrado debe seleccionar ... junto al estado de la huella digital y, luego, seleccionar Activate token encryption (Activar el certificado de tokens) desde las opciones del menú desplegable.
Seleccione Sí para confirmar la activación del certificado de cifrado de tokens.
Confirme que se cifran las aserciones SAML emitidas para la aplicación.

Para desactivar el cifrado de tokens en el Centro de administración de Microsoft Entra

En el Centro de administración de Microsoft Entra, vaya a Identidad>Aplicaciones>Aplicaciones empresariales>Todas las aplicaciones y, después, seleccione la aplicación que tiene habilitado el cifrado de tokens SAML.
En la página de la aplicación, seleccione Cifrado de tokens, busque el certificado y seleccione la opción ... para mostrar el menú desplegable.
Seleccione Deactivate token encryption (Desactivar el cifrado de tokens).

Configuración del cifrado de tokens SAML de aplicaciones registradas

En esta sección se describe cómo configurar el cifrado de tokens SAML para una aplicación registrada. Estas aplicaciones se configuran desde el panel Registros de aplicaciones de Centro de administración de Microsoft Entra. Para la aplicación empresarial, siga las instrucciones de Configuración del cifrado de tokens SAML para aplicaciones empresariales.

Los certificados de cifrado se almacenan en el objeto de la aplicación de Microsoft Entra ID con una etiqueta de uso encrypt. Puede configurar varios certificados de cifrado y el que está activo para el cifrado de tokens se identifica con el atributo tokenEncryptionKeyID.

Necesita el identificador de objeto de la aplicación para configurar el cifrado de tokens mediante Microsoft Graph API o PowerShell. Puede encontrar este valor mediante programación, o bien en la página Propiedades de la aplicación en Centro de administración de Microsoft Entra, anotando el valor de Object ID.

Cuando configure un valor keyCredential mediante Graph, PowerShell o en el manifiesto de aplicación, debe generar un GUID para usarlo para keyId.

Para configurar el cifrado de tokens para un registro de aplicación, siga estos pasos:

Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.
Vaya aIdentidad>Aplicaciones>Registros de aplicaciones>Todas las aplicaciones.
Escriba el nombre de la aplicación existente en el cuadro de búsqueda y seleccione la aplicación existente en los resultados de la búsqueda.

En la página de la aplicación, seleccione Manifiesto para editar el manifiesto de aplicación.

En el ejemplo siguiente se muestra un manifiesto de aplicación configurado con dos certificados de cifrado, donde el segundo seleccionado es el activo que usa tokenEncryptionKeyId.

{ 
  "id": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
  "accessTokenAcceptedVersion": null,
  "allowPublicClient": false,
  "appId": "00001111-aaaa-2222-bbbb-3333cccc4444",
  "appRoles": [],
  "oauth2AllowUrlPathMatching": false,
  "createdDateTime": "2017-12-15T02:10:56Z",
  "groupMembershipClaims": "SecurityGroup",
  "informationalUrls": { 
     "termsOfService": null, 
     "support": null, 
     "privacy": null, 
     "marketing": null 
  },
  "identifierUris": [ 
    "https://testapp"
  ],
  "keyCredentials": [ 
    { 
      "customKeyIdentifier": "Tog/O1Hv1LtdsbPU5nPphbMduD=", 
      "endDate": "2039-12-31T23:59:59Z", 
      "keyId": "aaaaaaaa-0b0b-1c1c-2d2d-333333333333", 
      "startDate": "2018-10-25T21:42:18Z", 
      "type": "AsymmetricX509Cert", 
      "usage": "Encrypt", 
      "value": <Base64EncodedKeyFile> 
      "displayName": "CN=SAMLEncryptTest" 
    }, 
    {
      "customKeyIdentifier": "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u=",
      "endDate": "2039-12-31T23:59:59Z", 
      "keyId": "bbbbbbbb-1c1c-2d2d-3e3e-444444444444",
      "startDate": "2018-10-25T21:42:18Z", 
      "type": "AsymmetricX509Cert", 
      "usage": "Encrypt", 
      "value": <Base64EncodedKeyFile> 
      "displayName": "CN=SAMLEncryptTest2" 
    } 
  ], 
  "knownClientApplications": [], 
  "logoUrl": null, 
  "logoutUrl": null, 
  "name": "Test SAML Application", 
  "oauth2AllowIdTokenImplicitFlow": true, 
  "oauth2AllowImplicitFlow": false, 
  "oauth2Permissions": [], 
  "oauth2RequirePostResponse": false, 
  "orgRestrictions": [], 
  "parentalControlSettings": { 
     "countriesBlockedForMinors": [], 
     "legalAgeGroupRule": "Allow" 
    }, 
  "passwordCredentials": [], 
  "preAuthorizedApplications": [], 
  "publisherDomain": null, 
  "replyUrlsWithType": [], 
  "requiredResourceAccess": [], 
  "samlMetadataUrl": null, 
  "signInUrl": "https://127.0.0.1:444/applications/default.aspx?metadata=customappsso|ISV9.1|primary|z" 
  "signInAudience": "AzureADMyOrg",
  "tags": [], 
  "tokenEncryptionKeyId": "bbbbbbbb-1c1c-2d2d-3e3e-444444444444" 
}

Use el módulo de PowerShell de Azure AD más reciente para conectarse a su inquilino. Debe iniciar sesión como mínimo un administrador de aplicaciones en la nube.

Establezca la configuración de cifrado de tokens mediante el comando Set-AzureApplication .

Set-AzureADApplication -ObjectId <ApplicationObjectId> -KeyCredentials "<KeyCredentialsObject>"  -TokenEncryptionKeyId <keyID>

Lea la configuración de cifrado de tokens con los siguientes comandos.

$app=Get-AzureADApplication -ObjectId <ApplicationObjectId>
$app.KeyCredentials
$app.TokenEncryptionKeyId

Use el módulo de PowerShell de Microsoft Graph para conectarse al inquilino. Debe iniciar sesión como mínimo un administrador de aplicaciones en la nube.

Establezca la configuración de cifrado de tokens mediante el comando Update-MgApplication.


Update-MgApplication -ApplicationId <ApplicationObjectId> -KeyCredentials "<KeyCredentialsObject>"  -TokenEncryptionKeyId <keyID>

Lea la configuración de cifrado de tokens con los siguientes comandos.


$app=Get-MgApplication -ApplicationId <ApplicationObjectId>

$app.KeyCredentials

$app.TokenEncryptionKeyId

Actualice el objeto keyCredentials de la aplicación con un certificado X.509 para el cifrado. En el ejemplo siguiente se muestra una carga JSON de Microsoft Graph con una colección de credenciales de clave asociadas a la aplicación.

PATCH https://graph.microsoft.com/beta/applications/<application objectid>

{ 
   "keyCredentials":[ 
      { 
         "type":"AsymmetricX509Cert","usage":"Encrypt",
         "keyId":"aaaaaaaa-0b0b-1c1c-2d2d-333333333333",    (Use a GUID generator to obtain a value for the keyId)
         "key": "MIICADCCAW2gAwIBAgIQ5j9/b+n2Q4pDvQUCcy3…"  (Base64Encoded .cer file)
      }
    ]
}

Identifique el certificado de cifrado activo para cifrar los tokens. En el ejemplo siguiente se muestra una carga JSON de Microsoft Graph con el elemento tokenEncryptionKeyId. El elemento tokenEncryptionKeyId especifica el id. clave de una clave pública de la colección keyCredentials.
```
PATCH https://graph.microsoft.com/beta/applications/<application objectid> 

{ 
   "tokenEncryptionKeyId":"aaaaaaaa-0b0b-1c1c-2d2d-333333333333" (The keyId of the keyCredentials entry to use)
}
```

Pasos siguientes

Descubra Cómo utiliza Microsoft Entra ID el protocolo SAML
Conozca el formato, las características de seguridad y el contenido de los tokens SAML en Microsoft Entra ID

Compartir a través de