この記事で分かること

ネットワーク機器の脆弱性確認を担当する方へ。私がOpenVulnQueryで行った一次確認の自動化を、入力・照合・チケットの三段階で紹介します。

  • ASA・IOS・Nexusを選び、保存済みのOS一覧を使う流れ。
  • 脆弱性ごとのチケットに、OSの該当・非該当を○×で並べる考え方。
  • 取得失敗を非該当と混同しない、説明用サンプルの試し方。

実際に自動化した作業

私が作ったのは、ASA・IOS・Nexusを選択式にし、別に保存していたOSバージョンの一覧と対象の脆弱性一覧を参照する仕組みです。OpenVulnQueryを使った一次確認の結果を、脆弱性ごとのチケットにまとめ、OSバージョンの該当・非該当を○×で出しました。

記事で紹介したいのは、APIから情報を取る部分と、確認する単位をそろえてチケットへ渡す部分です。対象の脆弱性と対象OSの組み合わせが見えると、どこを詳しく確認するかを整理できます。

一つのOS条件から候補を確認する入口として、Cisco製品の一次確認ページも用意しています。実APIの利用状態はページ内に表示し、架空データで画面操作を試すこともできます。

01 入力機器の種類を選ぶASA / IOS / Nexus
保存済みOS一覧・対象脆弱性一覧
02 照合対象の組み合わせを確認OpenVulnQueryで得た情報と
確認したい脆弱性を照合
03 出力脆弱性ごとのチケットOSバージョンごとに○×
人が詳細確認するための入口
実体験と、この記事のサンプルの範囲

上の選択・一覧の参照・チケット単位の○×出力は実際に行った作業です。以下のJSON、CSV、Pythonコードは、その流れを説明するために新しく作った架空データの例です。元の運用コードやチケット画面の複製ではありません。未確認を「?」にする扱いも、このサンプルで加えた設計です。

二つの一覧を用意する

最初に、確認する機器・OSの一覧と、確認したい脆弱性の一覧を分けます。機器名や管理IPを公開しなくても、照合に必要な条件だけで処理の形を説明できます。

一覧サンプルの項目用途
OS一覧family / version / platform / mode種類・版・機種・動作モードを区別する
対象脆弱性一覧ticket / advisory_id / title確認チケットと対象IDを対応させる
照会結果同じOS条件 / status / advisory_ids / checked_at照会の成否・対象ID・確認日時を残す

この記事では、対象IDをCiscoのアドバイザリIDにそろえる例を使います。元の運用で使った一覧の形式を再現したものではありません。手元の一覧がCVE番号なら、対応するアドバイザリIDとの関係を確かめてから照合してください。一つのアドバイザリに複数のCVEが含まれる場合もあるため、文字列の部分一致で同じものと判定しないようにします。

選択肢の「Nexus」は機器の呼び名です。実際の照会では、NX-OSのstandaloneとACIを区別し、対象の機種も確かめます。この例のNexusは説明用のstandaloneです。IOSとIOS XEも別の種類として扱います。Ciscoの対応OSと検索条件はopenVuln APIの概要 ↗で確認できます。

○×表の読み方を決める

○×を出す前に、記号が表す範囲を決めます。次の表はこの記事の説明用サンプルのルールです。○は詳細確認へ進む候補、×は今回の条件で照合した一覧に対象IDがなかった結果を表します。

記号条件次にすること
○:一次候補同じOS条件の、正常かつ全件取得済みの結果に対象IDがある公式アドバイザリの影響条件と機器設定を確認する
×:今回の候補なし同じOS条件で正常に全件取得でき、版が有効と確認された結果に対象IDがない照会条件・日時・対象範囲を残す。安全の保証には使わない
?:要確認未取得、取得失敗、取得途中、無効な版、結果の重複・構造不正条件や取得処理を直して再確認する

この段階では、機器の設定や有効な機能、到達可能性などを判断していません。○がそのまま実際の悪用可能性を示すわけではなく、×も全脆弱性への非該当を示しません。チケットには記号だけでなく、照合理由と確認日時を残します。

架空データで、チケット用の表を作る

APIの認証情報を用意する前に、照合と出力だけを手元で試せます。Python標準ライブラリを使い、外部通信・機器への接続・チケットサービスへの登録は行いません。JSONの結果は生のAPIレスポンスではなく、このサンプル専用の正規化済みデータです。

対象環境とファイルの配置

Python 3.12で実行できます。次の5ファイルを新しい作業フォルダの同じ場所に保存してください。

openvuln-triage/
  triage.py
  test_triage.py
  inventory.json
  targets.json
  query-results.json

実行する

保存したフォルダで次のコマンドを実行します。--family ASA、IOS、Nexusで選択した種類だけを出力でき、allは全種類です。

python triage.py --family all --inventory inventory.json --targets targets.json --results query-results.json --output tickets.csv
python -B -m unittest -v test_triage

tickets.csvには脆弱性とOSの組み合わせごとの行が入ります。チケット番号は説明用のDEMO-101、対象IDは実在の脆弱性を示さないdemo-001です。CSVは表計算ソフト向けのUTF-8 BOM付きで出力します。

