Claude Platform Docs
AdminClaude Platform OAuth

Referensi OAuth

Endpoint, autentikasi klien, parameter permintaan, scope, respons token, pencabutan, masa berlaku, aturan URI pengalihan, dan error.

Halaman ini mengumpulkan endpoint, parameter, aturan validasi, dan pemetaan error untuk Claude Platform OAuth. Untuk panduan langkah demi langkah, lihat Linked billing.

Endpoint

EndpointURL
Penerbithttps://identity.anthropic.com/users
Dokumen discoveryhttps://identity.anthropic.com/users/.well-known/openid-configuration
Kunci penandatanganan (JWKS)jwks_uri dalam dokumen discovery, di-host di identity.anthropic.com
Endpoint otorisasi (halaman masuk dan persetujuan)https://auth.claude.com/oauth/authorize
Endpoint “pushed authorization request” (permintaan otorisasi yang didorong), atau PARhttps://auth.claude.com/v1/oauth/par
Endpoint tokenhttps://auth.claude.com/v1/oauth/token
Endpoint pencabutanhttps://auth.claude.com/v1/oauth/revoke
Claude API (profil pengguna dan permintaan yang menagih pelanggan)https://api.anthropic.com

Baca kunci penandatanganan dari dokumen discovery alih-alih melakukan hardcode. Dokumen discovery tidak mencantumkan endpoint PAR maupun endpoint pencabutan, jadi gunakan URL dalam tabel ini.

Nilai dokumen discovery

FieldNilai
issuerhttps://identity.anthropic.com/users
authorization_endpointhttps://auth.claude.com/oauth/authorize
token_endpointhttps://auth.claude.com/v1/oauth/token
jwks_urihttps://identity.anthropic.com/users/jwks.json
response_types_supportedcode
grant_types_supportedauthorization_code, refresh_token
code_challenge_methods_supportedS256
token_endpoint_auth_methods_supportedprivate_key_jwt
id_token_signing_alg_values_supportedES256
scopes_supportedopenid, email
subject_types_supportedpublic, pairwise

auth.claude.com mengembalikan refresh token untuk Linked billing hanya jika pelanggan menyetujui offline_access bersama dengan billing:attribution: lihat Token OAuth untuk koneksi penagihan.

Autentikasi klien

auth.claude.com mengautentikasi klien rahasia dengan metode private_key_jwt (RFC 7523). Kirim parameter-parameter ini pada setiap permintaan ke endpoint PAR, endpoint token, dan endpoint pencabutan. Jangan pernah mengirim kredensial dalam query string URL: auth.claude.com akan menolaknya.

ParameterNilai
client_idID klien aplikasi OAuth Anda
client_assertion_typeurn:ietf:params:oauth:client-assertion-type:jwt-bearer
client_assertionJWT dari penyedia identitas Anda dengan klaim dalam Klaim client assertion

Klaim client assertion

“Client assertion” (asersi klien) harus berisi semua klaim berikut, dan header-nya harus berisi kid dari sebuah kunci dalam JWKS Anda.

KlaimPersyaratan
issURL issuer penyedia identitas Anda, persis seperti yang didaftarkan melalui Workload Identity Federation
subNilai yang cocok dengan pola subjek dalam pengaturan autentikasi klien aplikasi Anda, jika Anda menetapkannya
audTepat satu audiens: nilai dalam pengaturan autentikasi klien aplikasi Anda. auth.claude.com menolak asersi yang mencantumkan lebih dari satu audiens.
iatWaktu penyedia identitas Anda menerbitkan JWT
expWaktu kedaluwarsa, tidak lebih dari 1 jam setelah iat. Gunakan masa berlaku yang lebih singkat jika memungkinkan: siapa pun yang mencegat asersi dapat menggunakannya hingga kedaluwarsa.

Contoh payload asersi:

{
  "iss": "https://idp.example.com",
  "sub": "workload:prod:claude-integration-backend",
  "aud": "YOUR_CONFIGURED_AUDIENCE",
  "iat": 1791230000,
  "exp": 1791230300
}

Buat pola subjek dan kondisi klaim sesempit yang dimungkinkan oleh back end Anda. auth.claude.com menerima JWT apa pun dari penyedia identitas Anda yang cocok dengan keduanya sebagai autentikasi untuk aplikasi Anda.

