सार्वजनिक गाइड

AI Gateway और AI प्रदाता कनेक्शन

सेटअप होम के रूप में `/ai-gateway` का उपयोग करें: एक BYOK प्रदाता कुंजी कनेक्ट करें, इसे नीति में अनुमति दें, फिर अपने IDE या ऑटोमेशन के लिए एक क्लाइंट बनाएं। लक्षित पाठक: किरायेदार व्यवस्थापक, सुरक्षा लीड और कार्यस्थान स्वामी. सामान्य सेटअप समय: 15-20 मिनट.

reference

इसका उपयोग करें यदि

सेटअप होम के रूप में `/ai-gateway` का उपयोग करें: एक BYOK प्रदाता कुंजी कनेक्ट करें, इसे नीति में अनुमति दें, फिर अपने IDE या ऑटोमेशन के लिए एक क्लाइंट बनाएं।

लक्षित दर्शक: किरायेदार व्यवस्थापक, सुरक्षा लीड और कार्यस्थान स्वामीविशिष्ट समय: 15-20 मिनट

शुरू करने से पहले

  • पहला प्रदाता, IDE, या स्वचालन कार्यप्रवाह चुनें जिसे आप पायलट करना चाहते हैं।
  • पुष्टि करें कि उपयोगकर्ताओं को कौन से प्रदाता स्लग और MCP उपकरण देखने की अनुमति होगी।
  • एक्सेस बनाने से पहले कॉलबैक URL या क्लाइंट कॉन्फ़िगरेशन विवरण अपने पास रखें।

मार्गदर्शिका वॉकथ्रू

1

चरण 1

पहले एक प्रदाता कनेक्ट करें

`/ai-gateway` में शुरू करें, फिर पहली किरायेदार-स्वामित्व वाली कुंजी जोड़ने के लिए OpenAI प्रदाता कनेक्शन खोलें जिस पर आपकी टीम पहले से भरोसा करती है।

  • पहले BYOK प्रदाता क्रेडेंशियल के लिए `/integrations/ai_openai` का उपयोग करें, जब तक कि आपके पायलट को स्पष्ट रूप से 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 जोड़ें जिसकी आपके IDE या एजेंट को आवश्यकता है।
  • प्रत्येक क्लाइंट को केवल उन्हीं प्रदाता कनेक्शनों और 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 और AI प्रदाता कनेक्शन | BlackShield Docs