VISO TRUST

resmi

Akses dan kelola program risiko pihak ketiga VISO TRUST Anda langsung melalui asisten AI.

Apa yang bisa Anda lakukan dengan VISO TRUST MCP?

  • Cari penilaian vendor — Ambil penilaian tertentu berdasarkan ID, termasuk ringkasan yang dihasilkan AI dalam HTML atau Markdown.
  • Buat dan kelola penilaian — Mulai penilaian untuk relasi yang sudah ada, perbarui tanggal kedaluwarsanya, atau sesuaikan pengaturan tindak lanjut.
  • Cari relasi vendor — Filter relasi berdasarkan tag, domain, status, tingkat risiko, rentang skor, unit bisnis, dan tanggal.
  • Onboard atau offboard vendor — Onboard relasi dengan ringkasan persetujuan dan pengaturan siklus hidup, atau offboard dan arsipkan relasi tersebut.
  • Tinjau log audit — Telusuri peristiwa audit pengguna, organisasi, penilaian, dan relasi dalam rentang tanggal tertentu.
  • Kelola laporan intelijen — Buat, perbarui, atau ambil laporan BitSight, SecurityScorecard, dan Recorded Future untuk domain vendor.

Dokumentasi

Server MCP VISO TRUST

Server Model Context Protocol (MCP) untuk mengintegrasikan kemampuan API VISO TRUST dengan asisten AI.

Server Jarak Jauh yang Dihosting

VISO TRUST menghosting instans terkelola server MCP ini, sehingga Anda tidak perlu membangun, menjalankan, atau menghostingnya sendiri untuk memulai:

https://mcp.visotrust.com/mcp

Hubungkan klien MCP apa pun ke endpoint ini menggunakan transport Streamable HTTP dan lakukan autentikasi dengan token API VISO TRUST Anda. Untuk informasi tentang cara membuat token API, lihat dokumentasi dukungan VISO TRUST.

Contoh konfigurasi klien:

{
    "mcpServers": {
        "viso-mcp": {
            "type": "streamable-http",
            "url": "https://mcp.visotrust.com/mcp",
            "headers": {
                "Authorization": "Bearer <your-api-token>"
            }
        }
    }
}

Untuk menguji endpoint yang dihosting dengan MCP Inspector, jalankan npx @modelcontextprotocol/inspector, atur Transport Type ke Streamable HTTP, lalu gunakan URL di atas.

Bagian selanjutnya dari dokumen ini membahas cara menjalankan server sendiri (secara lokal atau di infrastruktur Anda sendiri).

Persyaratan

  • Java 21+
  • Gradle
  • Docker (opsional untuk deployment dalam kontainer)
  • MCP Inspector (opsional untuk pengujian)

Konfigurasi

Konfigurasi API VISO TRUST

