# Manajemen Pengguna

> [!WARNING]
> Fitur ini merupakan bagian dari paket Team & Enterprise.

Fitur-fitur berikut tersedia untuk organisasi dengan SSO yang diaktifkan. Lihat [SSO Dasar](./security-sso-basic) dan [SSO Terkelola](./enterprise-advanced-sso) untuk detail masing-masing mode.

	
	

## Waktu Sesi Berakhir

Nilai ini mengatur durasi sesi untuk anggota organisasi Anda.

Setelah waktu ini, anggota akan diminta untuk melakukan autentikasi ulang dengan Identity Provider Anda untuk mengakses sumber daya organisasi.

Nilai default adalah 7 hari.

## Pemetaan Peran

Ketika diaktifkan, Role Mapping memungkinkan Anda untuk secara dinamis menetapkan [roles](./organizations-security#access-control-in-organizations) kepada anggota organisasi berdasarkan data yang disediakan oleh Identity Provider Anda.

Bagian ini memungkinkan Anda untuk mendefinisikan pemetaan dari data profil pengguna IdP Anda ke peran yang ditugaskan di Hugging Face.

- **Jalur Atribut Peran IdP**

  Jalur JSON ke atribut dalam data profil IdP pengguna Anda. Mendukung notasi titik (misalnya `user.role` atau `groups`). Untuk SAML, ini dapat berupa URI (misalnya `http://schemas.microsoft.com/ws/2008/06/identity/claims/role`).

- **Pemetaan Peran**

  Pemetaan dari nilai atribut IdP ke peran yang ditugaskan dalam organisasi Hugging Face.

  Peran yang tersedia adalah `admin`, `write`, `contributor`, dan `read`. Lihat [dokumentasi peran](./organizations-security#access-control-in-organizations) untuk detail lebih lanjut.

> [!WARNING]
> Anda harus memetakan setidaknya satu peran `admin` dalam konfigurasi Anda.

Jika atribut dalam respons IdP berisi beberapa nilai (misalnya daftar grup) yang cocok dengan beberapa pemetaan, pengguna akan ditugaskan ke **peran yang paling berwenang di antara yang cocok**. Hierarki peran, dari yang paling rendah hingga paling berwenang, adalah `read` < `contributor` < `write` < `admin`.

Jika tidak ada kecocokan, peran ditentukan sebagai berikut:

- Jika pengguna diundang ke organisasi dengan peran tertentu, peran undangan tersebut digunakan sebagai cadangan.
- Jika tidak, pengguna akan diberikan peran default untuk organisasi Anda. Peran default dapat dikustomisasi di bagian `Members` pada pengaturan organisasi.

> [!NOTE]
> Saat mengundang pengguna yang perannya akan dikendalikan oleh pemetaan peran SSO, peran yang dipilih di modal undangan hanya berlaku jika pengguna tersebut belum memiliki peran yang ditugaskan di penyedia SSO Anda.

Sinkronisasi peran dilakukan setiap kali login.

## Pemetaan Grup Sumber Daya

Ketika diaktifkan, Resource Group Mapping memungkinkan Anda untuk secara dinamis menugaskan anggota ke [resource groups](./enterprise-resource-groups) di organisasi Anda, berdasarkan data yang disediakan oleh Identity Provider Anda.

	
	

- **Jalur Atribut IdP**

  Jalur JSON ke atribut dalam data profil IdP pengguna Anda. Mirip dengan Pemetaan Peran, ini mendukung notasi titik atau URI untuk SAML.

- **Pemetaan Grup Sumber Daya**

  Pemetaan dari nilai atribut IdP ke grup sumber daya di organisasi Hugging Face Anda. Anda dapat menetapkan peran tertentu (`admin`, `write`, `contributor`, `read`, `inherit`) untuk setiap pemetaan grup sumber daya.

Berbeda dengan Pemetaan Peran, **Pemetaan Grup Sumber Daya bersifat aditif**. Jika pengguna cocok dengan beberapa pemetaan (misalnya, mereka termasuk dalam beberapa grup di IdP Anda yang dipetakan ke Grup Sumber Daya yang berbeda), mereka akan ditambahkan ke **semua** Grup Sumber Daya yang cocok.

Jika tidak ada kecocokan, pengguna tidak akan ditugaskan ke grup sumber daya mana pun.

> [!WARNING]
> Grup sumber daya yang ditargetkan oleh pemetaan masih dapat diedit secara manual dari UI atau API Hub, tetapi perubahan tersebut akan ditimpa pada login SSO berikutnya oleh pengguna: perubahan peran akan dikembalikan ke peran yang dipetakan, dan pengguna yang dihapus secara manual akan ditambahkan kembali. Untuk mengubah akses pengguna yang dipetakan secara permanen, perbarui data IdP Anda atau konfigurasi pemetaan.

## Mencocokkan domain email

> [!NOTE]
> Fitur ini hanya relevan untuk [Basic SSO](./security-sso-basic). Dengan [Managed SSO](./enterprise-advanced-sso), akun pengguna sepenuhnya dikelola oleh organisasi, sehingga pencocokan domain email tidak berlaku.

Saat diaktifkan, 'Matching email domains' hanya memungkinkan anggota organisasi untuk menyelesaikan SSO jika email yang disediakan oleh penyedia identitas Anda cocok dengan salah satu email mereka di Hugging Face.

Untuk menambahkan domain email, isi kolom 'Matching email domains', tekan enter di keyboard Anda, lalu simpan.

## Kolaborator Eksternal

Kolaborator eksternal adalah pengguna di luar organisasi Anda yang memerlukan akses ke beberapa sumber dayanya tanpa melalui Single Sign-On (SSO). Itu biasanya berarti mereka tidak terdaftar di Identity Provider (IdP) Anda. Fitur ini tersedia di paket berbayar, dan mereka akan muncul dengan lencana "External collaborator" di daftar anggota organisasi Anda. Mereka juga dihitung dalam jumlah kursi berbayar di organisasi Anda.

Anda dapat menambahkannya dengan cara:

- **Mengundang mereka ke organisasi**: di halaman **Members** pengaturan organisasi Anda, centang **External Collaborator** saat Anda mengirim undangan.
- **Mengonversi anggota yang sudah ada**: di halaman **Members**, buka menu anggota tersebut dan pilih **Convert to external collaborator**. Gunakan **Convert to member** untuk mengembalikannya. Jika organisasi Anda menggunakan SSO, mereka perlu masuk melalui SSO setelahnya untuk mempertahankan akses. Anda juga dapat melakukan ini [melalui API](./programmatic-user-access-control#change-member-account-type-via-api).
- **Berbagi grup sumber daya atau repositori**: jika [undangan eksternal](./security-resource-groups#external-invitations) diaktifkan, admin grup sumber daya dapat mengundang pihak luar langsung ke Grup Sumber Daya, termasuk melalui **Bagikan dengan kolaborator eksternal** di halaman pengaturan repositori. Pengguna tersebut bergabung dengan peran organisasi `no_access` dan hanya mendapatkan Grup Sumber Daya tersebut.

Kolaborator eksternal tetap melewati kontrol akses organisasi Anda ([Resource Groups](./enterprise-resource-groups)).

> [!NOTE]
> Dengan [Managed SSO](./enterprise-advanced-sso), anggota internal diproseskan melalui penyedia identitas Anda (SCIM), sehingga pengguna yang diundang ke organisasi hanya dapat ditambahkan sebagai kolaborator eksternal.

