Yönetici anahtarları, yetkili çalışma alanı sahiplerinin ve yöneticilerinin araç ve hizmetleri desteklenen ChatGPT ve Codex yönetim API'lerine bağlamasını sağlar. Bir anahtar, seçtiğiniz çalışma alanına ve izinlere bağlı olarak analizleri, kullanıcı ve grup yönetimini, davetleri, kullanım sınırlarını, uyumluluk ve etkinlik günlüklerini veya hizmet hesabı yönetimini destekleyebilir.

Her Yönetici anahtarı tek bir ChatGPT çalışma alanı için geçerlidir. Diğer çalışma alanlarına, kiracı genelindeki yönetime, API Platformu kuruluşlarına, Ads hesaplarına, modellere veya model çıkarımına erişim sağlamaz.

Kiracınızı veya çalışma alanınızı seçme konusunda yardım için bkz. Yönetici Konsolu'nda kiracınızı yönetme.

Çalışma alanının kullanılabilirliğini ve erişimi kontrol edin

Yönetici anahtarları; ChatGPT Enterprise, ChatGPT Edu ve ChatGPT for Healthcare çalışma alanları dâhil olmak üzere uygun, yönetilen ChatGPT çalışma alanlarında kullanılabilir. Yönetmek istediğiniz çalışma alanında Sahip veya Yönetici rolüne sahip olmanız gerekir.

Erişim, seçili ChatGPT çalışma alanında atanan Sahip veya Yönetici rolüne bağlıdır. Genel yönetici, API Platformu kuruluş sahibi veya özel bir çalışma alanı rolüne sahip kullanıcı olmak tek başına Yönetici anahtarı erişimi sağlamaz.

Yerleşik çalışma alanı rolleri hakkında ayrıntılı bilgi için bkz. Üyeleri, çalışma alanı rollerini ve lisansları yönetme.

Role göre erişimi anlayın

• Çalışma alanı sahipleri Tümü, Salt okunur veya Özel izinlere sahip anahtarlar oluşturabilir. Çalışma alanlarındaki tüm Yönetici anahtarlarını düzenleyebilir veya iptal edebilirler.

• Çalışma alanı yöneticileri, her izin kategorisi için mevcut erişim düzeyini seçerek özel kapsamlı anahtarlar oluşturur. Oluşturulan anahtar Özel olarak etiketlenir. Yalnızca kendilerinin oluşturduğu anahtarları ve ancak anahtarın izinleri mevcut rolleri tarafından kullanılabiliyorsa düzenleyebilir veya iptal edebilirler.

• Seçili çalışma alanında Sahip veya Yönetici rolüne sahip olmayan genel yöneticiler, bu çalışma alanının Yönetici anahtarlarını oluşturamaz veya yönetemez.

Yönetici anahtarı izinlerini seçin

Çalışma alanı sahibi izin ön ayarları

Çalışma alanı sahipleri şu izin ön ayarlarından birini seçebilir:

• Tümü, mevcut olduğunda yalnızca çalışma alanı sahiplerine sunulan izinler de dâhil olmak üzere seçili çalışma alanındaki mevcut yönetici izinlerini verir.

• Salt okunur, seçili çalışma alanındaki mevcut salt okunur izinleri verir.

• Özel, her izin kategorisi için mevcut erişim düzeyini seçmenizi sağlar.

Kategoriye göre yönetici izinleri

Çalışma alanı yöneticileri Tümü, Salt okunur veya Özel ön ayar seçicisini görmez. İzinler altında, kullanılabilir her kategori için Yok, Okuma veya Yazma seçeneğini belirlerler. Oluşturulan anahtar Özel olarak etiketlenir.

Çalışma alanınıza bağlı olarak mevcut kategoriler arasında Uygulamalar, Kullanım sınırları, Grup Yönetimi, Kullanıcılar, Davetler, Codex analiz API'si, Enterprise analiz API'si, Çalışma alanı analizleri, Maliyetler ve Hizmet hesapları bulunabilir. Bazı kategoriler yalnızca Okuma veya Yazma seçeneğini destekler; bazılarıysa yalnızca ilgili özellik kullanılabildiğinde görünür.

Yaygın izin eşlemeleri şunlardır:

• Codex analiz API'si > Okuma: codex.enterprise.analytics.read.

• Kullanım sınırları > Okuma: chatgpt.enterprise.usage_limit.read.

• Kullanım sınırları > Yazma: chatgpt.enterprise.usage_limit.write ve chatgpt.enterprise.usage_limit.read.

• Kullanıcılar > Okuma: mevcut olduğunda chatgpt.enterprise.user.read.

Geniş kapsamlı uyumluluk izinleri, Konuşma mesajları ve Roller ve izinler, desteklendiğinde yalnızca çalışma alanı sahipleri tarafından kullanılabilir. Çalışma alanı yöneticileri, denetim veya kimlik doğrulama günlükleri gibi ayrı etkinlik günlüğü kategorilerini yine de seçebilir.

