この記事で分かること

外部APIの結果を保存して再利用したい方へ。このサイトのCisco一次確認ツールで採用した方法を、条件・期限・成否の三つから整理します。

  • CVE番号だけを、OSへの該当判定のキーにしない理由。
  • 完全な結果だけを保存し、元の確認日時を維持する方法。
  • 条件違いと期限切れを、Pythonのオフライン例で確認する手順。

同じ照会を減らすために、何を保存したか

Cisco製品の一次確認ツールでは、ASA・IOS・Nexusの条件を受け取り、OpenVulnQueryから候補を取得します。同じ条件を利用者が何度も確認する場合、毎回取得すると待ち時間と外部APIの利用回数が増えます。

このサイトでは、完全に取得できた結果を公開ディレクトリ外へ保存し、同じ条件なら6時間以内の結果を再利用する構成にしました。保存結果には、OS条件、候補一覧、確認日時、取得完了の状態を含めます。ブラウザーへ返すときも、確認日時を表示時刻へ置き換えません。

このサイトで確認できたこと

ASA 9.18.4 / ASAVの実照会で44候補を取得し、同じ条件の2回目は保存結果を返しました。再起動後と公開ページからの確認でも、元の取得日時を維持し、新しいAPI取得は増えていません。これは2026年10月4日の、その条件での検証記録です。全版の動作保証ではありません。

CVEではなく、照会条件をそろえる

CVE番号は脆弱性の識別子ですが、今回のOS条件でどの候補が返ったかを表すものではありません。同じ番号の詳細を保存する処理と、機器の条件に対する照会結果を保存する処理を分けます。

キーに含めるもの取り違えを防ぐ例
OSの種類IOSとIOS XE、NexusのstandaloneとACIを同じ条件にしない
OSバージョン記号を省略したり、部分一致で違う版へ流用しない
platform同じ版でも、機種指定ありと指定なしを分ける
conditions = {
    "os": "asa",
    "version": "9.18.4",
    "platform": "ASAV",
}
# この条件の組み合わせが一致する保存結果だけを再利用する

結果を保存した後に、対象CVE一覧との照合やCSV整形を行えば、同じ取得結果を別の見せ方へ使えます。ただし機種や版が変わった入力まで、表示だけを変えて流用してはいけません。照合の考え方はチケット単位の○×表にもつながります。

Ciscoの検索条件はOS別照会の公式仕様 ↗と照合します。API側が版不正を本文に返す場合や途中取得を、完全な空結果として保存しないことも必要です。

再利用できる範囲を、期限と成否で決める

状態扱い
同じ条件・完全な結果・期限内保存結果を返し、元のcheckedAtを表示
条件違い、保存結果なしその条件を新しく取得
期限切れ再取得へ進む。期限切れの空結果で「候補なし」としない
取得途中・認証失敗・通信失敗正常な結果として保存しない
保存情報の破損・保存失敗成功として返さず、修復が必要な状態と区別する

脆弱性情報は後から追加・更新されます。永久に保存して同じ結果を出し続ける方法では、更新を取り込めません。6時間はこのツールで採用した再取得間隔で、あらゆる運用に適した値ではありません。緊急の確認やOS変更後の確認では、いつのどの条件の結果かを確かめます。

保存容量も上限を設け、このサイトでは最大64条件・4MiBにしています。期限切れの整理は起動・参照・保存時に行い、容量超過時は古い結果から除去します。確認日時と、ファイルの最終更新日時を混同しないことも大切です。

条件違いと期限切れを、手元で試す

配布例はPython 3.12系の標準ライブラリだけで動きます。実APIへは接続せず、固定の時刻と架空のOS条件・候補を使います。ファイルを新しい作業フォルダに保存し、状態の保存先を別の専用フォルダに指定します。

python cache_demo.py --mode cache --state-dir demo-cache --reset

この例の期限は1時間です。本番ツールの6時間とは別で、時計を固定値で進めるため実際に1時間待つ必要はありません。--resetは指定フォルダ内の、このデモの状態だけを初期化します。自分の実データがある場所には向けないでください。

イベントstatuscheckedAt
first requestfetched1700000000
same conditionshit1700000000
different OSfetched1700000020
after TTLfetched1700003601

同じ条件の行だけ、最初の取得日時が変わりません。条件違いと期限切れでは新しい日時になります。例のfictional-CVE-0001は説明用文字列で、実在する脆弱性の照合結果ではありません。

固定時計の例なので、同じフォルダで繰り返すときは--resetを指定するか、新しい状態フォルダを使います。サンプルのconditions()とCACHE_TTLを別のコピーで一箇所ずつ変更すると、何が再利用を分けるかを確認できます。

保存先と、同時要求の扱いも決める

結果をディスクへ置くときは、公開HTMLと別の保存領域を用意します。ファイルを直接上書きする途中でプロセスが止まる場合に備え、一時ファイルへ書いてから入れ替えます。説明用Python例はfsyncとos.replaceを使います。Pythonのファイル同期と置換の仕様 ↗

入れ替えだけでは、二つの処理が同時に読み書きする問題は解決しません。配布例は協調するプロセス同士でロックを取り、状態を確認してから保存します。複数サーバーで同じ保存結果を共有する設計や、本番APIへの接続は含みません。

このサイトの本番は一つのアプリプロセスが保存領域を持ち、同じ条件への同時要求は一つの取得を共有します。コンテナの外へ状態を引き継ぐ方法はDockerの永続データの記事で説明しています。

失敗時の確認と出典

保存結果が見つからないときは、種類・版・機種の完全一致と期限を先に確認します。保存ができないときはパス・権限・容量を確認し、壊れたJSONを空の正常結果へ置き換えません。サンプルで時刻のエラーが出た場合は、固定時計を戻して同じ状態を再利用していないか確認します。

2026年10月4日に、このサイトの実装・保存結果再利用・再起動後の復元と、Pythonの説明例を確認しました。元データとAPI仕様の参照先はCisco OS別照会仕様 ↗、保存処理はPython 3.12のosモジュール ↗です。候補の有無を実環境の安全判定へ置き換えず、公式アドバイザリの影響条件を確認してください。