Parameter permintaan otorisasi

Kirim parameter-parameter ini, kecuali request_uri, dalam body JSON dari pushed authorization request.

ParameterLinked billingDeskripsi
response_typeWajibNilai code
client_idWajibID klien aplikasi OAuth Anda
redirect_uriWajibURI yang persis cocok dengan URI pengalihan yang terdaftar, hingga 2.048 karakter
scopeWajibUntuk koneksi penagihan, billing:attribution atau billing:attribution offline_access. Lihat Scope.
stateWajibNilai acak sekali pakai, hingga 2.048 karakter, yang Anda periksa pada callback
code_challengeWajibBASE64URL(SHA256(code_verifier)), dengan code_verifier sepanjang 43 hingga 128 karakter
code_challenge_methodWajibNilai S256
connection_typeWajibNilai organization_shared. Nilai ini meminta koneksi organisasi untuk penagihan.
connection_auth_targetWajibOrganisasi tujuan pengarahan permintaan koneksi. Untuk Linked billing, kirim platform (pemilik aplikasi OAuth).
user_profile_idWajibID profil pengguna aktif di organisasi Anda yang mewakili pelanggan
request_uriWajibNilai yang dikembalikan oleh endpoint PAR. Kirimkan ke endpoint otorisasi bersama client_id dan tanpa parameter lain.

Endpoint PAR mengembalikan HTTP 201 dengan request_uri dan expires_in (600 detik).

Scope

KategoriScopeDeskripsiTipe koneksiTipe klien
Umumoffline_accessMemberikan aplikasi refresh token yang mewakili scope lain yang diminta. Pada koneksi organization_shared, kirimkan hanya bersama dengan billing:attribution.organization_sharedRahasia
Penagihanbilling:attributionKoneksi yang memungkinkan Anda menagihkan permintaan Claude API yang diarahkan pelanggan untuk Anda buat ke organisasi Claude mereka. Kirimkan sendiri, atau bersama dengan offline_access untuk juga mendapatkan refresh token. Lihat Token OAuth untuk koneksi penagihan.organization_sharedRahasia
Penagihanorg:billing_attributionTidak digunakan lagi: gunakan billing:attribution.organization_sharedRahasia

Permintaan dan respons token

Kirim permintaan token ke https://auth.claude.com/v1/oauth/token dengan body JSON.

ParameterNilai
grant_typeauthorization_code
codeKode dari callback
redirect_uriredirect_uri yang sama dengan yang Anda kirim dalam permintaan otorisasi
code_verifierCode verifier PKCE
client_id, client_assertion_type, client_assertionSeperti dalam Autentikasi klien

Respons token berisi field-field berikut:

Field responsLinked billing
access_tokenToken akses koneksi
token_typeBearer
expires_inPaling lama 3600
scopeworkspace:inference
connection_idID koneksi, misalnya ocon_EXAMPLE. Simpan ID ini.
refresh_tokenDikembalikan hanya jika pelanggan menyetujui offline_access
refresh_token_expires_inDetik hingga refresh_token kedaluwarsa. Tidak ada jika tidak ada refresh_token.

Untuk melakukan refresh, kirim grant_type yang diatur ke refresh_token, refresh_token Anda, dan parameter dalam Autentikasi klien. Refresh untuk koneksi penagihan mengikuti aturan dalam Token OAuth untuk koneksi penagihan.

Token OAuth untuk koneksi penagihan

Untuk koneksi penagihan, endpoint token mengembalikan token akses koneksi. Token tersebut melakukan autentikasi sebagai akun layanan operator aplikasi Anda, di workspace yang disebutkan oleh pengaturan connection_token_workspace_id aplikasi. Pada /v1/messages dan /v1/chat/completions, permintaan dengan token tersebut ditagihkan ke pelanggan koneksi tersebut dan tidak ke pihak lain. Jika pelanggan juga menyetujui offline_access, endpoint token juga mengembalikan refresh token, dan grant refresh_token memperbarui kedua token. Untuk penyiapan dan panduan langkah demi langkah, lihat Token OAuth untuk setiap koneksi di halaman Linked billing.

