Manajemen Token

Fitur ini merupakan bagian dari paket Team & Enterprise.

Tokens Management memungkinkan administrator organisasi untuk mengawasi token akses di dalam organisasi mereka, memastikan akses yang aman ke sumber daya organisasi.

Untuk pengalaman anggota saat kebijakan manajemen token berlaku — termasuk cara memeriksa status token, kesalahan yang mungkin terjadi, serta bagaimana penolakan dan pencabutan memengaruhi token — lihat Tokens in organizations with token management policies.

Melihat dan Mengelola Token Akses

Fitur daftar token menampilkan semua token akses dalam organisasi Anda. Administrator dapat:

• Pantau penggunaan token dan identifikasi atau cegah potensi risiko keamanan:
  • Akses tidak sah ke sumber daya privat (“kebocoran”)
  • Cakupan akses yang terlalu luas
  • Higiene token yang tidak optimal (misalnya, token yang tidak dirotasi dalam waktu yang lama)
• Identifikasi token yang tidak aktif atau tidak digunakan

Token bergranularitas halus menampilkan izin spesifiknya:

Token yang dicabut disembunyikan dari daftar secara default. Gunakan pengalih Tampilkan token yang dicabut di atas daftar untuk menyertakannya dalam tampilan.

Lencana status REVOKED ditampilkan untuk setiap token yang dicabut, terlepas dari kebijakan token organisasi. Lencana PENDING, APPROVED, dan DENIED hanya muncul di organisasi yang mengaktifkan kebijakan “Require administrator approval”, karena status-status tersebut hanya dibuat oleh alur persetujuan.

Kebijakan Token

Administrator organisasi Team & Enterprise dapat menerapkan kebijakan berikut:

Meninjau Otorisasi Token

Ketika kebijakan token diatur ke “Require administrator approval”, administrator organisasi dapat meninjau detail semua token fine-grained yang mengakses sumber daya milik organisasi serta menyetujui atau menolak akses. Ketika token baru masuk ke status pending, hingga 50 administrator organisasi dengan alamat email yang terkonfirmasi akan menerima notifikasi dengan tautan langsung ke halaman peninjauan token. Tidak ada notifikasi yang dikirim ketika token disetujui secara otomatis (misalnya, karena pembuatnya adalah admin organisasi).

• Token Menunggu sedang menunggu keputusan administrator
• Token Disetujui telah diotorisasi dan aktif
• Token Denied telah diblokir dari mengakses sumber daya organisasi

Ketika sebuah token disetujui atau ditolak, pemilik token menerima notifikasi email.

Penolakan tidak bersifat permanen: token yang ditolak dapat disetujui kemudian oleh administrator, yang akan memulihkan aksesnya. Demikian pula, token yang sudah disetujui dapat ditolak kapan saja, yang akan menghapus akses berbasis persetujuannya secara segera.

Nama token hanya terlihat oleh administrator ketika kebijakan “Require administrator approval” diaktifkan.

Apa yang Dilihat Anggota Saat Diblokir

Anggota yang tokennya masih tertunda atau ditolak akan menerima error 403 saat mengakses sumber daya organisasi: “Karena kebijakan token organisasi, token Anda perlu disetujui oleh organisasi sebelum Anda dapat mengakses sumber daya ini.”

Pesan kesalahan sama untuk status pending dan denied. Untuk melihat statusnya, anggota dapat menavigasi ke halaman edit token individu. Halaman pengaturan manajemen token administrator organisasi menampilkan lencana status untuk semua token anggota.

Menolak vs. Mencabut

Administrator memiliki dua cara untuk menghapus akses token ke organisasi:

Gunakan deny saat mengelola akses dalam alur kerja persetujuan (token beralih ke status denied dan dapat disetujui kembali nanti). Gunakan revoke saat Anda perlu memutus akses token ke organisasi secara permanen.

Mencantumkan Token melalui API

Daftar token yang ditampilkan di antarmuka pengaturan juga tersedia secara programatik:

