高度なポリシータイプ

ポリシーフォームのAdvanced Modeでは、ポリシーの生のJSONを表示・編集できます。標準のフォーム項目にない設定が必要なとき、またはポリシー内部の PolicyType を直接指定する必要があるときに使います。

次のような作業をするときに、Advanced Modeを使います。

ポリシータイプやプラットフォームによって細部は異なりますが、JSONには通常、次のような項目が含まれます。

ポリシーのメタデータ
- 名前、説明、識別子
ターゲティング
- ポリシーが適用されるユーザー、マシン、アプリケーション、プラットフォーム、コレクション
ポリシータイプ
- エージェント上でのポリシーの評価の仕方を表す PolicyType フィールド
ポリシー構成
- そのポリシータイプ向けの設定をまとめたオブジェクトが1つ以上 (構成をJSONで渡すタイプでは、多くの場合 Extension オブジェクト)

Advanced Modeでの編集によって、次のようなことが起こり得ます。

JSONが実際に効く定義になるため、設定ファイルと同様に慎重に扱うことが重要です。小さな誤りでも、ポリシーが想定どおり適用されないことがあります。

標準UIで利用できる任意のポリシータイプからポリシーを作成します (有効なベース構造が得られます)。
先にUIでターゲティングを設定します (コレクション/ユーザー/マシン/アプリ/プラットフォーム)。
Advancedタブを開きます。
JSON全文をコピーし、安全な場所に保存します (必要なら元に戻せるようにします)。
必要最小限の変更だけを行います。
- PolicyType を希望の値に設定します
- 必要な構成オブジェクトを追加または更新します (例: Extension)
ポリシーを保存します。
小さなテスト範囲で挙動を確認してから、適用範囲を広げます。

プラグインまたはエージェントの構成をエンドポイントへ反映するときに使います。よくあるパターンは次のとおりです。

設定更新ポリシータイプのページをご参照ください。

エンドポイント上のジョブ用JSONを追加/更新/削除するときに使います。よくあるパターンは次のとおりです。

ジョブ更新ポリシータイプのページをご参照ください。

外向きウェブアクセスの規則を評価し、適用するときに使います。よくあるパターンは次のとおりです。

HTTPアクセスポリシータイプのページをご参照ください。

社内向けの特殊なワークフローや連携に使います。よくあるパターンは次のとおりです。

カスタムポリシータイプのページをご参照ください。

ターゲティングは、可能なら標準エディターで設定します。JSONで編集するのは、追加で必要なフィールドに限ります。

引用符、括弧、カンマの欠落は、ポリシーの保存や正しい処理を妨げることがあります。保存に失敗したら、最後に問題なく動いていたJSONに戻し、変更は少しずつ入れ直します。

PolicyType を変えたり、新しいJSONキーを足したりするときは、適用範囲を広げる前に、小さなテスト用コレクションで試します。

ポリシータイプが特定のJSONスキーマに依存している場合 (とくに Custom)、次のような情報の公開を検討してください。

最終更新 15 日前