Kedua grant menggunakan parameter dalam Permintaan dan respons token, dengan Autentikasi klien. Refresh tidak boleh mengirim parameter scope. Respons token berisi field-field berikut:

Field responsNilai
access_tokenToken akses koneksi
token_typeBearer
expires_inDetik hingga token akses kedaluwarsa, paling lama 3600
scopeSelalu workspace:inference
connection_idID koneksi, misalnya ocon_EXAMPLE. Hanya grant authorization_code yang mengembalikannya.
refresh_tokenRefresh token koneksi. Dikembalikan hanya jika pelanggan menyetujui offline_access.
refresh_token_expires_inDetik hingga refresh_token kedaluwarsa

Setiap refresh mengembalikan access_token baru dan refresh_token baru. Refresh token yang Anda kirim digantikan, dan token akses sebelumnya berhenti berfungsi dalam beberapa menit. Anda dapat mengirim refresh token yang telah digantikan satu kali lagi, dalam 30 detik setelah refresh yang menggantikannya, untuk mengulangi permintaan yang responsnya hilang. Permintaan kedua tersebut mengembalikan pasangan baru lainnya dan mencabut pasangan dari respons yang hilang: gunakan hanya pasangan terbaru. Permintaan ketiga dengan token yang telah digantikan akan mendapatkan invalid_grant, demikian juga permintaan kedua yang tiba setelah 30 detik tersebut. Dalam 30 detik tersebut, permintaan semacam itu tidak mencabut apa pun. Setelah 30 detik tersebut, permintaan itu mencabut setiap token koneksi dan mengakhiri koneksi. Segarkan token menjelaskan aturan dan error dari refresh.

Setiap peristiwa berikut mencabut token koneksi, termasuk token akses saat ini:

  • Pelanggan atau Anda membatalkan tautan.
  • Pelanggan menyetujui permintaan otorisasi baru dengan scope berbeda untuk profil pengguna yang sama, dan Anda menukarkan kode dari persetujuan tersebut. Koneksi baru menggantikan koneksi sebelumnya.
  • Workspace tempat token berjalan diarsipkan.

Untuk cara Claude API menagih permintaan dengan token akses koneksi, lihat Panggil Claude dengan token akses koneksi.

Pencabutan

Kirim permintaan pencabutan ke https://auth.claude.com/v1/oauth/revoke dengan body JSON atau form-encoded. Endpoint ini mengikuti RFC 7009 dan juga menerima ID koneksi dan ID profil pengguna.

Kirim parameter dalam Autentikasi klien dan tepat satu parameter dari tabel ini. aud dari client assertion adalah nilai dalam pengaturan autentikasi klien aplikasi Anda, bukan URL pencabutan.

ParameterApa yang diakhirinya
connection_idSalah satu koneksi aplikasi Anda, diberikan sebagai ID ocon_
user_profile_idSemua koneksi aplikasi Anda pada satu profil pengguna, diberikan sebagai ID uprof_
tokenUntuk Linked billing, kirim connection_id atau user_profile_id sebagai gantinya: mengirim token akses mungkin tidak mengakhiri koneksi.

auth.claude.com menerima token_type_hint dan mengabaikannya.

Endpoint mengembalikan HTTP 200 dan ID koneksi yang diakhiri oleh permintaan tersebut:

{
  "revoked_connection_ids": ["ocon_EXAMPLE"]
}

Daftar tersebut kosong jika token atau ID tidak dikenal atau milik aplikasi lain, jika koneksi sudah berakhir, atau jika permintaan mengakhiri token tetapi tidak mengakhiri koneksi apa pun. Respons tidak menyebutkan yang mana.

Setelah koneksi penagihan berakhir, Claude API menolak permintaan yang menagih pelanggan tersebut, dengan user_profile_not_billable, dan token OAuth koneksi berhenti berfungsi. Setelah itu, jangan mengandalkan token akses dari koneksi yang disetujui dengan scope org:billing_attribution yang sudah tidak digunakan lagi: token tersebut mungkin langsung berhenti berfungsi, atau tetap berfungsi hingga kedaluwarsa.

Masa berlaku

