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.
| Kode | Penyebab | Yang harus dilakukan |
|---|---|---|
invalid_client | client_id tidak dikenal. | Periksa SSO_APP_ID. |
invalid_redirect_uri | redirect_uri tidak sama persis dengan Redirect URI yang terdaftar. | Samakan skema, host, port, path, dan query, atau daftarkan URI itu di konsol. |
application_inactive | Aplikasi dinonaktifkan oleh admin Sentra. | Hubungi admin Sentra. |
state_required | state 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.
error | Kapan | Yang harus dilakukan |
|---|---|---|
access_denied | Pengguna menolak di layar izin. | Tampilkan pesan dan tombol untuk mencoba lagi. |
login_required | prompt=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_required | prompt=none, tetapi pengguna belum memberi izin ke aplikasi Anda. | Ulangi tanpa prompt=none supaya layar izin tampil. |
invalid_request | Nilai 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_type | response_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"}| Status | error | error_description | Arti dan tindakan |
|---|---|---|---|
| 400 | invalid_request | code and redirect_uri are required | code atau redirect_uri tidak dikirim. |
| 400 | invalid_request | parameters must be sent in the body, not the URL | Pindahkan parameter dari query string ke body. |
| 400 | invalid_request | use one client authentication method | Kirim kredensial lewat HTTP Basic atau body, jangan keduanya. |
| 400 | invalid_request | client_id does not match the Authorization header | client_id di body berbeda dari HTTP Basic. |
| 400 | unsupported_grant_type | only authorization_code is supported | Kirim grant_type=authorization_code. |
| 401 | invalid_client | client authentication failed | App ID atau Client secret salah, tidak dikirim, atau aplikasi nonaktif. Setelah merotasi secret, perbarui .env. |
| 400 | invalid_grant | code is invalid | Kode tidak dikenal atau milik aplikasi lain. |
| 400 | invalid_grant | code was already used | Kode sudah ditukar. Jangan ulangi penukaran. |
| 400 | invalid_grant | code expired | Lebih dari 60 detik. Tukar kode segera di callback. |
| 400 | invalid_grant | redirect_uri does not match | Kirim redirect_uri yang sama dengan di /authorize. |
| 400 | invalid_grant | code_verifier is required | /authorize memakai PKCE; kirim code_verifier. |
| 400 | invalid_grant | code_verifier does not match | code_verifier bukan pasangan code_challenge. Periksa nilai di sesi. |
| 400 | invalid_grant | code_verifier sent but no code_challenge was | Kirim code_verifier hanya jika /authorize memakai PKCE. |
| 400 | invalid_grant | user is not active | Akun dinonaktifkan di Sentra. Tolak masuk. |
| 429 | slow_down | too many token requests | Terlalu banyak permintaan dari IP Anda. Tunggu sebentar. |
| 500 | server_error | try again later | Gangguan di Sentra. Coba lagi nanti. |
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"}| Status | error | error_description | Arti dan tindakan |
|---|---|---|---|
| 401 | invalid_token | missing bearer token | Kirim header Authorization: Bearer <token>. |
| 401 | invalid_token | the access token is invalid or expired | Token rusak atau sudah lewat 15 menit. Tidak ada refresh token: minta pengguna masuk lagi jika Anda butuh data terbaru. |
| 401 | invalid_token | the application is not active | Aplikasi Anda dinonaktifkan. |
| 401 | invalid_token | the user is not active | Akun dinonaktifkan di Sentra. Akhiri sesi pengguna di aplikasi Anda. |
| 500 | server_error | try again later | Gangguan di Sentra. Coba lagi nanti. |