セキュリティ

CybOXとは?サイバー攻撃観測記述形式の仕組みとSTIX 2.1への対応表・変換手順

CybOXとは?サイバー攻撃観測記述形式の仕組みとSTIX 2.1への対応表・変換手順

CybOX(Cyber Observable eXpression、サイボックス)は、ファイルのハッシュ値やIPアドレス、プロセスの起動といった「システムやネットワークで観測された、または観測し得る事象や状態」を、機械が読める共通形式で書くための標準です。MITREが中心となって策定し、2016年にSTIXへ統合されました。いまCybOXのデータに出会うのは、古い脅威情報フィードや2016年以前のツールが残っている場面です。この記事では、CybOXの書き方を押さえたうえで、それが現行のSTIX 2.1のどこに引き継がれたか、手元のCybOXデータをどう変換するかを、実際にツールを動かした結果とともに説明します。

まとめ:CybOXの要点と今の扱い

  • CybOXは観測事象を「オブジェクト(ファイル・アドレス・レジストリ等)」と「アクション(作成・接続等)」で書くXMLの言語。最後の版はCybOX 2.1(2014年1月)。
  • 2016年10月にOASIS CTI技術委員会の投票でSTIXへの統合が決まり、名称は「STIX Cyber Observables(SCO)」に変わった。CybOXという名前はSTIX 2.0で使われなくなった。
  • 現行はSTIX 2.1(2021年6月10日にOASIS標準)。CybOXの観測オブジェクトは18種類のSCOとしてJSONで書き、検知条件はSTIX Patterningで書く。
  • 新しく脅威情報の仕組みを作るならSTIX 2.1を使う。CybOXを新規に採用する理由はない。
  • 既存のCybOX/STIX 1.xデータは、OASISのstix2-elevatorでSTIX 2.1へ変換できる。ただし変換は「ベストエフォート」で、DNSクエリやネットワークパケットなど変換先が無い型がある。

CybOXの定義:観測事象を機械可読にする記述言語

CybOXは「Cyber Observable eXpression」の略で、IPAは「サイバー攻撃観測記述形式」と訳しています。ここでいう観測事象(Observable)は、標的型メールの受信、不審な実行ファイルの作成、外部への通信といった、パソコンやサーバーに残る攻撃の痕跡を指します。セキュリティ製品ごとにログの書式が違うと、組織や製品をまたいで「同じ痕跡か」を突き合わせられません。CybOXは痕跡の書き方そのものを揃えることで、この突き合わせをプログラムで処理できるようにしました。

IPAのCybOX概説によると、検討は2009年9月にCAPEC(共通攻撃パターン一覧)の延長として始まり、2011年5月に原型ができ、2012年11月にCybOX V1.0が公開されました。IPAの概説はCybOX 2.1(2014年1月23日公開)を基に書かれており、最終更新は2018年5月31日です。統合後の扱いは載っていないので、STIX 2.1での行き先は後の章で補います。

STIX・TAXIIとの役割分担

CybOXが書くのは「何が観測されたか」です。STIXは、その観測を攻撃者・攻撃手法・キャンペーンといった「誰が、なぜ、どのように」の文脈と結びつけます。TAXIIは、STIXで書いた情報を組織間でやり取りするための通信の取り決めです。STIX 1.xの時代は、STIXの文書の中で観測事象の部分だけをCybOXで書くという入れ子の関係でした。2016年にSTIXへの統合を提案した動議は、その利点として相互運用性・文書管理・STIXの市場での認知の改善を挙げています。

CybOX言語の構造:Object・Event・Actionによる観測事象の記述

CybOXのObservableは、Objectによる状態の記述や、Eventとその中のActionによる動作の記述などで表します。すべての観測にObjectとEventの両方が必要なわけではありません。Objectは種類ごとに型があり、型ごとの属性(Properties)に具体的な値を入れます。

  • Object:IPAの概説によると、CybOX 2.1にはファイル、Windowsレジストリ、電子メール、URI、IPアドレス、ポート番号など約80種類の型がある。
  • Action:開く/閉じる、実行/停止、アップロード/ダウンロードなど約110種類の形態と、ファイル削除・ユーザー追加など約180種類の具体的な動作が定義されている。
  • Properties:ファイル名・ハッシュ値・サイズ・ポート番号など、型ごとに決まった属性。

