この記事では、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 ユーザー アカウント。 まだアカウントがない場合は、無料でアカウントを作成することができます。
- 次のいずれかのロール: アプリケーション管理者、クラウドアプリケーション管理者、または アプリケーション所有者。
- Microsoft Entra サブスクリプション。 サブスクリプションがない場合は、無料アカウントを取得できます。
- Redocly のシングル サインオン (SSO) が有効なサブスクリプション。
アプリケーションを追加してテスト ユーザーを割り当てる
シングル サインオンの構成プロセスを開始する前に、Microsoft Entra ギャラリーから Redocly アプリケーションを追加する必要があります。 アプリケーションに割り当ててシングル サインオン構成をテストするには、テスト ユーザー アカウントが必要です。
Microsoft Entra ギャラリーから Redocly を追加する
Microsoft Entra アプリケーション ギャラリーから Redocly を追加して、Redocly とのシングル サインオンを構成します。 ギャラリーからアプリケーションを追加する方法の詳細については、「 クイック スタート: ギャラリーからアプリケーションを追加する」を参照してください。
Microsoft Entra テスト ユーザーの作成と割り当て
作成とユーザー アカウントの割り当てに関する記事のガイドラインに従って、B.Simon というテスト ユーザー アカウントを作成します。
または、 エンタープライズ アプリ構成ウィザードを使用することもできます。 このウィザードでは、テナントにアプリケーションを追加し、ユーザー/グループをアプリに追加し、ロールを割り当てることができます。 このウィザードでは、シングル サインオン構成ウィンドウへのリンクも提供されます。 Microsoft 365 ウィザードの詳細を確認してください。.
Microsoft Entra SSO の構成
Microsoft Entra のシングル サインオンを有効にするには、次の手順を実行します。
クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
Entra ID>Enterprise apps>Redocly>シングルサインオンに移動します。
[シングル サインオン方式の選択] ページで、 [SAML] を選択します。
[ SAML でのシングル サインオンの設定 ] ページで、[ 基本的な SAML 構成 ] の鉛筆アイコンを選択して設定を編集します。
[基本的な SAML 構成] セクションで、次の手順を実行します。
ある。 [ 識別子 ] ボックスに、次のいずれかのパターンを使用して URL を入力します。
識別子 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/ssohttps://api.<Region>.redocly.com/auth/ssohttps://<SiteName>.redoc.dev/_auth/saml2https://<SiteName>.<REGION>.redoc.dev/_auth/saml2c. [ サインオン URL ] ボックスに、次のいずれかのパターンを使用して URL を入力します。
サインオン URL https://app.redocly.com/login-ssohttps://app.<Region>.redocly.com/login-ssohttps://<SiteName>.redoc.dev/_auth/idp-loginhttps://<SiteName>.<REGION>.redoc.dev/_auth/idp-login注
これらの値は実際の値ではありません。 実際の識別子、応答 URL、サインオン URL でこれらの値を更新します。 これらの値を取得するには、Redocly サポート チームにお問い合わせください。 [基本的な SAML 構成] セクションに示されているパターンを参照することもできます。
[SAML でシングル サインオンをセットアップします] ページの [SAML 署名証明書] セクションで、[証明書 (PEM)] を見つけて [ダウンロード] を選択し、証明書をダウンロードして、お使いのコンピューターに保存します。
[Redocly のセットアップ] セクションで、要件に基づいて適切な 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 My Apps」を参照してください。
その他のリソース
関連コンテンツ
Redocly を構成したら、組織の機密データを流出と侵入からリアルタイムで保護するセッション制御を適用することができます。 セッション制御は条件付きアクセスから拡張されます。 Microsoft Cloud App Security でセッション制御を適用する方法について説明します。