Hub documentation
Hizmet Hesapları
Hizmet Hesapları
Bu özellik, Enterprise ve Enterprise Plus planlarının bir parçasıdır.
Service accounts, CI/CD pipeline'leri, otomasyon betikleri ve backend entegrasyonları gibi organizasyonunuzun kaynaklarına programatik erişim için tasarlanmış, organizasyona ait kimliklerdir. Kişisel bir üye hesabının aksine, bir service account belirli bir kişiye bağlı değildir; organizasyona aittir ve yöneticileri tarafından yönetilir.
Bir hizmet hesabı herhangi bir bireyden bağımsız olduğu için, kişiler organizasyona katıldıkça veya ayrıldıkça otomatik iş akışlarının çalışmaya devam etmesini sağlar ve herhangi bir üyenin kişisel jetonlarını etkilemeden kimlik bilgilerini kapsamını daraltmanıza ve döndürmenize olanak tanır.
Hizmet Hesabı Oluşturma
Bir organizasyon yöneticisi olarak, hizmet hesaplarını oluşturmak ve yönetmek için organizasyon ayarlarınızın Hesaplar bölümüne gidin.

Bir hizmet hesabı oluştururken şunları sağlarsınız:
- Hizmet hesabını tanımlamak için bir ad.
- Hizmet hesabının ne için kullanıldığını belgelemek için isteğe bağlı bir description.
Hizmet hesaplarının şifresi yoktur ve etkileşimli olarak oturum açamazlar; yalnızca bunlar için çıkardığınız erişim jetonları üzerinden erişilir. Normal kullanıcılardan farklı olarak bir HF profil sayfasına sahip değillerdir, organizasyonun üye listesinde yer almazlar ve yalnızca Hizmet Hesapları ayarları üzerinden yönetilirler.
Erişim Belirteçlerini Yönetme
Bir hizmet hesabının organizasyonunuza erişimi, tamamen ona verdiğiniz ince tanımlı erişim belirteçleri tarafından belirlenir. Her belirteç için bir ad ve ince tanımlı izinler kümesi seçersiniz; böylece belirli bir iş akışının yalnızca ihtiyaç duyduğu erişimi verebilirsiniz.
İzinler iki düzeyde verilebilir:
- Örgüt genelinde — bir izni (örneğin, depo içeriğine okuma veya yazma erişimi) organizasyondaki tüm depolara uygulayın.
- Depo bazında — okuma veya yazma erişimini yalnızca belirli depolara sınırlayın. Jetonun uygulanacağı depoları arayın ve seçin, ardından vereceğiniz izinleri belirleyin. Seçilen depoların organizasyona ait veya herkese açık olması gerekir.
Bu, tüm organizasyona erişim vermek yerine, dar kapsamlı jetonlar oluşturmanızı sağlar; örneğin, yalnızca tek bir model deposunu okuyabilen bir jeton.

Hizmet hesabının sayfasından yöneticiler şunları yapabilir:
- Oluştur seçilen bir ad ve ince ayarlı izinlerle yeni bir erişim belirteci.
- Mevcut bir jetonun adını veya izinlerini güncelleyin.
- Bir belirteci döndürerek yeni bir değerle değiştirin. Önceki belirteç anında devre dışı kalır; bu, bir kimlik bilgisi ifşa edilmiş olabileceğinde faydalıdır.
- Bir jetonu silerek erişimini kalıcı olarak iptal edin.
Erişim jetonu yalnızca oluşturulduğunda veya döndürüldüğünde bir kez görüntülenir. Güvenli bir şekilde saklayın — daha sonra geri alınamaz. Kaybederseniz, yeni bir değer oluşturmak için jetonu döndürün.
S3 Kimlik Bilgileri Oluşturma
Hizmet hesabı jetonları, S3-uyumlu API üzerinden organizasyonunuzun Storage Buckets’lerine erişmek için kullanılabilir. Geçit, bir hizmet hesabı jetonundan türetilen AWS tarzı erişim anahtarlarıyla kimlik doğrulaması yapar.
Hizmet hesabının sayfasına gidin. Henüz bir tokenınız yoksa Create new token düğmesiyle token oluşturun. Tokenın izinleri, S3 kimlik bilgilerinin izinleri olur.
Listedeki belirteci bulun, açılır menüsünü açın ve S3 kimlik bilgileri oluştur seçeneğini seçin.