属性には condition="Equals" のような比較条件を付けられます。条件を付けない属性は「この値が観測された」という事実、条件を付けた属性は「この値に一致したら検知する」というパターンを表します。1つの書式で事実とパターンの両方を書けるのがCybOXの特徴で、STIX 2.xではこの2つが別の仕組みに分かれました。

次は、IPv4アドレスの値が198.51.100.3に一致する条件を書いたCybOX 2.1のXML断片です(STIX 1.2のIndicatorの中に入れた形)。

<indicator:Observable id="example:Observable-1">
  <cybox:Object id="example:Address-1">
    <cybox:Properties xsi:type="AddressObj:AddressObjectType" category="ipv4-addr">
      <AddressObj:Address_Value condition="Equals">198.51.100.3</AddressObj:Address_Value>
    </cybox:Properties>
  </cybox:Object>
</indicator:Observable>

名前空間(cybox:、AddressObj:)と xsi:type で型を指定するため、IPアドレス1つにも4段の入れ子が要ります。CybOX 2.1は型ごとにXMLスキーマが分かれており、ツールはコアのスキーマに加えて、扱う型に対応するスキーマを使用します。

CybOXの策定から統合までの年表

CybOXは単独の標準としては2014年の2.1で止まり、その後はOASISへの移管と統合の流れに入りました。

時期 出来事
2009年9月 MITREがCAPECの延長で検討を開始
2012年11月 CybOX V1.0を公開
2014年1月23日 CybOX 2.1を公開(単独の最終版)
2016年6月20日 OASISがCybOX 2.1.1の公開レビュー草案を発行
2016年9月28日〜10月5日 OASIS CTI TCが「Merge CybOX into STIX」を投票
2017年7月19日 STIX 2.0がCommittee Specification 01に
2021年6月10日 STIX 2.1がOASIS標準に

OASISの投票記録「Merge CybOX into STIX」には、CybOXをSTIXに統合して「STIX Cyber Observables(SCO)」と改称し、CybOXという用語はSTIX 2.0で廃止すると書かれています。STIX 2.0のPart 1は、置き換える仕様としてSTIX 1.2.1とともにCybOX 2.1.1を挙げています。MITREのCybOXのサイトは現在アーカイブで、「The CybOX Language has been integrated into Version 2.0 of Structured Threat Information eXpression」と告知しています。CybOXの「最新版」や「今後の予定」を探しても見つからないのは、このためです。

STIX 2.1でのCybOX:SCO18種とObserved Data

統合後、CybOXのオブジェクトはSTIX 2.1の「STIX Cyber-observable Objects(SCO)」になりました。STIX 2.1の仕様の第6章で定義されているSCOは、artifact、autonomous-system、directory、domain-name、email-addr、email-message、file、ipv4-addr、ipv6-addr、mac-addr、mutex、network-traffic、process、software、url、user-account、windows-registry-key、x509-certificate の18種類です。CybOX 2.1の約80種類から大きく絞られており、残りは拡張(extensions)で補う設計です。

観測した事実は、SCOを observed-data(Observed Data)から object_refs で参照して表します。STIX 2.0ではSCOをObserved Dataの中に入れ子で埋め込んでいましたが、2.1ではSCOが独立したIDを持つオブジェクトになり、入れ子の書き方は非推奨になりました。

CybOX 2.xの型とSCOの対応表

変換ツールstix2-elevatorのCybOX 2.xからSTIX 2.xへの対応表から、よく使う型を抜き出しました。1つのCybOX型が複数のSCOに分かれたり、SCOの拡張(-ext)に入ったりします。

CybOX 2.xの型 STIX 2.xの行き先
Address ipv4-addr / ipv6-addr / mac-addr / email-addr
DomainName / Hostname domain-name
URI url
File file(ディレクトリは directory)
WinExecutableFile file の windows-pebinary-ext
Process process
WinService process の windows-service-ext
WindowsRegistryKey windows-registry-key
NetworkConnection / HTTPSession network-traffic
EmailMessage email-message
Product software
X509Certificate x509-certificate

stix2-elevatorの未対応型とSTIX拡張による補完

同じ対応表には「CybOX 2.1 Object Types Not Representable in STIX 2.x」という一覧があり、DNS Query、DNS Record、Network Packet、Network Flow、Whois、Win Event Log、Win Task、Win Thread、Memory、Linux Packageなど50近い型が並んでいます。これらはSTIX 2.xのカスタムオブジェクトや拡張で書くことになり、elevatorは変換しません。TCPのパケット(TCP → network-traffic の tcp-ext)とNTFSの属性(WinFile)も、変換先はあるものの現行版では未対応と記載されています。

