# BrowserCustomProps

Properties for creating a Browser resource.

Extends: BrowserCustomProps
Used as props by: BrowserCustom

- Source: [`aws-bedrockagentcore/lib/tools/browser.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-bedrockagentcore/lib/tools/browser.ts#L536)
- Type last changed: v2.255.0 · 19 May 2026

## Example

```ts
const browser = new agentcore.BrowserCustom(this, 'BrowserVpcWithRecording', {
  browserCustomName: 'browser_recording',
  networkConfiguration: agentcore.BrowserNetworkConfiguration.usingVpc(this, {
    vpc: new ec2.Vpc(this, 'VPC', { restrictDefaultSecurityGroup: false }),
  }),
});
```

## Properties

- `browserCustomName`: string — The name of the browser custom tool 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](/cdk/api/v2/docs/aws-cdk-lib.aws_bedrockagentcore.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](/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](/cdk/api/v2/docs/aws-cdk-lib.aws_bedrockagentcore.BrowserNetworkConfiguration.html) — Network configuration for browser.

  **Default:** PUBLIC network mode

- `recordingConfig`: [RecordingConfig](/cdk/api/v2/docs/aws-cdk-lib.aws_bedrockagentcore.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