---
title: "CybOXとは？サイバー攻撃観測記述形式の仕組みとSTIX 2.1への対応表・変換手順"
url: "https://www.issoh.co.jp/tech/details/5121/"
published: 2025-01-30
updated: 2026-10-29
categories: ["セキュリティ"]
publisher: "株式会社一創"
---

# 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概説](https://www.ipa.go.jp/security/vuln/scap/cybox.html)によると、検討は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](/tech/details/5127/)は、その観測を攻撃者・攻撃手法・キャンペーンといった「誰が、なぜ、どのように」の文脈と結びつけます。[TAXII](/tech/details/5145/)は、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」](https://www.oasis-open.org/committees/ballot.php?id=2989)には、CybOXをSTIXに統合して「STIX Cyber Observables（SCO）」と改称し、CybOXという用語はSTIX 2.0で廃止すると書かれています。[STIX 2.0のPart 1](https://docs.oasis-open.org/cti/stix/v2.0/stix-v2.0-part1-stix-core.html)は、置き換える仕様としてSTIX 1.2.1とともにCybOX 2.1.1を挙げています。MITREの[CybOXのサイト](https://cyboxproject.github.io/)は現在アーカイブで、「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の仕様](https://docs.oasis-open.org/cti/stix/v2.1/os/stix-v2.1-os.html)の第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への対応表](https://stix2-elevator.readthedocs.io/en/latest/cyber-observables.html)から、よく使う型を抜き出しました。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](https://github.com/oasis-open/cti-stix-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の比較資料](https://oasis-open.github.io/cti-documentation/stix/compare.html)は、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](/tech/details/13310/)のSIEMや脅威インテリジェンス基盤に取り込んだりできます。ハッシュ値の観測を検体の判定につなぐなら、[VirusTotal APIでの検体判定の自動化](/tech/details/17462/)も参考になります。

## 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](/tech/details/13303/)との連携を見直すときは、[脆弱性診断・セキュリティ診断](/service/system/vulnerability/)とあわせて、データの形式がどの版で止まっているかを棚卸ししておくと、移行の範囲を見積もれます。

## よくある質問

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

## 関連記事

- [STIXとは？脅威インテリジェンス標準をSTIX 2.1・TAXII連携まで実装視点で解説【2026年時点】](/tech/details/5127/)
- [TAXIIとは？TAXII 2.1の仕組みとSTIX連携・実装判断【2026年時点】](/tech/details/5145/)
- [SOCとは？SIEM・SOARとの違いと監視運用の仕組み・内製とアウトソースの判断を実装者向けに解説【2026年時点】](/tech/details/13310/)
- [EDRとは？EPP・XDRとの違いと検知の仕組み・導入判断を実装者向けに解説【2026年時点】](/tech/details/13303/)

---

出典: [CybOXとは？サイバー攻撃観測記述形式の仕組みとSTIX 2.1への対応表・変換手順](<https://www.issoh.co.jp/tech/details/5121/>)（株式会社一創）