手元のCybOXデータにDNSクエリやイベントログの観測が多いなら、変換すると情報の一部が落ちます。移行前に、データに含まれる型をこの一覧と突き合わせておく必要があります。

決定論的ID:IPv4アドレスのUUIDv5生成

SCOすべてが同じ値から同じIDになるわけではありません。processはUUIDv4を使い、任意のID寄与プロパティがすべて欠ける場合にもUUIDv4が必要です。

STIX 2.1のSCOのIDは、型ごとに決まった「ID Contributing Properties」(ipv4-addrなら value)をJSONにしてRFC 8785で正規化し、名前空間 00abedb4-aa42-466c-9c01-fed23315a9b7 でUUIDv5を計算して作ることが推奨されています。同じIPアドレスを別々の組織が書いても同じIDになるので、受け取った側で重複をまとめられます。CybOXのIDは書き手が自由に付けていたため、この性質はありませんでした。

OASISのPythonライブラリstix2(3.0.2)で、198.51.100.3のIPv4アドレスを作ると次のIDになります。

from stix2 import IPv4Address

ip = IPv4Address(value="198.51.100.3")
print(ip.id)
# ipv4-addr--28bb3599-77cd-5a82-a950-b5bc3caf07c4

注意したいのは、STIX 2.1の仕様書が例に載せている ipv4-addr--ff26c055-6336-5bc5-b98d-13d6226742dd(同じ198.51.100.3)が、この計算結果と一致しないことです。仕様書の例は書式を示すための値なので、IDを手で書き写さず、ライブラリに計算させてください。

CybOXの検知条件からSTIX Patterningへ

CybOXで condition を付けて書いていた検知条件は、STIX 2.0のPart 5で定義されたSTIX Patterningに移りました。パターンはIndicatorの pattern プロパティに文字列で書きます。前章のXMLと同じ条件は、次の1行です。

[ipv4-addr:value = '198.51.100.3']

「観測した事実=Observed Data+SCO」「探す条件=Indicator+パターン」と、CybOXでは1つの書式だったものが2つに分かれた、と覚えておくと読み替えで迷いません。

既存のCybOXデータをSTIX 2.1へ変換する手順

OASISのstix2-elevatorは、CybOXを含むSTIX 1.xのXMLをSTIX 2.0/2.1のJSONに変換するツールです。READMEには「this conversion is best-effort only」とあり、本番環境での利用には注意するよう書かれています。2026年10月29日時点のPyPIの最新版は4.1.7(2022年9月28日公開)で、CybOXのPythonライブラリ(cybox)は2.1.0.21(2020年3月6日)が最後です。OASISのSTIX 1.xと2.xの比較資料は、MITREがSTIX 1/CybOX 2/TAXII 1向けに作ったツールとAPIを「end-of-life」と位置づけ、STIX 2.1への移行を勧めています。

stix2-elevatorの動作環境:setuptoolsとlxml 4.9.4の固定

READMEの動作条件は「Python 3.7+」ですが、実行できるかどうかはPython本体と依存ライブラリの組み合わせで決まります。macOS 26.6.2でuv 0.11.31を使い、stix2-elevator 4.1.7を新しい仮想環境に入れて2026年10月29日に試した結果は次のとおりです。

  • Python 3.12.13の素の仮想環境:起動時に ModuleNotFoundError: No module named 'distutils' で停止。依存するmixboxがdistutilsを読み込むが、Python 3.12で標準ライブラリから削除され、uvの仮想環境にはsetuptoolsも入らないため。
  • setuptools 84.2.1を追加し、lxmlは最新の6.1.3:変換中に module 'lxml.etree' has no attribute '_ElementStringResult' で停止。依存するstixmarxが、lxml 5で削除された内部クラスを参照するため。Python 3.11でも同じエラーになった。
  • setuptools 84.2.1+lxml 4.9.4:変換が完了(Python 3.12.13・3.11の両方)。
uv venv -p 3.12 .venv
uv pip install -p .venv/bin/python "stix2-elevator==4.1.7" "stix2==3.0.2" "lxml==4.9.4" setuptools

