Endpoint

Semua yang dipanggil aplikasi klien: satu halaman di browser (/authorize) dan tiga endpoint server ke server.

EndpointAlamatDipanggil dari
GET /authorizehttps://sso.sentratechnology.comBrowser pengguna
POST /oauth/tokenhttps://api.sso.sentratechnology.comServer Anda
GET /oauth/userinfohttps://api.sso.sentratechnology.comServer Anda
GET /.well-known/jwks.jsonhttps://api.sso.sentratechnology.comServer Anda

Masa berlaku

ItemMasa berlaku
code60 detik, sekali pakai.
Access token15 menit (expires_in: 900).
Refresh tokenTidak ada. Sesi aplikasi Anda yang mengatur lama login.
Sesi Sentra24 jam, tidak diperpanjang oleh aktivitas.

GET /authorize

Arahkan browser pengguna ke halaman ini untuk memulai proses masuk.

ParameterWajibArti
response_typeYaSelalu code.
client_idYaApp ID dari konsol (app_…).
redirect_uriYaHarus sama persis dengan salah satu Redirect URI yang terdaftar.
stateYaNilai acak dari aplikasi Anda, maksimal 512 karakter. Dikembalikan apa adanya.
code_challengeTidakPKCE: SHA-256 dari code_verifier, base64url tanpa =. 43–128 karakter.
code_challenge_methodJika ada code_challengeHanya S256.
promptTidakselect_account, login, consent, atau none.
max_ageTidakDetik. Minta masuk ulang jika sesi Sentra lebih tua dari nilai ini.

Arti setiap nilai prompt:

NilaiArti
select_accountSelalu tampilkan pilihan akun.
loginMinta pengguna memasukkan kata sandi lagi.
consentMinta izin lagi walau sudah pernah diberikan.
noneJangan 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...
Jika 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.

ParameterWajibArti
grant_typeYaSelalu authorization_code.
codeYaKode dari callback.
redirect_uriYaSama dengan yang dikirim ke /authorize.
code_verifierJika ada code_challengeNilai 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:

KlaimIsi
issAlamat API Sentra.
subsentra_id pengguna.
audApp ID Anda. Tolak token dengan aud lain.
client_idApp ID Anda.
iat, nbf, expWaktu terbit, mulai berlaku, dan kedaluwarsa (15 menit).
jtiID unik token.