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를 설치하세요.

Install with Docker in VS Code Install with Docker in VS Code Insiders

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 실행

  1. MCP Server Jar File 빌드
./gradlew bootJar
  1. 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

게시

새 릴리스가 생성되면:

  1. build.gradle의 프로젝트 버전을 릴리스 태그와 일치하도록 업데이트
  2. 릴리스 태그의 버전을 사용해 JAR 파일을 GitHub 릴리스에 업로드
  3. 다음 태그를 사용해 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 파일을 참조하세요.