additional_server_functions |
Default configutation for all additional server functions with the ability to override the configuration per function.
This feature requires open next v3.
By default, the module will create a new zip from the server function code on disk. However, you can override this by supplying a zip file containing the lambda code with either a local reference or a reference to the zip in an S3 bucket.
Possible values for backend_deployment_type: - REGIONAL_LAMBDA_WITH_AUTH_LAMBDA - REGIONAL_LAMBDA_WITH_OAC - REGIONAL_LAMBDA_WITH_OAC_AND_ANY_PRINCIPAL - REGIONAL_LAMBDA
See https://github.com/RJPearson94/terraform-aws-open-next/blob/v3.0.3/docs/backend-server-deployments.md for a complete breakdown of the different backend options.
NOTE: This can be overridden for each zone |
object({ enable_streaming = optional(bool) runtime = optional(string, "nodejs20.x") backend_deployment_type = optional(string, "REGIONAL_LAMBDA") timeout = optional(number, 10) memory_size = optional(number, 1024) function_architecture = optional(string) additional_environment_variables = optional(map(string), {}) iam_policies = optional(object({ include_bucket_access = optional(bool, false) include_revalidation_queue_access = optional(bool, false) include_tag_mapping_db_access = optional(bool, false) }), {}) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) vpc = optional(object({ security_group_ids = list(string), subnet_ids = list(string) })) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) logging_config = optional(object({ log_format = optional(string) application_log_level = optional(string) system_log_level = optional(string) })) cloudwatch_log = optional(object({ deployment = optional(string) retention_in_days = optional(number) name = optional(string) log_group_class = optional(string) skip_destroy = optional(bool) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) function_overrides = optional(map(object({ function_code = optional(object({ handler = optional(string, "index.handler") zip = optional(object({ path = string hash = string })) s3 = optional(object({ bucket = string key = string object_version = optional(string) })) })) enable_streaming = optional(bool) runtime = optional(string, "nodejs20.x") backend_deployment_type = optional(string, "REGIONAL_LAMBDA") timeout = optional(number, 10) memory_size = optional(number, 1024) function_architecture = optional(string) additional_environment_variables = optional(map(string), {}) iam_policies = optional(object({ include_bucket_access = optional(bool, false) include_revalidation_queue_access = optional(bool, false) include_tag_mapping_db_access = optional(bool, false) }), {}) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) vpc = optional(object({ security_group_ids = list(string), subnet_ids = list(string) })) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) logging_config = optional(object({ log_format = optional(string) application_log_level = optional(string) system_log_level = optional(string) })) cloudwatch_log = optional(object({ deployment = optional(string) retention_in_days = optional(number) name = optional(string) log_group_class = optional(string) skip_destroy = optional(bool) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) })), {}) }) |
{} |
no |
aliases |
The production and staging aliases to use. This can be overridden for each zone |
object({ production = string staging = string }) |
null |
no |
behaviours |
Override the default behaviour config. When the deployment is set to 'INDEPENDENT_ZONES' this can be overridden for each zone. If deployment is 'SHARED_DISTRIBUTION' or 'SHARED_DISTRIBUTION_AND_BUCKET' this configuration is used |
object({ custom_error_responses = optional(object({ path_overrides = optional(map(object({ allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ arn = string include_body = bool })) origin_response = optional(object({ arn = string })) }))) allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ type = string arn = string include_body = optional(bool) })) origin_response = optional(object({ type = string arn = string })) })) static_assets = optional(object({ paths = optional(list(string)) additional_paths = optional(list(string)) path_overrides = optional(map(object({ allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ arn = string include_body = bool })) origin_response = optional(object({ arn = string })) }))) allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ type = string arn = string include_body = optional(bool) })) origin_response = optional(object({ type = string arn = string })) })) server = optional(object({ paths = optional(list(string)) path_overrides = map(object({ allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ arn = string include_body = bool })) origin_response = optional(object({ arn = string })) })) allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ type = string arn = string include_body = optional(bool) })) origin_response = optional(object({ type = string arn = string })) })) additional_origins = optional(map(object({ paths = optional(list(string)) path_overrides = optional(map(object({ allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ arn = string include_body = bool })) origin_response = optional(object({ arn = string })) }))) allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ type = string arn = string include_body = optional(bool) })) origin_response = optional(object({ type = string arn = string })) })), {}) image_optimisation = optional(object({ paths = optional(list(string)) path_overrides = map(object({ allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ arn = string include_body = bool })) origin_response = optional(object({ arn = string })) })) allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ type = string arn = string include_body = optional(bool) })) origin_response = optional(object({ type = string arn = string })) })) }) |
{} |
no |
cache_control_immutable_assets_regex |
Regex to set public,max-age=31536000,immutable on immutable resources. This can be overridden for each zone |
string |
"^.*(\\.next)$" |
no |
cloudwatch_log |
The default cloudwatch log group configuration. This can be overridden for each zone and each function""
Possible values for deployment: - PER_FUNCTION (default) - SHARED_PER_ZONE - USE_EXISTING
When deployment is set to SHARED_PER_ZONE or USE_EXISTING , name is mandatory.
For SHARED_PER_ZONE , the name will include the aws/lambda namespace and the supplied prefix and suffix For USE_EXISTING , the name will represent the log group name (including prefix) |
object({ deployment = optional(string, "PER_FUNCTION") retention_in_days = optional(number, 7) name = optional(string) log_group_class = optional(string) skip_destroy = optional(bool) }) |
{} |
no |
content_types |
The MIME type mapping and default for artefacts generated by Open Next. This can be overridden for each zone |
object({ mapping = optional(map(string), { "svg" = "image/svg+xml", "js" = "application/javascript", "css" = "text/css", "html" = "text/html" }) default = optional(string, "binary/octet-stream") }) |
{} |
no |
continuous_deployment |
Configuration for continuous deployment config for CloudFront
When the deployment is set to 'INDEPENDENT_ZONES' this can be overridden for each zone. If continuous deployment is enabled, updates to the origins, ordered_cache_behaviors and default_cache_behaviors are ignored
See https://github.com/RJPearson94/terraform-aws-open-next/blob/v3.0.3/docs/continuous-deployments.md for a complete breakdown of how to use continuous deployment. |
object({ use = optional(bool, false) deployment = optional(string, "NONE") traffic_config = optional(object({ header = optional(object({ name = string value = string })) weight = optional(object({ percentage = number session_stickiness = optional(object({ idle_ttl = number maximum_ttl = number })) })) })) }) |
{} |
no |
custom_error_responses |
Allow custom error responses to be set on the distributions
When the deployment is set to 'INDEPENDENT_ZONES' this can be overridden for each zone. If deployment is 'SHARED_DISTRIBUTION' or 'SHARED_DISTRIBUTION_AND_BUCKET' this configuration is used. If the deployment is 'SHARED_DISTRIBUTION', the files are saved into the root zone bucket. If the deployment is 'SHARED_DISTRIBUTION_AND_BUCKET' the files are saved in the shared bucket
NOTE: These custom error pages only apply to response codes from the origins. To configure custom error responses for status codes returned by WAF, please configure the custom error responses in WAF. |
list(object({ error_code = string error_caching_min_ttl = optional(number) response_code = optional(string) response_page = optional(object({ source = string path_prefix = string })) })) |
[] |
no |
deployment |
The deployment model for the multi zone website
The possible values are: - INDEPENDENT_ZONES - SHARED_DISTRIBUTION - SHARED_DISTRIBUTION_AND_BUCKET
See https://github.com/RJPearson94/terraform-aws-open-next/tree/v3.0.3?tab=readme-ov-file#deployment-options for a complete breakdown of the different deployment options. |
string |
n/a |
yes |
distribution |
Configuration for the CloudFront distribution.
When the deployment is set to 'INDEPENDENT_ZONES' this can be overridden for each zone. If deployment is 'SHARED_DISTRIBUTION' or 'SHARED_DISTRIBUTION_AND_BUCKET' this configuration is used
Possible values for deployment are: - NONE - CREATE
The module has a local copy of the x-forwarded host CloudFront function code by default. The code can be seen at https://github.com/RJPearson94/terraform-aws-open-next/blob/v3.0.3/modules/tf-aws-open-next-public-resources/code/xForwardedHost.js (open next v2) and https://github.com/RJPearson94/terraform-aws-open-next/blob/v3.0.3/modules/tf-aws-open-next-public-resources/code/cloudfrontFunctionOpenNextV3.js (open next v3).
This code can be overridden by passing in the javascript function as a string to the code argument under the x_forwarded_host_function object. An example can be seen below.x_forwarded_host_function = { code = "function handler(event) { var request = event.request; request.headers['x-forwarded-host'] = request.headers.host; return request; }" } The auth function is deployed if the server function backend_deployment_type is set to EDGE_LAMBDA.
The module has a local copy of the auth function code, which will be deployed by default. The code can be seen at https://github.com/RJPearson94/terraform-aws-open-next/blob/v3.0.3/modules/tf-aws-open-next-public-resources/code/auth/index.js. You can override this to supplying a zip file containing the lambda code with either a local reference or a reference to the zip in an S3 bucket.
Possible values for the auth_function deployment are: - NONE - USE_EXISTING - CREATE - DETACH
The auth function arn is mandatory when deployment is set to USE_EXISTING .
When migrating from using the auth function to either public cloud functions or to using OAC, you should set the deployment on the auth_function to CREATE, then apply the changes. Then, you can set deployment to false in a subsequent change to clean up the function.
If you run the server function as a lambda@edge, you should increase the deletion timeout to 2 hours 120m . As the lambda service needs to wait for the replicas to be removed, this often exceeds the default 10-minute deletion timeout. This extended timeout allows Terraform to poll for longer and should help mitigate Terraform failures; an example Terraform configuration can be seen below.auth_function = { timeouts = { delete = "120m" } } As lambda@edge doesn't support environment variables, the environment variables are injected into the source code before the zip is generated. NOTE: If the lambda function code is supplied as a zip or via an S3 reference, this code modification will not occur
Terraform does not manage cloudwatch log groups for the auth function; the lambda service creates the log group when the function runs in each region.
CloudFront supports Origin Access Control (OAC) for lambda URLs. The possible values for the deployment options are: - NONE - CREATE
NOTE: If the server function or image optimisation function backend deployment types use OAC, then the OAC will be created.
As there is a limit on the number of cache policies associated with an AWS account, you can either configure the module to create the cache policy or use an existing one. The possible values for the cache policy deployment are: - USE_EXISTING - CREATE
If cache policy deployment is set to USE_EXISTING , then ID, is a required field.
WARNING: The distribution is fundamental to the architecture, and the module is optional to facilitate sharing a distribution for multi-zone deployments and to support edge cases not supported by the module. With that said, it is not recommended to supply a distribution. |
object({ deployment = optional(string, "CREATE") enabled = optional(bool, true) ipv6_enabled = optional(bool, true) http_version = optional(string, "http2") price_class = optional(string, "PriceClass_100") geo_restrictions = optional(object({ type = optional(string, "none"), locations = optional(list(string), []) }), {}) x_forwarded_host_function = optional(object({ runtime = optional(string) code = optional(string) }), {}) auth_function = optional(object({ deployment = optional(string, "NONE") qualified_arn = optional(string) function_code = optional(object({ handler = optional(string, "index.handler") zip = optional(object({ path = string hash = string })) s3 = optional(object({ bucket = string key = string object_version = optional(string) })) })) runtime = optional(string, "nodejs20.x") timeout = optional(number, 10) memory_size = optional(number, 256) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) }), {}) lambda_url_oac = optional(object({ deployment = optional(string, "NONE") }), {}) cache_policy = optional(object({ deployment = optional(string, "CREATE") id = optional(string) default_ttl = optional(number, 0) max_ttl = optional(number, 31536000) min_ttl = optional(number, 0) cookie_behavior = optional(string, "all") header_behavior = optional(string, "whitelist") header_items = optional(list(string)) query_string_behavior = optional(string, "all") }), {}) }) |
{} |
no |
domain_config |
Configuration for CloudFront distribution domain
When the deployment is set to 'INDEPENDENT_ZONES' this can be overridden for each zone. If deployment is 'SHARED_DISTRIBUTION' or 'SHARED_DISTRIBUTION_AND_BUCKET' this configuration is used
See https://github.com/RJPearson94/terraform-aws-open-next/blob/v3.0.3/docs/domain-config.md for a complete breakdown of the different domain configuration options. |
object({ evaluate_target_health = optional(bool, true) include_www = optional(bool, false) sub_domain = optional(string) hosted_zones = list(object({ name = string id = optional(string) private_zone = optional(bool, false) })) create_route53_entries = optional(bool, true) route53_record_allow_overwrite = optional(bool, true) viewer_certificate = optional(object({ acm_certificate_arn = string ssl_support_method = optional(string, "sni-only") minimum_protocol_version = optional(string, "TLSv1.2_2021") })) }) |
null |
no |
edge_functions |
Default configutation for all edge functions with the ability to override the configuration per edge function
By default, the module will create a new zip from the edge function code on disk. However, you can override this by supplying a zip file containing the lambda code with either a local reference or a reference to the zip in an S3 bucket.
This feature requires open next v3.
NOTE: Terraform does not manage cloudwatch log groups; instead, the lambda service creates the log group when the function runs in each region.
The module OPEN_NEXT_ORIGIN environment variable for each edge function, as per the open next documentation for middleware. You have the ability to remove this environment variable by setting the include_open_next_origin_env_variable to false or override this value by setting an environment variable with the same name via the additional_environment_variables attribute.
You should increase the deletion timeout to 2 hours 120m . As the lambda service needs to wait for the replicas to be removed, this often exceeds the default 10-minute deletion timeout. This extended timeout allows Terraform to poll for longer and should help mitigate Terraform failures; an example Terraform configuration can be seen below.timeouts = { delete = "120m" } As lambda@edge doesn't support environment variables, the environment variables are injected into the source code before the zip is generated. NOTE: If the lambda function code is supplied as a zip or via an S3 reference, this code modification will not occur
NOTE: This can be overridden for each zone |
object({ runtime = optional(string, "nodejs20.x") timeout = optional(number, 10) memory_size = optional(number, 512) include_open_next_origin_env_variable = optional(bool, true) additional_environment_variables = optional(map(string), {}) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) function_overrides = optional(map(object({ function_code = optional(object({ handler = optional(string, "handler.handler") zip = optional(object({ path = string hash = string })) s3 = optional(object({ bucket = string key = string object_version = optional(string) })) })) runtime = optional(string, "nodejs20.x") timeout = optional(number, 10) memory_size = optional(number, 512) include_open_next_origin_env_variable = optional(bool, true) additional_environment_variables = optional(map(string), {}) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) })), {}) }) |
{} |
no |
function_architecture |
The default instruction set architecture for the lambda functions. This can be overridden for each zone and each function |
string |
"arm64" |
no |
iam |
The default IAM configuration. This can be overridden for each zone and each function |
object({ path = optional(string, "/") permissions_boundary = optional(string) }) |
{} |
no |
image_optimisation_function |
Configuration for the image optimisation function.
By default, the module will create a new zip from the image optimisation function code on disk. However, you can override this by supplying a zip file containing the lambda code with either a local reference or a reference to the zip in an S3 bucket.
Possible values for backend_deployment_type: - REGIONAL_LAMBDA_WITH_AUTH_LAMBDA - REGIONAL_LAMBDA_WITH_OAC - REGIONAL_LAMBDA_WITH_OAC_AND_ANY_PRINCIPAL - REGIONAL_LAMBDA
See https://github.com/RJPearson94/terraform-aws-open-next/blob/v3.0.3/docs/backend-server-deployments.md for a complete breakdown of the different backend options.
If you do not want to provision the image optimisation function, you can set create to false.
NOTE: This can be overridden for each zone |
object({ create = optional(bool, true) function_code = optional(object({ handler = optional(string, "index.handler") zip = optional(object({ path = string hash = string })) s3 = optional(object({ bucket = string key = string object_version = optional(string) })) })) runtime = optional(string, "nodejs20.x") backend_deployment_type = optional(string, "REGIONAL_LAMBDA") timeout = optional(number, 25) memory_size = optional(number, 1536) additional_environment_variables = optional(map(string), {}) function_architecture = optional(string) static_image_optimisation = optional(bool, false) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) vpc = optional(object({ security_group_ids = list(string), subnet_ids = list(string) })) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) logging_config = optional(object({ log_format = optional(string) application_log_level = optional(string) system_log_level = optional(string) })) cloudwatch_log = optional(object({ deployment = optional(string) retention_in_days = optional(number) name = optional(string) log_group_class = optional(string) skip_destroy = optional(bool) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) }) |
{} |
no |
logging_config |
The default function logging configuration. The log group is determined by the cloudwatch_log variable. This can be overridden for each zone and each function |
object({ log_format = optional(string) application_log_level = optional(string) system_log_level = optional(string) }) |
null |
no |
open_next_version |
The version of open next that is used |
string |
"v2.x.x" |
no |
prefix |
A prefix which will be attached to the resource name to ensure resources are random |
string |
null |
no |
prefix_path_overrides |
Whether to add the path to the path overrides. This can be overridden for each zone |
bool |
true |
no |
revalidation_function |
Configuration for the revalidation function.
By default, the module will create a new zip from the revalidation function code on disk. However, you can override this by supplying a zip file containing the lambda code with either a local reference or a reference to the zip in an S3 bucket.
This function is deployed to the region specified on the default AWS Terraform provider.
NOTE: This can be overridden for each zone |
object({ function_code = optional(object({ handler = optional(string, "index.handler") zip = optional(object({ path = string hash = string })) s3 = optional(object({ bucket = string key = string object_version = optional(string) })) })) runtime = optional(string, "nodejs20.x") timeout = optional(number, 25) memory_size = optional(number, 1536) additional_environment_variables = optional(map(string), {}) function_architecture = optional(string) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) vpc = optional(object({ security_group_ids = list(string), subnet_ids = list(string) })) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) logging_config = optional(object({ log_format = optional(string) application_log_level = optional(string) system_log_level = optional(string) })) cloudwatch_log = optional(object({ deployment = optional(string) retention_in_days = optional(number) name = optional(string) log_group_class = optional(string) skip_destroy = optional(bool) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) }) |
{} |
no |
s3_exclusion_regex |
A regex of files to exclude from the s3 copy. his can be overridden for each zone |
string |
null |
no |
scripts |
Modify default script behaviours |
object({ interpreter = optional(string) additional_environment_variables = optional(map(string)) delete_folder_script = optional(object({ interpreter = optional(string) path = optional(string) additional_environment_variables = optional(map(string)) })) file_sync_script = optional(object({ interpreter = optional(string) path = optional(string) additional_environment_variables = optional(map(string)) })) invalidate_cloudfront_script = optional(object({ interpreter = optional(string) path = optional(string) additional_environment_variables = optional(map(string)) })) promote_distribution_script = optional(object({ interpreter = optional(string) path = optional(string) additional_environment_variables = optional(map(string)) })) remove_continuous_deployment_policy_id_script = optional(object({ interpreter = optional(string) path = optional(string) additional_environment_variables = optional(map(string)) })) save_item_to_dynamo_script = optional(object({ interpreter = optional(string) path = optional(string) additional_environment_variables = optional(map(string)) })) update_alias_script = optional(object({ interpreter = optional(string) path = optional(string) additional_environment_variables = optional(map(string)) })) update_parameter_script = optional(object({ interpreter = optional(string) path = optional(string) additional_environment_variables = optional(map(string)) })) }) |
{} |
no |
server_function |
Configuration for the server function.
By default, the module will create a new zip from the server function code on disk. However, you can override this by supplying a zip file containing the lambda code with either a local reference or a reference to the zip in an S3 bucket.
Possible values for backend_deployment_type: - REGIONAL_LAMBDA_WITH_AUTH_LAMBDA - REGIONAL_LAMBDA_WITH_OAC - REGIONAL_LAMBDA_WITH_OAC_AND_ANY_PRINCIPAL - REGIONAL_LAMBDA - EDGE_LAMBDA (only supported with open next v2)
See https://github.com/RJPearson94/terraform-aws-open-next/blob/v3.0.3/docs/backend-server-deployments.md for a complete breakdown of the different backend options.
NOTE: When backend_deployment_type is set to EDGE_LAMBDA, Terraform does not manage cloudwatch log groups; instead, the lambda service creates the log group when the function runs in each region.
If you run the server function as a lambda@edge, you should increase the deletion timeout to 2 hours 120m . As the lambda service needs to wait for the replicas to be removed, this often exceeds the default 10-minute deletion timeout. This extended timeout allows Terraform to poll for longer and should help mitigate Terraform failures; an example Terraform configuration can be seen below.timeouts = { delete = "120m" } As lambda@edge doesn't support environment variables, the environment variables are injected into the source code before the zip is generated. NOTE: If the lambda function code is supplied as a zip or via an S3 reference, this code modification will not occur
NOTE: This can be overridden for each zone |
object({ function_code = optional(object({ handler = optional(string, "index.handler") zip = optional(object({ path = string hash = string })) s3 = optional(object({ bucket = string key = string object_version = optional(string) })) })) enable_streaming = optional(bool, false) runtime = optional(string, "nodejs20.x") backend_deployment_type = optional(string, "REGIONAL_LAMBDA") timeout = optional(number, 10) memory_size = optional(number, 1024) function_architecture = optional(string) additional_environment_variables = optional(map(string), {}) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) vpc = optional(object({ security_group_ids = list(string), subnet_ids = list(string) })) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) logging_config = optional(object({ log_format = optional(string) application_log_level = optional(string) system_log_level = optional(string) })) cloudwatch_log = optional(object({ deployment = optional(string) retention_in_days = optional(number) name = optional(string) log_group_class = optional(string) skip_destroy = optional(bool) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) }) |
{} |
no |
suffix |
A suffix which will be attached to the resource name to ensure resources are random |
string |
null |
no |
tag_mapping_db |
Configuration for the ISR tag mapping database
By default, the module uploads the items in the dynamodb-cache JSON file stored locally. The cache alias is appended to each item in the DB.
Possible values for deployment: - NONE - CREATE
The read and write capacity for the Global Secondary Index (GSI) can be overridden; however, the table's read and write capacity will be used by default.
NOTE: This can be overridden for each zone |
object({ deployment = optional(string, "CREATE") billing_mode = optional(string, "PAY_PER_REQUEST") read_capacity = optional(number) write_capacity = optional(number) revalidate_gsi = optional(object({ read_capacity = optional(number) write_capacity = optional(number) }), {}) }) |
{} |
no |
vpc |
The default VPC configuration for the lambda resources. This can be overridden for each zone and each function |
object({ security_group_ids = list(string), subnet_ids = list(string) }) |
null |
no |
waf |
Configuration for the CloudFront distribution WAF.
When the deployment is set to 'INDEPENDENT_ZONES' this can be overridden for each zone. If deployment is 'SHARED_DISTRIBUTION' or 'SHARED_DISTRIBUTION_AND_BUCKET' this configuration is used"
Possible values for the WAF deployment are: - NONE - USE_EXISTING - CREATE - DETACH
The web_acl_id is mandatory when deployment is set to USE_EXISTING .
When configuring basic authentication, the encoded username and password are marked as sensitive. This can be turned off by setting mark_as_sensitive to false; however, a bug in Terraform v1.6.0 prevented this from working. If this occurs, please upgrade to at least v1.6.1.
Possible values for the WAF default action are: - ALLOW - BLOCK
The module provides the ability to configure recommended WAF rules to guard against SQL Injection (sqli), account takeover protection and account creation fraud prevention.
Multiple rate limits can be configured with each limit applied across all geographic regions or limited to a specific region. The possible values for the action are: - COUNT - BLOCK
The possible values for the action of each additional rule are: - COUNT - BLOCK
When IP address restrictions are used as part of additional rules or enforcing basic auth, the possible values for the action are: - BYPASS - BLOCK
Examples of maintenance pages, basic auth, and more can be found at https://github.com/RJPearson94/terraform-aws-open-next-examples. |
object({ deployment = optional(string, "NONE") web_acl_id = optional(string) aws_managed_rules = optional(list(object({ priority = optional(number) name = string aws_managed_rule_name = string })), [{ name = "amazon-ip-reputation-list" aws_managed_rule_name = "AWSManagedRulesAmazonIpReputationList" }, { name = "common-rule-set" aws_managed_rule_name = "AWSManagedRulesCommonRuleSet" }, { name = "known-bad-inputs" aws_managed_rule_name = "AWSManagedRulesKnownBadInputsRuleSet" }]) rate_limiting = optional(object({ enabled = optional(bool, false) limits = optional(list(object({ priority = optional(number) rule_name_suffix = optional(string) limit = optional(number, 1000) action = optional(string, "BLOCK") geo_match_scope = optional(list(string)) })), []) }), {}) sqli = optional(object({ enabled = optional(bool, false) priority = optional(number) }), {}) account_takeover_protection = optional(object({ enabled = optional(bool, false) priority = optional(number) login_path = string enable_regex_in_path = optional(bool) request_inspection = optional(object({ username_field_identifier = string password_field_identifier = string payload_type = string })) response_inspection = optional(object({ failure_codes = list(string) success_codes = list(string) })) })) account_creation_fraud_prevention = optional(object({ enabled = optional(bool, false) priority = optional(number) creation_path = string registration_page_path = string enable_regex_in_path = optional(bool) request_inspection = optional(object({ email_field_identifier = string username_field_identifier = string password_field_identifier = string payload_type = string })) response_inspection = optional(object({ failure_codes = list(string) success_codes = list(string) })) })) enforce_basic_auth = optional(object({ enabled = optional(bool, false) priority = optional(number) response_code = optional(number, 401) response_header = optional(object({ name = optional(string, "WWW-Authenticate") value = optional(string, "Basic realm="Requires basic auth"") }), {}) header_name = optional(string, "authorization") credentials = optional(object({ username = string password = string mark_as_sensitive = optional(bool, true) })) ip_address_restrictions = optional(list(object({ action = optional(string, "BYPASS") arn = optional(string) name = optional(string) }))) })) additional_rules = optional(list(object({ enabled = optional(bool, false) priority = optional(number) name = string action = optional(string, "COUNT") block_action = optional(object({ response_code = number response_header = optional(object({ name = string value = string })) custom_response_body_key = optional(string) })) ip_address_restrictions = list(object({ action = optional(string, "BYPASS") arn = optional(string) name = optional(string) })) }))) default_action = optional(object({ action = optional(string, "ALLOW") block_action = optional(object({ response_code = number response_header = optional(object({ name = string value = string })) custom_response_body_key = optional(string) })) })) ip_addresses = optional(map(object({ description = optional(string) ip_address_version = string addresses = list(string) }))) custom_response_bodies = optional(list(object({ key = string content = string content_type = string }))) }) |
{} |
no |
warmer_function |
Configuration for the warmer function.
By default, the module will create a new zip from the warmer function code on disk. However, you can override this by supplying a zip file containing the lambda code with either a local reference or a reference to the zip in an S3 bucket.
If the warmer function is enabled, you can conditionally choose to warm the staging distribution. Enabling this will provision another lambda function. By default, the warmer for the staging distribution will use the same concurrency value as the production distribution. However, you can override this value by specifying a concurrency value for the warm_staging object.
This function is deployed to the region specified on the default AWS Terraform provider.
NOTE: This can be overridden for each zone |
object({ enabled = optional(bool, false) warm_staging = optional(object({ enabled = optional(bool, false) concurrency = optional(number) })) function_code = optional(object({ handler = optional(string, "index.handler") zip = optional(object({ path = string hash = string })) s3 = optional(object({ bucket = string key = string object_version = optional(string) })) })) runtime = optional(string, "nodejs20.x") concurrency = optional(number, 20) timeout = optional(number, 15 * 60) // 15 minutes memory_size = optional(number, 1024) function_architecture = optional(string) schedule = optional(string, "rate(5 minutes)") additional_environment_variables = optional(map(string), {}) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) vpc = optional(object({ security_group_ids = list(string), subnet_ids = list(string) })) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) logging_config = optional(object({ log_format = optional(string) application_log_level = optional(string) system_log_level = optional(string) })) cloudwatch_log = optional(object({ deployment = optional(string) retention_in_days = optional(number) name = optional(string) log_group_class = optional(string) skip_destroy = optional(bool) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) }) |
{} |
no |
website_bucket |
Configuration for the website S3 bucket
When the deployment is set to 'INDEPENDENT_ZONES' or 'SHARED_DISTRIBUTION' this can be overridden for each zone. If deployment is 'SHARED_DISTRIBUTION_AND_BUCKET' this configuration is used"
This bucket is deployed to the region specified on the default AWS Terraform provider. |
object({ force_destroy = optional(bool, false) arn = optional(string) region = optional(string) name = optional(string) }) |
{} |
no |
zones |
The website zones to create. For a complete breakdown of the configuration of each input, see the descriptions above |
list(object({ root = bool name = string folder_path = string open_next_version = optional(string) path = optional(string) prefix_path_overrides = optional(bool, true) s3_exclusion_regex = optional(string) function_architecture = optional(string) iam = optional(object({ path = optional(string, "/") permissions_boundary = optional(string) })) logging_config = optional(object({ log_format = optional(string) application_log_level = optional(string) system_log_level = optional(string) })) cloudwatch_log = optional(object({ deployment = optional(string) retention_in_days = optional(number) name = optional(string) log_group_class = optional(string) skip_destroy = optional(bool) })) vpc = optional(object({ security_group_ids = list(string), subnet_ids = list(string) })) aliases = optional(object({ production = string staging = string })) cache_control_immutable_assets_regex = optional(string) content_types = optional(object({ mapping = optional(map(string), { "svg" = "image/svg+xml", "js" = "application/javascript", "css" = "text/css", "html" = "text/html" }) default = optional(string, "binary/octet-stream") })) warmer_function = optional(object({ enabled = optional(bool, false) warm_staging = optional(object({ enabled = optional(bool, false) concurrency = optional(number) })) function_code = optional(object({ handler = optional(string, "index.handler") zip = optional(object({ path = string hash = string })) s3 = optional(object({ bucket = string key = string object_version = optional(string) })) })) runtime = optional(string, "nodejs20.x") concurrency = optional(number, 20) timeout = optional(number, 15 * 60) // 15 minutes memory_size = optional(number, 1024) function_architecture = optional(string) schedule = optional(string, "rate(5 minutes)") additional_environment_variables = optional(map(string), {}) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) vpc = optional(object({ security_group_ids = list(string), subnet_ids = list(string) })) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) logging_config = optional(object({ log_format = optional(string) application_log_level = optional(string) system_log_level = optional(string) })) cloudwatch_log = optional(object({ deployment = optional(string) retention_in_days = optional(number) name = optional(string) log_group_class = optional(string) skip_destroy = optional(bool) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) })) edge_functions = optional(object({ runtime = optional(string, "nodejs20.x") timeout = optional(number, 10) memory_size = optional(number, 512) include_open_next_origin_env_variable = optional(bool, true) additional_environment_variables = optional(map(string), {}) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) function_overrides = optional(map(object({ function_code = optional(object({ handler = optional(string, "handler.handler") zip = optional(object({ path = string hash = string })) s3 = optional(object({ bucket = string key = string object_version = optional(string) })) })) runtime = optional(string, "nodejs20.x") timeout = optional(number, 10) memory_size = optional(number, 512) include_open_next_origin_env_variable = optional(bool, true) additional_environment_variables = optional(map(string), {}) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) })), {}) })) server_function = optional(object({ function_code = optional(object({ handler = optional(string, "index.handler") zip = optional(object({ path = string hash = string })) s3 = optional(object({ bucket = string key = string object_version = optional(string) })) })) enable_streaming = optional(bool, false) runtime = optional(string, "nodejs20.x") backend_deployment_type = optional(string, "REGIONAL_LAMBDA") timeout = optional(number, 10) memory_size = optional(number, 1024) function_architecture = optional(string) additional_environment_variables = optional(map(string), {}) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) vpc = optional(object({ security_group_ids = list(string), subnet_ids = list(string) })) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) logging_config = optional(object({ log_format = optional(string) application_log_level = optional(string) system_log_level = optional(string) })) cloudwatch_log = optional(object({ deployment = optional(string) retention_in_days = optional(number) name = optional(string) log_group_class = optional(string) skip_destroy = optional(bool) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) })) additional_server_functions = optional(object({ enable_streaming = optional(bool) runtime = optional(string, "nodejs20.x") backend_deployment_type = optional(string, "REGIONAL_LAMBDA") timeout = optional(number, 10) memory_size = optional(number, 1024) function_architecture = optional(string) additional_environment_variables = optional(map(string), {}) iam_policies = optional(object({ include_bucket_access = optional(bool, false) include_revalidation_queue_access = optional(bool, false) include_tag_mapping_db_access = optional(bool, false) }), {}) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) vpc = optional(object({ security_group_ids = list(string), subnet_ids = list(string) })) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) logging_config = optional(object({ log_format = optional(string) application_log_level = optional(string) system_log_level = optional(string) })) cloudwatch_log = optional(object({ deployment = optional(string) retention_in_days = optional(number) name = optional(string) log_group_class = optional(string) skip_destroy = optional(bool) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) function_overrides = optional(map(object({ function_code = optional(object({ handler = optional(string, "index.handler") zip = optional(object({ path = string hash = string })) s3 = optional(object({ bucket = string key = string object_version = optional(string) })) })) enable_streaming = optional(bool) runtime = optional(string, "nodejs20.x") backend_deployment_type = optional(string, "REGIONAL_LAMBDA") timeout = optional(number, 10) memory_size = optional(number, 1024) function_architecture = optional(string) additional_environment_variables = optional(map(string), {}) iam_policies = optional(object({ include_bucket_access = optional(bool, false) include_revalidation_queue_access = optional(bool, false) include_tag_mapping_db_access = optional(bool, false) }), {}) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) vpc = optional(object({ security_group_ids = list(string), subnet_ids = list(string) })) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) logging_config = optional(object({ log_format = optional(string) application_log_level = optional(string) system_log_level = optional(string) })) cloudwatch_log = optional(object({ deployment = optional(string) retention_in_days = optional(number) name = optional(string) log_group_class = optional(string) skip_destroy = optional(bool) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) })), {}) })) image_optimisation_function = optional(object({ create = optional(bool, true) function_code = optional(object({ handler = optional(string, "index.handler") zip = optional(object({ path = string hash = string })) s3 = optional(object({ bucket = string key = string object_version = optional(string) })) })) runtime = optional(string, "nodejs20.x") backend_deployment_type = optional(string, "REGIONAL_LAMBDA") timeout = optional(number, 25) memory_size = optional(number, 1536) additional_environment_variables = optional(map(string), {}) function_architecture = optional(string) static_image_optimisation = optional(bool, false) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) vpc = optional(object({ security_group_ids = list(string), subnet_ids = list(string) })) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) logging_config = optional(object({ log_format = optional(string) application_log_level = optional(string) system_log_level = optional(string) })) cloudwatch_log = optional(object({ deployment = optional(string) retention_in_days = optional(number) name = optional(string) log_group_class = optional(string) skip_destroy = optional(bool) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) })) revalidation_function = optional(object({ function_code = optional(object({ handler = optional(string, "index.handler") zip = optional(object({ path = string hash = string })) s3 = optional(object({ bucket = string key = string object_version = optional(string) })) })) runtime = optional(string, "nodejs20.x") timeout = optional(number, 25) memory_size = optional(number, 1536) additional_environment_variables = optional(map(string), {}) function_architecture = optional(string) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) vpc = optional(object({ security_group_ids = list(string), subnet_ids = list(string) })) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) logging_config = optional(object({ log_format = optional(string) application_log_level = optional(string) system_log_level = optional(string) })) cloudwatch_log = optional(object({ deployment = optional(string) retention_in_days = optional(number) name = optional(string) log_group_class = optional(string) skip_destroy = optional(bool) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) })) tag_mapping_db = optional(object({ deployment = optional(string, "CREATE") billing_mode = optional(string, "PAY_PER_REQUEST") read_capacity = optional(number) write_capacity = optional(number) revalidate_gsi = optional(object({ read_capacity = optional(number) write_capacity = optional(number) }), {}) })) website_bucket = optional(object({ force_destroy = optional(bool, false) arn = optional(string) region = optional(string) name = optional(string) })) distribution = optional(object({ deployment = optional(string, "CREATE") enabled = optional(bool, true) ipv6_enabled = optional(bool, true) http_version = optional(string, "http2") price_class = optional(string, "PriceClass_100") geo_restrictions = optional(object({ type = optional(string, "none"), locations = optional(list(string), []) }), {}) x_forwarded_host_function = optional(object({ runtime = optional(string) code = optional(string) }), {}) auth_function = optional(object({ deployment = optional(string, "NONE") qualified_arn = optional(string) function_code = optional(object({ handler = optional(string, "index.handler") zip = optional(object({ path = string hash = string })) s3 = optional(object({ bucket = string key = string object_version = optional(string) })) })) runtime = optional(string, "nodejs20.x") timeout = optional(number, 10) memory_size = optional(number, 256) additional_iam_policies = optional(list(object({ name = string, arn = optional(string) policy = optional(string) })), []) iam = optional(object({ path = optional(string) permissions_boundary = optional(string) })) logging_config = optional(object({ log_format = optional(string) application_log_level = optional(string) system_log_level = optional(string) })) cloudwatch_log = optional(object({ deployment = optional(string) retention_in_days = optional(number) name = optional(string) log_group_class = optional(string) skip_destroy = optional(bool) })) timeouts = optional(object({ create = optional(string) update = optional(string) delete = optional(string) }), {}) }), {}) lambda_url_oac = optional(object({ deployment = optional(string, "NONE") }), {}) cache_policy = optional(object({ deployment = optional(string, "CREATE") arn = optional(string) id = optional(string) default_ttl = optional(number, 0) max_ttl = optional(number, 31536000) min_ttl = optional(number, 0) cookie_behavior = optional(string, "all") header_behavior = optional(string, "whitelist") header_items = optional(list(string)) query_string_behavior = optional(string, "all") }), {}) })) behaviours = optional(object({ custom_error_responses = optional(object({ path_overrides = optional(map(object({ allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ arn = string include_body = bool })) origin_response = optional(object({ arn = string })) }))) allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ type = string arn = string include_body = optional(bool) })) origin_response = optional(object({ type = string arn = string })) })) static_assets = optional(object({ paths = optional(list(string)) additional_paths = optional(list(string)) path_overrides = optional(map(object({ allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ arn = string include_body = bool })) origin_response = optional(object({ arn = string })) }))) allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ type = string arn = string include_body = optional(bool) })) origin_response = optional(object({ type = string arn = string })) })) server = optional(object({ paths = optional(list(string)) path_overrides = map(object({ allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ arn = string include_body = bool })) origin_response = optional(object({ arn = string })) })) allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ type = string arn = string include_body = optional(bool) })) origin_response = optional(object({ type = string arn = string })) })) additional_origins = optional(map(object({ paths = optional(list(string)) path_overrides = optional(map(object({ allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ arn = string include_body = bool })) origin_response = optional(object({ arn = string })) }))) allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ type = string arn = string include_body = optional(bool) })) origin_response = optional(object({ type = string arn = string })) })), {}) image_optimisation = optional(object({ paths = optional(list(string)) path_overrides = map(object({ allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ arn = string include_body = bool })) origin_response = optional(object({ arn = string })) })) allowed_methods = optional(list(string)) cached_methods = optional(list(string)) cache_policy_id = optional(string) origin_request_policy_id = optional(string) compress = optional(bool) viewer_protocol_policy = optional(string) viewer_request = optional(object({ type = string arn = string include_body = optional(bool) })) viewer_response = optional(object({ type = string arn = string })) origin_request = optional(object({ type = string arn = string include_body = optional(bool) })) origin_response = optional(object({ type = string arn = string })) })) })) waf = optional(object({ deployment = optional(string, "NONE") web_acl_id = optional(string) aws_managed_rules = optional(list(object({ priority = optional(number) name = string aws_managed_rule_name = string })), [{ name = "amazon-ip-reputation-list" aws_managed_rule_name = "AWSManagedRulesAmazonIpReputationList" }, { name = "common-rule-set" aws_managed_rule_name = "AWSManagedRulesCommonRuleSet" }, { name = "known-bad-inputs" aws_managed_rule_name = "AWSManagedRulesKnownBadInputsRuleSet" }]) rate_limiting = optional(object({ enabled = optional(bool, false) limits = optional(list(object({ priority = optional(number) rule_name_suffix = optional(string) limit = optional(number, 1000) action = optional(string, "BLOCK") geo_match_scope = optional(list(string)) })), []) }), {}) sqli = optional(object({ enabled = optional(bool, false) priority = optional(number) }), {}) account_takeover_protection = optional(object({ enabled = optional(bool, false) priority = optional(number) login_path = string enable_regex_in_path = optional(bool) request_inspection = optional(object({ username_field_identifier = string password_field_identifier = string payload_type = string })) response_inspection = optional(object({ failure_codes = list(string) success_codes = list(string) })) })) account_creation_fraud_prevention = optional(object({ enabled = optional(bool, false) priority = optional(number) creation_path = string registration_page_path = string enable_regex_in_path = optional(bool) request_inspection = optional(object({ email_field_identifier = string username_field_identifier = string password_field_identifier = string payload_type = string })) response_inspection = optional(object({ failure_codes = list(string) success_codes = list(string) })) })) enforce_basic_auth = optional(object({ enabled = optional(bool, false) priority = optional(number) response_code = optional(number, 401) response_header = optional(object({ name = optional(string, "WWW-Authenticate") value = optional(string, "Basic realm="Requires basic auth"") }), {}) header_name = optional(string, "authorization") credentials = optional(object({ username = string password = string mark_as_sensitive = optional(bool, true) })) ip_address_restrictions = optional(list(object({ action = optional(string, "BYPASS") arn = optional(string) name = optional(string) }))) })) additional_rules = optional(list(object({ enabled = optional(bool, false) priority = optional(number) name = string action = optional(string, "COUNT") block_action = optional(object({ response_code = number response_header = optional(object({ name = string value = string })) custom_response_body_key = optional(string) })) ip_address_restrictions = list(object({ action = optional(string, "BYPASS") arn = optional(string) name = optional(string) })) }))) default_action = optional(object({ action = optional(string, "ALLOW") block_action = optional(object({ response_code = number response_header = optional(object({ name = string value = string })) custom_response_body_key = optional(string) })) })) ip_addresses = optional(map(object({ description = optional(string) ip_address_version = string addresses = list(string) }))) custom_response_bodies = optional(list(object({ key = string content = string content_type = string }))) })) domain_config = optional(object({ evaluate_target_health = optional(bool, true) include_www = optional(bool, false) sub_domain = optional(string) hosted_zones = list(object({ name = string id = optional(string) private_zone = optional(bool, false) })) create_route53_entries = optional(bool, true) route53_record_allow_overwrite = optional(bool, true) viewer_certificate = optional(object({ acm_certificate_arn = string ssl_support_method = optional(string, "sni-only") minimum_protocol_version = optional(string, "TLSv1.2_2021") })) })) continuous_deployment = optional(object({ use = optional(bool, false) deployment = optional(string, "NONE") traffic_config = optional(object({ header = optional(object({ name = string value = string })) weight = optional(object({ percentage = number session_stickiness = optional(object({ idle_ttl = number maximum_ttl = number })) })) })) })) custom_error_responses = optional(list(object({ error_code = string error_caching_min_ttl = optional(number) response_code = optional(string) response_page = optional(object({ source = string path_prefix = string })) }))) })) |
n/a |
yes |