BLACKSHIELD

公开指南

启用 AI Gateway 和 AI 提供商连接

连接您首选的 AI 提供商和 MCP 客户端，以便团队可以运行辅助分类和安全审核工作流程。 受众: 安全平台管理员和集成工程师. 典型配置时长: 20-30分钟.

reference

Use this if

连接您首选的 AI 提供商和 MCP 客户端，以便团队可以运行辅助分类和安全审核工作流程。

Audience
安全平台管理员和集成工程师
Typical time
20-30分钟

开始之前

  • 选择经过批准的模型提供商并将凭据存储在您的秘密管理器中。
  • 确认您的内部风险政策允许哪些人工智能任务。
  • 确保 MCP 客户端可以安全地发送工作区 JWT 凭据。

Guide walkthrough

步骤 1

安全配置提供商凭据

将模型提供程序机密保留在您自己的机密管理器中，并从 BlackShield 配置中引用它们。

  • 为您批准的模型端点创建提供商凭据。
  • 通过映射凭据引用`AI_SHIM_SECRET_VALUES` 使用 `credentials_ref` 密钥。
  • 仅启用您的团队打算使用的 AI 任务。

What success looks like

仅启用您的团队打算使用的 AI 任务。

步骤 2

启用带有护栏的AI辅助工作流程

从高价值工作流程开始，并对生产决策实施人工审查。

  • 启用 `smart_alert_triage` 以进行积压优先级。
  • 启用`pr_diff_analysis`以确保代码安全查看支持。
  • 设置与风险策略一致的模型、令牌、超时和温度限制。

What success looks like

设置与风险策略一致的模型、令牌、超时和温度限制。

步骤 3

集成您的MCP客户端

配置您的MCP客户端以调用BlackShield工具，同时保持模型推理在您的控制之下。

  • 将 MCP 端点设置为`/api/v1/mcp` 并在授权标头中包含工作区 JWT。
  • 在之前运行 `initialize` 和 `tools/list`调用 `tools/call`。
  • 使用 `/api/v1/mcp/manifest` 发现可用的工具元数据。
  • 将提供程序密钥保留在您自己的运行时中，并需要人工批准才能进行生产更改。

What success looks like

将提供程序密钥保留在您自己的运行时中，并需要人工批准才能进行生产更改。

What success looks like

  • MCP 握手和工具/list 成功完成。
  • AI辅助操作让人类批准影响生产的变更。
启用 AI Gateway 和 AI 提供商连接 | BlackShield Docs