OriginRequestCookieBehavior Class
Determines whether any cookies in viewer requests (and if so, which cookies) are included in requests that CloudFront sends to the origin.
| Source | aws-cloudfront/lib/origin-request-policy.ts |
|---|---|
| Type last changed |
Example
ts
// Creating a custom origin request policy for a Distribution -- all parameters optional
declare const bucketOrigin: origins.S3Origin;
const myOriginRequestPolicy = new cloudfront.OriginRequestPolicy(this, 'OriginRequestPolicy', {
originRequestPolicyName: 'MyPolicy',
comment: 'A default policy',
cookieBehavior: cloudfront.OriginRequestCookieBehavior.none(),
headerBehavior: cloudfront.OriginRequestHeaderBehavior.all('CloudFront-Is-Android-Viewer'),
queryStringBehavior: cloudfront.OriginRequestQueryStringBehavior.allowList('username'),
});
new cloudfront.Distribution(this, 'myDistCustomPolicy', {
defaultBehavior: {
origin: bucketOrigin,
originRequestPolicy: myOriginRequestPolicy,
},
});
python
# Creating a custom origin request policy for a Distribution -- all parameters optional
# bucket_origin: origins.S3Origin
my_origin_request_policy = cloudfront.OriginRequestPolicy(self, "OriginRequestPolicy",
origin_request_policy_name="MyPolicy",
comment="A default policy",
cookie_behavior=cloudfront.OriginRequestCookieBehavior.none(),
header_behavior=cloudfront.OriginRequestHeaderBehavior.all("CloudFront-Is-Android-Viewer"),
query_string_behavior=cloudfront.OriginRequestQueryStringBehavior.allow_list("username")
)
cloudfront.Distribution(self, "myDistCustomPolicy",
default_behavior=cloudfront.BehaviorOptions(
origin=bucket_origin,
origin_request_policy=my_origin_request_policy
)
)
java
// Creating a custom origin request policy for a Distribution -- all parameters optional
S3Origin bucketOrigin;
OriginRequestPolicy myOriginRequestPolicy = OriginRequestPolicy.Builder.create(this, "OriginRequestPolicy")
.originRequestPolicyName("MyPolicy")
.comment("A default policy")
.cookieBehavior(OriginRequestCookieBehavior.none())
.headerBehavior(OriginRequestHeaderBehavior.all("CloudFront-Is-Android-Viewer"))
.queryStringBehavior(OriginRequestQueryStringBehavior.allowList("username"))
.build();
Distribution.Builder.create(this, "myDistCustomPolicy")
.defaultBehavior(BehaviorOptions.builder()
.origin(bucketOrigin)
.originRequestPolicy(myOriginRequestPolicy)
.build())
.build();
csharp
// Install: dotnet add package Amazon.CDK.Lib
// Creating a custom origin request policy for a Distribution -- all parameters optional
S3Origin bucketOrigin;
var myOriginRequestPolicy = new OriginRequestPolicy(this, "OriginRequestPolicy", new OriginRequestPolicyProps {
OriginRequestPolicyName = "MyPolicy",
Comment = "A default policy",
CookieBehavior = OriginRequestCookieBehavior.None(),
HeaderBehavior = OriginRequestHeaderBehavior.All("CloudFront-Is-Android-Viewer"),
QueryStringBehavior = OriginRequestQueryStringBehavior.AllowList("username")
});
new Distribution(this, "myDistCustomPolicy", new DistributionProps {
DefaultBehavior = new BehaviorOptions {
Origin = bucketOrigin,
OriginRequestPolicy = myOriginRequestPolicy
}
});
go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
// Creating a custom origin request policy for a Distribution -- all parameters optional
var bucketOrigin S3Origin
myOriginRequestPolicy := cloudfront.NewOriginRequestPolicy(this, jsii.String("OriginRequestPolicy"), &OriginRequestPolicyProps{
OriginRequestPolicyName: jsii.String("MyPolicy"),
Comment: jsii.String("A default policy"),
CookieBehavior: cloudfront.OriginRequestCookieBehavior_None(),
HeaderBehavior: cloudfront.OriginRequestHeaderBehavior_All(jsii.String("CloudFront-Is-Android-Viewer")),
QueryStringBehavior: cloudfront.OriginRequestQueryStringBehavior_AllowList(jsii.String("username")),
})
cloudfront.NewDistribution(this, jsii.String("myDistCustomPolicy"), &DistributionProps{
DefaultBehavior: &BehaviorOptions{
Origin: bucketOrigin,
OriginRequestPolicy: myOriginRequestPolicy,
},
})
Properties
The behavior of cookies: allow all, none or an allow list.
cookiesmay be undefinedstring[]cookiesmay be undefinedtyping.List[str]cookiesmay be undefinedList<String>Cookiesmay be undefinedstring[]Cookiesmay be undefined*[]*string #The cookies to allow, if the behavior is an allow list.
Methods
all(): OriginRequestCookieBehavior // chainable@staticmethod def all() -> OriginRequestCookieBehaviorpublic static OriginRequestCookieBehavior all()public static OriginRequestCookieBehavior All()func All() OriginRequestCookieBehavior static #All cookies in viewer requests are included in requests that CloudFront sends to the origin.
allowList(...cookies: string[]): OriginRequestCookieBehavior // chainable@staticmethod def allow_list(cookies: str) -> OriginRequestCookieBehaviorpublic static OriginRequestCookieBehavior allowList(String cookies)public static OriginRequestCookieBehavior AllowList(string cookies)func AllowList(Cookies *string) OriginRequestCookieBehavior static #Only the provided `cookies` are included in requests that CloudFront sends to the origin.
denyList(...cookies: string[]): OriginRequestCookieBehavior // chainable@staticmethod def deny_list(cookies: str) -> OriginRequestCookieBehaviorpublic static OriginRequestCookieBehavior denyList(String cookies)public static OriginRequestCookieBehavior DenyList(string cookies)func DenyList(Cookies *string) OriginRequestCookieBehavior static #All cookies except the provided `cookies` are included in requests that CloudFront sends to the origin.
none(): OriginRequestCookieBehavior // chainable@staticmethod def none() -> OriginRequestCookieBehaviorpublic static OriginRequestCookieBehavior none()public static OriginRequestCookieBehavior None()func None() OriginRequestCookieBehavior static #Cookies in viewer requests are not included in requests that CloudFront sends to the origin.
Any cookies that are listed in a CachePolicy are still included in origin requests.