Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions modules/gateway/pages/bedrock-setup.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -119,6 +119,7 @@ A successful model response confirms the IAM policy, region, and credentials are
. Select *AWS Bedrock* as the provider type.
. Enter a Name such as `my-bedrock`. Use lowercase letters, digits, and hyphens. The name is immutable and appears in the proxy URL.
. Select the Region where you want to invoke Bedrock, such as `us-east-1`.
. For Credential type, select *Static keys*. (This guide uses the access keys you created above. For the default-chain and assume-role options, see xref:gateway:configure-provider.adoc[Configure an LLM provider].)
. Configure the credentials:
+
.. In the Access key ID ref dropdown, type a secret name such as `AWS_ACCESS_KEY_ID`.
Expand Down
22 changes: 19 additions & 3 deletions modules/gateway/pages/configure-provider.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -138,17 +138,33 @@ AWS Bedrock::
|`Base URL`
|Optional. Override the default regional Bedrock endpoint.

|`Credential type`
|How AI Gateway authenticates to Bedrock: *Default chain*, *Static keys*, or *Assume IAM role*. The fields below depend on the mode you pick.

|`Access key ID reference`
|Secret-store reference for the AWS access key ID, `UPPER_SNAKE_CASE` (typically `AWS_ACCESS_KEY_ID`). Leave both credential references empty to fall back to the default credential chain (environment variables, IRSA, EKS Pod Identity, or instance profile).
|*Static keys only.* Secret-store reference for the AWS access key ID, `UPPER_SNAKE_CASE` (typically `AWS_ACCESS_KEY_ID`).

|`Secret access key reference`
|Secret-store reference for the AWS secret access key, `UPPER_SNAKE_CASE` (typically `AWS_SECRET_ACCESS_KEY`).
|*Static keys only.* Secret-store reference for the AWS secret access key, `UPPER_SNAKE_CASE` (typically `AWS_SECRET_ACCESS_KEY`).

|`Role ARN`
|*Assume IAM role only.* Required. ARN of the IAM role AI Gateway assumes through AWS STS, for example `arn:aws:iam::123456789012:role/BedrockRole`.

|`External ID`
|*Assume IAM role only.* Optional. External ID for cross-account role assumption. Set it only when the role's trust policy mandates an external ID.

|`Session name`
|*Assume IAM role only.* Optional. Session name that appears in AWS CloudTrail audit logs, for example `redpanda-adp`.

|`Guardrail`
|Optional. Name of a xref:control:guardrails/overview.adoc[guardrail] to attach to this provider, or empty for none. Only the Bedrock provider type exposes this setting. AI Gateway validates the name when you save: it rejects a guardrail that doesn't exist or is being deleted, so set the field to an existing guardrail or leave it empty. See xref:control:guardrails/create-guardrail.adoc[Create a guardrail].
|===
+
The create form exposes static credentials (and the default-chain fallback when you leave both references empty). To configure an assume-role credential (`role_arn`, optional `external_id` when the role's trust policy mandates it, and optional `session_name` that surfaces in CloudTrail), use the API or the `rpk ai llm` CLI instead of the form.
Pick a *Credential type* to control how AI Gateway authenticates to Bedrock:
+
* *Default chain* (default): Leave the credentials unset to use the AWS SDK's default provider chain (environment variables, shared config, EKS Pod Identity, IRSA, or instance profile). Use this when the gateway already runs with an AWS identity.
* *Static keys*: An access key pair stored in the secret store. Use this when no ambient AWS identity is available. This is the path the xref:gateway:bedrock-setup.adoc[Bedrock setup guide] walks through.
* *Assume IAM role*: AI Gateway assumes an IAM role through AWS STS. Use this for cross-account access or when your security policy requires short-lived credentials.

OpenAI-compatible::
+
Expand Down