ItemMasa berlaku
request_uri dari endpoint PAR10 menit, sekali pakai
Kode otorisasi5 menit, sekali pakai
access_tokenHingga 1 jam
refresh_tokenHingga 1 tahun sejak pertukaran kode. Refresh tidak memperpanjangnya.

Ini adalah nilai saat ini. Baca expires_in dan refresh_token_expires_in dari setiap respons alih-alih mengandalkan nilai tetap.

Aturan URI pengalihan

  • Setiap redirect_uri harus persis cocok dengan URI yang terdaftar pada aplikasi Anda. auth.claude.com tidak menggunakan pencocokan wildcard atau prefiks.
  • Setiap URI pengalihan harus menggunakan HTTPS dan tidak boleh berisi fragmen. URI pengembangan lokal pada localhost, 127.0.0.1, atau [::1] boleh menggunakan HTTP.
  • URI pengembangan lokal yang didaftarkan dengan tanda bintang sebagai port, seperti http://localhost:*/callback, cocok dengan port apa pun.
  • Anda dapat mendaftarkan hingga 10 URI pengalihan untuk setiap aplikasi.
  • auth.claude.com mengirim error ke URI pengalihan Anda hanya jika redirect_uri cocok dengan URI yang terdaftar. Untuk redirect_uri lainnya, auth.claude.com tidak mengalihkan browser.

Error

Error pada pengalihan

auth.claude.com mengembalikan error sebagai parameter query error, error_description, dan state pada URI pengalihan Anda. Ini adalah error OAuth 2.0 standar (RFC 6749), kecuali user_profile_already_linked, yang khusus untuk Anthropic.

ErrorKapanApa yang ditampilkan kepada pengguna Anda
access_deniedOrang tersebut menolak, atau tidak dapat menyetujui permintaan ini. Untuk koneksi penagihan, orang tersebut harus menjadi administrator organisasi Claude.Jelaskan bahwa koneksi tidak selesai, dan jangan berasumsi bahwa orang tersebut menolak. Untuk koneksi penagihan, ikuti URI pengalihan Anda menerima error=access_denied dalam panduan Linked billing, yang mencantumkan penyebabnya dan apa yang perlu disampaikan kepada orang tersebut. Selain itu, minta orang tersebut untuk menghubungi Anda.
server_errorauth.claude.com gagal memproses permintaan.Minta pengguna untuk mencoba lagi.
user_profile_already_linkedHanya Linked billing. Organisasi pelanggan sudah tertaut ke aplikasi Anda melalui profil pengguna yang berbeda. Setiap organisasi pelanggan dapat memiliki satu koneksi ke aplikasi Anda. auth.claude.com sudah meminta administrator untuk menghubungi Anda.Jelaskan bahwa organisasi mereka sudah tertaut ke aplikasi Anda.

Jika request_uri telah kedaluwarsa atau Anda sudah menggunakannya, auth.claude.com menampilkan halaman error dan tidak mengalihkan browser kembali ke aplikasi Anda. Mulai alur lagi dengan pushed authorization request yang baru.

Error dari endpoint PAR dan token

Endpoint-endpoint ini mengembalikan body JSON dengan error dan error_description.

ErrorKapan
invalid_requestParameter wajib tidak ada atau tidak valid, misalnya state atau challenge PKCE yang tidak ada, atau user_profile_id yang bukan ID profil pengguna aktif di organisasi Anda.
invalid_clientauth.claude.com tidak dapat mengautentikasi aplikasi Anda: ID klien tidak dikenal, atau client assertion gagal diverifikasi. Periksa iss, sub, dan aud dari asersi terhadap pengaturan autentikasi klien aplikasi Anda, dan periksa bahwa penyedia identitas Anda menandatanganinya dengan kunci dalam JWKS Anda.
invalid_scopeScope yang diminta tidak diizinkan untuk aplikasi ini atau tipe koneksi ini. Untuk token koneksi penagihan, ini juga berarti bahwa refresh mengirim parameter scope, yang tidak diterimanya, atau bahwa billing:attribution tidak lagi terdaftar untuk aplikasi Anda. Pada pertukaran kode, penyebab kedua tersebut menghabiskan kode.
invalid_grantKode telah kedaluwarsa, Anda sudah menggunakannya, atau kode tidak cocok dengan redirect_uri atau code_verifier. Untuk refresh, refresh token telah kedaluwarsa atau tidak lagi valid: ikuti Segarkan token.
unauthorized_clientAplikasi Anda tidak disiapkan untuk permintaan ini. Untuk Linked billing, periksa terlebih dahulu akun layanan operator aplikasi dan workspace-nya: lihat Pertukaran kode mengembalikan unauthorized_client. Untuk token koneksi penagihan, error_description menyebutkan penyebabnya, misalnya workspace yang tidak ada. Penolakan ini tidak menghabiskan kode dan tidak mencabut refresh token.
user_profile_already_linkedHanya Linked billing, dari endpoint token. Di antara persetujuan dan permintaan ini, profil pengguna telah tertaut ke aplikasi Anda melalui organisasi pelanggan yang berbeda, atau organisasi pelanggan telah tertaut melalui profil pengguna yang berbeda.

