Microsoft Entra IDでSSOを設定する

チームがMicrosoft Entra IDでCirclebackにログインできるようにします

Entra管理センターでカスタムSAMLアプリケーションを作成すると、Microsoft Entra IDをCirclebackに接続できます。

Entraでエンタープライズアプリケーションを管理する権限と、Circlebackワークスペースの管理者であることが必要です。始める前に、シングルサインオンを設定するで要件を確認してください。

1. Circlebackで設定 → 一般(「ワークスペース」の下)に移動します。

2. シングルサインオンで、IDプロバイダーの横にある接続を選択します。SAMLを選び、続行を選択します。このフォームは開いたままにしておきます。

3. 別のタブでEntra管理センターを開き、Enterprise applicationsに移動します。

Microsoft Entra ID:Enterprise applications

4. New application → Create your own applicationを選択します。

Microsoft Entra ID:New application

5. 名前にCirclebackと入力し、ギャラリーにないアプリケーションを統合するオプションを選びます。

6. Createを選択します。

Microsoft Entra ID:Create your own application

7. アプリケーションを開き、Manageの下のSingle sign-onを選択して、SAMLを選びます。

Microsoft Entra ID:SAMLシングルサインオンを選択

8. EntraのBasic SAML ConfigurationでEditを選択します。開いているCirclebackのフォームからエンティティIDとACS URLを以下のフィールドにコピーします。

Microsoft Entra ID:Basic SAML Configurationを編集

フィールド値
Identifier (Entity ID)https://circleback.ai/api/sso/metadata
Reply URL (Assertion Consumer Service URL)https://circleback.ai/api/sso/oauth/saml

9. Saveを選択します。

Microsoft Entra ID:IdentifierとReply URLのフィールド。上記のCircleback URLを使用します

10. Attributes & ClaimsでEditを選択します。

Microsoft Entra ID:Attributes and Claimsを編集

11. Unique User Identifier (Name ID) に、チームメンバーがCirclebackで使用しているメールアドレスを、Email address形式で設定します。割り当てた各ユーザーについてuser.mailにそのメールアドレスが含まれている場合は、それを使用します。user.userprincipalnameは、Circlebackのメールアドレスと一致する場合にのみ使用してください。

12. 以下のクレームを確認し、不足しているものを追加します。

クレームソース属性
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddressuser.mail
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givennameuser.givenname
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surnameuser.surname

メールアドレスのクレームも、メンバーのCirclebackのメールアドレスと一致している必要があります。メールアドレスに別のソース属性を使用する場合は、メールアドレスのクレームとName IDの両方にその属性を使用してください。

13. 変更を保存します。

Microsoft Entra ID:属性クレームの例。上記のメールアドレスのマッピング手順に従ってください

14. EntraのSingle sign-onに戻ります。SAML Signing CertificateでFederation Metadata XMLをダウンロードします。

Microsoft Entra ID:Federation Metadata XMLをダウンロード

15. 開いているCirclebackのフォームのメタデータのソースでXMLファイルをアップロードを選び、ダウンロードしたファイルをアップロードします。

16. Entraで、アプリケーションのUsers and groupsを開きます。

17. Add user/groupを選択し、Circlebackを使用するユーザーまたはグループを選びます。

18. Assignを選択します。

19. Circlebackに戻り、続行を選択します。ログインのみに使用する場合はディレクトリ同期なしを選択したままにし、SCIMプロビジョニングを設定する予定の場合はMicrosoft Entra IDを選択します。接続を選択します。

ディレクトリ同期にMicrosoft Entra IDを選択した場合は、Circlebackに表示される認証情報を使用してディレクトリ同期を設定します。

ワークスペースのロールを割り当てる

ディレクトリ同期を設定している場合は、Entraで各メンバーのCirclebackでのロールも設定できます。

1. Entra管理センターでApp registrations → All applicationsに移動し、Circlebackを開きます。

2. App roles → Create app roleを選択します。次の3つのロールを作成し、それぞれでUsers/Groupsを許可します。

表示名値
AdminAdmin
MemberMember
ViewerViewer

3. Enterprise applications → Circleback → Users and groupsに移動します。各ユーザーまたはグループに、付与するロールを割り当てます。1人につき割り当てるロールは1つだけにしてください。

4. Provisioning → Attribute mapping → Usersを選択します。

5. Add New Mappingを選択し、マッピングの種類にExpressionを選んで、次のように入力します。

フィールド値
ExpressionSingleAppRoleAssignment([appRoleAssignments])
Target attributeroles[primary eq "True"].value

6. OKを選択し、Saveを選択します。

7. Settingsで、ScopeをSync only assigned users and groupsに設定します。

ワークスペースの全員にSSOでのログインを必須にするには、ワークスペースにSSOを強制適用するの手順に従ってください。

関連記事