Configurar Pega Systems para inicio de sesión único con Microsoft Entra ID

2025-05-04

En este artículo, aprenderá a integrar Pega Systems con Microsoft Entra ID. Al integrar Pega Systems con Microsoft Entra ID, puede hacer lo siguiente:

Controlar en Microsoft Entra ID quién tiene acceso a Pega Systems.
Permitir que los usuarios inicien sesión automáticamente en Pega Systems con sus cuentas de Microsoft Entra.
Administre sus cuentas en una ubicación central.

Prerrequisitos

En el escenario descrito en este artículo se supone que ya tiene los siguientes requisitos previos:

Una cuenta de usuario de Microsoft Entra con una suscripción activa. Si no la tiene, puede crear una cuenta gratis.
Uno de los siguientes roles:

Suscripción habilitada para el inicio de sesión único en Pega Systems.

Descripción del escenario

En este artículo, configurará y probará el inicio de sesión único de Microsoft Entra en un entorno de prueba.

Pega Systems admite el inicio de sesión único iniciado por SP e IDP.

Adición de Pega Systems desde la galería

Para configurar la integración de Pega Systems en Microsoft Entra ID, deberá agregar Pega Systems desde la galería a la lista de aplicaciones SaaS administradas.

Inicie sesión en el Centro de administración de Microsoft Entra siendo al menos un Administrador de aplicaciones en la nube.
Navegue a Entra ID>Aplicaciones empresariales>Nueva aplicación.
En la sección Agregar desde la galería, escriba Pega Systems en el cuadro de búsqueda.
Seleccione Pega Systems en el panel de resultados y agregue la aplicación. Espere unos segundos mientras la aplicación se agrega a su arrendatario.

Si lo deseas, puedes usar también el asistente para la configuración de aplicaciones empresariales. En este asistente, puede agregar una aplicación a su cliente, agregar usuarios o grupos a la aplicación, asignar roles y completar la configuración de SSO. Obtén más información sobre los asistentes de Microsoft 365.

Configuración y prueba del inicio de sesión único de Microsoft Entra para Pega Systems

Configure y pruebe el inicio de sesión único de Microsoft Entra con Pega Systems mediante un usuario de prueba llamado B.Simon. Para que el inicio de sesión único funcione, es necesario establecer una relación de vínculo entre un usuario de Microsoft Entra y el usuario relacionado de Pega Systems.

Para configurar y probar el inicio de sesión único de Microsoft Entra con Pega Systems, complete los siguientes pasos:

Configura Microsoft Entra SSO para permitir que tus usuarios usen esta característica.
1. Creación de un usuario de prueba de Microsoft Entra : para probar el inicio de sesión único de Microsoft Entra con B.Simon.
2. Asigne el usuario de prueba de Microsoft Entra : para permitir que B.Simon use el inicio de sesión único de Microsoft Entra.
Configuración del inicio de sesión único en Pega Systems , para configurar los valores de inicio de sesión único en la aplicación.
1. Creación de un usuario de prueba de Pega Systems: para tener un homólogo de B.Simon en Pega Systems que esté vinculado a la representación del usuario en Microsoft Entra.
Prueba SSO – para comprobar si la configuración funciona.

Configurar el SSO de Microsoft Entra

Siga estos pasos para activar el SSO de Microsoft Entra.

Inicie sesión en el Centro de administración de Microsoft Entra siendo al menos un Administrador de aplicaciones en la nube.
Vaya a Entra ID>Aplicaciones empresariales>Pega Systems>Inicio de sesión único.
En la página Seleccione un método de inicio de sesión único, elija SAML.
En la página Configurar inicio de sesión único con SAML, seleccione el icono de lápiz para Configuración básica SAML y edite la configuración.
En el cuadro de diálogo Configuración básica de SAML, si desea configurar la aplicación en modo iniciado por IdP, realice estos pasos.
1. En el cuadro de texto Identificador, escriba una dirección URL con el siguiente patrón:
  
  https://<customername>.pegacloud.io:443/prweb/sp/<instanceID>
2. En el cuadro de texto URL de respuesta, escriba una dirección URL con el siguiente patrón:
  
  https://<customername>.pegacloud.io:443/prweb/PRRestService/WebSSO/SAML/AssertionConsumerService
Si quiere configurar la aplicación en modo iniciado por SP, seleccione Establecer direcciones URL adicionales y haga lo siguiente.
1. En Dirección URL de inicio de sesión, escriba el valor de URL de inicio de sesión.
2. En el cuadro Estado de la retransmisión, escriba una dirección URL con este patrón: https://<customername>.pegacloud.io/prweb/sso
Nota:

