Di lingkungan perseroan skala menengah hingga korporat multinasional, fragmentasi identitas digital merupakan salah satu tantangan keamanan dan operasional terbesar bagi divisi Teknologi Informasi. Ketika seorang karyawan baru bergabung, administrator harus membuatkan akun secara terpisah di aplikasi ERP, CRM, portal vendor, sistem absensi, dan puluhan aplikasi web kustom internal.
Sebaliknya, ketika karyawan tersebut mengundurkan diri atau dimutasi, risiko keamanan akun tertinggal (orphan accounts) menjadi sangat tinggi jika hak akses tidak dicabut serentak di setiap sistem. Dari sudut pandang pengguna, menghafal lusinan kombinasi kata sandi berbeda memicu kebiasaan buruk mencatat kata sandi di kertas tempel atau menggunakan kata sandi yang sama secara berulang.
Solusi terstandarisasi untuk mengatasi masalah ini adalah menerapkan arsitektur Single Sign-On (SSO) menggunakan solusi Identity and Access Management (IAM) open-source tingkat enterprise seperti Keycloak, yang mampu menjembatani protokol tradisional SAML 2.0 dan protokol modern OpenID Connect (OIDC).
Arsitektur Identity Brokering Menggunakan Keycloak:
Karyawan / Pengguna
│
▼ Akses Aplikasi Web
┌────────────────────────────────────────────────────────┐
│ Aplikasi Web Kustom (Next.js / Portal Klien B2B) │
└────────────────────────────────────────────────────────┘
│ (OIDC / OAuth 2.0 Authorization Code + PKCE)
▼
┌────────────────────────────────────────────────────────┐
│ Keycloak IAM Gateway (Identity Broker & Policy Engine) │
│ - Manajemen Sesi Tunggal (Single Sign-On & Log-Out) │
│ - Pemetaan Atribut & Role-Based Access Control (RBAC) │
└────────────────────────────────────────────────────────┘
│ (Federasi Identitas Lintas Sistem)
├────────────────────────────────────────┐
▼ (SAML 2.0 Assertion) ▼ (LDAP / Kerberos Sync)
┌───────────────────────────────┐ ┌───────────────────────────────┐
│ Active Directory / Azure AD │ │ On-Premise Corporate LDAP / AD│
│ (Pusat Identitas Korporat) │ │ (Data Karyawan & Organisasi) │
└───────────────────────────────┘ └───────────────────────────────┘
Memahami Perbedaan Protokol: SAML 2.0 vs OpenID Connect (OIDC) #
Terdapat dua protokol standar industri yang mendominasi integrasi SSO:
1. SAML 2.0 (Security Assertion Markup Language) #
- Format Payload: Berbasis dokumen XML berukuran besar dengan tanda tangan digital XML Signature.
- Karakteristik: Standar matang yang telah digunakan selama lebih dari dua dekade. Sangat umum ditemukan di lingkungan perbankan, instansi pemerintah, dan integrasi enterprise warisan seperti Microsoft ADFS.
- Kelemahan: Kompleks untuk diurai (parse) pada aplikasi seluler (iOS/Android) atau Single Page Application (SPA), serta membutuhkan overhead bandwidth yang cukup besar untuk pertukaran assertion XML.
2. OpenID Connect (OIDC) #
- Format Payload: Dibangun sebagai lapisan identitas di atas kerangka kerja otorisasi OAuth 2.0, menggunakan token JSON Web Token (JWT) yang ringkas dan terstandarisasi.
- Karakteristik: Sangat mudah diproses oleh browser modern dan perangkat mobile. Menggunakan tiga jenis token terpisah: ID Token (informasi profil pengguna), Access Token (kunci otorisasi memanggil API), dan Refresh Token (memperpanjang sesi tanpa login ulang).
- Standar Keamanan: Mendukung ekstensi PKCE (Proof Key for Code Exchange) untuk mencegah pembajakan kode otorisasi pada klien publik.
Peran Keycloak sebagai Identity Broker Enterprise #
Alih-alih memaksa setiap aplikasi web internal mengimplementasikan integrasi rumit ke Active Directory perusahaan, Keycloak bertindak sebagai gerbang terpusat (Identity Broker):
- Keycloak berbicara ke Active Directory menggunakan protokol SAML 2.0 atau sinkronisasi LDAP internal.
- Keycloak menyajikan antarmuka modern OIDC ke seluruh aplikasi web frontend (seperti aplikasi Next.js, React, atau mobile apps).
- Jika perusahaan berganti penyedia direktori dari Microsoft Active Directory ke Okta atau Google Workspace, tidak ada satupun aplikasi web internal yang perlu diubah konfigurasinya.
Alur Autentikasi Authorization Code Flow dengan PKCE #
Alur paling aman untuk aplikasi web modern adalah Authorization Code Flow with PKCE:
- Pengguna membuka aplikasi Next.js dan menekan tombol "Login SSO".
- Aplikasi menghasilkan nilai acak
code_verifierdan membuat hash SHA-256 bernamacode_challenge. - Browser diarahkan ke Keycloak dengan menyertakan
code_challenge. - Pengguna memasukkan kredensial korporat di halaman login Keycloak (termasuk verifikasi 2FA/MFA).
- Keycloak mengalihkan browser kembali ke aplikasi dengan membawa parameter sementara
authorization_code. - Server aplikasi Next.js memanggil endpoint token Keycloak di jalur belakang (back-channel) dengan menyertakan
authorization_codedancode_verifierasli. - Keycloak memverifikasi kecocokan hash dan menerbitkan token JWT resmi ke aplikasi.
Implementasi Integrasi pada Aplikasi Next.js #
Berikut adalah contoh konfigurasi otentikasi OIDC Keycloak pada Next.js menggunakan library standar industri:
// app/api/auth/[...nextauth]/route.ts
import NextAuth, { NextAuthOptions } from 'next-auth';
import KeycloakProvider from 'next-auth/providers/keycloak';
export const authOptions: NextAuthOptions = {
providers: [
KeycloakProvider({
clientId: process.env.KEYCLOAK_CLIENT_ID!,
clientSecret: process.env.KEYCLOAK_CLIENT_SECRET!,
issuer: process.env.KEYCLOAK_ISSUER!, // Contoh: https://sso.perusahaan.co.id/realms/corporate
}),
],
callbacks: {
async jwt({ token, account, profile }: any) {
// Saat login pertama, salin access token dan peran RBAC dari payload Keycloak
if (account && profile) {
token.accessToken = account.access_token;
token.refreshToken = account.refresh_token;
token.roles = profile.realm_access?.roles || [];
}
return token;
},
async session({ session, token }: any) {
// Teruskan peran pengguna ke sesi browser untuk kontrol otorisasi halaman UI
session.accessToken = token.accessToken;
session.user.roles = token.roles;
return session;
},
},
};
const handler = NextAuth(authOptions);
export { handler as GET, handler as POST };
Pemetaan Peran (Role-Based Access Control) Terpusat #
Dengan mengintegrasikan Keycloak:
- Administrator mendefinisikan peran global di realm Keycloak (misalnya
finance_manager,procurement_staff,system_auditor). - Peran-peran ini otomatis disematkan ke dalam klaim token JWT (
realm_access.roles). - Komponen antarmuka web dan API backend dapat memeriksa izin akses secara instan tanpa perlu query tambahan ke database aplikasi lokal:
// Contoh proteksi rute di Next.js App Router
import { getServerSession } from 'next-auth';
import { authOptions } from '@/app/api/auth/[...nextauth]/route';
import { redirect } from 'next/navigation';
export default async function FinancialAuditPage() {
const session = await getServerSession(authOptions);
if (!session) {
redirect('/api/auth/signin');
}
const userRoles: string[] = (session as any).user?.roles || [];
if (!userRoles.includes('system_auditor')) {
return <div className="p-8 text-danger">Akses Ditolak: Anda tidak memiliki izin Auditor Keuangan.</div>;
}
return <main className="p-8">Panel Laporan Audit Finansial Enterprise</main>;
}
Penerapan SSO berbasis Keycloak memberikan keseimbangan sempurna antara kenyamanan akses bagi karyawan, efisiensi operasional bagi tim IT, dan penegakan kepatuhan tata kelola identitas digital yang ketat bagi perusahaan.