Grup yönetimi izinleri

Uygun bir ChatGPT çalışma alanında Gruplar Yönetici API'si ile grup oluşturmak, güncellemek veya silmek için o çalışma alanına ait bir Yönetici anahtarı kullanın.

Anahtar izinlerini seçerken Grup Yönetimi sayfasını inceleyin ve uç noktanın gerektirdiği izinleri verin. Salt okunur bir anahtar, grup değişikliklerine yetki vermez.

Yalnızca grup yöneticisi olarak atanmak, Yönetici anahtarları oluşturma veya Gruplar Yönetici API'sini kullanma izni vermez. Yalnızca çalışma alanı sahipleri ve yöneticileri Yönetici anahtarları oluşturabilir; API istekleri, gerekli izinlere sahip bir anahtar gerektirir.

Yetki devredilmiş grup yönetimi için bkz. Grupları ve grup yöneticilerini yönetme.

Uç nokta yolları, desteklenen işlemler, istek alanları ve gerekli kapsamlar için Yönetici API'si referansına bakın. Senkronize grupları kimlik sağlayıcınızın SCIM iş akışı üzerinden yönetin. Senkronizasyonla ilgili yönergeler için bkz. SCIM ile kaynak sağlama ve yönetim.

Yönetici anahtarı oluşturun

1. Yönetici Konsolu'nda oturum açın.

2. Gerekirse kiracınızı, ardından Sahip veya Yönetici rolüne sahip olduğunuz ChatGPT çalışma alanını seçin.

3. Kimlik Bilgileri'ni açın, ardından Yönetici anahtarları'nı seçin.

4. Yeni yönetici anahtarı oluştur'u seçin ve açıklayıcı bir ad girin.

5. Bir sona erme süresi seçin: Hiçbir zaman, 30 gün, 60 gün, 90 gün veya Özel. Özel sona erme süresi 1 ile 365 gün arasında olabilir.

6. Entegrasyonunuzun ihtiyaç duyduğu izinleri seçin. Çalışma alanı sahipleri Tümü, Salt okunur veya Özel seçeneğini belirleyebilir; çalışma alanı yöneticileri ise her kategori için mevcut izni seçer.

7. Gönder'i seçin, ardından gizli anahtarı kopyalayıp güvenli bir yerde saklayın. Gizli anahtarı tekrar görüntüleyemezsiniz.

Çalışma alanı sahibi anahtarlarında varsayılan olarak Tümü izinleri, sona erme içinse Hiçbir zaman seçilebilir. Anahtarı oluşturmadan önce her iki ayarı da gözden geçirin.

Bir Yönetici anahtarını inceleyin, düzenleyin veya iptal edin

Yönetici Konsolu'nda ChatGPT çalışma alanını açın, ardından Kimlik Bilgileri > Yönetici anahtarları'na gidin. Her anahtarın adını, durumunu, izleme kimliğini, gizlenmiş gizli değerini, oluşturan kişiyi, izinlerini, son kullanım tarihini ve sona erme tarihini inceleyin.

• Bir anahtarın adını veya izinlerini değiştirmek için diğer seçenekler menüsünü (•••) açın, Düzenle'yi seçin, değişikliklerinizi yapın ve Değişiklikleri kaydet'i seçin.

• Bir anahtarı kullanmayı durdurmak için diğer seçenekler menüsünü (•••) açın, İptal et'i seçin ve Yönetici anahtarını iptal et ile onaylayın.

Çalışma alanı sahipleri, seçili çalışma alanındaki tüm anahtarları düzenleyebilir veya iptal edebilir. Çalışma alanı yöneticileri yalnızca kendilerinin oluşturduğu anahtarları ve ancak anahtarın izinleri mevcut rolleri tarafından kullanılabiliyorsa düzenleyebilir veya iptal edebilir. Yalnızca çalışma alanı sahiplerine sunulan izinlere sahip anahtarları bir çalışma alanı sahibinin yönetmesini isteyin. Mevcut sona erme tarihleri değiştirilemez.

İptal edilen anahtarlar, değişiklik yürürlüğe girdikten sonra çalışmayı durdurur. Hâlâ kullanılan bir anahtarı iptal etmeden önce yerine yeni bir anahtar oluşturun ve etkilenen tüm entegrasyonları güncelleyin.

Uyumluluğu ve hassas verileri anlayın

Bazı Yönetici anahtarı izinleri, hassas çalışma alanı etkinliklerini veya içeriklerini açığa çıkarabilir. Geniş kapsamlı uyumluluk erişimi veya Konuşma mesajlarına erişim iznini yalnızca çalışma alanı sahipleri verebilir.

Çalışma alanı yöneticileri; denetim, kimlik doğrulama veya uygulama günlükları dâhil olmak üzere desteklenen ayrı günlük kategorilerine erişim verebilir. Her kategoriyi dikkatle inceleyin; ayrı günlükler de hassas bilgiler içerebilir.