Oluşturulan erişim anahtar kimliğini (
HFAK…önekiyle) ve gizli erişim anahtarını güvenli bir yere kopyalayın — gizli anahtar yalnızca bir kez görüntülenir. Kaybederseniz, yeni bir çift oluşturmak için S3 kimlik bilgilerini geçersiz kıl ve yenile seçeneğini kullanın. Önceki erişim anahtarı derhal çalışmayı durdurur.
S3 kimlik bilgileri, altındaki erişim jetonunun izinlerini devralır. Jetonu yalnızca kullanmayı planladığınız varlıklara (bucket) daraltın.
Eşleşmeyi token'ı silmeden devre dışı bırakmak için S3 kimlik bilgilerini iptal et seçeneğini kullanın — token'ın (veya hizmet hesabının) silinmesi, S3 kimlik bilgilerini de iptal eder. Hizmet hesabının sayfası, her token ile şu anda eşleşen erişim anahtarını gösterir.
Uç nokta URL’sinde <namespace> olarak organizasyon adınızı kullanın (bkz. İstemcisi Yapılandırma). S3 kimlik bilgilerini oluşturma ve iptal etme işlemleri, organizasyonun Denetim Kayıtlarında kaydedilir.
Bir token için Network Security exemption etkinleştirildiyse, S3 kimlik bilgilerini yalnızca organizasyon yöneticileri oluşturabilir.
Ağ Güvenliği muafiyeti
Bu seçenek, Enterprise Plus planının bir parçasıdır.
Organizasyonunuz Network Security ayarlarını kullanıyorsa, hizmet hesabı jetonları diğer tüm kimlik bilgileri gibi bu ayarlara tabidir: yalnızca organizasyonunuzun IP aralıklarından çalışırlar ve erişebilecekleri içerikler için Content Access Policy geçerlidir.
Bazı otomatik iş akışları kurumsal ağınızın dışında çalışır; örneğin, bir bulut sağlayıcısı tarafından barındırılan bir CI işi. Bu tür durumlarda, token formundaki Bypass IP restrictions and the Content Access Policy seçeneğiyle belirli bir token’ı organizasyonunuzun Network Security uygulamasından muaf tutabilirsiniz.
Etkinleştirildiğinde:
- Token, Organizasyon erişimini yalnızca IP aralıklarınıza kısıtlayın seçeneği etkin olsa bile herhangi bir IP adresinden çalışır.
- Token, kuruluşunuzun İçerik Erişim Politikası tarafından aksi halde engellenecek içeriğe erişebilir.
- Muafiyet yalnızca kendi organizasyonunuzun Ağ Güvenliği ayarlarına uygulanır. Başka bir organizasyonun politikasını asla atlamaz.
- Token, hizmet hesabının sayfasında IP kısıtlaması yok rozetiyle listelenir.
- Token'ın döndürülmesi muafiyeti korur.
Yalnızca organizasyon yöneticileri muafiyeti etkinleştirebilir veya zaten muaf olan bir belirteci döndürebilir.
Muaf bir token, ağ çevreniz tarafından artık korunmadığı için, erişebildiği kaynakları koruyan tek kimlik bilgisi tokenın kendisi olur. Tokenı mümkün olan en küçük depo kümesine daraltmanızı, yalnızca okuma yetkisinin yeterli olduğu durumlarda bu yetkiyi vermenizi ve tokenı düzenli olarak yenilemenizi öneririz.
Faturalandırma
Hizmet hesapları, organizasyonunuzda faturalandırılabilir üye olarak sayılmaz; bu nedenle oluşturulmaları, planınızdaki ücretli bir koltuğu tüketmez.
Update on GitHub