Jika auth.claude.com menerapkan batas laju pada permintaan, mengalami gangguan, atau menerima grant_type yang tidak dikenal atau parameter yang lebih panjang dari batasnya, ia mengembalikan error dalam format berbeda, yang mungkin bukan JSON. Coba ulang hanya pada respons HTTP 429 dan 5xx, dengan backoff. Perlakukan status lainnya sebagai kesalahan dalam permintaan. Untuk refresh koneksi penagihan, ikuti Segarkan token alih-alih backoff umum. Jika respons memiliki header retry-after, tunggu setidaknya selama waktu tersebut. Kirim permintaan berikutnya dari kode Anda sendiri, dan jangan mengandalkan percobaan ulang otomatis dari library klien HTTP: percobaan ulang tersebut mungkin tidak berjalan untuk respons semacam itu. Segarkan token juga menjelaskan kapan percobaan ulang aman, karena refresh token yang sudah digunakan dapat mengakhiri koneksi saat Anda mengirimnya lagi.

Error dari endpoint pencabutan

Untuk sebagian besar permintaan yang ditolak auth.claude.com, endpoint pencabutan mengembalikan HTTP 400 dan body JSON dengan error dan error_description.

ErrorKapan
invalid_requestParameter wajib tidak ada atau tidak valid, misalnya client_id yang tidak ada. Permintaan tidak mengirim satu pun dari token, connection_id, dan user_profile_id, atau mengirim lebih dari satu. Sebuah ID salah format, misalnya memiliki prefiks yang salah. Kredensial atau token berada dalam query string URL. Profil pengguna memiliki terlalu banyak koneksi untuk satu permintaan: permintaan tersebut mungkin telah mengakhiri sebagian di antaranya, jadi akhiri sisanya dengan connection_id.
invalid_clientauth.claude.com tidak dapat mengautentikasi aplikasi Anda. Untuk hal yang perlu diperiksa, lihat invalid_client dalam Error dari endpoint PAR dan token.
unauthorized_clientAplikasi Anda tidak disiapkan untuk permintaan ini. Hubungi tim akun Anthropic Anda.

Respons dalam tabel berikutnya menggunakan format berbeda, yang mungkin bukan JSON. Jika body berupa JSON, error adalah objek, bukan string.

StatusKapanApa yang harus dilakukan
400Sebuah parameter lebih panjang dari batasnya.Perbaiki permintaan. Jangan mencoba ulang.
429Terlalu banyak permintaan gagal yang berasal dari alamat IP Anda.Coba ulang dengan backoff.
500auth.claude.com gagal memproses permintaan.Coba ulang dengan backoff. Jika terus terjadi, hubungi tim akun Anthropic Anda.
501Anthropic belum mengaktifkan endpoint ini untuk organisasi Anda.Jangan mencoba ulang. Hubungi tim akun Anthropic Anda.
503Permintaan tidak selesai. Apa pun yang telah diakhirinya tetap berakhir.Coba ulang dengan backoff, dengan parameter yang sama dan client assertion baru. Percobaan ulang akan menyelesaikan sisanya, dan daftarnya tidak mencantumkan koneksi yang telah diakhiri oleh permintaan sebelumnya. Jika Anda mengirim user_profile_id, coba ulang dalam satu hari: setelah itu, percobaan ulang dapat mengembalikan 200 dengan daftar kosong dan tidak menyelesaikan apa pun. Percobaan ulang dengan setiap connection_id berfungsi kapan saja.

