Kullanıcı erişim belirteçleri

Kullanıcı Erişim Jetonları Nedir?

User Access Tokens, bir uygulama veya notebook'un Hugging Face hizmetlerine kimlik doğrulaması için tercih edilen yöntemdir. Erişim jetonlarınızı ayarlar bölümünden yönetebilirsiniz.

Erişim jetonları, uygulamaların ve defterlerin aşağıda gösterilen rollerin kapsamı tarafından belirlenen belirli işlemleri gerçekleştirmesine olanak tanır:

• fine-grained: Bu roldeki jetonlar, belirli bir model veya belirli bir organizasyondaki modeller gibi spesifik kaynaklara ince tanimli erişim sağlamak için kullanılabilir. Bu tür jetonlar, tüm kaynaklarınıza erişimi paylaşmadan kendi jetonunuzu kullanabilmeniz sayesinde üretim ortamlarında faydalıdır.

• read: Bu role sahip jetonlar, yalnızca okuyabildiğiniz depolara okuma erişimi sağlamak için kullanılabilir. Bunlar, sizin veya üyesi olduğunuz bir kuruluşun sahip olduğu herkese açık ve özel depoları içerir. Hugging Face Hub'dan yalnızca içerik okumanız gerekiyorsa (ör. özel modelleri indirme veya çıkarım yapma) bu role kullanın.

• write: Bu role sahip jetonlar, yazma erişimine sahip olduğunuz depolara ek olarak yazma erişimi de sağlar. Bir depoya içerik oluşturmanız veya göndermeniz gerektiğinde (örneğin, bir model eğitirken veya bir model kartını değiştirirken) bu jetonu kullanın.

Bir organizasyonun okuma/yazma/yönetici rolüne sahip bir üyesiyseniz, Kullanıcı Erişim Jetonlarınız, jeton iznine (okuma/yazma) ve organizasyon üyeliğine (okuma/yazma/yönetici) göre kaynakları okuyabilir/yazabilir.

Kullanıcı Erişim Belirteçleri nasıl yönetilir?

Erişim belirteci oluşturmak için ayarlarınıza gidin ve ardından Erişim Belirteçleri sekmesine tıklayın. Yeni bir Kullanıcı Erişim Belirteci oluşturmak için Yeni belirteç düğmesine tıklayın.

Bir rol ve bir ad seçin ve işte - hazırsınız!

Yönet düğmesine tıklayarak Kullanıcı Erişim Belirteçlerini silebilir ve yenileyebilirsiniz.

User Access Tokens nasıl kullanılır?

Hugging Face Hub'a erişmek için bir User Access Token kullanmanın birçok yolu vardır; bu da üzerinde harika uygulamalar geliştirmek için ihtiyacınız olan esnekliği sağlar.

Kullanıcı Erişim Jetonları şunlar olabilir:

• git veya temel kimlik doğrulama ile Hugging Face Hub'a erişmek için parola yerine kullanıldı.
• Inference Providers çağrılırken bearer token olarak geçirilir.
• transformers veya datasets gibi Hugging Face Python kütüphanelerinde kullanılır:

from transformers import AutoModel

access_token = "hf_..."

model = AutoModel.from_pretrained("private/model", token=access_token)

Tokeninizi sızdırmamaya çalışın! Her zaman döndürebilirsiniz, ancak bu sırada herkes özel depolarınızı okuyabilir veya yazabilir ki bu 💩 Bir token sızdırıldıysa Sızdırılan bir tokeni iptal etme bölümüne bakın.

En iyi uygulamalar

Her uygulama veya kullanım için ayrı bir erişim jetonu oluşturmanızı öneririz. Örneğin, aşağıdakiler için ayrı jetonlar oluşturabilirsiniz:

• Yerel bir makine.
• Bir Colab defteridir.
• Harika bir özel çıkarım sunucusu.

Bu şekilde, diğer kullanımlarınızı etkilemeden tek bir belirteci geçersiz kılabilirsiniz.

Üretim ortamında yalnızca ince taneli (fine-grained) jetonların kullanılmasını da öneririz. Sızdırılması durumunda etki azalır ve bu jetonlar hesabınızı etkilemeden organizasyonunuz içinde paylaşılabilir.

Örneğin, üretim uygulamanız bir gated model için okuma erişimi gerektiriyorsa, organizasyonunuzun bir üyesi modele erişim talep edebilir ve ardından bu modele okuma erişimi olan ince tanecikli bir token oluşturabilir. Bu token, uygulamanıza tüm özel modellerinize erişim vermeden üretim uygulamanızda kullanılabilir.

CI/CD hatları için

Erişime yalnızca bir CI/CD iş akışından (GitHub Actions, GitLab CI, CircleCI, …) ihtiyacınız varsa, bir erişim jetonunu CI gizli bilgisi olarak saklamaktan tamamen kaçınabilirsiniz. Her çalıştırmanın başında CI sağlayıcınızın OpenID Connect (OIDC) kimlik jetonunu kısa ömürlü bir Hub jetonuyla değiştiren Güvenilir Yayıncılar bölümüne bakın; bu jeton, model, veri seti, Space veya çekirdek yayınlamak veya bunları salt okunur olarak çekmek için depo kapsamına (repo-scoped) veya erişiminiz olan gated depoları okumak ve hesabınızın hız sınırlarını almak için kullanıcı kapsamına (user-scoped) sahip olabilir.

Kurumsal kuruluşlar için