Properti berikut dapat dikonfigurasi untuk API VISO TRUST:

  • visotrust.api.base-url: URL dasar untuk API VISO TRUST (default: http://localhost:8080)
  • visotrust.api.token: Token API Anda dari platform VISO TRUST (wajib)
  • visotrust.api.timeout: Batas waktu permintaan API dalam milidetik (default: 30000)
  • visotrust.api.connect-timeout: Batas waktu koneksi API dalam milidetik (default: 5000)

Untuk informasi tentang cara membuat token API untuk variabel lingkungan visotrust.api.token, lihat dokumentasi dukungan VISO TRUST.

Profil Aplikasi

Aplikasi ini mendukung profil Spring Boot untuk mengaktifkan konfigurasi berbeda bagi berbagai skenario deployment.

Profil Remote

Profil remote dirancang untuk dukungan MCP jarak jauh melalui transport Streamable HTTP. Profil ini menjalankan server sebagai aplikasi web agar dapat berkomunikasi dengan klien jarak jauh melalui HTTP. (Streamable HTTP menggantikan transport SSE yang sudah tidak digunakan lagi; di sini, transport ini dikonfigurasi dalam mode stateless.)

Perbedaan utama pada profil remote:

  • Berjalan sebagai aplikasi web servlet (Tomcat) pada port 3001, bukan menggunakan standard I/O
  • Mengekspos endpoint MCP di POST /mcp (Streamable HTTP)
  • Berjalan dalam mode stateless — tidak ada status server per sesi, sehingga dapat diskalakan secara horizontal di belakang load balancer tanpa memerlukan afinitas sesi
  • Pengaturan server dioptimalkan untuk koneksi klien jarak jauh
  • Logging yang ditingkatkan untuk debugging terdistribusi

Catatan: Klien terhubung ke satu endpoint Streamable HTTP, yaitu …/mcp. Endpoint SSE lama (/sse + /mcp/message) tidak lagi disediakan.

Cara mengaktifkan profil remote:

Saat menjalankan langsung dengan Java:

java -jar viso-mcp-server-<version>.jar --spring.profiles.active=remote

Saat menjalankan dengan Gradle:

./gradlew bootRun --args="--spring.profiles.active=remote"

Saat menggunakan Docker:

docker run -i --rm \
  -e VISOTRUST_API_TOKEN=<your-api-token> \
  -e SPRING_PROFILES_ACTIVE=remote \
  viso-mcp-server

Kapan menggunakan profil remote:

  • Saat men-deploy server MCP ke server jarak jauh atau lingkungan cloud
  • Saat klien akan terhubung melalui Streamable HTTP, bukan stdio langsung
  • Saat Anda memerlukan logging dan pemantauan yang ditingkatkan untuk deployment terdistribusi
  • Saat mengintegrasikan dengan asisten AI berbasis web yang terhubung melalui Streamable HTTP

Untuk pengembangan lokal dan komunikasi stdio langsung, gunakan profil default (tidak perlu menentukan profil).

Instalasi

Instalasi Cepat

Klik salah satu tombol di bawah untuk menginstal VISO MCP Server di VS Code:

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

Penyiapan Manual dengan VS Code

Tambahkan blok JSON berikut ke file User Settings (JSON) di VS Code. Anda dapat melakukannya dengan menekan Ctrl + Shift + P lalu mengetik 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}"
        }
      }
    }
  }
}

Sebagai opsi, Anda dapat menambahkan contoh serupa (yaitu tanpa kunci mcp) ke file bernama .vscode/mcp.json di ruang kerja Anda. Dengan demikian, konfigurasi dapat dibagikan kepada orang lain.

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

Penggunaan dengan Claude Desktop dan Klien MCP lainnya

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

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

Catatan: Variabel lingkungan JAVA_TOOL_OPTIONS digunakan untuk mengatur opsi JVM untuk debugging jarak jauh. Alamat dan port dapat diubah sesuai kebutuhan.

💻 Pengembangan

Penyiapan Docker

Membangun Image Docker

docker build -t viso-mcp-server .

Menjalankan Kontainer Docker

docker run -i --rm -e VISOTRUST_API_TOKEN=<your-api-token> viso-mcp-server

Debugging

Menginstal MCP Inspector

npm -g install @modelcontextprotocol/inspector

Menjalankan MCP Inspector untuk Pengujian

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

Ganti <version> dengan versi proyek saat ini (misalnya, 1.0.0 atau versi dari rilis terbaru).

Pipeline CI/CD

Proyek ini menggunakan GitHub Actions untuk integrasi dan deployment berkelanjutan. Alur kerja ini mencakup pekerjaan berikut:

Lint

Memeriksa pemformatan kode menggunakan Spotless:

./gradlew spotlessCheck

Build

Membangun aplikasi dan membuat file JAR:

./gradlew build

Publish

