Hub documentation

Manajemen Pengguna

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Manajemen Pengguna

Fitur ini merupakan bagian dari paket Team & Enterprise.

Fitur-fitur berikut tersedia untuk organisasi dengan SSO yang diaktifkan. Lihat SSO Dasar dan SSO Terkelola 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 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 (mis. user.role atau groups). Untuk SAML, ini dapat berupa URI (mis. 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 untuk detail lebih lanjut.

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.

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

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

Fitur ini hanya relevan untuk Basic SSO. Dengan Managed 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.
  • Berbagi grup sumber daya atau repositori: jika undangan eksternal 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).

Dengan Managed SSO, anggota internal diproseskan melalui penyedia identitas Anda (SCIM), sehingga pengguna yang diundang ke organisasi hanya dapat ditambahkan sebagai kolaborator eksternal.

Update on GitHub