Kunci Admin memungkinkan pemilik dan admin workspace yang berwenang menghubungkan alat serta layanan ke API administrasi ChatGPT dan Codex yang didukung. Bergantung pada workspace dan izin yang dipilih, kunci dapat mendukung analitik, pengelolaan pengguna dan grup, undangan, batas penggunaan, log kepatuhan dan aktivitas, atau administrasi akun layanan.
Setiap kunci Admin berlaku untuk satu workspace ChatGPT. Kunci tersebut tidak memberikan akses ke workspace lain, administrasi seluruh tenant, organisasi Platform API, akun Iklan, model, atau inferensi model.
Untuk bantuan memilih tenant atau workspace, lihat: Mengelola tenant Anda di Konsol Admin.
Periksa ketersediaan dan akses workspace
Kunci Admin tersedia untuk workspace ChatGPT terkelola yang memenuhi syarat, termasuk workspace ChatGPT Enterprise, ChatGPT Edu, dan ChatGPT untuk Layanan Kesehatan. Anda harus memiliki peran Pemilik atau Admin di workspace tertentu yang ingin Anda kelola.
Akses bergantung pada peran Pemilik atau Admin yang ditetapkan di workspace ChatGPT yang dipilih. Menjadi admin global, pemilik organisasi Platform API, atau pengguna dengan peran workspace kustom tidak dengan sendirinya memberikan akses ke kunci Admin.
Untuk detail tentang peran bawaan workspace, lihat: Mengelola anggota, peran workspace, dan lisensi.
Pahami akses berdasarkan peran
Pemilik workspace dapat membuat kunci dengan izin Semua, Hanya baca, atau Kustom. Mereka dapat mengedit atau mencabut kunci Admin apa pun di workspace mereka.
Admin workspace membuat kunci dengan cakupan kustom dengan memilih tingkat akses yang tersedia untuk setiap kategori izin. Kunci yang dihasilkan diberi label Kustom. Mereka hanya dapat mengedit atau mencabut kunci yang mereka buat, dan hanya jika izin kunci tersedia bagi peran mereka saat ini.
Admin global yang tidak memiliki peran Pemilik atau Admin di workspace yang dipilih tidak dapat membuat atau mengelola kunci Admin workspace tersebut.
Pilih izin kunci Admin
Preset izin Pemilik
Pemilik workspace dapat memilih salah satu preset izin berikut:
Semua memberikan izin admin yang tersedia untuk workspace yang dipilih, termasuk izin khusus pemilik jika tersedia.
Hanya baca memberikan izin hanya baca yang tersedia untuk workspace yang dipilih.
Kustom memungkinkan Anda memilih tingkat akses yang tersedia untuk setiap kategori izin.
Izin admin berdasarkan kategori
Admin workspace tidak melihat pemilih preset Semua, Hanya baca, atau Kustom. Di bagian Izin, mereka memilih Tidak ada, Baca, atau Tulis untuk setiap kategori yang tersedia. Kunci yang dihasilkan diberi label Kustom.
Bergantung pada workspace Anda, kategori yang tersedia dapat mencakup Aplikasi, Batas penggunaan, Pengelolaan Grup, Pengguna, Undangan, API analitik Codex, API analitik Enterprise, Analitik workspace, Biaya, dan Akun layanan. Beberapa kategori hanya mendukung Baca atau Tulis, dan beberapa hanya muncul jika fitur terkait tersedia.
Pemetaan izin yang umum meliputi:
API analitik Codex > Baca:
codex.enterprise.analytics.read.Batas penggunaan > Baca:
chatgpt.enterprise.usage_limit.read.Batas penggunaan > Tulis:
chatgpt.enterprise.usage_limit.writedanchatgpt.enterprise.usage_limit.read.Pengguna > Baca:
chatgpt.enterprise.user.read, jika tersedia.
Izin kepatuhan yang luas, Pesan percakapan, serta Peran dan izin hanya tersedia bagi pemilik workspace jika didukung. Admin workspace mungkin masih dapat memilih kategori log aktivitas tertentu, seperti log audit atau autentikasi.
Izin untuk pengelolaan grup
Untuk membuat, memperbarui, atau menghapus grup dengan API Admin Grup di workspace ChatGPT yang memenuhi syarat, gunakan kunci Admin untuk workspace tersebut.
Tinjau Pengelolaan Grup saat memilih izin kunci, lalu berikan izin yang diperlukan oleh endpoint. Kunci hanya baca tidak mengizinkan perubahan grup.
Penetapan sebagai pengelola grup saja tidak memberikan izin untuk membuat kunci Admin atau menggunakan API Admin Grup. Hanya pemilik dan admin workspace yang dapat membuat kunci Admin; permintaan API memerlukan kunci dengan izin yang diwajibkan.
Untuk administrasi grup yang didelegasikan, lihat: Mengelola grup dan pengelola grup.
Untuk jalur endpoint, operasi yang didukung, kolom permintaan, dan cakupan yang diperlukan, lihat referensi API Admin. Kelola grup yang disinkronkan melalui alur kerja SCIM penyedia identitas Anda. Untuk panduan sinkronisasi, lihat: Penyediaan dan pengelolaan SCIM.
Buat kunci Admin
Masuk ke Konsol Admin.
Pilih tenant Anda jika diperlukan, lalu pilih workspace ChatGPT tempat Anda memiliki peran Pemilik atau Admin.
Buka Kredensial, lalu pilih Kunci Admin.
Pilih Buat kunci admin baru dan masukkan nama yang deskriptif.
Pilih masa berlaku: Tidak pernah, 30 hari, 60 hari, 90 hari, atau Kustom. Masa berlaku kustom dapat ditetapkan antara 1 hingga 365 hari.
Pilih izin yang diperlukan integrasi Anda. Pemilik workspace dapat memilih Semua, Hanya baca, atau Kustom; admin workspace memilih izin yang tersedia untuk setiap kategori.
Pilih Kirim, lalu salin dan simpan rahasia tersebut dengan aman. Anda tidak dapat melihat rahasia tersebut lagi.
Kunci pemilik workspace dapat menggunakan izin Semua secara default, dan masa berlaku dapat diatur ke Tidak pernah secara default. Tinjau kedua pengaturan sebelum membuat kunci.
Tinjau, edit, atau cabut kunci Admin
Buka workspace ChatGPT di Konsol Admin, lalu buka Kredensial > Kunci Admin. Tinjau nama, status, ID pelacakan, rahasia yang disamarkan, pembuat, izin, tanggal terakhir digunakan, dan masa berlaku setiap kunci.
Untuk mengubah nama atau izin kunci, buka menu opsi lainnya (•••), pilih Edit, lakukan perubahan, lalu pilih Simpan perubahan.
Untuk berhenti menggunakan kunci, buka menu opsi lainnya (•••), pilih Cabut, lalu konfirmasikan dengan Cabut kunci admin.
Pemilik workspace dapat mengedit atau mencabut kunci apa pun untuk workspace yang dipilih. Admin workspace hanya dapat mengedit atau mencabut kunci yang mereka buat, dan hanya jika izin kunci tersedia bagi peran mereka saat ini. Minta pemilik workspace mengelola kunci dengan izin khusus pemilik. Tanggal kedaluwarsa yang sudah ditetapkan tidak dapat diubah.
Kunci yang dicabut berhenti berfungsi setelah perubahan berlaku. Buat kunci pengganti dan perbarui semua integrasi yang terdampak sebelum mencabut kunci yang masih digunakan.
Pahami kepatuhan dan data sensitif
Beberapa izin kunci Admin dapat mengekspos aktivitas atau konten sensitif dalam workspace. Hanya pemilik workspace yang dapat memberikan akses kepatuhan yang luas atau akses ke Pesan percakapan.
Admin workspace mungkin dapat memberikan akses ke kategori log tertentu yang didukung, termasuk log audit, autentikasi, atau aplikasi. Tinjau setiap kategori dengan saksama; log individual tetap dapat berisi informasi sensitif.
Untuk informasi tentang API kepatuhan dan akses data, lihat: Platform Kepatuhan OpenAI untuk Pelanggan Enterprise dan Edu.
Permintaan API Admin workspace ChatGPT menggunakan https://api.chatgpt.com/v1. Misalnya, gunakan /manage/workspaces/{workspace_id}/users untuk menampilkan anggota workspace saat ini. Endpoint di bawah /v1/organization/ mengelola organisasi Platform API dan memerlukan kunci Admin organisasi Platform API.
Untuk jalur endpoint, skema permintaan dan respons, serta cakupan yang diperlukan, lihat referensi API Admin.
Bedakan kunci Admin dari kredensial lain
Kunci Admin workspace mengautentikasi API administrasi ChatGPT dan Codex yang didukung untuk satu workspace ChatGPT. Kunci tersebut tidak memberikan akses ke inferensi model.
Token akses akun layanan Codex mengautentikasi identitas workspace nonmanusia untuk otomatisasi Codex. Token tersebut tidak mengautentikasi permintaan API Admin. Untuk panduan penyiapan, lihat: Membuat dan mengelola akun layanan Codex.
Kunci Admin organisasi Platform API dikelola secara terpisah di Platform API dan tidak mengelola workspace ChatGPT.
Jika Anda memerlukan kunci untuk organisasi Platform API, buka Kunci Admin organisasi Platform API. Gunakan endpoint API Admin ChatGPT khusus workspace dengan kunci Admin workspace; endpoint organisasi Platform API memerlukan kredensial terpisah.
Atasi masalah akses dan izin yang hilang
Pastikan Anda masuk dengan akun OpenAI yang benar dan memilih tenant serta workspace ChatGPT yang dimaksud.
Pastikan keanggotaan workspace Anda aktif dan peran workspace Anda adalah Pemilik atau Admin.
Pastikan workspace ChatGPT Anda memenuhi syarat untuk menggunakan kunci Admin. Ketersediaan dapat berbeda menurut paket dan tahap peluncuran.
Jika suatu kategori izin tidak ada, pastikan fitur tersebut tersedia di workspace yang dipilih dan peran Anda mengizinkan akses. Jika kategori yang diperlukan tetap tidak tersedia, hubungi Dukungan OpenAI dan jangan memilih izin yang tidak terkait.
Jika Anda tidak dapat mengedit atau mencabut kunci, pastikan Anda yang membuatnya dan izinnya tersedia bagi peran Anda saat ini. Minta pemilik workspace mengelola kunci dengan izin khusus pemilik.
Jika kunci yang sebelumnya berfungsi berhenti bekerja, periksa Status dan Masa berlaku, pastikan kunci belum kedaluwarsa atau dicabut, serta pastikan pembuatnya masih memiliki peran workspace aktif dengan izin yang diperlukan.
Jika masalah berlanjut, hubungi Dukungan OpenAI. Sertakan ID tenant, nama atau ID workspace, dan tangkapan layar jika diminta, tetapi jangan pernah membagikan rahasia kunci Admin.
Lindungi kunci Admin Anda
Pilih izin Kustom dan berikan hanya akses yang diperlukan integrasi Anda.
Tetapkan masa berlaku jika memungkinkan. Tidak pernah berarti kunci tidak memiliki jadwal kedaluwarsa. Kunci tetap dapat berhenti berfungsi jika dicabut, pembuatnya kehilangan akses workspace yang diperlukan, atau akun pembuatnya dinonaktifkan.
Gunakan kunci terpisah untuk integrasi atau alur kerja yang berbeda.
Simpan rahasia di pengelola rahasia yang aman. Jangan pernah mengirimkannya melalui email, obrolan, atau permintaan dukungan.
Tinjau penggunaan dan masa berlaku secara berkala, lalu cabut kunci yang tidak lagi diperlukan.