> 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/fr/votre-espace-de-travail/team/rippling-sso.md).

# Configuration de l’authentification unique (SSO) Rippling

Configurez l’authentification unique SAML de Rippling pour votre espace de travail AirOps, mappez les attributs des employés et testez la connexion depuis AirOps et Rippling.

Connectez Rippling à votre espace de travail AirOps afin que les employés puissent se connecter avec leur compte Rippling. Un administrateur configure la connexion une seule fois, puis attribue l'application AirOps aux employés dans Rippling.

La configuration échange deux ensembles de valeurs : AirOps fournit les URL de destination, et Rippling fournit les métadonnées du fournisseur d'identité.

<figure><img src="https://344527547-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>Gardez les deux pages d'administration ouvertes. Vous copierez des valeurs dans chaque sens.</p></figcaption></figure>

## Avant de commencer

Vous aurez besoin de :

* D'un espace de travail AirOps avec le SSO Rippling activé et l'autorisation de gérer les paramètres SSO. Contactez votre équipe de compte AirOps si Rippling n'apparaît pas dans la liste des fournisseurs.
* De l'autorisation de créer et de configurer une application SAML personnalisée dans votre société Rippling.
* D'un employé que vous pouvez attribuer pour les tests, avec une adresse e-mail professionnelle et un prénom dans Rippling.

Gardez votre session d'administration AirOps actuelle ouverte pendant les tests dans un profil de navigateur séparé ou une fenêtre privée.

## Comment configurer

Suivez ces étapes dans l'ordre. Gardez AirOps et Rippling ouverts dans des onglets séparés afin de pouvoir échanger les détails de la connexion avant de tester la connexion. Chaque capture d'écran d'intégration annotée comprend des repères numérotés pour les contrôles à utiliser. Cliquez sur une image pour l'agrandir.

### 1. Copiez les détails de connexion depuis AirOps

Dans votre **AirOps** onglet :

1. Ouvrez **Paramètres → Authentification unique**.
2. Trouvez **Rippling** et cliquez sur **Configurer**.
3. Copiez l' **URL ACS** et le **ID d'entité du SP**. Gardez ce formulaire ouvert ; vous y reviendrez à l'étape 8.

<figure><img src="https://344527547-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>Copiez les deux valeurs depuis votre propre espace de travail.</p></figcaption></figure>

### 2. Lancez une intégration personnalisée dans Rippling

Passez à **Rippling**:

1. Ouvrez **IT → Accès à des tiers**.
2. Cliquez sur **Ajouter une intégration**.
3. Sélectionnez **Créer une nouvelle intégration personnalisée**.

<figure><img src="https://344527547-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>Ouvrez le formulaire de création d'intégration personnalisée.</p></figcaption></figure>

### 3. Saisissez le nom de l'application, la catégorie et le logo

Dans **Créer une nouvelle intégration**, renseignez :

| Champ                           | À saisir                                                                                  |
| ------------------------------- | ----------------------------------------------------------------------------------------- |
| **Nom**                         | Un nom reconnaissable, comme `AirOps SSO`.                                                |
| **Sélectionner des catégories** | Choisissez une catégorie, comme **Productivité**.                                         |
| **Téléverser le logo**          | Téléversez le logo que vous souhaitez voir apparaître aux employés sur leur tuile AirOps. |

<figure><img src="https://344527547-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>L'application d'exemple s'appelle AirOps SSO. Choisissez un nom que les employés reconnaîtront.</p></figcaption></figure>

Restez sur cette page et faites défiler jusqu'à **Type d'intégration personnalisée**.

### 4. Sélectionnez l'authentification unique SAML

Dans la partie inférieure du même formulaire :

1. Sélectionnez **Intégration d'accès utilisateur**.
2. Sous **Fonctionnalités**, cochez **Authentification unique**.
3. Choisissez **SAML** dans la liste déroulante qui apparaît.
4. Laissez **Le provisionnement et le déprovisionnement des comptes via SCIM** décoché.
5. Activez **Prise en charge du provisionnement juste-à-temps** si les employés doivent recevoir un compte AirOps à leur première connexion réussie. Les restrictions d'inscription AirOps continuent de s'appliquer.

