CSO等級

機能詳細

警告

資料アクセスに一部制限があることをお知らせします。
CSO等級機能に関する詳細は次ここで確認できます。

マウス右クリックでランク指定

1.概要

ユーザーは右クリックメニューを通じて文書にランクを指定できます。

2. 機能設定 (必須およびオプション)

以下の項目の中で必須項目は必ず設定しなければ機能が動作します。

1. DS_MIP_INIT ポリシーに管理センタードメイン追加 (必須)

カスタムポリシー DS_MIP_INIT ポリシーの json データに以下の Security365 管理センタードメインを追加する必要があります。 (セキュリティグレードおよびラベル情報を取得するため)

\{
    ...
    "s365_portal_url":"https://devspsvr.softcamp.co.kr"     // 주의) 해당 주소값은 예시이며, 사이트에 적용시 알맞은 public 도메인으로 변경 필요함.
    ...
\}

2. 右クリックメニューの追加 (必須)

カスタムポリシー DS_MIP_SHELL_MENU にグレード指定メニューを追加**(リンク)**

\{
    ...
    \{
        "titleRes": "SHELL_MODIFY_SECULABEL",           // メニュー名
        "titleDesc": "UI_DRM_TO_AIP_DESC",
        "targetCmd": 254,                               // 該当値固定値なので必ず254にする必要があります
        "targetIcon": "ApplySecuLabel.bmp",             // メニューアイコンリソース
        "targetExt": "doc|xls|docx|pptx|xlsx|xlsb",
        "targetType": "*"
    \}
    ...
\}

関連リソース
- C:\Windows\Softcamp\SDK\Res\DS\ResUIKOR.rc私のSHELL_MODIFY_SECULABEL = 等級指定定義追加

3. 基本選択グレード設定 (オプション)

等級指定UIでデフォルト選択等級を設定するには、ztcapコンソールで実行ポリシーに指定等級選択の基本等級として設定する必要があります。

執行ポリシーのバックデータには、以下のような基本グレード指定データが追加されます。

{
    //...
    "category": "availableSecurityLevelList",
    "info": {
      //...
      "defaultSelectLevelId": "iqCCmC4N-ADUvGusn-4Gkhlyi6-vPJQvg6r"     // 기본지정 등급 아이디
      //...
    }
}

該当するポリシーがない場合は、最初のグレードレベルのラベルが選択されます。

3. 関連 Security365 サービス(必須)

警告

ランク指定機能が動作するためには、必ず管理センター(spsvr)サービスにセキュリティランク＆ラベル情報が登録されている必要があり、またどのランク同士が指定および変更可能かに関するポリシーが条件付きポリシーに登録されている必要があります。

A. 管理センター - セキュリティグレード＆ラベル登録

B. 条件付きポリシー ( ztcap ) : 変換可能なセキュリティラベルに関するポリシー

