---
title: "JASCON をはじめる"
description: "国家カタログをブラウザで開き、リファレンスバリデータを実行し、最初の要求事項を書き、OSCAL をインポートし、リスクカバレッジを算出し、コーディングエージェント用のスキルをインストールします。どの手順も数分で終わります。"
lang: ja
url: https://jascon.net/ja/start.html
---

はじめに

# ブラウザのタブから、検証済みのバンドルまで

多くの人がたどる順に、7 つの手順を示します。最初の手順に必要なのはブラウザです。2 番目の手順には Python か Windows マシンが必要です。どの手順にも、アカウント、サーバー、ライセンスキーは不要です。

## なじみのあるカタログを開く

アプリはリンクからバンドルを読み込み、ブラウザ内に保持します。普段使っているフレームワークから始めてください。オブジェクトブラウザはデータからフィルターを構築するため、SP 800-53 ではファミリーとベースライン、Grundschutz++ では法助動詞、保護目標、対象オブジェクトがフィルターとして提示されます。

| コーパス | オブジェクト数 | 型 | コンテンツのライセンス |  |
|---|---|---|---|---|
| AU.ISMInformation Security ManualAustralian Signals Directorate | 1,731 | 1,150 Requirement · 581 RequirementSet管理策 1,150 件。機密区分と Essential Eight のベースラインを Set として表現 | [CC BY 4.0](https://jascon.net/converted_examples/AU.ISM/SOURCE-LICENSE.md) | [アプリで開く](https://jascon.net/app/index.html#load=../converted_examples/AU.ISM/ism-core-bundle/&tool=browse) |
| DE.BSIGrundschutz++ AnwenderkatalogBSI（ドイツ） | 1,289 | 1,000 Requirement · 289 RequirementSetドイツ語の本文。ステートメント文法と保護目標はファセットとして表現 | [CC BY-SA 4.0](https://jascon.net/converted_examples/DE.BSI/SOURCE-LICENSE.md) | [アプリで開く](https://jascon.net/app/index.html#load=../converted_examples/DE.BSI/bsi-core-bundle/&tool=browse) |
| US.CSFCybersecurity Framework 2.0NIST | 226 | 185 Requirement · 41 RequirementSet機能、カテゴリー、サブカテゴリーを入れ子の Set として表現 | [CC0 1.0](https://jascon.net/converted_examples/US.CSF/SOURCE-LICENSE.md) | [アプリで開く](https://jascon.net/app/index.html#load=../converted_examples/US.CSF/csf-core-bundle/&tool=browse) |
| US.IFA-GoodReadOSCAL のサンプルシステム（SSP、評価計画、評価結果、POA&M）NIST（架空のコンテンツ） | 16 | 6 Component · 3 Implementation · 2 Finding · 2 Requirement · 2 Risk · 1 Assessmentライフサイクルの型：Component から Attestation まで。2 件の Risk を含む | [CC0 1.0](https://jascon.net/converted_examples/US.IFA-GoodRead/SOURCE-LICENSE.md) | [アプリで開く](https://jascon.net/app/index.html#load=../converted_examples/US.IFA-GoodRead/ifa-core-bundle/&tool=assess) |
| US.SP800-53SP 800-53 Rev 5.2.0 と 800-53B のベースラインNIST | 1,221 | 1,196 Requirement · 25 RequirementSetステートメント単位のパラメータ。4 つのベースラインを所属関係の Set として表現 | [CC0 1.0](https://jascon.net/converted_examples/US.SP800-53/SOURCE-LICENSE.md) | [アプリで開く](https://jascon.net/app/index.html#load=../converted_examples/US.SP800-53/sp800-53-core-bundle/&tool=browse) |

ハンドブックのサンプルバンドルには、すべての型のオブジェクトが含まれており、その中には Risk 1 つ、Tailoring 2 つ、Check 2 つもあります：[サンプルバンドルを開く](https://jascon.net/app/index.html#load=../jascon/examples/&tool=browse)。フォルダーを伴わない[単一ファイルのリーダー](https://jascon.net/reader/index.html)もあります。ダウンロードして、バンドルのフォルダーをその上にドロップしてください。

## リファレンスバリデータを実行する

バリデータは 822 件の適合性テストベクトルを実行し、続いて同梱バンドルのすべてのオブジェクトを両方のダイジェストで再検証します。最終行には `ALL GREEN` と表示されるか、失敗が 1 件ずつ、そのルールと理由とともに列挙されます。

独自のコンテンツを検証するには、1 つ以上のバンドルフォルダーを引数に渡します。`--require-risk-basis` を指定すると、正当化するリスクのない選択済みの要求事項が失敗として扱われます。

Windows では、PowerShell 版の姉妹実装が、何もインストールせずに PowerShell 5.1 上で同じ処理を行います。Python なら数秒で終わる処理に、数分かかります。

*Python（uv を使用）*

```sh
git clone https://github.com/christoph-puppe/JASCON.git
cd JASCON
uv run --no-project --with jsonschema python jascon/scripts/validate_core.py
```

*Python（pip を使用）*

```sh
pip install jsonschema
python jascon/scripts/validate_core.py
# your own bundle:
python jascon/scripts/validate_core.py path/to/your-bundle
```

*Windows PowerShell 5.1（インストール不要）*

```sh
powershell -ExecutionPolicy Bypass -File jascon\scripts\validate_core.ps1
```

## 最初の要求事項を書く

自分が管理するドメイン配下のプレフィックスを選び、それを使い続けてください。識別子は文字列として比較され、取得されることはないため、そのアドレスで何かを配信する必要はありません。

拘束力、義務を負う当事者、またはパラメータが変わる箇所で、テキストをステートメントに分割します。各パラメータを型付きで宣言し、本文中では `{param:name}` で参照します。

アプリの Browse ページには、そのためのフォームが「Write requirements and sets」の下にあります。このフォームは、本文中に見つけたパラメータを宣言します。Home ページは、作業中のセットを、マニフェストとオブジェクトごとの両ダイジェストを備えたバンドルとしてエクスポートします。

[ハンドブック第 4 章：要求事項の書き方](https://github.com/christoph-puppe/JASCON/blob/main/jascon/references/ch04-writing-requirements.md)

*req-backup-1.json — 架空の例*

```json
{
  "id": "https://grc.your.example/req/BACKUP-1",
  "version": "2026-11",
  "label": "BACKUP-1",
  "lifecycle": "active",
  "statements": [
    { "id": "s1",
      "modality": "must",
      "obligated-parties": ["https://grc.your.example/party/operations"],
      "parameters": [
        { "name": "restore-interval", "type": "duration" }
      ],
      "prose": {
        "en": "A restore from backup is tested at least every {param:restore-interval}.",
        "de": "Eine Wiederherstellung aus dem Backup wird mindestens alle {param:restore-interval} getestet."
      } }
  ]
}
```

## OSCAL を持ち込み、また取り出す

アプリの Import ページは、OSCAL のカタログまたはプロファイルを読み込み、適用したすべてのルールを報告します。ルールセットは Grundschutz++、SP 800-53、CIS Benchmarks 向けに用意されています。それ以外の形のカタログには汎用ルールが適用されます。汎用ルールは、カーネルに対応するフィールドがないものを利用者の名前空間のファセットに保持し、レポートに記載せずに何かを捨てることはありません。バッチ処理用には、実測した各コーパスに 1 つずつ、共通ライブラリ上に構築された 11 個の Python 製コンバーターがリポジトリにあります。

逆方向には、`export_oscal.py` が OSCAL 1.2.2 のカタログを書き出します。同梱バンドルのエクスポート結果は、各バンドルの隣の `converted_examples/*/oscal-export/` にあります。OSCAL に対応する構成要素がないもの（モダリティ、義務を負う当事者、重複する所属関係）は、名前空間付きの props に載せて運ばれ、インポート時に元に戻ります。

[Import ページを開く](https://jascon.net/app/index.html#import)

## リスクを追加し、カバレッジを算出する

カタログを読み込み、Tailoring でベースラインを選択し、その選択を正当化するリスクを Risk ページで書きます。Coverage ビューには、評価済みのどのリスクにも挙げられていない選択済みの要求事項が、すべて一覧表示されます。

最初の洗い出しには、試作版のリスクカタログ 2 つが役立ちます。オフィス IT の典型的なリスク 24 件と、産業プラントのリスク 23 件で、英語とドイツ語で書かれ、それぞれに推奨される SP 800-53 の管理策が付いています。インポートすると、項目が利用者自身の Risk にコピーされます。判断は利用者に委ねられたままです。

[リスクカタログとその限界](https://github.com/christoph-puppe/JASCON/blob/main/risk-catalogs/README.md)

*カタログをバンドルにインポートする*

```sh
python3 risk-catalogs/tools/risk_catalog.py import risk-catalogs/office-it \
    --bundle path/to/your-bundle \
    --org https://grc.your.example \
    --owner https://grc.your.example/party/ciso \
    --out path/to/risks
```

## 機械によるチェックを書く

技術的なルールについては、アプリの Checks ページで Check（カーネル 2.0.0、リリース候補）を書けます。コレクターが報告するファクト、判定を下す比較、そして bash、sh、Python、PowerShell、Ansible、または HTTP リクエストとしてのコレクターコードです。キーを入力すれば、言語モデルにチェックを下書きさせることもできます。下書きは 1 ルールずつでも、CIS からインポートしたすべての自動化ルールに対してでも可能です。各下書きはカーネルのルールと読み取り専用の lint で判定され、何を保存するかは利用者が決めます。アプリはコレクターを実行しません。

[例を読み込んで Checks ページを開く](https://jascon.net/app/index.html#load=../jascon/examples/&tool=checks) [チェックが判定を下す仕組み](https://jascon.net/ja/checks.html)

## ベンダーの助言を取り込む

アドバイスパックは、ベンダーが公開するファイルです。特定の要求事項に対する推奨事項を持つ Component からなります（カーネル 2.0.0、リリース候補）。アプリの Home ページは、何かが書き込まれる前にパックの内容を表示し、発行元が「申告のみ」「証明付き」「実証済み」のどれであるかを示し、インポート後には受領記録を出力します。Implement ページでは、製品を自分のシステムのメンバーにし、推奨事項を自分のエッジとして採用します。同じファイルを 2 回目にインポートしても、何も書き込まれません。

作例のパックは架空のもので、公開テスト鍵で署名されています。パックを公開したベンダーはまだありません。

[アプリで作例のパックをプレビューする](https://jascon.net/app/index.html#load=../jascon/example-packs/dbvendor-server-7-advice/) [パックの仕組み](https://jascon.net/ja/model.html#advice)

### ベンダー向け：パックを作成する

パックビルダーは、オフラインで動作する 1 つの HTML ファイルです。製品と各推奨事項をフォームに記述すると、ページは顧客側のインポートと同じルールでパックをチェックし、リリースに自社の Ed25519 鍵で署名するか、openssl や自社の署名サービス用にバイト列を準備して、ZIP を書き出します。カタログを読み込んでおけば、各要求事項の条項とパラメータを選択肢として示し、すべての推奨値をチェックします。既にお持ちの OSCAL コンポーネント定義は下書きとしてインポートされ、配置できなかったものがレポートされます。

[パックビルダーを開く](https://jascon.net/pack-builder/index.html) [1 つのファイルとしてダウンロードする](https://jascon.net/pack-builder/index.html)

## コーディングエージェントと作業する

フォルダー `jascon/` は Claude 用のスキルです。番号付きの 14 項目の要求事項としてまとめたハンドブック、カーネルスキーマ、適合性テストベクトル、コンバーター、作例のバンドルが含まれます。これを持つエージェントは、スキーマに沿ってオブジェクトを書き、自分の出力に対してバリデータを実行します。

役割分担はアプリと同じです。モデルが下書きし、カーネルのルールが判定し、人が承認します。

*スキルをインストールする*

```sh
# for your user
cp -r jascon ~/.claude/skills/jascon
# or for one project
cp -r jascon .claude/skills/jascon
```

読み進め方

## まず第 2 章、その後は立場別に

ハンドブックは 15 章と 7 つの付録からなります。第 2 章は全員が読みます。所要時間は 1 時間です。その後は、立場によって道が分かれます。

[第 3〜8 章、次に第 14 章 フレームワークを公開する 識別子と名前空間、ステートメント、Set とベースライン、テーラリング、ファセット、マッピング。カタログが実際のものになったら、移行プレイブックへ進みます。](https://github.com/christoph-puppe/JASCON/blob/main/jascon/references/ch03-identity-versions-lifecycle.md) [第 3、12、13、11 章 ツールを開発する メンタルモデルをつかむために識別子の章、次にバリデータの章と安全な取り込みの章。署名に関わる作業の前に、完全性の章を読みます。](https://github.com/christoph-puppe/JASCON/blob/main/jascon/references/ch12-building-a-validator.md) [第 9、10、11、15 章 運用、評価、または調達する システムと継承、評価と逸脱、署名が証明するもの、そして適合性の主張があれば何を要求できるか。](https://github.com/christoph-puppe/JASCON/blob/main/jascon/references/ch09-systems-components-inheritance.md)

リファレンス：[オブジェクトの構造（フィールドごと）](https://github.com/christoph-puppe/JASCON/blob/main/jascon/references/appendix-a-shapes.md) · [カーネルスキーマ](https://github.com/christoph-puppe/JASCON/blob/main/jascon/schemas/jascon-2.0.0.schema.json) · [異論と回答](https://github.com/christoph-puppe/JASCON/blob/main/jascon/references/appendix-f-objections.md) · [用語集](https://github.com/christoph-puppe/JASCON/blob/main/jascon/references/appendix-g-glossary.md)