Saat rilis baru dibuat:

  1. Memperbarui versi proyek di build.gradle agar sesuai dengan tag rilis
  2. Mengunggah file JAR ke rilis GitHub dengan versi dari tag rilis
  3. Membangun dan mengirim image Docker ke Docker Hub dengan tag:
    • latest
    • Tag rilis (misalnya, v1.0.0)
Secret yang Diperlukan untuk Publikasi

Untuk mengaktifkan publikasi ke Docker Hub, tambahkan secret berikut ke repositori GitHub Anda:

  • DOCKERHUB_USERNAME: Nama pengguna Docker Hub Anda
  • DOCKERHUB_TOKEN: Token akses Docker Hub Anda

🛠️ Tools

Bagian ini menyediakan dokumentasi untuk tools yang diekspos oleh VISO MCP Server. Setiap tool memiliki tujuan, parameter input, dan format output tertentu.

Penilaian

get_assessment - Mendapatkan penilaian berdasarkan ID-nya

  • id: ID penilaian (angka, wajib)

Mengembalikan informasi terperinci tentang penilaian tertentu.

get_assessment_summary - Mendapatkan ringkasan penilaian berdasarkan ID-nya

  • id: ID penilaian (angka, wajib)
  • format: HTML (default) atau MARKDOWN (string, opsional)

Mengembalikan ringkasan, version-nya, dan apakah ringkasan tersebut telah edited.

update_assessment_summary - Mengganti teks ringkasan penilaian yang dibuat oleh AI dan telah selesai

  • id: ID penilaian (angka, wajib)
  • summary: Ringkasan yang telah diedit (string, wajib)
  • format: HTML (default) atau MARKDOWN (string, opsional)
  • version: version dari get_assessment_summary; pembaruan ditolak jika ringkasan berubah sejak saat itu (string, opsional)

Mengembalikan ringkasan yang diperbarui dalam format yang digunakan saat dikirim.

create_assessment - Memulai penilaian untuk relasi yang sudah ada

  • relationshipId: ID relasi yang akan dibuatkan penilaian (angka, wajib)
  • recipientEmail: Alamat email penerima penilaian (string, opsional)
  • recipientFirstName: Nama depan penerima penilaian (string, opsional)
  • recipientLastName: Nama belakang penerima penilaian (string, opsional)
  • publicDocumentUrls: URL dokumen publik yang akan disertakan dalam penilaian (string[], opsional)
  • followupType: Jenis tindak lanjut (enum string, opsional)
  • followupRiskThreshold: Ambang tingkat risiko yang memicu tindak lanjut (enum string, opsional)
  • followupTimeline: Linimasa untuk tindakan tindak lanjut (enum string, opsional)
  • collectionTimeline: Linimasa bagi vendor untuk menyelesaikan pengiriman penilaian (enum string, opsional)
  • noVendorResponseAction: Tindakan yang dilakukan jika vendor tidak merespons (enum string, opsional)
  • aiProcessingOnly: Apakah pemrosesan hanya dilakukan menggunakan AI tanpa tinjauan manusia (boolean, opsional)
  • requestedAuditTypes: Jenis audit yang diminta untuk penilaian ini (string[], opsional)

Mengembalikan detail penilaian yang dibuat.

update_assessment_expiration_date - Memperbarui tenggat waktu pengiriman respons penilaian oleh vendor

  • id: ID penilaian (angka, wajib)
  • expirationDate: Tanggal/waktu kedaluwarsa baru, ISO-8601 dengan offset; harus di masa mendatang (string, wajib)

Mengembalikan pesan konfirmasi.

update_assessment_followup - Memperbarui konfigurasi tindak lanjut untuk penilaian

  • id: ID penilaian (angka, wajib)
  • followupType: Jenis tindak lanjut (enum string, wajib)
  • followupRiskThreshold: Ambang risiko yang memicu penilaian tindak lanjut jika tercapai atau terlampaui (enum string, opsional)
  • followupTimeline: Linimasa tindak lanjut (enum string, opsional)

Mengembalikan pesan konfirmasi.

