> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 組織管理：B2Bアプリ向けのメンバー・役割・企業SSO

> Didit Authenticationで取引先企業を組織として管理できます。メンバー、役割、招待、認証済みドメインによる自動参加、組織ごとのSSOを設定できます。

Didit Authenticationの組織機能を使うと、B2Bアプリケーションでユーザーを勤務先の企業ごとにグループ化できます。
各組織は独自のメンバーと役割を持ち、メールドメインを検証して同僚が自動で参加できるようにできます。また、組織独自のSAMLまたはOIDCのアイデンティティプロバイダーを通じて、メンバーをサインインさせることもできます。
アプリは、ユーザーの組織と役割をトークンとセッションから読み取り、各役割が実行できる操作を決定します。

> [!NOTE]
>
> ここでいう組織とは、アプリケーション内に存在する**あなたの**顧客の1つです。
> Business Consoleで自社のチームを管理するDidit組織とは別のものです。

## 組織を有効にする

新しいアプリケーションでは、組織は無効になっています。
コンソールで **Authentication > Organizations** を開き、**Settings** カードで次の操作を行ってください。

* **Organizations** をオンにします。
* **Default role for new members** を選択します。認証済みドメインまたはシングルサインオン経由で参加したユーザーに付与される役割です（デフォルトは `member`）。
* **Require MFA for organization admins** はオンのままにしてください。これはデフォルトのMFAポリシーです（[下記](#組織管理者のmfa)を参照）。

その後、コンソールで組織を管理します。**New organization** を選択すると、名前と、アプリケーション内で一意のスラッグを指定して組織を作成できます。
組織はお客様のチームが作成します。現時点では、アプリから利用者が自分で組織を作成することはできません。
一覧には、各組織のメンバー、認証済みドメイン、シングルサインオンの状態、MFAルール、作成日が表示されます。一覧の上部にある主要指標では、組織、メンバー、SSO接続、認証済みドメインの件数を確認できます。

![Didit Business Consoleの Organizations ページ。主要指標と、各組織のメンバー、認証済みドメイン、シングルサインオンの状態を示す一覧が表示されています](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organizations.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=95f8ab54f499735fe3f8593c565c0daa)

Authentication > Organizations の画面。

## メンバーと役割

1人のユーザーは、アプリケーション内の複数の組織に所属でき、組織ごとに1つの役割を持ちます。

| 役割 | 対象 |
| - | - |
| `admin` | アプリケーション内で組織を管理する人。 |
| `member` | それ以外のすべての人。デフォルトの役割です。 |
| `billing` | アプリケーション内で組織の請求を扱う人。 |

ScaleとEnterpriseプラン、およびすべてのサンドボックスアプリケーションでは、キーと、アプリが確認する権限を持つ**カスタムロール**も定義できます。たとえば、アプリが確認する権限として `payouts.approve` を設定できます。
メンバーは、自分の役割に加えてカスタムロールを持つことができます。

組織を開くと、シングルサインオン、認証済みドメイン、メンバー、役割、招待を確認できます。

![Didit Business Consoleで開いた組織。セットアップリンク付きのSAMLシングルサインオン、自動参加付きの認証済みドメイン、メンバーと役割が表示されている](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organization-detail.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=c3c60f877bbd96f53cb7d6ca2095d3d1)

組織のシングルサインオン、認証済みドメイン、メンバーと役割。

## 招待

組織で**Invite member**を選択し、メールアドレスを最大20件と、それらのユーザーに付与する役割（`admin`、`member`、`billing`）を入力します。するとDiditが各ユーザーに招待メールを送信します。
招待の有効期間は7日間です。招待を受けたユーザーは、サインイン元にあるホスト型の`/invite`ページを開き、サインインまたはアカウントを作成して参加します。
組織の**Invitations**一覧には、各招待の有効期限が表示されます。また、各招待に**Resend**と**Revoke**があります。

## 検証済みドメインと自動参加

組織は、メールドメインの所有を証明できます：

1. 組織にドメインを追加します。
2. Didit が表示する TXT レコードを、DNSプロバイダーで `_didit-auth.<domain>` に追加します。このレコードには検証用のトークンが含まれます。
3. ドメインを確認します。レコードが見つかると、**Verified** と表示されます。

検証済みのドメインで **Auto-join** がオンになっている場合、そのドメインの検証済みメールアドレスでサインインしたユーザーは、デフォルトの役割で組織に自動的に参加します。
1つのドメインは、アプリケーション内の1つの組織にのみ自動参加できます。

## 企業のシングルサインオン

組織は、SAMLまたはOIDCを使い、独自のIDプロバイダーを通じてユーザーをサインインさせることができます。

* **設定リンク。** 組織の**Single sign-on**カードで**Copy setup link**を選択し、組織のIT管理者に安全な方法で共有してください。リンクの有効期間は7日間で、接続の設定手順を案内します。設定リンクにはScaleまたはEnterpriseプランが必要です。サンドボックスのアプリケーションでは、どのプランでも利用できます。
* **SAML。** サービスプロバイダーのメタデータは`{origin}/sso/saml/metadata/`で公開されています。
* **接続の検索。** ホスト型サインインページは、ユーザーの認証済みメールドメイン、**Use single sign-on**、またはサインインURLの`organization=<slug>`から、その組織の接続を見つけます。
* **ステータス。** 組織の一覧には、各接続が有効、未設定、または送信した設定リンクによる設定を待っている状態のいずれであるかが表示されます。

組織のIDプロバイダーを通じてサインインしたユーザーは、デフォルトの役割で組織に参加します。
各プロトコルの設定項目は[サインイン方法](https://docs.didit.me/ja/authentication/sign-in-methods.md#組織sso)にあります。

## 組織管理者のMFA

デフォルトのMFAポリシーである`organization_admins`は、アプリケーション内のいずれかの組織で`admin`ロールを持つすべてのユーザーに、第2認証要素を求めます。
管理者になったユーザーは認証要素を登録する必要があります。ポリシーを満たすまで、`GET /session/`はそのユーザーのセッションを受け付けません。
ポリシーは**Authentication > Security and sessions**で変更できるほか、[アプリケーション設定](https://docs.didit.me/ja/authentication/overview.md#アプリケーション設定)の`mfa_policy`でも変更できます。

## アプリで組織情報を取得する

組織機能が有効な間は、エンドユーザーのトークンとセッションによって、アプリがそのユーザーの所属先を判断できます。

| 場所 | 内容 |
| - | - |
| アクセストークンとIDトークンの `org` クレーム | ユーザーの最初の組織所属の `{"id", "role"}`。該当がない場合は `null`。 |
| `GET /session/` の `organizations` | すべての所属情報。`organization_id`、`organization__name`、`role`、`custom_role`（`key`と`permissions`、または`null`）を含みます。 |
| SDKのセッションの `organizations` | 同じ一覧です。JavaScriptでは `session.organizations`、Reactでは `user.organizations` を使います。 |

```json theme={null}
{
  "organizations": [
    {
      "organization_id": "3e9a1f0b-5c2d-4e7f-8a6b-9c0d1e2f3a4b",
      "organization__name": "Northwind",
      "role": "admin",
      "custom_role": {"key": "approver", "permissions": ["payouts.approve"]}
    }
  ]
}
```

役割と権限に依存する操作を行う前に、必ずバックエンドで確認してください。確認には、検証済みトークンまたは `GET /session/` を使います。
組織機能がオフの場合、`org` は `null` になり、一覧は空になります。

## 既存の組織をインポートする

別のプラットフォームから[ユーザーをインポート](https://docs.didit.me/ja/authentication/migration.md)する際に、そのユーザーの組織メンバーシップも一緒に取り込めます。
詳しくは[ソーシャルリンク、認証手段、組織](https://docs.didit.me/ja/authentication/migration.md#ソーシャル連携・認証アプリ・組織)を参照してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.