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.
Memeriksa 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 dikelola.
Akses bergantung pada peran Pemilik atau Admin yang ditetapkan di workspace ChatGPT yang dipilih. Status sebagai 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, jenis lisensi, peran, dan akses di ChatGPT Enterprise.
Memahami 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 tersebut tersedia bagi peran mereka saat ini.
Admin global yang tidak memiliki peran Pemilik atau Admin di workspace terpilih tidak dapat membuat atau mengelola kunci Admin workspace tersebut.
Memilih izin kunci Admin
Preset izin pemilik
Pemilik workspace dapat memilih salah satu preset izin berikut:
Semua memberikan izin admin yang tersedia untuk workspace terpilih, termasuk izin khusus pemilik jika tersedia.
Hanya baca memberikan izin baca-saja yang tersedia untuk workspace terpilih.
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 sebagian hanya muncul jika fitur terkait tersedia.
Pemetaan izin yang umum mencakup:
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 luas, Pesan percakapan, serta Peran dan izin hanya tersedia bagi pemilik workspace jika didukung. Admin workspace mungkin tetap dapat memilih kategori log aktivitas individual, seperti log audit atau autentikasi.
Membuat kunci Admin
Masuk ke Konsol Admin.
Pilih tenant Anda jika perlu, 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 dengan aman. Anda tidak dapat melihat rahasia itu lagi.
Kunci milik pemilik workspace dapat menggunakan izin Semua secara default, dan masa berlaku dapat menggunakan Tidak Pernah secara default. Tinjau kedua pengaturan sebelum membuat kunci.
Meninjau, mengedit, atau mencabut 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 terpilih. Admin workspace hanya dapat mengedit atau mencabut kunci yang mereka buat, dan hanya jika izin kunci tersebut 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 pengganti dan perbarui semua integrasi yang terdampak sebelum mencabut kunci yang masih digunakan.
Memahami kepatuhan dan data sensitif
Beberapa izin kunci Admin dapat mengekspos aktivitas atau konten workspace yang sensitif. Hanya pemilik workspace yang dapat memberikan akses kepatuhan luas atau akses ke Pesan percakapan.
Admin workspace mungkin dapat memberikan akses ke kategori log individual yang didukung, termasuk log audit, autentikasi, atau aplikasi. Tinjau setiap kategori dengan cermat; setiap log 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 diwajibkan, lihat referensi API Admin.
Membedakan 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 digunakan untuk mengelola workspace ChatGPT.
Jika 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.
Memecahkan masalah akses dan izin yang tidak tersedia
Pastikan Anda masuk dengan akun OpenAI yang benar serta memilih tenant dan workspace ChatGPT yang dimaksud.
Pastikan keanggotaan workspace Anda aktif dan peran workspace Anda adalah Pemilik atau Admin.
Pastikan workspace ChatGPT Anda memenuhi syarat untuk kunci Admin. Ketersediaan dapat berbeda menurut paket dan tahap peluncuran.
Jika kategori izin tidak tersedia, pastikan fitur tersebut tersedia di workspace terpilih dan peran Anda mengizinkan akses. Jika kategori yang diperlukan masih 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 diwajibkan.
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.
Melindungi 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 diwajibkan, 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, chat, atau permintaan dukungan.
Tinjau penggunaan dan masa berlaku secara rutin, lalu cabut kunci yang tidak lagi diperlukan.