> ## 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]
>
> 이 페이지에서 말하는 조직은 애플리케이션 안에 있는 **귀사의 고객 중 하나입니다**.
> Business Console에서 자사 팀을 포함하는 Didit 조직과는 별개입니다.

## 조직 기능 켜기

새 애플리케이션에서는 조직 기능이 꺼져 있습니다.
콘솔에서 **Authentication > Organizations**를 열고, **Settings** 카드에서 다음을 설정합니다.

* **Organizations**를 켭니다.
* 인증된 도메인 또는 싱글 사인온으로 가입하는 사용자가 받는 역할인 **Default role for new members**를 선택합니다(기본값은 `member`입니다).
* 기본 MFA 정책인 **Require MFA for organization admins**를 켜 둡니다([아래](#조직-관리자를-위한-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 페이지.

## 멤버와 역할

한 사람이 애플리케이션의 여러 조직에 속할 수 있으며, 조직마다 하나의 역할을 가집니다.

| 역할 | 대상 |
| - | - |
| `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. DNS 제공업체에서 `_didit-auth.<domain>`에 Didit이 표시하는 TXT 레코드를 추가합니다. 이 레코드에는 인증 토큰이 포함되어 있습니다.
3. 도메인을 확인합니다. 레코드가 발견되면 **Verified**로 표시됩니다.

인증된 도메인에 대해 **Auto-join**이 켜져 있으면, 해당 도메인의 인증된 이메일 주소로 로그인한 사용자는 기본 역할을 부여받아 조직에 자동으로 가입됩니다.
도메인은 애플리케이션 내에서 하나의 조직에만 자동 가입할 수 있습니다.

## 기업 싱글 사인온

조직은 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/ko/authentication/sign-in-methods.md#조직-sso)에 나와 있습니다.

## 조직 관리자를 위한 MFA

기본 MFA 정책인 `organization_admins`는 애플리케이션의 어떤 조직에서든 `admin` 역할을 가진 모든 사람에게 두 번째 인증 요소를 요구합니다.
관리자가 된 사용자는 인증 수단을 등록해야 하며, 세션이 정책을 다시 충족할 때까지 `GET /session/`은 해당 사용자의 세션을 더 이상 허용하지 않습니다.
정책은 **Authentication > Security and sessions**에서 변경하거나, [애플리케이션 설정](https://docs.didit.me/ko/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/ko/authentication/migration.md) 때, 해당 사용자의 조직 멤버십도 함께 가져올 수 있습니다.
자세한 내용은 [소셜 링크, 인증기 및 조직](https://docs.didit.me/ko/authentication/migration.md#소셜-연동-인증-앱-및-조직)을 참조하세요.


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