X-Guard Docs

Mulai cepat ​

X-Guard adalah OpenID Provider per organisasi. Setiap organisasi punya alamat sendiri (issuer), mis. https://nama-organisasi.x-guard.online, atau domain sendiri. Aplikasi menitipkan pengguna ke halaman login organisasi itu, lalu menerima identitasnya lewat OpenID Connect standar.

text
 Browser            Aplikasi Anda                 X-Guard organisasi
    | klik Masuk          |                               |
    |-------------------->| /auth/login                   |
    |<--------------------| alihkan ke /authorize (PKCE)  |
    |------------------------------------------------------>| login (sekali per sesi)
    |<------------------------------------------------------| kembali ke /auth/callback?code=...
    |-------------------->| tukar code (server ke server) |
    |                     |------------------------------>|
    |                     |<------------------------------| ID token (JWT RS256)
    |<--------------------| sesi aplikasi dibuat          |

1. Daftarkan aplikasi ​

Admin organisasi membuka konsol X-Guard → Aplikasi → Tambah aplikasi, mengisi alamat callback dan alamat sesudah logout, lalu menyimpan client ID dan client secret (secret hanya tampil sekali). Rinciannya di Mendaftarkan aplikasi.

2. Catat alamat X-Guard ​

Rincian aplikasi di konsol menampilkan issuer dan panel Panduan integrasi berisi konfigurasi siap salin untuk Laravel, Go, ASP Classic, dan Node.js, sudah terisi nilai aplikasi Anda.

3. Pilih SDK atau pustaka OIDC ​

AplikasiPakai
Laravel 10 sampai 12SDK Laravel
Go (net/http, Gin)SDK Go
ASP Classic (IIS)SDK ASP Classic, tanpa DLL atau komponen tambahan
Node.jsopenid-client
LainnyaPustaka OpenID Connect yang membaca discovery dan mendukung PKCE

4. Isi konfigurasi ​

Simpan di konfigurasi server (env), bukan di kode browser atau repositori:

dotenv
XGUARD_ISSUER=https://nama-organisasi.x-guard.online
XGUARD_CLIENT_ID=...
XGUARD_CLIENT_SECRET=...
XGUARD_REDIRECT_URI=https://aplikasi-anda/auth/callback
XGUARD_POST_LOGOUT_URI=https://aplikasi-anda/

5. Uji ​

  1. Klik Masuk dengan X-Guard, login, dan pastikan kembali ke aplikasi sebagai pengguna itu.
  2. Buka aplikasi organisasi yang lain: langsung masuk tanpa password.
  3. Logout di satu aplikasi: aplikasi lain ikut keluar (lewat back-channel logout atau pemeriksaan sesi berkala).

Sebelum ke produksi, periksa daftar periksa produksi.