この記事で分かること
外部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は指定フォルダ内の、このデモの状態だけを初期化します。自分の実データがある場所には向けないでください。
| イベント | status | checkedAt |
|---|---|---|
| first request | fetched | 1700000000 |
| same conditions | hit | 1700000000 |
| different OS | fetched | 1700000020 |
| after TTL | fetched | 1700003601 |
同じ条件の行だけ、最初の取得日時が変わりません。条件違いと期限切れでは新しい日時になります。例の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モジュール ↗です。候補の有無を実環境の安全判定へ置き換えず、公式アドバイザリの影響条件を確認してください。