Los valores proporcionados aquí son marcadores de posición. Necesita usar los valores de Identificador, URL de respuesta, URL de inicio de sesión y URL de estado de retransmisión. Puede obtener los valores de identificador y dirección URL de respuesta de una aplicación Pega, como se explica más adelante en este artículo. Para obtener el valor de estado de la retransmisión, póngase en contacto con el equipo de soporte técnico de Pega Systems. También puede consultar los patrones que se muestran en la sección Configuración básica de SAML.
La aplicación de Pega Systems necesita las aserciones de SAML en un formato específico. Para obtenerlas en el formato correcto, deberá agregar asignaciones de atributo personalizadas a la configuración de atributos del token SAML. En la siguiente captura se muestra la lista de atributos predeterminados. Seleccione el icono Editar para abrir el cuadro de diálogo Atributos de usuario.
Además de los atributos que se muestran en la captura de pantalla anterior, la aplicación Pega Systems requiere que se pasen algunos atributos más en la respuesta de SAML. En la sección Notificaciones del usuario del cuadro de diálogo Atributos de usuario, haga lo siguiente para agregar estos atributos del token SAML:
- uid
- cn
- mail
- accessgroup
- organization
- orgdivision
- orgunit
- workgroup
- Phone
Nota:

Estos valores son específicos de su organización. Proporcione los valores adecuados.
1. Seleccione Agregar nueva notificación para abrir el cuadro de diálogo Administrar las notificaciones del usuario:
1. En el cuadro Nombre , escriba el nombre del atributo que se muestra para esa fila.
2. Deje Espacio de nombres vacío.
3. En Origen, seleccione Atributo.
4. En la lista Atributo de origen, escriba el valor de atributo que se muestra para esa fila.
5. Seleccione Aceptar.
6. Haga clic en Guardar.
En la página Configurar el inicio de sesión único con SAML, en la sección Certificado de firma de SAML, seleccione el vínculo Descargar situado junto a XML de metadatos de federación, según sus requisitos, y guarde el certificado en el equipo.
En la sección Configurar Pega Systems, copie las direcciones URL adecuadas según sus necesidades.

Creación y asignación de un usuario de prueba de Microsoft Entra

Siga las instrucciones de creación y asignación de una cuenta de usuario de inicio rápido para crear una cuenta de usuario de prueba llamada B.Simon.

Configuración del inicio de sesión único de Pega Systems

Para configurar el inicio de sesión único en Pega Systems, inicie sesión en el portal de Pega con cuenta de administrador en otra ventana del explorador.
Seleccione Create>SysAdmin>Authentication Service (Crear > SysAdmin > Servicio de autenticación):
Realice los siguientes pasos en la pantalla Create Authentication Service (Crear servicio de autenticación).
1. En la lista Type (Tipo), seleccione SAML 2.0.
2. En el cuadro Nombre, escriba cualquier nombre (por ejemplo, Inicio de sesión único de Microsoft Entra).
3. En el cuadro Short description (Descripción corta) escriba una descripción.
4. Seleccione Create and open (Crear y abrir).
En la sección Identity Provider (IdP) information (Información de proveedor de identidades [IdP]), haga clic en Import IdP metadata (Importar metadatos de IdP) y busque el archivo de metadatos que descargó. Seleccione Enviar para cargar los metadatos:

La importación rellenará los datos del IdP, como se muestra a continuación:
Siga estos pasos en la sección Service Provider (SP) settings (Configuración del proveedor de servicios [SP]).
1. Copie el valor de Entity Identification (Identificación de la entidad) y péguelo en el cuadro Identificador de Configuración básica de SAML.
2. Copie el valor de Assertion Consumer Service (ACS) location (Ubicación del servicio de consumidor de aserciones [ACS]) y péguelo en el cuadro Dirección URL de respuesta de Configuración básica de SAML.
3. Seleccione Disable request signing (Deshabilitar firma de solicitudes).
Haga clic en Guardar.

Creación de un usuario de prueba de Pega Systems

A continuación, deberá crear un usuario llamado a Britta Simon en Pega Systems. Trabaje con el equipo de soporte técnico de Pega Systems para crear usuarios.

Prueba de SSO

En esta sección vas a probar la configuración de inicio de sesión único de Microsoft Entra con las siguientes opciones.

Iniciado por SP:

Seleccione Probar esta aplicación; esta opción redirige a la dirección URL de inicio de sesión de Pega Systems, donde puede iniciar el flujo de inicio de sesión.
Acceda directamente a la URL de inicio de sesión de Pega Systems y ponga en marcha el flujo de inicio de sesión desde ahí.

IDP iniciado:

Seleccione Probar esta aplicación y debería iniciar sesión automáticamente en la instancia de Pega Systems para la que configuró el inicio de sesión único.

También puedes usar Mis aplicaciones de Microsoft para probar la aplicación en cualquier modo. Al seleccionar el icono de Pega Systems en Aplicaciones, si se ha configurado en modo SP, se le redirigirá a la página de inicio de sesión de la aplicación para comenzar el flujo de inicio de sesión y, si se ha configurado en modo IDP, debería iniciar sesión automáticamente en la instancia de Pega Systems para la que configuró el inicio de sesión único. Para obtener más información acerca de Mis aplicaciones, consulta Introducción a Mis aplicaciones.

Una vez configurado Pega Systems, puede aplicar el control de sesión, que protege su organización en tiempo real frente a la filtración e infiltración de información confidencial. El control de sesión se extiende desde el acceso condicional. Aprende a aplicar el control de sesión con Microsoft Defender para aplicaciones en la nube.