メインコンテンツにスキップ

Azure AD を SAML プロバイダーとして追加

このガイドでは、SAML を介して Azure AD (Microsoft Entra ID) アカウントで Casdoor にサインインする方法について説明します。


学習目標​

  • Azure AD で Casdoor 用のエンタープライズ アプリケーションを作成します。
  • Casdoor に Azure AD を SAML プロバイダーとして追加します。
  • ユーザーを割り当てて、サインインをテストします。

必要なもの​

  • エンタープライズ アプリケーションを作成する権限を持つ Azure AD テナント
  • Casdoor 管理コンソールへの管理者アクセス権

エンタープライズ アプリケーションの作成​

  1. Azure ポータルで、Azure Active Directory > Enterprise applications に移動します。
  2. New application > Create your own application をクリックします。
  3. 名前を入力し(例:Casdoor)、Integrate any other application you don't find in the gallery (Non-gallery) を選択して、Create をクリックします。

シングルサインオンの設定​

  1. エンタープライズアプリケーションで、Single sign-on に移動し、SAML を選択します。

  2. Basic SAML Configuration で、Edit をクリックして以下を入力します:

    FieldValue
    Identifier (Entity ID)https://<your-casdoor-domain>/api/acs, for example https://door.example.com/api/acs
    Reply URL (Assertion Consumer Service URL)The same URL

    Azure AD は HTTP POST でレスポンスを送信しますが、これは /api/acs エンドポイントが要求する形式です。

  3. Save をクリックします。

  4. デフォルトの Attributes & Claims のままにするか、変更します:

    ClaimDefault source
    Unique User Identifieruser.userprincipalname
    emailaddressuser.mail
    nameuser.userprincipalname

    ユーザー名属性がマッピングされていない場合、Casdoor はアサーションのメールアドレスまたは NameID をユーザー名として使用します。

  5. SAML Certificates セクションから Federation Metadata XML をダウンロードします。または、Certificate (Base64) と、Set up Casdoor セクションにある Login URL、Azure AD Identifier、および Logout URL をメモしておきます。

Casdoor へのプロバイダーの追加​

  1. Casdoor 管理コンソールで、Identity > Providers に移動し、プロバイダーを追加します。
  2. Category を SAML に、Type を Custom に設定します。
  3. フェデレーションメタデータを Metadata に貼り付け、Parse をクリックします。
  4. プロバイダーを保存します。
  5. アプリケーションの編集ページを開き、Providers タブでプロバイダーを追加して、保存します。

ユーザーの割り当て​

Azure AD のエンタープライズアプリケーションで、Users and groups に移動し、Casdoor にサインインできるユーザーまたはグループを割り当てます。

結果の確認​

アプリケーションのサインインページを開き、Azure AD ボタンをクリックします。また、SAML 構成の Test ボタンを使って Azure AD 側からテストすることもできます。

関連項目​