SaaS型Webアプリ診断ツール「AeyeScan」を運営している株式会社エーアイセキュリティラボが、セキュリティテストの自動化、脆弱性診断の内製化、AI/機械学習などの技術情報の共有を目的とした記事です。
AeyeScanの情報はこちら https://www.aeyescan.jp
エーアイセキュリティラボの情報はこちら、https://www.aeyesec.jp

こんにちは。株式会社エーアイセキュリティラボ　インターンの大桶です。
こちらの記事では脆弱性診断ツール「AeyeScan」の機能や、脆弱性診断内製化のコツ、CIツールを使ったDevSecOps等を紹介していきます。

前回はAeyeScanによる脆弱性診断を手動で実行する手順について紹介しました。
第2回目「Github Actionsを使ったAeyeScanによる診断の自動化」は以下のような内容でお送りします！

■なぜ脆弱性診断の自動化が必要?

システム開発において、開発と運用を短い周期で繰り返していく手法をDevOpsと呼び、生産性を上げる手法として広く採用されています。
システム開発のもう一つの重要な要素としてセキュリティ品質の担保がありますが、DevOpsのサイクルにセキュリティ診断を組み込んだものをDevSecOpsと呼びます。

DevSecOpsを実現するためには、システムの開発と運用のサイクルに合わせて高い頻度でセキュリティ診断を行う必要があります。
このような高い頻度でのセキュリティ診断を実現するための手法の１つとして、CIツールなどによるセキュリティ診断の自動化が有効になります。

■GitHub Actionsの紹介

GitHub ActionsはGitHubが提供するCIツールの一種で、GitHubのアカウントがあれば誰でも利用が可能です。
ワークフローをyaml形式で記述することで、ソフトウェア開発中のタスクを簡単に自動化することができます。

今回の記事では、このGitHub Actionsを使用してAeyeScanによる脆弱性診断を自動で実行していきます！

■GitHub ActionsでAeyeScanを自動実行

・スキャン作成

まずはAeyeScanで新規スキャンの作成を行います。
この手順の詳細については前回の記事をご覧ください。

作成したスキャンのIDを後で使うのでここで控えておきます。

・APIキー作成

次に、AeyeScanでAPIキーを作成します。
APIキーはAeyeScanのメニューバーの「組織設定」→「APIキー管理」から作成できます。
APIキーを作成する際には書き込み・実行権限を「書き込み」に設定します。

作成したAPIキーとトークンは後から確認できないため、安全な場所に保管してください。

・GitHub secretsの追加

次に、GitHubリポジトリにsecretsを追加し、前の手順で作成したAPIキーとトークンの値を設定します。
GitHub secretsの追加手順については公式ドキュメントをご覧ください。
以下のような名前と値でGitHub secretsを追加します。

・GitHub Actions workflowの作成

最後に、githubリポジトリにworkflowを作成します。
GitHub Actions workflowについてはこちらをご覧ください。
リポジトリに./github/workflows/という名前でディレクトリを作成し、
この下に適当な名前で以下のような内容のyamlファイルを作成します。

yamlファイル

name: scan
on:
###################################################
# 毎日17時(JST)=8時(UTC)に実行
###################################################
schedule:
  - cron: '0 8 * * *'
jobs:
build:
  runs-on: ubuntu-latest
  # Steps represent a sequence of tasks that will be executed as part of the job
  steps:
    - name: Run scan
      run: |
        # テンプレートとなるスキャンIDを指定する。
        COPYID='7'
       
        # スキャンデータをコピーする。設定を変更する場合は、このテンプレートに対して行う。
        COPY_RES=$(curl -X PUT https://api.aeyescan.com/api/v1/scan/$COPYID/copy \
          -H "X-AEYE-API-KEY:${{ secrets.API_KEY }}" \
          -H "X-AEYE-API-TOKEN:${{ secrets.API_TOKEN }}" \
          -H "Content-Type:application/json")
       
        # コピーしたスキャンデータを使って巡回とスキャンを実行する。
        SCANID=$(echo "$COPY_RES" | jq -r .scanInfo.id)
        curl -X PUT https://api.aeyescan.com/api/v1/scan/$SCANID/startCrawl \
          -H "X-AEYE-API-KEY:${{ secrets.API_KEY }}" \
          -H "X-AEYE-API-TOKEN:${{ secrets.API_TOKEN }}" \
          -H "Content-Type:application/json" \
          -d '{"scanMode": 1,"speed": "normal"}'

こちらのyamlファイルはほぼそのままお使いいただけますが、以下の2箇所は各自で編集していただく必要があります。

7行目　実行時間の設定
　posix cron syntaxで実行時間を指定しています。
　タイムゾーンがJSTでなくUTCで指定する点にご注意ください。
　scheduleによる実行時間の指定方法についてはこちらをご覧ください。
16行目　テンプレートとなるスキャンID
　前の手順で作成したAeyeScanのスキャンIDをここに入力します。