# Microsoft Entra IDでSSOを設定する (/docs/ja/support/security/single-sign-on/set-up-sso-with-microsoft-entra-id)

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

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

1\. Circlebackで[設定 → 一般](https://circleback.ai/settings?tab=workspace)（「ワークスペース」の下）に移動します。

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/emailaddress` | `user.mail` |
| `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname` | `user.givenname` |
| `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname` | `user.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に表示される認証情報を使用して[ディレクトリ同期を設定](/docs/support/security/single-sign-on/sso)します。

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

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

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

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

| 表示名 | 値 |
| ------------ | -------- |
| Admin | `Admin` |
| Member | `Member` |
| Viewer | `Viewer` |

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

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

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

| フィールド | 値 |
| ---------------- | ----------------------------------------------- |
| Expression | `SingleAppRoleAssignment([appRoleAssignments])` |
| Target attribute | `roles[primary eq "True"].value` |

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

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

ワークスペースの全員にSSOでのログインを必須にするには、[ワークスペースにSSOを強制適用する](/docs/support/security/single-sign-on/sso)の手順に従ってください。