aws_waf_xss_match_sets resource

Use the aws_waf_xss_match_sets InSpec audit resource to test the properties of multiple AWS WAF XssMatchSet objects.

For additional information, including details on parameters and properties, see the AWS documentation on the AWS::WAF::XssMatchSet resource.

Install

This resource is available in the Chef InSpec AWS resource pack.

For information on configuring your AWS environment for Chef InSpec and creating an InSpec profile that uses the InSpec AWS resource pack, see the Chef InSpec documentation on the AWS cloud platform.

Ensure that any XssMatchSet object exists.

describe aws_waf_xss_match_sets do
  it { should exist }
end

This resource does not require any parameters.

xss_match_set_ids: A unique identifier for an XssMatchSet.; Field: xss_match_set_id
names: The name of the XssMatchSet.; Field: name

Verify an XssMatchSet object is available by ID.

describe aws_waf_xss_match_sets do
  its('xss_match_set_ids') { should include 'XSS_MATCH_SET_ID' }
end

Verify an XssMatchSet object name is available.

describe aws_waf_xss_match_sets do
    its('names') { should include 'XSS_MATCH_SET_NAME' }
end

For a full list of available matchers, see our Universal Matchers page.

The controls will pass if the list method returns at least one result.

Use should to test that the entity exists.

describe aws_waf_xss_match_sets do
  it { should exist }
end

Use should_not to test the entity does not exist.

describe aws_waf_xss_match_sets do
  it { should_not exist }
end

Your Principal will need the WAF:Client:ListXssMatchSetsResponse action with Effect set to Allow.