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

# بيانات الاعتماد وعمليات التكامل

> أدر اتصالاتك وأسرارك وامنحها للتطبيقات والأتمتة التي تحتاج إليها.

<Note>متاحة ضمن جميع الخطط السحابية؛ وتتطلب الاستضافة الذاتية خطة Business أو أعلى.</Note>

عندما يستدعي تطبيق أو أتمتة خدمة خارجية، فإنه يستخدم **بيانات اعتمادك أنت**. بيانات الاعتماد ملك لك لا للتطبيق أو الأتمتة، وهي على نوعين:

* **الاتصالات**: حسابات لدى جهات خارجية تمنح Teable حق الوصول إليها عبر OAuth، مثل Google أو Slack أو Feishu.
* **الأسرار**: سلاسل نصية تحفظها بنفسك، مثل مفتاح API أو رمز وصول.

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

## إدارة اتصالاتك وأسرارك

انقر على صورتك في أسفل اليسار ثم افتح **الإعدادات** ← **التكاملات**. تنقسم الصفحة إلى ثلاثة أقسام: **اتصالاتي** و**أسراري** و**تطبيقات الطرف الثالث التي منحتها إذنًا**.

يطلب زر **إضافة سرّ** ما يلي:

| الحقل       | الوصف                                                                 |
| ----------- | --------------------------------------------------------------------- |
| **المفتاح** | يبدأ بحرف كبير، ولا يقبل سوى الحروف الكبيرة والأرقام والشرطات السفلية |
| **القيمة**  | مخصصة للكتابة فقط بعد الحفظ؛ أدخل قيمة جديدة لاستبدالها               |
| **الوصف**   | اختياري، لتوضيح الغرض من السرّ                                        |

يُضاف الاتصال عبر **ربط حساب جديد**. وعند انتهاء صلاحية التصريح، يظهر في الاتصال زر **إعادة الربط**.

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

## منح بيانات اعتماد لتطبيق أو أتمتة

افتح لوحة بيانات الاعتماد الخاصة بالمورد:

* **التطبيقات**: من لوحة المحادثة في App Builder، افتح **+** ← **المزيد** ← **بيانات الاعتماد والإعدادات**.
* **الأتمتة**: افتح سير العمل وانقر على **بيانات الاعتماد والإعدادات** في علامة تبويب **التحرير**.

يتيح زر **منح** ثلاثة مسارات: **منح سرّ موجود** لاختيار أحد أسرارك أو اتصالاتك؛ و**إضافة سرّ** لإنشاء سرّ ومنحه في الحال؛ أو اختيار خدمة من قائمة **الخدمات**، فيبدأ تصريح OAuth للخدمة غير المرتبطة، أما الخدمة المعلَّمة بـ **متصل** فتُمنح مباشرة.

يحتاج كل تفويض إلى **اسم متغير**، وهو الاسم المستعار لبيانات الاعتماد داخل ذلك التطبيق أو تلك الأتمتة. وتنطبق عليه قواعد تسمية مفتاح السرّ نفسها، وهو الاسم الذي تقرؤه الشيفرة.

قد تظهر في اللوحة عناصر نائبة عليها **لم يُربط بعد**. فنسخ تطبيق أو تكرار سير عمل أو استيراد قاعدة بيانات أو تكرارها ينقل الأسماء المستعارة التي تتوقعها الشيفرة دون بيانات الاعتماد. انقر على **ربط بيانات اعتمادي** لتزويده ببياناتك حتى يعمل التطبيق أو الأتمتة.

وإذا كان الاسم المستعار مرتبطًا حاليًا ببيانات اعتماد شخص آخر، فزر **استبداله بحسابي** ينقله إليك. أما **إزالة الترخيص فقط (إبقاء العنصر النائب)** فيفك الارتباط ويُبقي العنصر النائب، فلا تحتاج الشيفرة إلى تعديل.

<Info>يتطلب تعديل تفويضات مورد ما صلاحية تحرير ذلك التطبيق أو تلك الأتمتة. ولا يمكنك منح سوى بيانات اعتمادك أنت.</Info>

## قراءة بيانات الاعتماد في الشيفرة

| الموضع                    | طريقة القراءة                                                                   |
| ------------------------- | ------------------------------------------------------------------------------- |
| البرامج النصية في الأتمتة | متغير بيئة، مثل `process.env.EXTERNAL_API_KEY`                                  |
| حقول الإدخال في الأتمتة   | انقر على **إدراج سرّ** بجوار الحقل واختر سرًّا مفوَّضًا                         |
| الأسرار داخل التطبيق      | تقرأ الشيفرة من جانب الخادم `process.env.MY_API_KEY`                            |
| الاتصالات داخل التطبيق    | تستدعي الشيفرة من جانب الخادم `getConnectionToken('ALIAS')` للحصول على رمز وصول |

عند لصق قيمة تشبه المفتاح في أحد حقول الأتمتة، يحفظها Teable بوصفها سرًّا لك ويترك مكانها مرجعًا، فلا يصل النص الصريح إلى إعدادات سير العمل. وإذا أردت إبقاء النص كما هو، فانقر على **تراجع** في التنبيه.

## طلبات بيانات الاعتماد في محادثة الذكاء الاصطناعي

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

* **ربط حسابي**: تنفيذ تصريح OAuth؛ ويُمنح الاتصال الجديد للمورد تلقائيًا.
* **منح ...**: استخدام اتصال أو سرّ تملكه بالفعل.
* **تخطي**: عدم تقديم بيانات الاعتماد؛ ويواصل الذكاء الاصطناعي الأجزاء التي لا تعتمد عليها.

## الاستبدال والحذف ومغادرة المساحة

قبل استبدال قيمة سرّ أو حذف سرّ أو قطع اتصال، يعرض Teable قائمة التطبيقات والأتمتة التي لا تزال تستخدمه. ويؤدي الحذف وقطع الاتصال إلى تعطّل تلك الموارد فورًا، لذا امنحها بيانات اعتماد أخرى أولًا إذا كان عليها الاستمرار في العمل. ولا يمكن استرجاع قيمة السرّ القديمة.

بعد حفظ القيمة الجديدة، تستخدمها الأتمتة في تشغيلها التالي، ويستخدمها التطبيق عند إعادة تشغيل بيئة المعاينة، أما التطبيق المنشور فلا يستخدمها إلا بعد إعادة نشره.

وإذا غادرت مساحة ما زال فيها تطبيق أو أتمتة يستخدم بيانات اعتمادك، فستشير صفحة **التكاملات** إلى ذلك بعبارة **لقد غادرت هذه المساحة**. انقر على **إزالة التفويض** للتوقف عن تقديمها.