إنشاء الـ Credentials وتعديلها

الـ Credentials هي معلومات توثيق (authentication) مخزّنة بشكل آمن، تُستخدم لربط سير العمل في n8n بخدمات خارجية مثل الـ APIs أو قواعد البيانات.

إنشاء Credential

1. اضغط على زر Create في الزاوية العلوية من القائمة الجانبية، ثم اختر credential.
2. إذا كانت نسخة n8n لديك تدعم المشاريع (projects)¹، فعليك اختيار مكان الإنشاء: المساحة الشخصية أو مشروع لديك صلاحية الوصول إليه. أما في النسخة المجتمعية (community)، فتُنشأ الـ credential في مساحتك الشخصية.
3. اختر التطبيق أو الخدمة التي تريد الاتصال بها.

أو:

1. استخدم زر Create في الزاوية العلوية من صفحة Overview أو من مشروع معيّن، ثم اختر Credential.
2. إذا نفّذت ذلك من صفحة Overview، فستُنشأ الـ credential في مساحتك الشخصية. وإذا نفّذته من داخل مشروع، فستُنشأ داخل هذا المشروع تحديدًا.
3. اختر التطبيق أو الخدمة التي تريد الاتصال بها.

ويمكنك أيضًا إنشاء credential جديدة من القائمة المنسدلة للـ credentials أثناء تعديل نود في محرر الـ Workflow.

عند الوصول إلى نافذة الـ credential، أدخل البيانات التي تطلبها الخدمة. راجع صفحة خدمتك في مكتبة الـ credentials للحصول على الإرشادات.

عند حفظ الـ credential، تختبرها n8n للتأكد من أنها تعمل.

اختيار نوع الـ Credential

عند إنشاء أو تعديل OAuth credential، تختار Credential type:

• Fixed credential: تُستخدم الـ credential نفسها بغض النظر عمّن يشغّل الـ Workflow. وهذا هو السلوك الافتراضي.
• End-user credential: تُستخدم credential كل مستخدم أثناء التشغيل، ولا يمكن لأحد رؤيتها أو استخدامها سواه.

تتيح الـ End-user credentials تشغيل الـ Workflow بـ credentials الشخص الذي يشغّله، وإبقاء بيانات كل مستخدم خاصة به. ويظهر الاختيار بين نوعي Fixed credential وEnd-user credential لـ OAuth credentials في n8n Cloud Enterprise وفي Enterprise المستضافة ذاتيًا. لمعرفة كيفية إعدادها، راجع End-user credentials.

النطاقات المسموح بها لطلبات HTTP

يظهر الحقل Allowed HTTP Request Domains في كثير من credentials n8n الخاصة بالـ APIs والخدمات القائمة على الويب. يتحكم هذا الحقل في النطاقات (domains) التي يُسمح باستخدام الـ credential معها عند اختيارها في نود HTTP Request. ولا يؤثر عند استخدام الـ credential في النود المخصص لها.

للحقل ثلاثة خيارات:

• All: يمكن استخدام الـ credential مع أي رابط (URL).
• Specific Domains: التقييد بنطاقات محددة (أدخل قائمة مفصولة بفواصل مثل httpbin.org, api.github.com)
• None: تُحظر الـ credential تمامًا من الاستخدام في نود HTTP Request.

يمنع هذا الحقل إساءة استخدام الـ credential، مثل إرسالها إلى روابط خارج النطاق المقصود.

الـ Expressions في الـ Credentials

يمكنك استخدام الـ expressions² لتعيين الـ credentials ديناميكيًا أثناء تشغيل الـ Workflow:

1. في الـ Workflow، حدّد مسار البيانات (data path) الذي يحتوي على الـ credential. يختلف ذلك بحسب أسماء المعاملات (parameters) في بياناتك بالضبط. تأكد من أن البيانات التي تحتوي على الـ credential متاحة في الـ Workflow عند وصولك إلى النود الذي يحتاجها.
2. عند إنشاء الـ credential، مرّر المؤشر فوق الحقل الذي تريد استخدام expression فيه.
3. فعّل Expression.
4. أدخل الـ expression.

Workflow توضيحي

استخدام المثال

مصادر ذات صلة

• فهم سير العمل
• إنشاء سير العمل وتشغيله
• حفظ سير العمل ونشره
• استخدام رصيد Gateway
• مكوّنات سير العمل
• فهم الـ Executions

الهوامش

1. تتيح مشاريع n8n فصل الـ workflows والمتغيرات والـ credentials في مجموعات منفصلة لتسهيل الإدارة. وتسهّل المشاريع التعاون بين الفرق عبر مشاركة الموارد المرتبطة ببعضها وعزلها. ↩

2. تتيح لك الـ expressions في n8n ملء إعدادات النود بشكل ديناميكي عبر تنفيذ كود JavaScript. فبدلًا من إدخال قيمة ثابتة، يمكنك استخدام صيغة الـ expressions في n8n لتحديد القيمة باستخدام بيانات من نودات سابقة، أو من workflows أخرى، أو من بيئة n8n الخاصة بك. ↩