> ## 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.

# Organisasi B2B: Anggota, Peran & SSO Perusahaan

> Modelkan pelanggan bisnis Anda sebagai organisasi di Didit Authentication, dengan anggota, peran, undangan, domain terverifikasi, auto-join, dan SSO sendiri.

Organisasi di Didit Authentication memungkinkan aplikasi B2B Anda mengelompokkan penggunanya berdasarkan perusahaan tempat mereka bekerja.
Setiap organisasi memiliki anggota dan peran sendiri, dapat memverifikasi domain email-nya agar rekan kerja bergabung secara otomatis, dan dapat mengautentikasi anggotanya melalui penyedia identitas SAML atau OIDC miliknya sendiri.
Aplikasi Anda membaca organisasi dan peran seseorang dari token dan sesi mereka, lalu menentukan apa yang boleh dilakukan setiap peran.

> [!NOTE]
>
> Organisasi di sini adalah salah satu pelanggan **Anda** di dalam aplikasi Anda.
> Organisasi ini terpisah dari organisasi Didit Anda, yang berisi tim Anda sendiri di Business Console.

## Aktifkan organisasi

Organisasi dinonaktifkan pada aplikasi baru.
Buka **Authentication > Organizations** di konsol, lalu di kartu **Settings**:

* Aktifkan **Organizations**.
* Pilih **Default role for new members**, yaitu peran yang didapat orang saat bergabung melalui domain terverifikasi atau single sign-on (secara default `member`).
* Biarkan **Require MFA for organization admins** aktif, yaitu kebijakan MFA default (lihat [di bawah](#mfa-untuk-admin-organisasi)).

Setelah itu, Anda mengelola organisasi di konsol. **New organization** membuat organisasi dengan nama dan slug, dengan slug yang unik dalam aplikasi.
Organisasi dibuat oleh tim Anda. Saat ini, orang tidak dapat membuat organisasi sendiri dari aplikasi Anda.
Daftar menampilkan anggota, domain terverifikasi, status single sign-on, aturan MFA, dan tanggal pembuatan setiap organisasi. Di atas daftar, metrik utama menghitung jumlah organisasi, anggota, koneksi SSO, dan domain terverifikasi.

![Halaman Organizations di Didit Business Console, dengan metrik utama dan daftar organisasi beserta anggota, domain terverifikasi, dan status single sign-on](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organizations.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=95f8ab54f499735fe3f8593c565c0daa)

Authentication > Organizations.

## Anggota dan peran

Seseorang dapat menjadi anggota beberapa organisasi di aplikasi Anda, dengan satu peran di setiap organisasi.

| Peran | Diperuntukkan bagi |
| - | - |
| `admin` | Orang yang mengelola organisasi di aplikasi Anda. |
| `member` | Semua orang lainnya. Peran default. |
| `billing` | Orang yang mengurus penagihan organisasi di aplikasi Anda. |

Di paket Scale dan Enterprise, serta di setiap aplikasi Sandbox, Anda juga dapat menentukan **peran kustom**, masing-masing dengan kunci dan izin yang diperiksa aplikasi Anda, misalnya `payouts.approve`.
Anggota dapat memiliki peran kustom selain perannya.

Buka organisasi untuk melihat login tunggal, domain terverifikasi, anggota, peran, dan undangannya.

![Sebuah organisasi yang dibuka di Didit Business Console, menampilkan login tunggal SAML dengan tautan pengaturan, domain terverifikasi dengan bergabung otomatis, serta anggota dan peran-perannya](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organization-detail.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=c3c60f877bbd96f53cb7d6ca2095d3d1)

Login tunggal, domain terverifikasi, anggota, dan peran sebuah organisasi.

## Undangan

Pilih **Invite member** pada sebuah organisasi, masukkan hingga 20 alamat email beserta peran yang akan diberikan (`admin`, `member`, atau `billing`), lalu Didit mengirim email undangan kepada setiap orang.
Undangan berlaku selama 7 hari dan membuka halaman `/invite` yang di-hosting di origin sign-in Anda, tempat orang tersebut masuk atau membuat akun, lalu bergabung.
Daftar **Invitations** pada organisasi menampilkan kapan setiap undangan kedaluwarsa, dengan tombol **Resend** dan **Revoke**.

## Verifikasi domain dan auto-join

Sebuah organisasi dapat membuktikan kepemilikan domain email:

1. Tambahkan domain ke organisasi.
2. Tambahkan record TXT yang ditampilkan Didit di `_didit-auth.<domain>` melalui penyedia DNS Anda, yang berisi token verifikasi.
3. Periksa domain tersebut. Statusnya menjadi **Verified** setelah record ditemukan.

Dengan **Auto-join** aktif untuk domain yang terverifikasi, orang yang masuk dengan alamat email terverifikasi di domain tersebut akan bergabung ke organisasi secara otomatis, dengan peran default Anda.
Sebuah domain hanya dapat melakukan auto-join ke satu organisasi dalam aplikasi Anda.

## Single sign-on perusahaan

Organisasi dapat mengizinkan anggotanya masuk melalui penyedia identitasnya sendiri, dengan SAML atau OIDC.

* **Tautan pengaturan.** Pilih **Copy setup link** pada kartu **Single sign-on** organisasi, lalu bagikan secara aman kepada admin TI organisasi. Tautan ini berlaku selama tujuh hari dan memandu mereka melalui proses koneksi. Tautan pengaturan memerlukan paket Scale atau Enterprise; aplikasi Sandbox memilikinya di paket apa pun.
* **SAML.** Metadata penyedia layanan Anda dipublikasikan di `{origin}/sso/saml/metadata/`.
* **Menemukan koneksi.** Halaman masuk yang di-hosting menemukan koneksi organisasi dari domain email terverifikasi pengguna, dari **Use single sign-on**, atau dari `organization=<slug>` pada URL masuk.
* **Status.** Daftar organisasi menunjukkan apakah setiap koneksi aktif, belum diatur, atau menunggu tautan pengaturan yang telah dikirim.

Pengguna yang masuk melalui penyedia identitas organisasi akan bergabung dengan organisasi tersebut menggunakan peran default Anda.
Kolom konfigurasi untuk setiap protokol ada di [metode masuk](https://docs.didit.me/id/authentication/sign-in-methods.md#sso-organisasi).

## MFA untuk admin organisasi

Kebijakan MFA default, `organization_admins`, mewajibkan faktor kedua dari setiap orang yang memegang peran `admin` di organisasi mana pun dalam aplikasi Anda.
Orang yang menjadi admin harus mendaftarkan faktor, dan `GET /session/` tidak lagi menerima sesi mereka sampai sesi tersebut kembali memenuhi kebijakan.
Ubah kebijakan di **Authentication > Security and sessions**, atau dengan `mfa_policy` di [pengaturan aplikasi](https://docs.didit.me/id/authentication/overview.md#pengaturan-aplikasi).

## Membaca organisasi di aplikasi Anda

Saat organisasi diaktifkan, token dan sesi pengguna memberi tahu aplikasi Anda di mana mereka tergabung:

| Lokasi | Isi |
| - | - |
| Klaim `org` di token akses dan token ID | `{"id", "role"}` dari keanggotaan organisasi paling awal milik pengguna, atau `null`. |
| `organizations` di `GET /session/` | Setiap keanggotaan, dengan `organization_id`, `organization__name`, `role` dan `custom_role` (`key` dan `permissions`, atau `null`). |
| `organizations` di sesi SDK | Daftar yang sama, misalnya `session.organizations` di JavaScript dan `user.organizations` di React. |

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

Periksa peran dan izin di backend Anda, dari token yang telah diverifikasi atau `GET /session/`, sebelum setiap tindakan yang bergantung padanya.
Saat organisasi dinonaktifkan, `org` bernilai `null` dan daftarnya kosong.

## Impor organisasi yang sudah ada

Saat Anda [mengimpor pengguna](https://docs.didit.me/id/authentication/migration.md) dari platform lain, Anda dapat membawa keanggotaan organisasi mereka sekaligus.
Lihat [tautan sosial, autentikator, dan organisasi](https://docs.didit.me/id/authentication/migration.md#tautan-sosial-autentikator-dan-organisasi).


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