# BrowserCustomProps

Properties for creating a Browser resource.

Used as props by: [BrowserCustom](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-bedrock-agentcore-alpha.BrowserCustom.html)

- Source: [`lib/tools/browser.ts`](https://github.com/aws/aws-cdk/blob/v2.278.0/packages/@aws-cdk/aws-bedrock-agentcore-alpha/lib/tools/browser.ts#L534)

## Example

TypeScript:

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as bedrock_agentcore_alpha from '@aws-cdk/aws-bedrock-agentcore-alpha';
import { aws_iam as iam } from 'aws-cdk-lib';

declare const browserNetworkConfiguration: bedrock_agentcore_alpha.BrowserNetworkConfiguration;
declare const role: iam.Role;
const browserCustomProps: bedrock_agentcore_alpha.BrowserCustomProps = {
  browserCustomName: 'browserCustomName',
  browserSigning: bedrock_agentcore_alpha.BrowserSigning.ENABLED,
  description: 'description',
  executionRole: role,
  networkConfiguration: browserNetworkConfiguration,
  recordingConfig: {
    enabled: false,
    s3Location: {
      bucketName: 'bucketName',
      objectKey: 'objectKey',

      // the properties below are optional
      objectVersion: 'objectVersion',
    },
  },
  tags: {
    tagsKey: 'tags',
  },
};
```

Python:

```python
from aws_cdk.aws_s3 import Location
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk.aws_bedrock_agentcore_alpha as bedrock_agentcore_alpha
from aws_cdk import aws_iam as iam

# browser_network_configuration: bedrock_agentcore_alpha.BrowserNetworkConfiguration
# role: iam.Role

browser_custom_props = bedrock_agentcore_alpha.BrowserCustomProps(
    browser_custom_name="browserCustomName",
    browser_signing=bedrock_agentcore_alpha.BrowserSigning.ENABLED,
    description="description",
    execution_role=role,
    network_configuration=browser_network_configuration,
    recording_config=bedrock_agentcore_alpha.RecordingConfig(
        enabled=False,
        s3_location=Location(
            bucket_name="bucketName",
            object_key="objectKey",

            # the properties below are optional
            object_version="objectVersion"
        )
    ),
    tags={
        "tags_key": "tags"
    }
)
```

Java:

```java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.bedrock.agentcore.alpha.*;
import software.amazon.awscdk.services.iam.*;

BrowserNetworkConfiguration browserNetworkConfiguration;
Role role;

BrowserCustomProps browserCustomProps = BrowserCustomProps.builder()
        .browserCustomName("browserCustomName")
        .browserSigning(BrowserSigning.ENABLED)
        .description("description")
        .executionRole(role)
        .networkConfiguration(browserNetworkConfiguration)
        .recordingConfig(RecordingConfig.builder()
                .enabled(false)
                .s3Location(Location.builder()
                        .bucketName("bucketName")
                        .objectKey("objectKey")

                        // the properties below are optional
                        .objectVersion("objectVersion")
                        .build())
                .build())
        .tags(Map.of(
                "tagsKey", "tags"))
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.AWS.Bedrock.Agentcore.Alpha
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.Bedrock.Agentcore.Alpha;
using Amazon.CDK.AWS.IAM;

BrowserNetworkConfiguration browserNetworkConfiguration;
Role role;

var browserCustomProps = new BrowserCustomProps {
    BrowserCustomName = "browserCustomName",
    BrowserSigning = BrowserSigning.ENABLED,
    Description = "description",
    ExecutionRole = role,
    NetworkConfiguration = browserNetworkConfiguration,
    RecordingConfig = new RecordingConfig {
        Enabled = false,
        S3Location = new Location {
            BucketName = "bucketName",
            ObjectKey = "objectKey",

            // the properties below are optional
            ObjectVersion = "objectVersion"
        }
    },
    Tags = new Dictionary<string, string> {
        { "tagsKey", "tags" }
    }
};
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awsbedrockagentcorealpha/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import bedrock_agentcore_alpha "github.com/aws/aws-cdk-go/awsbedrockagentcorealpha"
import "github.com/aws/aws-cdk-go/awscdk"

var browserNetworkConfiguration BrowserNetworkConfiguration
var role Role

browserCustomProps := &BrowserCustomProps{
	BrowserCustomName: jsii.String("browserCustomName"),
	BrowserSigning: bedrock_agentcore_alpha.BrowserSigning_ENABLED,
	Description: jsii.String("description"),
	ExecutionRole: role,
	NetworkConfiguration: browserNetworkConfiguration,
	RecordingConfig: &RecordingConfig{
		Enabled: jsii.Boolean(false),
		S3Location: &Location{
			BucketName: jsii.String("bucketName"),
			ObjectKey: jsii.String("objectKey"),

			// the properties below are optional
			ObjectVersion: jsii.String("objectVersion"),
		},
	},
	Tags: map[string]*string{
		"tagsKey": jsii.String("tags"),
	},
}
```

## Properties

- `browserCustomName`: string — The name of the browser Valid characters are a-z, A-Z, 0-9, _ (underscore) The name must start with a letter and can be up to 48 characters long Pattern: [a-zA-Z][a-zA-Z0-9_]{0,47}.

  **Default:** auto generate

- `browserSigning`: [BrowserSigning](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-bedrock-agentcore-alpha.BrowserSigning.html) = BrowserSigning.DISABLED — Specifies whether browser signing is enabled.

  When enabled, the browser will cryptographically sign
  HTTP requests to identify itself as an AI agent to bot control vendors.

- `description`: string — Optional description for the browser Valid characters are a-z, A-Z, 0-9, _ (underscore), - (hyphen) and spaces The description can have up to 200 characters.

  **Default:** No description

- `executionRole`: [IRole](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_iam.IRole.html) — The IAM role that provides permissions for the browser to access AWS services.

  **Default:** A new role will be created

- `networkConfiguration`: [BrowserNetworkConfiguration](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-bedrock-agentcore-alpha.BrowserNetworkConfiguration.html) — Network configuration for browser.

  **Default:** PUBLIC network mode

- `recordingConfig`: [RecordingConfig](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-bedrock-agentcore-alpha.RecordingConfig.html) — Recording configuration for browser.

  **Default:** No recording configuration

- `tags`: { [key: string]: string } — Tags (optional) A list of key:value pairs of tags to apply to this Browser resource.

  **Default:** {} - no tags