<figure><img src="https://344527547-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>Sélectionnez la capacité SAML et le comportement de provisionnement pour votre déploiement.</p></figcaption></figure>

Cliquez sur **Continuer** pour créer l'intégration.

### 5. Choisissez l'installateur

Dans **Sélectionnez un installateur**:

1. Sélectionnez **Oui, j'installerai cette intégration** si vous gérez l'intégration AirOps pour votre entreprise.
2. Cliquez sur **Continuer** pour accéder aux **instructions de configuration du SSO**.

<figure><img src="https://344527547-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>Sélectionnez la personne qui configurera la connexion. La capture d'écran montre le formulaire avant qu'un choix ne soit effectué.</p></figcaption></figure>

Pour une installation existante, ouvrez **Accès → Authentification unique (SSO) → Configuration** et cliquez sur **Reconfigurer** dans **Général** pour rouvrir l'assistant.

### 6. Copiez ou téléchargez le XML de métadonnées de Rippling

Dans **instructions de configuration du SSO**, trouvez **Étape 1 - Saisir les champs de configuration SAML**, puis localisez **Métadonnées IdP**. Ce XML contient les détails de connexion Rippling nécessaires à AirOps.

Choisissez une option :

* **Télécharger le XML :** Cliquez sur l'icône de téléchargement à droite de **Métadonnées IdP** et enregistrez le fichier. Vous le téléverserez dans AirOps à l'étape 8.
* **Copier le XML :** Copiez le contenu XML complet de **Métadonnées IdP**. Passez à votre onglet AirOps et collez-le dans **Ou coller le XML de métadonnées** maintenant, puis revenez à Rippling. Gardez le formulaire AirOps ouvert.

<figure><img src="https://344527547-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>Copiez ou téléchargez le XML complet des métadonnées IdP pour la configuration AirOps.</p></figcaption></figure>

Pour une application installée, le téléchargement est également disponible sous **Accès → Authentification unique (SSO) → Configuration → Métadonnées → XML des métadonnées**.

Gardez la page de configuration Rippling ouverte pour saisir ensuite les URL AirOps.

### 7. Collez les URL AirOps dans Rippling

Sur la même **instructions de configuration du SSO** page, faites défiler jusqu'à **Étape 2 - Fournir les métadonnées du fournisseur de services**. Copiez chaque valeur du formulaire AirOps dans le champ Rippling correspondant :

| Champ Rippling                               | Valeur à coller              |
| -------------------------------------------- | ---------------------------- |
| **URL du service consommateur d'assertions** | Votre **URL ACS**.           |
| **ID d'entité du fournisseur de services**   | Votre **ID d'entité du SP**. |

<figure><img src="https://344527547-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 capture d'écran montre des URL d'exemple provenant d'un espace de travail AirOps. Copiez les URL générées pour votre propre espace de travail et environnement.</p></figcaption></figure>

Ces deux champs fournissent les métadonnées du fournisseur de services. Vous pouvez laisser le **URL des métadonnées** et le **Métadonnées** de rechange vides lorsque vous utilisez cette méthode.

Laissez Rippling ouvert et revenez à AirOps.

### 8. Enregistrez la connexion dans AirOps

Dans le formulaire AirOps que vous avez laissé ouvert :

1. Si vous avez téléchargé le XML à l'étape 6, choisissez **Téléverser le XML de métadonnées IdP** et sélectionnez le fichier. Si vous l'avez copié, utilisez le contenu déjà collé dans **Ou coller le XML de métadonnées**.
2. Cliquez sur **Examiner les métadonnées**.
3. Vérifiez l' **ID d'entité IdP**, **URL SSO**, et **Certificats de signature**.
4. Saisissez les noms d'attribut exacts configurés dans votre application Rippling. **Les noms ci-dessous sont des exemples ; votre application peut utiliser des noms différents.** Voir [étape 16 : Configurer les attributs des employés](#16-configure-the-employee-attributes) pour les vérifier ou les créer avant de tester la connexion.

