> ## 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.
Ваше приложение получает организации и роли пользователя из его token и сессии и решает, что может делать каждая роль.

> [!NOTE]
>
> Здесь организация означает одного из **ваших** клиентов внутри вашего приложения.
> Она отличается от вашей организации в Didit, которая объединяет вашу собственную команду в Business Console.

## Включение организаций

Организации по умолчанию выключены в новом приложении.
Откройте **Authentication > Organizations** в консоли и в карточке **Settings**:

* Включите **Organizations**.
* Выберите **Default role for new members**: роль, которую получают пользователи при присоединении через подтверждённый домен или единый вход (SSO). По умолчанию это `member`.
* Оставьте включённой настройку **Require MFA for organization admins**: это политика MFA по умолчанию (см. [ниже](#mfa-для-администраторов-организаций)).

Затем вы управляете организациями в консоли: **New organization** создаёт организацию с названием и slug, который должен быть уникальным в приложении.
Организации создаёт ваша команда; пользователи пока не могут создавать собственные организации из вашего приложения.
В списке для каждой организации показаны участники, подтверждённые домены, статус единого входа (SSO), правило MFA и дата создания. Над списком выводятся ключевые показатели: количество организаций, участников, подключений SSO и подтверждённых доменов.

![Страница Organizations в Didit Business Console с ключевыми показателями и списком организаций, их участников, подтверждённых доменов и статуса единого входа (SSO)](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organizations.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=95f8ab54f499735fe3f8593c565c0daa)

Authentication > Organizations.

## Участники и роли

Один человек может состоять в нескольких организациях вашего приложения, и в каждой у него своя роль.

| Роль | Назначение |
| - | - |
| `admin` | Люди, которые управляют организацией в вашем приложении. |
| `member` | Все остальные. Роль по умолчанию. |
| `billing` | Люди, которые занимаются биллингом организации в вашем приложении. |

На тарифах Scale и Enterprise, а также в каждом приложении Sandbox вы можете определить **пользовательские роли**: каждая из них имеет ключ и набор разрешений, которые проверяет ваше приложение, например `payouts.approve`.
Участник может иметь пользовательскую роль в дополнение к своей основной роли.

Откройте организацию, чтобы увидеть её единый вход (SSO), подтверждённые домены, участников, роли и приглашения.

![Организация, открытая в 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. Добавьте TXT-запись, которую Didit показывает, по адресу `_didit-auth.<domain>` у вашего DNS-провайдера. Запись содержит токен верификации.
3. Проверьте домен. После того как запись будет найдена, он отображается как **Verified**.

Если для подтверждённого домена включена опция **Auto-join**, пользователь, который входит с подтверждённым адресом электронной почты на этом домене, автоматически присоединяется к организации с ролью по умолчанию.
Домен может автоматически присоединять пользователей только к одной организации вашего приложения.

## Корпоративный единый вход

Организация может аутентифицировать своих пользователей через собственного провайдера удостоверений по SAML или OIDC.

* **Ссылка для настройки.** Нажмите **Copy setup link** в карточке **Single sign-on** организации и безопасно передайте её IT-администратору организации. Ссылка действует семь дней и проводит администратора через настройку подключения. Ссылки для настройки доступны на тарифах Scale и Enterprise. В приложениях Sandbox они доступны на любом тарифе.
* **SAML.** Метаданные вашего поставщика услуг опубликованы по адресу `{origin}/sso/saml/metadata/`.
* **Поиск подключения.** Размещённая страница входа находит подключение организации по подтверждённому домену электронной почты пользователя, по **Use single sign-on** или по параметру `organization=<slug>` в URL входа.
* **Статус.** В списке организаций видно, активно ли каждое подключение, не настроено ли оно или ожидает ссылки для настройки, которая уже отправлена.

Пользователи, которые входят через провайдера удостоверений организации, присоединяются к ней с вашей ролью по умолчанию.
Поля конфигурации для каждого протокола описаны в разделе [способы входа](https://docs.didit.me/ru/authentication/sign-in-methods.md#sso-для-организаций).

## MFA для администраторов организаций

Политика MFA по умолчанию, `organization_admins`, требует второй фактор от каждого пользователя, который имеет роль `admin` в любой организации вашего приложения.
Пользователь, который становится администратором, должен зарегистрировать фактор. До тех пор, пока сессия снова не будет соответствовать политике, `GET /session/` не принимает её.
Изменить политику можно в разделе **Authentication > Security and sessions** или с помощью `mfa_policy` в [настройках приложения](https://docs.didit.me/ru/authentication/overview.md#настройки-приложения).

## Просмотр организаций в вашем приложении

Пока организации включены, токены и сессия пользователя показывают вашему приложению, к каким организациям он относится:

| Где | Что содержит |
| - | - |
| Утверждение `org` в токенах доступа и ID-токенах | `{"id", "role"}` для самого раннего членства пользователя в организации, или `null`. |
| `organizations` в `GET /session/` | Все членства с полями `organization_id`, `organization__name`, `role` и `custom_role` (`key` и `permissions`, или `null`). |
| `organizations` в сессии SDK | Тот же список, например `session.organizations` в JavaScript и `user.organizations` в React. |

```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/ru/authentication/migration.md) из другой платформы, вы можете перенести вместе с ними и их членство в организациях.
Подробнее см. [социальные ссылки, аутентификаторы и организации](https://docs.didit.me/ru/authentication/migration.md#социальные-связи-аутентификаторы-и-организации).


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