«تسجيل الدخول عبر EL OUATINE»

كيف يعمل؟

تدفّق OAuth2 القياسي — رمز التفويض (Authorization Code)

النطاقات (Scopes)

• profile — المعرّف + الاسم — الحدّ الأدنى لأي تسجيل دخول.
• email — البريد الإلكتروني المسجّل — يُمنح فقط بموافقة صريحة من المستخدم.

دليل الدمج

• أنشئ عميلًا وسجّل السرّ
  POST /api/oauth/v1/clients من جلسة مسجّلة — يُعرض client_secret مرة واحدة فقط. احفظه في خادمك، ولا تضعه أبدًا في كود الواجهة.
• وجّه المستخدم للموافقة
  GET /oauth/authorize?client_id=…&redirect_uri=…&response_type=code&scope=profile%20email&state=… — يجب أن يطابق redirect_uri أحد الروابط المسجّلة حرفيًا.
• استبدل الرمز بتوكن
  POST /oauth/token خلال ١٠ دقائق: {grant_type:"authorization_code", code, redirect_uri, client_id, client_secret}.
• اقرأ بيانات المستخدم
  GET /oauth/userinfo مع Authorization: Bearer <access_token> — التوكن صالح لساعة واحدة.

مثال: استبدال الرمز (curl)

curl -X POST https://securecelleouatine.com/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "authorization_code",
    "code": "RECEIVED_CODE",
    "redirect_uri": "https://your-app.example/callback",
    "client_id": "eloauth_YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET"
  }'

مثال: قراءة الملف الشخصي (JavaScript)

const res = await fetch('https://securecelleouatine.com/oauth/userinfo', {
  headers: { 'Authorization': 'Bearer ' + accessToken }
});
const profile = await res.json(); // { sub, name, email? }
if (res.status === 401) { /* التوكن منتهي أو ملغي — أعد التوجيه للموافقة */ }

الحدود والقيود

• رمز التفويض: صالح ١٠ دقائق، استعمال واحد فقط — إعادة الاستعمال تُرفَض.
• توكن الوصول: صالح ساعة واحدة، لا توجد توكنات تحديث (يُعاد التوجيه للموافقة).
• redirect_uri: يجب أن يطابق حرفيًا أحد الروابط المسجّلة — https إجباري (يُسمح بـ http لـ localhost فقط أثناء التطوير).
• نقطة /oauth/token محدودة المعدّل: ٣٠ طلبًا/دقيقة لكل عميل.
• الأسرار تُخزَّن مُجزَّأة (SHA-256) ولا تُسجَّل في السجلات أبدًا.