VISO TRUST
공식AI 어시스턴트를 통해 VISO TRUST 서드파티 리스크 프로그램에 직접 접근하고 관리하세요.
VISO TRUST MCP(으)로 무엇을 할 수 있나요?
- 공급업체 평가 조회 — ID로 특정 평가를 가져오며, AI가 생성한 요약을 HTML 또는 Markdown 형식으로 확인합니다.
- 평가 생성 및 관리 — 기존 관계에 대한 평가를 시작하고, 만료일을 업데이트하거나 후속 조치 설정을 조정합니다.
- 공급업체 관계 검색 — 태그, 도메인, 상태, 위험 수준, 점수 범위, 사업부 및 날짜를 기준으로 관계를 필터링합니다.
- 공급업체 온보딩 또는 오프보딩 — 승인 요약 및 수명 주기 설정과 함께 관계를 온보딩하거나, 오프보딩하고 보관합니다.
- 감사 로그 검토 — 날짜 범위 내의 사용자, 조직, 평가 및 관계 감사 이벤트를 조회합니다.
- 인텔리전스 보고서 관리 — 공급업체 도메인에 대한 BitSight, SecurityScorecard 및 Recorded Future 보고서를 생성, 업데이트 또는 가져옵니다.
문서
VISO TRUST MCP 서버
VISO TRUST API 기능을 AI 어시스턴트와 통합하기 위한 Model Context Protocol (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 프로필
remote 프로필은 Streamable HTTP 전송을 통한 원격 MCP 지원을 위해 설계되었습니다. 이 프로필은 서버를 웹 애플리케이션으로 실행하여 HTTP를 통해 원격 클라이언트와 통신할 수 있게 합니다. (Streamable HTTP는 더 이상 사용되지 않는 SSE 전송을 대체하며, 여기서는 상태 비저장 모드로 구성됩니다.)
Remote 프로필의 주요 차이점:
- 표준 입출력 대신 포트
3001에서 서블릿 웹 애플리케이션(Tomcat)으로 실행 - MCP 엔드포인트
POST /mcp노출 (Streamable HTTP) - 상태 비저장 모드로 실행 — 세션별 서버 상태가 없으므로 세션 고정 없이 로드 밸런서 뒤에서 수평 확장 가능
- 원격 클라이언트 연결에 최적화된 서버 설정
- 분산 디버깅을 위한 향상된 로깅
참고: 클라이언트는 단일 Streamable HTTP 엔드포인트
…/mcp에 연결합니다. 기존 SSE 엔드포인트(/sse+/mcp/message)는 더 이상 제공되지 않습니다.
Remote 프로필 활성화 방법:
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
Remote 프로필을 사용하는 경우:
- MCP 서버를 원격 서버 또는 클라우드 환경에 배포할 때
- 클라이언트가 직접 stdio가 아닌 Streamable HTTP를 통해 연결할 때
- 분산 배포를 위해 향상된 로깅 및 모니터링이 필요할 때
- Streamable HTTP를 통해 연결하는 웹 기반 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 File 빌드
./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 - 모든 관계 및 평가 세부 정보 목록 가져오기
매개변수가 필요하지 않습니다.
평가 상태, 위험 수준 및 연락처 정보를 포함한 제3자 공급업체 정보를 반환합니다.
get_relationship_by_id - ID로 특정 관계 및 평가 세부 정보 가져오기
- id: 관계 ID (숫자, 필수)
평가 상태, 위험 수준 및 연락처 정보를 포함한 제3자 공급업체의 자세한 정보를 반환합니다.
get_relationship_assessment_history - 관계의 평가 이력 가져오기
- id: 관계 ID (숫자, 필수)
지정된 관계와 연결된 평가 목록을 반환합니다.
create_relationship - 제3자 공급업체와 새 관계 생성
- name: 관계/공급업체 이름 (문자열, 필수)
- homepage: 공급업체 홈페이지 URL (문자열, 필수)
- businessOwnerEmail: 비즈니스 소유자의 이메일 주소 (문자열, 필수)
- businessOwnerFirstName: 비즈니스 소유자의 이름 (문자열, 선택 사항)
- businessOwnerLastName: 비즈니스 소유자의 성 (문자열, 선택 사항)
- description: 관계/공급업체 설명 (문자열, 선택 사항)
- contextTypes: 이 관계의 비즈니스 컨텍스트 유형 목록 (객체[], 선택 사항)
- dataTypes: 이 관계에서 처리하는 데이터 유형 목록 (객체[], 선택 사항)
- tags: 이 관계를 분류하는 태그 목록 (문자열[], 선택 사항)
- thirdPartyContact: 제3자 공급업체 담당자의 연락처 정보 (객체, 선택 사항)
생성된 관계 세부 정보를 반환합니다.
create_relationship_by_domain - 공급업체 도메인만 사용하여 새 관계 생성
- domain: 공급업체의 도메인(예:
visotrust.com) (string, 필수) - vendorName: 공급업체 이름 (string, 필수)
- product: 공급업체가 제공하는 제품 (string, 선택 사항)
- description: 공급업체 관계에 대한 설명 (string, 선택 사항)
생성된 관계의 세부 정보를 반환합니다.
update_relationship - 타사 공급업체와의 기존 관계 업데이트
- id: 관계 ID (number, 필수)
- name: 관계/공급업체 이름 (string, 필수)
- homepage: 공급업체 홈페이지 URL (string, 선택 사항)
- description: 관계/공급업체에 대한 설명 (string, 선택 사항)
- contextTypes: 비즈니스 컨텍스트 유형 목록 (object[], 선택 사항)
- dataTypes: 이 관계에서 처리하는 데이터 유형 목록 (object[], 선택 사항)
- businessOwnerEmail: 비즈니스 소유자의 이메일 주소 (string, 선택 사항)
- businessOwnerFirstName: 비즈니스 소유자의 이름 (string, 선택 사항)
- businessOwnerLastName: 비즈니스 소유자의 성 (string, 선택 사항)
- 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: 정확한 관계 이름 (string, 선택 사항)
- externalId: 정확한 외부 ID (string, 선택 사항)
- 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: 점수 범위(양 끝값 포함) (number, 선택 사항)
- businessUnitIds:
get_all_business_units의 사업부 ID (number[], 선택 사항) - businessOwnerIds / creatorIds:
get_all_users의 사용자 ID (number[], 선택 사항) - createdAfter / createdBefore, onboardedAfter / onboardedBefore, recertificationAfter / recertificationBefore, assessmentCompletedAfter / assessmentCompletedBefore: ISO-8601 날짜-시간 (string, 선택 사항)
- page: 0부터 시작하는 페이지 번호 (number, 선택 사항, 기본값 0)
- size: 페이지 크기 (number, 선택 사항, 기본값 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 (number, 필수)
- email: 연락처 이메일 (string, 필수)
- firstName: 연락처 이름 (string, 필수)
- lastName: 연락처 성 (string, 필수)
업데이트된 관계의 세부 정보를 반환합니다.
onboard_relationship - 승인 요약 및 수명 주기 관리 설정(선택 사항)과 함께 관계 온보딩
- id: 관계 ID (number, 필수)
- approvalSummary: 온보딩 시 기록되는 선택적 승인 요약 (string, 선택 사항)
- lifecycleManagementUpdateRequest: 선택적 수명 주기 관리 설정 (object, 선택 사항)
- artifactUpdateSettings.artifactUpdateType: 아티팩트 업데이트 유형 (string enum)
- recertificationSettings.recertificationType: 재인증 유형 (string enum)
- recertificationSettings.recertificationDate: 다음 재인증 날짜/시간(오프셋이 포함된 ISO-8601) (string)
- recertificationSettings.reviewFrequency:
THREE_YEARS,TWO_YEARS,ANNUAL,SEMIANNUAL또는QUARTERLY(string enum)
온보딩된 관계의 세부 정보를 반환합니다.
offboard_relationship - 관계 오프보딩
- id: 관계 ID (number, 필수)
오프보딩된 관계의 세부 정보를 반환합니다.
accept_relationship_risk - 관계의 위험 수용
- id: 관계 ID (number, 필수)
- request: (object, 선택 사항)
- riskReviewNote: 결정을 설명하는 메모 (string, 선택 사항)
- inherentRiskOverride / residualRiskOverride:
LOW,MEDIUM,HIGH또는EXTREME; 둘 다 제공하거나 둘 다 제공하지 않아야 합니다 (string, 선택 사항)
업데이트된 관계를 반환합니다.
get_relationship_detections - 관계 증거에서 발견된 탐지 항목 가져오기
- id: 관계 ID (number, 필수)
- detectionTypes:
NORMAL,SUBSERVICE,SHARED_RESPONSIBILITY_MODEL,EXCEPTION,CUEC,SUBPROCESSOR; 기본값은NORMAL을 제외한 전체입니다 (string[], 선택 사항) - controlDomainTypes: 포함할 제어 도메인 유형; 기본값은 전체입니다 (string[], 선택 사항)
- assessmentId: 이 관계의 완료된 평가 또는 진행 중인 최신 평가 (number, 선택 사항)
- includeQuestionnaireAnswers: 보충 설문지 탐지 항목의 근거가 된 답변 포함 여부 (boolean, 선택 사항)
- afterId: 이전 페이지의
nextAfterId(number, 선택 사항) - size: 페이지당 탐지 항목 수, 1~500 (number, 선택 사항, 기본값 100)
탐지 항목의 한 페이지를 반환합니다. nextAfterId이 null이 아닐 때까지 계속 읽으세요.
get_risk_advisories_by_relationship - 관계 공급업체의 위험 권고 가져오기
- id: 관계 ID (number, 필수)
archive_relationship - 관계 보관
- id: 관계 ID (number, 필수)
보관된 관계의 세부 정보를 반환합니다.
웹훅
get_all_webhooks - 모든 웹훅 가져오기
필요한 매개변수가 없습니다.
모든 웹훅 구성 목록을 반환합니다.
get_webhook - ID로 웹훅 구성 가져오기
- id: 웹훅 ID (number, 필수)
특정 웹훅 구성의 세부 정보를 반환합니다.
create_webhook_configuration - 웹훅 구성 생성
- request: 웹훅 생성 매개변수 (object, 필수)
- url: 웹훅 URL (string, 필수)
- secret: 웹훅 비밀 키 (string, 필수)
- eventTypes: 웹훅을 트리거할 이벤트 유형 (string[], 필수)
- serviceType: 웹훅 서비스 유형 (string, 필수)
생성된 웹훅 구성을 반환합니다.
update_webhook_configuration - 웹훅 구성 업데이트
- request: 웹훅 업데이트 매개변수 (object, 필수)
- id: 웹훅 ID (number, 필수)
- url: 웹훅 URL (string, 선택 사항)
- secret: 웹훅 비밀 키 (string, 선택 사항)
- eventTypes: 웹훅을 트리거할 이벤트 유형 (string[], 선택 사항)
- serviceType: 웹훅 서비스 유형 (string, 선택 사항)
업데이트된 웹훅 구성을 반환합니다.
delete_webhook_configuration - 웹훅 구성 삭제
- id: 웹훅 ID (number, 필수)
지정된 웹훅 구성을 삭제합니다.
인텔리전스 보고서
create_bitsight_intelligence_report - 새 BitSight 인텔리전스 보고서 생성
- request: BitSight 보고서 매개변수 (object, 필수)
- vendorDomain: 공급업체의 기본 도메인 이름 (string, 필수)
- reportDate: 보고서가 생성된 날짜/시간 (ISO 8601 string, 필수)
- link: 공급업체 UI로 연결되는 선택적 링크 (string, 선택 사항)
- guid: 엔터티의 BitSight GUID (string, 필수)
- customId: BitSight의 사용자 지정 식별자 (string, 선택 사항)
- name: BitSight 엔터티의 표시 이름 (string, 선택 사항)
- description: BitSight 엔터티에 대한 설명 (string, 선택 사항)
- primaryDomain: BitSight 엔터티의 기본 도메인 (string, 선택 사항)
- ratingRange: BitSight 등급 범위 (string, 선택 사항)
- ratingColor: BitSight 등급 색상 (string, 선택 사항)
- confidence: BitSight 등급의 신뢰도 수준 (string, 선택 사항)
생성된 인텔리전스 보고서를 반환합니다.
create_security_scorecard_intelligence_report - 새 SecurityScorecard 인텔리전스 보고서 생성
- request: SecurityScorecard 보고서 매개변수 (object, 필수)
- vendorDomain: 공급업체의 기본 도메인 이름 (string, 필수)
- reportDate: 보고서가 생성된 날짜/시간 (ISO 8601 string, 필수)
- link: 공급업체 UI로 연결되는 선택적 링크 (string, 선택 사항)
- grade: SecurityScorecard 문자 등급 (string, 필수)
- domain: 스코어카드 엔터티와 연결된 도메인 (string, 선택 사항)
- score: SecurityScorecard의 숫자 점수 (number, 선택 사항)
생성된 인텔리전스 보고서를 반환합니다.
create_recorded_future_intelligence_report - 새 Recorded Future 인텔리전스 보고서 생성
- request: Recorded Future 보고서 매개변수 (object, 필수)
- vendorDomain: 공급업체의 기본 도메인 이름 (string, 필수)
- reportDate: 보고서가 생성된 날짜/시간 (ISO 8601 string, 필수)
- entityType: Recorded Future 엔터티 유형(예:
Company) (string, 필수) - entity: Recorded Future 엔터티 식별자 (string, 필수)
- riskScore: 숫자 위험 점수 (number, 필수)
- riskLevel: 위험 수준 레이블(예:
Critical/High/Medium/Low) (string, 필수) - link: 공급업체 UI의 보고서로 연결되는 선택적 링크 (string, 선택 사항)
- firstSeen: 엔터티가 처음 관찰된 날짜(ISO 8601) (string, 선택 사항)
- lastSeen: 엔터티가 가장 최근에 관찰된 날짜(ISO 8601) (string, 선택 사항)
- triggeredRuleCount: 트리거된 Recorded Future 규칙 수 (number, 선택 사항)
- maxRuleCount: 평가된 Recorded Future 규칙의 최대 수 (number, 선택 사항)
- summary: Recorded Future의 선택적 요약 텍스트 (string, 선택 사항)
- criticalityLabel: 엔터티에 대한 Recorded Future 중요도 레이블 (string, 선택 사항)
생성된 인텔리전스 보고서를 반환합니다.
get_intelligence_reports_by_vendor - 공급업체의 모든 인텔리전스 보고서 가져오기
- vendorDomain: 공급업체의 기본 도메인 이름 (string, 필수)
지정된 공급업체의 인텔리전스 보고서 목록을 반환합니다.
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: 공급업체의 기본 도메인 이름 (string, 필수)
- source: 인텔리전스 제공업체 (string enum:
BITSIGHT,SECURITY_SCORECARD또는RECORDED_FUTURE, 필수)
지정된 공급업체 및 소스의 최신 인텔리전스 보고서를 반환합니다.
위험 권고
get_risk_advisories_by_vendor - 공급업체의 모든 위험 권고 가져오기
- vendorId: 공급업체 ID (number, 필수)
공급업체에 대해 게시된 보안, 규정 준수, 취약성, 법률, 지정학, 재무 및 운영 관련 권고를 반환합니다.
사용자
get_all_users - 조직의 모든 사용자 가져오기
- page: 가져올 결과 페이지 (숫자, 선택 사항, 기본값 0)
- size: 페이지당 레코드 수 (숫자, 선택 사항, 기본값 20)
- sort: property(,asc|desc) 형식의 정렬 기준 (문자열, 선택 사항)
페이지로 나뉜 사용자 목록을 반환합니다.
get_user_by_email - 이메일로 사용자 가져오기
- email: 사용자의 이메일 주소 (문자열, 필수)
사용자 세부 정보를 반환합니다.
create_user - 새 사용자 만들기
- request: 사용자 생성 매개변수 (객체, 필수)
- email: 새 사용자의 이메일 주소 (문자열, 필수)
- firstName: 새 사용자의 이름 (문자열, 필수)
- lastName: 새 사용자의 성 (문자열, 필수)
생성된 사용자를 반환합니다.
코드 서식
이 프로젝트는 코드 서식 지정에 Google Java Format과 함께 Spotless를 사용합니다. 일관된 코드 스타일을 유지하기 위해 커밋 전 훅이 자동으로 설정됩니다.
설정
저장소를 복제한 후 Gradle 명령을 실행하면 커밋 전 훅이 자동으로 설정됩니다.
수동 서식 지정
모든 파일의 서식을 수동으로 지정하려면:
./gradlew spotlessApply
파일의 서식이 올바른지 확인하려면:
./gradlew spotlessCheck
서식 문제로 커밋 전 훅이 커밋을 거부하면 ./gradlew spotlessApply을 실행해 서식을 수정한 다음 다시 커밋하면 됩니다.
라이선스
이 프로젝트는 MIT 라이선스에 따라 제공됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.