# UDS Enterprise (Virtual Cable)

> Integra Ironchip con UDS Enterprise 3.5 mediante un autenticador SAML: crea la aplicación, configura el autenticador, define los atributos y los grupos.

URL: https://docs.ironchip.com/identidad/integraciones/puestos/uds-enterprise/

Esta guía integra un autenticador [SAML](https://docs.ironchip.com/identidad/protocolos/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**.

   [Imagen: Sección SAML apps de la consola]

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

   [Imagen: Opción para crear 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**.

   [Imagen: Nombre de la aplicación y 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.

   [Imagen: Descarga del metadata generado por Ironchip]

## 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**.

   [Imagen: Menú para crear un autenticador SAML en UDS Enterprise]

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

   [Imagen: Pestaña Main del autenticador]

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

   [Imagen: Pestaña Certificates del autenticador]

#### 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.

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

   [Imagen: Ejemplo de generación del certificado]

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

   [Imagen: Datos solicitados para generar el certificado]

3. Convierte la clave a formato RSA.

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

   [Imagen: Conversión de la clave a RSA]

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

   [Imagen: Contenido del certificado y de la clave RSA]

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

   [Imagen: Campos Private Key y Certificate rellenados]

### 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.

   [Imagen: Pestaña Metadata con el IDP Metadata pegado]

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.

   [Imagen: Datos de Entity ID y metadata del autenticador guardado]

## 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.

   [Imagen: Campo Metadata URL del asistente de Ironchip]

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.

   [Imagen: Opción para dar acceso a usuarios a la aplicación]

   [Imagen: Selección de usuarios o grupos]

   [Imagen: Usuarios seleccionados]

   [Imagen: Configuración del acceso]

   [Imagen: Acceso añadido a la aplicación]

## 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.

   [Imagen: Edición del autenticador SAML]

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`  |

   [Imagen: Pestaña Attributes con los atributos definidos]

   :::note
   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.

   [Imagen: Apartado Groups del 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`.

   [Imagen: Grupos añadidos al autenticador]

## Comprobación

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

   [Imagen: Portal de UDS Enterprise con el autenticador SAML]

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.

   [Imagen: Página de inicio de sesión de Ironchip pidiendo el correo]

   [Imagen: Notificación push enviada al usuario]

   :::note
   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.

   [Imagen: Página de servicios de UDS Enterprise tras iniciar sesión]

   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.

   [Imagen: Edición del usuario en el autenticador]

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