# FunctionUrlOriginAccessControlProps

Properties for creating a Lambda Function URL Origin Access Control resource.

Extends: [OriginAccessControlBaseProps](/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.OriginAccessControlBaseProps.html)
Used as props by: [FunctionUrlOriginAccessControl](/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.FunctionUrlOriginAccessControl.html)

- 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#L80)
- Type last changed: v2.168.0 · 20 Nov 2024

## Example

TypeScript:

```ts
declare const regionalEndpointDomainName: string;

const oac = new cloudfront.FunctionUrlOriginAccessControl(this, 'WebFunctionOAC', {
  signing: cloudfront.Signing.SIGV4_ALWAYS_AMZ_AUTH,
});

new cloudfront.Distribution(this, 'MyDistribution', {
  defaultBehavior: {
    origin: new origins.HttpOrigin(regionalEndpointDomainName, {
      originAccessControlId: oac.originAccessControlId,
    }),
  },
});
```

Python:

```python
# regional_endpoint_domain_name: str

oac = cloudfront.FunctionUrlOriginAccessControl(self, "WebFunctionOAC",
    signing=cloudfront.Signing.SIGV4_ALWAYS_AMZ_AUTH
)

cloudfront.Distribution(self, "MyDistribution",
    default_behavior=cloudfront.BehaviorOptions(
        origin=origins.HttpOrigin(regional_endpoint_domain_name,
            origin_access_control_id=oac.origin_access_control_id
        )
    )
)
```

Java:

```java
String regionalEndpointDomainName;

FunctionUrlOriginAccessControl oac = FunctionUrlOriginAccessControl.Builder.create(this, "WebFunctionOAC")
        .signing(Signing.SIGV4_ALWAYS_AMZ_AUTH)
        .build();

Distribution.Builder.create(this, "MyDistribution")
        .defaultBehavior(BehaviorOptions.builder()
                .origin(HttpOrigin.Builder.create(regionalEndpointDomainName)
                        .originAccessControlId(oac.getOriginAccessControlId())
                        .build())
                .build())
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
string regionalEndpointDomainName;

var oac = new FunctionUrlOriginAccessControl(this, "WebFunctionOAC", new FunctionUrlOriginAccessControlProps {
    Signing = Signing.SIGV4_ALWAYS_AMZ_AUTH
});

new Distribution(this, "MyDistribution", new DistributionProps {
    DefaultBehavior = new BehaviorOptions {
        Origin = new HttpOrigin(regionalEndpointDomainName, new HttpOriginProps {
            OriginAccessControlId = oac.OriginAccessControlId
        })
    }
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
var regionalEndpointDomainName string

oac := cloudfront.NewFunctionUrlOriginAccessControl(this, jsii.String("WebFunctionOAC"), &FunctionUrlOriginAccessControlProps{
	Signing: cloudfront.Signing_SIGV4_ALWAYS_AMZ_AUTH(),
})

cloudfront.NewDistribution(this, jsii.String("MyDistribution"), &DistributionProps{
	DefaultBehavior: &BehaviorOptions{
		Origin: origins.NewHttpOrigin(regionalEndpointDomainName, &HttpOriginProps{
			OriginAccessControlId: oac.OriginAccessControlId,
		}),
	},
})
```

## Properties

- `description`: string — A description of the origin access control.

  **Default:** no description

- `originAccessControlName`: string — A name to identify the origin access control, with a maximum length of 64 characters.

  **Default:** a generated name

- `signing`: [Signing](/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.Signing.html) = SIGV4_ALWAYS — Specifies which requests CloudFront signs and the signing protocol.
