Hub documentation

Koleksi Grup Gating

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Koleksi Grup Gating

Fitur ini merupakan bagian dari paket Team & Enterprise.

Gating Group Collections memungkinkan organisasi untuk memberikan (atau menolak) akses ke semua model dan dataset dalam sebuah koleksi sekaligus, bukan per repo. Pengguna hanya perlu melewati satu permintaan akses.

Untuk mengaktifkan Gating Group dalam sebuah koleksi:

  • pemilik koleksi harus berupa organisasi
  • organisasi harus berlangganan paket Team atau Enterprise
  • semua model dan dataset dalam koleksi harus dimiliki oleh organisasi yang sama dengan koleksinya
  • setiap model atau dataset dalam koleksi hanya dapat menjadi bagian dari satu Gating Group Collection (namun, mereka masih dapat disertakan dalam koleksi non-gating, yaitu koleksi reguler).

Gating hanya berlaku untuk model dan dataset; sumber daya lain yang menjadi bagian dari koleksi (seperti Space atau Paper) tidak akan terpengaruh.

Kelola grup gating sebagai admin organisasi

Untuk mengaktifkan permintaan akses, buka halaman koleksi dan klik Gating group di sudut kanan bawah.

Hugging Face collection page with gating group collection feature disabled

Secara default, gating group dinonaktifkan: klik Configure Access Requests untuk membuka pengaturan

Hugging Face gating group collection settings with gating disabled

Secara default, akses ke repositori dalam koleksi diberikan secara otomatis kepada pengguna saat mereka memintanya. Hal ini disebut sebagai persetujuan otomatis. Dalam mode ini, pengguna mana pun dapat mengakses repositori Anda setelah mereka setuju untuk membagikan informasi kontak mereka kepada Anda.

Hugging Face gating group collection settings with automatic mode selected

Jika Anda ingin menyetujui secara manual pengguna mana yang dapat mengakses repositori dalam koleksi Anda, Anda harus menyetelnya ke Manual Review. Dalam kasus ini, Anda akan melihat opsi baru:

Frekuensi notifikasi, yang memungkinkan Anda mengatur kapan menerima notifikasi tentang pengguna baru yang meminta akses. Pengaturan ini dapat diatur menjadi sekali sehari atau real-time. Secara default, email dikirim ke 5 admin pertama organisasi. Anda juga dapat mengatur alamat email yang berbeda di kolom Email notifikasi.

Hugging Face gating group collection settings with manual review mode selected

Tinjau permintaan akses

Setelah permintaan akses diaktifkan, Anda memiliki kendali penuh atas siapa yang dapat mengakses repositori dalam koleksi grup gating Anda, baik mode persetujuan manual maupun otomatis. Anda dapat meninjau dan mengelola permintaan baik dari UI maupun melalui API.

Menyetujui permintaan untuk repo dalam kumpulan grup gating akan secara otomatis menyetujui akses ke semua repo (model dan dataset) dalam kumpulan tersebut.

Dari UI

Anda dapat meninjau siapa yang memiliki akses ke semua repositori dalam Gating Group Collection Anda dari halaman pengaturan salah satu repositori dalam koleksi tersebut, dengan mengklik tombol Review access requests:

Hugging Face repo access settings when repo is in a gating group collection

Ini akan membuka modal dengan 3 daftar pengguna:

  • pending: daftar pengguna yang menunggu persetujuan untuk mengakses repositori Anda. Daftar ini kosong kecuali Anda telah memilih Manual Review. Anda dapat Accept atau Reject setiap permintaan. Jika permintaan ditolak, pengguna tidak dapat mengakses repositori Anda dan tidak dapat meminta akses lagi.
  • accepted: daftar lengkap pengguna yang memiliki akses ke repositori Anda. Anda dapat memilih untuk Reject akses kapan saja untuk pengguna mana pun, baik mode persetujuan manual maupun otomatis. Anda juga dapat Cancel persetujuan, yang akan memindahkan pengguna ke daftar pending.
  • rejected: daftar pengguna yang Anda tolak secara manual. Pengguna-pengguna tersebut tidak dapat mengakses repositori Anda. Jika mereka membuka repositori Anda, mereka akan melihat pesan Your request to access this repo has been rejected by the repo’s authors.