| Champ AirOps                                | Exemple            | Ce qu'il faut saisir pour votre connexion                                                                               |
| ------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| **Format NameID**                           | **adresse e-mail** | Le même format NameID que celui configuré dans Rippling.                                                                |
| **Attribut e-mail professionnel**           | `adresse e-mail`   | Le nom exact de l'attribut utilisé par Rippling pour envoyer l'e-mail professionnel de l'employé.                       |
| **Attribut du prénom**                      | `firstName`        | Le nom exact de l'attribut utilisé par Rippling pour envoyer le prénom de l'employé.                                    |
| **Attribut du nom de famille (facultatif)** | `lastName`         | Le nom exact de l'attribut utilisé par Rippling pour envoyer le nom de famille de l'employé. Laissez vide si inutilisé. |
| **Rôle par défaut**                         | **Membre**         | Choisissez le rôle AirOps que les nouveaux membres de l'espace de travail doivent recevoir.                             |

Ces champs contiennent des noms d'attribut. Rippling fournit l'adresse e-mail et le nom réels de l'employé lorsqu'il se connecte.

<figure><img src="https://344527547-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>Configuration d'exemple. Utilisez vos noms d'attribut Rippling et choisissez le rôle AirOps pour les nouveaux membres.</p></figcaption></figure>

Cliquez sur **Ajouter la connexion**. Vérifiez qu'AirOps affiche **Connexion Rippling enregistrée.**

{% hint style="info" %}
L'ID d'entité IdP importé **ID d'entité IdP** identifie Rippling. Le **ID d'entité du SP** que vous avez copiée à l'étape 1 identifie l'espace de travail AirOps. Chacun appartient à son propre côté de la connexion.
{% endhint %}

### 9. Définissez les règles d'accès à l'application SSO

Retournez à la **instructions de configuration du SSO** page Rippling et cliquez sur **Passer à l'étape suivante**. Dans **règles d'accès à l'application SSO**, choisissez qui doit recevoir l'application AirOps :

1. Utilisez **Attribuer un groupe** pour attribuer votre groupe pilote, ou **Attribuer une personne** pour attribuer votre employé test. Vous pouvez utiliser l'une ou l'autre méthode.
2. Examiner **Groupes attribués**, **Personnes attribuées**, et **Exclusions**. Limitez l'attribution initiale aux personnes de votre pilote.
3. Cliquez sur **Continuer**.

<figure><img src="https://344527547-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>Attribuez l'application à votre employé test ou à votre groupe pilote. L'éligibilité au SSO est un choix distinct à l'étape 14.</p></figcaption></figure>

### 10. Vérifiez le calendrier d'accès

Dans **Temps de provisionnement**, **Délai d'accès des nouveaux arrivants** détermine quand une personne correspondant aux règles d'accès de l'application devient éligible à l'accès.

| Option                                                      | Quand l'accès devient disponible                                             |
| ----------------------------------------------------------- | ---------------------------------------------------------------------------- |
| **Dès qu'ils ont signé leur lettre d'offre ou leur accord** | Après que l'employé a signé son offre ou son accord.                         |
| **À leur date de début, pas avant**                         | À la date de début de l'employé.                                             |
| **Un délai fixe avant leur date de début**                  | À l'intervalle que vous configurez avant la date de début de l'employé.      |
| **Dès que l'administrateur les embauche**                   | Lorsque l'administrateur embauche l'employé, avant qu'il ne signe un accord. |

Sélectionnez le calendrier qui correspond aux politiques d'intégration et d'accès de votre organisation, puis cliquez sur **Continuer**. AirOps crée un nouveau compte éligible à la première connexion réussie, sous réserve des restrictions d'inscription.

<figure><img src="https://344527547-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>L'option sélectionnée est un exemple. Choisissez le calendrier qui correspond aux politiques de votre organisation.</p></figcaption></figure>

### 11. Vérifiez les options SSO pour les administrateurs

Dans **SSO pour les administrateurs**, Rippling demande si les administrateurs Rippling de votre entreprise doivent pouvoir se connecter à un compte administrateur AirOps partagé.

