# ################################### ## Rule Specification ## ##################################### # # Rule Identifier: # elb_predefined_security_policy_ssl_check # # Description: # This control checks whether ELB classic load balancer HTTPS/SSL listeners use the predefined security policy 'ELBSecurityPolicy-TLS-1-2-2017-01'. # # Reports on: # AWS::ElasticLoadBalancing::LoadBalancer # # Evaluates: # AWS CloudFormation, AWS CloudFormation hook # # Rule Parameters: # None # # Scenarios: # Scenario: 1 # Given: The input document is an AWS CloudFormation or CloudFormation hook document # And: The input document does not contain any ElasticLoadBalancing LoadBalancer resources # Then: SKIP # Scenario: 2 # Given: The input document is an AWS CloudFormation or CloudFormation hook document # And: The input document contains an ElasticLoadBalancing LoadBalancer resource # And: There are no HTTPS or SSL 'Listeners' configured on the ElasticLoadBalancing LoadBalancer resource # Then: SKIP # Scenario: 3 # Given: The input document is an AWS CloudFormation or CloudFormation hook document # And: The input document contains an ElasticLoadBalancing LoadBalancer resource # And: 'Policies' does not contain a policy with 'PolicyType' equal to 'SSLNegotiationPolicyType' # Then: FAIL # Scenario: 4 # Given: The input document is an AWS CloudFormation or CloudFormation hook document # And: The input document contains an ElasticLoadBalancing LoadBalancer resource # And: 'Policies' contains a policy with 'PolicyType' equal to 'SSLNegotiationPolicyType' # And: 'Policies' is missing a 'Reference-Security-Policy' with a value of # 'ELBSecurityPolicy-TLS-1-2-2017-01' # Then: FAIL # Scenario: 5 # Given: The input document is an AWS CloudFormation or CloudFormation hook document # And: The input document contains an ElasticLoadBalancing LoadBalancer resource # And: 'Policies' contains a policy with 'PolicyType' equal to 'SSLNegotiationPolicyType' # And: 'Policies' contains a 'Reference-Security-Policy' with a value of # 'ELBSecurityPolicy-TLS-1-2-2017-01' # And: A 'HTTPS' or 'SSL' Listener on the LoadBalancer resource does not reference the secure policy # Then: FAIL # Scenario: 6 # Given: The input document is an AWS CloudFormation or CloudFormation hook document # And: The input document contains an ElasticLoadBalancing LoadBalancer resource # And: 'Policies' contains a policy with 'PolicyType' equal to 'SSLNegotiationPolicyType' # And: 'Policies' contains a 'Reference-Security-Policy' with a value of # 'ELBSecurityPolicy-TLS-1-2-2017-01' # And: All 'HTTPS' and 'SSL' Listeners on the LoadBalancer resource reference the secure policy # Then: PASS # # Constants # let ELASTIC_LOAD_BALANCER_TYPE = "AWS::ElasticLoadBalancing::LoadBalancer" let VALID_REFERENCE_SECURITY_POLICIES = [ "ELBSecurityPolicy-TLS-1-2-2017-01" ] let INPUT_DOCUMENT = this # # Assignments # let classic_load_balancers = Resources.*[ Type == %ELASTIC_LOAD_BALANCER_TYPE ] # # Primary Rules # rule elb_predefined_security_policy_ssl_check when is_cfn_template(%INPUT_DOCUMENT) %classic_load_balancers not empty { check(%classic_load_balancers.Properties) << [CT.ELASTICLOADBALANCING.PR.12]: Require any ELB classic load balancer SSL/HTTPS listener to have a predefined security policy with a strong configuration [FIX]: Configure classic load balancer HTTPS/SSL listeners to use the predefined security policy called ELBSecurityPolicy-TLS-1-2-2017-01. >> } rule elb_predefined_security_policy_ssl_check when is_cfn_hook(%INPUT_DOCUMENT, %ELASTIC_LOAD_BALANCER_TYPE) { check(%INPUT_DOCUMENT.%ELASTIC_LOAD_BALANCER_TYPE.resourceProperties) << [CT.ELASTICLOADBALANCING.PR.12]: Require any ELB classic load balancer SSL/HTTPS listener to have a predefined security policy with a strong configuration [FIX]: Configure classic load balancer HTTPS/SSL listeners to use the predefined security policy called ELBSecurityPolicy-TLS-1-2-2017-01. >> } # # Parameterized Rules # rule check(classic_load_balancer) { %classic_load_balancer { let elb = this # Scenario 2 Listeners[ Protocol in ["HTTPS", "SSL"] ] { %elb.Policies exists %elb.Policies is_list %elb.Policies not empty let secure_policies = %elb.Policies[ PolicyType == "SSLNegotiationPolicyType" some Attributes[*] { Name == "Reference-Security-Policy" Value in %VALID_REFERENCE_SECURITY_POLICIES } ].PolicyName # Scenarios 3 and 4 %secure_policies not empty # Scenarios 5 and 6 PolicyNames exists PolicyNames is_list PolicyNames not empty some PolicyNames.* in %secure_policies } } } # # Utility Rules # rule is_cfn_template(doc) { %doc { AWSTemplateFormatVersion exists or Resources exists } } rule is_cfn_hook(doc, RESOURCE_TYPE) { %doc.%RESOURCE_TYPE.resourceProperties exists }