بيانات الاعتماد
أدر بيانات اعتماد الخدمات الخارجية والتكاملات بأمان لاستخدامها في سير عمل API.
نظرة عامة
يسمح قسم Credentials بربط مشروعك بخدمات خارجية مثل Stripe و Telegram و Slack و Notion ومزوّدي الذكاء الاصطناعي. تُشفَّر بيانات الاعتماد بـ Fernet (مفتاح متماثل فريد لكل مشروع) وتُفك فقط وقت التنفيذ داخل المحرك — ولا تُعاد إلى الواجهة بعد الحفظ أبداً.
بعد التخزين، يمكن الإشارة إلى بيانات الاعتماد من بنّاء API عند ضبط العقد في سير عملك.
بيانات الاعتماد محدودة بمشروع واحد. يدير كل مشروع مجموعة تكاملاته بشكل مستقل.
أنواع بيانات الاعتماد
تشحن HeroMate 26 نوع بيانات اعتماد مكتوب إضافة إلى نوع Custom عام من أزواج مفتاح-قيمة. كل عقدة تتحدث إلى خدمة خارجية تطلب بيانات الاعتماد المطابقة.
المدفوعات
Stripe، Stripe Webhook، Polar، Polar Webhook
الرسائل
Telegram، WhatsApp، Slack، Discord، Twilio
البريد
SMTP، IMAP، Resend، SendGrid
البيانات والإنتاجية
Google Sheets، Airtable، Notion، Trello
التطوير و CRM
GitHub، Linear، Calendly، HubSpot، Shopify
الذكاء الاصطناعي (BYOK)
OpenAI، Anthropic، Gemini
| الفئة | أنواع بيانات الاعتماد |
|---|---|
| المدفوعات | Stripe، Stripe Webhook، Polar، Polar Webhook |
| الرسائل | Telegram، WhatsApp، Slack، Discord، Twilio |
| البريد | SMTP، IMAP، Resend، SendGrid |
| البيانات والإنتاجية | Google Sheets، Airtable، Notion، Trello |
| التطوير | GitHub، Linear |
| الجدولة | Calendly |
| CRM | HubSpot |
| التجارة الإلكترونية | Shopify |
| الذكاء الاصطناعي (BYOK) | OpenAI، Anthropic، Gemini |
| عام | HTTP Request، Custom (مفتاح-قيمة) |
تكامل Google الوحيد هو Google Sheets
ليس لدى HeroMate أنواع بيانات اعتماد لـ AWS (S3/SES/SNS/SQS/Lambda/DynamoDB) أو Google Drive/Calendar/Gmail/Analytics أو Microsoft (Excel/OneDrive/Outlook/Teams) أو MySQL أو MongoDB. لأي API آخر، استخدم بيانات اعتماد HTTP Request العامة مع عقدة HTTP Request، أو بيانات اعتماد Custom من أزواج مفتاح-قيمة.
بيانات اعتماد الذكاء الاصطناعي BYOK
لاستخدام مزوّد ذكاء اصطناعي خاص بك بدلاً من HeroMate Managed AI، خزّن بيانات اعتماد OpenAI أو Anthropic أو Gemini هنا واخترها على عقدة agent. مع BYOK تدفع للمزوّد مباشرة — لا تضيف HeroMate هامشاً على تلك الرموز. تفضّل بلا إعداد؟ استخدم HeroMate Managed AI بدلاً من ذلك (لا حاجة لمفتاح، تُحسب كأرصدة ذكاء اصطناعي).
الوصول إلى قاعدة البيانات لا يحتاج بيانات اعتماد
عقدة PostgreSQL المستقلة معطّلة حالياً. استخدم عقدة dypai_database المضمّنة لقراءة قاعدة بيانات مشروعك وكتابتها — دون سلسلة اتصال خارجية أو بيانات اعتماد.
إضافة بيانات اعتماد
افتح Credentials
انتقل إلى قسم Credentials في الشريط الجانبي لمشروعك.
اعثر على تكاملك
تصفّح شبكة التكاملات أو استخدم شريط البحث للعثور على الخدمة التي تحتاجها.
اضبط
انقر Configure على بطاقة التكامل. املأ الحقول المطلوبة (مفاتيح API، الرموز، سلاسل الاتصال، وغيرها).
احفظ
انقر Save. تُشفَّر بيانات الاعتماد وتُخزَّن بأمان.
بعد الحفظ، لا يمكن عرض قيم بيانات الاعتماد مرة أخرى. لتحديث بيانات اعتماد، يجب إعادة إدخال كل الحقول بقيم جديدة.
استخدام بيانات الاعتماد في سير العمل
عند ضبط عقدة في بنّاء API تتطلب وصولاً إلى خدمة خارجية، استخدم أداة Credentials Select للاختيار من بيانات الاعتماد المحفوظة.
يحقن المحرك تلقائياً بيانات الاعتماد المفكوكة وقت التنفيذ، مما يسمح للعقدة بالتفاعل مع الخدمة الخارجية بأمان.
بيانات الاعتماد مقابل أسرار الخلفية
تمنحك HeroMate ثلاثة أماكن متميزة لتخزين الإعداد — اختر ما يطابق ما تخزّنه:
| المخزن | ما يحمله | كيف يُشار إليه |
|---|---|---|
| Credentials | مفاتيح API خارجية مكتوبة النوع (Stripe، Slack، OpenAI…) | تُختار على عقدة سير عمل عبر credential_id |
| أسرار الخلفية | أسرار تشغيل عامة بالاسم، مشفّرة (Fernet) | ctx.secrets.X / ${ secrets.X } في سير العمل |
| متغيرات Frontend (Build) | قيم عامة وقت البناء تُدمج في حزمة العميل | import.meta.env / process.env في الواجهة |
عقدة Code تستخدم env_vars، وليس Credentials
لا تستطيع عقدة Code javascript_code اختيار Credentials مكتوبة النوع. تقرأ env_vars كنص واضح الخاصة بها (ctx.env.*) المعرَّفة على العقدة — لا تضع أسراراً حقيقية هناك. لأسرار التشغيل، استخدم أسرار الخلفية؛ لمفاتيح المزوّدين مكتوبة النوع، استخدم Credentials على عقد التكامل.
الأمان
- التشفير: تشفير Fernet في التخزين (متماثل، مفتاح لكل مشروع) لكل قيم بيانات الاعتماد.
- فك التشفير: فقط وقت التنفيذ، داخل بيئة المحرك الآمنة.
- الظهور: لا تُعاد القيم إلى العميل بعد الحفظ الأولي أبداً.
- التدقيق: يُسجَّل الوصول إلى بيانات الاعتماد لمراقبة الأمان.
الخطوات التالية
- ابنِ سير عمل في بنّاء API
- أسرار الخلفية — أسرار التشغيل بالاسم
- HeroMate Managed AI — ذكاء اصطناعي بلا إعداد دون مفتاح BYOK
- اعرض السجلات في وحدة التحكم