シングルサインオン（SSO）

チームの管理ダッシュボードへのログイン方法をカスタマイズする

SSO 機能は Enterprise プランで利用できます。

SAML と OIDC を使ってダッシュボードにシングルサインオンできます。Okta、Google Workspace、Microsoft Entra をご利用の場合は、SSO 設定のためのプロバイダー別ドキュメントをご用意しています。その他のプロバイダーをご利用の場合は、お問い合わせください。

Okta

SAML

1. アプリケーションを作成する

   Applications で、SAML 2.0 を使用した新しいアプリ統合の作成をクリックします。

2. 統合を設定する

   次を入力します：

   • シングルサインオン URL（Mintlify 提供）
   • Audience URI（Mintlify 提供）
   • Name ID Format：EmailAddress
   • 属性ステートメント：

     Name	Name format	Value
     firstName	Basic	user.firstName
     lastName	Basic	user.lastName

3. IdP 情報を送信する

   アプリケーションの設定が完了したら、Sign-On タブに移動し、メタデータ URL をお送りください。 こちらでこの情報を用いて接続を有効化します。

Google Workspace

SAML

1. アプリケーションを作成する

   Web and mobile apps で、Add app ドロップダウンから Add custom SAML app を選択します。

   
2. IdP 情報を送信する

   提供された SSO URL、Entity ID、x509 証明書をコピーし、Mintlify チームに送付してください。

   
3. インテグレーションを設定する

   Service provider details ページで、次の項目を入力します:

   • ACS URL（Mintlify 提供）
   • Entity ID（Mintlify 提供）
   • Name ID format: EMAIL
   • Name ID: Basic Information > Primary email

   

   次のページで、以下の属性ステートメントを入力します:

   Google Directory Attribute	App Attribute
   First name	firstName
   Last name	lastName

   この手順が完了し、ユーザーをアプリケーションに割り当てたら、当社チームまでご連絡ください。お客様のアカウントで SSO を有効化します。

Microsoft Entra

SAML

1. アプリケーションを作成する

   1. “Enterprise applications” で New application を選択します。
   2. Create your own application を選択し、“Integrate any other application you don’t find in the gallery (Non-gallery)” を選びます。
2. SAML を設定する

   Single Sign-On のセットアップページに移動し、SAML を選択します。“Basic SAML Configuration” で次を入力します:

   • Identifier (Entity ID): Mintlify が提供する Audience URI
   • Reply URL (Assertion Consumer Service URL): Mintlify が提供する ACS URL

   そのほかの値は空のままにして Save を選択します。

3. Attributes & Claims を設定する

   Attributes & Claims セクションを編集します。

   1. “Required Claim” の Unique User Identifier (Name ID) を選択します。
   2. Source attribute を user.primaryauthoritativeemail に変更します。
   3. Additional claims で次のクレームを作成します。

      Name	Value
      firstName	user.givenname
      lastName	user.surname

4. Mintlify に IdP 情報を送信する

   アプリケーションの設定が完了したら “SAML Certificates” セクションに移動し、App Federation Metadata URL を送信してください。 この情報を用いて当方で接続を有効化します。

5. ユーザーを割り当てる

   Entra アプリケーションの “Users and groups” に移動し、ダッシュボードにアクセスさせるユーザーを追加します。