Guide public

Activer AI Gateway et fournisseurs IA

Utilisez `/ai-gateway` comme accueil de configuration : connectez une clé de fournisseur BYOK, autorisez-la dans la politique, puis créez un client pour votre IDE ou automatisation. Audience: Administrateurs de locataires, responsables de sécurité et propriétaires d'espaces de travail. Temps moyen de mise en place: 15-20 minutes.

reference

Utilisez ceci si

Utilisez `/ai-gateway` comme accueil de configuration : connectez une clé de fournisseur BYOK, autorisez-la dans la politique, puis créez un client pour votre IDE ou automatisation.

Public visé: Administrateurs de locataires, responsables de sécurité et propriétaires d'espaces de travailDurée estimée: 15-20 minutes

Avant de commencer

  • Choisissez le premier fournisseur, IDE ou flux d'automatisation que vous souhaitez tester.
  • Confirmez quels fournisseurs et outils MCP les utilisateurs seront autorisés à voir.
  • Munissez-vous de l'URL de rappel ou des détails de configuration du client avant de créer l'accès.

Déroulement du guide

1

Étape 1

Connecter d'abord un fournisseur

Commencez dans `/ai-gateway`, puis ouvrez la connexion OpenAI pour ajouter la première clé appartenant au locataire et déjà approuvée par votre équipe.

  • Utilisez `/integrations/ai_openai` pour le premier identifiant de fournisseur BYOK, sauf si votre pilote nécessite explicitement Anthropic ou un point de terminaison compatible OpenAI.
  • Utilisez une clé de fournisseur dédiée pour BlackShield au lieu d'une clé personnelle partagée entre collègues.
  • Exécutez la vérification préliminaire du fournisseur avant de revenir à AI Gateway.

Critères de réussite

Exécutez la vérification préliminaire du fournisseur avant de revenir à AI Gateway.

2

Étape 2

Autoriser le fournisseur dans la politique

AI Gateway restreint le routage actif et l'accès jusqu'à ce que la politique autorise explicitement le fournisseur connecté.

  • Ouvrez l'onglet de politique depuis `/ai-gateway` et ajoutez le fournisseur connecté à `approved_providers`.
  • Gardez la première politique simple : liste d'autorisation des fournisseurs, outils masqués et limite de requêtes claire.
  • Restez en mode consultatif (advisory) jusqu'à ce que l'équipe pilote voie les avertissements attendus, puis passez en mode exécution (enforce).

Critères de réussite

Restez en mode consultatif (advisory) jusqu'à ce que l'équipe pilote voie les avertissements attendus, puis passez en mode exécution (enforce).

3

Étape 3

Créer un client pour l'outil utilisé par votre équipe

Donnez à chaque IDE, client MCP ou principal de service son propre client AI Gateway afin que l'accès soit facile à renouveler ou désactiver.

  • Créez un client public pour les flux de connexion ou un client confidentiel pour l'automatisation sans tête.
  • Ajoutez l'URL de rappel requise par votre IDE ou agent avant de transmettre le client aux utilisateurs finaux.
  • Limitez chaque client aux connexions de fournisseurs et aux outils MCP dont cette équipe a réellement besoin.

Critères de réussite

Limitez chaque client aux connexions de fournisseurs et aux outils MCP dont cette équipe a réellement besoin.

4

Étape 4

Tester la passerelle avant le déploiement général

Effectuez d'abord un test à faible risque pour confirmer l'authentification, le comportement des politiques et la journalisation des activités.

  • Définissez le point de terminaison MCP sur `/api/v1/mcp` et le point de terminaison d'inférence sur `/api/v1/ai-gateway/openai/v1/chat/completions`.
  • Connectez-vous avec le nouveau client ou échangez les identifiants client contre un jeton éphémère.
  • Exécutez `tools/list` ou une simple invite en lecture seule, puis confirmez que l'événement apparaît dans l'activité AI Gateway.
  • Passez en revue les avertissements de politique et les journaux d'utilisation avant d'inviter d'autres utilisateurs.

Critères de réussite

Passez en revue les avertissements de politique et les journaux d'utilisation avant d'inviter d'autres utilisateurs.

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.

Exécuter

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"
      ]
    }
  }
}

Critères de réussite

  • Le client pilote s'authentifie avec succès et ne voit que les fournisseurs et outils prévus.
  • Le flux d'activité affiche l'appel de test et tous les avertissements ou blocages de politique attendus.
Activer AI Gateway et fournisseurs IA | BlackShield Docs