| Option                                                                                                             | Ce que cela contrôle                                                                                                           |
| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| **Autoriser les administrateurs de \[your company] à se connecter au compte administrateur de \[your app]**        | Rippling donne aux administrateurs complets l'accès au compte désigné comme compte administrateur partagé de l'application.    |
| **Ne pas autoriser les administrateurs de \[your company] à se connecter au compte administrateur de \[your app]** | Désactive l'accès administrateur partagé. Les administrateurs peuvent toujours utiliser le SSO avec leurs comptes individuels. |

Pour cette configuration, nous recommandons de sélectionner **Ne pas autoriser les administrateurs de \[your company] à se connecter au compte administrateur de \[your app]** afin que chaque personne se connecte avec son propre compte AirOps. Les administrateurs AirOps peuvent toujours utiliser le SSO et conserver leurs rôles d'espace de travail attribués.

Après avoir examiné le paramètre, cliquez sur **Continuer**. Gérez les rôles d'espace de travail des utilisateurs individuels dans AirOps.

<figure><img src="https://344527547-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 capture d'écran montre le choix recommandé pour cette configuration. Les noms de l'entreprise et de l'application correspondront à votre intégration.</p></figcaption></figure>

### 12. Examinez les attributs de groupe facultatifs

**Attributs de groupe** permettent à Rippling d'inclure des valeurs liées aux groupes dans la réponse de connexion SAML. Par exemple, un attribut `groupes` pourrait envoyer `Ingénierie` pour les employés de votre groupe Ingénierie.

Examinez les attributs de groupe déjà configurés pour votre application. Si la configuration SAML de votre organisation nécessite des informations de groupe supplémentaires, utilisez **Créer un nouveau** pour définir les valeurs et les personnes auxquelles elles s'appliquent. Vous pouvez également continuer sans ajouter d'attributs de groupe.

Pour AirOps, ces attributs sont facultatifs et n'attribuent pas de rôles d'espace de travail. Les nouveaux membres de l'espace de travail reçoivent le **Rôle par défaut** sélectionné à l'étape 8 ; les membres actifs existants conservent leurs rôles. Les attributions d'applications et l'éligibilité au SSO sont configurées séparément aux étapes 9 et 14. Les attributs d'e-mail et de nom des employés sont configurés à l'étape 16.

Après avoir examiné la configuration, cliquez sur **Continuer**.

<figure><img src="https://344527547-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>Cet exemple n'a aucun attribut de groupe configuré. Configurez des valeurs facultatives pour répondre à la configuration de votre organisation.</p></figcaption></figure>

### 13. Reportez le test de connexion initial

La **Vérifier l'intégration SSO** l'étape affiche **Tester la connexion de Rippling à \[your app]** et un **Se connecter via Rippling** bouton.

Les attributs des employés et les paramètres du tableau de bord doivent encore être examinés après l'installation. Cliquez **Continuer** pour l'instant et revenez à ce test à l'étape 19. Aller au-delà de cet écran ne confirme pas une connexion réussie.

<figure><img src="https://344527547-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>Cliquez sur Continuer pour poursuivre la configuration de l'application. Lancez le test de connexion à l'étape 19.</p></figcaption></figure>

{% hint style="info" %}
Le texte de test générique de Rippling mentionne la création et la désactivation d'utilisateurs. Cette configuration SAML crée de nouveaux comptes AirOps éligibles lors de la connexion. Elle ne configure pas SCIM ni ne supprime automatiquement l'appartenance à AirOps lorsqu'une attribution Rippling est supprimée.
{% endhint %}

### 14. Choisissez quels utilisateurs attribués peuvent se connecter avec le SSO

Dans **Éligibilité SSO**, la page demande **Quels utilisateurs attribués peuvent se connecter avec le SSO ?**:

1. Choisissez **Tous les utilisateurs attribués** si tous ceux attribués à l'étape 9 doivent utiliser le SSO. Pour tester le SSO avec un sous-ensemble plus restreint des utilisateurs attribués à l'application, choisissez **Seulement les utilisateurs attribués sélectionnés** et incluez votre employé test dans les règles qui apparaissent.
2. Examiner **Exclure des utilisateurs (facultatif)** et vérifiez que votre employé test n'est pas exclu. Utilisez **Aperçu des personnes** pour vérifier le résultat de toute règle.
3. Cliquez sur **Continuer**.

