> ## 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.

# وصول وكلاء الذكاء الاصطناعي: السماح لوكلاء المستخدمين بالتصرف نيابةً عنهم

> تتيح Didit للمستخدمين الموافقة على وكلاء الذكاء الاصطناعي للتصرف نيابةً عنهم داخل تطبيقك، ضمن جلسة محدودة تنتهي تلقائياً ويمكن إلغاؤها.

تتيح ميزة وصول الوكلاء في Didit Authentication لمستخدمي تطبيقك الموافقة على وكلاء الذكاء الاصطناعي الخاصين بهم ليتصرفوا نيابةً عنهم. يرى الشخص ما يطلبه الوكيل ويوافق عليه، فيحصل الوكيل على جلسة خاصة به ومحدودة النطاق، تنتهي تلقائياً، ويمكن للشخص أو لفريقك إلغاؤها في أي وقت. يميّز خادمك الخلفي طلب الوكيل عن طلب الشخص من خلال المطالبة `act` في token.

تتوفر ميزة وصول الوكلاء ضمن كل الخطط دون سعر منفصل.

## كيف يعمل

1. يطلب وكيل ذكاء اصطناعي التصرف نيابةً عن شخص في تطبيقك، ويحدد النطاقات التي يحتاجها.
2. يسجّل الشخص الدخول إلى صفحة الموافقة المستضافة في تطبيقك، أو في شاشة الموافقة الخاصة بك، فيرى اسم الوكيل، وما إذا كان موثّقاً، وما الذي يطلبه.
3. يمكن للشخص تضييق الطلب (نطاقات أقل، أو جلسة أقصر، أو بعض [المؤسسات](https://docs.didit.me/ar/authentication/organizations.md) فقط)، ثم يوافق عليه، مع مفتاح مرور جديد عندما تطلب إعداداتك ذلك.
4. يتلقى الوكيل رمزًا لمرة واحدة، ويستبدله برموز الوصول الخاصة به. وتدوم رموز الوصول الخاصة به 5 دقائق كحد أقصى، مثل رموز الشخص.
5. كل طلب يرسله الوكيل إلى الخادم الخلفي لديك يحمل رمزاً تشير فيه المطالبة `act` إلى الوكيل والنطاقات التي وافق عليها الشخص.

تنتهي جلسة الوكيل عند انقضاء مدة صلاحيتها، أو بعد انتهاء مهلة الخمول لديك، أو عندما يُلغيها الشخص أو فريقك.

## فعّله واختر القواعد

وصول الوكلاء معطّل في تطبيق جديد.
فعّله من **Authentication > Agent access**، ثم اختر **Edit settings**:

| الإعداد | الخيارات | الافتراضي |
| - | - | - |
| ما يمكن للوكلاء فعله | **Read only** (`read`): الاطلاع على معلومات حساب الشخص. **Acts for them** (`act`): تغيير إعدادات حساب الشخص وتفضيلاته. | لا شيء حتى تختار |
| أي الوكلاء يمكنهم الطلب | يمكن لأي وكيل تقديم طلب حاليًا، وتعرض شاشة الموافقة ما إذا كان الوكيل موثّقاً. السماح للوكلاء الموثّقين فقط غير متاح بعد. | أي وكيل |
| مدة الجلسة | 1 أو 7 أو 30 يوماً. | 7 أيام |
| تنتهي عند الخمول لمدة | 30 دقيقة أو ساعتان أو 24 ساعة. | ساعتان |
| كيف يوافق الأشخاص | **A passkey** (مفتاح مرور)، أو **Their usual sign-in** (طريقة تسجيل الدخول المعتادة لديهم). | مفتاح مرور |
| موافقة الأشخاص وحدهم على طلبات الوكلاء | تتطلب كل موافقة تأكيداً جديداً من مفتاح المرور الخاص بالشخص الذي يوافق. | مُعطّل |

يمكن للأشخاص إيقاف أي نطاق تعرضه في شاشة الموافقة، ولا يمكنهم تفعيل أي نطاق.
تُطبَّق التغييرات على الموافقات الجديدة فقط: الجلسات النشطة للوكلاء تحتفظ بما وافق عليه الشخص.

لا يمكن تغيير **Only people approve agent requests** (`agent_humans_only`) إلا من قِبل Owner أو Admin في مؤسستك في Didit، ويحتاج هذا المستخدم أولاً إلى مفتاح مرور في حسابه على لوحة التحكم.
يثبت هذا الإعداد أن الشخص الذي وافق استخدم أداة المصادقة الخاصة به مع التحقق من المستخدمين، وأن ذلك تم خلال خمس دقائق وكان مرتبطاً بذلك الطلب تحديداً؛ ولا يكشف الأتمتة بشكل عام.
لشاشة الموافقة الخاصة بك، تجد الاستدعاءات في [الموافقة على الوكيل باستخدام مفتاح مرور](https://docs.didit.me/ar/authentication/sign-in-methods.md#الموافقة-على-الوكيل-باستخدام-مفتاح-مرور).

## أضِف الميزة إلى تطبيقك

تُرسل الوكلاء الذين يدعمون هذه الميزة المستخدمين إلى شاشة الموافقة الخاصة بك من تلقاء أنفسهم.
يقوم تطبيقك بأمرين:

**اسمح للمستخدمين برؤية وكلائهم وسحب وصولهم.**
في React، اعرض `<ConnectedAgents />` في صفحة إعدادات الحساب: يعرض هذا المكوّن الوكلاء الذين وافق عليهم المستخدم، ولكل وكيل زر **Revoke**.
راجع [دليل البدء السريع لـ React](https://docs.didit.me/ar/authentication/quickstarts/react.md).

**تحقّق من المطالبة `act` على الخادم الخلفي.**
يُوقَّع token الخاص بالوكيل بالمفتاح نفسه، ويحمل `typ` و`iss` و`aud` نفسها التي يحملها token المستخدم، لذلك لا يميّز بينهما إلا `act`:

| `act` | الجهة المستدعية | ما الذي يُسمح به |
| - | - | - |
| `null` | المستخدم. | ما يحق للمستخدم القيام به. |
| `{"sub", "agent", "scopes"}` | وكيل ذكاء اصطناعي يتصرف نيابة عن المستخدم. | فقط ما تمنحه `act.scopes`، على المسارات التي تفتحها للوكلاء. ارفضه في كل مكان آخر. |

يمثل `sid` في token الوكيل معرّف الصلاحية التي منحها المستخدم، و`GET /session/` يرفض دائماً token الوكيل.
للاطلاع على الفحوصات في الشيفرة، راجع [التحقق من الـ token على الخادم الخاص بك](https://docs.didit.me/ar/authentication/tokens-and-jwks.md#التحقق-من-رمز-على-الخادم-لديك).

## المراقبة والإلغاء من Business Console

تعرض صفحة **Authentication > Agent access** ما يلي:

* **At a glance:** الجلسات النشطة للوكلاء، والجلسات التي وافق عليها الأشخاص خلال آخر 7 أيام، والأشخاص الذين لديهم وكيل، وعمليات الإلغاء هذا الشهر، مقسّمة حسب الأشخاص وحسب فريقك.
* **Active agent sessions:** كل شخص، والوكيل مع وصفه وما إذا كان قد تم التحقق منه، وما يمكنه فعله، وآخر نشاط له ووقت انتهائها، مع زر **Revoke**.

![صفحة Agent access في Didit Business Console، تعرض إعدادات الوكيل والمقاييس الرئيسية والجلسات النشطة للوكلاء مع زر Revoke](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-agent-access.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=7cc518e37e2ccafa5515eb22e6ef9b8d)

Authentication > Agent access.

يؤدي الإلغاء إلى إنهاء جلسة الوكيل فوراً، ويمكنك إرسال بريد إلكتروني إلى الشخص لإعلامه بأنها انتهت.
ويمكن لفريقك أيضاً إنهاء كل جلسات الوكيل لشخص واحد. حظر شخص ما، أو إعادة تعيين MFA الخاص به، أو إلغاء جلساته من **Users** يلغي وصوله إلى الوكيل أيضاً.

## رسائل البريد الإلكتروني والأحداث

عندما يلغي فريقك وصول أحد الوكلاء من وحدة التحكم، يمكنك اختيار إرسال بريد إلكتروني إلى الشخص الذي أُلغي وصوله. يستخدم البريد علامتك التجارية، كما هو الحال مع كل [بريد تسجيل الدخول](https://docs.didit.me/ar/authentication/branding-and-custom-domain.md#رسائل-تسجيل-الدخول).

تُسجَّل الموافقات والإلغاءات كحدثين `security.agent_access_approved` و`security.agent_access_revoked` في الخط الزمني للشخص. يسجّل Didit الموافقة عندما يوافق الشخص، حتى لو لم يستبدل الوكيل رمزه أبدًا. راجع [تدقيق موافقة الوكيل](https://docs.didit.me/ar/authentication/events-and-webhooks.md#سجل-تدقيق-موافقات-الوكيل).


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