VISO TRUST
官方通过AI助手直接访问和管理您的VISO TRUST第三方风险计划。
你可以用 VISO TRUST MCP 做什么?
- 查找供应商评估 — 按 ID 检索特定评估,包括以 HTML 或 Markdown 格式生成的 AI 摘要。
- 创建和管理评估 — 为现有关系启动评估、更新其到期日期,或调整后续跟进设置。
- 搜索供应商关系 — 按标签、域名、状态、风险等级、分数范围、业务部门和日期筛选关系。
- 供应商入驻或退出 — 根据审批摘要和生命周期设置为某个关系办理入驻,或将其退出并归档。
- 查看审计日志 — 在指定日期范围内查询用户、组织、评估和关系的审计事件。
- 管理情报报告 — 为供应商域名创建、更新或获取 BitSight、SecurityScorecard 和 Recorded Future 报告。
文档
VISO TRUST MCP Server
一个用于将 VISO TRUST API 功能与 AI 助手集成的模型上下文协议 (MCP) 服务器。
托管远程服务器
VISO TRUST 托管了此 MCP 服务器的托管实例,因此您无需构建、运行或自行托管任何内容即可开始使用:
https://mcp.visotrust.com/mcp
使用 Streamable HTTP 传输将任意 MCP 客户端连接到此端点,并使用您的 VISO TRUST API 令牌进行身份验证。有关如何生成 API 令牌的信息,请参阅 VISO TRUST 支持文档。
客户端配置示例:
{
"mcpServers": {
"viso-mcp": {
"type": "streamable-http",
"url": "https://mcp.visotrust.com/mcp",
"headers": {
"Authorization": "Bearer <your-api-token>"
}
}
}
}
若要使用 MCP Inspector 测试托管端点,请运行 npx @modelcontextprotocol/inspector,将 Transport Type 设为 Streamable HTTP,并使用上方的 URL。
本文档其余部分介绍如何自行运行服务器(在本地或您自己的基础设施中)。
要求
- Java 21+
- Gradle
- Docker(容器化部署时可选)
- MCP Inspector(测试时可选)
配置
VISO TRUST API 配置
可为 VISO TRUST API 配置以下属性:
visotrust.api.base-url:VISO TRUST API 的基础 URL(默认值:http://localhost:8080)visotrust.api.token:您在 VISO TRUST 平台上的 API 令牌(必需)visotrust.api.timeout:API 请求超时时间(毫秒,默认值:30000)visotrust.api.connect-timeout:API 连接超时时间(毫秒,默认值:5000)
有关如何为 visotrust.api.token 环境变量生成 API 令牌的信息,请参阅 VISO TRUST 支持文档。
应用配置文件
此应用支持 Spring Boot 配置文件,以便针对不同的部署场景启用不同配置。
远程配置文件
remote 配置文件专为通过 Streamable HTTP 传输提供 远程 MCP 支持而设计。此配置文件会将服务器作为 Web 应用运行,以便通过 HTTP 与远程客户端通信。(Streamable HTTP 取代了已弃用的 SSE 传输;此处将其配置为无状态模式。)
远程配置文件的主要区别:
- 作为 servlet Web 应用(Tomcat)在端口
3001上运行,而非使用标准输入/输出 - 在
POST /mcp暴露 MCP 端点(Streamable HTTP) - 以无状态模式运行——不保留每个会话的服务器状态,因此可在负载均衡器后水平扩展,无需会话亲和性
- 针对远程客户端连接优化的服务器设置
- 增强日志记录,便于分布式调试
注意: 客户端连接到单一的 Streamable HTTP 端点
…/mcp。旧版 SSE 端点(/sse+/mcp/message)不再提供服务。
如何启用远程配置文件:
直接使用 Java 运行时:
java -jar viso-mcp-server-<version>.jar --spring.profiles.active=remote
使用 Gradle 运行时:
./gradlew bootRun --args="--spring.profiles.active=remote"
使用 Docker 时:
docker run -i --rm \
-e VISOTRUST_API_TOKEN=<your-api-token> \
-e SPRING_PROFILES_ACTIVE=remote \
viso-mcp-server
适用远程配置文件的场景:
- 将 MCP 服务器部署到远程服务器或云环境时
- 客户端将通过 Streamable HTTP 而非直接 stdio 连接时
- 分布式部署需要增强日志记录和监控时
- 与通过 Streamable HTTP 连接的基于 Web 的 AI 助手集成时
对于本地开发和直接 stdio 通信,请使用默认配置文件(无需指定配置文件)。
安装
快速安装
点击下方任一按钮,在 VS Code 中安装 VISO MCP Server:
在 VS Code 中手动设置
将以下 JSON 块添加到 VS Code 的 User Settings (JSON) 文件中。您可以按 Ctrl + Shift + P 并输入 Preferences: Open User Settings (JSON) 来完成此操作。
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "viso_baseurl",
"description": "VISO TRUST API Base URL",
"default": "https://app.visotrust.com"
},
{
"type": "promptString",
"id": "viso_token",
"description": "VISO TRUST API Token",
"password": true
}
],
"servers": {
"viso-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VISOTRUST_API_TOKEN",
"-e",
"VISOTRUST_API_BASEURL",
"visotrustai/viso-mcp-server:latest"
],
"env": {
"VISOTRUST_API_BASEURL": "${input:viso_baseurl}",
"VISOTRUST_API_TOKEN": "${input:viso_token}"
}
}
}
}
}
您也可以选择将类似的示例(即不含 mcp 键)添加到工作区中名为 .vscode/mcp.json 的文件。这样便可与他人共享配置。
{
"inputs": [
{
"type": "promptString",
"id": "viso_baseurl",
"description": "VISO TRUST API Base URL",
"default": "https://app.visotrust.com"
},
{
"type": "promptString",
"id": "viso_token",
"description": "VISO TRUST API Token",
"password": true
}
],
"servers": {
"viso-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VISOTRUST_API_TOKEN",
"-e",
"VISOTRUST_API_BASEURL",
"visotrustai/viso-mcp-server:latest"
],
"env": {
"VISOTRUST_API_BASEURL": "${input:viso_baseurl}",
"VISOTRUST_API_TOKEN": "${input:viso_token}"
}
}
}
}
在 Claude Desktop 和其他 MCP 客户端中使用
Docker 配置
{
"mcpServers": {
"viso-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e", "VISOTRUST_API_TOKEN",
"-e", "VISOTRUST_API_BASEURL",
"visotrustai/viso-mcp-server:latest"
],
"env": {
"VISOTRUST_API_TOKEN": "<your-api-token>",
"VISOTRUST_API_BASEURL": "https://app.visotrust.com"
}
}
}
}
Java 配置
{
"mcpServers": {
"viso-mcp": {
"command": "java",
"args": [
"-jar",
"viso-mcp-server-<version>.jar",
"--port",
"8080",
"--host",
"localhost"
],
"env": {
"JAVA_TOOL_OPTIONS": "-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005",
"VISOTRUST_API_TOKEN": "<your-api-token>",
"VISOTRUST_API_BASEURL": "https://app.visotrust.com"
}
}
}
}
注意:JAVA_TOOL_OPTIONS 环境变量用于设置远程调试的 JVM 选项。可根据需要更改地址和端口。
💻 开发
Docker 设置
构建 Docker 镜像
docker build -t viso-mcp-server .
运行 Docker 容器
docker run -i --rm -e VISOTRUST_API_TOKEN=<your-api-token> viso-mcp-server
调试
安装 MCP Inspector
npm -g install @modelcontextprotocol/inspector
运行 MCP Inspector 进行测试
- 构建 MCP Server Jar 文件
./gradlew bootJar
- 运行 MCP Inspector
npx @modelcontextprotocol/inspector \
-e JAVA_TOOL_OPTIONS=-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=\*:5005 \
-e VISOTRUST_API_TOKEN=<your-api-token> \
java -jar build/libs/viso-mcp-server-<version>.jar \
--port 8080 --host localhost
将 <version> 替换为项目当前版本(例如 1.0.0 或最新版本发布中的版本)。
CI/CD 流水线
此项目使用 GitHub Actions 进行持续集成和部署。工作流包含以下作业:
代码检查
使用 Spotless 检查代码格式:
./gradlew spotlessCheck
构建
构建应用并创建 JAR 文件:
./gradlew build
发布
创建新版本发布时:
- 更新 build.gradle 中的项目版本,使其与发布标签一致
- 将 JAR 文件上传到 GitHub 发布页面,版本号使用发布标签中的版本
- 构建 Docker 镜像并推送到 Docker Hub,使用以下标签:
latest- 发布标签(例如
v1.0.0)
发布所需的机密
若要启用 Docker Hub 发布,请将以下机密添加到您的 GitHub 仓库:
DOCKERHUB_USERNAME:您的 Docker Hub 用户名DOCKERHUB_TOKEN:您的 Docker Hub 访问令牌
🛠️ 工具
本节介绍 VISO MCP Server 提供的工具。每个工具都有特定用途、输入参数和输出格式。
评估
get_assessment - 根据 ID 获取评估
- id:评估 ID(数字,必需)
返回特定评估的详细信息。
get_assessment_summary - 根据 ID 获取评估摘要
- id:评估 ID(数字,必需)
- format:
HTML(默认)或MARKDOWN(字符串,可选)
返回摘要、其 version,以及该摘要是否已 edited。
update_assessment_summary - 替换已完成评估的 AI 生成摘要文本
- id:评估 ID(数字,必需)
- summary:编辑后的摘要(字符串,必需)
- format:
HTML(默认)或MARKDOWN(字符串,可选) - version:来自
get_assessment_summary的version;如果摘要自该版本以来发生变化,则拒绝更新(字符串,可选)
以提交时使用的格式返回更新后的摘要。
create_assessment - 为现有关系启动评估
- relationshipId:要为其创建评估的关系 ID(数字,必需)
- recipientEmail:评估接收者的电子邮件地址(字符串,可选)
- recipientFirstName:评估接收者的名字(字符串,可选)
- recipientLastName:评估接收者的姓氏(字符串,可选)
- publicDocumentUrls:要纳入评估的公开文档 URL(字符串数组,可选)
- followupType:后续跟进类型(字符串枚举,可选)
- followupRiskThreshold:触发后续跟进的风险级别阈值(字符串枚举,可选)
- followupTimeline:后续跟进操作的时间安排(字符串枚举,可选)
- collectionTimeline:供应商完成评估提交的时间安排(字符串枚举,可选)
- noVendorResponseAction:供应商未响应时采取的操作(字符串枚举,可选)
- aiProcessingOnly:是否仅使用 AI 处理而不进行人工审核(布尔值,可选)
- requestedAuditTypes:此评估请求的审计类型(字符串数组,可选)
返回已创建评估的详细信息。
update_assessment_expiration_date - 更新供应商必须提交评估答复的截止时间
- id:评估 ID(数字,必需)
- expirationDate:新的到期日期/时间,采用带偏移量的 ISO-8601 格式;必须为未来时间(字符串,必需)
返回确认消息。
update_assessment_followup - 更新评估的后续跟进配置
- id:评估 ID(数字,必需)
- followupType:后续跟进类型(字符串枚举,必需)
- followupRiskThreshold:触发后续评估的风险阈值(达到或超过此阈值时触发)(字符串枚举,可选)
- followupTimeline:后续跟进时间安排(字符串枚举,可选)
返回确认消息。
审计日志
get_user_audit_log_events - 获取组织范围内与用户相关的审计日志事件
- start:查询开始日期/时间,采用带偏移量的 ISO-8601 格式(字符串,必需)
- end:查询结束日期/时间,采用带偏移量的 ISO-8601 格式(字符串,必需)
- eventTypes:用于筛选的可选事件类型集合(例如
USER_LOGGED_IN);留空表示全部(字符串数组,可选)
返回用户审计日志事件列表,最多 500 条记录。
get_audit_log_events - 获取筛选后的审计日志事件(用户、组织、评估和关系事件)
- start:查询开始日期/时间,采用带偏移量的 ISO-8601 格式(字符串,必需)
- end:查询结束日期/时间,采用带偏移量的 ISO-8601 格式(字符串,必需)
- eventTypes:用于筛选的可选事件类型集合(例如
ASSESSMENT_COMPLETED、RELATIONSHIP_CREATED);留空表示全部(字符串数组,可选)
返回多态审计日志事件记录。每个条目至少包含 auditEventType 和 dateTime。
业务部门
get_all_business_units - 获取组织的所有业务部门,并按名称排序
返回每个业务部门的 id(可用作 search_relationships 中的 businessUnitIds 筛选条件)和 name(可用作 create_user 中的 businessUnit)。
业务案例
get_all_business_cases - 获取组织的所有可用业务案例
无需参数。
返回组织的所有可用业务案例列表。
数据类型
get_all_datatypes - 获取组织的所有可用数据类型
无需参数。
返回组织的所有可用数据类型列表。
供应商目录
search_vendor_directory - 按 URL 或域名在 VISO TRUST 供应商目录中查找供应商
- urlOrDomain:要搜索的 URL 或域名,例如
example.com(字符串,必需)
返回供应商的基本元数据(名称、主页、描述、网站图标、已知域名)。
关系
get_all_relationships - 获取所有关系及其评估详情列表
无需参数。
返回第三方供应商的信息,包括其评估状态、风险级别和联系详情。
get_relationship_by_id - 根据 ID 获取特定关系及其评估详情
- id:关系 ID(数字,必需)
返回第三方供应商的详细信息,包括评估状态、风险级别和联系详情。
get_relationship_assessment_history - 获取某个关系的评估历史记录
- id:关系 ID(数字,必需)
返回与指定关系关联的评估列表。
create_relationship - 创建与第三方供应商的新关系
- name:关系/供应商名称(字符串,必需)
- homepage:供应商主页 URL(字符串,必需)
- businessOwnerEmail:业务负责人的电子邮件地址(字符串,必需)
- businessOwnerFirstName:业务负责人的名字(字符串,可选)
- businessOwnerLastName:业务负责人的姓氏(字符串,可选)
- description:关系/供应商的描述(字符串,可选)
- contextTypes:此关系的业务上下文类型列表(对象数组,可选)
- dataTypes:此关系中处理的数据类型列表(对象数组,可选)
- tags:用于对该关系分类的标签列表(字符串数组,可选)
- thirdPartyContact:第三方供应商代表的联系详情(对象,可选)
返回已创建关系的详细信息。
create_relationship_by_domain - 仅使用供应商域名创建新的关系
- domain: 供应商的域名,例如
visotrust.com(字符串,必填) - vendorName: 供应商名称(字符串,必填)
- product: 供应商提供的产品(字符串,可选)
- description: 供应商关系的描述(字符串,可选)
返回已创建的关系详情。
update_relationship - 更新与第三方供应商的现有关系
- id: 关系 ID(数字,必填)
- name: 关系/供应商名称(字符串,必填)
- homepage: 供应商主页 URL(字符串,可选)
- description: 关系/供应商的描述(字符串,可选)
- contextTypes: 业务上下文类型列表(object[],可选)
- dataTypes: 此关系中处理的数据类型列表(object[],可选)
- businessOwnerEmail: 业务负责人的电子邮件地址(字符串,可选)
- businessOwnerFirstName: 业务负责人的名字(字符串,可选)
- businessOwnerLastName: 业务负责人的姓氏(字符串,可选)
- tags: 标签列表(string[],可选)
返回已更新的关系详情。
partially_update_relationship - 部分更新现有关系
接受与 update_relationship 相同的字段。仅更改请求中提供的字段;其他字段保持不变。
返回已更新的关系详情。
search_relationships - 按筛选条件搜索关系
调用 POST /api/v1/relationships/search。所有筛选条件均为可选;筛选条件之间采用 AND 组合,同一列表筛选条件中的值采用 OR 组合。
- request: 搜索筛选条件(object,可选)
- tags: 标签名称,与其在 VISO TRUST 中显示的完全一致(string[],可选)
- domains: 供应商域名,例如
example.com(string[],可选) - name: 完全匹配的关系名称(字符串,可选)
- externalId: 完全匹配的外部 ID(字符串,可选)
- statuses: 关系状态 —
NOT_ONBOARDED、ONBOARDED、ARCHIVED(string[],可选) - assessmentStatuses: 最新评估状态(string[],可选)
- riskAcceptanceStatuses:
RISK_ACCEPTED、REVIEW_NEEDED、REMEDIATION_REQUESTED(string[],可选) - inherentRiskLevels / residualRiskLevels:
NO_CONTEXT、LOW、MEDIUM、HIGH、EXTREME(string[],可选) - minScore / maxScore: 分数范围,包含边界值(数字,可选)
- businessUnitIds: 来自
get_all_business_units的业务部门 ID(number[],可选) - businessOwnerIds / creatorIds: 来自
get_all_users的用户 ID(number[],可选) - createdAfter / createdBefore、onboardedAfter / onboardedBefore、recertificationAfter / recertificationBefore、assessmentCompletedAfter / assessmentCompletedBefore: ISO-8601 日期时间(字符串,可选)
- page: 从零开始的页码(数字,可选,默认值为 0)
- size: 页面大小(数字,可选,默认值为 100,最大值为 500)
- sort: 排序顺序,格式为
property,asc|desc;属性为name、externalId、score、createdDate、onboardedDate、recertificationDate(string[],可选)
返回 totalCount、page、size、hasMore 以及匹配的 relationships 页面。
create_tags - 创建用于关系分类的新标签
- tags: 要创建的标签名称列表(string[],必填)
返回包含新创建标签在内的所有标签列表。
update_third_party_contact - 更新第三方供应商的联系详情
- relationshipId: 关系 ID(数字,必填)
- email: 联系人电子邮件(字符串,必填)
- firstName: 联系人名字(字符串,必填)
- lastName: 联系人姓氏(字符串,必填)
返回已更新的关系详情。
onboard_relationship - 入驻关系,可选择提供审批摘要和生命周期管理设置
- id: 关系 ID(数字,必填)
- approvalSummary: 入驻时记录的可选审批摘要(字符串,可选)
- lifecycleManagementUpdateRequest: 可选的生命周期管理设置(object,可选)
- artifactUpdateSettings.artifactUpdateType: 工件更新类型(字符串枚举)
- recertificationSettings.recertificationType: 重新认证类型(字符串枚举)
- recertificationSettings.recertificationDate: 下次重新认证的日期/时间,采用带偏移量的 ISO-8601 格式(字符串)
- recertificationSettings.reviewFrequency:
THREE_YEARS、TWO_YEARS、ANNUAL、SEMIANNUAL或QUARTERLY(字符串枚举)
返回已入驻的关系详情。
offboard_relationship - 终止关系
- id: 关系 ID(数字,必填)
返回已终止的关系详情。
accept_relationship_risk - 接受关系风险
- id: 关系 ID(数字,必填)
- request:(object,可选)
- riskReviewNote: 说明决策的备注(字符串,可选)
- inherentRiskOverride / residualRiskOverride:
LOW、MEDIUM、HIGH或EXTREME;必须同时提供或都不提供(字符串,可选)
返回已更新的关系。
get_relationship_detections - 获取关系证据中发现的检测项
- id: 关系 ID(数字,必填)
- detectionTypes:
NORMAL、SUBSERVICE、SHARED_RESPONSIBILITY_MODEL、EXCEPTION、CUEC、SUBPROCESSOR;默认包含除NORMAL之外的所有类型(string[],可选) - controlDomainTypes: 要包含的控制域类型;默认包含所有类型(string[],可选)
- assessmentId: 此关系已完成的评估,或其最新的进行中评估(数字,可选)
- includeQuestionnaireAnswers: 是否包含补充问卷检测项背后的答案(布尔值,可选)
- afterId: 上一页的
nextAfterId(数字,可选) - size: 每页检测项数量,范围为 1 到 500(数字,可选,默认值为 100)
返回一页检测项;当 nextAfterId 不为 null 时继续读取。
get_risk_advisories_by_relationship - 获取关系供应商的风险公告
- id: 关系 ID(数字,必填)
archive_relationship - 归档关系
- id: 关系 ID(数字,必填)
返回已归档的关系详情。
Webhooks
get_all_webhooks - 获取所有 Webhook
无需参数。
返回所有 Webhook 配置的列表。
get_webhook - 按 ID 获取 Webhook 配置
- id: Webhook ID(数字,必填)
返回特定 Webhook 配置的详情。
create_webhook_configuration - 创建 Webhook 配置
- request: Webhook 创建参数(object,必填)
- url: Webhook URL(字符串,必填)
- secret: Webhook 密钥(字符串,必填)
- eventTypes: 触发 Webhook 的事件类型(string[],必填)
- serviceType: Webhook 的服务类型(字符串,必填)
返回已创建的 Webhook 配置。
update_webhook_configuration - 更新 Webhook 配置
- request: Webhook 更新参数(object,必填)
- id: Webhook ID(数字,必填)
- url: Webhook URL(字符串,可选)
- secret: Webhook 密钥(字符串,可选)
- eventTypes: 触发 Webhook 的事件类型(string[],可选)
- serviceType: Webhook 的服务类型(字符串,可选)
返回已更新的 Webhook 配置。
delete_webhook_configuration - 删除 Webhook 配置
- id: Webhook ID(数字,必填)
删除指定的 Webhook 配置。
Intelligence Reports
create_bitsight_intelligence_report - 创建新的 BitSight 情报报告
- request: BitSight 报告参数(object,必填)
- vendorDomain: 供应商的主域名(字符串,必填)
- reportDate: 报告生成的日期/时间(ISO 8601 字符串,必填)
- link: 提供商界面的可选链接(字符串,可选)
- guid: 实体的 BitSight GUID(字符串,必填)
- customId: BitSight 的自定义标识符(字符串,可选)
- name: BitSight 实体的显示名称(字符串,可选)
- description: BitSight 实体的描述(字符串,可选)
- primaryDomain: BitSight 实体的主域名(字符串,可选)
- ratingRange: BitSight 评级范围(字符串,可选)
- ratingColor: BitSight 评级颜色(字符串,可选)
- confidence: BitSight 评级的置信度(字符串,可选)
返回已创建的情报报告。
create_security_scorecard_intelligence_report - 创建新的 SecurityScorecard 情报报告
- request: SecurityScorecard 报告参数(object,必填)
- vendorDomain: 供应商的主域名(字符串,必填)
- reportDate: 报告生成的日期/时间(ISO 8601 字符串,必填)
- link: 提供商界面的可选链接(字符串,可选)
- grade: SecurityScorecard 字母等级(字符串,必填)
- domain: 与 scorecard 实体关联的域名(字符串,可选)
- score: SecurityScorecard 的数值评分(数字,可选)
返回已创建的情报报告。
create_recorded_future_intelligence_report - 创建新的 Recorded Future 情报报告
- request: Recorded Future 报告参数(object,必填)
- vendorDomain: 供应商的主域名(字符串,必填)
- reportDate: 报告生成的日期/时间(ISO 8601 字符串,必填)
- entityType: Recorded Future 实体类型,例如
Company(字符串,必填) - entity: Recorded Future 实体标识符(字符串,必填)
- riskScore: 风险数值评分(数字,必填)
- riskLevel: 风险级别标签,例如
Critical/High/Medium/Low(字符串,必填) - link: 提供商界面中报告的可选链接(字符串,可选)
- firstSeen: 首次观察到该实体的日期,ISO 8601 格式(字符串,可选)
- lastSeen: 最近观察到该实体的日期,ISO 8601 格式(字符串,可选)
- triggeredRuleCount: 已触发的 Recorded Future 规则数量(数字,可选)
- maxRuleCount: 已评估的 Recorded Future 规则最大数量(数字,可选)
- summary: Recorded Future 提供的可选摘要文本(字符串,可选)
- criticalityLabel: Recorded Future 为该实体提供的关键性标签(字符串,可选)
返回已创建的情报报告。
get_intelligence_reports_by_vendor - 获取供应商的所有情报报告
- vendorDomain: 供应商的主域名(字符串,必填)
返回指定供应商的情报报告列表。
get_intelligence_report - 按 ID 获取情报报告
- id: 报告 ID(UUID,必填)
update_bitsight_intelligence_report、update_security_scorecard_intelligence_report、update_recorded_future_intelligence_report - 替换现有情报报告
- id: 报告 ID(UUID,必填)
- request: 与对应的
create_*_intelligence_report工具相同的字段。未提供的可选字段将被清除。
delete_intelligence_report - 永久删除情报报告
- id: 报告 ID(UUID,必填)
bulk_create_bitsight_intelligence_reports、bulk_create_security_scorecard_intelligence_reports、bulk_create_recorded_future_intelligence_reports - 一次创建最多 1000 份情报报告
- reports: 与对应的
create_*_intelligence_report工具相同的字段(object[],必填)
返回 totalCount、created 个报告 ID,以及已排队等待后台创建的报告对应的 backgroundedCount。
get_latest_intelligence_report - 获取特定来源的供应商最新情报报告
- vendorDomain: 供应商的主域名(字符串,必填)
- source: 情报提供商(字符串枚举:
BITSIGHT、SECURITY_SCORECARD或RECORDED_FUTURE,必填)
返回指定供应商和来源的最新情报报告。
Risk Advisories
get_risk_advisories_by_vendor - 获取供应商的所有风险公告
- vendorId: 供应商 ID(数字,必填)
返回已发布的供应商安全、合规、漏洞、法律、地缘政治、财务和运营公告。
Users
get_all_users - 获取组织中的所有用户
- page:要检索的结果页(数字,可选;默认值为 0)
- size:每页的记录数(数字,可选;默认值为 20)
- sort:排序条件,格式为:property(,asc|desc)(字符串,可选)
返回分页的用户列表。
get_user_by_email - 按电子邮件地址获取用户
- email:用户的电子邮件地址(字符串,必填)
返回用户详情。
create_user - 创建新用户
- request:用户创建参数(对象,必填)
- email:新用户的电子邮件地址(字符串,必填)
- firstName:新用户的名字(字符串,必填)
- lastName:新用户的姓氏(字符串,必填)
返回已创建的用户。
代码格式化
本项目使用 Spotless 和 Google Java Format 进行代码格式化。系统会自动设置 pre-commit 钩子,以确保代码风格一致。
设置
克隆仓库后,运行任何 Gradle 命令时都会自动设置 pre-commit 钩子。
手动格式化
手动格式化所有文件:
./gradlew spotlessApply
检查文件格式是否正确:
./gradlew spotlessCheck
如果 pre-commit 钩子因格式问题拒绝了提交,只需运行 ./gradlew spotlessApply 修复格式,然后再次尝试提交。
许可证
本项目采用 MIT 许可证,详情请参阅 LICENSE 文件。