---
title: "التكامل مع خادم التحكم في الوصول من طرف ثالث"
slug: "integration-with-third-party-access-control-server"
updated: 2026-08-04T06:04:28Z
published: 2026-08-04T06:04:28Z
canonical: "knowledge.akuvox.com/integration-with-third-party-access-control-server"
---

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

# التكامل مع خادم التحكم في الوصول من طرف ثالث



تسمح هذه الميزة لأجهزة أكوفوكس بإعادة توجيه بيانات الدخول (مثل رموز QR أو البطاقات أو رموز PIN) إلى خادم طرف ثالث للتحقق بدلا من إجراء المصادقة المحلية.

**حالات الاستخدام النموذجية**:

- التحكم المركزي في الوصول يدار بواسطة منصة طرف ثالث.
- منطق أمني مخصص تم تنفيذه على خوادم خارجية.

**كيف يعمل**:

![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/Gemini_Generated_Image_20jac420jac420ja.png)

## النماذج المدعومة

هذه الميزة مدعومة في النماذج التالية:

| النموذج | إصدار البرنامج الثابت (أو أعلى) | النموذج | إصدار البرنامج الثابت (أو أعلى) |
| --- | --- | --- | --- |
| A01/A02 | 101.30.10.128 | A05V2 | 205.30.10.157 |
| A08* | 108.30.11.122 | E18 | 18.30.11.27 |
| E16V2 | 216.30.11.25 | X915V2 | 2915.30.10.728 |
| X916 | 916.30.10.353 | R29 | 29.30.10.727 |
| S535 | 535.30.11.13 | S539 | 539.30.10.428 |
| X912 | 912.30.12.209 | S538 | 538.30.10.705 |

> [!NOTE]
> ملاحظة
> 
> * في A08، **يتطلب وضع التفويض** **ووضع طلب المصادقة متعددة العوامل** (انظر أدناه) البرنامج الثابت 108.30.11.228 أو أحدث. جميع الوظائف الأخرى الموضحة في هذا المقال متاحة من 108.30.11.122.

## قبل أن تبدأ

تأكد من أنك تملك:

- واجهة برمجة تطبيقات HTTP المقدمة من خادم الطرف الثالث.
- معرف الجهاز المخصص من قبل النظام الخارجي.
- طريقة المصادقة مخططة (رمز QR، بطاقة، رمز PIN أو متعدد العوامل).

## نظرة عامة على التكوين

يتم دعم وضعين للتكامل:

**التكامل العام**

- يستخدم **فقط للمصادقة على رمز الاستجابة السريعة**.
- يرسل الجهاز طلب HTTP محدد مسبقا يحتوي على بيانات رمز QR.

**التكامل المخصص**

- يستخدم **لعدة طرق مصادقة**.
- يدعم رمز الاستجابة السريعة، البطاقة، الرمز الشخصي، والمصادقة متعددة العوامل.
- يسمح بتنسيق البيانات المرن لمعالجة الخادم.

## خطوات التكوين

خذ A08 كمثال.

1. استخدم عنوان IP الخاص بالجهاز لتسجيل الدخول إلى واجهة الويب الخاصة به. اسم المستخدم الأول وكلمة المرور هما **admin**.
2. اذهب إلى **Control Access Control > Relay > تكامل الطرف الثالث**.
3. اختر نوع التكامل.

- **عام**: نقل رابط HTTP المرتبط برمز QR بطريقة Akuvox.
- **التخصيص**: نقل بيانات بيانات بيانات الوصول بطريقة مخصصة.

![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/Screenshot 2026-04-10 145414.png)

### الخيار أ: التكامل العام (رمز QR فقط)

**متى تستخدم:**

- يتطلب فقط التحقق من رموز الاستجابة السريعة.
- يقوم الخادم بالتحقق من رموز QR عبر طلبات HTTP.

1. أدخل أمر HTTP الذي يوفره مزود الخدمة الطرف الثالث.

**مثال على الصيغة**:

*http://192.168.31.123:8090/api/visitor/scan?codeKey={QRCode}&deviceId={DeviceID}*
2. أدخل معرف الجهاز الذي يوفره خادم طرف ثالث.
3. اختر **وضع التفويض**. قم بتكوين **اسم المستخدم** **وكلمة المرور** المستخدمة للمصادقة عند اختيار وضع **Basic** أو **Digest** .

