# Zoho One

> Integrar Zoho One con Ironchip por SAML: crear la aplicación, añadir el proveedor de identidades, formatear el certificado X.509 y activar la directiva.

URL: https://docs.ironchip.com/identidad/integraciones/saas/zoho-one/

Ironchip actúa como proveedor de identidad SAML de Zoho One. Esta guía explica cómo configurar ambas partes y asignar los usuarios que podrán autenticarse con Ironchip.

## Requisitos

- Acceso a la consola de administración de Ironchip.
- Un usuario con permisos para realizar la configuración en Zoho One.

## Configuración en Ironchip

### Crear la aplicación SAML

1. En la consola de Ironchip, ve a **Applications** y haz clic en el botón verde **New application**.

   [Imagen: Botón New application en la sección Applications de la consola de Ironchip]

2. En el diálogo, selecciona **SAML** en **Standard authentication protocols**.

   [Imagen: Selección de SAML entre los protocolos de autenticación estándar]

3. Asigna un nombre descriptivo a la aplicación, por ejemplo `Zoho One`.

### Obtener los datos del Identity Provider

En el paso **Configure service** de la aplicación, abre la pestaña **Identity Provider**. En **Single Sign On Service**, copia estos valores, que necesitarás en Zoho One:

- **URL SSO** (Single Sign On Service): será tu URL de inicio de sesión en Zoho.
- **URL SLO**: se obtiene sustituyendo `/sso` por `/slo` en la URL anterior.
- **Certificado X.509**: cópialo con su botón de copiar.

[Imagen: Paso Configure service de la nueva aplicación en Ironchip con la URL del Single Sign On Service]

## Configuración en Zoho One

### Añadir el proveedor de identidades

1. Accede al panel de Zoho One. En el menú superior, despliega el selector de espacios y haz clic en **Administrar espacios**.

   [Imagen: Selector de espacios con la opción Administrar espacios]

2. En el panel lateral izquierdo, ve a **Seguridad** > **Proveedor de identidades** y haz clic en **Agregar proveedor de identidades**.

   [Imagen: Sección Seguridad con el botón Agregar proveedor de identidades]

3. Selecciona el tipo **SAML** y rellena los campos con los datos que copiaste de Ironchip:
   - **URL de inicio de sesión**: pega la URL SSO de Ironchip.
   - **URL de cierre de sesión**: pega la misma URL cambiando `/sso` por `/slo`.
   - **Formato de ID de nombre**: selecciona **Dirección de correo electrónico**.
   - **Certificado X509**: sube el archivo `.crt` con el certificado formateado (consulta el apartado siguiente).

### Formatear el certificado X.509

El certificado copiado de Ironchip debe tener el formato correcto antes de importarlo.

1. Ve a <https://www.samltool.com/format_x509cert.php>.
2. Pega el contenido del certificado en el campo **X.509 cert** y haz clic en **FORMAT X.509 CERTIFICATE**.

   [Imagen: Herramienta para formatear un certificado X.509 con el botón FORMAT X.509 CERTIFICATE]

3. Copia el resultado y guárdalo como archivo de texto con extensión `.crt` (por ejemplo, `SAMLcert.crt`).
4. Vuelve a Zoho One e importa el archivo `.crt` en el campo **Certificado X509**.

   [Imagen: Formulario Agregar proveedor de identidades de Zoho One con las URL de Ironchip y el certificado SAMLcert.crt]

:::caution[Comprueba el formato del certificado]
El certificado bien formateado empieza por `-----BEGIN CERTIFICATE-----` y termina con `-----END CERTIFICATE-----`. Si no tiene ese formato, el inicio de sesión falla.
:::

### Intercambiar los metadatos

Cuando guardes el proveedor de identidades en Zoho One, el sistema muestra los metadatos del Service Provider.

1. Copia estos valores:
   - **EntityID** / **Emisor** (Issuer).
   - **URL del Assertion Consumer Service (ACS)**.

   [Imagen: Configuración de SSO de Zoho One con la URL de servicios de consumidor de aserciones y el emisor]

2. Vuelve a la consola de Ironchip, entra en la aplicación SAML que creaste y abre la pestaña **Service Provider**.
3. Pega los valores copiados en los campos correspondientes y guarda los cambios.

   [Imagen: Campos Entity ID y Assertion Consumer Services de la aplicación SAML en Ironchip]

### Activar el proveedor de identidades en la directiva

1. En Zoho One, ve a **Seguridad** > **Directivas de enrutamiento** y edita la directiva **Valor predeterminado**.

   [Imagen: Directivas de enrutamiento con la directiva Valor predeterminado]

2. Abre la pestaña **Modos de autenticación**, activa la opción **Proveedor de identidades** y marca la casilla de Ironchip.
3. Haz clic en **Actualizar**.

   [Imagen: Modos de autenticación de la directiva con el proveedor de identidades de Ironchip marcado]

## Generar accesos para los usuarios

1. Vuelve a la consola de Ironchip y termina de crear la aplicación haciendo clic en **ADD**.
2. En **Your applications**, busca la aplicación y, en la columna **Add access**, haz clic en **Add**.
3. Asigna los usuarios o grupos que podrán autenticarse en Zoho One a través de Ironchip.

   [Imagen: Lista Your applications de Ironchip con el botón Add de la columna Add access junto a Zoho One]

## Comprobación

1. Pide a un usuario al que hayas dado acceso que inicie sesión en Zoho One con el proveedor de identidades de Ironchip.
2. Zoho One lo redirige a Ironchip para autenticarse.
3. Cuando completa la autenticación en su dispositivo, vuelve a Zoho One con la sesión iniciada.

## Problemas frecuentes

| Problema                                                     | Causa probable                                                                                                                                      | Solución                                                                                                                                             |
| ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| El inicio de sesión falla después de importar el certificado | El certificado no tiene el formato correcto                                                                                                         | Vuelve a formatearlo con la herramienta indicada y comprueba que empieza por `-----BEGIN CERTIFICATE-----` y termina con `-----END CERTIFICATE-----` |
| Zoho One no reconoce al usuario                              | El **Formato de ID de nombre** no es **Dirección de correo electrónico**, o el nombre de usuario del acceso en Ironchip no es el correo del usuario | Corrige el formato en Zoho One y edita el acceso del usuario a la aplicación en Ironchip para usar como nombre de usuario su correo de Zoho One      |
| El usuario no puede autenticarse                             | No tiene acceso a la aplicación en Ironchip                                                                                                         | En la columna **Add access** de la aplicación, haz clic en **Add** y asigna el usuario o su grupo                                                    |