Kode galat

Galat yang bisa ditemui aplikasi klien: di halaman /authorize, di Redirect URI setelah pengguna kembali, dan dari endpoint /oauth/token dan /oauth/userinfo.

Halaman /authorize: Tautan tidak valid

Jika Sentra tidak bisa memastikan aplikasi atau Redirect URI-nya, pengguna tidak diarahkan ke mana pun. Sentra menampilkan halaman Tautan tidak valid berisi client_id, redirect_uri, dan kode galat. Ini mencegah Sentra dipakai untuk mengarahkan pengguna ke alamat yang tidak terdaftar.

KodePenyebabYang harus dilakukan
invalid_clientclient_id tidak dikenal.Periksa SSO_APP_ID.
invalid_redirect_uriredirect_uri tidak sama persis dengan Redirect URI yang terdaftar.Samakan skema, host, port, path, dan query, atau daftarkan URI itu di konsol.
application_inactiveAplikasi dinonaktifkan oleh admin Sentra.Hubungi admin Sentra.
state_requiredstate kosong atau lebih dari 512 karakter.Selalu kirim state acak dari aplikasi Anda.

Karena tidak ada pengalihan, aplikasi Anda tidak menerima apa pun. Galat ini hanya terlihat oleh pengguna, jadi uji tautan masuk setiap kali Anda mengubah Redirect URI.

Di Redirect URI

Setelah aplikasi dan Redirect URI dipastikan, galat lain dikirim kembali ke Redirect URI Anda dengan state yang sama:

https://api.belajar.contoh.id/auth/sso/callback?error=access_denied&state=r7Kx2vQ9mT4w...

Periksa state lebih dulu, seperti pada respons yang berhasil. Galat ini tidak membawa error_description.

errorKapanYang harus dilakukan
access_deniedPengguna menolak di layar izin.Tampilkan pesan dan tombol untuk mencoba lagi.
login_requiredprompt=none, tetapi pengguna belum masuk ke Sentra, sesinya lebih tua dari max_age, atau ia harus mengganti kata sandi dulu.Ulangi tanpa prompt=none supaya pengguna bisa masuk.
consent_requiredprompt=none, tetapi pengguna belum memberi izin ke aplikasi Anda.Ulangi tanpa prompt=none supaya layar izin tampil.
invalid_requestNilai prompt tidak dikenal, max_age bukan bilangan bulat 0 atau lebih, code_challenge_method selain S256, atau code_challenge tidak 43–128 karakter.Perbaiki parameter /authorize.
unsupported_response_typeresponse_type selain code.Kirim response_type=code.

Tanpa prompt=none, Sentra tidak mengembalikan galat untuk keadaan ini: pengguna diminta masuk, mengganti kata sandi, atau memberi izin lebih dulu.

POST /oauth/token

Galat token mengikuti format OAuth 2.0, dengan header Cache-Control: no-store:

curl -i -X POST "$SSO_API_URL/oauth/token" \
  -u "$SSO_APP_ID:$SSO_CLIENT_SECRET" \
  --data-urlencode grant_type=authorization_code \
  --data-urlencode code=kode-yang-salah \
  --data-urlencode redirect_uri="$SSO_REDIRECT_URI"
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
Cache-Control: no-store

{"error":"invalid_grant","error_description":"code is invalid"}
Statuserrorerror_descriptionArti dan tindakan
400invalid_requestcode and redirect_uri are requiredcode atau redirect_uri tidak dikirim.
400invalid_requestparameters must be sent in the body, not the URLPindahkan parameter dari query string ke body.
400invalid_requestuse one client authentication methodKirim kredensial lewat HTTP Basic atau body, jangan keduanya.
400invalid_requestclient_id does not match the Authorization headerclient_id di body berbeda dari HTTP Basic.
400unsupported_grant_typeonly authorization_code is supportedKirim grant_type=authorization_code.
401invalid_clientclient authentication failedApp ID atau Client secret salah, tidak dikirim, atau aplikasi nonaktif. Setelah merotasi secret, perbarui .env.
400invalid_grantcode is invalidKode tidak dikenal atau milik aplikasi lain.
400invalid_grantcode was already usedKode sudah ditukar. Jangan ulangi penukaran.
400invalid_grantcode expiredLebih dari 60 detik. Tukar kode segera di callback.
400invalid_grantredirect_uri does not matchKirim redirect_uri yang sama dengan di /authorize.
400invalid_grantcode_verifier is required/authorize memakai PKCE; kirim code_verifier.
400invalid_grantcode_verifier does not matchcode_verifier bukan pasangan code_challenge. Periksa nilai di sesi.
400invalid_grantcode_verifier sent but no code_challenge wasKirim code_verifier hanya jika /authorize memakai PKCE.
400invalid_grantuser is not activeAkun dinonaktifkan di Sentra. Tolak masuk.
429slow_downtoo many token requestsTerlalu banyak permintaan dari IP Anda. Tunggu sebentar.
500server_errortry again laterGangguan di Sentra. Coba lagi nanti.
Untuk semua invalid_grant, kode sudah tidak bisa dipakai. Arahkan pengguna untuk masuk lagi dari awal; jangan coba ulang dengan kode yang sama.

GET /oauth/userinfo

curl -i "$SSO_API_URL/oauth/userinfo" -H "Authorization: Bearer x"
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer error="invalid_token"

{"error":"invalid_token","error_description":"the access token is invalid or expired"}
Statuserrorerror_descriptionArti dan tindakan
401invalid_tokenmissing bearer tokenKirim header Authorization: Bearer <token>.
401invalid_tokenthe access token is invalid or expiredToken rusak atau sudah lewat 15 menit. Tidak ada refresh token: minta pengguna masuk lagi jika Anda butuh data terbaru.
401invalid_tokenthe application is not activeAplikasi Anda dinonaktifkan.
401invalid_tokenthe user is not activeAkun dinonaktifkan di Sentra. Akhiri sesi pengguna di aplikasi Anda.
500server_errortry again laterGangguan di Sentra. Coba lagi nanti.