Manage access requests modal for a repo in a gating group collection

Melalui API

Anda dapat mengelola permintaan akses secara programatik dalam Gated Group Collection melalui API dari salah satu model atau dataset-nya.

Kunjungi dokumentasi model bergerbang atau dataset bergerbang kami untuk mengetahui lebih lanjut tentang hal ini.

Unduh laporan akses

Anda dapat mengunduh laporan akses untuk Gated Group Collection melalui halaman pengaturan dari salah satu model atau dataset-nya.

Kunjungi dokumentasi model bergerbang atau dataset bergerbang kami untuk mengetahui lebih lanjut tentang hal ini.

Pilih data profil mana yang akan dikumpulkan

Secara default, Hugging Face membagikan nama pengguna dan alamat email utama pemohon kepada organisasi. Pada pengaturan grup gating, Anda dapat mengontrol hal tersebut dan mengubah informasi apa yang dibagikan Hugging Face kepada Anda. Pengaturan ini berlaku untuk semua repo dalam koleksi dan hanya memengaruhi permintaan baru.

Kunjungi dokumentasi model bergerbang atau dataset bergerbang kami untuk mengetahui lebih lanjut tentang hal ini.

Sesuaikan informasi yang diminta

Organisasi dapat menyesuaikan parameter gating serta informasi pengguna yang dikumpulkan per repo ber-gate. Silakan kunjungi dokumentasi model ber-gate atau dataset ber-gate kami untuk detail lebih lanjut.

Selain pengaturan data profil di atas, saat ini tidak ada cara untuk menyesuaikan parameter gerbang dan informasi yang diminta secara terpusat. Jika Anda ingin mengumpulkan data yang sama terlepas dari repositori koleksi mana pun yang diminta aksesnya oleh pengguna, Anda perlu menambahkan parameter gerbang yang sama di metadata semua model dan dataset dalam koleksi tersebut, serta menjaganya tetap sinkron.

Pengaturan lanjutan

Organisasi Enterprise Plus dapat secara otomatis menolak atau memblokir pengunjung dari lokasi tertentu di seluruh model dan dataset mereka. Pengaturan ini terdapat di pengaturan Publisher Analytics, di bawah tab Advanced Gating.

Penegakan

Pengaturan Enforcement mengontrol apa yang ditolak bagi pengunjung yang diblokir:

  • Repositori bergerbang: permintaan akses ke repositori bergerbang organisasi ditolak secara otomatis.
  • Semua repositori: selain menolak permintaan akses secara otomatis, unduhan ditolak di setiap repositori organisasi, termasuk yang publik. Pengunjung yang diblokir melihat pemberitahuan “tidak tersedia di wilayah Anda” di halaman repositori, dan penampil dataset dinonaktifkan untuk mereka.

Penerapan berlaku untuk pengunjung dari negara dan wilayah yang diblokir, terlepas dari apakah mereka masuk atau tidak. Anggota organisasi tidak dikecualikan.

Lokasi yang diblokir

Dua daftar mendefinisikan lokasi yang diblokir:

  • Negara yang diblokir: negara, diidentifikasi oleh kode ISO 3166-1 alpha-2 mereka.
  • Wilayah yang diblokir: wilayah-wilayah tertentu yang diblokir di samping negara-negara di atas, untuk wilayah yang bukan merupakan negara yang berdiri sendiri dan oleh karena itu tidak dapat dipilih dalam daftar di atas.

Akses repositori bergerbang dalam Koleksi Grup Penggerbang sebagai pengguna

Koleksi Grup Berpintu menampilkan ikon tertentu di samping namanya:

Hugging Face collection page with gating group collection feature enabled

Untuk mendapatkan akses ke model dan dataset dalam Gated Group Collection, cukup ajukan satu permintaan akses di halaman salah satu repositori tersebut. Setelah permintaan Anda disetujui, Anda akan dapat mengakses semua repositori lain dalam koleksi tersebut, termasuk yang ditambahkan di kemudian hari.

Kunjungi dokumentasi model bergerbang atau dataset bergerbang kami untuk mempelajari lebih lanjut tentang cara meminta akses ke repositori.

Update on GitHub