# ORG_NAME should be your organization name and ADMIN_HF_TOKEN an admin's access token
curl -H "Authorization: Bearer ${ADMIN_HF_TOKEN}" \
  "https://huggingface.co/api/organizations/${ORG_NAME}/settings/tokens"

Responsnya adalah array dari token akses anggota. Lihat referensi OpenAPI untuk skema lengkap: GET /api/organizations/<name>/settings/tokens

Secara default, token yang dicabut disembunyikan; berikan q=status:all untuk menyertakannya, seperti toggle Tampilkan token yang dicabut di UI.

Mencabut Token

Fitur ini merupakan bagian dari paket Enterprise dan di atasnya.

Administrator organisasi dapat mencabut token akses anggota mana pun dari halaman detail token. Pencabutan tersedia terlepas dari apakah organisasi menggunakan kebijakan “Require administrator approval” atau tidak. Token yang dicabut tidak lagi dapat mengakses sumber daya organisasi, tetapi tetap berfungsi di tempat lain. Pemilik token menerima notifikasi email saat pencabutan dilakukan.

Token yang dicabut tetap berstatus dicabut meskipun kebijakan token organisasi kemudian diubah atau dinonaktifkan. Pencabutan bersifat permanen di tingkat organisasi — tidak ada tindakan untuk membatalkan pencabutan. Jika seorang anggota membutuhkan akses yang dipulihkan, mereka harus menghapus token yang dicabut dan membuat token baru. Jika organisasi menggunakan kebijakan “Require administrator approval”, token baru akan berstatus pending dan memerlukan persetujuan admin.

Anggota yang tokennya telah dicabut akan menerima error 403 dengan pesan: “Token Anda telah dicabut oleh administrator organisasi, Anda tidak lagi dapat mengakses sumber daya organisasi. Silakan hubungi mereka untuk informasi lebih lanjut.” Pesan ini ditampilkan terlepas dari apakah organisasi menggunakan kebijakan “Require administrator approval”.

Mencabut melalui API

Administrator juga dapat mencabut token secara programatik menggunakan id token. Hal ini berguna untuk alur kerja otomatis, di mana token perlu dicabut segera.

# ORG_NAME should be your organization name and ADMIN_HF_TOKEN an admin's access token
# TOKEN_ID is the 24-character id shown on the org token settings page (or returned by the tokens listing API)
curl -X POST "https://huggingface.co/api/organizations/${ORG_NAME}/settings/tokens/${TOKEN_ID}/revoke" \
  -H "Authorization: Bearer ${ADMIN_HF_TOKEN}"

Administrator tidak dapat mencabut token miliknya sendiri: permintaan yang id token-nya cocok dengan token yang digunakan untuk autentikasi akan ditolak dengan error 403.

Endpoint ini hanya mencabut akses token ke organisasi Anda; token tetap berfungsi untuk sumber daya lain milik pemiliknya. Untuk membatalkan token yang bocor di mana pun, gunakan POST /api/credentials/revoke sebagai gantinya, yang tidak memerlukan autentikasi dan menerima kumpulan nilai token mentah.

Penerbitan Token Secara Programatik

Fitur ini merupakan bagian dari paket Enterprise dan di atasnya.

Untuk organisasi yang perlu menerbitkan token akses secara programatik untuk anggotanya (misalnya, untuk platform internal, pipeline CI/CD, atau integrasi kustom), lihat OAuth Token Exchange. Fitur rencana Enterprise ini memungkinkan layanan backend Anda untuk menerbitkan token berscope untuk anggota organisasi tanpa memerlukan persetujuan pengguna interaktif.

Akun Layanan

Fitur ini merupakan bagian dari paket Enterprise dan di atasnya.

Untuk akses otomatis yang dimiliki oleh organisasi alih-alih anggota individu, administrator dapat membuat Service Accounts dan menerbitkan token bergranularitas halus yang di-scope ke sumber daya organisasi Anda.