Log Audit

get_user_audit_log_events - Mendapatkan peristiwa log audit yang cakupannya terbatas pada pengguna di organisasi Anda

  • start: Tanggal/waktu mulai kueri, ISO-8601 dengan offset (string, wajib)
  • end: Tanggal/waktu akhir kueri, ISO-8601 dengan offset (string, wajib)
  • eventTypes: Kumpulan jenis peristiwa opsional untuk memfilter (misalnya, USER_LOGGED_IN); biarkan kosong untuk mengambil semua (string[], opsional)

Mengembalikan daftar peristiwa log audit pengguna, dibatasi hingga 500 catatan.

get_audit_log_events - Mendapatkan peristiwa log audit yang difilter (peristiwa pengguna, organisasi, penilaian, dan relasi)

  • start: Tanggal/waktu mulai kueri, ISO-8601 dengan offset (string, wajib)
  • end: Tanggal/waktu akhir kueri, ISO-8601 dengan offset (string, wajib)
  • eventTypes: Kumpulan jenis peristiwa opsional untuk memfilter (misalnya, ASSESSMENT_COMPLETED, RELATIONSHIP_CREATED); biarkan kosong untuk mengambil semua (string[], opsional)

Mengembalikan catatan peristiwa log audit polimorfik. Setiap item memiliki setidaknya auditEventType dan dateTime.

Unit Bisnis

get_all_business_units - Mendapatkan semua unit bisnis organisasi Anda, diurutkan berdasarkan nama

Mengembalikan id setiap unit bisnis (dapat digunakan sebagai filter businessUnitIds di search_relationships) dan name (dapat digunakan sebagai businessUnit di create_user).

Kasus Bisnis

get_all_business_cases - Mendapatkan semua kasus bisnis yang tersedia untuk organisasi Anda

Tidak memerlukan parameter.

Mengembalikan daftar semua kasus bisnis yang tersedia untuk organisasi Anda.

Jenis Data

get_all_datatypes - Mendapatkan semua jenis data yang tersedia untuk organisasi Anda

Tidak memerlukan parameter.

Mengembalikan daftar semua jenis data yang tersedia untuk organisasi Anda.

Direktori Vendor

search_vendor_directory - Mencari vendor di direktori vendor VISO TRUST berdasarkan URL atau domain

  • urlOrDomain: URL atau nama domain yang akan dicari, misalnya example.com (string, wajib)

Mengembalikan metadata dasar vendor (nama, beranda, deskripsi, favicon, domain yang diketahui).

Relasi

get_all_relationships - Mendapatkan daftar semua relasi beserta detail penilaiannya

Tidak memerlukan parameter.

Mengembalikan informasi tentang vendor pihak ketiga, termasuk status penilaian, tingkat risiko, dan detail kontaknya.

get_relationship_by_id - Mendapatkan relasi tertentu beserta detail penilaiannya berdasarkan ID

  • id: ID relasi (angka, wajib)

Mengembalikan informasi terperinci tentang vendor pihak ketiga, termasuk status penilaian, tingkat risiko, dan detail kontaknya.

get_relationship_assessment_history - Mendapatkan riwayat penilaian untuk suatu relasi

  • id: ID relasi (angka, wajib)

Mengembalikan daftar penilaian yang terkait dengan relasi yang ditentukan.

create_relationship - Membuat relasi baru dengan vendor pihak ketiga

  • name: Nama relasi/vendor (string, wajib)
  • homepage: URL beranda vendor (string, wajib)
  • businessOwnerEmail: Alamat email pemilik bisnis (string, wajib)
  • businessOwnerFirstName: Nama depan pemilik bisnis (string, opsional)
  • businessOwnerLastName: Nama belakang pemilik bisnis (string, opsional)
  • description: Deskripsi relasi/vendor (string, opsional)
  • contextTypes: Daftar jenis konteks bisnis untuk relasi ini (object[], opsional)
  • dataTypes: Daftar jenis data yang ditangani dalam relasi ini (object[], opsional)
  • tags: Daftar tag untuk mengategorikan relasi ini (string[], opsional)
  • thirdPartyContact: Detail kontak perwakilan vendor pihak ketiga (object, opsional)