Error penagihan

Ini berlaku untuk permintaan Claude API yang mengatur billing_policy.bill_to ke "user_profile" atau yang melakukan autentikasi dengan token akses koneksi penagihan. Claude API tidak menagih organisasi mana pun untuk permintaan yang ditolak. Tidak ada respons 402 dan 403 yang dapat dicoba ulang, kecuali penolakan user_profile_not_billable dalam 10 detik pertama setelah koneksi baru.

StatusTipe dan kode errorKapan
400invalid_request_errorPermintaan mengirim billing_policy tanpa header beta user-profiles-billing-2026-10-01. Atau objek billing_policy memiliki field yang tidak ada atau tidak valid. Dengan token akses koneksi penagihan, bill_to boleh dihilangkan. Atau permintaan menggunakan eksekusi kode di luar kombinasi yang diizinkan.
400invalid_request_error, user_profile_requiredbill_to adalah "user_profile", permintaan tidak menyertakan ID profil pengguna, dan permintaan tidak melakukan autentikasi dengan token akses koneksi penagihan.
400invalid_request_error, tanpa kode errorPermintaan melakukan autentikasi dengan token akses koneksi penagihan, dan mengatur bill_to ke "self" atau menyebutkan profil pengguna selain profil yang menjadi batasan token tersebut. Masing-masing dari kedua penolakan ini menyebutkan apa yang salah dalam error.message.
401authentication_errorPermintaan melakukan autentikasi dengan token akses koneksi penagihan yang telah kedaluwarsa, yang telah digantikan oleh refresh, atau yang koneksinya telah berakhir. Pesan menyebutkan apakah token telah kedaluwarsa atau telah dicabut. Kirim permintaan lagi dengan token akses saat ini, atau tautkan pelanggan lagi jika koneksi telah berakhir. Setelah koneksi berakhir, setiap permintaan baru dengan token aksesnya dapat menerima 401 ini atau 403 user_profile_not_billable, tanpa urutan tetap.
402billing_error, linked_organization_spend_limit_reachedOrganisasi pelanggan telah mencapai batas pengeluaran yang ditetapkannya, baik untuk aplikasi OAuth Anda maupun untuk seluruh organisasi. Claude API mengirim kode yang sama ketika organisasi tidak memiliki kredit yang dapat membayar permintaan tersebut. Respons tidak menyebutkan yang mana. Minta pelanggan untuk memeriksa kedua batas tersebut dan saldo kreditnya. Error yang diharapkan untuk Linked billing menjelaskan di mana masing-masing ditetapkan dan apa yang perlu diubah.
402billing_error, linked_organization_billing_unavailableAnthropic saat ini tidak dapat menagih organisasi pelanggan karena masalah pada akun Anthropic milik organisasi tersebut. Kode yang sama mengakhiri balasan yang telah dimulai Claude ketika kredit organisasi tersebut habis. Minta pelanggan untuk memeriksa status penagihannya dengan Anthropic.
403permission_error, tanpa kode errorAnthropic tidak menagih organisasi Anda secara langsung, sehingga tidak dapat menagih pelanggan atas nama Anda.
403permission_error, user_profile_not_billableProfil pengguna tidak memiliki koneksi ke organisasi pelanggan, administrator atau back end Anda mengakhiri koneksi, organisasi pelanggan tidak membayar Anthropic secara langsung untuk penggunaan API-nya (kredit prabayar dan penagihan berbasis faktur sama-sama terhitung), atau permintaan tidak diautentikasi sebagai akun layanan aplikasi Anda. Respons tidak menyebutkan yang mana. Token akses koneksi juga dapat menerimanya setelah koneksi berakhir. Penyebab user_profile_not_billable menjelaskan apa yang perlu diperiksa untuk masing-masing penyebab.
503overloaded_errorClaude API untuk sementara tidak dapat memastikan apakah dapat menagih pelanggan. Coba ulang permintaan. Jika respons menyertakan header retry-after, tunggu selama waktu tersebut sebelum mencoba ulang.

