> 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を使うと、ワークスペースメンバーはMicrosoft Entra ID
（旧Azure AD）のエンタープライズアプリケーションを通じてElevenLabsにサインインできます。

> **Info**
>
> SSOはエンタープライズワークスペースで利用できます。SSO設定を構成できるのはワークスペース管理者のみです。

> **Warning**
>
> ElevenLabsはサービスプロバイダー（SP）起点のSAML SSOをサポートしています。サインインを開始するには、
> `https://elevenlabs.io/app/sign-in?use_sso=true`を使用します。メールアドレス欄を事前入力するには、クエリ
> パラメータとして`email=user@example.com`を追加できます。

> **Note**
>
> Microsoft EntraはSAML経由でのみサポートされています。Microsoft EntraでのOIDCは推奨されず、
> サインインの問題を引き起こす可能性があります。

## 前提条件

* エンタープライズのElevenLabsワークスペース。
* ElevenLabsでのワークスペース管理者アクセス権。
* Microsoft Entra管理センターでの管理者アクセス権。
* Microsoft Entra経由でサインインするユーザー向けにElevenLabsで確認済みのメールドメイン。

## Microsoft Entra SAML SSOを設定する

#### ElevenLabsでSSO設定を開く

**ワークスペース設定** > **セキュリティとSSO**に移動します。

#### メールドメインを確認する

**ユーザー自動プロビジョニング**で、Microsoft Entraユーザーがサインインに使用するメールドメインを確認します。
ドメイン（サブドメインも可）を入力し、表示される案内に従って所有権を確認します。必要に応じて自動プロビジョニングを有効にすると、
一致するメールドメインを持つユーザーが自動的にワークスペースに参加します。

![ElevenLabsの一括ドメイン確認ダイアログ](/docs/_fern-img/9b471a5441feffcb2f57e3e1ee85bafdccf687bfbe61e6cfb89234f38bc5821d.webp)

#### SSOプロバイダーとしてSAMLを選択する

**SSOプロバイダー**で**SAML**を選択します。**サービスプロバイダーエンティティID**と**リダイレクトURL**の
値をコピーします。これらの値はMicrosoft Entraで使用します。

#### Microsoft Entraエンタープライズアプリケーションを作成する

Microsoft Entra管理センターで、ディレクトリの**概要**を開き、**追加** >
**エンタープライズアプリケーション**をクリックします。

![エンタープライズアプリケーションが選択されたMicrosoft Entraの［概要］の［追加］メニュー](/docs/_fern-img/3d80c303777e59820fc3e9240368ffaf6fd5af53279f5ce574b21d57f4433cff.webp)

**Microsoft Entraアプリギャラリーを参照**で、**独自のアプリケーションの作成**をクリックします。

![［独自のアプリケーションの作成］が表示されたMicrosoft Entraアプリギャラリー](/docs/_fern-img/e78db7434ea9a3b210ef75544126423d1a55fb04aa6e08408dc0abaed1aa2fb2.webp)

#### アプリケーションに名前を付ける

名前（例：`ElevenLabs`）を入力し、\*\*ギャラリーにないその他のアプリケーションを統合する
（非ギャラリー）\*\*を選択してから、**作成**をクリックします。

![非ギャラリーアプリが選択されたMicrosoft Entraの［独自のアプリケーションの作成］パネル](/docs/_fern-img/4ab66649e94c88812f19c55412be1370aa3d8d7a9249f55576dfd62c3cb33558.webp)

#### シングルサインオンの設定を開始する

アプリケーションの**概要**で、**はじめに**の下にある**シングルサインオンの設定** >
**開始する**を選択します。

![［シングルサインオンの設定］が表示されたMicrosoft Entraエンタープライズアプリケーションの［はじめに］](/docs/_fern-img/1fcee15188b6ebc3c5773af4fd1ffb0dd9ff986821a57702b9b4ae876b8e26cf.webp)

シングルサインオン方式として**SAML**を選択します。

![SAMLが表示されたMicrosoft Entraの［シングルサインオン方式の選択］](/docs/_fern-img/e0a67bdc3f893e3d00fefc2531db05e2ae5db569821ab59479f629bf9619d6e9.webp)