![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-F9LC0OWK.png)

1. قدم الإعداد.

#### تنسيق استجابة الخادم

بعد استلام الطلب، يجب على الخادم الثالث إعادة **رد JSON صالح** يشير إلى ما إذا كان الوصول.

يحدد الجهاز النتيجة بناء على حقول محددة في الاستجابة.

**معيار النجاح المدعوم**:

- "صحيح": صحيح
- "صالح": 1
- "validation_result": "1"

**المعامل الفاشل المدعوم**:

- "صحيح": خاطئ
- "صحيح": 0
- "validation_result": "0"

#### مهلة الاستجابة

ينتظر الجهاز ردا من خادم الطرف الثالث خلال فترة زمنية محدودة.

- **وقت الاستراحة: 3 ثوان**

إذا لم يتم استلام أي رد صالح خلال هذا الوقت:

- سيعتبر الطلب **فاشلا.**
- سيتم **رفض الوصول تلقائيا.**

#### النتيجة

- عند مسح رمز الاستجابة السريعة:
  - `{QRCode}` يتم استبداله بمحتوى QR الفعلي.
  - `{DeviceID}` يحدد الجهاز.
- يقوم الخادم بالتحقق من الطلب.
- الجهاز يفتح الباب إذا نجح التحقق.

![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-AQVTW9CX.png)

مثال على عنوان URL المستلم

### الخيار ب: التكامل المخصص

**متى تستخدم**:

- هناك حاجة إلى عدة طرق للمصادقة.
- يتم تنفيذ منطق التحقق المخصص على الخادم.

**الاعتمادات المدعومة:**

- رمز QR
- بطاقة RF
- رمز التعريف الشخصي
- المصادقة متعددة العوامل

قبل إعداد التكامل، **حدد أي وضع مصادقة** يستخدمه الجهاز.

اختر وضع المصادقة في واجهة **التحكم > المرحل > وضع التحقق من الوصول** .

![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-HI41VU7C.png)

#### السيناريو 1: أي وضع طريقة

في هذا الوضع، يمكن لأي اعتماد محدد أن يفعل التحقق.

1. اختر طريقة الوصول التي سيتم التحقق منها من قبل الخادم الخارجي.
2. اختر **وضع التفويض**. قم بتكوين **اسم المستخدم** **وكلمة المرور** المستخدمة للمصادقة عند اختيار وضع **Basic** أو **Digest** .
3. أدخل أمر HTTP الذي يوفره مزود الخدمة الطرف الثالث.

**مثال على الصيغة**:

*http://192.168.31.123:8090/api/visitor/scan?codeKey={QRCode}/{Card}/{Pin}&deviceId={DeviceID}.*
4. أدخل معرف الجهاز الذي يوفره خادم طرف ثالث.

![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-05I3TGS5.png)

1. قدم الإعداد.

> [!WARNING]
> نصيحة
> 
> تدعم الطرازات المحددة (X916، S535، R29، A05V2، E18، وE16V2) ميزة **التوجيه على شاشة LCD** .
> 
> - اختر **خيار الافتراضي** لاعتماد موجه فتح باب هاتف Akuvox.
> - اختر **قيمة الإرجاع** لاستخدام قيمة الإرجاع من خادم طرف ثالث كطلب.

#### تنسيق استجابة الخادم

بعد استلام الطلب، يجب على الخادم الثالث أن يرد **ردا صالحا** يوضح ما إذا كان الوصول.

يحدد الجهاز النتيجة بناء على حقول محددة في الاستجابة.

**معيار النجاح المدعوم**:

- "صحيح": صحيح
- "صالح": 1
- "validation_result": "1"

**المعامل الفاشل المدعوم**:

- "صحيح": خاطئ
- "صحيح": 0
- "validation_result": "0"

#### مهلة الاستجابة

ينتظر الجهاز ردا من خادم الطرف الثالث خلال فترة زمنية محدودة.

- **وقت الاستراحة: 3 ثوان**

إذا لم يتم استلام أي رد صالح خلال هذا الوقت:

- سيعتبر الطلب **فاشلا.**
- سيتم **رفض الوصول تلقائيا.**

#### النتيجة

- يرسل الجهاز بيانات الاعتماد المستخدمة (QR، بطاقة، أو رمز PIN).
- يتم استبدال المتغير المقابل في العنوان.
- يقوم الخادم بالتحقق من بيانات الاعتماد ويعيد النتيجة.