- ztcap ポリシーは、現在の文書がどのセキュリティグレード（ラベル）に変更可能かについてのポリシーを構成する必要があります。 ( [開発バックグラウンドデータ関連](https://wiki.softcamp.co.kr/pages/viewpage.action?pageId=162349616) )
    - [条件付きポリシー - エンドポイントメニューガイド](https://idocs.softcamp.co.kr/shieldrm/Guide/Webconsoleguide/Policy_Management/Endpoint)

オーバーレイアイコンの適用

1. 概要

DS 6.0 ENT 文書グレード(C/S/O)として指定された文書に対してオーバーレイアイコン識別機能を提供
適用可能な色:Red 🔴, Green 🟢, Yellow 🟡

2. 制約事項

ウィンドウにインストールされたプログラムのオーバーレイアイコンが多数（12個以上）ある場合、既存のオーバーレイアイコンが表示されないことがあります。
機能開発以前モジュールが適用されたクライアント環境で文書等級アイコンが適用された文書が編集/保存時に識別情報が削除されます。削除される情報はpre headerに保存されるメタデータであり、等級情報データは文書内に保存されているため、ファイル閲覧/保存時に等級アイコンが再び適用されます。
文書グレードアイコンが適用された文書が Teams、SharePoint ライブラリにアップロードされた後、ダウンロードされる場合、サイトポリシーに従ってアイコン識別情報が削除されることがあります。

文書プロパティウィンドウのセキュリティレベル表示

1. 概要

Windows エクスプローラーでファイルを右クリックして**[属性]を開くと、既存のタブの隣に「セキュリティグレード」タブこの新しいものが表示されます。このタブでは、ユーザーはその文書に適用されたC/S/O セキュリティグレード**(C/S/O = 文書を機密・敏感・公開などに分類するDocument Securityの文書セキュリティ等級システム)読み取り専用で直接確認できます。一般文書・自社DRM（Digital Rights Management、自社文書暗号化）文書・MIP（Microsoft Information Protection、マイクロソフト情報保護）文書どのタイプでも同様に動作します。

この機能が必要な理由

現在まで文書に適用されたC/S/Oセキュリティ等級はエクスプローラーアイコンの上に重ねて表示される小さなオーバーレイアイコンによってのみ確認することができました。オーバーレイアイコンは同時に表示される数に制限があり、小さいため、特定の文書のグレードを確実に検証することが難しかったです。また、既存の「セキュリティ文書情報」タブ（MIP文書用）はMIPラベル・権限情報のみを表示し、C/S/Oセキュリティグレードは扱っていませんでした。

この機能はユーザーがオーバーレイアイコンに依存せず、プロパティウィンドウで直接グレードを確認できるように、すべての文書タイプに共通して適用されるセキュリティグレード表示タブを提供します。

動作方式

文書に隠された保存されたセキュリティグレード情報を読み取る属性タブに4つの項目（グレードID・グレード名・ラベルID・ラベル名）で表示します。保護された文書はグレードを読み取るために内部的に復号化が必要なので、属性ウィンドウが停止しないようにバックグラウンドで照会し、「照会中」進行状況表示後、結果で更新します。

また文書セキュリティにログインしていない状態（ログアウト）では「セキュリティレベル」タブは表示されず、(オンラインログイン状態でのみ表示)等級が指定されていない文書は照会失敗と区別される別途案内文言("セキュリティレベルが指定されていない文書")と表示します。

備考

要約: エクスプローラーでファイルを右クリック → [プロパティ] →「セキュリティグレード」タブを開くと、その文書の C/S/O セキュリティ等級（等級 ID・等級名・ラベル ID・ラベル名）が読み取り専用で表示されます。一般・DRM・MIP すべての文書タイプで動作します。

適用範囲 / 入口点

#	エントリーポイント	ユーザーアクション
1	エクスプローラーのファイルプロパティウィンドウ	Windows エクスプローラーでファイルを右クリック → [プロパティ] → 「セキュリティレベル」タブを選択

警告

この機能はDocument Security がサポートする拡張子の文書(オフィス・PDFなど)にのみ「セキュリティ等級」タブが表示されます。サポートされていないファイル（例：画像・テキスト）ではタブは表示されません。

2. 表示されるセキュリティグレード情報

「セキュリティレベル」タブを開くと、文書に適用されたセキュリティレベル情報を次の4つの項目で表示します。

項目	意味
セキュリティ等級ID	文書に適用されたセキュリティグレードの識別番号
セキュリティ等級名	セキュリティレベルの名前
ラベル ID	文書に適用されたラベルの識別番号
ラベル名	ラベルの名前

表示されるグレード名・ラベル名は文書に保存された名前をそのまま表示します（別途正規化・置換なし）。保護文書は等級情報を読み取るのに時間がかかる場合があるため、タブに「照会中」をまず表示した後、結果で更新します（属性ウィンドウは停止しません）。

3. ユーザー画面

「セキュリティグレード」タブの画面構成は次のとおりです（上部ロゴ + 進行表示 + 4行情報）。

┌─ ファイル属性 ──────────────────────────────────┐
│ [一般] [セキュリティ文書情報] [セキュリティグレード]            │
│ ┌──────────────────────────────────────────┐ │
│ │  (Document Security ロゴ)                 │ │
│ ├─ セキュリティグレード情報 ─────────────────────────┤ │
│ │  セキュリティグレードID    : 2                      │ │
│ │  セキュリティグレード名      : 社内版                 │ │
│ │  ラベルID         : 10                     │ │
│ │  ラベル名          : General                │ │
│ └──────────────────────────────────────────┘ │
└──────────────────────────────────────────────┘

조회が終わる前には "조회 중" 文句と進行バーが表示され、照会が終わるとその場所に4行の情報が埋め込まれます（属性ウィンドウへの進入は止まりません）。
等級が指定されていない文書は**"セキュリティレベルが指定されていない文書"文言が表示され、その他のランクを読み取れない場合（復号権限なし・エージェント未起動など）には"照会不可"**文言が表示されます。
このタブは読み取り専用です — グレードを変更したり指定したりする動線はありません。

4. 多言語サポート

タブタイトル・項目ラベル・"照会中"・"照会不可"などの画面文言は6つの言語で提供されます。

区分	内容
サポートされている言語	韓国語 / 英語 / 日本語 / 中国語 / ドイツ語 / ロシア語
リソース	`ResUIKOR/ENG/JPN/CHN/DEU/RUS.rc`の`[DS365Prop]`セクション C/S/O 文言キー 9種（グレード未指定文言を含む）
表示言語の決定	システムロケールに対応するリソース文言が表示されます
基本値(fallback) = 英語	文言リソースが配布されていないか、該当言語キーが見つからない場合、英語の文言が表示されます（呼び出し部に英語の基本文言を一緒に渡す現製品リソース動作と同様）。

警告

多言語の文言が正常に表示されるためにはResUI*.rc6種(6.0.0.36)がSDKインストールパッケージと共に配布される必要があります。未配布環境では英語で表示されます。

5. 動作シナリオ要約表

#	状況	動作結果
1	サポート拡張子文書（一般・DRM・MIP）にグレードが適用されています	「セキュリティグレード」タブ表示 → "照会中" → 4行(グレードID·グレード名·ラベルID·ラベル名)表示
2	サポート拡張子文書ですが、グレードが付与されていません。	「セキュリティレベル」タブ表示 → "セキュリティレベル指定がされていない文書"
3	保護文書ですが、復号権限がありません	「セキュリティグレード」タブ表示 → "照会不可"
4	Security365 エージェントが起動していません	「セキュリティグレード」タブ表示 → "照会不可" (プロパティウィンドウ停止なし)
5	サポートされていない拡張子（画像・テキストなど）	「セキュリティレベル」タブ未表示
6	文書セキュリティログアウトまたはオフラインログイン状態	「セキュリティレベル」タブ未表示(オンラインログイン状態でのみ表示)

ランクの照会中も属性ウィンドウは停止せず、照会が終了すると結果がその場で更新されます。

6. サポート範囲 (拡張子 / ドキュメントタイプ)

タブ表示対象: Document Security がサポートする拡張子（オフィス・PDF など）の文書。判定は製品が登録した**サポートされている拡張子のリスト（読み取り専用共有メモリ）**で実行します。
ドキュメントタイプ: 一般（平文）·自社 DRM·MIP 文書すべて。タイプによって復号の可否が異なりますが、タブの動作は同じです。
ログイン状態: 文書セキュリティオンラインログイン状態でのみ「セキュリティグレード」タブが表示されます。ログアウト・オフラインログイン状態ではタブは表示されません。
未対応: サポートされていない拡張子のファイルにはタブが表示されません。

7. 制約事項

項目	内容
照会不可理由部分区分	等級が指定されていない文書は「セキュリティ等級が指定されていない文書」という文言で別途表示されます。それ以外の復号権限なし・エージェント未起動などは理由を区別せず単一の「照会不可」という文言で表示します。
エージェント依存	セキュリティ365 エージェント(`DS365.Core`パイプサーバー)に依存します。エージェント未起動時は「照会不可」と表示されます（属性ウィンドウが停止せずに安全に処理）。
等級別の色・正規化名称未適用	この機能は、グレード名を文書の保存値のまま表示し、オーバーレイアイコンのようなランク別の色表示·管理センター等級体系基準正規化名称（機密/敏感/公開）変換は含まれません。
感謝・権限別の可視性・ポリシー衝突処理未含む	企画で定義した等級照会監査ログ、役割・部門範囲別の可視性、表示ポリシーの衝突案内（5種の状態）は本作業範囲外であり、後続の開発領域です。
ログアウト・オフライン時タブ未表示	文書セキュリティはオンラインログイン状態でのみタブを表示します。ログアウト・オフラインログイン状態では「セキュリティレベル」タブは表示されません。

文書終了時に C/S/O 等級を自動指定

1. 概要

文書を保存または閉じる（終了する）時点で、会社のセキュリティポリシーが指定した単一のC/S/Oセキュリティ等級（機密・敏感・公開）をシステムがユーザーの介入なしに自動で文書に付与する機能です。管理者が条件付きポリシーに「適用するグレード・ラベル」をあらかじめ指定しておくと、対象文書に保存・終了イベントが発生したとき、そのグレードがそのまま適用されます。

この自動指定は C/S/O 等級付与の基本（既存）パスであり、「文書終了時にユーザーが手動でC/S/O等級を指定する」は、同時にユーザーが直接等級を選択する拡張パスです。二つの方式はサーバーポリシーカードで分岐し、一つの文書に同時に適用されることはありません。

この機能が必要な理由

等級体系が単純であったり、部門単位で等級が固定されている環境では、ユーザーが毎回等級を選ばなくても組織のポリシーに従って一括で付与される方が効率的です。
右クリック [ドキュメントグレード設定] メニューはユーザーが意図的に実行しなければ動作しないため、新しいドキュメントを作成してそのまま閉じる一般的な流れではグレードが欠落する可能性があります。保存・終了時点の自動指定はこの空白を埋め、対象ドキュメントが常にポリシーが定めたグレードを持つことを保証します。

動作方式

文書の保存・終了時にその文書が自動指定カード(setSecuLevel)にマッチングなれば、政策に指定された単一グレード・ラベルを別途確認ウィンドウなしで文書に適用します。

要約: 保存・終了時にポリシーが「自動指定」を指示した場合、ユーザーに何も尋ねずにポリシーが定めた単一のグレードが文書に付与されます。自動・手動の区分はサーバーポリシーカードによって決定され、付与履歴は統合ログに自動/手動の区分とともに記録されます。

ユーザーエクスペリエンス (別途選択画面なし)

自動指定は無音(silent)で動作します — 保存・終了時にレベル選択ウィンドウや案内ウィンドウが表示されません。適用されたレベルの結果は、エクスプローラーのオーバーレイアイコンとファイルプロパティウィンドウの「セキュリティレベル」タブで確認できます。

適用範囲 / 入口点

#	エントリーポイント (ドキュメントイベント)	動作時点
1	文書の閲覧/編集後の終了（または保存）	編集プログラムで文書を保存または閉じるとき (1次サポート範囲)

同じ自動指定(setSecuLevel）は条件付きポリシー設定に従って、ドキュメントの閲覧・ファイル単位のイベント（ローカルエクスプローラーの移動/コピー、Cloudのダウンロード・アップロード）でも動作するように構成できます。
一般文書とセキュリティ（DRM/MIP）文書の両方を対象とします。

2. 政策 / 設定

保存・終了イベントのグレード実行カード（管理コンソール「セキュリティグレード設定」）で指定する方法自動指定として選択すると、管理者が指定した単一のグレード・ラベルが自動付与対象になります。

指定方式	入力項目	実行キーワード
自動指定	適用するグレード + ラベル (各1個)	`setSecuLevel`
手動指定	ユーザーに表示するグレード (複数)	`availableSecurityLevelList`

手動指定は「文書終了時のユーザー手動C/S/O等級指定」セクションを参照してください。

条件付き執行ポリシー(`enforcementAttributes`) スキーマ

条件付きポリシー(ZTCAP)の実行ポリシーは、実行カード配列(enforcementAttributes)であり、グレードカードはその配列の1項目です（必要に応じて変換カードなどと一緒に配列に含まれます）。各カードは処理順序（order)·種類(category)·詳細(info)で構成され、自動指定はcategoryがsetSecuLevelインカードで表現されます。

{
  "enforcementAttributes": [
    {
      "order": 0,
      "category": "setSecuLevel",
      "info": {
        "detail": "レベルID;ラベルID"
      }
    }
  ]
}

自動カードのinfo.detailは레벨ID;레이블ID 単一ペア(セミコロン区切り)です — 適用するグレード1つとそのサブラベル1つを指定します。
手動カード(availableSecurityLevelList)が候補グレードID配列を含むユーザーに表示するのとは異なり、自動カードは目的地グレード・ラベルを管理者が単一で確定します。

現在のランク評価 (N2SF昇格)

自動指定度 N2SF 等級移動ルール（上昇のみ許可、下降不可）に従います。ただし、手動指定のように選択ウィンドウで候補等級をフィルタリングして表示する方式ではなく、ポリシー条件ステージで文書の現在の評価を評価対象かどうかを判定します。つまり、下方が発生しないように政策マッチングの時点でフィルタリングされ、実行カードには目的地のグレードのみが指定されます。

3. 動作シナリオ要約表

#	状況	動作結果
1	自動指定カード(`setSecuLevel`) マッチング + 保存・終了	ポリシーに指定された単一グレード・ラベルを確認ウィンドウなしで自動適用 + 統合ログ（自動区分、変更前/後のグレード）
2	手動指定カード(`availableSecurityLevelList`) マッチング	本経路介入なし手動指定経路で選択ウィンドウを表示（該当セクション参照）
3	対象文書ではありません / グレードカード未発行	等級変更なし
4	常駐エージェント未稼働など障害	等級未適用 + 統合ログ障害(ERROR)。保存・終了自体は正常進行
5	変換カードと共に構成 (例: DRM暗号化 + 自動グレーディング)	一つのポリシーの中でカードを順番に逐次実行（例：変換 → グレード）

4. サポート範囲 (拡張子 / ドキュメントタイプ)

対象: オフィス文書 —pps · ppsx · ppt · pptx · doc · docx · xls · xlsx · xlsb · xlsm(右クリック手動指定・終了時手動指定仕様と同一範囲)。
文書タイプ: 一般文書 + セキュリティ(DRM/MIP) 文書すべてサポート。
等級・ラベルはSecurity365管理センターのセキュリティ分類ラベルに従います（1次課題基準等級–ラベル1:1マッピング）。

5. 主要な流れ

管理者 — ポリシー登録

管理コンソール → 条件付きポリシー → エンドポイント → 対象文書・構成員・条件指定。
ドキュメントイベントで「ドキュメントの閲覧/編集後に終了（または保存）」を選択します。
執行ポリシー → グレードカード「セキュリティグレード設定」 → 指定方式自動指定選択。
適用するグレード(C/S/O) 1つとその下位ラベル1つを指定 → 保存。

クライアント — 保存・終了時に自動適用

ユーザーがドキュメントを保存または終了します。
保存・終了イベントとマッチする自動指定ポリシーを確認します。
ポリシーに指定された単一のグレード・ラベルを文書に適用します（ユーザー確認なし）。
部与内訳を統合ログ（自動区分、変更前/後グレード）に送信します。

6. 制約事項

#	制約	内容
1	単一グレード固定	自動指定は、ポリシーに指定された単一のグレード・ラベルのみを付与します。文書内容に基づいてグレードを判定して付与する方式は含まれていません（今後の拡張検討領域）。
2	自動/手動混在不可	同一文書に自動(`setSecuLevel`)·手動(`availableSecurityLevelList`) 等級カードが同時に発行される場合は、サーバーポリシーで除外されます。
3	エージェント依存	等級の適用は常駐エージェント（ポリシー処理コア）に依存します。未稼働時には等級が適用されません（意図された無動作）。
4	政策の優先順位	同一条件に複数のポリシーがマッチした場合、優先順位の高いポリシー1件が適用されます。1つのポリシー内の変換・グレードカードは管理者が設定した順序で実行されます。

文書終了時にユーザー手動C/S/Oグレード指定

1. 概要

文書を閉じる（終了する）時点で、会社のセキュリティポリシーが「ユーザーが自分で選択する」と指定されている場合セキュリティレベル選択ウィンドウを表示し、ユーザーがその文書のセキュリティレベル（C/S/O — 機密/敏感/公開）を直接選択・適用できる機能です。従来は終了時点にポリシーが定めた単一のグレードをシステムが自動でマッピング方式だけが動作したが、ここにユーザー手動選択パスを加え、政策に従って自動指定とユーザーの直接選択の両方をサポートします。(国家多重セキュリティシステム N2SF(National Network Security Framework) 対応)

この機能が必要な理由

N2SFは文書のグレード分類の主体と責任をユーザーにします。システムが自動的にランクを付けるだけでは「作成者が直接分類した」という要件を満たすのが難しい状況があります。

既存製品でユーザーが直接ランクを選ぶウィンドウはマウス右クリック → [文書グレード設定] メニューでしか開けませんでした。ユーザーが新しい文書を作成し、そのまま閉じる一般的な流れでは、グレードが欠落したり、システムの自動値に依存することになります。また、終了時点でポリシーが「ユーザー直接選択」を下ろしても、クライアントがこれを処理できず、そのまま進んでしまいます。ランクが適用されない限界がありました。

この機能は作業フローの自然な終了地点で分類を誘導この空白を埋めます。

動作方式 (一行メカニズム)

文書終了時、その文書が手動指定ポリシーにマッチングできれば、右クリック [ドキュメントランク設定]と同じランク選択ウィンドウを表示し — ユーザーがランクを選択すると、そのランクが文書に適用され、キャンセルするとランクは適用されません(no-op)。

備考

要約: 文書を閉じる際にポリシーが「ユーザー直接選択」を指示すると、閉じる文書ごとにセキュリティグレード選択ウィンドウが表示され、ユーザーが選んだグレードが文書に適用されます。自動指定と手動選択はサーバーポリシーカードで分岐され、グレード変更履歴は統合ログに自動・手動区分とともに記録されます。

適用範囲 / 入口点

#	エントリーポイント	動作時点
1	エディタプロセスの終了	Officeなどの編集プログラムを閉じるとき、閉じる文書ごとに
2	単一文書の終了	編集者が個別の文書を閉じるとき

適用ログイン環境:s365 · sso(DS6 標準認証経路). レガシー appAuth 経路は適用範囲から除外されます(制約事項項目参照)。
一般文書とセキュリティ（DRM/MIP）文書の両方を対象とします。

2. ユーザー画面 (UX)

終了時に手動指定ポリシーにマッチする場合、右クリック [文書グレード設定] と同じセキュリティグレード設定ウィンドウこれが表示されます。左側のメニューと右側のグレードリストで構成された2段ウィンドウで、閉じる文書の情報と選択可能なグレード・ラベルを表示します。

上部: 閉じる文書のアイコン・ファイル名・パスと製品ロゴ。
左側: メニュー領域(セキュリティレベル設定)。
右側: グレードリスト — 各グレードには色表示・グレード名・説明があり、その下に該当グレードのラベルがラジオ項目として並べられています。ラベルの1つを選択すると、そのグレードに分類されます（全体で1つだけ選択）。
下部: [キャンセル] · [確認] ボタン。

┌──────────────────────────────────────────────────────────────┐
│  [文書] 四半期報告書.docx           [ Document Security ロゴ ]  ×  │
│         C:\Users\...\四半期報告書.docx                            │
├───────────────┬────────────────────────────────────────────────┤
│               │  セキュリティ等級設定                                  │
│ ▍セキュリティ等級    │  終了する文書に適用するセキュリティ等級を選択してください。    │
│    設定       │                                                 │
│               │  ● C等級 (機密)     組織機密情報               │
│               │      ○ C-極秘   ● C-対外秘   ○ C-内部            │
│               │  ──────────────────────────────────            │
│               │  ● S等級 (敏感)     敏感情報                    │
│               │      ○ S-対外秘   ○ S-内部                       │
│               │  ──────────────────────────────────            │
│               │  ● O等級 (公開)     公開可能                    │
│               │      ○ O-一般                                   │
│               │                                                 │
│               │                         [ キャンセル ]   [ 確認 ]     │
└───────────────┴────────────────────────────────────────────────┘

ユーザー選択	結果
ラベル選択後 [確認]	選択したグレード・ラベルを文書に適用。統合ログに手動指定・変更前/後のグレード・指定者記録
[キャンセル] / 閉じる(×) / 未選択	等級を適用しない(no-op)。統合ログは未適用(INFO)のまま。

画面の基本選択は、ポリシーの基本グレードに従います。
複数の文書を一度に閉じるとドキュメントごとに選択ウィンドウが順次表示されます。

3. 政策 / 設定

終了イベントのグレード実行カード（管理コンソール「セキュリティグレード設定」）で自動/手動指定方式を選択すると、選択に応じて保存されるカードの種類が異なります。

指定方式	入力項目	実行キーワード
自動指定	適用するグレード + ラベル (各1個)	`setSecuLevel`
手動指定	ユーザーに表示するグレード (複数)	`availableSecurityLevelList`

条件付き実行ポリシー(enforcementAttributes)スキーマ

条件付き政策(ZTCAP)の執行政策は実行カード配列(enforcementAttributes)であり、グレードカードはその配列の1項目です（必要に応じて変換カードなどと一緒に配列に含まれます）。各カードは処理順序（order)·種類(category)·詳細(info)で構成され、グレード指定方式（自動/手動）はcategoryに決定されます。

{
  "enforcementAttributes": [
    {
      "order": 0,
      "category": "availableSecurityLevelList",
      "info": {
        "detail": "[{\"levelId\":\"NI9V0lbL-...\"},{\"levelId\":\"iqCCmC4N-...\"},{\"levelId\":\"dliTWZzt-...\"}]",
        "defaultSelectLevelId": "iqCCmC4N-ADUvGusn-4Gkhlyi6-vPJQvg6r"
      }
    }
  ]
}

info.detailはJSON 文字列で再度エンコードされた(二重エンコーディング) グレード ID 配列です。右クリック手動指定パスの候補グレード形式と同じです。

自動カード vs 手動カード

二つの方式は同じグレードのカードの場所でcategoryわinfo.detail形式で区切られます。

// 자동 지정 — 종료 시 단일 등급/레이블 자동 부여 (기존)
{
  "order": 0,
  "category": "setSecuLevel",
  "info": {
    "detail": "레벨ID;레이블ID"
  }
}

// 수동 지정 — 종료 시 노출할 등급 복수 (사용자 선택, 본 기능)
{
  "order": 0,
  "category": "availableSecurityLevelList",
  "info": {
    "detail": "[{\"levelId\":\"...\"},{\"levelId\":\"...\"}]",
    "defaultSelectLevelId": "..."
  }
}

自動カードのdetailは레벨ID;레이블ID 単一ペア(セミコロン区切り)です。
手動カードのdetail候補ランク ID 配列であり、ユーザーがその中の一つ(+詳細ラベル)を選択ウィンドウで選びます。

クライアント使用フィールド (手動カード)

フィールド	使用
`category` = `availableSecurityLevelList`	手動指定ディスパッチキー
`info.detail`(グレード ID 配列、二重エンコーディング)	ユーザーが選択する候補グレードIDリスト
`info.defaultSelectLevelId`	選択ウィンドウの基本選択レベル

4. 多言語 / リソース

ランク選択ウィンドウの文言は6つの言語で提供されます。

項目	内容
サポートされている言語	韓国語 · 英語 · 中国語 · 日本語 · ドイツ語 · ロシア語
リソース	`DSResKor/Eng/Chn/Jpn/Deu/Rus.ini`の`[GRADE_UI]`セクション (選択ウィンドウ文言 8個キー)
表示言語の決定	クライアント UI 文化圏（システムロケール）に該当するリソース文言表示
デフォルト値(fallback)	該当言語リソース・キーを見つけられません。英語文言表示

警告

フランス語·チェコ語·繁体字など上記6言語以外の言語は未サポートで、英語で表示されます。多言語の文言はSDKインストールパッケージと共に配布される必要があります。

5. 動作シナリオ要約表

#	状況	動作結果
1	手動指定カードマッチング文書終了 + ユーザーがランク選択・[確認]	選択ウィンドウ表示 → 選択レベル適用 + 統合ログ（手動、変更前/後、指定者）
2	手動指定カードマッチング文書終了 + [キャンセル]/X/未選択	選択ウィンドウ表示 → 等級未適用(no-op)、統合ログ未適用(INFO)
3	自動指定カード(`setSecuLevel`) マッチング文書終了	本経路介入なしに既存の自動指定で単一グレードを付与
4	常駐エージェント（デーモン）未稼働・表示失敗	等級未適用(no-op) + 統合ログ障害(ERROR)。エディタ終了は正常進行
5	複数の文書を一括終了（手動マッチング）	ドキュメントごとに選択ウィンドウを順次表示

6. サポート範囲 (拡張子 / ドキュメントタイプ)

対象: オフィス文書 —pps · ppsx · ppt · pptx · doc · docx · xls · xlsx · xlsb · xlsm(右クリック手動指定・終了時自動指定仕様と同範囲).
文書タイプ: 一般文書 + セキュリティ(DRM/MIP) 文書すべてサポート。
等級・ラベルはSecurity365管理センターのセキュリティ分類ラベルに従います（1次課題基準等級–ラベル1:1マッピング）。

7. 主要な流れ

管理者 — ポリシー登録

管理コンソールで終了（または保存）イベントのグレードカードを手動指定として、表示するグレードを複数選択して保存します。

ユーザー — 終了時に手動指定

ユーザーが文書を閲覧/編集した後、終了（または保存）します。
終了イベントとマッチする手動指定ポリシーを確認します。
N2SF 規則(未指定 → 許可レベル全体 / 既指定 → 同一・上位)で露出レベルを決定します。
グレード選択ウィンドウを表示し、ユーザーがグレード・ラベルを選択します。
選択グレードを文書に適用し、統合ログ（手動区分・指定子）を送信します。
複数の文書が閉じると、文書ごとに上記の流れを繰り返します。

8. 制約事項

#	制約	内容 / ユーザー影響
1	同期占有	選択ウィンドウが表示されている間、該当の終了処理経路が占有されます（ユーザー選択時間分）。エディタ終了応答自体は影響を受けませんが、同時に進行中の他のセキュリティ動作が遅延する可能性があります。無限待機を防ぐために、自動閉鎖タイムアウトが適用されます。
2	N文書の順次処理	複数の文書が一括終了されると、文書ごとに選択ウィンドウが順次表示され、各選択時間が累積されます。(バッチ単一リストUIは本作業範囲外)
3	多言語サポート範囲	6つの言語（韓国語・英語・中国語・日本語・ドイツ語・ロシア語）のみサポートされており、それ以外の言語は英語で表示されます。
4	リソース反映時点	選択ウィンドウの文言は常駐デーモンが1回ロードして保管するため、リソース(INI)の更新はデーモンの再起動または再ブート後に反映されます(インストールパッケージの配布時には無関係)。
5	自動/手動混在不可	同一文書に自動・手動のグレードポリシーが同時に発行される場合は、サーバーポリシーから除外（混在不可）されることを前提とします。
6	適用環境	s365 · sso 認証経路に適用され、レガシー appAuth 経路は含まれていません。
7	エージェント依存	常駐エージェントが未稼働の場合、グレードは適用されません（意図された無動作）。

CSO等級別プリントマーキング

1. 概要

セキュリティ文書を印刷する際、文書のCSO等級(C/S/O)に応じて上下のテキストと中央のマークを等級別に異なる表示にします。等級は文書ヘッダーのSFIオーバーレイアイコンインデックスで判別し、等級別カスタムポリシー(DS_PRINTMK_CSO_C/O/S）の値を基本プリントマークポリシーが作成したマーク行に置き換えます(item-override)。

グレード	SFI overlay icon index	カスタムポリシー名
C	1	`DS_PRINTMK_CSO_C`
O	2	`DS_PRINTMK_CSO_O`
S	3	`DS_PRINTMK_CSO_S`

2. 置換タグ仕様

タグ	対象行	nType / LOCATION	備考
`TEXT_OPTION`	中央斜線ウォーターマーク	MARKING_SETTING	マークテキストの`$oText`変数に置き換えられました
`TEXT`	上・下段テキスト行	nType=0 / LOC=0(上), 2(下)	同じ`<case=MARKING_DATA>`内部で LOCATION によって位置を指定
`CENTER_TEXT`	中央テキスト行	nType=0 / LOC=1	専用タグ。 `TEXT`再利用不可 (ExtractTagValueの最初のマッチが上部行をキャッチ)
`IMAGE_FILE_NAME`	中央画像行	nType=1 / LOC=1	BMPフォーマット（拡張子無関係）。`windows\Softcamp\SDS\`に配置

四半期排他性: 画像行(nType=1) / 中央テキスト行(nType=0·LOC=1) / 上下テキスト行(nType=0·LOC=0,2) — 3つは重ならない。nType==0ガードロ中央テキスト置換が画像行を侵害しない。

3. ポリシー設定

基本プリントマークポリシー (管理者コンソール → プリントマーク → スクリプト)

中央 = 画像行(dscgru.dll) + テキスト行("セキュリティ文書"). CSO override がこの中央テキスト行("セキュリティ文書")を等級別CENTER_TEXTを置き換える。

<Begin>
  <case=MARKING_VERSION>
    <VERSION="2">
  </case>
   <case=MARKING_SETTING>
    <NORMAL_DOC="0">
    <ENABLE="1">
    <BMP_FILE_USE="0">
    <DENSITY_CENTER="40">
    <INTERCHARACTER="0">
    <INTERLINE="100">
    <SLOPE="300">
    <TEXT_OPTION="이문서는보안문서입니다. ">
    <DATE_FORMAT1="yyyy-MM-dd ">
    <DATE_FORMAT2="yyyy, MM, dd ddd">
    <DATE_FORMAT3="yyyy MM dd">
    <TIME_FORMAT1="HH:mm">
    <TIME_FORMAT2="hh mm ss">
    <TIME_FORMAT3="hh mm ">
    <WIDTH="600">
    <HEIGHT="600">
    <HP_PRINT_DENSITY="10">
    <DOT_PRINTER="ALL">
  </case>
  <case=MARKING_DATA>
    <NORMAL_DOC="0">
    <TYPE="1">
    <LOCATION="1">
    <ALIGN="0">
    <FONT_SIZE="200">
    <IMAGE_FILE_NAME="dscgru.dll">
    <MARGINX="0"> 
    <MARGINY="0"> 
    <RESERVED="0">
    </case>
    <case=MARKING_DATA>
    <LOCATION="0">
    <ALIGN="1">
    <FONT_SIZE="20">
    <FONT_NAME="굴림">
    <FONT_COLOR="0">
    <FONT_WEIGHT="0">
    <TEXT="보안/ $uID / $uName / $uOrg / $HostName">
    <MARGINX="0"> 
    <MARGINY="0"> 
  </case>
  <case=MARKING_DATA>
    <NORMAL_DOC="0">
    <LOCATION="2">
    <ALIGN="1">
    <FONT_SIZE="20">
    <FONT_NAME="굴림">
    <FONT_COLOR="0">
    <FONT_WEIGHT="0">
    <TEXT="보안/ $pDate1 / $pTime1 / $oText">
    <MARGINX="0">
    <MARGINY="0">
  </case>
  <case=MARKING_DATA>
    <NORMAL_DOC="0">
    <LOCATION="1">
    <FONT_SIZE="150">
    <FONT_NAME="HY견고딕">
    <FONT_COLOR="0">
    <FONT_WEIGHT="300">
    <TEXT="보안문서">
    <ALIGN="1">
  </case>
<End>

DS_PRINTMK_CSO_C カスタムポリシー

CENTER_TEXT="C등급"→ 基本政策中央テキスト行("セキュリティ文書")を "Cランク" に置換。上下 TEXT も Cランク文言に置換。

<Begin>
  <case=MARKING_VERSION>
    <VERSION="2">
  </case>
   <case=MARKING_SETTING>
    <NORMAL_DOC="0">
    <ENABLE="1">
    <BMP_FILE_USE="0">
    <DENSITY_CENTER="40">
    <INTERCHARACTER="0">
    <INTERLINE="100">
    <SLOPE="300">
    <CENTER_TEXT="C등급">
    <DATE_FORMAT1="yyyy-MM-dd ">
    <DATE_FORMAT2="yyyy, MM, dd ddd">
    <DATE_FORMAT3="yyyy MM dd">
    <TIME_FORMAT1="HH:mm">
    <TIME_FORMAT2="hh mm ss">
    <TIME_FORMAT3="hh mm ">
    <WIDTH="600">
    <HEIGHT="600">
    <HP_PRINT_DENSITY="10">
    <DOT_PRINTER="ALL">
  </case>
    <case=MARKING_DATA>
    <LOCATION="0">
    <ALIGN="1">
    <FONT_SIZE="20">
    <FONT_NAME="굴림">
    <FONT_COLOR="0">
    <FONT_WEIGHT="0">
    <TEXT="C등급 문서/ $uID / $uName / $uOrg / $HostName">
    <MARGINX="0"> 
    <MARGINY="0"> 
  </case>
  <case=MARKING_DATA>
    <NORMAL_DOC="0">
    <LOCATION="2">
    <ALIGN="1">
    <FONT_SIZE="20">
    <FONT_NAME="굴림">
    <FONT_COLOR="0">
    <FONT_WEIGHT="0">
    <TEXT="C등급 문서/ $pDate1 / $pTime1 / $oText">
    <MARGINX="0">
    <MARGINY="0">
  </case>
  <case=MARKING_DATA>
    <NORMAL_DOC="0">
    <LOCATION="1">
    <FONT_SIZE="150">
    <FONT_NAME="HY견고딕">
    <FONT_COLOR="0">
    <FONT_WEIGHT="300">
    <ALIGN="1">
  </case>
<End>

DS_PRINTMK_CSO_S カスタムポリシー

<Begin>
  <case=MARKING_VERSION>
    <VERSION="2">
  </case>
   <case=MARKING_SETTING>
    <NORMAL_DOC="0">
    <ENABLE="1">
    <BMP_FILE_USE="0">
    <DENSITY_CENTER="40">
    <INTERCHARACTER="0">
    <INTERLINE="100">
    <SLOPE="300">
    <CENTER_TEXT="S등급">
    <DATE_FORMAT1="yyyy-MM-dd ">
    <DATE_FORMAT2="yyyy, MM, dd ddd">
    <DATE_FORMAT3="yyyy MM dd">
    <TIME_FORMAT1="HH:mm">
    <TIME_FORMAT2="hh mm ss">
    <TIME_FORMAT3="hh mm ">
    <WIDTH="600">
    <HEIGHT="600">
    <HP_PRINT_DENSITY="10">
    <DOT_PRINTER="ALL">
  </case>
    <case=MARKING_DATA>
    <LOCATION="0">
    <ALIGN="1">
    <FONT_SIZE="20">
    <FONT_NAME="굴림">
    <FONT_COLOR="0">
    <FONT_WEIGHT="0">
    <TEXT="S등급 문서/ $uID / $uName / $uOrg / $HostName">
    <MARGINX="0"> 
    <MARGINY="0"> 
  </case>
  <case=MARKING_DATA>
    <NORMAL_DOC="0">
    <LOCATION="2">
    <ALIGN="1">
    <FONT_SIZE="20">
    <FONT_NAME="굴림">
    <FONT_COLOR="0">
    <FONT_WEIGHT="0">
    <TEXT="S등급 문서/ $pDate1 / $pTime1 / $oText">
    <MARGINX="0">
    <MARGINY="0">
  </case>
  <case=MARKING_DATA>
    <NORMAL_DOC="0">
    <LOCATION="1">
    <FONT_SIZE="150">
    <FONT_NAME="HY견고딕">
    <FONT_COLOR="0">
    <FONT_WEIGHT="300">
    <ALIGN="1">
  </case>
<End>

DS_PRINTMK_CSO_O カスタムポリシー

<Begin>
  <case=MARKING_VERSION>
    <VERSION="2">
  </case>
   <case=MARKING_SETTING>
    <NORMAL_DOC="0">
    <ENABLE="1">
    <BMP_FILE_USE="0">
    <DENSITY_CENTER="40">
    <INTERCHARACTER="0">
    <INTERLINE="100">
    <SLOPE="300">
    <CENTER_TEXT="O등급">
    <DATE_FORMAT1="yyyy-MM-dd ">
    <DATE_FORMAT2="yyyy, MM, dd ddd">
    <DATE_FORMAT3="yyyy MM dd">
    <TIME_FORMAT1="HH:mm">
    <TIME_FORMAT2="hh mm ss">
    <TIME_FORMAT3="hh mm ">
    <WIDTH="600">
    <HEIGHT="600">
    <HP_PRINT_DENSITY="10">
    <DOT_PRINTER="ALL">
  </case>
    <case=MARKING_DATA>
    <LOCATION="0">
    <ALIGN="1">
    <FONT_SIZE="20">
    <FONT_NAME="굴림">
    <FONT_COLOR="0">
    <FONT_WEIGHT="0">
    <TEXT="O등급 문서/ $uID / $uName / $uOrg / $HostName">
    <MARGINX="0"> 
    <MARGINY="0"> 
  </case>
  <case=MARKING_DATA>
    <NORMAL_DOC="0">
    <LOCATION="2">
    <ALIGN="1">
    <FONT_SIZE="20">
    <FONT_NAME="굴림">
    <FONT_COLOR="0">
    <FONT_WEIGHT="0">
    <TEXT="O등급 문서/ $pDate1 / $pTime1 / $oText">
    <MARGINX="0">
    <MARGINY="0">
  </case>
  <case=MARKING_DATA>
    <NORMAL_DOC="0">
    <LOCATION="1">
    <FONT_SIZE="150">
    <FONT_NAME="HY견고딕">
    <FONT_COLOR="0">
    <FONT_WEIGHT="300">
    <ALIGN="1">
  </case>
<End>

政策作成の注意

この構成の等級別中央マーキング = CENTER_TEXT**(テキスト置換)**方式だ。基本政策の中央テキスト行("セキュリティ文書")を"Cランク"/"Sランク"/"Oランク"に置き換える。
CSO ポリシーにはper-grade IMAGE_FILE_NAME がない。中央画像(dscgru.dll）は基本政策固定 — すべてのグレード同じ。グレードごとに異なる画像CSOポリシーに必要な場合は<IMAGE_FILE_NAME="...">追加 + 해당 BMP を SDS フォルダに配置 (現構成未使用 — 拡張オプション)。
CSO_C/S/O ポリシーの終了<case=MARKING_DATA><LOCATION="1">(TEXT/IMAGE ない空の中央行)は無効構造全て (override が無視される). 置いても無害だが動作には関与しない。

機能詳細​

マウス右クリックでランク指定​

1.概要​

2. 機能設定 (必須およびオプション)​

3. 関連 Security365 サービス**(必須)**​

A. 管理センター - セキュリティグレード＆ラベル登録​

B. 条件付きポリシー ( ztcap ) : 変換可能なセキュリティラベルに関するポリシー​

オーバーレイアイコンの適用​

1. 概要​

2. 制約事項​

文書プロパティウィンドウのセキュリティレベル表示​

1. 概要​

この機能が必要な理由​

動作方式​

適用範囲 / 入口点​

2. 表示されるセキュリティグレード情報​

3. ユーザー画面​

4. 多言語サポート​

5. 動作シナリオ要約表​

6. サポート範囲 (拡張子 / ドキュメントタイプ)​

7. 制約事項​

文書終了時に C/S/O 等級を自動指定​

1. 概要​

この機能が必要な理由​

動作方式​

ユーザーエクスペリエンス (別途選択画面なし)​

適用範囲 / 入口点​

2. 政策 / 設定​

条件付き執行ポリシー(enforcementAttributes) スキーマ​

現在のランク評価 (N2SF昇格)​

3. 動作シナリオ要約表​

4. サポート範囲 (拡張子 / ドキュメントタイプ)​

5. 主要な流れ​

管理者 — ポリシー登録​

クライアント — 保存・終了時に自動適用​

6. 制約事項​

文書終了時にユーザー手動C/S/Oグレード指定​

1. 概要​

この機能が必要な理由​

動作方式 (一行メカニズム)​

適用範囲 / 入口点​

2. ユーザー画面 (UX)​

3. 政策 / 設定​

条件付き実行ポリシー(enforcementAttributes)スキーマ​

自動カード vs 手動カード​

クライアント使用フィールド (手動カード)​

4. 多言語 / リソース​

5. 動作シナリオ要約表​

6. サポート範囲 (拡張子 / ドキュメントタイプ)​

7. 主要な流れ​

管理者 — ポリシー登録​

ユーザー — 終了時に手動指定​

8. 制約事項​

CSO等級別プリントマーキング​

1. 概要​

2. 置換タグ仕様​

3. ポリシー設定​

基本プリントマークポリシー (管理者コンソール → プリントマーク → スクリプト)​

DS_PRINTMK_CSO_C カスタムポリシー​

DS_PRINTMK_CSO_S カスタムポリシー​

DS_PRINTMK_CSO_O カスタムポリシー​

政策作成の注意​

機能詳細

マウス右クリックでランク指定

1.概要

2. 機能設定 (必須およびオプション)

3. 関連 Security365 サービス(必須)

A. 管理センター - セキュリティグレード＆ラベル登録

B. 条件付きポリシー ( ztcap ) : 変換可能なセキュリティラベルに関するポリシー

オーバーレイアイコンの適用

1. 概要

2. 制約事項

文書プロパティウィンドウのセキュリティレベル表示

1. 概要

この機能が必要な理由

動作方式

適用範囲 / 入口点

2. 表示されるセキュリティグレード情報

3. ユーザー画面

4. 多言語サポート

5. 動作シナリオ要約表

6. サポート範囲 (拡張子 / ドキュメントタイプ)

7. 制約事項

文書終了時に C/S/O 等級を自動指定

1. 概要

この機能が必要な理由

動作方式

ユーザーエクスペリエンス (別途選択画面なし)

適用範囲 / 入口点

2. 政策 / 設定

条件付き執行ポリシー(`enforcementAttributes`) スキーマ

現在のランク評価 (N2SF昇格)

3. 動作シナリオ要約表

4. サポート範囲 (拡張子 / ドキュメントタイプ)

5. 主要な流れ

管理者 — ポリシー登録

クライアント — 保存・終了時に自動適用

6. 制約事項

文書終了時にユーザー手動C/S/Oグレード指定

1. 概要

この機能が必要な理由

動作方式 (一行メカニズム)

適用範囲 / 入口点

2. ユーザー画面 (UX)

3. 政策 / 設定

条件付き実行ポリシー(enforcementAttributes)スキーマ

自動カード vs 手動カード

クライアント使用フィールド (手動カード)

4. 多言語 / リソース

5. 動作シナリオ要約表

6. サポート範囲 (拡張子 / ドキュメントタイプ)

7. 主要な流れ

管理者 — ポリシー登録

ユーザー — 終了時に手動指定

8. 制約事項

CSO等級別プリントマーキング

1. 概要

2. 置換タグ仕様

3. ポリシー設定

基本プリントマークポリシー (管理者コンソール → プリントマーク → スクリプト)

DS_PRINTMK_CSO_C カスタムポリシー

DS_PRINTMK_CSO_S カスタムポリシー

DS_PRINTMK_CSO_O カスタムポリシー

政策作成の注意