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

# Microsoft Entra SAML SSO

Microsoft Entra SAML SSO से workspace के सदस्य Microsoft Entra ID
(पहले Azure AD) एंटरप्राइज़ एप्लिकेशन के ज़रिए ElevenLabs में साइन इन कर सकते हैं।

> **Info**
>
> SSO Enterprise workspace के लिए उपलब्ध है। केवल Workspace admin ही SSO सेटिंग्स कॉन्फ़िगर कर सकते हैं।

> **Warning**
>
> ElevenLabs, Service Provider (SP) से शुरू किया गया SAML SSO सपोर्ट करता है। साइन-इन शुरू करने के लिए,
> `https://elevenlabs.io/app/sign-in?use_sso=true` इस्तेमाल करें। ईमेल फ़ील्ड पहले से भरने के लिए आप query
> parameter के रूप में `email=user@example.com` जोड़ सकते हैं।

> **Note**
>
> Microsoft Entra केवल SAML के ज़रिए सपोर्ट किया जाता है। Microsoft Entra के साथ OIDC की सलाह नहीं दी जाती और
> इससे साइन-इन में समस्याएं हो सकती हैं।

## आवश्यक शर्तें

* एक Enterprise ElevenLabs workspace।
* ElevenLabs में Workspace admin एक्सेस।
* Microsoft Entra admin center में admin एक्सेस।
* Microsoft Entra से साइन इन करने वाले यूज़र्स के लिए ElevenLabs में सत्यापित ईमेल डोमेन।

## Microsoft Entra SAML SSO सेट अप करें

#### ElevenLabs में SSO सेटिंग्स खोलें

**Workspace settings** > **Security & SSO** पर जाएं।

#### अपना ईमेल डोमेन सत्यापित करें

**User Auto Provisioning** में, उस ईमेल डोमेन को सत्यापित करें जिससे आपके Microsoft Entra यूज़र्स साइन इन
करेंगे। डोमेन दर्ज करें (सबडोमेन की अनुमति है), फिर स्वामित्व की पुष्टि करने के लिए निर्देशों का पालन करें।
वैकल्पिक रूप से, auto-provisioning चालू करें ताकि मिलते-जुलते ईमेल डोमेन वाले यूज़र्स अपने आप आपके
workspace में शामिल हो जाएं।

![ElevenLabs बल्क डोमेन सत्यापन डायलॉग](/docs/_fern-img/9b471a5441feffcb2f57e3e1ee85bafdccf687bfbe61e6cfb89234f38bc5821d.webp)

#### SSO provider के रूप में SAML चुनें

**SSO Provider** में, **SAML** चुनें। **Service Provider Entity Id** और **Redirect URL**
वैल्यू कॉपी करें। आप इन वैल्यू का इस्तेमाल Microsoft Entra में करेंगे।

#### Microsoft Entra एंटरप्राइज़ एप्लिकेशन बनाएं

Microsoft Entra admin center में, अपनी directory का **Overview** खोलें, फिर **Add** >
**Enterprise application** पर क्लिक करें।

![Enterprise application चुने हुए Microsoft Entra Overview का Add मेनू](/docs/_fern-img/3d80c303777e59820fc3e9240368ffaf6fd5af53279f5ce574b21d57f4433cff.webp)

**Browse Microsoft Entra App Gallery** में, **Create your own application** पर क्लिक करें।

![Create your own application के साथ Microsoft Entra App Gallery](/docs/_fern-img/e78db7434ea9a3b210ef75544126423d1a55fb04aa6e08408dc0abaed1aa2fb2.webp)

#### एप्लिकेशन को नाम दें

नाम दर्ज करें (उदाहरण के लिए, `ElevenLabs`), **Integrate any other application you don't find
in the gallery (Non-gallery)** चुनें, फिर **Create** पर क्लिक करें।

![नॉन-गैलरी ऐप के साथ Microsoft Entra Create your own application पैनल](/docs/_fern-img/4ab66649e94c88812f19c55412be1370aa3d8d7a9249f55576dfd62c3cb33558.webp)

#### single sign-on सेटअप शुरू करें

एप्लिकेशन के **Overview** में, **Getting Started** के तहत, **Set up single sign on** >
**Get started** चुनें।

![Set up single sign on के साथ Microsoft Entra एंटरप्राइज़ एप्लिकेशन का Getting Started](/docs/_fern-img/1fcee15188b6ebc3c5773af4fd1ffb0dd9ff986821a57702b9b4ae876b8e26cf.webp)

single sign-on तरीके के रूप में **SAML** चुनें।

![SAML के साथ Microsoft Entra Select a single sign-on method](/docs/_fern-img/e0a67bdc3f893e3d00fefc2531db05e2ae5db569821ab59479f629bf9619d6e9.webp)