#### 基本SAML設定を構成する

**基本SAML構成**で、ElevenLabsの値を使用してアプリを構成します。

* **識別子（エンティティID）**をElevenLabsの**サービスプロバイダーエンティティID**に設定します。
* **応答URL（アサーションコンシューマーサービスURL）**をElevenLabsの**リダイレクトURL**に設定します。
* **サインオンURL**は空白のままにします。ElevenLabsはSP起点のSSOを使用します。

**保存**をクリックします。

![識別子と応答URLが設定されたMicrosoft Entraの基本SAML構成](/docs/_fern-img/9961d266eb4ccb0bd4b6aa6f2d9a3322b059322fa7b933fe2741ca2c2ac2edb9.webp)

> **Note**
>
> [データレジデンシー](/docs/ja/overview/administration/data-residency)環境では、
> 応答URLとして`https://<region>.residency.elevenlabs.io/__/auth/handler`を使用し、
> `<region>`をリージョンコードに置き換えてください。

#### Name IDクレームを構成する

**属性とクレーム**で、\*\*一意のユーザー識別子（Name ID）\*\*クレームを編集します。

* **名前識別子の形式**を**メールアドレス**に設定します。
* **ソース**を**属性**に設定します。
* **ソース属性**を、すべてのユーザーのメールアドレスが含まれるフィールドに設定します。通常は
  `user.mail`ですが、`user.userprincipalname`の場合もあります。

**保存**をクリックします。

> **Note**
>
> すべてのユーザーのメールアドレスが格納されている属性を選択してください。`user.mail`がすべてのユーザーで
> 設定されていない場合は、代わりに`user.userprincipalname`を使用してください。

![メールアドレス形式とuser.mailソース属性が設定されたMicrosoft Entraのクレーム管理](/docs/_fern-img/1d94d0fecd19d9ca30ff5cce93294fda6a8c84ed98837ea89549f79b97ae153d.webp)

#### 署名証明書をダウンロードする

**SAML証明書**で、**証明書（Base64）**の横にある**ダウンロード**をクリックします。
ダウンロードしたファイルをテキストエディターで開きます。

![［証明書（Base64）］のダウンロードが表示されたMicrosoft EntraのSAML証明書](/docs/_fern-img/684fac9e520103b4c6978ef8dd3e95ea30d04a34e31b6ec7d13d97128492af07.webp)

#### ユーザーまたはグループを割り当てる

アプリの**ユーザーとグループ**を開き、ElevenLabsにサインインできるユーザーまたはグループを割り当てます。

![Microsoft Entraの［割り当ての追加］ユーザーリスト](/docs/_fern-img/c07ddb7a33eb511ada81ce437cdf468aecbfb83ef11a5c3a25f3fa6c87f5afcc.webp)

#### Entra証明書をElevenLabsに追加する

ElevenLabsで**証明書を追加**をクリックします。Base64ファイルからPEM証明書全体を貼り付けます。
`-----BEGIN CERTIFICATE-----`と`-----END CERTIFICATE-----`も含めてから、**追加**をクリックします。

![ElevenLabsのX509証明書の追加ダイアログ](/docs/_fern-img/bd8d3e047624b0c8f5b119d77e79ef4b721ef2917ad9049a2a44b36b6016201b.webp)

#### Entraアイデンティティプロバイダーの値をElevenLabsにコピーする

Microsoft Entraの**セットアップ**セクションで、アイデンティティプロバイダーの値をElevenLabsにコピーします。

* **アイデンティティプロバイダーエンティティID**には**Microsoft Entra識別子**を使用します。
* **アイデンティティプロバイダーサインインURL**には**ログインURL**を使用します。

![ログインURLとMicrosoft Entra識別子が表示されたMicrosoft Entraのセットアップ値](/docs/_fern-img/abddc7178305f0c220d6b9ad92d21320859824c024a84506933fd67a9045144e.webp)

#### 許可するメールドメインを追加する

ElevenLabsで**ドメインを追加**をクリックし、Microsoft Entraユーザーのメールドメインに一致する確認済みドメインを選択します。

