> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# دليل البدء السريع للمصادقة: أول تسجيل دخول في 10 دقائق

> فعّل مصادقة Didit في بيئة تجريبية، وسجّل دخول المستخدم عبر صفحة مستضافة، ثم تحقق من رمز الوصول على الخادم.

يشرح هذا الدليل السريع كيفية تشغيل Didit Authentication من البداية إلى النهاية في حوالي 10 دقائق.
تقوم بتسجيل رابط استدعاء في تطبيق في البيئة التجريبية، وتفعيل طريقة تسجيل دخول، وتسجيل دخول المستخدم عبر صفحة تسجيل الدخول المستضافة، ثم التحقق من access token على الخادم الخاص بك، وتشاهد عملية تسجيل الدخول في Business Console.

## المتطلبات الأساسية

* حساب Didit مع تطبيق في البيئة التجريبية (Sandbox). إنشاء الحساب مجاني، وميزة المصادقة مفعّلة في كل تطبيق في البيئة التجريبية.
* Node.js 20 أو أحدث، وتطبيق ويب يمكنك تشغيله على `http://localhost:3000`.

## الخطوات

**1. افتح تطبيق Sandbox الخاص بك**

في [Business Console](https://business.didit.me)، استخدم مبدّل التطبيقات لتحديد تطبيق **Sandbox** الخاص بك، ثم افتح **Authentication**.

يقبل تطبيق Sandbox عمليات الاستدعاء على `http://localhost` وبيانات اعتماد الاختبار الخاصة بـ Didit لتسجيل الدخول عبر وسائل التواصل الاجتماعي، ولا تُفرض عليه أي رسوم أبداً.
أما تطبيق Live فتُفعّل فيه المصادقة من صفحة **Products** بدلاً من ذلك: راجع [تهيئة تطبيقك](https://docs.didit.me/ar/authentication/overview.md#تجهيز-تطبيقك).

**2. سجّل رابط الاستدعاء والأصل**

افتح **Authentication > Security and sessions > Redirect URLs and allowed origins** وأضِف:

| البند | القيمة |
| - | - |
| رابط إعادة التوجيه | `http://localhost:3000/auth/callback` |
| الأصل المسموح | `http://localhost:3000` |

لا تُعيد Didit توجيه الشخص إلا إلى رابط إعادة توجيه سجّلته لديك، حرفاً بحرف.
يتيح الأصل المسموح للمتصفح تبادل الرمز مع أصل Didit الخاص بتطبيقك.

![بطاقة Redirect URLs and allowed origins في لوحة Didit Business Console، بجوار قائمة السماح وقائمة الحظر وعنوان URL لتسجيل الدخول](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-redirect-urls.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=8bf9cdacf97580097f4e8c6bd242af6f)

روابط إعادة التوجيه والأصول المسموحة، ضمن Authentication > Security and sessions.

**3. فعّل طريقة تسجيل دخول**

افتح **Authentication > Sign-in methods** وفعّل **Email code**.
يبدأ أي تطبيق جديد وجميع الطرق فيه معطّلة، وتعرض الصفحة المستضافة الطرق التي تفعّلها فقط.

يمكنك أيضاً إضافة **Passkeys** إن أردت، أو طريقة تسجيل دخول عبر وسائل التواصل الاجتماعي مع **بيانات اعتماد الاختبار من Didit**، وهي تعمل في Sandbox دون الحاجة إلى تطبيق خاص بك.
تُشرح كل طريقة في [طرق تسجيل الدخول](https://docs.didit.me/ar/authentication/sign-in-methods.md).

![صفحة Sign-in methods في لوحة Didit Business Console، وتضم بطاقة صفحة تسجيل الدخول المستضافة، وطرق تسجيل الدخول بدون كلمة مرور وبكلمة المرور، ومعاينة مباشرة للصفحة المستضافة](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-in-methods.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=4f71ad0125f22dd8184ad837854ec8db)

Authentication > Sign-in methods، مع معاينة مباشرة للصفحة المستضافة.

**4. انسخ المفتاح القابل للنشر**

افتح **Authentication > Developers** وانسخ **Publishable key**.
في تطبيق Sandbox يبدأ بـ `pk_test_`.

المفتاح القابل للنشر عام، ويعرّف أصل تسجيل الدخول في Didit الخاص بتطبيقك.
لا تضع **Secret key** أبداً في شيفرة المتصفح أو شيفرة تطبيق الجوال.

**5. ثبّت SDK وسجّل الدخول**

```bash theme={null}
npm install @didit-protocol/auth
```

```ts auth.ts theme={null}
import { createDiditAuth } from "@didit-protocol/auth";

export const auth = createDiditAuth({
  publishableKey: "pk_test_...",
  redirectUri: "http://localhost:3000/auth/callback",
});

// Your sign-in button
export async function onSignInClick() {
  await auth.signIn({ returnTo: "/dashboard" });
}

// Run once on http://localhost:3000/auth/callback
export async function onCallbackPage() {
  const { session, returnTo } = await auth.handleRedirectCallback();
  console.log(session.email, session.vendorData);
  window.location.replace(returnTo ?? "/");
}
```

انقر على الزر: تطلب الصفحة المستضافة عنوان بريد إلكتروني وترسل رمزاً مكوّناً من ستة أرقام.
أدخل الرمز، فتعيدك Didit إلى رابط الاستدعاء الخاص بك، الذي يستبدل الرمز لمرة واحدة بـ tokens الخاصة بالجلسة.
أول تسجيل دخول باستخدام عنوان بريد إلكتروني لا يرتبط بحساب ينشئ حساباً، لأن سياسة التسجيل الافتراضية تتيح لأي شخص التسجيل.

![الصفحة المستضافة لتسجيل الدخول على الهاتف، وفيها زر مفتاح المرور وحقلا البريد الإلكتروني وكلمة المرور](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-phone.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=842077ff63a6dcffc50b0f0542ab07e4)

الصفحة المستضافة لتسجيل الدخول على الهاتف. تعرض الطرق التي فعّلتها فقط.

**6. تحقق من token على خادمك**

أرسل token الوصول من `auth.getToken()` إلى الواجهة الخلفية في ترويسة `Authorization`، وتحقق منه هناك في كل طلب محمي:

```ts server.ts theme={null}
import { verifyToken } from "@didit-protocol/auth/server";

export async function authenticate(request: Request) {
  const header = request.headers.get("authorization") ?? "";
  const token = header.startsWith("Bearer ") ? header.slice(7) : "";
  try {
    const claims = await verifyToken(token, { publishableKey: process.env.DIDIT_PUBLISHABLE_KEY });
    return { personId: claims.sub, vendorData: claims.vendor_data };
  } catch {
    return null;
  }
}
```

يتحقق `verifyToken` من توقيع ES256 باستخدام المفاتيح المنشورة لجهة الإصدار، ومن جهة الإصدار ومن تاريخ الانتهاء.
تبلغ مدة صلاحية tokens الوصول 5 دقائق كحد أقصى، و`auth.getToken()` يجدّدها لك تلقائياً.
ولغات البرمجة الأخرى تتحقق من token نفسه باستخدام [حزم SDK للخادم](https://docs.didit.me/ar/integration/server-sdks/overview.md) أو أي مكتبة JWT، كما يوضح [الرموز وJWKS](https://docs.didit.me/ar/authentication/tokens-and-jwks.md#التحقق-من-رمز-على-الخادم-لديك).

**7. اعرض تسجيل الدخول في لوحة التحكم**

افتح **Authentication > Sign-ins**.
يظهر تسجيل دخولك مع نتيجته وطريقته وجهازه وموقعه ومخاطره، إلى جانب أمثلة تسجيلات الدخول التي يبدأ بها كل تطبيق Sandbox.
ويظهر الشخص ضمن **Users**.

![صفحة Sign-ins في لوحة Didit Business Console، تعرض محاولات تسجيل الدخول مع حالتها وصاحبها وطريقتها وجهازها وموقعها ومخاطرها ووقتها](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-ins.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=3c79b4e120c911b732d738e52d1687c8)

Authentication > Sign-ins: كل محاولة، مع تصفية حسب الحالة والطريقة والمخاطر.

لتلقي نشاط تسجيل الدخول على خادمك، اربط [وجهة webhook](https://docs.didit.me/ar/integration/webhooks.md) بالأحداث `auth.signup` و`auth.login`. راجع [الأحداث وwebhooks](https://docs.didit.me/ar/authentication/events-and-webhooks.md).

## قبل الإطلاق

1. فعّل **المصادقة** لتطبيقك في بيئة الإنتاج (Live) من صفحة **Products**.
2. سجّل هنا عناوين `https://` الخاصة بإعادة التوجيه والمصادر في بيئة الإنتاج، علمًا بأن تطبيق Live يقبل عناوين `https://` فقط.
3. استبدل بيانات الاعتماد التجريبية لدى Didit لتسجيل الدخول عبر مواقع التواصل الاجتماعي ببيانات تطبيقك: معرّف العميل (client ID) والسر (secret).
4. انسخ مفتاح النشر الخاص ببيئة الإنتاج (`pk_live_`) إلى إعدادات الإنتاج لديك.
5. راجع [قائمة التحقق قبل الإطلاق](https://docs.didit.me/ar/authentication/integration-guide.md#قائمة-التحقق-قبل-الإطلاق).

## الخطوات التالية

> [card] [دليل التكامل](https://docs.didit.me/ar/authentication/integration-guide.md)
>
> شاشات مستضافة أو شاشاتك الخاصة، وتخزين token، والجلسات، والتحقق الإضافي، واستكشاف الأخطاء وإصلاحها.

> [card] [React وNext.js](https://docs.didit.me/ar/authentication/quickstarts/nextjs.md)
>
> المكونات والخطافات وملفات تعريف الارتباط HttpOnly والدالة `auth()` على الخادم.

> [card] [iOS وAndroid وReact Native وFlutter](https://docs.didit.me/ar/authentication/quickstarts/ios.md)
>
> تسجيل الدخول عبر التطبيق الأصلي باستخدام متصفح النظام، ومفاتيح المرور، والتخزين المحمي.

> [card] [الحماية من الروبوتات](https://docs.didit.me/ar/authentication/bot-protection.md)
>
> فعّل السياسات التي تمنع الروبوتات والاستيلاء على الحساب.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.