<figure><img src="https://344527547-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 employé doit avoir à la fois une attribution d'application et l'éligibilité au SSO. La capture d'écran montre Tous les utilisateurs attribués sélectionné.</p></figcaption></figure>

### 15. Terminez l'installation et ouvrez Configuration

Complétez les éventuelles invites restantes présentées par Rippling pour votre installation. Lorsque vous atteignez **installation de \[your app] terminée**, cliquez sur **Accéder à l'intégration**.

<figure><img src="https://344527547-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>Ouvrez l'application installée pour examiner ses attributs d'employé et ses paramètres avancés.</p></figcaption></figure>

Dans votre intégration AirOps :

1. Sélectionnez **Accès**.
2. Sélectionnez **Authentification unique (SSO)**.
3. Ouvrez **Configuration**.

Gardez cette page ouverte pour les attributs d'employé et les paramètres avancés ci-dessous.

### 16. Configurez les attributs des employés

Dans **Rippling**, ouvrez votre intégration AirOps et allez à **Accès → Authentification unique (SSO) → Configuration → Attributs SAML**.

Commencez par trouver les attributs pour l'e-mail professionnel, le prénom et le nom de famille facultatif dans la colonne **Nom** . Réutilisez les attributs existants et créez uniquement les correspondances manquantes.

Le tableau ci-dessous montre des noms d'exemple et des champs d'employé. Les noms de vos attributs peuvent différer ; chaque nom doit correspondre au champ correspondant dans AirOps.

| Champ AirOps de l'étape 8                   | Nom d'attribut Rippling d'exemple | Valeur d'employé Rippling d'exemple                                                                                 |
| ------------------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Attribut e-mail professionnel**           | `adresse e-mail`                  | **Adresse e-mail de l'utilisateur**, contenant l'e-mail professionnel de l'employé.                                 |
| **Attribut du prénom**                      | `firstName`                       | **Prénom préféré de l'utilisateur**.                                                                                |
| **Attribut du nom de famille (facultatif)** | `lastName`                        | **Nom de famille préféré de l'utilisateur**. Omettez ce mappage si le champ du nom de famille est vide dans AirOps. |

<figure><img src="https://344527547-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 utilise ici les prénoms et noms préférés. La colonne Nom doit correspondre aux noms d'attribut enregistrés dans AirOps.</p></figcaption></figure>

**Créer un attribut manquant**

Pour chaque ligne manquante :

1. Cliquez sur **Créer un nouveau** dans **Attributs SAML**.
2. Dans **Créer un attribut SAML**, sélectionnez **Attribut global**. Cela vous permet de mapper un champ employé pour chaque personne qui se connecte.
3. Dans **Nom de l'attribut global**, saisissez le nom que vous utiliserez aussi dans AirOps. Par exemple, saisissez `firstName` pour un nouveau mappage de prénom.
4. Ouvrez **Valeur** et sélectionnez le champ d'employé correspondant. Pour `firstName`, choisissez **Prénom préféré de l'utilisateur**. Sélectionnez le champ dans la liste déroulante afin que Rippling utilise la valeur pour l'employé qui se connecte.
5. Cliquez sur **Enregistrer**, puis vérifiez que la ligne apparaît sous **Attributs SAML**.
6. Répétez pour tout mappage manquant d'e-mail professionnel ou de nom de famille, en utilisant les noms d'attribut que vous avez choisis et les champs d'employé correspondants. Le tableau montre `adresse e-mail` et le `lastName` comme exemples. Ignorez tout mappage qui existe déjà.

<figure><img src="https://344527547-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>Exemple de création de firstName lorsqu'il est manquant. Utilisez le tableau ci-dessus pour emailAddress et lastName. La capture d'écran montre un formulaire non enregistré.</p></figcaption></figure>

**Vérifier ou corriger un attribut existant**

