# OriginRequestPolicyProps

Properties for creating a Origin Request Policy.

Extends: OriginRequestPolicyProps
Used as props by: OriginRequestPolicy

- Source: [`aws-cloudfront/lib/origin-request-policy.ts`](https://github.com/aws/aws-cdk/blob/v2.274.0/packages/aws-cdk-lib/aws-cloudfront/lib/origin-request-policy.ts#L24)

## 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,
  },
});
```

## Properties

- `comment`: string — A comment to describe the origin request policy.

  **Default:** no comment

- `cookieBehavior`: [OriginRequestCookieBehavior](/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.OriginRequestCookieBehavior.html) — The cookies from viewer requests to include in origin requests.

  **Default:** OriginRequestCookieBehavior.none()

- `headerBehavior`: [OriginRequestHeaderBehavior](/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.OriginRequestHeaderBehavior.html) — The HTTP headers to include in origin requests.

  **Default:** OriginRequestHeaderBehavior.none()

  These can include headers from viewer requests and additional headers added by CloudFront.

- `originRequestPolicyName`: string — A unique name to identify the origin request policy.

  **Default:** generated from the `id`

  The name must only include '-', '_', or alphanumeric characters.

- `queryStringBehavior`: [OriginRequestQueryStringBehavior](/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.OriginRequestQueryStringBehavior.html) — The URL query strings from viewer requests to include in origin requests.

  **Default:** OriginRequestQueryStringBehavior.none()