![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-JON6PLTJ.png)

مثال على عنوان URL المستلم

#### السيناريو 2: وضع المصادقة الثنائية

يتطلب هذا الوضع اعتمادين متتاليين. التركيبات المدعومة هي **بطاقة RF + PIN** **وPIN + بطاقة RF**.

> [!NOTE]
> ملاحظة
> 
> في أجهزة A08 التي تعمل بالبرنامج **الثابت 108.30.11.228 أو أحدث**، يعتمد سير العمل على **إعداد وضع طلب المصادقة متعدد العوامل** . في جميع الطرازات الأخرى — وعلى البرمجيات الثابتة A08 قبل 108.30.11.228 — يطبق فقط سير عمل الطلبات المنفصلة.

**سير العمل:**

| طلبات منفصلة | طلب واحد مشترك (A08، البرنامج الثابت 108.30.11.228 أو أحدثه فقط) |
| --- | --- |
| يكمل المستخدم الخطوة الأولى للمصادقة (مثلا، تمرير بطاقة RF). | يكمل المستخدم الخطوة الأولى للمصادقة (مثلا، تمرير بطاقة RF). |
| يرسل الجهاز فورا أول بيانات اعتماد إلى الخادم باستخدام **{Token}**. يقوم الخادم بالتحقق من ذلك ويعيد النتيجة. | الجهاز يحتفظ ببيانات الاعتماد المجمعة وينتظر — ولا يتم إرسال أي طلب حتى الآن. |
| يكمل المستخدم الخطوة الثانية للمصادقة (مثلا، يدخل رمز التعريف الشخصي). | يكمل المستخدم الخطوة الثانية للمصادقة (مثلا، يدخل رمز التعريف الشخصي). |
| يرسل الجهاز بيانات الاعتماد الثانية إلى الخادم باستخدام **{Token}**. يقوم الخادم بالتحقق من ذلك ويعيد النتيجة. | يرسل الجهاز كلا بيانات الاعتماد معا في طلب واحد باستخدام **{Card}** و **{Pin}**. يقوم الخادم بالتحقق من كلاهما ويعيد نتيجة واحدة. |

في كلتا الحالتين، إذا لم تتطابق بيانات الاعتماد المدخلة في أي من الخطوتين مع وضع التحقق الثنائي المكون، يطلب من المستخدم استخدام الطريقة الصحيحة قبل إرسال الطلب.

1. اختر وضع التحقق عن بعد **متعدد العوامل** .
2. اختر **وضع طلب المصادقة متعددة العوامل**.
3. اختر **وضع التفويض**. قم بتكوين **اسم المستخدم** **وكلمة المرور** المستخدمة للمصادقة عند اختيار وضع **Basic** أو **Digest** .
4. أدخل أمر HTTP الذي يوفره مزود الخدمة الطرف الثالث.

**مثال على الصيغة**:

لوضع **الطلبات المنفصلة** :

*http://192.168.31.123:8090/api/visitor/scan?codeKey={Token}/{Type}&deviceId={DeviceID}*

بالنسبة لوضع **الطلب المدمج الواحد** :

*http://192.168.31.123:8090/api/visitor/scan?codeKey={Card}/{Pin}/{Type}&deviceId={DeviceID}*

1. أدخل معرف الجهاز الذي يوفره خادم طرف ثالث.

![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-1S5BYIJY.png)

1. قدم الإعداد.

> [!WARNING]
> نصيحة
> 
> تدعم الطرازات المحددة (X916، S535، R29، A05V2، E18، X912، وE16V2) ميزة **التوجيه على شاشة LCD** .
> 
> - اختر **خيار الافتراضي** لاعتماد موجه فتح باب هاتف Akuvox.
> - اختر **قيمة الإرجاع** لاستخدام قيمة الإرجاع من خادم طرف ثالث كطلب.

#### تنسيق استجابة الخادم

بعد استلام الطلب، يجب على الخادم الثالث إعادة **رد JSON صالح** يشير إلى ما إذا كان الوصول.

يحدد الجهاز النتيجة بناء على حقول محددة في الاستجابة.

**معيار النجاح المدعوم**:

- "صحيح": صحيح
- "صالح": 1
- "validation_result": "1"