1. Ouvrez le menu de la ligne d'attribut et choisissez **Modifier**.
2. Contrôle **Valeur** par rapport au tableau et sélectionnez le champ d'employé correspondant si nécessaire.
3. Cliquez sur **Enregistrer** si vous avez modifié la valeur. Répétez l'opération pour les autres attributs existants.

<figure><img src="https://344527547-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>Modifiez une ligne existante au lieu d'en créer un doublon.</p></figcaption></figure>

**Faites correspondre les noms dans AirOps**

Les valeurs Rippling **Nom** doivent correspondre au **Attribut e-mail professionnel**, **Attribut du prénom**, et à l' **Attribut du nom de famille** que vous avez enregistrés à l'étape 8. Si vous avez utilisé d'autres noms, ouvrez **AirOps → Paramètres → Authentification unique → Rippling → Actions → Mettre à jour les identifiants**, saisissez ces noms exacts, puis cliquez sur **Enregistrer la connexion**. Rippling fixe les noms de ses attributs par défaut, alors utilisez les noms que votre application envoie réellement.

{% hint style="info" %}
Les noms sont sensibles à la casse. Par exemple, si votre attribut e-mail professionnel Rippling s'appelle `adresse e-mail`, saisissez `adresse e-mail` dans AirOps et sélectionnez **Adresse e-mail de l'utilisateur** comme sa valeur dynamique dans Rippling. AirOps nécessite l'attribut e-mail même lorsque NameID contient une adresse e-mail. Le **Attributs de groupe** écran facultatif de l'assistant d'intégration ne configure pas ces champs d'identité des employés.
{% endhint %}

### 17. Faites correspondre le format NameID et les paramètres de signature

Faites défiler jusqu'à **Paramètres avancés** et cliquez sur **Modifier**.

L'exemple de ce guide utilise **adresse e-mail** pour **Format NameID par défaut à utiliser**:

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

Choisissez le format qui correspond à votre connexion AirOps. Laissez **État de relais par défaut** vide.

<figure><img src="https://344527547-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>Utilisez le même format NameID dans Rippling et AirOps.</p></figcaption></figure>

Vérifiez les paramètres restants :

| Paramètre                                       | Valeur                     |
| ----------------------------------------------- | -------------------------- |
| **Algorithme de signature**                     | **RSA-SHA256** recommandé. |
| **Algorithme de condensat pour les assertions** | **SHA-256** recommandé.    |
| **Chiffrer les assertions**                     | **Non**.                   |

AirOps exige une assertion SAML signée. La signature de la réponse seule ne satisfait pas cette exigence.

Si vous mettez à jour une connexion existante, conservez sa valeur NameID stable et son format, et faites-les correspondre dans AirOps. Restez dans **Paramètres avancés** pour l'étape suivante.

### 18. Activer l'accès rapide au tableau de bord

Dans le même **Paramètres avancés** formulaire, définissez :

| Paramètre                                                                                                                        | Valeur                                             |
| -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| **Désactiver le champ « InResponseTo » dans les assertions pour le SSO lancé par l'IdP**                                         | **Oui**                                            |
| **L'application prend uniquement en charge une connexion initiée depuis l'application, également appelée flux initié par le SP** | **Non**                                            |
| **Désactiver la normalisation automatique des attributs**                                                                        | **Oui**, afin de conserver les noms des attributs. |

Cliquez sur **Enregistrer**, puis rouvrez **Paramètres avancés** et vérifiez les valeurs enregistrées.

<figure><img src="https://344527547-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>Confirmez les deux valeurs d'accès rapide après l'enregistrement : Oui pour Disable InResponseTo et Non pour SP-initiated-only.</p></figcaption></figure>

