> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # SSO Microsoft Entra SAML Le SSO SAML Microsoft Entra permet aux membres du Workspace de se connecter à ElevenLabs via une application d’entreprise Microsoft Entra ID (anciennement Azure AD). > **Info** > > Le SSO est disponible pour les Workspaces Enterprise. Seuls les administrateurs du Workspace peuvent configurer les paramètres SSO. > **Warning** > > ElevenLabs prend en charge le SSO SAML initié par le fournisseur de services (SP). Pour démarrer la connexion, utilisez > `https://elevenlabs.io/app/sign-in?use_sso=true`. Vous pouvez ajouter `email=user@example.com` comme paramètre de requête > afin de préremplir le champ email. > **Note** > > Microsoft Entra est uniquement pris en charge via SAML. OIDC avec Microsoft Entra n’est pas recommandé et > peut entraîner des problèmes de connexion. ## Prérequis * Un Workspace ElevenLabs Enterprise. * Un accès administrateur au Workspace dans ElevenLabs. * Un accès administrateur au centre d’administration Microsoft Entra. * Un domaine email vérifié dans ElevenLabs pour les utilisateurs qui se connecteront via Microsoft Entra. ## Configurer le SSO SAML Microsoft Entra #### Ouvrir les paramètres SSO dans ElevenLabs Accédez à **Paramètres du Workspace** > **Sécurité et SSO**. #### Vérifier votre domaine email Sous **Provisionnement automatique des utilisateurs**, vérifiez le domaine email avec lequel vos utilisateurs Microsoft Entra se connecteront. Saisissez le domaine (les sous-domaines sont autorisés), puis suivez les instructions pour confirmer que vous en êtes propriétaire. Vous pouvez également activer le provisionnement automatique afin que les utilisateurs disposant d’un domaine email correspondant rejoignent automatiquement votre Workspace. ![Boîte de dialogue de vérification groupée de domaine ElevenLabs](/docs/_fern-img/9b471a5441feffcb2f57e3e1ee85bafdccf687bfbe61e6cfb89234f38bc5821d.webp) #### Sélectionner SAML comme fournisseur SSO Dans **Fournisseur SSO**, sélectionnez **SAML**. Copiez les valeurs **ID d’entité du fournisseur de services** et **URL de redirection**. Vous utiliserez ces valeurs dans Microsoft Entra. #### Créer une application d’entreprise Microsoft Entra Dans le centre d’administration Microsoft Entra, ouvrez la **Vue d’ensemble** de votre annuaire, puis cliquez sur **Ajouter** > **Application d’entreprise**. ![Menu Ajouter de la vue d’ensemble Microsoft Entra, avec Application d’entreprise sélectionné](/docs/_fern-img/3d80c303777e59820fc3e9240368ffaf6fd5af53279f5ce574b21d57f4433cff.webp) Dans **Parcourir la galerie d’applications Microsoft Entra**, cliquez sur **Créer votre propre application**. ![Galerie d’applications Microsoft Entra avec Créer votre propre application](/docs/_fern-img/e78db7434ea9a3b210ef75544126423d1a55fb04aa6e08408dc0abaed1aa2fb2.webp) #### Nommer l’application Saisissez un nom (par exemple, `ElevenLabs`), sélectionnez **Intégrer toute autre application que vous ne trouvez pas dans la galerie (hors galerie)**, puis cliquez sur \*\*Créer \*\*. ![Panneau Créer votre propre application de Microsoft Entra avec une application hors galerie](/docs/_fern-img/4ab66649e94c88812f19c55412be1370aa3d8d7a9249f55576dfd62c3cb33558.webp) #### Démarrer la configuration de l’authentification unique Dans la **Vue d’ensemble** de l’application, sous **Prise en main**, sélectionnez **Configurer l’authentification unique** > **Prise en main**. ![Section Prise en main de l’application d’entreprise Microsoft Entra avec Configurer l’authentification unique](/docs/_fern-img/1fcee15188b6ebc3c5773af4fd1ffb0dd9ff986821a57702b9b4ae876b8e26cf.webp) Sélectionnez **SAML** comme méthode d’authentification unique. ![Sélection d’une méthode d’authentification unique Microsoft Entra avec SAML](/docs/_fern-img/e0a67bdc3f893e3d00fefc2531db05e2ae5db569821ab59479f629bf9619d6e9.webp) #### Configurer les paramètres SAML de base Dans **Configuration SAML de base**, configurez l’application avec les valeurs d’ElevenLabs : * Définissez **Identificateur (ID d’entité)** sur l’**ID d’entité du fournisseur de services** d’ElevenLabs. * Définissez **URL de réponse (URL du service consommateur d’assertion)** sur l’**URL de redirection** d’ElevenLabs. * Laissez **URL de connexion** vide. ElevenLabs utilise le SSO initié par SP. Cliquez sur **Enregistrer**. ![Configuration SAML de base Microsoft Entra avec Identificateur et URL de réponse](/docs/_fern-img/9961d266eb4ccb0bd4b6aa6f2d9a3322b059322fa7b933fe2741ca2c2ac2edb9.webp) > **Note** > > Pour les environnements de [résidence des données](/docs/fr/overview/administration/data-residency), utilisez > `https://.residency.elevenlabs.io/__/auth/handler` comme URL de réponse, en remplaçant > `` par le code de votre région. #### Configurer la revendication Name ID Dans **Attributs et revendications**, modifiez la revendication **Identificateur utilisateur unique (Name ID)** : * Définissez **Format de l’identificateur de nom** sur **Adresse email**. * Définissez **Source** sur **Attribut**. * Définissez **Attribut source** sur le champ contenant l’adresse email de tous les utilisateurs. Il s’agit généralement de `user.mail`, mais il peut s’agir de `user.userprincipalname`. Cliquez sur **Enregistrer**. > **Note** > > Choisissez l’attribut contenant une adresse email pour chaque utilisateur. Si `user.mail` n’est pas renseigné > pour tous vos utilisateurs, utilisez plutôt `user.userprincipalname`. ![Gestion des revendications Microsoft Entra avec le format Adresse email et l’attribut source user.mail](/docs/_fern-img/1d94d0fecd19d9ca30ff5cce93294fda6a8c84ed98837ea89549f79b97ae153d.webp) #### Télécharger le certificat de signature Dans **Certificats SAML**, à côté de **Certificat (Base64)**, cliquez sur **Télécharger**. Ouvrez le fichier téléchargé dans un éditeur de texte. ![Certificats SAML Microsoft Entra avec téléchargement du certificat Base64](/docs/_fern-img/684fac9e520103b4c6978ef8dd3e95ea30d04a34e31b6ec7d13d97128492af07.webp) #### Attribuer des utilisateurs ou des groupes Ouvrez **Utilisateurs et groupes** de l’application, puis attribuez les utilisateurs ou groupes qui doivent pouvoir se connecter à ElevenLabs. ![Liste des utilisateurs Ajouter une attribution de Microsoft Entra](/docs/_fern-img/c07ddb7a33eb511ada81ce437cdf468aecbfb83ef11a5c3a25f3fa6c87f5afcc.webp) #### Ajouter le certificat Entra à ElevenLabs Dans ElevenLabs, cliquez sur **Ajouter un certificat**. Collez le certificat PEM complet du fichier Base64, y compris `-----BEGIN CERTIFICATE-----` et `-----END CERTIFICATE-----`, puis cliquez sur **Ajouter**. ![Boîte de dialogue Ajouter un certificat X509 d’ElevenLabs](/docs/_fern-img/bd8d3e047624b0c8f5b119d77e79ef4b721ef2917ad9049a2a44b36b6016201b.webp) #### Copier les valeurs du fournisseur d’identité Entra dans ElevenLabs Dans la section **Configurer** de Microsoft Entra, copiez les valeurs du fournisseur d’identité dans ElevenLabs : * Utilisez l’**Identificateur Microsoft Entra** pour l’**ID d’entité du fournisseur d’identité**. * Utilisez l’**URL de connexion** pour l’**URL de connexion du fournisseur d’identité**. ![Valeurs de configuration Microsoft Entra affichant l’URL de connexion et l’identificateur Microsoft Entra](/docs/_fern-img/abddc7178305f0c220d6b9ad92d21320859824c024a84506933fd67a9045144e.webp) #### Ajouter votre domaine email autorisé Dans ElevenLabs, cliquez sur **Ajouter un domaine** et sélectionnez le domaine vérifié qui correspond au domaine email de vos utilisateurs Microsoft Entra. ![Boîte de dialogue Ajouter des domaines email autorisés d’ElevenLabs](/docs/_fern-img/3039fce378edac35eaeab847e55a99ec82a241d7fc3bc46be24b23ec52e4a2bf.webp) #### Enregistrer le fournisseur SSO Vérifiez la configuration, sélectionnez \*\*Je reconnais que cette modification déconnectera les utilisateurs qui utilisent actuellement le SSO \*\*, puis cliquez sur \*\*Mettre à jour le SSO \*\*. ## Correspondance des champs Utilisez ce tableau pour faire correspondre les paramètres SAML Microsoft Entra aux champs SSO d’ElevenLabs. | Champ ou emplacement Microsoft Entra | Champ ElevenLabs | Valeur à utiliser | | ----------------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------ | | **Méthode de connexion** | **Fournisseur SSO** | `SAML` | | **Identificateur (ID d’entité)** | **ID d’entité du fournisseur de services** | Utilisez la valeur ElevenLabs, par exemple `https://elevenlabs.io` | | **URL de réponse (URL du service consommateur d’assertion)** | **URL de redirection** | Utilisez la valeur ElevenLabs, par exemple `https://elevenlabs.io/__/auth/handler` | | **Identificateur Microsoft Entra** | **ID d’entité du fournisseur d’identité** | Émetteur Entra, par exemple `https://sts.windows.net/{tenant-id}/` | | **URL de connexion** | **URL de connexion du fournisseur d’identité** | URL de connexion SAML Entra, par exemple `https://login.microsoftonline.com/{tenant-id}/saml2` | | **Certificat (Base64)** | **Certificat** | Certificat de signature de jeton Entra au format PEM valide | | **Format Name ID** | Aucune configuration manuelle requise | Définissez sur **Adresse email** | | **Attribut source Name ID** | Aucune configuration manuelle requise | Champ contenant l’email de l’utilisateur, généralement `user.mail` (ou `user.userprincipalname`) | | Domaine email de l’utilisateur ou de l’application dans Microsoft Entra | **Domaine** | Doit correspondre à un domaine ElevenLabs vérifié, par exemple `company.com` | ## Résolution des problèmes #### Microsoft Entra affiche une connexion réussie, mais ElevenLabs indique qu’il est impossible de se connecter Vérifiez la réponse Network du navigateur pour `accounts:signInWithIdp`. Les journaux de connexion Microsoft Entra confirment uniquement qu’Entra a authentifié l’utilisateur. ElevenLabs peut toujours rejeter la réponse SAML si les valeurs d’assertion ne correspondent pas à la configuration SSO. #### INVALID_IDP_RESPONSE: erreur lors de l’analyse du certificat La réponse Network du navigateur peut afficher `INVALID_IDP_RESPONSE: Error when parsing certificate`. Supprimez le certificat d’ElevenLabs, puis ajoutez de nouveau le **Certificat (Base64)** Entra dans un format PEM valide. N’utilisez pas de LLM pour formater le certificat. Ouvrez le certificat Base64 dans un éditeur de texte et copiez-le exactement, y compris `-----BEGIN CERTIFICATE-----` et `-----END CERTIFICATE-----`. #### Impossible de se connecter avec saml.workspace... ou erreurs de non-correspondance d’utilisateur Assurez-vous que Microsoft Entra envoie l’adresse email de l’utilisateur comme `NameID`. Dans **Attributs et revendications **, définissez le **Format de l’identificateur de nom** de la revendication **Identificateur utilisateur unique (Name ID)** sur **Adresse email** et l’** Attribut source** sur le champ contenant l’adresse email de tous les utilisateurs (généralement `user.mail`, ou `user.userprincipalname` si `user.mail` n’est pas renseigné). Dans le champ `` de la réponse SAML, `` doit correspondre à l’adresse email de l’utilisateur. #### Quelles valeurs Microsoft Entra utiliser ? Utilisez l’**Identificateur Microsoft Entra** pour l’**ID d’entité du fournisseur d’identité**, l’**URL de connexion** pour l’**URL de connexion du fournisseur d’identité**, et le **Certificat (Base64)** pour le **Certificat**.