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. Seçtiğiniz çalışma alanına ve izinlere bağlı olarak bir anahtar; analiz, kullanıcı ve grup yönetimi, davetler, kullanım sınırları, uyumluluk ve etkinlik günlükleri ya da 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ı genelinde yönetime, API Platformu kuruluşlarına, Reklam 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ı kullanılabilirliğini ve erişimi kontrol etme

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çilen ChatGPT çalışma alanında atanmış Sahip veya Yönetici rolüne bağlıdır. Genel yönetici, API Platformu kuruluş sahibi veya özel çalışma alanı rolüne sahip bir 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. ChatGPT Enterprise'ta üyeleri, lisans türlerini, rolleri ve erişimi yönetme.

Rollere göre erişimi anlama

• Ç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 kullanılabilir erişim düzeyini seçerek özel kapsamlı anahtarlar oluşturur. Oluşturulan anahtar Özel olarak etiketlenir. Yalnızca kendi oluşturdukları anahtarları ve ancak anahtarın izinleri mevcut rollerinde kullanılabiliyorsa düzenleyebilir veya iptal edebilirler.

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

Yönetici anahtarı izinlerini seçme

Sahip izinleri için hazır ayarlar

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

• Tümü, seçilen çalışma alanında kullanılabilir olan yönetici izinlerini ve varsa yalnızca sahiplere özel izinleri verir.

• Salt okunur, seçilen çalışma alanında kullanılabilir olan salt okunur izinleri verir.

• Özel, her izin kategorisi için kullanılabilir 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 hazır ayar seçicisini görmez. İzinler altında, kullanılabilir her kategori için Yok, Okuma veya Yazma'yı seçerler. Oluşturulan anahtar Özel olarak etiketlenir.

Çalışma alanınıza bağlı olarak kullanılabilir 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'yı 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: kullanılabildiği durumlarda chatgpt.enterprise.user.read.

Geniş kapsamlı uyumluluk izinleri, Konuşma mesajları ve Roller ve izinler, desteklendiğinde yalnızca çalışma alanı sahiplerinin kullanımına sunulur. Çalışma alanı yöneticileri yine de denetim veya kimlik doğrulama günlükleri gibi bağımsız etkinlik günlüğü kategorilerini seçebilir.

Yönetici anahtarı oluşturma

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çıp Yönetici anahtarları'nı seçin.

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

5. Bir geçerlilik süresi seçin: Hiçbir zaman, 30 gün, 60 gün, 90 gün veya Özel. Özel geçerlilik 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'i seçebilir; çalışma alanı yöneticileri ise her kategori için kullanılabilir izni seçer.

7. Gönder'i seçin, ardından gizli değeri kopyalayıp güvenli şekilde saklayın. Gizli değeri daha sonra yeniden görüntüleyemezsiniz.

Çalışma alanı sahibi anahtarlarında varsayılan izin Tümü, varsayılan geçerlilik süresi ise Hiçbir zaman olabilir. Anahtarı oluşturmadan önce her iki ayarı da gözden geçirin.

Yönetici anahtarını inceleme, düzenleme veya iptal etme

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, maskelenmiş gizli değerini, oluşturan kişiyi, izinlerini, son kullanılma tarihini ve geçerlilik süresini 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ı bırakmak 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çilen çalışma alanındaki tüm anahtarları düzenleyebilir veya iptal edebilir. Çalışma alanı yöneticileri yalnızca kendi oluşturdukları anahtarları ve ancak anahtarın izinleri mevcut rollerinde kullanılabiliyorsa düzenleyebilir veya iptal edebilir. Yalnızca sahiplere özel izinlere sahip anahtarları yönetmesi için bir çalışma alanı sahibinden yardım isteyin. Mevcut geçerlilik tarihleri değiştirilemez.

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

Uyumluluğu ve hassas verileri anlama

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

Çalışma alanı yöneticileri; denetim, kimlik doğrulama veya uygulama günlükleri dâhil olmak üzere desteklenen bağımsız günlük kategorilerine erişim verebilir. Her kategoriyi dikkatle inceleyin; bağımsız günlükler yine 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ırma

• Çalışma alanı Yönetici anahtarları, tek bir ChatGPT çalışma alanı için desteklenen ChatGPT ve Codex yönetim API'lerinde kimlik doğrulaması yapar. 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ğini doğrular. Yönetici API'si isteklerinde kimlik doğrulaması yapmazlar. Kurulum talimatları 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ı'nı açın. Çalışma alanına özgü 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 izinlerle ilgili sorunları giderme

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

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

• ChatGPT çalışma alanınızın Yönetici anahtarlarını kullanmaya 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çilen ç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üzde kullanılabildiğini doğrulayın. Yalnızca sahiplere özel izinlere sahip anahtarları yönetmesi için bir çalışma alanı sahibinden yardım isteyin.

• Daha önce çalışan bir anahtar çalışmayı durdurursa Durum ve Geçerlilik süresi'ni 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ı koruma

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

• Mümkün olduğunda bir geçerlilik süresi belirleyin. Hiçbir zaman, anahtarın planlanmış bir geçerlilik sonu 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 aracılığıyla göndermeyin.

• Kullanımı ve geçerlilik sürelerini düzenli olarak gözden geçirin, artık ihtiyaç duymadığınız anahtarları iptal edin.