Kurumunuz, her kullanıcının kendi belirteci oluşturmasını gerektirmeden üyelere programatik olarak belirteç dağıtmak gerekiyorsa, OAuth Token Exchange bölümüne bakın. Bu Enterprise planı özelliği, kurum üyeleri adına Hugging Face kaynaklarına erişmesi gereken dahili platformlar, CI/CD hatları veya özel entegrasyonlar oluşturmak için idealdir.

Sızdırılan bir jetonu iptal etme

Kendi belirteçlerinizden biri sızdıysa, ayarlarınızın Erişim Belirteçleri sekmesinden silin veya yenileyin.

Başkasına ait bir Hugging Face erişim anahtarı bulduysanız, POST /api/credentials/revoke uç noktası ile geçersiz kılabilirsiniz. Anahtarın sahibi olan hesap veya kuruluş üzerinde herhangi bir yetkiniz olmasına gerek yoktur.

# LEAKED_HF_TOKEN should contain the raw token value to revoke
curl -X POST "https://huggingface.co/api/credentials/revoke" \
  -H "Content-Type: application/json" \
  -d "{\"credentials\": [\"${LEAKED_HF_TOKEN}\"]}"

Tek bir çağrıda credentials dizisine birden fazla token değeri geçebilirsiniz; bu, bulguları toplu olarak raporlayan gizli tarama hatları için kullanışlıdır.

Gönderilen ve mevcut bir token ile eşleşen her token anında geçersiz kılınır ve her yerde çalışmayı durdurur — tek bir organizasyona erişimi kesen organizasyon düzeyinde iptal işleminden farklı olarak. Token sahibi e-posta ile bilgilendirilir ve erişimi yeniden sağlamak için yeni bir token oluşturmalıdır.

Uç nokta, gönderdiğiniz jetonlardan herhangi birinin var olup olmadığına bakılmaksızın her zaman 202 Accepted yanıtı verir; bu nedenle yanıtı, bir jetonun geçerli olup olmadığını sorgulamak için kullanılamaz. Aynı jetonu tekrar göndermek zararsızdır: tekrarlanan çağrılar hiçbir şey yapmaz ve sahip yalnızca bir kez bilgilendirilir.

Kabuk geçmişinde veya günlüklerde token değerlerinin sızmasını önlemek için bunları ortam değişkenleri veya dosyalar aracılığıyla iletin ve ham tokenleri doğrudan komut satırlarına yapıştırmaktan kaçının.

Token yönetimi politikalarına sahip organizasyonlardaki jetonlar

Team ve Enterprise planlarındaki kuruluşlar, o kuruluşun kaynaklarına erişirken tokenlarınızın nasıl çalışacağını etkileyen token politikaları uygulayabilir.

Tokenınız onay gerektirdiğinde (Team & Enterprise kuruluşları)

Bir organizasyona özel, yönetici onayı gerektiren ince tanecikli bir belirteç oluşturduğunuzda, belirteç otomatik olarak Pending durumuna geçer. Bir yönetici onaylayana kadar bu belirteç, ilgili organizasyonun kaynaklarına erişemez. Belirteciniz onaylandığında veya reddedildiğinde e-posta bildirimi alırsınız.

Durumu, token listeniz sayfasından kontrol edebilirsiniz; bekleyen bir token, izin rozetinin yanında turuncu bir kum saati simgesi gösterirken, reddedilen veya iptal edilen bir token kırmızı bir ünlem simgesi gösterir. Tokenınız reddedildi veya iptal edildi ise, tokenın düzenleme sayfasında da kırmızı bir hata bandı görünür.

Bir organizasyon yöneticisiyseniz, o organizasyona kapsamı daraltılmış olarak oluşturduğunuz ince tanecikli jetonlar otomatik olarak onaylanır — bir inceleme adımı gerekmez.

Tokenınız reddedildiğinde (Team & Enterprise kuruluşları)

Tokenınız reddedilirse, bir e-posta bildirimi alırsınız. Token hesabınızda kalır ve organizasyon dışındaki kaynaklar için hâlâ kullanılabilir. Reddedilen bir token, daha sonra bir yönetici tarafından onaylanabilir ve yeni bir token oluşturmanıza gerek kalmadan erişim yeniden sağlanır.

Organizasyon kaynaklarına karşı reddedilmiş bir jeton kullanmaya çalıştığınızda 403 hatası alırsınız.

Tokeniniz iptal edildiğinde (Enterprise kuruluşları)

İptal kalıcıdır. Reddedilmenin aksine, iptal edilen bir jeton geri alınamaz. Jetonunuz iptal edildiyse, onu silip yeni bir tane oluşturmanız gerekir. Örgüt yönetici onayı gerektiriyorsa, yeni jeton bekleyen durumunda başlar.

Devredilen bir token'ı organizasyon kaynaklarına karşı kullanmaya çalıştığınızda, şu mesajla birlikte bir 403 hatası alırsınız: “Token'ınız organizasyon yöneticisi tarafından devredildi, artık organizasyon kaynaklarına erişemezsiniz. Daha fazla bilgi için lütfen onlarla iletişime geçin.”

İptal işlemi yalnızca iptal eden organizasyonu etkiler. Jeton, kapsamına dahil olduğu diğer tüm kaynaklar için normal şekilde çalışmaya devam eder.

Örgütünüz yalnızca ince tanecikli jetonlara izin verdiğinde (Team & Enterprise örgütleri)

Kurumunuz ince tanecikli token'ları zorunlu kılan bir politika belirlediyse, okuma/yazma token'ları o kurumun kaynaklarına karşı kullanıldığında 403 hatasıyla reddedilir.