#### बुनियादी SAML सेटिंग्स कॉन्फ़िगर करें

**Basic SAML Configuration** में, ElevenLabs की वैल्यू के साथ ऐप कॉन्फ़िगर करें:

* **Identifier (Entity ID)** को ElevenLabs के **Service Provider Entity Id** पर सेट करें।
* **Reply URL (Assertion Consumer Service URL)** को ElevenLabs के **Redirect URL** पर सेट करें।
* **Sign on URL** खाली छोड़ दें। ElevenLabs SP-initiated SSO का इस्तेमाल करता है।

**Save** पर क्लिक करें।

![Identifier और Reply URL के साथ Microsoft Entra Basic SAML Configuration](/docs/_fern-img/9961d266eb4ccb0bd4b6aa6f2d9a3322b059322fa7b933fe2741ca2c2ac2edb9.webp)

> **Note**
>
> [डेटा रेज़िडेंसी](/docs/hi/overview/administration/data-residency) environments के लिए,
> `https://<region>.residency.elevenlabs.io/__/auth/handler` को Reply URL के रूप में इस्तेमाल करें और
> `<region>` को अपने region code से बदलें।

#### Name ID claim कॉन्फ़िगर करें

**Attributes & Claims** में, **Unique User Identifier (Name ID)** claim को एडिट करें:

* **Name identifier format** को **Email address** पर सेट करें।
* **Source** को **Attribute** पर सेट करें।
* **Source attribute** को उस फ़ील्ड पर सेट करें जिसमें सभी यूज़र्स का ईमेल पता हो। आम तौर पर यह
  `user.mail` होता है, लेकिन `user.userprincipalname` भी हो सकता है।

**Save** पर क्लिक करें।

> **Note**
>
> वह attribute चुनें जिसमें हर यूज़र का ईमेल पता हो। अगर आपके सभी यूज़र्स के लिए `user.mail` भरा हुआ नहीं है,
> तो उसकी जगह `user.userprincipalname` इस्तेमाल करें।

![Email address फ़ॉर्मैट और user.mail source attribute के साथ Microsoft Entra Manage claim](/docs/_fern-img/1d94d0fecd19d9ca30ff5cce93294fda6a8c84ed98837ea89549f79b97ae153d.webp)

#### signing certificate डाउनलोड करें

**SAML Certificates** में, **Certificate (Base64)** के आगे **Download** पर क्लिक करें। डाउनलोड की गई
फ़ाइल को text editor में खोलें।

![Certificate Base64 डाउनलोड के साथ Microsoft Entra SAML Certificates](/docs/_fern-img/684fac9e520103b4c6978ef8dd3e95ea30d04a34e31b6ec7d13d97128492af07.webp)

#### यूज़र्स या ग्रुप असाइन करें

ऐप का **Users and groups** खोलें, फिर उन यूज़र्स या ग्रुप को असाइन करें जिन्हें ElevenLabs में साइन
इन करने की अनुमति होनी चाहिए।

![यूज़र्स सूची के साथ Microsoft Entra Add Assignment](/docs/_fern-img/c07ddb7a33eb511ada81ce437cdf468aecbfb83ef11a5c3a25f3fa6c87f5afcc.webp)

#### Entra certificate को ElevenLabs में जोड़ें

ElevenLabs में, **Add Certificate** पर क्लिक करें। Base64 फ़ाइल से पूरा PEM certificate पेस्ट करें,
जिसमें `-----BEGIN CERTIFICATE-----` और `-----END CERTIFICATE-----` शामिल हों, फिर **Add** पर क्लिक करें।

![ElevenLabs Add X509 Certificate डायलॉग](/docs/_fern-img/bd8d3e047624b0c8f5b119d77e79ef4b721ef2917ad9049a2a44b36b6016201b.webp)

#### Entra identity provider वैल्यू को ElevenLabs में कॉपी करें

Microsoft Entra के **Set up** सेक्शन में, identity provider वैल्यू को ElevenLabs में कॉपी करें:

* **Identity Provider Entity Id** के लिए **Microsoft Entra Identifier** इस्तेमाल करें।
* **Identity Provider Sign-In URL** के लिए **Login URL** इस्तेमाल करें।

![Login URL और Microsoft Entra Identifier दिखाती Microsoft Entra set up वैल्यू](/docs/_fern-img/abddc7178305f0c220d6b9ad92d21320859824c024a84506933fd67a9045144e.webp)

#### अपना अनुमति प्राप्त ईमेल डोमेन जोड़ें

ElevenLabs में, **Add Domain** पर क्लिक करें और ऐसा सत्यापित डोमेन चुनें जो आपके Microsoft Entra यूज़र्स के
ईमेल डोमेन से मेल खाता हो।