Pada /v1/messages, kode error ada di error.details.error_code. Pada /v1/chat/completions, error.type selalu invalid_request_error, error.code berisi tipe error Anthropic (misalnya permission_error atau billing_error), dan respons tidak memiliki kode error, jadi lakukan pencocokan berdasarkan status HTTP dan error.code.

Standar

StandarTempat berlakunya
OAuth 2.0 (RFC 6749)Alur kode otorisasi, endpoint token, dan respons error
PKCE (RFC 7636)Wajib dengan S256 pada setiap permintaan otorisasi
Pushed authorization requests (RFC 9126)Wajib untuk Linked billing.
Pencabutan token (RFC 7009)Endpoint pencabutan, yang juga menerima ID koneksi dan ID profil pengguna serta mengembalikan ID koneksi yang diakhirinya
Autentikasi klien JWT (RFC 7523)Autentikasi klien private_key_jwt di endpoint PAR, token, dan pencabutan, serta pertukaran token akun layanan untuk permintaan yang menagih pelanggan

Istilah yang digunakan di halaman-halaman ini

Arti berikut hanya berlaku untuk Claude Platform OAuth.

IstilahArti
Organisasi ClaudeAkun organisasi dengan Anthropic. Perusahaan Anda memilikinya, demikian juga setiap pelanggan yang menautkan organisasinya untuk penagihan.
AdministratorAnggota organisasi Claude dengan peran Admin atau Penagihan.
Aplikasi OAuthPendaftaran di organisasi Claude Anda yang mengidentifikasi produk Anda ke auth.claude.com. Aplikasi ini memiliki ID klien, nama, logo, URL beranda, URI pengalihan, dan tipe-tipe koneksi yang didukungnya.
Tipe koneksiSiapa yang menyetujui koneksi: administrator atas nama seluruh organisasi (organization_shared, untuk Linked billing).
Penyedia identitasLayanan di infrastruktur Anda sendiri yang menandatangani JWT berumur pendek untuk back end Anda dan memublikasikan kunci publiknya sebagai JSON Web Key Set (JWKS), seperti layanan identitas workload penyedia cloud Anda atau issuer Anda sendiri yang sesuai dengan OIDC. Di halaman-halaman ini, “penyedia identitas Anda” selalu berarti layanan ini, bukan Anthropic.
Client assertionJWT berumur pendek yang ditandatangani oleh penyedia identitas Anda dan dikirim oleh back end Anda untuk mengautentikasi aplikasi OAuth Anda. Ini adalah metode autentikasi klien private_key_jwt (RFC 7523).
Pushed authorization request (PAR)Permintaan di mana back end Anda mengirim parameter otorisasi langsung ke auth.claude.com dan menerima request_uri untuk digunakan dalam pengalihan browser (RFC 9126).
Workload Identity FederationFitur Claude Console yang digunakan organisasi Anda untuk mendaftarkan penyedia identitas Anda, sehingga Anthropic menerima JWT yang ditandatangani dengan kunci dalam JWKS Anda.
Dokumen discoveryDokumen OIDC yang mencantumkan issuer, endpoint, dan kunci penandatanganan Anthropic.
Profil penggunaCatatan yang Anda buat di organisasi Claude Anda sendiri untuk mewakili salah satu pelanggan Anda. Koneksi penagihan menautkan profil pengguna ke organisasi Claude pelanggan.
Akun layananAkun non-manusia di organisasi Claude Anda. Untuk Linked billing, aplikasi OAuth Anda ditautkan ke satu akun layanan, yaitu akun layanan operatornya, dan back end Anda diautentikasi sebagai akun layanan tersebut saat mengirim permintaan yang menagih pelanggan.
Token OAuth koneksiToken akses yang dikembalikan auth.claude.com untuk koneksi penagihan, dan refresh token yang dikembalikannya jika pelanggan juga menyetujui offline_access. Token akses melakukan autentikasi sebagai akun layanan operator dan hanya dapat menagih profil pengguna dari koneksi tersebut. Lihat Token OAuth untuk koneksi penagihan.

Apakah halaman ini membantu?