ルールで AWS CloudFormation Guard の入力パラメータの使用 - AWS CloudFormation Guard
の使用方法使用例複数の入力パラメータ

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ルールで AWS CloudFormation Guard の入力パラメータの使用

AWS CloudFormation Guard では、検証中に動的データルックアップの入力パラメータを使用できます。この機能は、ルールで外部データを参照する必要がある場合に特に便利です。ただし、入力パラメータキーを指定する場合、Guard は競合するパスがないことを要求します。

の使用方法

  1. --input-parameters または -iフラグを使用して、入力パラメータを含むファイルを指定します。複数の入力パラメータファイルを指定でき、組み合わせて共通のコンテキストを形成します。入力パラメータキーに競合するパスを含めることはできません。

  2. --data または -dフラグを使用して、検証する実際のテンプレートファイルを指定します。

使用例

  1. 入力パラメータファイルを作成します (例: network.yaml）。

    NETWORK:
  allowed_security_groups: ["sg-282850", "sg-292040"]
  allowed_prefix_lists: ["pl-63a5400a", "pl-02cd2c6b"]

  2. ガードルールファイルでこれらのパラメータを参照します (例: security_groups.guard）。

    let groups = Resources.*[ Type == 'AWS::EC2::SecurityGroup' ]

let permitted_sgs = NETWORK.allowed_security_groups
let permitted_pls = NETWORK.allowed_prefix_lists
rule check_permitted_security_groups_or_prefix_lists(groups) {
    %groups {
        this in %permitted_sgs or
        this in %permitted_pls
    }
}

rule CHECK_PERMITTED_GROUPS when %groups !empty {
    check_permitted_security_groups_or_prefix_lists(
       %groups.Properties.GroupName
    )
}

  3. 失敗したデータテンプレートを作成します (例: security_groups_fail.yaml）。

    # ---
# AWSTemplateFormatVersion: 2010-09-09
# Description: CloudFormation - EC2 Security Group

Resources:
  mySecurityGroup:
    Type: AWS::EC2::SecurityGroup
    Properties:
      GroupName: wrong

  4. validate コマンドを実行します。

    cfn-guard validate -r security_groups.guard -i network.yaml -d security_groups_fail.yaml

    このコマンドで:

    • -r はルールファイルを指定します。

    • -i は入力パラメータファイルを指定します。

    • -d は、検証するデータファイル (テンプレート) を指定します。

複数の入力パラメータ

複数の入力パラメータファイルを指定できます。

cfn-guard validate -r rules.guard -i params1.yaml -i params2.yaml -d template.yaml

で指定されたすべてのファイルは結合され、パラメータルックアップの単一のコンテキストを形成し-iます。