pipを使う場合も、setuptoolsが入っているかを確認し、lxmlは4.9.4に固定してください。

STIX 1.2からSTIX 2.1への変換コマンドと出力例

ファイルの観測(ファイル名とSHA-256)をCybOX 2.1で書いた、次のSTIX 1.2パッケージを obs.xml として保存します。IDの末尾をUUIDにしておくと、変換後もそのUUIDが引き継がれます。

<stix:STIX_Package
  xmlns:stix="http://stix.mitre.org/stix-1"
  xmlns:cybox="http://cybox.mitre.org/cybox-2"
  xmlns:FileObj="http://cybox.mitre.org/objects#FileObject-2"
  xmlns:cyboxCommon="http://cybox.mitre.org/common-2"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:example="http://example.com"
  id="example:Package-6f1b1e3a-2b7c-4a55-9b1e-0d7c6a1f2e01" version="1.2" timestamp="2026-10-01T00:00:00Z">
  <stix:Observables cybox_major_version="2" cybox_minor_version="1">
    <cybox:Observable id="example:Observable-2a0f4c1e-8d3b-4f8e-a6f2-5b9d1c7e3a10">
      <cybox:Object id="example:File-7c9e2b4d-1a3f-4e6b-8d2c-9f0a1b3c5e7d">
        <cybox:Properties xsi:type="FileObj:FileObjectType">
          <FileObj:File_Name>ipa.exe</FileObj:File_Name>
          <FileObj:Hashes>
            <cyboxCommon:Hash>
              <cyboxCommon:Type>SHA256</cyboxCommon:Type>
              <cyboxCommon:Simple_Hash_Value>2fa3b8aafa7f52c1342d8993c070f14194871b94b87c772d2fbb6dfbcf67e4c8</cyboxCommon:Simple_Hash_Value>
            </cyboxCommon:Hash>
          </FileObj:Hashes>
        </cybox:Properties>
      </cybox:Object>
    </cybox:Observable>
  </stix:Observables>
</stix:STIX_Package>

変換を実行すると、次の結果になりました。

.venv/bin/stix2_elevator obs.xml > out.json
{
    "id": "bundle--6f1b1e3a-2b7c-4a55-9b1e-0d7c6a1f2e01",
    "objects": [
        {
            "hashes": {
                "SHA-256": "2fa3b8aafa7f52c1342d8993c070f14194871b94b87c772d2fbb6dfbcf67e4c8"
            },
            "id": "file--ae250a9e-ccd0-5f64-b8a7-5d442db15009",
            "name": "ipa.exe",
            "type": "file"
        },
        {
            "first_observed": "2026-10-01T00:00:00.000Z",
            "id": "observed-data--2a0f4c1e-8d3b-4f8e-a6f2-5b9d1c7e3a10",
            "last_observed": "2026-10-01T00:00:00.000Z",
            "number_observed": 1,
            "object_refs": [
                "file--ae250a9e-ccd0-5f64-b8a7-5d442db15009"
            ],
            "spec_version": "2.1",
            "type": "observed-data"
        }
    ],
    "type": "bundle"
}

(out.jsonの先頭に出る告知の1行と、created・modified は省略)CybOXのFileオブジェクトはSCOの file に、Observableは observed-data になり、object_refs でつながっています。file のIDは、stix2で同じファイル名とハッシュから作ったIDと一致しました。一方、前章のIndicatorに入れたIPアドレスの条件は observed-data にならず、Indicatorの "pattern": "[ipv4-addr:value = '198.51.100.3']" に変換されました。

変換結果の検証:標準出力・ID・複合条件・未対応型

  • 標準出力の1行目:CLIは「Results produced by the stix2-elevator are not for production purposes.」を標準出力に書くため、> でファイルに落とすとJSONの前にこの1行が入る。読み込む前に警告行を除くか、Pythonから elevate() を呼び、その戻り値のJSON文字列だけをファイルに保存する。
  • IDの書式:example:Indicator-1 のように末尾がUUIDでないIDは「Malformed id」の警告とともに新しいUUIDに置き換わる。元のIDで他システムと突き合わせているなら、対応表を残す。
  • 複合条件:READMEは、STIX 1.xやCybOX 2.xの複合条件は解釈が曖昧になりやすく、変換後のパターンが意図どおりか確かめるよう求めている。
  • 変換されない型:前章の「STIX 2.xで表せない型」に当たる観測は出力に現れない。入力の型・属性・参照関係を出力と照合し、変換警告も確認する。分割や統合で件数が変わるため、総件数の一致だけでは情報の保持を判定しない。

