> 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. # Okta SAML SSO Okta SAML SSOを使用すると、ワークスペースメンバーはOkta SAML 2.0アプリ統合を通じてElevenLabsにサインインできます。 > **Info** > > SSOはエンタープライズワークスペースで利用できます。SSO設定を構成できるのはワークスペース管理者のみです。 > **Warning** > > ElevenLabsは、サービスプロバイダー（SP）起点のSAML SSOに対応しています。サインインを開始するには、 > `https://elevenlabs.io/app/sign-in?use_sso=true`を使用します。メールアドレス欄を事前入力するには、クエリ > パラメーターとして`email=user@example.com`を追加できます。 ## 前提条件 * エンタープライズのElevenLabsワークスペース。 * ElevenLabsでのワークスペース管理者アクセス。 * Oktaでの管理者アクセス。 * Okta経由でサインインするユーザー向けに、ElevenLabsで検証済みのメールドメイン。 ## Okta SAML SSOを設定する #### ElevenLabsでSSO設定を開く **ワークスペース設定** > **セキュリティ＆SSO**に移動します。 ![ElevenLabsのワークスペース設定にある［セキュリティ＆SSO］タブ](/docs/_fern-img/3bc083c160206a93cce639948b66d9aefdacfc7ed238d60548d1bde2ae365479.webp) #### SSOプロバイダーとしてSAMLを選択する **SSOプロバイダー**で**SAML**を選択します。**サービスプロバイダーエンティティID**と**リダイレクト URL**の値をコピーします。これらの値はOktaで使用します。 ![ElevenLabsのSAMLプロバイダー設定](/docs/_fern-img/299948b19e628c531333c21ced70086b975d926f834b0f8a55e13edbd5898303.webp) #### Oktaアプリ統合を作成する Okta管理コンソールで、**Applications** > **Applications**に移動し、**Create App Integration**をクリックします。 ![［Create App Integration］が表示されたOktaのApplicationsページ](/docs/_fern-img/ed1e7575d777d053d3749efc7f0a31ebfdf19a5f37de5f266ea147b26e4a2487.webp) **SAML 2.0**を選択し、**Next**をクリックします。 ![［SAML 2.0］が選択されたOktaの新しいアプリ統合作成ダイアログ](/docs/_fern-img/89e194f26b79f20c6e34af660802266901dd96464987be2f38ea41c7d338704b.webp) #### アプリ名を追加する **General Settings**で、**App name**を`ElevenLabs`に設定し、**Next**をクリックします。 ![OktaのCreate SAML Integrationにある一般設定](/docs/_fern-img/56ed422543674b8b81608e27e585faf71fdca05d28ceb1493aef5d5d3c256722.webp) #### OktaでSAML設定を構成する **SAML Settings**で、ElevenLabsの値を使用してアプリを設定します。 * **Single sign-on URL**をElevenLabsの**リダイレクトURL**に設定します。 * **Use this for Recipient URL and Destination URL**を選択します。 * **Audience URI (SP Entity ID)**をElevenLabsの**サービスプロバイダーエンティティID**に設定します。 * **Name ID format**を**EmailAddress**に設定します。 * **Application username**を**Email**に設定します。 ![ElevenLabs用のOkta SAML設定](/docs/_fern-img/45c4621749048612f9dcaa96123b07b60e661f3a84c03c654a0e229dce385ad6.webp) #### ユーザーまたはグループを割り当てる Oktaアプリの**Assignments**タブを開き、ElevenLabsにサインインできるユーザーまたはグループを 割り当てます。 ![OktaアプリのAssignmentsタブ](/docs/_fern-img/3cf08aff22d992d143bfb1c655f3a807c5b2b6b5cafba4ee2aff6e18bd997676.webp) #### Okta証明書をElevenLabsに追加する Oktaで**SAML Signing Certificates**を開き、有効な証明書の**Actions** > **Download certificate**を 使用します。 ![OktaのSAML Signing Certificatesにある証明書ダウンロード操作](/docs/_fern-img/334a3a8fb4355a170254e0dd132b141fd9f6a86dd58374d054ae1a708a8778f9.webp) 証明書ファイルを開き、`-----BEGIN CERTIFICATE-----`と`-----END CERTIFICATE-----`を含む PEM証明書全体をコピーします。 ![PEM形式のOkta証明書ファイル](/docs/_fern-img/d62e28cf4ff1d3240d190cc9405345e193177e533b185acd64b19ab7f77596c5.webp) ElevenLabsで**Add Certificate**をクリックし、Okta証明書を貼り付けてから**Add**をクリックします。 ![ElevenLabsのAdd X509 Certificateダイアログ](/docs/_fern-img/910152284bd98c1ebdae064a7424d7d1ac185fe716abdda751607bad9b4cc147.webp) #### Oktaメタデータ値をElevenLabsにコピーする OktaでIdPメタデータXMLを開きます。メタデータ値をElevenLabsにコピーします。 * **アイデンティティプロバイダーエンティティID**には`entityID`を使用します。 * **アイデンティティプロバイダーサインインURL**には、`/sso/saml`で終わる`SingleSignOnService Location` URLを使用します。 ![entityIDとSingleSignOnService Locationを示すOkta IdPメタデータXML](/docs/_fern-img/96f8ad35da0fbeafc265310e0ca761c69163cb53c76baf8d35c97e9a992d4ee8.webp) #### 許可するメールドメインを追加する ElevenLabsで**Add Domain**をクリックし、Oktaユーザーのメールドメインと一致する検証済みドメインを 選択します。 ![ElevenLabsの許可するメールドメイン追加ダイアログ](/docs/_fern-img/bd532d18051c43e9db7c3b33e54b5910a2050ec16e04e85c9b7541fda20f7b6f.webp) #### SSOプロバイダーを保存する 設定を確認し、**I acknowledge this change will log out users currently using SSO**を選択してから、**Update SSO**をクリックします。 ## フィールドマッピング この表を使用して、Okta SAML設定をElevenLabsのSSOフィールドにマッピングします。 | Oktaのフィールドまたは場所 | ElevenLabsのフィールド | 使用する値 | | ------------------------------------------------------ | -------------------------- | ------------------------------------------------------------- | | **Sign-in method** | **SSOプロバイダー** | `SAML` | | **Audience URI (SP Entity ID)** | **サービスプロバイダーエンティティID** | ElevenLabsの値を使用します（例：`https://elevenlabs.io`） | | **Single sign-on URL** | **リダイレクトURL** | ElevenLabsの値を使用します（例：`https://elevenlabs.io/__/auth/handler`） | | **Recipient URL** | **リダイレクトURL** | **Single sign-on URL**と同じ | | **Destination URL** | **リダイレクトURL** | **Single sign-on URL**と同じ | | **SAML Issuer ID**またはメタデータの`entityID` | **アイデンティティプロバイダーエンティティID** | Okta発行者（例：`http://www.okta.com/exk...`） | | **Sign On URL**またはメタデータの`SingleSignOnService Location` | **アイデンティティプロバイダーサインインURL** | `/sso/saml`で終わるOkta SAML URL | | **X.509 Certificate**またはメタデータの`ds:X509Certificate` | **証明書** | 有効なPEM形式のOkta署名証明書 | | **Application username** | 手動設定は不要 | **Email**に設定 | | **Name ID format** | 手動設定は不要 | **EmailAddress**に設定 | | Oktaのユーザーまたはアプリのメールドメイン | **ドメイン** | 検証済みのElevenLabsドメインと一致する必要があります（例：`company.com`） | ## トラブルシューティング #### Oktaではサインイン成功と表示されるが、ElevenLabsではサインインできないと表示される ブラウザのNetworkレスポンスで`accounts:signInWithIdp`を確認してください。`User single sign on to app SUCCESS`などの Oktaシステムログエントリは、Oktaがユーザーを認証したことのみを示します。アサーション値がSSO設定と一致しない場合、ElevenLabsは SAMLレスポンスを拒否することがあります。 #### INVALID_IDP_RESPONSE: Error when parsing certificate ブラウザのNetworkレスポンスに`INVALID_IDP_RESPONSE: Error when parsing certificate`と表示される場合があります。 ElevenLabsから証明書を削除し、有効なPEM形式のOkta X.509証明書を再度追加してください。証明書の整形にLLMを使用しないでください。 `-----BEGIN CERTIFICATE-----`と`-----END CERTIFICATE-----`を含め、証明書を正確にコピーしてください。 #### ユーザーまたは認証の不一致エラー Oktaがユーザーのメールアドレスを`NameID`として送信していることを確認してください。Oktaで**Name ID format**を **EmailAddress**に、**Application username**を**Email**に設定します。 #### どのOktaメタデータ値を使用すればよいですか？ **アイデンティティプロバイダーエンティティID**にはメタデータの`entityID`、**アイデンティティプロバイダーサインインURL**には`SingleSignOnService Location`、 **証明書**には`ds:X509Certificate`を使用します。