# Signing

Options for how CloudFront signs requests.

Obtainable from: Signing.NEVER, Signing.SIGV4A_ALWAYS, Signing.SIGV4A_ALWAYS_AMZ_AUTH, Signing.SIGV4_ALWAYS, Signing.SIGV4_ALWAYS_AMZ_AUTH, Signing.SIGV4_NO_OVERRIDE

- Source: [`aws-cloudfront/lib/origin-access-control.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/aws-cdk-lib/aws-cloudfront/lib/origin-access-control.ts#L166)
- Type last changed: v2.275.0 · 26 Oct 2026

## Example

TypeScript:

```ts
const myBucket = new s3.Bucket(this, 'myBucket');
const oac = new cloudfront.S3OriginAccessControl(this, 'MyOAC', {
  signing: cloudfront.Signing.SIGV4_NO_OVERRIDE
});
const s3Origin = origins.S3BucketOrigin.withOriginAccessControl(myBucket, {
    originAccessControl: oac
  }
)
new cloudfront.Distribution(this, 'myDist', {
  defaultBehavior: {
    origin: s3Origin
  },
});
```

Python:

```python
my_bucket = s3.Bucket(self, "myBucket")
oac = cloudfront.S3OriginAccessControl(self, "MyOAC",
    signing=cloudfront.Signing.SIGV4_NO_OVERRIDE
)
s3_origin = origins.S3BucketOrigin.with_origin_access_control(my_bucket,
    origin_access_control=oac
)
cloudfront.Distribution(self, "myDist",
    default_behavior=cloudfront.BehaviorOptions(
        origin=s3_origin
    )
)
```

Java:

```java
Bucket myBucket = new Bucket(this, "myBucket");
S3OriginAccessControl oac = S3OriginAccessControl.Builder.create(this, "MyOAC")
        .signing(Signing.SIGV4_NO_OVERRIDE)
        .build();
IOrigin s3Origin = S3BucketOrigin.withOriginAccessControl(myBucket, S3BucketOriginWithOACProps.builder()
        .originAccessControl(oac)
        .build());
Distribution.Builder.create(this, "myDist")
        .defaultBehavior(BehaviorOptions.builder()
                .origin(s3Origin)
                .build())
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
var myBucket = new Bucket(this, "myBucket");
var oac = new S3OriginAccessControl(this, "MyOAC", new S3OriginAccessControlProps {
    Signing = Signing.SIGV4_NO_OVERRIDE
});
var s3Origin = S3BucketOrigin.WithOriginAccessControl(myBucket, new S3BucketOriginWithOACProps {
    OriginAccessControl = oac
});
new Distribution(this, "myDist", new DistributionProps {
    DefaultBehavior = new BehaviorOptions {
        Origin = s3Origin
    }
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
myBucket := s3.NewBucket(this, jsii.String("myBucket"))
oac := cloudfront.NewS3OriginAccessControl(this, jsii.String("MyOAC"), &S3OriginAccessControlProps{
	Signing: cloudfront.Signing_SIGV4_NO_OVERRIDE(),
})
s3Origin := origins.S3BucketOrigin_WithOriginAccessControl(myBucket, &S3BucketOriginWithOACProps{
	OriginAccessControl: oac,
})
cloudfront.NewDistribution(this, jsii.String("myDist"), &DistributionProps{
	DefaultBehavior: &BehaviorOptions{
		Origin: s3Origin,
	},
})
```

## Initializer

TypeScript:

```ts
new Signing(protocol: SigningProtocol, behavior: SigningBehavior)
```

Python:

```python
Signing(protocol: SigningProtocol, behavior: SigningBehavior)
```

Java:

```java
new Signing(SigningProtocol protocol, SigningBehavior behavior)
```

C# / .NET:

```csharp
new Signing(SigningProtocol protocol, SigningBehavior behavior)
```

Golang:

```go
NewSigning(Protocol SigningProtocol, Behavior SigningBehavior)
```

## Properties

- `behavior`: [SigningBehavior](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.SigningBehavior.html) — Which requests CloudFront signs.

- `NEVER`: [Signing](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.Signing.html) (static) — Do not sign any origin requests.

- `protocol`: [SigningProtocol](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.SigningProtocol.html) — The signing protocol.

- `SIGV4_ALWAYS`: [Signing](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.Signing.html) (static) — Sign all origin requests using the AWS Signature Version 4 signing protocol.

- `SIGV4_ALWAYS_AMZ_AUTH`: [Signing](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.Signing.html) (static) — Sign all origin requests using the AWS Signature Version 4 signing protocol, and pass the viewer's Authorization header to the origin unchanged.

- `SIGV4_NO_OVERRIDE`: [Signing](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.Signing.html) (static) — Sign only if the viewer request doesn't contain the Authorization header using the AWS Signature Version 4 signing protocol.

- `SIGV4A_ALWAYS`: [Signing](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.Signing.html) (static) — Sign all origin requests using the AWS Signature Version 4A signing protocol.

- `SIGV4A_ALWAYS_AMZ_AUTH`: [Signing](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.Signing.html) (static) — Sign all origin requests using the AWS Signature Version 4A signing protocol, and pass the viewer's Authorization header to the origin unchanged.
