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/callbackhttps, 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=S256Contoh 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',
]);// lib/sentra.ts
import { createHash, randomBytes } from "node:crypto";
export type SentraUser = {
sentra_id: string;
name: string;
picture: string | null;
credential: string;
roles: string[];
user_types: string[];
};
export function startSignIn() {
const state = randomBytes(24).toString("base64url");
const verifier = randomBytes(32).toString("base64url");
const challenge = createHash("sha256").update(verifier).digest("base64url");
const url = new URL("/authorize", process.env.SSO_BASE_URL);
url.search = new URLSearchParams({
response_type: "code",
client_id: process.env.SSO_APP_ID!,
redirect_uri: process.env.SSO_REDIRECT_URI!,
state,
code_challenge: challenge,
code_challenge_method: "S256",
}).toString();
return { url: url.toString(), state, verifier };
}code_challenge, Sentra mewajibkan code_verifier yang cocok saat penukaran kode. PKCE dianjurkan untuk semua aplikasi.Parameter tambahan yang opsional:
| Parameter | Arti |
|---|---|
prompt=select_account | Selalu tampilkan pilihan akun. |
prompt=login | Minta pengguna memasukkan kata sandi lagi. |
prompt=consent | Minta izin lagi walau sudah pernah diberikan. |
prompt=none | Jangan 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"$state = $request->session()->pull('sentra_state');
abort_unless($state && hash_equals($state, (string) $request->query('state')), 403);
$response = Http::asForm()
->withBasicAuth(config('services.sentra.app_id'), config('services.sentra.client_secret'))
->post(config('services.sentra.api_url').'/oauth/token', [
'grant_type' => 'authorization_code',
'code' => $request->query('code'),
'redirect_uri' => config('services.sentra.redirect_uri'),
'code_verifier' => $request->session()->pull('sentra_verifier'),
])
->throw();
$user = $response->json('user');// lib/sentra.ts (lanjutan)
export async function exchangeCode(code: string, verifier: string): Promise<SentraUser> {
const basic = Buffer.from(`${process.env.SSO_APP_ID}:${process.env.SSO_CLIENT_SECRET}`).toString("base64");
const res = await fetch(`${process.env.SSO_API_URL}/oauth/token`, {
method: "POST",
headers: { Authorization: `Basic ${basic}` },
body: new URLSearchParams({
grant_type: "authorization_code",
code,
redirect_uri: process.env.SSO_REDIRECT_URI!,
code_verifier: verifier,
}),
});
if (!res.ok) throw new Error(`Sentra token exchange failed: ${res.status}`);
const { user } = (await res.json()) as { user: SentraUser };
return user;
}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"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();