Mengembalikan detail relasi yang dibuat.

create_relationship_by_domain - Buat relasi baru hanya dengan menggunakan domain vendor

  • domain: Domain vendor, misalnya visotrust.com (string, wajib)
  • vendorName: Nama vendor (string, wajib)
  • product: Produk yang ditawarkan vendor (string, opsional)
  • description: Deskripsi relasi dengan vendor (string, opsional)

Mengembalikan detail relasi yang dibuat.

update_relationship - Perbarui relasi yang sudah ada dengan vendor pihak ketiga

  • id: ID relasi (number, wajib)
  • name: Nama relasi/vendor (string, wajib)
  • homepage: URL beranda vendor (string, opsional)
  • description: Deskripsi relasi/vendor (string, opsional)
  • contextTypes: Daftar jenis konteks bisnis (object[], opsional)
  • dataTypes: Daftar jenis data yang ditangani dalam relasi ini (object[], opsional)
  • businessOwnerEmail: Alamat email pemilik bisnis (string, opsional)
  • businessOwnerFirstName: Nama depan pemilik bisnis (string, opsional)
  • businessOwnerLastName: Nama belakang pemilik bisnis (string, opsional)
  • tags: Daftar tag (string[], opsional)

Mengembalikan detail relasi yang diperbarui.

partially_update_relationship - Perbarui sebagian relasi yang sudah ada

Menerima kolom yang sama dengan update_relationship. Hanya kolom yang disertakan dalam permintaan yang diubah; kolom lainnya tidak berubah.

Mengembalikan detail relasi yang diperbarui.

search_relationships - Cari relasi berdasarkan kriteria filter

Memanggil POST /api/v1/relationships/search. Semua filter bersifat opsional; filter digabungkan dengan AND, sedangkan nilai dalam satu filter daftar digabungkan dengan OR.

  • request: Filter pencarian (object, opsional)
    • tags: Nama tag, persis seperti yang ditampilkan di VISO TRUST (string[], opsional)
    • domains: Nama domain vendor, misalnya example.com (string[], opsional)
    • name: Nama relasi yang persis (string, opsional)
    • externalId: ID eksternal yang persis (string, opsional)
    • statuses: Status relasi — NOT_ONBOARDED, ONBOARDED, ARCHIVED (string[], opsional)
    • assessmentStatuses: Status asesmen terbaru (string[], opsional)
    • riskAcceptanceStatuses: RISK_ACCEPTED, REVIEW_NEEDED, REMEDIATION_REQUESTED (string[], opsional)
    • inherentRiskLevels / residualRiskLevels: NO_CONTEXT, LOW, MEDIUM, HIGH, EXTREME (string[], opsional)
    • minScore / maxScore: Rentang skor, inklusif (number, opsional)
    • businessUnitIds: ID unit bisnis dari get_all_business_units (number[], opsional)
    • businessOwnerIds / creatorIds: ID pengguna dari get_all_users (number[], opsional)
    • createdAfter / createdBefore, onboardedAfter / onboardedBefore, recertificationAfter / recertificationBefore, assessmentCompletedAfter / assessmentCompletedBefore: Tanggal-waktu ISO-8601 (string, opsional)
  • page: Nomor halaman berbasis nol (number, opsional, default 0)
  • size: Ukuran halaman (number, opsional, default 100, maks. 500)
  • sort: Urutan pengurutan sebagai property,asc|desc; properti name, externalId, score, createdDate, onboardedDate, recertificationDate (string[], opsional)

Mengembalikan totalCount, page, size, hasMore dan halaman berisi relationships yang cocok.

