Asosiy qismga oʻtish

Misollar · 15-bob

Mobil ilovalar va SPA

Foydalanuvchi qurilmasida ishlaydigan ilovalar secretni saqlay olmaydi. Ular ochiq klientlar: client_secret yoʻq, himoyani PKCE taʼminlaydi.

2 daqiqa oʻqish

Backendni afzal koʻring

Ilovangizning oʻz serveri boʻlsa, server maxfiy klient boʻlsin va kirish oʻsha yerda bajarilsin (PHP, Node.js yoki Python boblariga qarang). Shunda brauzer yoki ilova faqat oʻzingizning sessiya cookie ni saqlaydi — tokenlar qurilmaga hech qachon yetib bormaydi. Bu eng xavfsiz va biz tavsiya qiladigan variant.

Mobil ilovalar

  • Tizim brauzeridan sertifikatlangan kutubxona orqali foydalaning: AppAuth for iOS, AppAuth for Android yoki flutter_appauth. Hech qachon ichki WebView ichida kirmang — u yerda foydalanuvchi haqiqiy manzilni koʻra olmaydi.
  • Redirect URI lar https boʻlishi shart. Ilovangizga biriktirilgan https havoladan foydalaning: iOS da Universal Links, Android da (tasdiqlangan) App Links, masalan https://example.com/app/goxost-callback. Maxsus URL sxemalari qabul qilinmaydi.
  • Refresh token olish uchun offline_access ni soʻrang va uni Keychain (iOS) yoki Keystore asosidagi xotirada (Android) saqlang.
  • Refresh tokenlar almashtiriladi: har doim yangisini saqlang va yangilashlarni ketma-ket bajaring, shunda ikki soʻrov hech qachon bir xil tokendan foydalanmaydi.
// Flutter, flutter_appauth
final result = await const FlutterAppAuth().authorizeAndExchangeCode(
  AuthorizationTokenRequest(
    'gxid_01JD3W8V6Q2N9F4K7T5R0YHXBM',
    'https://example.com/app/goxost-callback',
    issuer: 'https://myid.goxost.net',
    scopes: ['openid', 'profile', 'email', 'offline_access'],
  ),
);
// result.idToken, result.accessToken, result.refreshToken — PKCE S256 is automatic

Bir sahifali ilovalar

  • response_type: 'code' bilan oidc-client-ts kabi sertifikatlangan kutubxonadan foydalaning; u PKCE ni avtomatik bajaradi.
  • Callback sahifangizning aynan https URL manzilini roʻyxatdan oʻtkazing (ishlab chiqish uchun http://localhost:5173/callback ni ham).
  • Tokenlarni xotirada saqlang. Refresh tokenlarni localStorage ga qoʻymang — sahifaga kiritilgan har qanday skript ularni oʻqiy oladi.
  • Qatʼiy Content Security Policy oʻrnating; SPA faqat u yuklaydigan skriptlar darajasida xavfsiz.
import { UserManager } from 'oidc-client-ts';

const auth = new UserManager({
  authority: 'https://myid.goxost.net',
  client_id: 'gxid_01JD3W8V6Q2N9F4K7T5R0YHXBM',
  redirect_uri: 'https://app.example.com/callback',
  post_logout_redirect_uri: 'https://app.example.com/',
  response_type: 'code',
  scope: 'openid profile email',
});

// sign-in button
await auth.signinRedirect();

// on /callback
const user = await auth.signinCallback(); // user.profile.sub

Ochiq klientning token soʻrovi

Ochiq klient client_id ni soʻrov tanasida yuboradi, secret yubormaydi:

curl -X POST https://myid.goxost.net/oauth/token \
  -d grant_type=authorization_code \
  -d client_id=gxid_01JD3W8V6Q2N9F4K7T5R0YHXBM \
  -d code=Splx10BeZQQYbYS6WxSbIA \
  -d redirect_uri=https://app.example.com/callback \
  -d code_verifier=YOUR_CODE_VERIFIER