> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/es/tu-espacio-de-trabajo/team/rippling-sso.md).

# Configuración de SSO de Rippling

Configura el inicio de sesión único SAML de Rippling para tu espacio de trabajo de AirOps, asigna atributos de los empleados y prueba el inicio de sesión desde AirOps y Rippling.

Conecta Rippling a tu espacio de trabajo de AirOps para que los empleados puedan iniciar sesión con su cuenta de Rippling. Un administrador configura la conexión una sola vez y luego asigna la app de AirOps a los empleados en Rippling.

La configuración intercambia dos conjuntos de valores: AirOps proporciona las URL de destino y Rippling proporciona los metadatos del proveedor de identidad.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-807c59ee1a49bf7780e4ef92a4d971913c5ecb3b%2Frippling-sso-00-overview.png?alt=media" alt="Copy the ACS URL and SP entity ID from AirOps to Rippling, then import Rippling IdP metadata XML into AirOps"><figcaption><p>Mantén abiertas ambas páginas de administración. Copiarás valores en ambas direcciones.</p></figcaption></figure>

## Antes de empezar

Necesitas:

* Un espacio de trabajo de AirOps con SSO de Rippling habilitado y permiso para administrar la configuración de SSO. Ponte en contacto con tu equipo de cuenta de AirOps si Rippling no aparece en la lista de proveedores.
* Permiso para crear y configurar una aplicación SAML personalizada en tu empresa de Rippling.
* Un empleado al que puedas asignar para pruebas, con correo electrónico del trabajo y nombre en Rippling.

Mantén abierta tu sesión actual de administrador de AirOps mientras pruebas en un perfil de navegador separado o una ventana privada.

## Cómo configurarlo

Sigue estos pasos en orden. Mantén AirOps y Rippling abiertos en pestañas separadas para que puedas intercambiar los detalles de la conexión antes de probar el inicio de sesión. Cada captura de pantalla anotada de incorporación incluye llamadas numeradas para los controles que debes usar. Haz clic en una imagen para ampliarla.

### 1. Copia los detalles de la conexión desde AirOps

En tu **AirOps** pestaña:

1. Abrir **Configuración → Inicio de sesión único**.
2. Busca **Rippling** y haz clic en **Configura**.
3. Copia el **URL ACS** como en el **ID de entidad SP**. Mantén abierto este formulario; volverás a él en el paso 8.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-5966527e78da4fd419065326b0e64f32be85e3fc%2Fsso-rippling-01-connection.png?alt=media" alt="Add Rippling SAML connection dialog with the ACS URL and SP entity ID and their copy buttons"><figcaption><p>Copia ambos valores de tu propio espacio de trabajo.</p></figcaption></figure>

### 2. Inicia una integración personalizada en Rippling

Cambia a **Rippling**:

1. Abrir **TI → Acceso de terceros**.
2. Haz clic en **Agregar integración**.
3. Selecciona **Crear nueva integración personalizada**.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-671cecbb4b87af80cf2de7c97963c58b8476322d%2Frippling-sso-02-add-integration.jpg?alt=media" alt="Rippling Add integration menu with Create new custom integration"><figcaption><p>Abre el formulario de creación de integración personalizada.</p></figcaption></figure>

### 3. Introduce el nombre de la app, la categoría y el logotipo

En **Crear nueva integración**, completa:

| Campo                      | Qué introducir                                                               |
| -------------------------- | ---------------------------------------------------------------------------- |
| **Nombre**                 | Un nombre reconocible, como `AirOps SSO`.                                    |
| **Seleccionar categorías** | Elige una categoría, como **Productividad**.                                 |
| **Subir logotipo**         | Sube el logotipo que quieres que los empleados vean en su mosaico de AirOps. |

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-2805edfe525c635b5fa076a3d473b83eb8e383d2%2Frippling-sso-app-details-full.svg?alt=media" alt="Rippling Create new integration form showing the app Name, Productivity category, and an uploaded logo"><figcaption><p>La app de ejemplo se llama AirOps SSO. Elige un nombre que los empleados reconozcan.</p></figcaption></figure>

Quédate en esta página y desplázate hacia abajo hasta **Tipo de integración personalizada**.

### 4. Selecciona inicio de sesión único SAML

En la parte inferior del mismo formulario:

1. Selecciona **Integración de acceso de usuario**.
2. En **Capacidades**, marca **Inicio de sesión único**.
3. Elige **SAML** en el menú desplegable que aparece.
4. Deja **Aprovisionamiento y desaprovisionamiento de cuentas mediante SCIM** sin marcar.
5. Habilita **Admite aprovisionamiento justo a tiempo** si los empleados deben recibir una cuenta de AirOps en su primer inicio de sesión correcto. Las restricciones de registro de AirOps siguen aplicándose.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-310ae5bc1a46256990da53bf9d08fe0ce787b71a%2Frippling-sso-app-saml-full.svg?alt=media" alt="Rippling form with User access integration selected, Single sign-on checked, SAML selected, SCIM unchecked, and just-in-time provisioning enabled"><figcaption><p>Selecciona la capacidad SAML y el comportamiento de aprovisionamiento para tu implementación.</p></figcaption></figure>

Haz clic en **Continuar** para crear la integración.

### 5. Elige al instalador

En **Selecciona un instalador**:

1. Selecciona **Sí, instalaré esta integración** si administras la integración de AirOps para tu empresa.
2. Haz clic en **Continuar** para llegar a **instrucciones de configuración de SSO**.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-9866733f83400a6d74636dba862b0821f38f6482%2Frippling-sso-installer-full.svg?alt=media" alt="Rippling installer selection screen with numbered callouts for choosing the installer and continuing"><figcaption><p>Selecciona a la persona que configurará la conexión. La captura de pantalla muestra el formulario antes de realizar una selección.</p></figcaption></figure>

Para una instalación existente, abre **Acceso → Inicio de sesión único (SSO) → Configuración** y haz clic en **Reconfigurar** en **General** para volver a abrir el asistente.

### 6. Copia o descarga el XML de metadatos de Rippling

En **instrucciones de configuración de SSO**, busca **Paso 1 - Introducir los campos de configuración SAML**, luego localiza **Metadatos IdP**. Este XML contiene los detalles de conexión de Rippling que AirOps necesita.

Elige una opción:

* **Descargar el XML:** Haz clic en el icono de descarga a la derecha de **Metadatos IdP** y guarda el archivo. Lo subirás a AirOps en el paso 8.
* **Copiar el XML:** Copia el contenido XML completo de **Metadatos IdP**. Cambia a tu pestaña de AirOps y pégalo en **O pegar XML de metadatos** ahora y luego vuelve a Rippling. Mantén abierto el formulario de AirOps.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-44ef5f9ff6b79bd19ac24d3bda9c7ad150213073%2Frippling-sso-05-rippling-metadata.jpg?alt=media" alt="Rippling IdP Metadata section showing the XML contents and its download icon"><figcaption><p>Copia o descarga el XML completo de metadatos IdP para la configuración de AirOps.</p></figcaption></figure>

Para una app instalada, la descarga también está disponible en **Acceso → Inicio de sesión único (SSO) → Configuración → Metadatos → XML de metadatos**.

Mantén abierta la página de configuración de Rippling para introducir a continuación las URL de AirOps.

### 7. Pega las URL de AirOps en Rippling

En la misma **instrucciones de configuración de SSO** página, desplázate hasta **Paso 2 - Proporcionar metadatos del proveedor de servicios**. Copia cada valor del formulario de AirOps en su campo correspondiente de Rippling:

| Campo de Rippling                                | Valor para pegar         |
| ------------------------------------------------ | ------------------------ |
| **URL del Servicio de Consumidor de Aserciones** | Tu **URL ACS**.          |
| **ID de entidad del proveedor de servicios**     | Tu **ID de entidad SP**. |

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-fc52a7014db2a452acddf222c3546301e832bef4%2Frippling-sso-02-rippling-endpoints.jpg?alt=media" alt="Rippling SSO setup instructions showing Assertion Consumer Service URL and Service Provider Entity ID"><figcaption><p>La captura de pantalla muestra URL de ejemplo de un espacio de trabajo de AirOps. Copia las URL generadas para tu propio espacio de trabajo y entorno.</p></figcaption></figure>

Estos dos campos proporcionan los metadatos del proveedor de servicios. Puedes dejar la alternativa **URL de metadatos** como en el **Metadatos** vacía cuando uses este método.

Deja Rippling abierto y vuelve a cambiar a AirOps.

### 8. Guarda la conexión en AirOps

En el formulario de AirOps que dejaste abierto:

