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の式になります。