--- sourceDocument: Xanadu IT Service Management sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/it-service-management Release : - xanadu ft:locale : - ja-JP ft:publication_title : - Xanadu IT Service Management ft:clusterId : - itsm bundleId : - itsm workflow : - Technology --- # 汎用ポリシー # の汎用ポリシー DevOps コンフィグ {#ariaid-title1} * リリースバージョン: Xanadu * * 更新日 2024年08月01日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：32分 デフォルトでは、 DevOps コンフィグ ポリシーコンテンツパックには、構成データを検証するための汎用ポリシーのセットが含まれています。 重要: Washington DC リリース以降、DevOps コンフィグは将来の廃止に備えて準備されます。これは非表示になり、新しいインスタンスにはインストールされなくなりますが、引き続きサポートされます。詳細については、Now Support ナレッジベースの「[Deprecation Process (廃止プロセス) \[KB0867184\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB0867184)」の記事を参照してください。 これらのデフォルトの DevOps コンフィグ ポリシーを使用またはカスタマイズして、構成データコンテンツが適合していることを検証できます。 [のライフサイクル全体を管理します PaCE ポリシー](https://www.servicenow.com/docs/access?context=pace-managing-policies&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). 注: デフォルトのポリシーを変更することはできません。ただし、ポリシーのコピーを作成して、そのコピーをカスタマイズすることはできます。 |-| | [あ](https://servicenow-prod.fluidtopics.net/S4U7UAsD6G_tUu6AyCJT5A#devops-config-gen-policies__a) \| [C](https://servicenow-prod.fluidtopics.net/S4U7UAsD6G_tUu6AyCJT5A#devops-config-gen-policies__c) \| [Dさん](https://servicenow-prod.fluidtopics.net/S4U7UAsD6G_tUu6AyCJT5A#devops-config-gen-policies__d) \| [エフ](https://servicenow-prod.fluidtopics.net/S4U7UAsD6G_tUu6AyCJT5A#devops-config-gen-policies__f) \| [Gの](https://servicenow-prod.fluidtopics.net/S4U7UAsD6G_tUu6AyCJT5A#devops-config-gen-policies__g) \| [ケイ](https://servicenow-prod.fluidtopics.net/S4U7UAsD6G_tUu6AyCJT5A#devops-config-gen-policies__k) \| [L](https://servicenow-prod.fluidtopics.net/S4U7UAsD6G_tUu6AyCJT5A#devops-config-gen-policies__l) \| [のM](https://servicenow-prod.fluidtopics.net/S4U7UAsD6G_tUu6AyCJT5A#devops-config-gen-policies__m) \| [N](https://servicenow-prod.fluidtopics.net/S4U7UAsD6G_tUu6AyCJT5A#devops-config-gen-policies__n) \| [Sさん](https://servicenow-prod.fluidtopics.net/S4U7UAsD6G_tUu6AyCJT5A#devops-config-gen-policies__s) \| [U](https://servicenow-prod.fluidtopics.net/S4U7UAsD6G_tUu6AyCJT5A#devops-config-gen-policies__u) | [表 : 1. このページのポリシーの最初の文字のナビゲーション] {#devops-config-gen-policies__table_gsp_4vm_nzb} ## すべてのキー/値コンパレーター (allKeysValuesComparator) {#devops-config-gen-policies__a} 追加の展開可能項目のすべてのキーと値の組み合わせがメイン展開可能項目と同じかどうかを確認します。 次の条件では、非準拠ステータスになります。 * キーがメイン展開可能項目には存在するが、追加の展開可能項目には存在しない場合。 * キーが追加の展開可能項目には存在するが、メインの展開可能項目には存在しない場合。 * キーがメイン展開可能項目と追加の展開可能項目の両方に存在し、値が異なる場合 {#devops-config-gen-policies__ul_xg2_hgm_nzb} ユースケース:ステージング環境と本番環境間の構成のずれを検出します。 入力引数 : * additionalDeployablesInput * メイン展開可能項目と比較される追加の展開可能項目のリスト。 * タイプ:リスト * Mandatory : True {#devops-config-gen-policies__ul_ogc_pkz_zyb} * includeNodes * 検証に構成データアイテム (CDI) 以外のノードを含めるかどうかを示すブール値。 * デフォルト値: `false` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_ppl_jkz_zyb} * exceptionList * 比較時に無視する必要があるキー名のカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_bgt_mkz_zyb} {#devops-config-gen-policies__ul_jym_zkt_nzb} ## 許可されたメールドメイン (authorizedEmailDomains) {#devops-config-gen-policies__section_b2m_bcq_wqb} 正規表現に基づいて識別されたメールドメイン値が、承認済みメールドメインリストに含まれているかどうかを確認します。 メールドメインが承認済みドメインでない場合、非準拠ステータスになります。 ユースケース:(機密性の高い) データが信頼できる会社のメールドメインから送信されるのを防ぎます。 入力引数 : * authorizedDomain * 許可されたメールドメインのカンマ区切りリスト。 * 例： gmail.com,servicenow.com * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_hwv_5lz_zyb} * exceptionList * ポリシーによって無視されるキー名のカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_tqf_kmz_zyb} {#devops-config-gen-policies__ul_xpf_dlt_nzb} ## URL 内の承認済みホスト (authorisedHostsInURLS) {#devops-config-gen-policies__section_gc4_rcq_wqb} スナップショット内の URL 値のホストコンポーネントの形式が許可されているかどうかを確認します。 スナップショット内の URL 値がホストコンポーネントに指定された形式に従っていない場合、非準拠ステータスになります。 ユースケース:許可されていない URL による (機密性の高い) データの公開を防止します。 入力引数 : * authorizedHostsRegex * URL のホストコンポーネントを検証するために使用される正規表現のカンマ区切りリスト。 * 例： notpresent$,code.devsnc+,mydomain.com * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_bdz_hnz_zyb} * exceptionList * ポリシーによって無視されるキー名のカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_abl_hnz_zyb} {#devops-config-gen-policies__ul_aq5_3kt_nzb} ## 認可されたキーと値の組み合わせ (authorisedKVCombinations) {#devops-config-gen-policies__section_t4c_zcq_wqb} スナップショットで見つかった入力キー値が許可されているかどうかを確認します。 キーに許可されていない値がある場合、非準拠ステータスになります。 入力引数 : * authorisedList * 各キーの許可された文字列値のリストを含む、キーの JSON リスト。 * 例： { "image":"k8s.example.io,gke.example.io,docker.example.com:8444", "domain":"example.service-now.com" } * タイプ：JSON * Mandatory : True {#devops-config-gen-policies__ul_pgd_2nk_zyb} * caseSensitive * 検証に使用される認証キーとそのキー値で大文字と小文字を区別するかどうかを示すブール値。 * デフォルト値：`False` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_js2_n3r_zyb} {#devops-config-gen-policies__ul_gbj_lkt_nzb} ## 許可されたポート範囲 (authorisedPortsRange) {#devops-config-gen-policies__section_fqx_hdq_wqb} スナップショットで見つかった入力ポート値が許可されているかどうかを確認します。 ポート値が許容範囲内にない場合、非準拠ステータスになります。 ユースケース:ポート名が、使用される環境の許容範囲内にあることを確認します。このポリシーは、ポート番号だけでなく、任意の範囲値のチェックに使用できます。例えば、ヒープ・サイズを定義するすべてのパラメーターが適切な範囲内にあることを確認する場合などです。 入力引数 : * keysRegexWithRange * 最小値と最大値を含むポートキーとポート範囲の JSON リスト。キーは、キーが入力で指定された正規表現と一致する場合にポートとして識別されます。 * 例： { "^web_port$": "5000-5003", "env.db.port": "10000-65535" } * タイプ：JSON * Mandatory : True {#devops-config-gen-policies__ul_owc_xqz_zyb} * exceptionList * ポリシーによって無視されるキー名のカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_apt_dsz_zyb} {#devops-config-gen-policies__ul_fkf_nkt_nzb} ## 証明書検証ツール (certificateValidator) {#devops-config-gen-policies__c} 証明書がスナップショットに存在するかどうか、および証明書が期限切れになっているか、有効期限内に期限切れになりそうであるかどうかを確認します。 スナップショット内の有効期限 `のある` キーまたは `PEM` エンコード形式の値を持つ証明書キーが期限切れになっているか、有効期限内に期限切れになる場合は、非準拠ステータスになります。有効期間は、ポリシーが実行された日に有効期限日数を加算して計算されます。 入力引数 : * certificatesNode * 証明書を含むノードの名前。 * デフォルト値: `certificates` * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_vxn_5rj_bzb} * expirationDays * 証明書の有効期間を計算する日数。有効期間は、ポリシーが実行された日に有効期限日数を加算して計算されます。 * タイプ：整数 * 必須:false {#devops-config-gen-policies__ul_gm4_wpj_bzb} * exceptionList * ポリシーによって無視される証明書名のカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_qf1_1qj_bzb} {#devops-config-gen-policies__ul_d3m_pkt_nzb} ## コンシステント・ノード・コンパレーター (consistentNodesComparator) {#devops-config-gen-policies__section_i3h_q1y_4sb} スナップショット内のすべての第 1 レベルのノードについて、すべてのキーと値の組み合わせが同じかどうかを確認します。 スナップショット内のいずれかの 2 つの第 1 レベルのノードのキーと値の組み合わせが異なる場合、非準拠ステータスになります。 ユースケース:スナップショット内のすべてのノードがデバイスまたは仮想マシン (VM) のグループである場合、それらは同じ構成になります。 入力引数 : exceptionList * 検証から除外するノードまたはキーと値の組み合わせのカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_tn5_cvj_bzb} ## 正しいホスト正規表現 (correctHostRegex) {#devops-config-gen-policies__section_usq_zgt_fvb} ホスト関連キーの形式をチェックして、ホスト名の使用が許可されていることを確認します。 スナップショット内の URL 値を持つキーが許可されたホストに指定された正規表現と一致しない場合、非準拠ステータスになります。 入力引数 : * authorizedHostRegex * URL 内のホストコンポーネントを検証するために使用される正規表現。 * 例： mydomain.com * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_ymx_zjd_nzb} * exceptionList * 比較から除外する URL 値を含むキーのカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_az3_k1y_bzb} {#devops-config-gen-policies__ul_ojs_rkt_nzb} ## 未使用変数の検出 (detectUnusedVariables) {#devops-config-gen-policies__d} 展開可能項目またはコレクションの vars フォルダーに、スナップショットで使用されていない変数が含まれているかどうかを確認します。 変数が宣言されているが、スナップショットで使用されていない場合、警告が表示されます。 ## 異なるキー名が同じ値 (differentKeyNamesSameValues) {#devops-config-gen-policies__section_zpc_qws_fvb} キーペアの値が同じかどうかを確認します。 指定したキーペアの値が同じでない場合、非準拠ステータスになります。 ユースケース:異なるキーの値が同じであることを確認することで、条件をよりきめ細かく制御します。 入力引数 : keyPairs * 同じ値を持つ必要があるキーペアのアレイ。キーペアは異なるキーを持つ必要があり、1 つのキー (`[key1`) または 2 つ以上のキー (`[key1=key2=key3]`) で構成することはできません。 * 例： ["key1=key3","key2=key4"] * タイプ:文字列のアレイ * Mandatory : True {#devops-config-gen-policies__ul_lb2_ycy_bzb} ## 異なる値ノードコンパレーター (differentValuesNodesComparator) {#devops-config-gen-policies__section_lsf_z1y_4sb} スナップショットの複数のコンポーネントにキーが存在する場合に、すべてのコンポーネントでキーの値が異なるかどうかを確認します。 キーが複数のコンポーネントで同じ値を持っている場合、非準拠ステータスになります。 注: 同じコンポーネント内でキーが複数存在する場合は、 [一意のキー値 (uniqueKeyValue)](https://servicenow-prod.fluidtopics.net/S4U7UAsD6G_tUu6AyCJT5A#devops-config-gen-policies__u) ポリシーを使用します。 入力引数 : keynameList * 第 1 レベルのノードに異なる値を指定するキー名のカンマ区切りリスト。 * 例： key1,key2 * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_mmd_52y_bzb} ## Docker イメージ形式検証ツール (dockerImageFormatValidator) {#devops-config-gen-policies__section_tjb_gk4_twb} サービスの Docker イメージが、入力で指定された正規表現に従っているかどうかを確認します。たとえば、Docker イメージのタグ付けとバージョニングがベストプラクティスに従っていることを確認するための正規表現値を指定します。 イメージ値が `imageExpectedRegex` 入力引数の正規表現入力値と一致しない場合、非準拠ステータスになります。 入力引数 : * imageExpectedRegex * Docker イメージの正規表現値。 画像のタグが英数字値であることを確認するための入力値の例: ^.*:([0-9]+.?)+([-_]{1}[A-Za-z0-9.]+)?$ * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_gjm_mg4_twb} * serviceExceptionList * 検証から除外されるサービスのカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_sqp_wg4_twb} {#devops-config-gen-policies__ul_fjm_mg4_twb} ## Docker イメージレジストリバリデーター (dockerImageRegistryValidator) {#devops-config-gen-policies__section_ytl_gk4_twb} Docker イメージのレジストリが、レジストリの許可リストに含まれているかどうかを確認します。 各サービスの Docker イメージを解析し、イメージ内のレジストリの値をフェッチしてから、取得したレジストリ値が authorizedRegistryList 入力に含まれているかどうかを確認します。 イメージレジストリーが authorizedRegistryList 入力にない場合、非準拠状況になります。 入力引数 : authorizedRegistryList * レジストリのコンマ区切りリスト。 例： k8s.example.io,gke.example.io,docker.example.com:8444 * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_wd2_gf4_twb} ## Docker ネットワークバリデーター (dockerNetworkValidator) {#devops-config-gen-policies__section_fpr_fk4_twb} Docker サービスのネットワークがネットワークセクションで定義されているかどうかを確認します。 サービスのネットワークが最上位のネットワークセクションで定義されていない場合、または labels/com.docker.lb.network プロパティで構成されたサービスのネットワークがサービスレベルセクションと最上位のネットワークセクションで定義されていない場合、非準拠ステータスになります。 ## 重複値 (duplicateValues) {#devops-config-gen-policies__section_wmg_wgk_dwb} スナップショット内の重複値をチェックします。 例外リストで定義された値を除き、スナップショットに重複キー値がある場合、非準拠ステータスになります。 ユースケース:スナップショットの値が異なることを確認することで、条件をよりきめ細かく制御します。 入力引数 : * includePath * 出力にノードの完全パスを含めるかどうかを示すブール値。 * デフォルト値：`True` * タイプ：True \| False * Mandatory : True {#devops-config-gen-policies__ul_y5y_dmv_hzb} * pathSeparator * ノードのパスセパレーターを示す文字列。 * デフォルト値: `/` * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_b1q_jmv_hzb} * exceptionList * 検証から除外する文字列のアレイ。 * デフォルト値: `["true", "false", "yes", "no", "enabled", "disabled"]` * タイプ:文字列のアレイ * 必須:false {#devops-config-gen-policies__ul_rjv_wlv_hzb} {#devops-config-gen-policies__ul_jzs_5kt_nzb} ## 禁止されているキーと値の組み合わせ (forbiddenKVcombinations) {#devops-config-gen-policies__f} スナップショットに禁止されているキーと値の組み合わせがあるかどうかを確認します。 スナップショットで見つかったキーの値が入力リストで指定されている禁止値である場合、非準拠ステータスになります。 入力引数 : forbiddenKV * 各キーの禁止値のリストを含むキーの JSON リスト。 * 例： { "username":"root,admin", "password":"qwerty123" } * タイプ：JSON * Mandatory : True {#devops-config-gen-policies__ul_mwb_j1v_hzb} ## ジェネリック リスト検証ツール (genericListValidator) {#devops-config-gen-policies__g} スナップショットのキー値を、入力に指定された値のリストと比較します。キー値は、文字列、カンマ区切りの文字列のリスト、文字列のアレイ、またはオブジェクトです。キー値がオブジェクトの場合、オブジェクトのキーが比較に使用されます。 ポリシーコンプライアンスの次の点に注意してください。 * operator が `IN` の場合、キー値内のすべての文字列が入力リストに含まれていれば、ポリシーは準拠しています。 * 演算子が `EQUALS` の場合、キー値内のすべての文字列が、入力リストに任意の順序でリストされているすべての文字列と一致すると、ポリシーは準拠しています。 * 演算子が `CONTAINS` の場合、キー値に入力リスト内のすべての文字列が含まれていると、ポリシーは準拠しています。 * 演算子が `NOT CONTAINS` の場合、キー値の文字列が入力リストに存在しなければ、ポリシーは準拠しています。 {#devops-config-gen-policies__ul_ngx_d5w_wwb} 入力引数 : * keysToValidateObject * 各オブジェクトにキーパス、演算子、および参照リストが含まれるオブジェクトのアレイ。 * 使用できる演算子は、`IN`、`CONTAINS`、`NOT CONTAINS``、および EQUALS` です。 * システムの /root/user パス で定義されているユーザーが `user1` または `user2` のいずれかであることを強制する入力値の例: [     {       keyPath: ["system", "root", "user"]        operator: "IN"       referenceList: [user1, user2]     } ] * デフォルト値: `[]` * タイプ:オブジェクトのアレイ * Mandatory : True {#devops-config-gen-policies__ul_rqg_4w4_3yb} * caseSensitive * リスト比較で大文字と小文字を区別するかどうかを示すブール値。 * デフォルト値：`True` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_k2l_y34_twb} {#devops-config-gen-policies__ul_ivb_434_twb} ## ジェネリックバリデーター (genericValidator) {#devops-config-gen-policies__section_q4s_pcy_4sb} 演算子と参照入力値に基づいて、キーの値が有効かどうかを確認します。 ポリシーコンプライアンスの次の点に注意してください。 * 演算子が `=` または `==` の場合、キー値が参照入力値と一致すると、ポリシーは準拠しています。 * 演算子が `<`の場合、キー値が参照入力値より小さいとポリシーは準拠しています。 * 演算子が `>`の場合、キー値が参照入力値より大きいとポリシーは準拠しています。 * 演算子が `<=` の場合、キー値が参照入力値以下であれば、ポリシーは準拠しています。 * 演算子が `>=` の場合、キー値が参照入力値以上であれば、ポリシーは準拠しています。 * 演算子が `!=` または `<>` の場合、キー値が参照入力値と一致しない場合、ポリシーは準拠しています。 * 演算子が `IN` の場合、キー値が参照入力リストに含まれていると、ポリシーは準拠しています。 * 演算子が `NOT IN` の場合、キー値が参照入力リストに含まれていないと、ポリシーは準拠しています。 * 演算子が `CONTAINS` の場合、キー値に参照入力値が含まれていると、ポリシーは準拠しています。 * 演算子が `NOT CONTAINS` の場合、キー値に参照入力値が含まれていなければ、ポリシーは準拠しています。 * 演算子が `REGEX` の場合、キー値が参照入力値で指定された正規表現パターンと一致すると、ポリシーは準拠しています。 {#devops-config-gen-policies__ul_fy4_pcv_hzb} 入力引数 : * keysToValidate * 各オブジェクトにキー、演算子、および参照値が含まれるオブジェクトのアレイ。 * 使用できる演算子は、`<`、`<=`、`>`、`>=`、`=` or `==`、`<>` or `!=`、`RANGE、``CONTAINS`、`NOT CONTAINS`、`IN、``NOT IN、`および `REGEX` です。 * 例： [ { "key": "webport-KO", "operator": "RANGE", "refValue": "8000-9000" }, { "key": "webport-OK", "operator": ">=", "refValue": 8000 }, { "key": "fqdn-OK", "operator": "REGEX", "refValue": ".francecentral.cloudapp.azure.com$" }, { "key": "trace_level-KO", "operator": "IN", "refValue": "INFO,ERROR,FATAL" }, { "key": "trace_level-KO", "operator": "NOT IN", "refValue": "DEBUG,VERBOSE" }, { "key": "trace-KO-ifcasesensitive", "operator": "CONTAINS", "refValue": "ERROR" } ] * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_znn_pbv_hzb} * caseSensitive * リスト比較で大文字と小文字を区別するかどうかを示すブール値。 * デフォルト値：`True` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_a4n_pbv_hzb} {#devops-config-gen-policies__ul_ynn_pbv_hzb} ## キー存在コンパレーター (keyExistenceComparator) {#devops-config-gen-policies__k} メイン展開可能項目のすべてのキーが、入力に指定された追加の展開可能項目にも存在するかどうかを確認します。 キーがメイン展開可能項目には存在するが、追加の展開可能項目には存在しない場合、非準拠ステータスになります。 ユースケース:環境変数を比較し、整合性があることを確認します。 入力引数 : * additionalDeployablesInput * メイン展開可能項目と比較される追加の展開可能項目のリスト。 * タイプ:リスト * Mandatory : True {#devops-config-gen-policies__ul_kky_l2v_hzb} * includeNodes * 比較中に展開可能項目の子ノードを含めるかどうかを示すブール値。 * デフォルト値：`False` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_mky_l2v_hzb} * caseSensitive * キー比較で大文字と小文字を区別するかどうかを示すブール値。 * デフォルト値：`False` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_ymz_y2v_hzb} * exceptionList * 比較時に無視する必要があるキー名のカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_lky_l2v_hzb} {#devops-config-gen-policies__ul_uz2_vgt_nzb} ## キーの命名規則 (keyNamingConvention) {#devops-config-gen-policies__section_bpp_bgt_fvb} キー名が指定された命名パターンに従っているかどうかを確認します。 キーが入力引数で指定されたプレフィックスとサフィックスの名前付けパターンに従わない場合、非準拠ステータスになります。 入力引数 : * maxLength * キー名の最大長を示す整数値。 * タイプ：整数 * 必須:false {#devops-config-gen-policies__ul_q4x_15n_lzb} * approvedPrefixArray * キー名の承認されたプリフィックスを示す文字列のアレイ。 * タイプ:文字列のアレイ * 必須:false {#devops-config-gen-policies__ul_ot2_2zc_gvb} * includePath * 出力にノードの完全パスを含めるかどうかを示すブール値。 * デフォルト値：`True` * タイプ：True \| False * Mandatory : True {#devops-config-gen-policies__ul_dml_zrl_lzb} * approvedSuffixArray * キー名の承認されたサフィックスを示す文字列のアレイ。 * タイプ:文字列のアレイ * 必須:false {#devops-config-gen-policies__ul_jlb_vwn_lzb} * exceptionList * 検証から除外するキーのカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_d3y_xwn_lzb} {#devops-config-gen-policies__ul_rvk_bxn_lzb} ## キーパス検証ツール (keyPathValidator) {#devops-config-gen-policies__section_izt_jgt_fvb} 指定されたキーパスのキーがスナップショットで見つかるかどうかを確認し、見つかった場合、キーの値は演算子の値と参照入力値に基づいて有効です。 指定されたキーパスのキーに無効な値がある場合、非準拠ステータスになります。さらに、 `入力引数 ignoreIfNotFound` が `False` の場合、入力引数で指定されたキー パスがスナップショットで見つからないと、非準拠ステータスになります。 入力引数 : * pathAndDesiredValues * キーのセットと、キーに必要な条件と値のマッピングを含む JSON オブジェクト。 * 例： { "release-1.0/paymentService-V1.0/integerValues": ["<","3"], "release-1.0/paymentService-V1.0/database/dbPort": [">","8000"] } * タイプ：JSON * Mandatory : True {#devops-config-gen-policies__ul_zp5_2xn_lzb} * pathSeparator * ノードのパスセパレーターを示す文字列。 * デフォルト値: `/` * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_edh_h5l_lzb} * ignoreIfNotFound * 指定されたキーパスのキーがスナップショットに存在するかどうかを示すブール値。 * デフォルト値：`True` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_t5v_hxn_lzb} {#devops-config-gen-policies__ul_chb_vzc_gvb} ## キー値のサブ文字列チェック (keyValueSubstringCheck) {#devops-config-gen-policies__section_adz_wlk_dwb} 指定されたキー名のスナップショット値で指定されたサブ文字列をチェックします。 キー名の値に入力引数で指定された部分文字列が含まれていない場合、非準拠ステータスになります。 入力引数 : keyNameWithKeyValues * キー名、サブ文字列、キー値のサブ文字列のペアを含む、必須のサブ文字列セットを含む JSON オブジェクト。 * 例： { "live": "2022" "environment": "aws" } * タイプ：JSON * Mandatory : True {#devops-config-gen-policies__ul_xgr_k5n_lzb} ## リストコンパレーター (listComparator) {#devops-config-gen-policies__l} 2 つのキーの値のリストを比較して、2 つのキーに同じ値があるかどうかを確認します。比較では大文字と小文字は区別されません。 最初のキーのすべての値リストが、2 番目のキーに任意の順序でリストされているすべての値と一致すると、非準拠ステータスになります。 入力引数 : * list1Node * プライマリノードのキー名。 * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_mwh_mxn_lzb} * list2Node * プライマリノードと比較されるノードのキー名。 * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_ifm_4xn_lzb} {#devops-config-gen-policies__ul_fm1_rkt_fvb} ## 必須キー (mandatoryKeys) {#devops-config-gen-policies__m} 入力で指定されたキー名のリストがスナップショットに存在するかどうかを確認します。 指定されたキー名がスナップショットに存在しない場合、非準拠ステータスになります。 入力引数 : * mandatoryKeys * キー名のカンマ区切りリスト。 * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_yxm_dld_nzb} * caseSensitive * キー比較で大文字と小文字を区別するかどうかを示すブール値。 * デフォルト値：`False` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_vkr_gld_nzb} {#devops-config-gen-policies__ul_a4y_rpd_nzb} ## メモリ制限バリデーター (memoryLimitValidator) {#devops-config-gen-policies__section_gnq_hk4_twb} キー値に割り当てられたメモリリソースが、メモリユニットの指定された制限内にあるかどうかを確認します。 メトリクス単位 (KB、MB、GB など) とバイナリ単位 (KiB、MiB、GiB など) の大文字と小文字を区別しないキー値を比較します。比較する前に、キー値とその入力値をバイトに変換します。 キー値が指定された制限内にない場合、またはキー値がメモリ単位でない場合は、非準拠ステータスになります。 入力引数 : pathAndLimitsArray * キーパスと、メモリユニット制限の最小値と最大値 (最小値と最大値) のアレイ。 * タイプ:オブジェクトのアレイ * Mandatory : True {#devops-config-gen-policies__ul_mfw_qhk_wwb} 例： [     {     keyPath: ["deploy", "resources", "limits", "cpu"],     min: "250m",     max: "500m"     },     {     keyPath: ["deploy", "resources", "limits", "cpu"],     min: "1GB",     max: "8GB"     } ] ## 必須タグリスト (mandatoryTagsList) {#devops-config-gen-policies__section_h5c_42q_wqb} スナップショットで見つかったタグノードに許可された値があるかどうかを確認します。 タグノードに許可されたタグリストに含まれていない値がある場合、非準拠ステータスになります。 入力引数 : * tagsNodeName * キー名のカンマ区切りリスト。 * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_krj_tld_nzb} * tagsList * 許可されたタグ値のカンマ区切りリスト。 * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_l1h_ypd_nzb} * caseSensitive * キー比較で大文字と小文字を区別するかどうかを示すブール値。 * デフォルト値：`False` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_clj_vld_nzb} {#devops-config-gen-policies__ul_jrj_tld_nzb} ## 必須の値 (mandatoryValue) {#devops-config-gen-policies__section_b24_s2q_wqb} 入力として指定されたすべてのキーが空でない値を持つかどうかを確認します。 キーの値が null または空の場合は非準拠ステータスになり、入力で指定されたキー名がスナップショットに見つからない場合は警告が表示されます。 入力引数 : * keysList * キー名のカンマ区切りリスト。 * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_u34_lmd_nzb} * stopAtFirstFound * スナップショット内で最初に出現したキー値のみをチェックするかどうかを示すブール値。 * デフォルト値：`True` * タイプ：True \| False * Mandatory : True {#devops-config-gen-policies__ul_zyc_mmd_nzb} * trimValue * 比較する前にキー値の先頭または末尾のスペースを削除するかどうかを示すブール値。 * デフォルト値：`True` * タイプ：True \| False * Mandatory : True {#devops-config-gen-policies__ul_lqs_vmd_nzb} * caseSensitive * キー比較で大文字と小文字を区別するかどうかを示すブール値。 * デフォルト値：`False` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_cxr_1nd_nzb} {#devops-config-gen-policies__ul_kj5_kmd_nzb} ## タイプ別の必須値 (mandatoryValueByType) {#devops-config-gen-policies__section_emy_y2q_wqb} 入力として指定されたすべてのキーが空でない値を持つかどうかを確認します。 次の条件では、非準拠ステータスになります。 * `keyNamesString` 入力引数に指定されたキーの値が文字列値でないか、空の場合。 * `keyNamesInteger` 入力引数に指定されたキーの値が整数値でないか、空の場合。 * `keyNamesBoolean` 入力引数に指定されたキーの値がブール値でないか、空の場合。 {#devops-config-gen-policies__ul_g5y_g4d_nzb} 入力引数 : * keyNamesString * 文字列値を持つ必要があるキー名のカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_ocr_lqd_nzb} * keyNamesInteger * 整数値を持つ必要があるキー名のカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_jvd_mqd_nzb} * keyNamesBoolean * ブール値を持つ必要があるキー名のカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_rzp_nnd_nzb} {#devops-config-gen-policies__ul_qzp_nnd_nzb} ## 明確な機密データがありません (noClearSensitiveData) {#devops-config-gen-policies__n} 指定したキーワードを含むキー名の値が暗号化されているかどうかを確認します。 指定されたキーワードを含むキー名が暗号化されていない場合、非準拠ステータスになります。 ユースケース: DevOps コンフィグ は、権限ベースのアクセス制御を通じて機密データ (パスワード、API キー、トークン) を管理および統制するために組織によって使用されます。 入力引数 : * keyWords * スナップショット内の機密キーを識別するために使用される文字列のカンマ区切りリスト。このポリシーでは、大文字と小文字を区別しない比較が使用されます。 * デフォルト値: `pass,pwd,secret` * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_xrm_xnl_nzb} * exceptionList * 検証から除外するキーのカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_nmr_ght_nzb} {#devops-config-gen-policies__ul_gsw_lfq_wqb} ## 重複キーなし (noDuplicateKeys) {#devops-config-gen-policies__section_c25_4fq_wqb} スナップショットに重複するキー名がないかどうかを確認します。 スナップショット内でキー名が複数回出現する場合、非準拠ステータスになります。 ユースケース:デプロイ自動化ツールは、サービスのダウンタイムの原因となる設定の複数回のオカレンスを不適切に処理できます。 入力引数 : keyNames * キー名のカンマ区切りリスト。 * デフォルト値: `dbConnectionString,dbUserName` * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_y4n_fpl_nzb} ## 空の値なし (noEmptyValues) {#devops-config-gen-policies__section_n35_5fq_wqb} すべてのキーの値が空でないかどうかを確認します。 例外リストに含まれていないキーの値が null または空の場合、非準拠ステータスになります。 入力引数 : * trimValue * 比較する前にキー値の先頭または末尾のスペースを削除するかどうかを示すブール値。 * デフォルト値：`True` * タイプ：True \| False * Mandatory : True {#devops-config-gen-policies__ul_fcr_spl_nzb} * caseSensitive * キー比較で大文字と小文字を区別するかどうかを示すブール値。 * デフォルト値：`False` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_gcr_spl_nzb} * exceptionList * 検証から除外するキーのカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_og5_v1m_nzb} {#devops-config-gen-policies__ul_ccr_spl_nzb} ## 禁止値なし (noForbiddenValues) {#devops-config-gen-policies__section_z3g_zfq_wqb} スナップショットに禁止値を含むキー名があるかどうかを確認します。 スナップショットで見つかったキーの値が入力リストで指定されている禁止値である場合、非準拠ステータスになります。 入力引数 : * forbiddenValues * 禁止値をカンマで区切ったリスト。 * デフォルト値: `root` * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_usr_x1m_nzb} * excludedKeyNames * 検証から除外するキーのカンマ区切りリスト。 * デフォルト値: `name,*desc*` * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_wc5_y1m_nzb} {#devops-config-gen-policies__ul_b3b_x1m_nzb} ## FTP なし (noFTP) {#devops-config-gen-policies__section_nxx_jgq_wqb} スナップショット内のすべての URL が FTPS プロトコルを使用しているかどうかを確認します。 スナップショット内の URL に FTP が含まれている場合は、非準拠ステータスになります。 入力引数 : * searchValue * キー値に存在してはならない検索用語。 * デフォルト値: `FTTP:/` * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_ihg_mrl_nzb} * caseSensitive * キー比較で大文字と小文字を区別するかどうかを示すブール値。 * デフォルト値：`False` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_wqh_ksl_nzb} * exceptionList * 検証から除外するキーのカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_grv_1bm_nzb} {#devops-config-gen-policies__ul_anv_mgq_wqb} ## HTTPなし(noHTTP) {#devops-config-gen-policies__section_zth_cbm_nzb} スナップショット内のすべての URL が HTTPS プロトコルを使用しているかどうかを確認します。 スナップショットに URL に HTTP が含まれている場合、非準拠ステータスになります。 入力引数 : * searchValue * キー値に存在してはならない検索用語。 * デフォルト値: `HTTP:/` * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_b5h_cbm_nzb} * caseSensitive * キー比較で大文字と小文字を区別するかどうかを示すブール値。 * デフォルト値：`False` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_c5h_cbm_nzb} * exceptionList * 検証から除外するキーのカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_d5h_cbm_nzb} {#devops-config-gen-policies__ul_a5h_cbm_nzb} ## ノードキーコンパレーター (nodeKeysComparator) {#devops-config-gen-policies__section_osk_rht_fvb} プライマリノードのすべてのキーがセカンダリノードで同じかどうかを確認します。 キーがプライマリノードには存在するがセカンダリノードには存在しない場合、またはその逆の場合、非準拠ステータスになります。 入力引数 : * fromNode * スナップショット内のプライマリノードのパスを示す文字列のアレイ。 * デフォルト値: `[]` * タイプ:文字列のアレイ * Mandatory : True {#devops-config-gen-policies__ul_bn3_rtl_nzb} * toNode * スナップショット内のセカンダリノードのパスを示す文字列のアレイ。 * デフォルト値: `[]` * タイプ:文字列のアレイ * Mandatory : True {#devops-config-gen-policies__ul_z25_zcm_nzb} * includePath * 出力にノードの完全パスを含めるかどうかを示すブール値。 * デフォルト値：`True` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_cx4_1dm_nzb} {#devops-config-gen-policies__ul_xwy_g1d_gvb} ## LDAP なし (noLDAP) {#devops-config-gen-policies__section_nlk_cbm_nzb} スナップショット内のすべての URL が LDAPS プロトコルを使用しているかどうかを確認します。 スナップショットに URL に LDAP が含まれている場合、非準拠ステータスになります。 入力引数 : * searchValue * キー値に存在してはならない検索用語。 * デフォルト値: `LDAP:/` * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_plk_cbm_nzb} * caseSensitive * キー比較で大文字と小文字を区別するかどうかを示すブール値。 * デフォルト値：`False` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_qlk_cbm_nzb} * exceptionList * 検証から除外するキーのカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_rlk_cbm_nzb} {#devops-config-gen-policies__ul_olk_cbm_nzb} ## ノード値コンパレーター (nodesValueComparator) {#devops-config-gen-policies__section_kcb_tgt_fvb} スナップショット内の 2 つのノード間のすべてのキーと値の組み合わせを比較します。 次の条件では、非準拠ステータスになります。 * `sameValueKeys` 入力引数で指定されたキーが 2 つのノードで異なる値を持つ場合。 * `diffValueKeys` 入力引数に指定されたキーが 2 つのノードで同じ値を持つ場合。 * `allowMissingKeys` 入力引数が `False` に設定されていて、キーがプライマリノードに存在するがセカンダリノードには存在しない場合、またはその逆の場合。 {#devops-config-gen-policies__ul_nkm_ddm_nzb} ユースケース:2 つのノード間でキーの値を比較することで、ノード間の一貫性を確保します。 入力引数 : * fromNode * スナップショット内のプライマリノードのパスを示す文字列のアレイ。 * デフォルト値: `[]` * タイプ:文字列のアレイ * Mandatory : True {#devops-config-gen-policies__ul_fwt_b5l_nzb} * toNode * スナップショット内のセカンダリノードのパスを示す文字列のアレイ。 * デフォルト値: `[]` * タイプ:文字列のアレイ * Mandatory : True {#devops-config-gen-policies__ul_ymg_4dm_nzb} * includePath * 出力にノードの完全パスを含めるかどうかを示すブール値。 * デフォルト値：`True` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_z2x_4dm_nzb} * sameValueKeys * 同じ値を持つキー名のカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_q5d_dvl_nzb} * diffValueKeys * 異なる値を持つキー名のカンマ区切りリスト。 * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_mf4_rdm_nzb} * allowMissingKeys * プライマリノードのすべてのキーがセカンダリノードで同じであることを確認するかどうかを示すブール値。 * デフォルト値：`False` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_kpk_sdm_nzb} {#devops-config-gen-policies__ul_ewt_b5l_nzb} ## 空白文字は使用できません (noWhiteSpaceAllowed) {#devops-config-gen-policies__section_vbv_rgq_wqb} キー値に、先頭と末尾のスペースを含む空白文字が含まれていないかどうかを確認します。 キー値に空白文字が含まれている場合、非準拠ステータスになります。 ユースケース:設定が適用されるときに、空白文字によってツールやアプリケーションに問題が発生しないようにします。 入力引数 : excludedKeyNames * 検証から除外するキーのカンマ区切りリスト。 * デフォルト値: `説明` * タイプ：文字列 * 必須:false {#devops-config-gen-policies__ul_osl_vcm_nzb} ## 同じキー値 (sameKeyValue) {#devops-config-gen-policies__s} スナップショットの複数のコンポーネントにキーの値が含まれている場合に、すべてのコンポーネントで同じかどうかを確認します。 キーが複数のコンポーネントで異なる値を持っている場合、非準拠ステータスになります。 入力引数 : keyList * キー名のカンマ区切りリスト * Mandatory : True * タイプ：文字列 {#devops-config-gen-policies__ul_xhx_s24_twb} ## 同じ値のコンパレーター (sameValuesComparator) {#devops-config-gen-policies__section_nsf_wgq_wqb} `keyList` 入力引数として指定されたすべてのキーが展開可能項目全体で同じ値を持つかどうかを確認します。 キーの値が複数の展開可能項目で異なる場合は非準拠ステータスになり、入力で指定されたキー名がどの展開可能項目でも見つからない場合は警告が表示されます。 ユースケース:ステージング環境と本番環境間の構成のずれを検出します。 入力引数 : * additionalDeployablesInput * メイン展開可能項目と比較される追加の展開可能項目のリスト。 * タイプ:リスト * Mandatory : True {#devops-config-gen-policies__ul_m2g_sxl_nzb} * keysList * キー名のカンマ区切りリスト。 * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_r4h_mxl_nzb} * stopAtFirstFound * スナップショット内で最初に出現したキー値のみをチェックするかどうかを示すブール値。 * デフォルト値：`True` * タイプ：True \| False * Mandatory : True {#devops-config-gen-policies__ul_s4h_mxl_nzb} * caseSensitive * キー比較で大文字と小文字を区別するかどうかを示すブール値。 * デフォルト値：`True` * タイプ：True \| False * 必須:false {#devops-config-gen-policies__ul_u4h_mxl_nzb} {#devops-config-gen-policies__ul_q4h_mxl_nzb} ## 一意のキー値 (uniqueKeyValue) {#devops-config-gen-policies__u} スナップショット内でキーに複数のオカレンスがある場合に、キーのキー値が異なるかどうかを確認します。 キーが複数回同じ値を持つ場合、非準拠ステータスになります。 入力引数 : keyList * キー名のカンマ区切りリスト。 * Mandatory : True * タイプ：文字列 {#devops-config-gen-policies__ul_xmx_124_twb} ## 展開可能項目全体で一意の値 (checkUniqueKeyValue_crossDeployables) {#devops-config-gen-policies__section_y2h_lcv_twb} `keyName` 入力引数として指定されたすべてのキーの値が展開可能項目全体で異なるかどうかを確認します。 キーの値が複数の展開可能項目で同じ場合は非準拠ステータスになり、入力で指定されたキー名がどの展開可能項目でも見つからない場合は警告が表示されます。 ユースケース:ステージング環境と本番環境間の構成のずれを検出します。 入力引数 : * additionalDeployablesInput * メイン展開可能項目と比較される追加の展開可能項目のリスト。 * タイプ:リスト * Mandatory : True {#devops-config-gen-policies__ul_ipb_wyl_nzb} * keyName * キー名のカンマ区切りリスト。 * タイプ：文字列 * Mandatory : True {#devops-config-gen-policies__ul_jpb_wyl_nzb} {#devops-config-gen-policies__ul_hpb_wyl_nzb} ## 未解決の変数 (unresolvedVariables) {#devops-config-gen-policies__section_bcp_bhq_wqb} スナップショットに未解決の変数があるかどうかを確認します。 キー値で使用される変数を解決できない場合、非準拠ステータスになります。 ユースケース:未解決の変数があると展開操作が中断される可能性があるため、構成データ設定で使用されるすべての変数が値に置き換えられていることを確認します。