Endpoint
Semua yang dipanggil aplikasi klien: satu halaman di browser (/authorize) dan tiga endpoint server ke server.
| Endpoint | Alamat | Dipanggil dari |
|---|---|---|
GET /authorize | https://sso.sentratechnology.com | Browser pengguna |
POST /oauth/token | https://api.sso.sentratechnology.com | Server Anda |
GET /oauth/userinfo | https://api.sso.sentratechnology.com | Server Anda |
GET /.well-known/jwks.json | https://api.sso.sentratechnology.com | Server Anda |
Masa berlaku
| Item | Masa berlaku |
|---|---|
code | 60 detik, sekali pakai. |
| Access token | 15 menit (expires_in: 900). |
| Refresh token | Tidak ada. Sesi aplikasi Anda yang mengatur lama login. |
| Sesi Sentra | 24 jam, tidak diperpanjang oleh aktivitas. |
GET /authorize
Arahkan browser pengguna ke halaman ini untuk memulai proses masuk.
| Parameter | Wajib | Arti |
|---|---|---|
response_type | Ya | Selalu code. |
client_id | Ya | App ID dari konsol (app_…). |
redirect_uri | Ya | Harus sama persis dengan salah satu Redirect URI yang terdaftar. |
state | Ya | Nilai acak dari aplikasi Anda, maksimal 512 karakter. Dikembalikan apa adanya. |
code_challenge | Tidak | PKCE: SHA-256 dari code_verifier, base64url tanpa =. 43–128 karakter. |
code_challenge_method | Jika ada code_challenge | Hanya S256. |
prompt | Tidak | select_account, login, consent, atau none. |
max_age | Tidak | Detik. Minta masuk ulang jika sesi Sentra lebih tua dari nilai ini. |
Arti setiap nilai prompt:
| Nilai | Arti |
|---|---|
select_account | Selalu tampilkan pilihan akun. |
login | Minta pengguna memasukkan kata sandi lagi. |
consent | Minta izin lagi walau sudah pernah diberikan. |
none | Jangan tampilkan layar apa pun. Jika perlu masuk atau izin, Sentra kembali dengan galat. |
Jika berhasil, Sentra mengarahkan browser ke Redirect URI Anda:
https://api.belajar.contoh.id/auth/sso/callback?code=Qm8xT2...&state=r7Kx2vQ9mT4w...Jika permintaan ditolak atau tidak valid, Sentra kembali dengan error dan state yang sama:
https://api.belajar.contoh.id/auth/sso/callback?error=access_denied&state=r7Kx2vQ9mT4w...client_id atau redirect_uri tidak cocok, aplikasinya nonaktif, atau state tidak ada, Sentra tidak mengarahkan ke mana pun dan menampilkan halaman Tautan tidak valid. Daftar lengkapnya ada di Kode galat.POST /oauth/token
Tukar code dengan access token dan data pengguna. Kirim parameter di body (application/x-www-form-urlencoded atau JSON), bukan di URL.
Autentikasi aplikasi dengan HTTP Basic (app_id:client_secret), atau dengan client_id dan client_secret di body. Pakai salah satu, jangan keduanya.
| Parameter | Wajib | Arti |
|---|---|---|
grant_type | Ya | Selalu authorization_code. |
code | Ya | Kode dari callback. |
redirect_uri | Ya | Sama dengan yang dikirim ke /authorize. |
code_verifier | Jika ada code_challenge | Nilai asli PKCE. Jangan kirim jika /authorize tidak memakai PKCE. |
curl -X POST "$SSO_API_URL/oauth/token" \
-u "$SSO_APP_ID:$SSO_CLIENT_SECRET" \
--data-urlencode grant_type=authorization_code \
--data-urlencode code="$CODE" \
--data-urlencode redirect_uri="$SSO_REDIRECT_URI" \
--data-urlencode code_verifier="$CODE_VERIFIER"Respons 200, dengan Cache-Control: no-store:
{
"access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6...",
"token_type": "Bearer",
"expires_in": 900,
"user": {
"sentra_id": "8f3a1c52-7d0e-4b6a-9c21-5e7f0a3d9b14",
"name": "Aisyah Rahmawati",
"picture": "https://api.sso.sentratechnology.com/files/8f3a1c52.jpg",
"credential": "aisyah.rahmawati@contoh.id",
"roles": ["editor"],
"user_types": ["umum"]
}
}Isi user dijelaskan di Data pengguna. Permintaan ke endpoint ini dibatasi per alamat IP.
GET /oauth/userinfo
Ambil data pengguna terbaru selama access token masih berlaku. POST juga diterima.
curl "$SSO_API_URL/oauth/userinfo" \
-H "Authorization: Bearer $ACCESS_TOKEN"Respons 200 berisi objek user yang sama, tanpa pembungkus:
{
"sentra_id": "8f3a1c52-7d0e-4b6a-9c21-5e7f0a3d9b14",
"name": "Aisyah Rahmawati",
"picture": "https://api.sso.sentratechnology.com/files/8f3a1c52.jpg",
"credential": "aisyah.rahmawati@contoh.id",
"roles": ["editor"],
"user_types": ["umum"]
}Endpoint ini menjawab 401 invalid_token jika token kedaluwarsa, akun pengguna dinonaktifkan, atau aplikasi Anda dinonaktifkan.
GET /.well-known/jwks.json
Kunci publik untuk memeriksa tanda tangan access token sendiri. Anda tidak membutuhkannya jika hanya memakai user dari /oauth/token.
curl "$SSO_API_URL/.well-known/jwks.json"{
"keys": [
{
"kty": "RSA",
"use": "sig",
"alg": "RS256",
"kid": "2026-11",
"n": "5YjVAn4Ogke3VoIthANrR0AV0xhpU_IZcWArYo5_lf2Q...",
"e": "AQAB"
}
]
}Respons boleh di-cache 5 menit. Saat kunci diganti, kunci lama tetap ada di daftar untuk sementara, jadi pilih kunci berdasarkan kid di header token.
Access token adalah JWT RS256 dengan klaim berikut:
| Klaim | Isi |
|---|---|
iss | Alamat API Sentra. |
sub | sentra_id pengguna. |
aud | App ID Anda. Tolak token dengan aud lain. |
client_id | App ID Anda. |
iat, nbf, exp | Waktu terbit, mulai berlaku, dan kedaluwarsa (15 menit). |
jti | ID unik token. |