Guía pública

Habilitar AI Gateway y conexiones de proveedor de IA

Utilice `/ai-gateway` como base de configuración: conecte una clave de proveedor BYOK, agréguela a la lista de permitidos en la política y luego cree un cliente para su IDE o automatización. Audiencia: Administradores de inquilinos, líderes de seguridad y propietarios de espacios de trabajo. Tiempo típico de configuración: 15-20 minutos.

reference

Úsalo si

Utilice `/ai-gateway` como base de configuración: conecte una clave de proveedor BYOK, agréguela a la lista de permitidos en la política y luego cree un cliente para su IDE o automatización.

Audience: Administradores de inquilinos, líderes de seguridad y propietarios de espacios de trabajoTypical time: 15-20 minutos

Antes de comenzar

  • Elija el primer proveedor, IDE o flujo de automatización que desee probar en el piloto.
  • Confirme qué identificadores de proveedores y herramientas MCP podrán ver los usuarios.
  • Tenga a mano la URL de devolución de llamada o los detalles de configuración del cliente antes de crear el acceso.

Guide walkthrough

1

Paso 1

Conectar primero un proveedor

Comience en `/ai-gateway`, luego abra la conexión de proveedor de OpenAI para agregar la primera clave propiedad del tenant en la que su equipo ya confía.

  • Utilice `/integrations/ai_openai` para la primera credencial de proveedor BYOK a menos que su piloto necesite explícitamente Anthropic o un extremo compatible con OpenAI.
  • Utilice una clave de proveedor dedicada para BlackShield en lugar de una clave personal compartida entre personas.
  • Ejecute la verificación previa del proveedor antes de regresar a AI Gateway.

Cómo se ve el éxito

Ejecute la verificación previa del proveedor antes de regresar a AI Gateway.

2

Paso 2

Agregar el proveedor a la lista permitida en la política

AI Gateway restringe el enrutamiento y acceso activos hasta que la política permita explícitamente el proveedor conectado.

  • Abra la pestaña de políticas desde `/ai-gateway` y agregue el proveedor conectado a `approved_providers`.
  • Mantenga la primera política simple: lista de permitidos de proveedores, herramientas ocultas y un límite claro de solicitudes.
  • Permanezca en modo informativo (advisory) hasta que el equipo piloto vea las advertencias esperadas, luego pase al modo de aplicación (enforce).

Cómo se ve el éxito

Permanezca en modo informativo (advisory) hasta que el equipo piloto vea las advertencias esperadas, luego pase al modo de aplicación (enforce).

3

Paso 3

Crear un cliente para la herramienta que usa su equipo

Otorgue a cada IDE, cliente MCP o entidad de servicio su propio cliente de AI Gateway para que el acceso sea fácil de rotar o deshabilitar.

  • Cree un cliente público para flujos de inicio de sesión o un cliente confidencial para automatización sin interfaz.
  • Agregue la URL de devolución de llamada que su IDE o agente requiere antes de entregar el cliente a los usuarios finales.
  • Limite cada cliente a las conexiones de proveedores y herramientas MCP que ese equipo realmente necesita.

Cómo se ve el éxito

Limite cada cliente a las conexiones de proveedores y herramientas MCP que ese equipo realmente necesita.

4

Paso 4

Probar la puerta de enlace antes del despliegue general

Ejecute primero una prueba de bajo riesgo para confirmar la autenticación, el comportamiento de la política y el registro de actividad.

  • Establezca el extremo MCP en `/api/v1/mcp` y el extremo de inferencia en `/api/v1/ai-gateway/openai/v1/chat/completions`.
  • Inicie sesión con el nuevo cliente o intercambie credenciales de cliente por un token de corta duración.
  • Ejecute `tools/list` o una solicitud de solo lectura simple, luego confirme que el evento aparezca en la actividad de AI Gateway.
  • Revise las advertencias de política y los registros de uso antes de invitar a más usuarios.

Cómo se ve el éxito

Revise las advertencias de política y los registros de uso antes de invitar a más usuarios.

Solo demostración

Esta configuración está diseñada para facilitar el uso. Para desplegar clientes de escaneo a escala, planifique su arquitectura de despliegue en consecuencia o contáctenos para obtener las mejores prácticas empresariales.

Ejecuta esto

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

Cómo se ve el éxito

  • El cliente piloto se autentica correctamente y solo ve los proveedores y herramientas planificados.
  • El flujo de actividad muestra la llamada de prueba y las advertencias o bloqueos de políticas esperados.
Habilitar AI Gateway y conexiones de proveedor de IA | Docs de BlackShield