Microsoft Entra SSO と Redocly の統合

  • [アーティクル]

この記事では、Redocly と Microsoft Entra ID を統合する方法について学習します。 Redocly は、GitHub でドキュメントを保持できる最初の開発者向けドキュメント ツールであり、開発者のドキュメントを開発者の近くに保つことができます。 Microsoft Entra ID と Redocly を統合すると、次のことができます。

  • Redocly にアクセスできるユーザーを Microsoft Entra ID で制御する。
  • ユーザーが自分の Microsoft Entra アカウントを使って Redocly に自動的にサインインできるようにする。
  • 1 つの場所でアカウントを管理します。

テスト環境で Redocly 用の Microsoft Entra シングル サインオンを構成してテストします。 Redocly では、SP によって開始されるシングル サインオンと Just-In-Time ユーザー プロビジョニングがサポートされています。

前提条件

Microsoft Entra ID を Redocly と統合するには、次のものが必要です。

アプリケーションを追加してテスト ユーザーを割り当てる

シングル サインオンの構成プロセスを開始する前に、Microsoft Entra ギャラリーから Redocly アプリケーションを追加する必要があります。 アプリケーションに割り当て、シングル サインオン構成をテストするには、テスト ユーザー アカウントが必要です。

Microsoft Entra アプリケーション ギャラリーから Redocly を追加して、Redocly とのシングル サインオンを構成します。 ギャラリーからアプリケーションを追加する方法の詳細については、クイック スタート: ギャラリーからのアプリケーションの追加に関する記事を参照してください。

Microsoft Entra テスト ユーザーを作成して割り当てる

「ユーザー アカウントを作成して割り当てる」の記事のガイドラインに従って、B.Simon というテスト ユーザー アカウントを作成します。

または、Enterprise App Configuration ウィザードを使用することもできます。 このウィザードでは、テナントへのアプリケーションの追加、アプリへのユーザーとグループの追加、ロールの割り当てができます。 このウィザードには、シングル サインオン構成ウィンドウへのリンクも表示されます。 Microsoft 365 ウィザードの詳細をご覧ください。

Microsoft Entra SSO の構成

Microsoft Entra シングル サインオンを有効にするには、次の手順を行います。

  1. クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。

  2. [ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[Redocly]>[シングル サインオン] の順に移動します。

  3. [シングル サインオン方式の選択] ページで、 [SAML] を選択します。

  4. [SAML でシングル サインオンをセットアップします] ページで、 [基本的な SAML 構成] の鉛筆アイコンを選択して設定を編集します。

    基本的な SAML 構成を編集する方法を示すスクリーンショット。

  5. [基本的な SAML 構成] セクションで、次の手順を実行します。

    a. [識別子] ボックスに、次のいずれかのパターンで URL を入力します。

    Identifier
    https://api.redocly.com/auth/sso?idpId=<CustomerId>
    https://api.<Region>.redocly.com/auth/sso?idpId=<CustomerId>

    b. [応答 URL] ボックスに、次のいずれかの形式で URL を入力します。

    応答 URL
    https://api.redocly.com/auth/sso
    https://api.<Region>.redocly.com/auth/sso
    https://<SiteName>.redoc.dev/_auth/saml2
    https://<SiteName>.<REGION>.redoc.dev/_auth/saml2

    c. [サインオン URL] ボックスに、次のいずれかの形式で URL を入力します。

    サインオン URL
    https://app.redocly.com/login-sso
    https://app.<Region>.redocly.com/login-sso
    https://<SiteName>.redoc.dev/_auth/idp-login
    https://<SiteName>.<REGION>.redoc.dev/_auth/idp-login

    注意

    これらは実際の値ではありません。 これらの値は、実際の識別子、応答 URL、サインオン URL で更新してください。 これらの値を取得するには、Redocly サポート チームにお問い合わせください。 [基本的な SAML 構成] セクションに示されているパターンを参照することもできます。

  6. [SAML でシングル サインオンをセットアップします] ページの [SAML 署名証明書] セクションで、[証明書 (PEM)] を見つけて [ダウンロード] を選択し、証明書をダウンロードして、お使いのコンピューターに保存します。

    証明書のダウンロード リンクを示すスクリーンショット。

  7. [Redocly のセットアップ] セクションで、要件に基づいて適切な URL をコピーします。

    構成の適切な URL をコピーすることを示すスクリーンショット。

Redocly の SSO を構成する

Redocly 側でシングル サインオンを構成するには、ダウンロードした証明書 (PEM) と、アプリケーションの構成からコピーした適切な URL を、Redocly サポート チームに送信する必要があります。 サポート チームはこれを設定して、SAML SSO 接続が両方の側で正しく設定されるようにします。

Redocly のテスト ユーザーを作成する

このセクションでは、B.Simon というユーザーを Redocly に作成します。 Redocly では、Just-In-Time ユーザー プロビジョニングがサポートされており、既定で有効になっています。 このセクションでは、ユーザー側で必要な操作はありません。 Redocly にユーザーがまだ存在していない場合、一般的には認証後に新しいものが作成されます。

SSO のテスト

このセクションでは、次のオプションを使用して Microsoft Entra のシングル サインオン構成をテストします。

  • [このアプリケーションをテストします] をクリックすると、ログイン フローを開始できる Redocly のサインオン URL にリダイレクトされます。

  • Redocly のサインオン URL に直接移動し、そこからログイン フローを開始します。

  • Microsoft マイ アプリを使用することができます。 マイ アプリの [Redocly] タイルをクリックすると、Redocly のサインオン URL にリダイレクトされます。 詳細については、「Microsoft Entra のマイ アプリ」を参照してください。

その他のリソース

次のステップ

Redocly を構成したら、組織の機密データを流出と侵入からリアルタイムで保護するセッション制御を適用することができます。 セッション制御は、条件付きアクセスを拡張したものです。 Microsoft Cloud App Security でセッション制御を強制する方法をご覧ください。