create_tags - Buat tag baru untuk mengategorikan relasi

  • tags: Daftar nama tag yang akan dibuat (string[], wajib)

Mengembalikan daftar semua tag, termasuk tag yang baru dibuat.

update_third_party_contact - Perbarui detail kontak vendor pihak ketiga

  • relationshipId: ID relasi (number, wajib)
  • email: Email kontak (string, wajib)
  • firstName: Nama depan kontak (string, wajib)
  • lastName: Nama belakang kontak (string, wajib)

Mengembalikan detail relasi yang diperbarui.

onboard_relationship - Onboard relasi, secara opsional dengan ringkasan persetujuan dan pengaturan manajemen siklus hidup

  • id: ID relasi (number, wajib)
  • approvalSummary: Ringkasan persetujuan opsional yang dicatat saat onboarding (string, opsional)
  • lifecycleManagementUpdateRequest: Pengaturan manajemen siklus hidup opsional (object, opsional)
    • artifactUpdateSettings.artifactUpdateType: Jenis pembaruan artefak (string enum)
    • recertificationSettings.recertificationType: Jenis sertifikasi ulang (string enum)
    • recertificationSettings.recertificationDate: Tanggal/waktu sertifikasi ulang berikutnya, ISO-8601 dengan offset (string)
    • recertificationSettings.reviewFrequency: THREE_YEARS, TWO_YEARS, ANNUAL, SEMIANNUAL, atau QUARTERLY (string enum)

Mengembalikan detail relasi yang di-onboard.

offboard_relationship - Offboard relasi

  • id: ID relasi (number, wajib)

Mengembalikan detail relasi yang di-offboard.

accept_relationship_risk - Terima risiko suatu relasi

  • id: ID relasi (number, wajib)
  • request: (object, opsional)
    • riskReviewNote: Catatan yang menjelaskan keputusan (string, opsional)
    • inherentRiskOverride / residualRiskOverride: LOW, MEDIUM, HIGH atau EXTREME; isi keduanya atau jangan isi keduanya (string, opsional)

Mengembalikan relasi yang diperbarui.

get_relationship_detections - Dapatkan deteksi yang ditemukan dalam bukti relasi

  • id: ID relasi (number, wajib)
  • detectionTypes: NORMAL, SUBSERVICE, SHARED_RESPONSIBILITY_MODEL, EXCEPTION, CUEC, SUBPROCESSOR; secara default mencakup semua kecuali NORMAL (string[], opsional)
  • controlDomainTypes: Jenis domain kontrol yang akan disertakan; secara default mencakup semua (string[], opsional)
  • assessmentId: Asesmen relasi ini yang telah selesai, atau asesmen terbaru yang sedang berlangsung (number, opsional)
  • includeQuestionnaireAnswers: Sertakan jawaban yang mendasari deteksi kuesioner tambahan (boolean, opsional)
  • afterId: nextAfterId dari halaman sebelumnya (number, opsional)
  • size: Jumlah deteksi per halaman, 1 hingga 500 (number, opsional, default 100)

Mengembalikan satu halaman deteksi; lanjutkan membaca selama nextAfterId tidak null.

get_risk_advisories_by_relationship - Dapatkan advis risiko untuk vendor suatu relasi

  • id: ID relasi (number, wajib)

archive_relationship - Arsipkan relasi

  • id: ID relasi (number, wajib)

Mengembalikan detail relasi yang diarsipkan.

Webhook

get_all_webhooks - Dapatkan semua webhook

Tidak memerlukan parameter.

Mengembalikan daftar semua konfigurasi webhook.

get_webhook - Dapatkan konfigurasi webhook berdasarkan id

  • id: ID webhook (number, wajib)

Mengembalikan detail konfigurasi webhook tertentu.

