دليل عام

تمكين AI Gateway واتصالات المزودين

استخدم `/ai-gateway` كمركز للإعداد: قم بتوصيل مفتاح موفر BYOK واحد، وأضفه إلى القائمة المسموح بها في السياسة، ثم أنشئ عميلاً لبيئة التطوير (IDE) أو الأتمتة الخاصة بك. الجمهور: مسؤولو المستأجرين، وقادة الأمن، ومالكو مساحات العمل. وقت الإعداد المعتاد: 15-20 دقيقة.

reference

استخدم هذا إذا

استخدم `/ai-gateway` كمركز للإعداد: قم بتوصيل مفتاح موفر BYOK واحد، وأضفه إلى القائمة المسموح بها في السياسة، ثم أنشئ عميلاً لبيئة التطوير (IDE) أو الأتمتة الخاصة بك.

الجمهور المستهدف: مسؤولو المستأجرين، وقادة الأمن، ومالكو مساحات العملالوقت النموذجي: 15-20 دقيقة

قبل البدء

  • اختر أول موفر أو بيئة تطوير أو سير عمل أتمتة تريد اختباره تجريبيًا.
  • تأكد من معرفات الموفرين وأدوات MCP التي سيسمح للمستخدمين برؤيتها.
  • احصل على عنوان URL لإعادة التوجيه أو تفاصيل تكوين العميل قبل إنشاء الوصول.

خطوات الدليل

1

الخطوة 1

توصيل موفر واحد أولاً

ابدأ في `/ai-gateway`، ثم افتح اتصال موفر OpenAI لإضافة أول مفتاح مملوك للمستأجر يثق به فريقك بالفعل.

  • استخدم `/integrations/ai_openai` لبيانات اعتماد موفر BYOK الأولى ما لم يكن الإصدار التجريبي يحتاج صراحةً إلى Anthropic أو نقطة نهاية متوافقة مع OpenAI.
  • استخدم مفتاح موفر مخصص لـ BlackShield بدلاً من مفتاح شخصي مشترك بين الأفراد.
  • قم بتشغيل الفحص المسبق للموفر قبل العودة إلى AI Gateway.

معايير النجاح

قم بتشغيل الفحص المسبق للموفر قبل العودة إلى AI Gateway.

2

الخطوة 2

إدراج الموفر في القائمة المسموح بها في السياسة

تقيد AI Gateway التوجيه النشط والوصول حتى تسمح السياسة صراحةً بالموفر المتصل.

  • افتح علامة تبويب السياسة من `/ai-gateway` وأضف الموفر المتصل إلى `approved_providers`.
  • حافظ على بساطة السياسة الأولى: قائمة الموفرين المسموح بها، والأدوات المخفية، وحد طلب واضح.
  • ابق في الوضع الاستشاري (advisory) حتى يرى الفريق التجريبي التحذيرات المتوقعة، ثم انتقل إلى وضع الفرض (enforce).

معايير النجاح

ابق في الوضع الاستشاري (advisory) حتى يرى الفريق التجريبي التحذيرات المتوقعة، ثم انتقل إلى وضع الفرض (enforce).

3

الخطوة 3

إنشاء عميل للأداة التي يستخدمها فريقك

امنح كل بيئة تطوير (IDE) أو عميل MCP أو كيان خدمة عميلاً خاصًا به في AI Gateway بحيث يسهل تدوير الوصول أو تعطيله.

  • أنشئ عميلاً عامًا لمسارات تسجيل الدخول أو عميلاً سريًا للأتمتة بدون واجهة.
  • أضف عنوان URL لإعادة التوجيه الذي تتطلبه بيئة التطوير أو الوكيل الخاص بك قبل تسليم العميل للمستخدمين النهائيين.
  • قصر كل عميل على اتصالات الموفرين وأدوات MCP التي يحتاجها هذا الفريق بالفعل.

معايير النجاح

قصر كل عميل على اتصالات الموفرين وأدوات MCP التي يحتاجها هذا الفريق بالفعل.

4

الخطوة 4

اختبار البوابة قبل النشر العام

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

  • قم بتعيين نقطة نهاية MCP على `/api/v1/mcp` ونقطة نهاية الاستدلال على `/api/v1/ai-gateway/openai/v1/chat/completions`.
  • قم بتسجيل الدخول باستخدام العميل الجديد أو استبدل بيانات اعتماد العميل برمز مميز قصير الأجل.
  • قم بتشغيل `tools/list` أو مطالبة قراءة بسيطة، ثم تأكد من ظهور الحدث في نشاط AI Gateway.
  • راجع تحذيرات السياسة وسجلات الاستخدام قبل دعوة المزيد من المستخدمين.

معايير النجاح

راجع تحذيرات السياسة وسجلات الاستخدام قبل دعوة المزيد من المستخدمين.

Demonstration only

This configuration is designed for ease of use. To deploy scanner clients at scale, please plan your deployment architecture accordingly or contact us for enterprise best practices.

نفّذ هذا

Exchange client credentials for a short-lived token
curl -X POST https://api.blackshield.chaplau.com/api/v1/ai-gateway/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "your-client-id",
    "client_secret": "your-client-secret"
  }'
Query OpenAI completions via the Gateway Proxy
curl -X POST https://api.blackshield.chaplau.com/api/v1/ai-gateway/openai/v1/chat/completions \
  -H "Authorization: Bearer <your_short_lived_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "openai",
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": "List the security requirements for the tenant onboarding flow."
      }
    ]
  }'
Configure the Stdin/Stdout MCP Proxy in Cursor / VS Code / Claude Desktop
{
  "mcpServers": {
    "blackshield-gateway": {
      "command": "blackshield-mcp",
      "args": [
        "--client-id", "<your-client-id>",
        "--client-secret", "<your-client-secret>",
        "--url", "https://api.blackshield.chaplau.com/api/v1/mcp"
      ]
    }
  }
}

معايير النجاح

  • يتم مصادقة العميل التجريبي بنجاح ولا يرى سوى الموفرين والأدوات المخطط لها.
  • يعرض تدفق النشاط مكالمة الاختبار وأي تحذيرات أو حظر متوقع من السياسة.
تمكين AI Gateway واتصالات المزودين | BlackShield Docs