Dokumentasi ChatGPT
Bahasa Indonesia
Hubungi kami goolvyouyou@gmail.com

Autentikasi

Metode masuk untuk web ChatGPT dan klien Codex

Untuk menghubungkan klien lokal ke gateway organisasi Anda dengan atau tanpa masuk dengan ChatGPT, lihat Hubungkan ke gateway. Akses langsung ke Bedrock menggunakan opsi autentikasi Amazon Bedrock.

Autentikasi OpenAI

Codex mendukung dua cara bagi seseorang untuk masuk saat menggunakan model OpenAI:

  • Masuk dengan ChatGPT untuk akses langganan
  • Masuk dengan API key untuk akses berbasis penggunaan

Aplikasi desktop ChatGPT, Codex CLI, dan ekstensi IDE mendukung kedua metode masuk untuk pekerjaan lokal. Cloud Codex mengharuskan Anda masuk dengan ChatGPT.

Metode masuk Anda juga menentukan kontrol admin dan kebijakan penanganan data yang berlaku.

  • Saat Anda masuk dengan ChatGPT, penggunaan Codex mengikuti izin ruang kerja ChatGPT, kontrol akses berbasis peran (RBAC), serta pengaturan retensi dan residensi ChatGPT Enterprise.
  • Dengan API key, penggunaan mengikuti pengaturan retensi dan berbagi data organisasi API Anda.

Untuk ruang kerja terkelola, autentikasi hanyalah salah satu lapisan akses. Keanggotaan dan penyediaan ruang kerja menentukan siapa yang dapat masuk, sedangkan lisensi dan peran ruang kerja menentukan antarmuka serta fitur produk yang dapat mereka gunakan. Untuk pekerjaan lokal di aplikasi desktop ChatGPT, Codex CLI, atau ekstensi IDE, profil izin membatasi tindakan yang dapat dilakukan agen di perangkat. Lihat Grup dan penyediaan dan Peran dan izin ruang kerja untuk merencanakan kontrol tersebut.

Masuk dengan ChatGPT

Untuk menggunakan akses komputer lokal dengan Work Cloud di desktop, perangkat seluler, dan web:

  1. Masuk dengan ChatGPT ke ruang kerja yang memenuhi syarat.

  2. Minta pemilik ruang kerja mengaktifkan Work Cloud, lalu aktifkan Izinkan akses komputer lokal di bagian Work Cloud. Gunakan Codex secara lokal di aplikasi desktop ChatGPT bukan prasyarat.

API key dan token akses Codex tidak mengaktifkan akses komputer lokal dengan Work Cloud. Lihat Peran dan izin ruang kerja dan FAQ admin Work untuk prasyarat, atau Akses komputer lokal untuk Work Cloud dan dots untuk penyiapan.

Saat Anda masuk dengan ChatGPT dari aplikasi desktop ChatGPT, Codex CLI, atau ekstensi IDE, alur masuk akan membuka jendela browser. Setelah Anda masuk, browser mengembalikan kredensial Anda ke Codex.

Aplikasi desktop ChatGPT

Di layar saat belum masuk, pilih Continue to sign in, lalu selesaikan alur di browser.

Masuk dengan API key

Anda juga dapat masuk ke aplikasi desktop ChatGPT, Codex CLI, atau ekstensi IDE dengan API key. Dapatkan API key Anda dari dasbor OpenAI.

Aplikasi desktop ChatGPT

Di layar saat belum masuk, pilih Sign in another way, masukkan kunci Anda, lalu pilih Continue.

OpenAI menagih penggunaan API key melalui akun OpenAI Platform Anda dengan tarif API standar. Lihat halaman harga API.

Autentikasi API key mendukung alur kerja Codex lokal, tetapi beberapa fitur yang bergantung pada akses ruang kerja ChatGPT atau layanan cloud dibatasi atau tidak tersedia. Bandingkan dukungan berdasarkan paket di Ketersediaan fitur.

Di Codex CLI dan Codex dalam aplikasi desktop ChatGPT, autentikasi API key mencakup akses ke plugin yang dikurasi OpenAI dan didukung. Beberapa plugin tidak tersedia karena alur koneksinya memerlukan kemampuan OAuth yang tidak didukung. Lihat Gunakan plugin.

Saat Anda masuk dengan API key, Codex menggunakan harga API standar, bukan kredit yang disertakan dalam paket ChatGPT.

Gunakan autentikasi API key untuk alur kerja Codex CLI terprogram, seperti tugas CI/CD. Jangan mengekspos eksekusi Codex di lingkungan yang tidak tepercaya atau publik.

Periksa autentikasi atau keluar

Buka menu profil untuk melihat akun aktif atau status API key. Pilih Keluar untuk menghapus kredensial saat ini.

Gunakan token akses Codex untuk otomatisasi perusahaan

Di ruang kerja ChatGPT Enterprise, admin dapat memberikan izin token akses agar anggota yang diizinkan dapat membuat token akses Codex untuk alur kerja lokal Codex noninteraktif yang tepercaya. Gunakan token akses jika otomatisasi memerlukan akses ruang kerja ChatGPT, hak Codex yang dikelola ChatGPT, atau kontrol ruang kerja perusahaan tanpa masuk melalui browser.

Token akses ditujukan untuk skrip tepercaya, penjadwal, dan runner CI privat. Untuk panggilan OpenAI API umum, tetap gunakan Platform API key.

