github.com/khulnasoft-lab/defsec@v1.0.5-0.20230827010352-5e9f46893d95/rules/cloud/policies/aws/sam/api_use_secure_tls_policy.go (about)

     1  package sam
     2  
     3  import (
     4  	"github.com/khulnasoft-lab/defsec/internal/rules"
     5  	"github.com/khulnasoft-lab/defsec/pkg/providers"
     6  	"github.com/khulnasoft-lab/defsec/pkg/scan"
     7  	"github.com/khulnasoft-lab/defsec/pkg/severity"
     8  	"github.com/khulnasoft-lab/defsec/pkg/state"
     9  )
    10  
    11  var CheckApiUseSecureTlsPolicy = rules.Register(
    12  	scan.Rule{
    13  		AVDID:       "AVD-AWS-0112",
    14  		Provider:    providers.AWSProvider,
    15  		Service:     "sam",
    16  		ShortCode:   "api-use-secure-tls-policy",
    17  		Summary:     "SAM API domain name uses outdated SSL/TLS protocols.",
    18  		Impact:      "Outdated SSL policies increase exposure to known vulnerabilities",
    19  		Resolution:  "Use the most modern TLS/SSL policies available",
    20  		Explanation: `You should not use outdated/insecure TLS versions for encryption. You should be using TLS v1.2+.`,
    21  		Links: []string{
    22  			"https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-property-api-domainconfiguration.html#sam-api-domainconfiguration-securitypolicy",
    23  		},
    24  		CloudFormation: &scan.EngineMetadata{
    25  			GoodExamples:        cloudFormationApiUseSecureTlsPolicyGoodExamples,
    26  			BadExamples:         cloudFormationApiUseSecureTlsPolicyBadExamples,
    27  			Links:               cloudFormationApiUseSecureTlsPolicyLinks,
    28  			RemediationMarkdown: cloudFormationApiUseSecureTlsPolicyRemediationMarkdown,
    29  		},
    30  		Severity: severity.High,
    31  	},
    32  	func(s *state.State) (results scan.Results) {
    33  		for _, api := range s.AWS.SAM.APIs {
    34  			if api.DomainConfiguration.SecurityPolicy.NotEqualTo("TLS_1_2") {
    35  				results.Add(
    36  					"Domain name is configured with an outdated TLS policy.",
    37  					api.DomainConfiguration.SecurityPolicy,
    38  				)
    39  			} else {
    40  				results.AddPassed(&api)
    41  			}
    42  		}
    43  		return
    44  	},
    45  )