La `InResponseTo` s'applique aux lancements depuis le tableau de bord. Les réponses à une connexion initiée depuis AirOps doivent toujours correspondre à la demande d'origine. Rippling décrit les options disponibles dans sa [référence SSO SAML](https://developer.rippling.com/documentation/developer-portal/v2-guides/saml).

### 19. Tester la connexion terminée

Les deux côtés sont maintenant enregistrés. Gardez votre session d'administration AirOps ouverte et testez la connexion dans un autre profil de navigateur ou une fenêtre privée.

Si vous connectez un compte AirOps existant pour la première fois, suivez [Connecter un compte AirOps existant](#connect-an-existing-airops-account) avant de tester une connexion après déconnexion.

**Se connecter depuis AirOps**

1. Ouvrez le [page de connexion AirOps](https://app.airops.com/users/sign_in).
2. Cliquez sur **Se connecter avec Rippling** pour afficher le **slug de l’espace de travail** champ.
3. Saisissez le slug de votre espace de travail AirOps et cliquez sur **Continuer**.
4. AirOps vous redirige vers Rippling. Connectez-vous avec votre compte Rippling et répondez aux éventuelles invites d'authentification. Si vous avez déjà une session Rippling active, Rippling peut continuer sans vous demander de vous reconnecter.
5. Rippling vous renvoie vers AirOps. Confirmez que votre espace de travail s'ouvre et que vous pouvez y accéder avec le rôle attendu.

<figure><img src="https://344527547-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>Sélectionnez Se connecter avec Rippling, saisissez votre slug d'espace de travail et cliquez sur Continuer.</p></figcaption></figure>

**Se connecter depuis le tableau de bord Rippling**

1. Ouvrez Rippling et cliquez sur la tuile d'accès rapide AirOps.
2. Sur la page de continuation AirOps, cliquez sur **Continuer vers l'espace de travail**.
3. Terminez les éventuelles invites de connexion Rippling, puis confirmez que vous accédez à l'espace de travail AirOps prévu.

<figure><img src="https://344527547-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 page de continuation AirOps fait partie intégrante d'une connexion depuis le tableau de bord.</p></figcaption></figure>

**Revenir au test de connexion de Rippling**

Vous pouvez également revenir au **Se connecter via Rippling** test :

1. Sous **Configuration → Général**, cliquez sur **Reconfigurer**.
2. Ouvrez le sélecteur d'étapes en haut à gauche et sélectionnez **Vérifier l'intégration SSO**.
3. Vérifiez l'e-mail de l'employé affiché sur **Tester la connexion de Rippling** , puis cliquez sur **Se connecter via Rippling**.
4. Terminez la connexion. Si AirOps affiche **Continuer vers l'espace de travail**, cliquez dessus et confirmez que vous accédez à l'espace de travail prévu.

Si un test échoue, vérifiez la configuration avant de considérer l'installation comme terminée. Terminer l'assistant Rippling seul ne vérifie pas la connexion AirOps.

Vérifiez qu'un nouveau membre reçoit le rôle par défaut configuré et qu'un membre actif existant conserve son rôle.

## Référence de configuration AirOps

| Champ                                       | À saisir                                                                                                                                                               |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **URL ACS / ID d'entité SP**                | Généré par AirOps. Copiez les deux dans l'application SAML Rippling.                                                                                                   |
| **XML des métadonnées IdP**                 | Exportez depuis l'application Rippling correspondante. Importez ou collez un fichier jusqu'à 250 Ko, puis cliquez sur **Examiner les métadonnées**.                    |
| **Format NameID**                           | Faites correspondre le format de Rippling et utilisez un identifiant d'employé stable. Conservez l'identifiant et le format de manière cohérente après le déploiement. |
| **Attribut e-mail professionnel**           | Nom exact de l'attribut SAML, sensible à la casse, contenant l'adresse e-mail professionnelle de l'employé. Obligatoire.                                               |
| **Attribut du prénom**                      | Nom exact de l'attribut SAML contenant le prénom de l'employé. Obligatoire.                                                                                            |
| **Attribut du nom de famille (facultatif)** | Nom exact de l'attribut SAML contenant le nom de famille de l'employé. Laissez vide si ce champ n'est pas utilisé.                                                     |
| **Rôle par défaut**                         | Rôle pour les nouveaux membres de l'espace de travail. Les membres actifs existants conservent leur rôle actuel.                                                       |

Pour mettre à jour une connexion, ouvrez **Paramètres → Authentification unique → Rippling → Actions → Mettre à jour les identifiants**, apportez vos modifications et cliquez sur **Enregistrer la connexion**. Importez de nouvelles métadonnées lorsque Rippling renouvelle ses certificats de signature, avant l'expiration des certificats existants.

## Exemples de connexion

### Partager les instructions de connexion

Partagez le [page de connexion AirOps](https://app.airops.com/users/sign_in) et le slug de votre espace de travail avec les employés. Ils peuvent sélectionner **Se connecter avec Rippling**, saisir le slug, puis cliquer sur **Continuer**.

Les employés peuvent également utiliser la tuile AirOps SAML sur leur tableau de bord Rippling.

### Connecter un compte AirOps existant

Pour la première connexion Rippling sur un compte AirOps existant :

1. Connectez-vous à AirOps en utilisant la méthode de connexion actuelle du compte.
2. Dans **même profil de navigateur**, ouvrez la tuile AirOps SAML sur votre tableau de bord Rippling et cliquez sur **Continuer vers l'espace de travail**.
3. Terminez la connexion Rippling en utilisant l'adresse e-mail professionnelle correspondante.

Une fois le compte lié, testez une connexion après déconnexion. Si AirOps vous demande d'utiliser votre fournisseur de connexion d'origine, contactez votre équipe de compte AirOps pour organiser la transition.

### Comprendre le comportement d'appartenance

AirOps crée un nouveau compte et une appartenance à l'espace de travail lors de la première connexion réussie de l'employé, sous réserve des restrictions d'inscription de votre espace de travail. Cette connexion SSO ne synchronise pas l'appartenance des employés ni les rôles via SCIM. Gérez séparément l'appartenance AirOps existante lors de la suppression de l'accès.

## Dépannage

| Ce que vous voyez                                                  | Ce qu'il faut vérifier                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Rippling** est absent des paramètres AirOps ou de la connexion   | Demandez à votre équipe de compte AirOps d'activer Rippling pour l'espace de travail.                                                                                                                                                                                                                                                                                                                                          |
| **La connexion Rippling n'a pas pu être vérifiée**                 | Confirmez que l'URL ACS et l'ID d'entité SP correspondent au même espace de travail et au même environnement AirOps. Vérifiez à nouveau les métadonnées, la validité du certificat, le format NameID et le paramètre d'assertion signée. Pour les lancements depuis le tableau de bord, vérifiez également les deux options d'accès rapide à l'étape 18 et laissez le Default Relay State vide. Lancez une nouvelle tentative. |
| Un attribut e-mail ou prénom est manquant                          | Faites correspondre les noms exacts des attributs, y compris la casse. Sélectionnez les champs des employés comme valeurs dans Rippling et confirmez que l'employé assigné a bien ces valeurs renseignées.                                                                                                                                                                                                                     |
| La tuile d'accès rapide ouvre la page générale de connexion AirOps | Confirmez que la tuile lance l'application SAML plutôt qu'un favori vers la page de connexion. Rouvrez et vérifiez les paramètres d'accès rapide à l'étape 18.                                                                                                                                                                                                                                                                 |
| AirOps vous demande de vous connecter d'abord à un compte existant | Suivez **Connecter un compte AirOps existant** ci-dessus dans le même profil de navigateur.                                                                                                                                                                                                                                                                                                                                    |
| **Ajouter la connexion** est indisponible                          | Importez les métadonnées et cliquez sur **Examiner les métadonnées**. Vérifiez-le à nouveau si vous modifiez le XML.                                                                                                                                                                                                                                                                                                           |
| Le rôle d'un membre existant n'a pas changé                        | Le rôle par défaut s'applique aux nouveaux membres. Mettez à jour le rôle du membre existant dans AirOps.                                                                                                                                                                                                                                                                                                                      |

Si la connexion échoue toujours, partagez le slug de l'espace de travail, le point d'entrée, l'heure de la tentative et le message d'erreur affiché avec l'assistance AirOps. N'incluez pas de réponse SAML ni de jetons de session.


---

# 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/fr/votre-espace-de-travail/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.