1. Si descargaste el XML en el paso 6, elige **Subir XML de metadatos IdP** y selecciona el archivo. Si lo copiaste, usa el contenido ya pegado en **O pegar XML de metadatos**.
2. Haz clic en **Revisar metadatos**.
3. Comprueba el **ID de entidad IdP**, **URL de SSO**, y **Certificados de firma**.
4. Introduce los nombres exactos de atributos configurados en tu app de Rippling. **Los nombres a continuación son ejemplos; tu app puede usar nombres diferentes.** Ver [paso 16: Configura los atributos de los empleados](#16-configure-the-employee-attributes) para comprobarlos o crearlos antes de probar el inicio de sesión.

| Campo de AirOps                                | Ejemplo          | Qué introducir para tu conexión                                                                                     |
| ---------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Formato NameID**                             | **emailAddress** | El mismo formato NameID configurado en Rippling.                                                                    |
| **Atributo de correo electrónico del trabajo** | `emailAddress`   | El nombre exacto del atributo que usa Rippling para enviar el correo electrónico del trabajo del empleado.          |
| **Atributo de nombre**                         | `firstName`      | El nombre exacto del atributo que usa Rippling para enviar el nombre del empleado.                                  |
| **Atributo de apellido (opcional)**            | `lastName`       | El nombre exacto del atributo que usa Rippling para enviar el apellido del empleado. Déjalo en blanco si no se usa. |
| **Rol predeterminado**                         | **Member**       | Elige el rol de AirOps que deben recibir los nuevos miembros del espacio de trabajo.                                |

Estos campos contienen nombres de atributos. Rippling proporciona el correo electrónico y el nombre reales del empleado cuando inicia sesión.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-a73f137f2c676a7da8f47c82cc2f5b0a3f8f5ead%2Fsso-rippling-02-attributes.png?alt=media" alt="Rippling SAML connection with NameID format emailAddress, the emailAddress, firstName, and lastName attributes, and Member as the default role"><figcaption><p>Configuración de ejemplo. Usa los nombres de atributos de Rippling y elige el rol de AirOps para los nuevos miembros.</p></figcaption></figure>

Haz clic en **Agregar conexión**. Confirma que AirOps muestre **Conexión de Rippling guardada.**

{% hint style="info" %}
El **ID de entidad IdP** importado identifica a Rippling. El **ID de entidad SP** que copiaste en el paso 1 identifica el espacio de trabajo de AirOps. Cada uno pertenece a su propio lado de la conexión.
{% endhint %}

### 9. Establece las reglas de acceso a la app de SSO

Vuelve a la página de Rippling **instrucciones de configuración de SSO** y haz clic en **Ir al siguiente paso**. En **reglas de acceso a la app de SSO**, elige quién debe recibir la app de AirOps:

1. Usa **Asignar un grupo** para asignar tu grupo piloto, o **Asignar a una persona** para asignar a tu empleado de prueba. Puedes usar cualquiera de los dos métodos.
2. Revisar **Grupos asignados**, **Personas asignadas**, y **Exclusiones**. Mantén la asignación inicial limitada a las personas de tu piloto.
3. Haz clic en **Continuar**.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-dddcad45377a78d57a8daa11cbd0c244500afba0%2Frippling-sso-access-rules-full.svg?alt=media" alt="Full Rippling SSO app access rules screen with numbered boxes and arrows around the group assignment, individual assignment, and Continue controls"><figcaption><p>Asigna la app a tu empleado de prueba o grupo piloto. La elegibilidad para SSO es una elección separada en el paso 14.</p></figcaption></figure>

### 10. Revisa el momento del acceso

En **Tiempo de aprovisionamiento**, **Tiempo de acceso para nuevos empleados** determina cuándo alguien que coincide con las reglas de acceso de la app pasa a ser elegible para el acceso.

| Opción                                                         | Cuándo está disponible el acceso                                             |
| -------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| **Tan pronto como hayan firmado su carta de oferta o acuerdo** | Después de que el empleado firme su oferta o acuerdo.                        |
| **En su fecha de inicio, no antes**                            | En la fecha de inicio del empleado.                                          |
| **Una hora fija antes de su fecha de inicio**                  | En el intervalo que configures antes de la fecha de inicio del empleado.     |
| **Tan pronto como el administrador los contrate**              | Cuando el administrador contrata al empleado, antes de que firme un acuerdo. |

Selecciona el momento que se ajuste a las políticas de incorporación y acceso de tu organización y luego haz clic en **Continuar**. AirOps crea una nueva cuenta elegible en el primer inicio de sesión exitoso, sujeta a las restricciones de registro.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-48af3406e4495e5a900210991f747f681e9e8ff6%2Frippling-sso-provision-time-full.svg?alt=media" alt="Full Rippling Provision time screen highlighting the available access timing options and Continue"><figcaption><p>La opción seleccionada es un ejemplo. Elige el momento que se ajuste a las políticas de tu organización.</p></figcaption></figure>

### 11. Revisa las opciones de SSO para administradores

En **SSO para administradores**, Rippling pregunta si los administradores de Rippling de tu empresa deberían poder iniciar sesión en una cuenta de administrador compartida de AirOps.

| Opción                                                                                                             | Qué controla                                                                                                                                 |
| ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Permitir que los administradores de \[tu empresa] inicien sesión en la cuenta de administrador de \[tu app]**    | Rippling ofrece a los administradores con acceso completo acceso a la cuenta designada como la cuenta de administrador compartida de la app. |
| **No permitir que los administradores de \[tu empresa] inicien sesión en la cuenta de administrador de \[tu app]** | Deja deshabilitado el acceso de administrador compartido. Los administradores aún pueden usar SSO con sus cuentas individuales.              |

Para esta configuración, recomendamos seleccionar **No permitir que los administradores de \[tu empresa] inicien sesión en la cuenta de administrador de \[tu app]** para que cada persona inicie sesión con su propia cuenta de AirOps. Los administradores de AirOps aún pueden usar SSO y conservar sus roles de espacio de trabajo asignados.

Después de revisar la configuración, haz clic en **Continuar**. Gestiona los roles de espacio de trabajo de los usuarios individuales en AirOps.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-db7c7ba0da198a6319fb2f9847411972a2085ece%2Frippling-sso-admin-sso-full.svg?alt=media" alt="Full Rippling Shared Admin SSO screen highlighting the recommended Don&#x27;t let option and Continue"><figcaption><p>La captura de pantalla muestra la opción recomendada para esta configuración. Los nombres de la empresa y de la app coincidirán con tu integración.</p></figcaption></figure>

### 12. Revisa los atributos opcionales de grupo

**Atributos de grupo** permiten que Rippling incluya valores relacionados con grupos en la respuesta de inicio de sesión SAML. Por ejemplo, un atributo `grupos` podría enviar `Ingeniería` para los empleados de tu grupo de Ingeniería.

Revisa cualquier atributo de grupo ya configurado para tu app. Si la configuración SAML de tu organización requiere información adicional de grupo, usa **Crear nuevo** para definir los valores y las personas a las que se aplican. También puedes continuar sin agregar atributos de grupo.

Para AirOps, estos atributos son opcionales y no asignan roles de espacio de trabajo. Los nuevos miembros del espacio de trabajo reciben el **Rol predeterminado** seleccionado en el paso 8; los miembros activos existentes conservan sus roles. Las asignaciones de apps y la elegibilidad para SSO se configuran por separado en los pasos 9 y 14. Los atributos de correo electrónico y nombre del empleado se configuran en el paso 16.

Después de revisar la configuración, haz clic en **Continuar**.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-1fe53e2abbc0baa7c71d5f6ba24496abb90fd253%2Frippling-sso-group-attributes-full.svg?alt=media" alt="Full Rippling Group attributes screen for AirOps SSO showing no configured group attributes and highlighting Continue"><figcaption><p>Este ejemplo no tiene atributos de grupo configurados. Configura valores opcionales para que se ajusten a la configuración de tu organización.</p></figcaption></figure>

### 13. Pospone la prueba inicial de conexión

La **Verificar la integración SSO** el paso muestra **Probar la conexión de Rippling con \[tu app]** y un botón **Conectar mediante Rippling** .

Los atributos del empleado y la configuración del panel aún deben revisarse después de la instalación. Haz clic en **Continuar** por ahora y vuelve a esta prueba en el paso 19. Continuar más allá de esta pantalla no confirma un inicio de sesión correcto.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-5349c853c1ae22549b809c3df02ffdae1b7d5599%2Frippling-sso-connection-test-full.svg?alt=media" alt="Full Test Rippling&#x27;s connection screen highlighting only Continue"><figcaption><p>Haz clic en Continuar para seguir configurando la app. Ejecuta la prueba de conexión en el paso 19.</p></figcaption></figure>

{% hint style="info" %}
El texto genérico de prueba de Rippling menciona la creación y desactivación de usuarios. Esta configuración SAML crea nuevas cuentas de AirOps elegibles al iniciar sesión. No configura SCIM ni elimina automáticamente la membresía de AirOps cuando se elimina una asignación de Rippling.
{% endhint %}

### 14. Elige qué usuarios asignados pueden iniciar sesión con SSO

En **Elegibilidad para SSO**, la página pregunta **¿Qué usuarios asignados pueden iniciar sesión con SSO?**:

1. Elige **Todos los usuarios asignados** si todos los asignados en el paso 9 deben usar SSO. Para probar SSO con un subconjunto más pequeño de los usuarios asignados a la app, elige **Solo usuarios asignados seleccionados** e incluye a tu empleado de prueba en las reglas que aparecen.
2. Revisar **Excluir usuarios (opcional)** y comprueba que tu empleado de prueba no esté excluido. Usa **Vista previa de personas** para comprobar el resultado de cualquier regla.
3. Haz clic en **Continuar**.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-884b2ba441aa1c86691228b058c0bf61ca4f9eea%2Frippling-sso-sso-eligibility-full.svg?alt=media" alt="Full Rippling SSO Eligibility screen highlighting All assigned users or Only selected assigned users, exclusion rules, and Continue"><figcaption><p>Un empleado debe tener tanto una asignación de app como elegibilidad para SSO. La captura de pantalla muestra seleccionado Todos los usuarios asignados.</p></figcaption></figure>

### 15. Termina la instalación y abre Configuración

Completa cualquier indicación restante que Rippling presente para tu instalación. Cuando llegues a **instalación de \[tu app] completada**, haz clic en **Ir a la integración**.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-072c9125d3994f115872f7d80cc343547028ed95%2Frippling-sso-installation-complete-full.svg?alt=media" alt="Full Rippling installation complete screen with a numbered arrow pointing to Go to integration"><figcaption><p>Abre la app instalada para revisar sus atributos de empleado y ajustes avanzados.</p></figcaption></figure>

En tu integración de AirOps:

1. Selecciona **Acceso**.
2. Selecciona **Inicio de sesión único (SSO)**.
3. Abrir **Configuración**.

Mantén esta página abierta para los atributos de empleado y los ajustes avanzados a continuación.

### 16. Configura los atributos del empleado

En **Rippling**, abre tu integración de AirOps y ve a **Acceso → Inicio de sesión único (SSO) → Configuración → Atributos SAML**.

Primero, busca los atributos para correo electrónico del trabajo, nombre y apellido opcional en la columna **Nombre** . Reutiliza los atributos existentes y crea solo los mapeos que falten.

La tabla siguiente muestra nombres de ejemplo y campos de empleado. Los nombres de tus atributos pueden diferir; cada nombre debe coincidir con el campo correspondiente en AirOps.

| Campo de AirOps del paso 8                     | Nombre de atributo de Rippling de ejemplo | Valor de empleado de Rippling de ejemplo                                                                      |
| ---------------------------------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Atributo de correo electrónico del trabajo** | `emailAddress`                            | **Dirección de correo electrónico del usuario**, que contiene el correo electrónico del trabajo del empleado. |
| **Atributo de nombre**                         | `firstName`                               | **Nombre preferido del usuario**.                                                                             |
| **Atributo de apellido (opcional)**            | `lastName`                                | **Apellido preferido del usuario**. Omitir este mapeo si el campo de apellido está en blanco en AirOps.       |

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-866aef3dabc10630713be92a856b5e67790c2b0b%2Frippling-sso-03-rippling-attributes.jpg?alt=media" alt="Rippling SAML attributes table showing emailAddress, firstName, and lastName mapped to employee fields"><figcaption><p>AirOps SSO usa nombres preferidos y apellidos preferidos en este ejemplo. La columna Name debe coincidir con los nombres de atributos guardados en AirOps.</p></figcaption></figure>

**Agregar un atributo que falta**

Para cada fila que falte:

1. Haz clic en **Crear nuevo** en **Atributos SAML**.
2. En **Crear atributo SAML**, selecciona **Atributo global**. Esto te permite asignar un campo de empleado para cada persona que inicia sesión.
3. En **Nombre de atributo global**, introduce el nombre que también usarás en AirOps. Por ejemplo, introduce `firstName` para un nuevo mapeo de nombre.
4. Abrir **Valor** y selecciona el campo de empleado correspondiente. Para `firstName`, elige **Nombre preferido del usuario**. Selecciona el campo del menú desplegable para que Rippling use el valor del empleado que inicia sesión.
5. Haz clic en **Guardar**, luego comprueba que la fila aparezca debajo de **Atributos SAML**.
6. Repite el proceso para cualquier mapeo de correo electrónico del trabajo o apellido que falte, usando los nombres de atributo que elegiste y los campos de empleado correspondientes. La tabla muestra `emailAddress` como en el `lastName` como ejemplos. Omite cualquier mapeo que ya exista.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-7ecfc5baa42f448c6bcaf8fb0a5dc607a772ddac%2Frippling-sso-create-employee-attribute-full.svg?alt=media" alt="Rippling Create SAML attribute form with numbered callouts for Global attribute, the firstName name, the dynamic Preferred first name value, and Save"><figcaption><p>Ejemplo de creación de firstName cuando falta. Usa la tabla anterior para emailAddress y lastName. La captura de pantalla muestra un formulario sin guardar.</p></figcaption></figure>

**Comprobar o corregir un atributo existente**

1. Abre el menú de la fila del atributo y elige **Editar**.
2. Comprobación **Valor** con respecto a la tabla y selecciona el campo de empleado correspondiente si es necesario.
3. Haz clic en **Guardar** si cambiaste el valor. Repite el proceso con los otros atributos existentes.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-f4a30675e85a29519c7a349ca5fb299c87fb8412%2Frippling-sso-03-rippling-attribute-editor.jpg?alt=media" alt="Rippling Edit SAML attribute dialog showing firstName and the Value dropdown set to User&#x27;s Preferred first name"><figcaption><p>Edita una fila existente en lugar de crear un duplicado.</p></figcaption></figure>

**Haz coincidir los nombres en AirOps**

Los valores de Rippling **Nombre** deben coincidir con el **Atributo de correo electrónico del trabajo**, **Atributo de nombre**, y opcional **atributo de apellido** que guardaste en el paso 8. Si usaste nombres diferentes, abre **AirOps → Configuración → Inicio de sesión único → Rippling → Acciones → Actualizar credenciales**, introduce esos nombres exactos y haz clic en **Guardar conexión**. Rippling fija los nombres de sus atributos predeterminados, así que usa los nombres que tu app realmente envía.

{% hint style="info" %}
Los nombres distinguen mayúsculas y minúsculas. Por ejemplo, si tu atributo de correo electrónico del trabajo de Rippling se llama `emailAddress`, introduce `emailAddress` en AirOps y selecciona **Dirección de correo electrónico del usuario** como su valor dinámico en Rippling. AirOps requiere el atributo de correo electrónico incluso cuando NameID contiene un correo electrónico. El opcional **Atributos de grupo** pantalla del asistente de incorporación no configura estos campos de identidad del empleado.
{% endhint %}

### 17. Haz coincidir el formato NameID y la configuración de firma

Desplázate hasta **Configuración avanzada** y haz clic en **Editar**.

El ejemplo de esta guía usa **emailAddress** para **Formato NameID predeterminado que se utilizará**:

```
urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress
```

Elige el formato que coincida con tu conexión de AirOps. Mantén **Estado de retransmisión predeterminado** en blanco.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-f82be7ba5d74c0859f7e37906f25681c96d63f75%2Frippling-sso-04-nameid.jpg?alt=media" alt="Rippling advanced settings showing emailAddress as the default NameID format and a blank default relay state"><figcaption><p>Usa el mismo formato NameID en Rippling y AirOps.</p></figcaption></figure>

Revisa las demás configuraciones:

| Configuración                                  | Valor                       |
| ---------------------------------------------- | --------------------------- |
| **Algoritmo de firma**                         | **RSA-SHA256** recomendado. |
| **Algoritmo de digestión para las aserciones** | **SHA-256** recomendado.    |
| **Cifrar aserciones**                          | **No**.                     |

AirOps requiere una aserción SAML firmada. Firmar solo la respuesta no cumple ese requisito.

Si está actualizando una conexión existente, conserve su valor y formato de NameID estables, y coincídalos en AirOps. Permanezca en **Configuración avanzada** para el siguiente paso.

### 18. Habilite el acceso rápido al panel

En el mismo **Configuración avanzada** formulario, configure:

| Configuración                                                                                                                  | Valor                                                |
| ------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------- |
| **Deshabilite el campo 'InResponseTo' en las aserciones para el SSO iniciado por el IdP**                                      | **Sí**                                               |
| **La aplicación solo admite el inicio de sesión iniciado desde la aplicación, también conocido como flujo iniciado por el SP** | **No**                                               |
| **Desactive la estandarización automática de atributos**                                                                       | **Sí**, para conservar los nombres de los atributos. |

Haz clic en **Guardar**, luego vuelva a abrir **Configuración avanzada** y compruebe los valores guardados.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-3f9e670465251d3f32189a17710105f6ad73e8d6%2Frippling-sso-04-rippling-quick-access.jpg?alt=media" alt="Saved Rippling advanced settings with Disable InResponseTo set to Yes and SP-initiated-only set to No"><figcaption><p>Confirme los dos valores de acceso rápido después de guardar: Sí para Disable InResponseTo y No para SP-initiated-only.</p></figcaption></figure>

La `InResponseTo` se aplica a los inicios desde el panel. Las respuestas a un inicio de sesión comenzado desde AirOps aún deben coincidir con la solicitud original. Rippling describe las opciones disponibles en su [referencia de SAML SSO](https://developer.rippling.com/documentation/developer-portal/v2-guides/saml).

### 19. Pruebe la conexión completada

Ambos lados ya están guardados. Mantenga abierta su sesión de administrador de AirOps y pruebe el inicio de sesión en un perfil de navegador o ventana privada separados.

Si está conectando una cuenta de AirOps existente por primera vez, siga [Conectar una cuenta de AirOps existente](#connect-an-existing-airops-account) antes de probar un inicio de sesión sin sesión iniciada.

**Inicie sesión desde AirOps**

1. Abre el [Página de inicio de sesión de AirOps](https://app.airops.com/users/sign_in).
2. Haz clic en **Iniciar sesión con Rippling** para mostrar el **slug del espacio de trabajo** campo.
3. Introduzca el slug de su espacio de trabajo de AirOps y haga clic en **Continuar**.
4. AirOps lo redirige a Rippling. Inicie sesión con su cuenta de Rippling y complete cualquier solicitud de autenticación. Si ya tiene una sesión activa en Rippling, Rippling puede continuar sin pedirle que inicie sesión de nuevo.
5. Rippling lo devuelve a AirOps. Confirme que su espacio de trabajo se abre y que puede acceder a él con el rol esperado.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-f3d9f24bd63e5db30df157e5f34454b28b7bfb33%2Frippling-sso-07-airops-sign-in.png?alt=media" alt="AirOps sign-in flow: choose Sign in with Rippling, enter the workspace slug and click Proceed, authenticate with Rippling, and return to the AirOps workspace"><figcaption><p>Seleccione Iniciar sesión con Rippling, introduzca el slug de su espacio de trabajo y haga clic en Continuar.</p></figcaption></figure>

**Inicie sesión desde el panel de Rippling**

1. Abra Rippling y haga clic en el mosaico de acceso rápido de AirOps.
2. En la página de continuación de AirOps, haga clic en **Continuar al espacio de trabajo**.
3. Complete cualquier solicitud de inicio de sesión de Rippling y luego confirme que llega al espacio de trabajo de AirOps previsto.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-b7a06114c36d8a1488a5ea9348572d553091e8ca%2Frippling-sso-06-sign-in.png?alt=media" alt="Rippling quick-access flow: AirOps tile, Continue to workspace, Rippling verification, and AirOps workspace"><figcaption><p>La página de continuación de AirOps es una parte esperada del inicio de sesión desde el panel.</p></figcaption></figure>

**Vuelva a visitar la prueba de conexión de Rippling**

También puede volver a **Conectar mediante Rippling** la prueba:

1. En **Configuración → General**, haz clic en **Reconfigurar**.
2. Abra el selector de pasos en la parte superior izquierda y seleccione **Verificar la integración SSO**.
3. Compruebe el correo electrónico del empleado que se muestra en **Probar la conexión de Rippling**, luego haz clic en **Conectar mediante Rippling**.
4. Complete el inicio de sesión. Si AirOps muestra **Continuar al espacio de trabajo**, haga clic en él y confirme que llega al espacio de trabajo previsto.

Si una prueba falla, revise la configuración antes de considerar que la configuración está completa. Completar solo el asistente de Rippling no verifica la conexión de AirOps.

Compruebe que un nuevo miembro recibe el rol predeterminado configurado y que un miembro activo existente conserva su rol.

## Referencia de configuración de AirOps

| Campo                                          | Qué introducir                                                                                                                                            |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **URL ACS / ID de entidad del SP**             | Generado por AirOps. Copie ambos en la aplicación SAML de Rippling.                                                                                       |
| **XML de metadatos del IdP**                   | Exporte desde la aplicación de Rippling correspondiente. Cargue o pegue un archivo de hasta 250 KB y luego haga clic en **Revisar metadatos**.            |
| **Formato NameID**                             | Coincida con el formato de Rippling y use un identificador de empleado estable. Mantenga el identificador y el formato coherentes después del despliegue. |
| **Atributo de correo electrónico del trabajo** | Nombre exacto del atributo SAML, sensible a mayúsculas y minúsculas, que contiene el correo electrónico laboral del empleado. Obligatorio.                |
| **Atributo de nombre**                         | Nombre exacto del atributo SAML que contiene el nombre del empleado. Obligatorio.                                                                         |
| **Atributo de apellido (opcional)**            | Nombre exacto del atributo SAML que contiene el apellido del empleado. Déjelo en blanco si se omite.                                                      |
| **Rol predeterminado**                         | Rol para los nuevos miembros del espacio de trabajo. Los miembros activos existentes conservan su rol actual.                                             |

Para actualizar una conexión, abra **Configuración → Single Sign On → Rippling → Acciones → Actualizar credenciales**, realice los cambios y haga clic en **Guardar conexión**. Importe metadatos nuevos cuando Rippling rote sus certificados de firma, antes de que expiren los certificados existentes.

## Ejemplos de inicio de sesión

### Comparta las instrucciones de inicio de sesión

Comparta el [Página de inicio de sesión de AirOps](https://app.airops.com/users/sign_in) y el slug de su espacio de trabajo con los empleados. Pueden seleccionar **Iniciar sesión con Rippling**, introducir el slug y hacer clic en **Continuar**.

Los empleados también pueden usar el mosaico SAML de AirOps en su panel de Rippling.

### Conectar una cuenta de AirOps existente

Para el primer inicio de sesión de Rippling en una cuenta de AirOps existente:

1. Inicie sesión en AirOps usando el método de inicio de sesión actual de la cuenta.
2. En el **mismo perfil de navegador**, abra el mosaico SAML de AirOps en su panel de Rippling y haga clic en **Continuar al espacio de trabajo**.
3. Complete el inicio de sesión de Rippling usando el correo electrónico laboral correspondiente.

Después de vincular la cuenta, pruebe un inicio de sesión sin sesión iniciada. Si AirOps le pide que use su proveedor de inicio de sesión original, póngase en contacto con su equipo de cuenta de AirOps para coordinar la transición.

### Comprenda el comportamiento de la membresía

AirOps crea una nueva cuenta y membresía en el espacio de trabajo durante el primer inicio de sesión exitoso del empleado, sujeto a las restricciones de registro de su espacio de trabajo. Esta conexión SSO no sincroniza la membresía ni los roles de los empleados a través de SCIM. Gestione por separado la membresía existente de AirOps al retirar el acceso.

## Solución de problemas

| Lo que ve                                                                        | Qué comprobar                                                                                                                                                                                                                                                                                                                                                                                             |
| -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Rippling** falta en la configuración o el inicio de sesión de AirOps           | Pida a su equipo de cuenta de AirOps que habilite Rippling para el espacio de trabajo.                                                                                                                                                                                                                                                                                                                    |
| **No se pudo verificar el inicio de sesión de Rippling**                         | Confirme que la URL ACS y el ID de entidad del SP coinciden con el mismo espacio de trabajo y entorno de AirOps. Vuelva a comprobar los metadatos, la validez del certificado, el formato NameID y la configuración de aserción firmada. Para los inicios desde el panel, revise también ambos conmutadores de acceso rápido en el paso 18 y deje en blanco Default Relay State. Inicie un nuevo intento. |
| Falta un atributo de correo electrónico o de nombre                              | Coincida exactamente con los nombres de los atributos, incluida la capitalización. Seleccione campos del empleado como valores en Rippling y confirme que el empleado asignado tiene esos valores rellenados.                                                                                                                                                                                             |
| El mosaico de acceso rápido abre la página general de inicio de sesión de AirOps | Confirme que el mosaico inicia la aplicación SAML, en lugar de un marcador a la página de inicio de sesión. Vuelva a abrir y verifique la configuración de acceso rápido en el paso 18.                                                                                                                                                                                                                   |
| AirOps le pide que inicie sesión primero en una cuenta existente                 | Siga **Conectar una cuenta de AirOps existente** lo anterior en el mismo perfil de navegador.                                                                                                                                                                                                                                                                                                             |
| **Agregar conexión** no está disponible                                          | Importe los metadatos y haga clic en **Revisar metadatos**. Revíselo de nuevo si cambia el XML.                                                                                                                                                                                                                                                                                                           |
| El rol de un miembro existente no cambió                                         | El rol predeterminado se aplica a los nuevos miembros. Actualice el rol del miembro existente en AirOps.                                                                                                                                                                                                                                                                                                  |

Si el inicio de sesión sigue fallando, comparta con el soporte de AirOps el slug del espacio de trabajo, el punto de entrada, la hora del intento y el error mostrado. No incluya una respuesta SAML ni tokens de sesión.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/es/tu-espacio-de-trabajo/team/rippling-sso.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