変換したSTIX 2.1は、TAXII 2.1のサーバーで配信したり、SOCのSIEMや脅威インテリジェンス基盤に取り込んだりできます。ハッシュ値の観測を検体の判定につなぐなら、VirusTotal APIでの検体判定の自動化も参考になります。

CybOXの扱いの判断:新規実装と既存資産

新しく脅威情報の記述や共有の仕組みを作るなら、CybOXを選ぶ理由はありません。CybOXを読み書きするPythonライブラリの最終リリースは2020年3月で、MITREのツール群はend-of-lifeとされ、変換ツールも依存ライブラリの版を固定しないと動きません。STIX 2.1のSCOとPatterningで書き、TAXII 2.1でやり取りするのが現行の組み合わせです。

CybOXを扱う必要があるのは、2016年以前に作った脅威情報の蓄積や、STIX 1.xのフィードしか出さない古い連携先が残っている場合です。その場合も、CybOXのまま運用を続けるより、受け取った時点でstix2-elevatorでSTIX 2.1に変換し、元のXML全体を保存したうえで、変換結果を検索や突き合わせに用いる運用を推奨します。対応型でも失われる属性があるため、未対応型だけの保管では原情報を保持できません。社内の脅威情報基盤やEDRとの連携を見直すときは、脆弱性診断・セキュリティ診断とあわせて、データの形式がどの版で止まっているかを棚卸ししておくと、移行の範囲を見積もれます。

よくある質問

CybOXは何の略ですか?読み方は?

Cyber Observable eXpression の略で、読みは「サイボックス」、IPAの訳語は「サイバー攻撃観測記述形式」です。同じ綴りの「CyBox」には大学のオンラインストレージや鉄道向けWi-Fi機器などセキュリティと無関係の名前もあるため、検索結果では文脈を確かめてください。

CybOXは今でも使われていますか?

単独仕様としての開発は終了していますが、既存データや連携先では使われる場合があります。2016年にSTIXへの統合が決まり、観測オブジェクトはSTIX 2.1の「STIX Cyber-observable Objects(SCO)」として引き継がれています。CybOXの形式が残っているのは、古いSTIX 1.xのデータやツールです。

CybOXとSTIXの違いは何ですか?

CybOXは「何が観測されたか」を、STIXは観測を攻撃者や攻撃手法と結びつけた「脅威の文脈」を書く標準でした。STIX 1.xはCybOXを部品として使い、STIX 2.0以降はCybOXの部分をSCOとして仕様の中に取り込んでいます。

CybOXはXMLですか、JSONですか?

CybOX 1.x/2.xはXMLです。後継のSTIX 2.0/2.1のSCOはJSONで書きます。XMLのCybOXをJSONのSTIX 2.1に変えるには、OASISのstix2-elevatorを使います。

CybOXのObservableはSTIX 2.1では何になりますか?

観測した事実は、SCO(fileやipv4-addrなど)と、それを参照する observed-data になります。検知条件として書いたObservableは、Indicatorの pattern に入るSTIX Patterningの式になります。

関連記事

お気に入りに入れた記事の一覧

一創の公式 SNS

X では毎朝の新着記事と IT ニュースの速報を、YouTube・TikTok・Instagram・LinkedIn・Facebook では記事の解説動画を配信しています。

この記事は以下の記事からリンクされています

資料請求

今日のトレンド記事 直近 24 時間で、いつもより多く読まれている記事

  1. 2026.11.18 テックブログ Java脆弱性CVE-2026-114938(Java4Shell)とは?影響版・修正版と回避フラグの実装手順
  2. 2026.11.11 テックブログ Vite 脆弱性 GHSA-p4f5-76q4-ffq7:開発サーバーRCEの確認と修正版への更新
  3. 2026.11.18 テックブログ 楽天証券の不正アクセス:最大約447万口座の対象確認と、テスト環境に本番データを置かない実装
  4. 2026.11.17 テックブログ チャットプラスの不正アクセス:導入企業がチャット履歴の個人データと報告準備を確かめる手順
  5. 2026.11.19 テックブログ 大崎電気のランサムウェア被害|スマートメーター生産停止の経緯と工場の生産系を守る手順

RELATED POSTS 関連記事

目次