---
title: VAddyと連携してAPIエンドポイントに対する自動診断を設定する。
category: 外部システム連携
weight: 1
---

KurocoではVAddyと連携することで、バックエンドで設定されている全てのAPIエンドポイントに対する脆弱性診断の自動的な定期実行が可能です。

このチュートリアルでは、Kuroco管理画面でのVAddyとの連携方法を説明します。

:::caution
VAddy側の仕様の変更により、VAddy側での操作方法は本チュートリアルと異なる箇所がある場合もございます。詳細は[VAddyサポートサイト](https://support.vaddy.net/hc/ja)で最新情報をご確認ください。  
:::

## 1. VAddyを申し込む  
Kuroco管理画面にアクセスし、[外部システム連携] -> [VAddy]をクリックします。  
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/18d2347f905e24b249c63e09c9f8bd43.png)
Kuroco管理画面の[VAddyページ](/ja/docs/management/vaddy/)から「VAddyの申し込みはこちらから」をクリックします。  
![Image from Gyazo](https://t.gyazo.com/teams/diverta/8bbcaecbe913121ee07f68ed74d8e4f6.png)

サービスコードが適用された状態でVAddyのお申込みページに遷移しますので、VAddyのアカウント作成をお願いいたします。  
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/01cae640647c3ed0ba1e293928c51dae.png)

## 2. VAddyのプロジェクトを追加する
VAddyでは本番環境のサーバーへのスキャン実行は禁止されているため、診断を実施するためのFQDNを確認します。  
Kuroco管理画面にアクセスし、[外部システム連携] -> [VAddy]をクリックします。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/18d2347f905e24b249c63e09c9f8bd43.png)
Server FQDNに表示されている `kuroco-vaddy.com` のドメインのURLを確認します。  
こちらが診断を実施するためのFQDNになります。  
![Image from Gyazo](https://t.gyazo.com/teams/diverta/c69620c42538bfa4f46da1416ea93d3c.png)

次に[VAddyのスタートアップガイド](https://support.vaddy.net/hc/ja/articles/115006110548--STEP-1-%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E4%BD%9C%E6%88%90)に従って、VAddy側でプロジェクトの作成をします。  
Server FQDNは`https://`を指定して、先ほど確認をした`kuroco-vaddy.com` のドメインのURLを入力してください。  
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/c7babf808f993748b59b9a669e28a997.png)
プロジェクトが追加できたら、表示された[プロジェクトID]と[Project number]をメモしておきます。  
Project numberはURL末尾の数字になります。  
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/5ddd89a0c27bc4eecca520349cf52a63.png)
## 3. サーバー所有者確認を実施する
認証ファイルのファイル名をKuroco管理画面に入力することで所有者確認のための認証ファイル設置ができます。  
まずはVAddyのプロジェクトページで認証ファイルのファイル名を確認します。  
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/cb83a4b0f9e84bf3e3da33b05e5bf195.png)
次にKurocoの管理画面で`vaddy-`から`.html`までの認証ファイルのファイル名を入力し、[更新する]をクリックします。

![Image from Gyazo](https://t.gyazo.com/teams/diverta/3597246362c9ea0e3a9e016a51582477.png)

Kuroco管理画面で認証ファイルの項目を入力したらVAddy側の所有者確認に戻り、[認証ファイルの設置を確認する]をクリックします。  

![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/9f0850c70bb92eb486a5b2fa2696f13a.png)
:::tip
ユーザーから認証文字列確認用のURLにアクセスした場合は403エラーになりますが、VAddy側からは確認ができ、認証が通ります。  
:::

## 4. API Auth Key (VADDY_TOKEN)を取得する 
[VAddyのWebAPIの画面](https://console.vaddy.net/user/webapi)にアクセスし、[Create WebAPI Key]をクリックします。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/6b2109733ea3bcfc87bcf78331fe90cc.png)
表示された[User ID (VADDY_USER)]と[API Auth Key (VADDY_TOKEN)]をメモしておきます。  
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/5287c22736c12e6af0eb69c64683cd20.png)
以上でVAddy側での作業は完了です。  
Kurocoでの自動的な脆弱性診断はKurocoのエンドポイントをシステム側で自動的に登録するので、[「【STEP 2】クロールの設定と実行」](https://support.vaddy.net/hc/ja/articles/115005935107--STEP-2-%E3%82%AF%E3%83%AD%E3%83%BC%E3%83%AB%E3%81%AE%E8%A8%AD%E5%AE%9A%E3%81%A8%E5%AE%9F%E8%A1%8C)は実施不要です。  

## 5. Kurocoの設定をする。
次にKuroco側の設定をします。  
Kuroco管理画面にアクセスし、[外部システム連携] -> [VAddy]をクリックします。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/18d2347f905e24b249c63e09c9f8bd43.png)
「2. VAddyのプロジェクトを追加する」「4. API Auth Key (VADDY_TOKEN)を取得する」でメモした下記の情報を入力し、[更新する]をクリックします。  
- User ID (VADDY_USER)
- API Auth Key (VADDY_TOKEN)
- プロジェクトID
- Project number

![Image from Gyazo](https://t.gyazo.com/teams/diverta/d1576073c76e57c26c703a191332d6a9.png)

以上でKurocoとVAddyの連携は完了です。
バックエンドで設定されている全てのAPIエンドポイントに対する脆弱性診断の自動的な定期実行がされるようになります。  
脆弱性診断は日次で、午前3時頃に実施されます。  

![Image from Gyazo](https://t.gyazo.com/teams/diverta/d3673d45d08fb49559c68e47d512b066.png)