**المعامل الفاشل المدعوم**:

- "صحيح": خاطئ
- "صحيح": 0
- "validation_result": "0"

#### مهلة الاستجابة

ينتظر الجهاز ردا من خادم الطرف الثالث خلال فترة زمنية محدودة.

- **وقت الاستراحة: 3 ثوان**

إذا لم يتم استلام أي رد صالح خلال هذا الوقت:

- سيعتبر الطلب **فاشلا**
- سيتم **رفض الوصول تلقائيا**

#### النتيجة

- `{Token}` تمثل الشهادة التي تم جمعها في كل خطوة.
- `{Type}` يشير إلى تسلسل المصادقة:
  - `1` = بطاقة RF + رمز PIN
  - `2` = رمز PIN + بطاقة RF
  - `3` = وجه + بطاقة RF
  - `4` = وجه + رمز PIN
- يقوم الخادم بالتحقق من كلا بيانات الاعتماد قبل منح الوصول.

![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-IMUT4APX.png)

مثال على عنوان URL المستلم

## وصف المتغيرات

| المتغير | الوصف |
| --- | --- |
| {QRCode} | محتوى رمز QR |
| {بطاقة} / {رمز البطاقة} | رقم البطاقة |
| {دبوس} / {PINCode} | رمز PIN |
| {معرف المستخدم} | معرف المستخدم المرتبط بوجه المستخدم. |
| {وجه} | قيم الميزات المحولة من بيانات الوجه. |
| {DeviceID} | معرف الجهاز |
| {رمز} | تم جمع الاعتماد في الخطوة الحالية |
| {نوع} | نوع المصادقة ذات العاملين |
| {الوقت} | الوقت الحالي للجهاز |

## اختلافات قدرات النماذج

### قدرات المصادقة

تدعم النماذج المختلفة طرق مصادقة مختلفة للتكامل مع خوادم الطرف الثالث.

| النموذج | الطرق المدعومة |
| --- | --- |
| S539 / S538 | رمز QR |
| E16 | رمز QR، بطاقة |
| S535 / X915V2 | رمز الاستجابة السريعة، البطاقة، الوجه، رقم التعريف الشخصي |
| E18 | رمز الاستجابة السريعة، البطاقة، رقم التعريف الشخصي |
| X916 | رمز الاستجابة السريعة، البطاقة، الوجه |
| X912 / R29 | رمز الاستجابة السريعة، البطاقة، الوجه، الرقم السري، العامل الثنائي |
| A08 | رمز QR، رمز PIN، بطاقة RF، ورمز ثنائي |
| A05 | رمز الاستجابة السريعة، البطاقة، الوجه |
| A02 / A01 | البطاقة، رقم التعريف الشخصي |

### المتغيرات المدعومة حسب النموذج

تدعم النماذج المختلفة متغيرات مختلفة عند إرسال البيانات إلى الخادم.

| النموذج | تنسيق متغير |
| --- | --- |
| S539 / S538 | {QRCode}, {DeviceID}, {Time} |
| E16V2 | {QRCode}, {Card}, {DeviceID}, {Time} |
| S535 / X915V2 | {QRCode}, {Card}, {Pin}, {UserID}, {DeviceID}, {Time} |
| E18 | {QRCode}, {Card}, {Pin}, {DeviceID}, {Time} |
| X916 | {QRCode}, {Card}, {UserID}, {DeviceID}, {Time} |
| X912 | {QRCode}, {Card}, {Pin}, {UserID}, {DeviceID}, {Token}, {Type}, {Time} |
| R29 | {QRCode}, {Card}, {Pin}, {Face}, {UserID}, {DeviceID}, {Token}, {Type}, {Time} |
| A08 | {QRCode}, {Card}, {Pin}, {DeviceID}, {Token}, {Type}, {Time} |
| A05V2 | {QRCode}, {Card}, {UserID}, {DeviceID}, {Time} |
| A02 / A01 | {Card}, {PINCode}, {DeviceID}, {Time} |

> [!NOTE]
> ملاحظة
> 
> - تنسيقات المتغيرات غير قابلة للتبديل بين النماذج.
> - يمكن استخدام المتغيرات المدعومة من قبل نموذج الجهاز فقط في أمر HTTP.
> - استخدام المتغيرات غير المدعومة قد يؤدي إلى فشل الطلبات.