Package software.amazon.awscdk.services.shield

Interface CfnDRTAccessProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnDRTAccessProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.98.0 (build 00b106d)",
           date="2024-05-17T05:10:18.223Z")
@Stability(Stable)
public interface CfnDRTAccessProps
extends software.amazon.jsii.JsiiSerializable

Properties for defining a CfnDRTAccess.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.shield.*;
 CfnDRTAccessProps cfnDRTAccessProps = CfnDRTAccessProps.builder()
         .roleArn("roleArn")
         // the properties below are optional
         .logBucketList(List.of("logBucketList"))
         .build();
 

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-shield-drtaccess.html

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	CfnDRTAccessProps.Builder	A builder for CfnDRTAccessProps
static final class	CfnDRTAccessProps.Jsii$Proxy	An implementation for CfnDRTAccessProps

Method Summary

Modifier and Type	Method	Description
static CfnDRTAccessProps.Builder	builder()
default List<String>	getLogBucketList()	Authorizes the Shield Response Team (SRT) to access the specified Amazon S3 bucket containing log data such as Application Load Balancer access logs, CloudFront logs, or logs from third party sources.
String	getRoleArn()	Authorizes the Shield Response Team (SRT) using the specified role, to access your AWS account to assist with DDoS attack mitigation during potential attacks.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getRoleArn

@Stability(Stable)
@NotNull
String getRoleArn()

Authorizes the Shield Response Team (SRT) using the specified role, to access your AWS account to assist with DDoS attack mitigation during potential attacks.

This enables the SRT to inspect your AWS WAF configuration and logs and to create or update AWS WAF rules and web ACLs.

You can associate only one RoleArn with your subscription. If you submit this update for an account that already has an associated role, the new RoleArn will replace the existing RoleArn .

This change requires the following:

• You must be subscribed to the Business Support plan or the Enterprise Support plan .
• The AWSShieldDRTAccessPolicy managed policy must be attached to the role that you specify in the request. You can access this policy in the IAM console at AWSShieldDRTAccessPolicy . For information, see Adding and removing IAM identity permissions .
• The role must trust the service principal drt.shield.amazonaws.com . For information, see IAM JSON policy elements: Principal .

The SRT will have access only to your AWS WAF and Shield resources. By submitting this request, you provide permissions to the SRT to inspect your AWS WAF and Shield configuration and logs, and to create and update AWS WAF rules and web ACLs on your behalf. The SRT takes these actions only if explicitly authorized by you.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-shield-drtaccess.html#cfn-shield-drtaccess-rolearn

getLogBucketList

@Stability(Stable)
@Nullable
default List<String> getLogBucketList()

Authorizes the Shield Response Team (SRT) to access the specified Amazon S3 bucket containing log data such as Application Load Balancer access logs, CloudFront logs, or logs from third party sources.

You can associate up to 10 Amazon S3 buckets with your subscription.

Use this to share information with the SRT that's not available in AWS WAF logs.

To use the services of the SRT, you must be subscribed to the Business Support plan or the Enterprise Support plan .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-shield-drtaccess.html#cfn-shield-drtaccess-logbucketlist

builder

@Stability(Stable)
static CfnDRTAccessProps.Builder builder()

Returns:

a CfnDRTAccessProps.Builder of CfnDRTAccessProps