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

# دعم جلسات الوصول

> كيف يصل دعم عملاء Truthlocks إلى المستأجر الخاص بك من خلال جلسات انتحال شخصية محدودة الوقت ومحددة النطاق.

عندما تتصل بدعم Truthlocks ويتطلب استكشاف الأخطاء وإصلاحها الوصول إلى المستأجر الخاص بك، يستخدم موظفو الدعم **جلسات انتحال الشخصية** — جلسات محدودة الوقت ومحدودة النطاق يتم تسجيلها بالكامل في سجل التدقيق الخاص بك.

## كيف يعمل

**1. الدعم ينشئ جلسة**

يقوم أحد موظفي الدعم بإنشاء جلسة انتحال تحدد
المستأجر، ونطاقات الأذونات المطلوبة، وTTL، وسبب الوصول.
يمكن تحديد نطاق الجلسات اختياريًا لمؤسسة معينة داخل
المستأجر.

**2. الجلسة محدودة الوقت**

لكل جلسة وقت بقاء قابل للتكوين (TTL) يتراوح بين 1 و 60
دقائق (الافتراضي 15 دقيقة). عند انتهاء صلاحية TTL، يتم إلغاء الوصول
فورًا — لا يلزم اتخاذ إجراء يدوي.

**3. يتم تسجيل الإجراءات**

يتم تسجيل كل طلب HTTP يقوم به عضو فريق الدعم أثناء الجلسة
مسجلة في سجل وصول مخصص مع الطريقة والمسار ورمز الحالة،
ومعرف الطلب. تظهر هذه الأحداث أيضًا في المستأجر الخاص بك
[سجل التدقيق](https://docs.truthlocks.com/ar/security/audit.md).

## خصائص الجلسة

| الخاصية | الوصف |
| :- | :- |
| **المستأجر** | المستأجر الذي تمنح الجلسة الوصول إليه. |
| **المنظمة** | *(اختياري)* منظمة محددة داخل المستأجر. عند التعيين، يقتصر الوصول على بيانات تلك المنظمة فقط. |
| **النطاقات** | الأذونات الممنوحة للجلسة. الافتراضي هو `read_only` إذا لم يتم تحديد أي منها. |
| **TTL** | وقت البقاء بالدقائق (1-60، الافتراضي 15). |
| **السبب** | شرح سهل القراءة لسبب إنشاء الجلسة (10 أحرف كحد أدنى). |
| **الحالة** | `ACTIVE` (قيد الاستخدام)، `EXPIRED` (تم الوصول إلى TTL)، أو `REVOKED` (انتهت يدويًا). |
| **عنوان IP** | عنوان IP لموظف الدعم الذي أنشأ الجلسة. |
| **وكيل المستخدم** | المتصفح أو العميل المستخدم من قبل موظفي الدعم. |
| **صدر في** | عندما تم إنشاء الجلسة. |
| **ينتهي في** | عندما تنتهي صلاحية الجلسة تلقائيًا، بناءً على TTL. |

## دورة حياة الجلسة

* **نشط** — الجلسة قيد الاستخدام وعضو فريق الدعم لديه حق الوصول إلى النطاقات الممنوحة.
* **منتهي الصلاحية** - تم الوصول إلى TTL وتم إلغاء الوصول تلقائيًا.
* **ملغاة** — قام مسؤول المنصة بإنهاء الجلسة مبكرًا. يتم تسجيل هوية المسؤول وسبب الإلغاء الاختياري.

## مراجعة نشاط الدعم

### سجل التدقيق

تظهر جميع أنشطة جلسة الدعم في [سجل تدقيق المستأجر الخاص بك](https://docs.truthlocks.com/ar/security/audit.md). قم بالتصفية حسب فئة الحدث `support_session` لمعرفة ما تم الوصول إليه بالضبط ومتى.

```bash theme={null}
curl "https://api.truthlocks.com/v1/audit?category=support_session" \
  -H "X-API-Key: tl_live_..."
```

يتضمن كل حدث تدقيق معرف الجلسة وهوية الموظف والإجراء الذي تم تنفيذه والطابع الزمني.

### سجلات الوصول لكل جلسة

يمكنك أيضًا استرداد سجل وصول مفصل لجلسة معينة. يسجل كل إدخال طريقة HTTP، ومسار الطلب، ورمز حالة الاستجابة، ومعرف طلب فريد.

```json theme={null}
[
  {
    "method": "GET",
    "path": "/v1/attestations",
    "status_code": 200,
    "request_id": "req_abc123",
    "timestamp": "2026-03-26T14:30:00Z"
  }
]
```

## ضوابط الأمان

> [card] وصول محدد النطاق
>
> تقتصر الجلسات على نطاقات أذونات محددة، واختياريًا، على
> مؤسسة واحدة. لا يمكن للدعم الوصول إلى الموارد خارج النطاق الممنوح
> النطاقات.

> [card] محدود زمنياً
>
> تنتهي صلاحية كل جلسة تلقائيًا بناءً على مدة البقاء (TTL) الخاصة بها (1-60 دقيقة).
> لا توجد منح وصول دعم دائمة.

> [card] مسار تدقيق كامل
>
> يتم تسجيل كل طلب HTTP في سجل الوصول الخاص بالجلسة مع
> عنوان IP الخاص بالموظف ووكيل المستخدم (User-Agent).

> [card] قابل للإلغاء
>
> يمكن لمسؤول المنصة إلغاء الجلسات النشطة في أي وقت،
> مع سبب اختياري.

## ذات صلة

> [card] [سجلات التدقيق](https://docs.truthlocks.com/security/audit.md)
>
> عرض وتصدير أحداث التدقيق الخاصة بالمستأجر الخاص بك.

> [card] [التحكم في الوصول المستند إلى الدور (RBAC)](https://docs.truthlocks.com/security/rbac.md)
>
> فهم الأدوار ونطاقات الأذونات.


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