Uyumluluk API'leri ve veri erişimi hakkında bilgi için bkz. Enterprise ve Edu Müşterileri için OpenAI Uyumluluk Platformu.

ChatGPT çalışma alanı Yönetici API'si istekleri https://api.chatgpt.com/v1 adresini kullanır. Örneğin mevcut çalışma alanı üyelerini listelemek için /manage/workspaces/{workspace_id}/users yolunu kullanın. /v1/organization/ altındaki uç noktalar API Platformu kuruluşlarını yönetir ve bir API Platformu kuruluşu Yönetici anahtarı gerektirir.

Uç nokta yolları, istek ve yanıt şemaları ile gerekli kapsamlar için Yönetici API'si referansına bakın.

Yönetici anahtarlarını diğer kimlik bilgilerinden ayırt edin

• Çalışma alanı Yönetici anahtarları, tek bir ChatGPT çalışma alanına yönelik desteklenen ChatGPT ve Codex yönetim API'lerinde kimlik doğrulaması sağlar. Model çıkarımına erişim sağlamazlar.

• Codex hizmet hesabı erişim belirteçleri, Codex otomasyonu için insan olmayan bir çalışma alanı kimliğinin doğrulanmasını sağlar. Yönetici API'si isteklerinde kimlik doğrulaması sağlamazlar. Kurulum yönergeleri için bkz. Codex hizmet hesapları oluşturma ve yönetme.

• API Platformu kuruluşu Yönetici anahtarları API Platformu'nda ayrı olarak yönetilir ve ChatGPT çalışma alanlarını yönetmez.

Bir API Platformu kuruluşu için anahtara ihtiyacınız varsa API Platformu kuruluşu Yönetici anahtarları sayfasını açın. Çalışma alanına özel ChatGPT Yönetici API'si uç noktalarını bir çalışma alanı Yönetici anahtarıyla kullanın; API Platformu kuruluşu uç noktaları ayrı kimlik bilgileri gerektirir.

Erişim ve eksik izin sorunlarını giderin

• Doğru OpenAI hesabıyla oturum açtığınızı ve istediğiniz kiracı ile ChatGPT çalışma alanını seçtiğinizi doğrulayın.

• Çalışma alanı üyeliğinizin etkin, rolünüzün ise Sahip veya Yönetici olduğunu kontrol edin.

• ChatGPT çalışma alanınızın Yönetici anahtarları için uygun olduğundan emin olun. Kullanılabilirlik plana ve kullanıma sunma aşamasına göre değişebilir.

• Bir izin kategorisi eksikse özelliğin seçili çalışma alanında kullanılabildiğini ve rolünüzün erişime izin verdiğini doğrulayın. Gerekli kategori hâlâ kullanılamıyorsa ilgisiz bir izin seçmek yerine OpenAI Destek ile iletişime geçin.

• Bir anahtarı düzenleyemiyor veya iptal edemiyorsanız anahtarı sizin oluşturduğunuzu ve izinlerinin mevcut rolünüzce kullanılabildiğini doğrulayın. Yalnızca çalışma alanı sahiplerine sunulan izinlere sahip anahtarları bir çalışma alanı sahibinin yönetmesini isteyin.

• Daha önce çalışan bir anahtar artık çalışmıyorsa Durum ve Sona erme bilgilerini kontrol edin, süresinin dolmadığını veya iptal edilmediğini doğrulayın ve anahtarı oluşturan kişinin gerekli izinlere sahip etkin bir çalışma alanı rolünün hâlâ bulunduğundan emin olun.

Sorun devam ederse OpenAI Destek ile iletişime geçin. İstenirse kiracı kimliğini, çalışma alanı adını veya kimliğini ve bir ekran görüntüsünü ekleyin; ancak Yönetici anahtarının gizli değerini asla paylaşmayın.

Yönetici anahtarlarınızı koruyun

• Özel izinleri seçin ve yalnızca entegrasyonunuzun ihtiyaç duyduğu erişimi verin.

• Mümkün olduğunda bir sona erme süresi belirleyin. Hiçbir zaman, anahtarın planlanmış bir sona erme tarihi olmadığı anlamına gelir. Anahtar iptal edilirse, anahtarı oluşturan kişi gerekli çalışma alanı erişimini kaybederse veya bu kişinin hesabı devre dışı bırakılırsa anahtar yine de çalışmayı durdurabilir.

• Farklı entegrasyonlar veya iş akışları için ayrı anahtarlar kullanın.

• Gizli değerleri güvenli bir gizli değer yöneticisinde saklayın. Bunları asla e-posta, sohbet veya destek talebi üzerinden göndermeyin.

• Kullanımı ve sona erme tarihlerini düzenli olarak gözden geçirin, artık ihtiyacınız olmayan anahtarları iptal edin.