![ElevenLabsの許可するメールドメインの追加ダイアログ](/docs/_fern-img/3039fce378edac35eaeab847e55a99ec82a241d7fc3bc46be24b23ec52e4a2bf.webp)

#### SSOプロバイダーを保存する

設定を確認し、**この変更により、現在SSOを使用しているユーザーがログアウトすることを承認します**を選択してから、**SSOを更新**をクリックします。

## フィールドのマッピング

以下の表を使用して、Microsoft EntraのSAML設定をElevenLabsのSSOフィールドにマッピングします。

| Microsoft Entraのフィールドまたは場所         | ElevenLabsのフィールド           | 使用する値                                                                      |
| ---------------------------------- | -------------------------- | -------------------------------------------------------------------------- |
| **サインイン方法**                        | **SSOプロバイダー**              | `SAML`                                                                     |
| **識別子（エンティティID）**                  | **サービスプロバイダーエンティティID**     | ElevenLabsの値を使用します。例：`https://elevenlabs.io`                               |
| **応答URL（アサーションコンシューマーサービスURL）**    | **リダイレクトURL**              | ElevenLabsの値を使用します。例：`https://elevenlabs.io/__/auth/handler`               |
| **Microsoft Entra識別子**             | **アイデンティティプロバイダーエンティティID** | Entra発行者。例：`https://sts.windows.net/{tenant-id}/`                          |
| **ログインURL**                        | **アイデンティティプロバイダーサインインURL** | Entra SAMLサインインURL。例：`https://login.microsoftonline.com/{tenant-id}/saml2` |
| **証明書（Base64）**                    | **証明書**                    | 有効なPEM形式のEntraトークン署名証明書                                                    |
| **Name ID形式**                      | 手動設定は不要                    | **メールアドレス**に設定                                                             |
| **Name IDソース属性**                   | 手動設定は不要                    | ユーザーのメールアドレスを含むフィールド。通常は`user.mail`（または`user.userprincipalname`）           |
| Microsoft Entraのユーザーまたはアプリのメールドメイン | **ドメイン**                   | 確認済みのElevenLabsドメインと一致する必要があります。例：`company.com`                            |

## トラブルシューティング

#### Microsoft Entraではサインイン成功と表示されるが、ElevenLabsでサインインできないと表示される

ブラウザーのネットワークレスポンスで`accounts:signInWithIdp`を確認してください。Microsoft Entraのサインインログでは、
Entraがユーザーを認証したことのみ確認できます。アサーション値がSSO設定と一致しない場合、ElevenLabsはSAMLレスポンスを
拒否することがあります。

#### INVALID_IDP_RESPONSE: 証明書の解析中にエラー

ブラウザーのネットワークレスポンスに`INVALID_IDP_RESPONSE: Error when parsing certificate`と表示される場合があります。
ElevenLabsから証明書を削除し、有効なPEM形式のEntra \*\*証明書（Base64）\*\*を再度追加してください。証明書の整形にLLMを
使用しないでください。Base64証明書をテキストエディターで開き、`-----BEGIN CERTIFICATE-----`と
`-----END CERTIFICATE-----`を含めて正確にコピーしてください。

#### saml.workspace...でログインできない、またはユーザー不一致エラーが発生する

Microsoft Entraがユーザーのメールアドレスを`NameID`として送信していることを確認してください。**属性と
クレーム**で、**一意のユーザー識別子（Name ID）**クレームの**名前識別子の形式**を**メール
アドレス**に設定し、**ソース属性**をすべてのユーザーのメールアドレスが含まれるフィールドに設定します
（通常は`user.mail`、`user.mail`が設定されていない場合は`user.userprincipalname`）。SAMLレスポンスの
`<saml:Subject>`フィールド内で、`<saml:NameID>`はユーザーのメールアドレスである必要があります。

#### どのMicrosoft Entra値を使用すればよいですか？

**アイデンティティプロバイダーエンティティID**には**Microsoft Entra識別子**を、
**アイデンティティプロバイダーサインインURL**には**ログインURL**を、**証明書**には
\*\*証明書（Base64）\*\*を使用します。