input / output)ごとに Guardian へ割り当てられます。
Starfort の Guard Policy Type Catalog は固定の集合 — PII と TOPIC — です。System Guardian は評価できるサブセットを宣言し、Project Guardian はそのサブセットを継承します。各ポリシーは Policy Name を持ち、これはプロジェクト内で一意です。この名前は Guardian の出力や Opticon のトレースタグで使われる識別子であるため、ポリシーの名前を変更することは履歴を書き換えるのではなく、新たなアイデンティティを開始することを意味します。
PII ポリシー
個人データや機微なデータを検出し、各一致に対する処理を決定します。PII ポリシーは 3 種類のルールで構成されます。
各ルールには、そのアクションを設定する policy_type が付与されます。
MASKING— 一致箇所をマスクワードトークンに置き換えます(例:PHONE_NUMBER→[PHONE_NUMBER_1])。BLOCKING— 一致した場合、リクエスト全体をブロックします。PASSING— 明示的に許可します(例: テストデータを許可リストに登録)。これにより、より広範なルールに捕捉されないようにします。
Starfort に標準で付属する PII ポリシーは、韓国の電話番号、住民登録番号、パスポート/運転免許/通関 ID、銀行口座、カード、メール、車両ナンバープレートを対象としており、加えて一般的なテストパターン向けの
PASSING ルールも含まれています。カスタマイズした PII ポリシーの追加を参照してください。Topic ポリシー
定義されたトピックに照らしてコンテンツを分類し、その分類結果に基づいて処理します。各トピックはsafe と unsafe のコンテンツを定義し、その分類は直接アクションにマッピングされます。
safe→ PASS — そのまま通過します。unsafe→ BLOCK — リクエストが停止されます。
ポリシーが Guardian に渡される仕組み
ポリシーは、ポリシー種別 → Policy Name という 2 階層の構造で Guardian に渡されます。同じタイプの複数のポリシーは名前によって区別されたまま保持されます(そのまま渡され、決してマージされません)。そのため、1 つのinput スロットは、例えば 2 つの異なる PII ポリシーと 1 つの Topic ポリシーを同時に保持でき、それぞれが独立して評価されます。
バージョン管理と割り当て
Guard Policy はセマンティックバージョニングを使用し、Project Guardian は特定のバージョンを **Pin(固定)**します。- ポリシーのルールを編集すると、新しいバージョンが作成されます(例:
v0.1.0→v0.1.1)。 - Project Guardian は、明示的に再 Pin するまで、Pin されたバージョンを使い続けます — 保存 ≠ 適用。新しいバージョンを公開しても、Pin が自動的に変わることはありません。
- 1 つの process type スロットには、複数のポリシーを保持できます(例:
inputに PII ポリシーと Topic ポリシーの両方)。