Azure AD を SAML プロバイダーとして追加
このガイドでは、SAML を介して Azure AD (Microsoft Entra ID) アカウントで Casdoor にサインインする方法について説明します。
学習目標
- Azure AD で Casdoor 用のエンタープライズ アプリケーションを作成します。
- Casdoor に Azure AD を SAML プロバイダーとして追加します。
- ユーザーを割り当てて、サインインをテストします。
必要なもの
- エンタープライズ アプリケーションを作成する権限を持つ Azure AD テナント
- Casdoor 管理コンソールへの管理者アクセス権
エンタープライズ アプリケーションの作成
- Azure ポータルで、Azure Active Directory > Enterprise applications に移動します。
- New application > Create your own application をクリックします。
- 名前を入力し(例:
Casdoor)、Integrate any other application you don't find in the gallery (Non-gallery) を選択して、Create をクリックします。
シングルサインオンの設定
-
エンタープライズアプリケーションで、Single sign-on に移動し、SAML を選択します。
-
Basic SAML Configuration で、Edit をクリックして以下を入力します:
Field Value Identifier (Entity ID) https://<your-casdoor-domain>/api/acs, for examplehttps://door.example.com/api/acsReply URL (Assertion Consumer Service URL) The same URL Azure AD は HTTP POST でレスポンスを送信しますが、これは
/api/acsエンドポイントが要求する形式です。 -
Save をクリックします。
-
デフォルトの Attributes & Claims のままにするか、変更します:
Claim Default source Unique User Identifier user.userprincipalnameemailaddress user.mailname user.userprincipalnameユーザー名属性がマッピングされていない場合、Casdoor はアサーションのメールアドレスまたは NameID をユーザー名として使用します。
-
SAML Certificates セクションから Federation Metadata XML をダウンロードします。または、Certificate (Base64) と、Set up Casdoor セクションにある Login URL、Azure AD Identifier、および Logout URL をメモしておきます。
Casdoor へのプロバイダーの追加
- Casdoor 管理コンソールで、Identity > Providers に移動し、プロバイダーを追加します。
- Category を
SAMLに、Type をCustomに設定します。 - フェデレーションメタデータを Metadata に貼り付け、Parse をクリックします。
- プロバイダーを保存します。
- アプリケーションの編集ページを開き、Providers タブでプロバイダーを追加して、保存します。
ユーザーの割り当て
Azure AD のエンタープライズアプリケーションで、Users and groups に移動し、Casdoor にサインインできるユーザーまたはグループを割り当てます。
結果の確認
アプリケーションのサインインページを開き、Azure AD ボタンをクリックします。また、SAML 構成の Test ボタンを使って Azure AD 側からテストすることもできます。