create_webhook_configuration - Buat konfigurasi webhook

  • request: Parameter pembuatan webhook (object, wajib)
    • url: URL webhook (string, wajib)
    • secret: Secret webhook (string, wajib)
    • eventTypes: Jenis peristiwa yang memicu webhook (string[], wajib)
    • serviceType: Jenis layanan untuk webhook (string, wajib)

Mengembalikan konfigurasi webhook yang dibuat.

update_webhook_configuration - Perbarui konfigurasi webhook

  • request: Parameter pembaruan webhook (object, wajib)
    • id: ID webhook (number, wajib)
    • url: URL webhook (string, opsional)
    • secret: Secret webhook (string, opsional)
    • eventTypes: Jenis peristiwa yang memicu webhook (string[], opsional)
    • serviceType: Jenis layanan untuk webhook (string, opsional)

Mengembalikan konfigurasi webhook yang diperbarui.

delete_webhook_configuration - Hapus konfigurasi webhook

  • id: ID webhook (number, wajib)

Menghapus konfigurasi webhook yang ditentukan.

Laporan Intelijen

create_bitsight_intelligence_report - Buat laporan intelijen BitSight baru

  • request: Parameter laporan BitSight (object, wajib)
    • vendorDomain: Nama domain utama vendor (string, wajib)
    • reportDate: Tanggal/waktu laporan dibuat (string ISO 8601, wajib)
    • link: Tautan opsional ke UI penyedia (string, opsional)
    • guid: GUID BitSight untuk entitas (string, wajib)
    • customId: Pengidentifikasi khusus dari BitSight (string, opsional)
    • name: Nama tampilan entitas BitSight (string, opsional)
    • description: Deskripsi entitas BitSight (string, opsional)
    • primaryDomain: Domain utama untuk entitas BitSight (string, opsional)
    • ratingRange: Rentang peringkat BitSight (string, opsional)
    • ratingColor: Warna peringkat BitSight (string, opsional)
    • confidence: Tingkat keyakinan peringkat BitSight (string, opsional)

Mengembalikan laporan intelijen yang dibuat.

create_security_scorecard_intelligence_report - Buat laporan intelijen SecurityScorecard baru

  • request: Parameter laporan SecurityScorecard (object, wajib)
    • vendorDomain: Nama domain utama vendor (string, wajib)
    • reportDate: Tanggal/waktu laporan dibuat (string ISO 8601, wajib)
    • link: Tautan opsional ke UI penyedia (string, opsional)
    • grade: Nilai huruf SecurityScorecard (string, wajib)
    • domain: Domain yang terkait dengan entitas scorecard (string, opsional)
    • score: Skor numerik dari SecurityScorecard (number, opsional)

Mengembalikan laporan intelijen yang dibuat.

create_recorded_future_intelligence_report - Buat laporan intelijen Recorded Future baru

  • request: Parameter laporan Recorded Future (object, wajib)
    • vendorDomain: Nama domain utama vendor (string, wajib)
    • reportDate: Tanggal/waktu laporan dibuat (string ISO 8601, wajib)
    • entityType: Jenis entitas Recorded Future, misalnya Company (string, wajib)
    • entity: Pengidentifikasi entitas Recorded Future (string, wajib)
    • riskScore: Skor risiko numerik (number, wajib)
    • riskLevel: Label tingkat risiko, misalnya Critical/High/Medium/Low (string, wajib)
    • link: Tautan opsional ke laporan di UI penyedia (string, opsional)
    • firstSeen: Tanggal paling awal entitas teramati, ISO 8601 (string, opsional)
    • lastSeen: Tanggal paling baru entitas teramati, ISO 8601 (string, opsional)
    • triggeredRuleCount: Jumlah aturan Recorded Future yang terpicu (number, opsional)
    • maxRuleCount: Jumlah maksimum aturan Recorded Future yang dievaluasi (number, opsional)
    • summary: Teks ringkasan opsional dari Recorded Future (string, opsional)
    • criticalityLabel: Label tingkat kritikalitas Recorded Future untuk entitas (string, opsional)

