Mulai cepat

Tambahkan "Masuk dengan Sentra" ke aplikasi Anda. Sentra memberi tahu siapa penggunanya; sesi dan peran tetap diatur aplikasi Anda.

1. Daftarkan aplikasi

Buka konsol, buat aplikasi, lalu isi Redirect URI (alamat callback di server Anda) dan URL masuk. Unduh .env dari konsol dan simpan di server. Client secret hanya tampil sekali.

SSO_BASE_URL=https://sso.sentratechnology.com
SSO_API_URL=https://api.sso.sentratechnology.com
SSO_APP_ID=app_9fk2mq7xlr4tzw8nb3vh5cyd
SSO_CLIENT_SECRET=sec_...
SSO_REDIRECT_URI=https://api.belajar.contoh.id/auth/sso/callback
Redirect URI harus sama persis dengan yang terdaftar, termasuk skema, port, dan path. Gunakan https, kecuali untuk localhost saat pengembangan.

2. Arahkan pengguna ke Sentra

Buat nilai state acak dan code_verifier PKCE, simpan keduanya di sesi pengguna, lalu arahkan pengguna ke /authorize.

https://sso.sentratechnology.com/authorize
  ?response_type=code
  &client_id=app_9fk2mq7xlr4tzw8nb3vh5cyd
  &redirect_uri=https://api.belajar.contoh.id/auth/sso/callback
  &state=r7Kx2vQ9mT4w...
  &code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM
  &code_challenge_method=S256

Contoh untuk Laravel (di route redirect) dan Next.js (modul server):

$state = Str::random(40);
$verifier = Str::random(64);
$challenge = rtrim(strtr(base64_encode(hash('sha256', $verifier, true)), '+/', '-_'), '=');

$request->session()->put(['sentra_state' => $state, 'sentra_verifier' => $verifier]);

$url = config('services.sentra.base_url').'/authorize?'.http_build_query([
    'response_type'         => 'code',
    'client_id'             => config('services.sentra.app_id'),
    'redirect_uri'          => config('services.sentra.redirect_uri'),
    'state'                 => $state,
    'code_challenge'        => $challenge,
    'code_challenge_method' => 'S256',
]);
Jika Anda mengirim code_challenge, Sentra mewajibkan code_verifier yang cocok saat penukaran kode. PKCE dianjurkan untuk semua aplikasi.

Parameter tambahan yang opsional:

ParameterArti
prompt=select_accountSelalu tampilkan pilihan akun.
prompt=loginMinta pengguna memasukkan kata sandi lagi.
prompt=consentMinta izin lagi walau sudah pernah diberikan.
prompt=noneJangan tampilkan layar apa pun. Jika pengguna belum masuk atau belum memberi izin, Sentra kembali dengan error=login_required atau error=consent_required.
max_age=<detik>Minta masuk ulang jika sesi Sentra lebih tua dari nilai ini.

3. Tukar kode di server

Sentra mengembalikan code dan state ke Redirect URI Anda. Pastikan state sama dengan yang Anda simpan, lalu tukar code dari server dalam 60 detik. Kode hanya bisa dipakai sekali.

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"
Jangan pernah menaruh Client secret di kode browser. Jika pengguna menolak, Sentra kembali dengan error=access_denied dan state yang sama.

4. Baca data pengguna

Respons berisi identitas pengguna. Access token berlaku 15 menit dan tidak perlu disimpan jika Anda hanya butuh login.

{
  "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"]
  }
}

Butuh data terbaru selama token masih berlaku? Panggil userinfo:

curl "$SSO_API_URL/oauth/userinfo" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
Jadikan sentra_id kunci pengguna. credential berisi email jika akun punya email, jika tidak berisi username, jadi jangan menganggapnya selalu alamat email dan jangan menautkan akun berdasarkan kolom ini. roles berisi peran yang diberikan admin untuk aplikasi Anda, dan user_types berisi tipe pengguna.

5. Buat sesi di aplikasi Anda

Cari atau buat pengguna berdasarkan sentra_id, tentukan perannya, lalu buat sesi aplikasi. Lama sesi sepenuhnya Anda yang menentukan; Sentra tidak memberikan refresh token. Contoh Laravel:

$account = User::updateOrCreate(
    ['sentra_id' => $user['sentra_id']],
    ['name' => $user['name']],
);

Auth::login($account);
$request->session()->regenerate();