Untuk langkah penyiapan serta panduan izin, rotasi, dan pencabutan, lihat Token akses.

Amankan akun cloud Codex Anda

Cloud Codex berinteraksi langsung dengan basis kode Anda sehingga memerlukan keamanan yang lebih kuat daripada banyak fitur ChatGPT lainnya. Aktifkan autentikasi multifaktor (MFA).

Jika Anda menggunakan penyedia login sosial (Google, Microsoft, Apple), Anda tidak diwajibkan mengaktifkan MFA pada akun ChatGPT, tetapi Anda dapat menyiapkannya melalui penyedia login sosial.

Untuk petunjuk penyiapan, lihat:

Jika Anda mengakses ChatGPT melalui sistem masuk tunggal (SSO), administrator SSO organisasi Anda harus menerapkan MFA untuk semua pengguna.

Jika Anda masuk menggunakan email dan kata sandi, Anda harus menyiapkan MFA di akun sebelum mengakses cloud Codex.

Jika akun Anda mendukung lebih dari satu metode login dan salah satunya adalah email dan kata sandi, Anda harus menyiapkan MFA sebelum mengakses Codex, meskipun Anda masuk dengan cara lain.

Penyimpanan sementara login

Saat Anda masuk ke aplikasi desktop ChatGPT, Codex CLI, atau ekstensi IDE menggunakan ChatGPT atau API key, detail login Anda disimpan sementara dan digunakan kembali. CLI dan ekstensi menggunakan detail login tersimpan yang sama. Jika Anda keluar dari salah satunya, Anda harus masuk lagi saat berikutnya memulai CLI atau ekstensi.

Codex menyimpan detail login secara lokal dalam file teks biasa di ~/.codex/auth.json atau dalam penyimpanan kredensial khusus OS Anda.

Untuk sesi masuk dengan ChatGPT, Codex secara otomatis menyegarkan token selama penggunaan sebelum kedaluwarsa, sehingga sesi aktif biasanya berlanjut tanpa memerlukan login browser lagi.

Penyimpanan kredensial

Gunakan cli_auth_credentials_store untuk mengontrol tempat Codex CLI menyimpan kredensial yang disimpan sementara:

# file | keyring | auto | ephemeral
cli_auth_credentials_store = "keyring"
  • file menyimpan kredensial dalam auth.json di bawah CODEX_HOME (defaultnya ~/.codex).
  • keyring menyimpan kredensial di penyimpanan kredensial sistem operasi Anda dan gagal jika penyimpanan tersebut tidak tersedia.
  • auto menggunakan penyimpanan kredensial OS jika tersedia; jika tidak, menggunakan auth.json sebagai cadangan.
  • ephemeral menyimpan kredensial hanya dalam memori untuk proses yang sedang berjalan.

Lihat referensi konfigurasi untuk skema config.toml yang lengkap.

Admin dapat memberlakukan cli_auth_credentials_store dan chatgpt_base_url melalui persyaratan autentikasi lokal. Pengguna tidak dapat mengesampingkan persyaratan tersebut melalui config.toml atau penggantian pengaturan melalui CLI.

Terapkan metode login atau ruang kerja

Dalam lingkungan terkelola, admin dapat membatasi cara pengguna diizinkan melakukan autentikasi:

# Only allow ChatGPT login or only allow API key login.
forced_login_method = "chatgpt" # or "api"

# When using ChatGPT login, restrict users to a specific workspace.
forced_chatgpt_workspace_id = "00000000-0000-0000-0000-000000000000"

Jika kredensial aktif tidak sesuai dengan pembatasan yang dikonfigurasi, Codex mengeluarkan pengguna dan berhenti.

Pengaturan ini juga dapat diberikan melalui konfigurasi terkelola lama. Untuk pembatasan login yang diberlakukan admin, lihat Kelola autentikasi secara lokal.

Penyedia model alternatif

Saat menentukan penyedia model khusus dalam file konfigurasi, Anda dapat memilih salah satu metode autentikasi berikut:

  • Autentikasi OpenAI: Atur requires_openai_auth = true untuk menggunakan autentikasi OpenAI. Anda kemudian dapat masuk dengan ChatGPT atau API key. Metode ini berguna saat Anda mengakses model OpenAI melalui server proksi LLM. Saat requires_openai_auth = true, Codex mengabaikan env_key.
  • Autentikasi variabel lingkungan: Atur env_key = "<ENV_VARIABLE_NAME>" untuk menggunakan API key khusus penyedia dari variabel lingkungan lokal bernama <ENV_VARIABLE_NAME>.
  • OAuth bawaan gateway: Konfigurasikan [model_providers.<id>.gateway_oauth] untuk masuk melalui browser menggunakan penyedia identitas organisasi Anda. Metode ini berfungsi dengan atau tanpa masuk dengan ChatGPT. Lihat OAuth bawaan gateway untuk persyaratan dan konfigurasi gateway.
  • Autentikasi berbasis perintah: Konfigurasikan [model_providers.<id>.auth] untuk memperoleh token dari alat bantu kredensial yang terinstal.
  • Tanpa autentikasi: Untuk model lokal yang tidak memerlukan kredensial, biarkan requires_openai_auth tidak ditetapkan atau bernilai false dan jangan sertakan pengaturan kredensial, termasuk env_key, experimental_bearer_token, auth, dan gateway_oauth.