Mengembalikan laporan intelijen yang dibuat.

get_intelligence_reports_by_vendor - Dapatkan semua laporan intelijen untuk vendor

  • vendorDomain: Nama domain utama vendor (string, wajib)

Mengembalikan daftar laporan intelijen untuk vendor yang ditentukan.

get_intelligence_report - Dapatkan laporan intelijen berdasarkan ID

  • id: ID laporan (UUID, wajib)

update_bitsight_intelligence_report, update_security_scorecard_intelligence_report, update_recorded_future_intelligence_report - Ganti laporan intelijen yang sudah ada

  • id: ID laporan (UUID, wajib)
  • request: Kolom yang sama dengan alat create_*_intelligence_report yang sesuai. Kolom opsional yang tidak disertakan akan dihapus.

delete_intelligence_report - Hapus laporan intelijen secara permanen

  • id: ID laporan (UUID, wajib)

bulk_create_bitsight_intelligence_reports, bulk_create_security_scorecard_intelligence_reports, bulk_create_recorded_future_intelligence_reports - Buat hingga 1000 laporan intelijen sekaligus

  • reports: Kolom yang sama dengan alat create_*_intelligence_report yang sesuai (object[], wajib)

Mengembalikan totalCount, ID laporan created, dan backgroundedCount untuk laporan yang masuk antrean pembuatan di latar belakang.

get_latest_intelligence_report - Dapatkan laporan intelijen terbaru untuk vendor dari sumber tertentu

  • vendorDomain: Nama domain utama vendor (string, wajib)
  • source: Penyedia intelijen (string enum: BITSIGHT, SECURITY_SCORECARD, atau RECORDED_FUTURE, wajib)

Mengembalikan laporan intelijen terbaru untuk vendor dan sumber yang ditentukan.

Advis Risiko

get_risk_advisories_by_vendor - Dapatkan semua advis risiko untuk vendor

  • vendorId: ID vendor (number, wajib)

Mengembalikan advis keamanan, kepatuhan, kerentanan, hukum, geopolitik, keuangan, dan operasional yang diterbitkan untuk vendor.

Pengguna

get_all_users - Dapatkan semua pengguna di organisasi Anda

  • page: Halaman hasil yang akan diambil (angka, opsional; default 0)
  • size: Jumlah catatan per halaman (angka, opsional; default 20)
  • sort: Kriteria pengurutan dalam format: property(,asc|desc) (string, opsional)

Mengembalikan daftar pengguna dengan paginasi.

get_user_by_email - Dapatkan pengguna berdasarkan email

  • email: Alamat email pengguna (string, wajib)

Mengembalikan detail pengguna.

create_user - Buat pengguna baru

  • request: Parameter pembuatan pengguna (objek, wajib)
    • email: Alamat email pengguna baru (string, wajib)
    • firstName: Nama depan pengguna baru (string, wajib)
    • lastName: Nama belakang pengguna baru (string, wajib)

Mengembalikan pengguna yang dibuat.

Pemformatan Kode

Proyek ini menggunakan Spotless dengan Google Java Format untuk pemformatan kode. Hook pre-commit disiapkan secara otomatis untuk memastikan gaya kode yang konsisten.

Penyiapan

Setelah mengkloning repositori, hook pre-commit akan disiapkan secara otomatis saat Anda menjalankan perintah Gradle apa pun.

Pemformatan Manual

Untuk memformat semua file secara manual:

./gradlew spotlessApply

Untuk memeriksa apakah file telah diformat dengan benar:

./gradlew spotlessCheck

Jika hook pre-commit menolak commit Anda karena masalah pemformatan, jalankan ./gradlew spotlessApply untuk memperbaiki pemformatan, lalu coba commit lagi.

Lisensi

Proyek ini dilisensikan di bawah Lisensi MIT — lihat file LICENSE untuk detailnya.