![ElevenLabs Add allowed email domains डायलॉग](/docs/_fern-img/3039fce378edac35eaeab847e55a99ec82a241d7fc3bc46be24b23ec52e4a2bf.webp)

#### SSO provider सेव करें

कॉन्फ़िगरेशन की समीक्षा करें, **I acknowledge this change will log out users currently using
SSO** चुनें, फिर **Update SSO** पर क्लिक करें।

## फ़ील्ड मैपिंग

Microsoft Entra SAML सेटिंग्स को ElevenLabs SSO फ़ील्ड से मैप करने के लिए इस टेबल का इस्तेमाल करें।

| Microsoft Entra फ़ील्ड या स्थान                | ElevenLabs फ़ील्ड                    | इस्तेमाल करने की वैल्यू                                                                     |
| ---------------------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------- |
| **Sign-in method**                             | **SSO Provider**                     | `SAML`                                                                                      |
| **Identifier (Entity ID)**                     | **Service Provider Entity Id**       | ElevenLabs की वैल्यू इस्तेमाल करें, उदाहरण के लिए `https://elevenlabs.io`                   |
| **Reply URL (Assertion Consumer Service URL)** | **Redirect URL**                     | ElevenLabs की वैल्यू इस्तेमाल करें, उदाहरण के लिए `https://elevenlabs.io/__/auth/handler`   |
| **Microsoft Entra Identifier**                 | **Identity Provider Entity Id**      | Entra issuer, उदाहरण के लिए `https://sts.windows.net/{tenant-id}/`                          |
| **Login URL**                                  | **Identity Provider Sign-In URL**    | Entra SAML साइन-इन URL, उदाहरण के लिए `https://login.microsoftonline.com/{tenant-id}/saml2` |
| **Certificate (Base64)**                       | **Certificate**                      | वैध PEM फ़ॉर्मैट में Entra token signing certificate                                        |
| **Name ID format**                             | मैन्युअल कॉन्फ़िगरेशन की ज़रूरत नहीं | **Email address** पर सेट करें                                                               |
| **Name ID source attribute**                   | मैन्युअल कॉन्फ़िगरेशन की ज़रूरत नहीं | यूज़र का ईमेल रखने वाला फ़ील्ड, आम तौर पर `user.mail` (या `user.userprincipalname`)         |
| Microsoft Entra में यूज़र या ऐप का ईमेल डोमेन  | **Domain**                           | सत्यापित ElevenLabs डोमेन से मेल खाना चाहिए, उदाहरण के लिए `company.com`                    |

## समस्या निवारण

#### Microsoft Entra सफल साइन-इन दिखाता है, लेकिन ElevenLabs साइन इन नहीं हो पा रहा बताता है

`accounts:signInWithIdp` के लिए browser Network response जांचें। Microsoft Entra साइन-इन logs केवल
यह पुष्टि करते हैं कि Entra ने यूज़र को authenticated किया है। अगर assertion वैल्यू SSO कॉन्फ़िगरेशन से मेल नहीं
खाती हैं, तो ElevenLabs फिर भी SAML response को अस्वीकार कर सकता है।

#### INVALID_IDP_RESPONSE: certificate पार्स करते समय त्रुटि

browser Network response में `INVALID_IDP_RESPONSE: Error when parsing certificate` दिख सकता है।
ElevenLabs से certificate हटाएं, फिर Entra **Certificate (Base64)** को वैध PEM फ़ॉर्मैट में दोबारा
जोड़ें। certificate को फ़ॉर्मैट करने के लिए LLM का इस्तेमाल न करें। Base64 certificate को text
editor में खोलें और `-----BEGIN CERTIFICATE-----` और
`-----END CERTIFICATE-----` सहित उसे बिल्कुल उसी तरह कॉपी करें।

#### saml.workspace... से लॉगिन नहीं हो पा रहा या user mismatch त्रुटियां

सुनिश्चित करें कि Microsoft Entra यूज़र का ईमेल पता `NameID` के रूप में भेजता है। **Attributes &
Claims** में, **Unique User Identifier (Name ID)** claim का **Name identifier format** **Email
address** पर और **Source attribute** उस फ़ील्ड पर सेट करें जिसमें सभी यूज़र्स का ईमेल पता हो
(आम तौर पर `user.mail`, या अगर `user.mail` भरा हुआ नहीं है तो `user.userprincipalname`)। SAML response के
`<saml:Subject>` फ़ील्ड के अंदर, `<saml:NameID>` यूज़र का ईमेल पता होना चाहिए।

#### मुझे कौन-सी Microsoft Entra वैल्यू इस्तेमाल करनी चाहिए?

**Identity Provider Entity Id** के लिए **Microsoft Entra Identifier**, **Identity Provider Sign-In URL** के लिए
**Login URL**, और **Certificate** के लिए **Certificate (Base64)** इस्तेमाल करें।