この記事で分かること
ネットワーク機器の脆弱性確認を担当する方へ。私がOpenVulnQueryで行った一次確認の自動化を、入力・照合・チケットの三段階で紹介します。
- ASA・IOS・Nexusを選び、保存済みのOS一覧を使う流れ。
- 脆弱性ごとのチケットに、OSの該当・非該当を○×で並べる考え方。
- 取得失敗を非該当と混同しない、説明用サンプルの試し方。
実際に自動化した作業
私が作ったのは、ASA・IOS・Nexusを選択式にし、別に保存していたOSバージョンの一覧と対象の脆弱性一覧を参照する仕組みです。OpenVulnQueryを使った一次確認の結果を、脆弱性ごとのチケットにまとめ、OSバージョンの該当・非該当を○×で出しました。
記事で紹介したいのは、APIから情報を取る部分と、確認する単位をそろえてチケットへ渡す部分です。対象の脆弱性と対象OSの組み合わせが見えると、どこを詳しく確認するかを整理できます。
一つのOS条件から候補を確認する入口として、Cisco製品の一次確認ページも用意しています。実APIの利用状態はページ内に表示し、架空データで画面操作を試すこともできます。
保存済み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バージョン | 記号 | 架空データでの理由 |
|---|---|---|---|
| ASA | 9.18.4 | × | 完全な同条件の結果に対象IDなし |
| ASA | 9.16.4 | ○ | 同条件の結果に対象IDあり |
| IOS | 15.9(3)M | ? | 同条件の照会データなし |
| Nexus | 10.4(2) | ? | 照会失敗 |
これらの記号は架空データの照合結果です。実在するOSバージョンの脆弱性判定や、推奨バージョンを示していません。
一箇所変えて、判断の境界を確かめる
query-results.jsonのASA結果をstatus: "failed"に変えると、対象行は×ではなく?になります。all_pagesをfalseにすると、取得途中として?になります。- 対象IDに似た別の文字列を入れても完全一致しないため、○にはなりません。
- 同じ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公式リポジトリ ↗
- 使う版とコマンドを確認する
隔離したPython環境でインストールし、
python -m pip show OpenVulnQueryとopenVulnQuery --helpで版とオプションを記録します。古い記事のコマンドだけで判断せず、実際に使う版のソースも確認します。 - 選択した種類をAPIのOS条件へ対応させる
ASAは
asa、IOSはios、Nexusのstandaloneはnxos、ACIはaciに対応させます。機種条件が必要な対象はplatformAliasも確認します。サンプルのmodeは内部の照合キーで、APIパラメータの名前ではありません。 - 一つの既知の組み合わせで照会する
認証情報は公開するコード・記事・コマンド履歴へ書かず、アクセスを制限した設定ファイルや実行環境へ渡します。照会条件と結果を公式アドバイザリでも確認してから、保存済みの一覧へ広げます。
- 結果を正規化し、チケット用の表へ渡す
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による判定は区別しています。更新・訂正の扱いは編集方針にまとめています。