UDS Enterprise (Virtual Cable)

Esta guía integra un autenticador SAML de UDS Enterprise 3.5 para validar usuarios en Ironchip, de modo que los usuarios de Ironchip puedan acceder al servicio de UDS.

Requisitos

• Acceso a la consola de administración de Ironchip con un usuario con permisos de administración.
• Una cuenta con permisos para realizar la configuración en UDS Enterprise.
• Usuarios dados de alta en ambas plataformas.

Configuración en Ironchip

Crear la aplicación SAML

1. En la consola de administración de Ironchip, selecciona SAML apps.

   

2. Da de alta una aplicación SAML personalizada.

   

3. En el asistente, indica un nombre para identificar la aplicación y selecciona el tipo de integración SAML.

   

4. Descarga el metadata que genera Ironchip. Lo necesitarás en UDS Enterprise. Deja esta ventana abierta y continúa con el siguiente paso.

   

Configuración en UDS Enterprise

Crear el autenticador SAML

1. En la administración de UDS Enterprise, ve a Autenticadores, selecciona Nuevo y elige SAML Authenticator.

   

2. En la pestaña Main, indica un nombre para el autenticador (no puede contener espacios), la prioridad y un Label.

   

3. En la pestaña Certificates, indica un certificado válido y su clave. Tienen que estar en formato PEM.

   

Generar un certificado con OpenSSL

Si no tienes certificados, puedes generar uno con OpenSSL. El servidor de UDS tiene OpenSSL instalado, así que puedes usar esa máquina.

1. Genera el certificado y la clave.

   openssl req -new -newkey rsa:2048 -days 3650 -x509 -nodes -keyout server.key -out server.crt

   

2. Completa los datos que te pide para generar el certificado.

   

3. Convierte la clave a formato RSA.

   openssl rsa -in server.key -out server_rsa.key

   

4. Copia el contenido del certificado y de la clave RSA en UDS.

   

5. Pega la clave en Private Key y el certificado en Certificate.

   

Añadir el metadata de Ironchip

1. En la pestaña Metadata, rellena IDP Metadata con el metadata que descargaste de Ironchip al crear la aplicación SAML personalizada. Copia el contenido completo del fichero. Ábrelo con un editor adecuado y nunca con un navegador, porque oculta partes del código.

   

2. Deja Entity ID vacío: se rellena automáticamente al guardar el autenticador, a partir de la URL que uses para conectar con el portal de UDS Enterprise.

3. Guarda el autenticador. Para que te deje guardar, indica cualquier dato en la pestaña Attributes; volverás a este apartado más adelante para aplicar la configuración definitiva.

4. Vuelve a editar el autenticador. Ahí obtienes los datos de Entity ID que necesitas para terminar de configurar la aplicación SAML personalizada en la consola de Ironchip.

   

Terminar la configuración en Ironchip

1. Retoma el asistente de Ironchip para crear la aplicación SAML personalizada. Te pedirá la Metadata URL que generó UDS Enterprise al guardar y volver a editar el autenticador.

   

2. Introduce la URL y finaliza el asistente.

3. Da acceso a tus usuarios a la aplicación creada. Puedes añadir usuarios individuales o grupos de usuarios.

   

   

   

   

   

Definir los atributos y los grupos en UDS Enterprise

1. En la administración de UDS Enterprise, selecciona el autenticador SAML que creaste y edítalo.

   

2. En Attributes, indica los atributos correctos. Están definidos y visibles en la documentación de Ironchip. Por defecto son:

   Description	Friendly Name	SAML Name
   User Name	uid	urn:oid:0.9.2342.19200300.100.1.1
   User Email	mail	urn:oid:0.9.2342.19200300.100.1.3
   User given Name	givenName	urn:oid:2.5.4.42
   User common Name	cn	urn:oid:2.5.4.3
   User Groups	eduPersonAffiliation	urn:oid:1.3.6.1.4.1.5923.1.1.1.1

   

   Nota

   En UDS Enterprise puedes indicar varios atributos o usar expresiones regulares, por ejemplo para definir nuevos atributos de pertenencia a grupos.

3. Guarda y accede al autenticador creado en UDS Enterprise.

4. Ve al apartado Groups y añade los grupos necesarios. Tienes que añadirlos manualmente, porque la búsqueda automática no se aplica a este tipo de autenticador.

   

5. Añade todos los grupos necesarios. En este ejemplo se añaden los departamentos a los que pertenecen los usuarios, porque el atributo de pertenencia a departamentos que usa Ironchip es Groups.

   

Comprobación

1. Accede al portal de UDS Enterprise a través del autenticador SAML que acabas de crear.

   

2. Al seleccionar el autenticador SAML, UDS Enterprise te redirige a la página del proveedor. En este caso, el sistema te pide el correo electrónico del usuario al que se enviará una notificación push.

   

   

   Nota

   El modo de validación es el que esté configurado en el propio proveedor. Si tienes validación de usuarios con MFA, se usará.

3. Tras iniciar sesión en Ironchip, se te redirige de vuelta a la página de servicios de UDS Enterprise.

   

   Si el grupo al que pertenece el usuario tiene servicios asignados, se le muestran y puede acceder a ellos.

4. Para comprobar a qué grupos pertenece un usuario, accede al autenticador y edita el usuario.

   

En este ejemplo, el usuario pertenece al grupo UDS Enterprise y, como ese grupo está dado de alta en el autenticador, puede acceder.