期待する結果

種類OSバージョン記号架空データでの理由
ASA9.18.4×完全な同条件の結果に対象IDなし
ASA9.16.4○同条件の結果に対象IDあり
IOS15.9(3)M?同条件の照会データなし
Nexus10.4(2)?照会失敗

これらの記号は架空データの照合結果です。実在するOSバージョンの脆弱性判定や、推奨バージョンを示していません。

一箇所変えて、判断の境界を確かめる

  1. query-results.jsonのASA結果をstatus: "failed"に変えると、対象行は×ではなく?になります。
  2. all_pagesをfalseにすると、取得途中として?になります。
  3. 対象IDに似た別の文字列を入れても完全一致しないため、○にはなりません。
  4. 同じOSバージョンでもplatformやmodeが違う結果は流用しません。

再実行には別の出力名を指定してください。既存ファイルは上書きしません。テストはこの照合ルールとCSV出力を確かめるもので、Cisco APIの稼働状況や元の運用の正確性は検証しません。

自分の一覧へ応用する

まず架空の4行で記号と理由を確認します。その後、実データを公開フォルダへ置かず、別の作業場所でOS条件・対象IDを合わせます。API結果を変換する処理では、版の有効性・全ページ取得・エラーの有無を確認してからcompleteを設定してください。元のCSVやAPIのJSONをそのままこのサンプルへ渡すことはできません。

実際のOpenVulnQueryへつなぐ前に

OpenVulnQueryはCisco PSIRT openVuln APIのPythonクライアントです。公式READMEにはASA・IOS・NX-OSを指定するCLIと、JSON/CSV出力、設定ファイルまたは環境変数による認証設定が載っています。OpenVulnQuery公式リポジトリ ↗

  1. 使う版とコマンドを確認する

    隔離したPython環境でインストールし、python -m pip show OpenVulnQueryとopenVulnQuery --helpで版とオプションを記録します。古い記事のコマンドだけで判断せず、実際に使う版のソースも確認します。

  2. 選択した種類をAPIのOS条件へ対応させる

    ASAはasa、IOSはios、Nexusのstandaloneはnxos、ACIはaciに対応させます。機種条件が必要な対象はplatformAliasも確認します。サンプルのmodeは内部の照合キーで、APIパラメータの名前ではありません。

  3. 一つの既知の組み合わせで照会する

    認証情報は公開するコード・記事・コマンド履歴へ書かず、アクセスを制限した設定ファイルや実行環境へ渡します。照会条件と結果を公式アドバイザリでも確認してから、保存済みの一覧へ広げます。

  4. 結果を正規化し、チケット用の表へ渡す

    OS条件、アドバイザリID、確認日時と取得状態を残します。表示用の一覧を作る処理と、外部チケットサービスへ登録する処理を分けると、まず表だけを確認できます。

現在の公式API仕様は/security/advisories/v2/OSType/{OSType}を掲載し、旧OS別エンドポイントには移行案内があります。手元のクライアントの接続先と仕様を照合してください。現行のOS別照会仕様 ↗、旧エンドポイントの扱い ↗

この記事の動作確認はオフラインの照合サンプルまでです。認証して実際のAPIを呼ぶ部分と、利用するクライアント版の互換性は各環境で確認が必要です。

失敗時の確認と、人が判断する範囲

状況確認すること
サンプルを起動できないpython --version、作業フォルダ、5ファイルの配置を確認する。moduleの追加インストールは不要
CSVを出力できない出力先の書き込み権限と同名ファイルの有無を確認する。既存なら別名を指定する
照会結果が?種類・版・機種・モードの完全一致、status、all_pages、version_valid、同条件の重複を確認する
認証・通信に失敗するクライアント設定、接続先、権限、エラーを確認する。失敗を空の正常結果へ置き換えない
APIが200でも期待する一覧がない本文のエラー情報とデータ形式も確認する。公式仕様には200の本文に版不正などの情報を返す形式がある
結果が少ない・空全ページを取得したか、版と検索範囲が有効か、対象IDの対応が正しいかを確認する

HTTPステータスだけで照会成功を決めない点と、ページ分割はCiscoのOS別照会仕様 ↗に基づく確認点です。version_validやall_pagesはAPIがそのまま返す保証フラグではなく、取得側で確認して付けるサンプル独自の項目です。

○の行は公式アドバイザリへ進み、影響を受ける製品・版・有効な機能・機器設定・修正方法を確認します。チケットの完了判断にはその根拠を残します。古い結果を再利用する場合も確認日時が分かるようにし、OS変更やアドバイザリ更新後には改めて照会する運用が必要です。

出典と確認範囲

実体験の記述は、私が行ったASA・IOS・Nexusの選択、二つの保存済み一覧の参照、脆弱性単位のチケットと○×出力を基にしています。実機の情報や実際のチケット内容は公開していません。

外部仕様は2026年10月3日に公式READMEとCisco DevNetの仕様を参照しました。説明用サンプルの結果と、実際のAPIによる判定は区別しています。更新・訂正の扱いは編集方針にまとめています。