Skip to content

fix(ai-gateway): AI entities pages audit - #6807

Open
tomek-labuk wants to merge 4 commits into
release/ai-gateway-2.0from
fix/entities-audit
Open

fix(ai-gateway): AI entities pages audit#6807
tomek-labuk wants to merge 4 commits into
release/ai-gateway-2.0from
fix/entities-audit

Conversation

@tomek-labuk

Copy link
Copy Markdown
Contributor

Description

Fixes #issue

Preview Links

Checklist

  • Tested how-to docs. If not, note why here.
  • All pages contain metadata.
  • Any new docs link to existing docs.
  • All autogenerated instructions render correctly (API, decK, Konnect, Kong Manager).
  • Style guide (capitalized gateway entities, placeholder URLs) implemented correctly.
  • Every page has a description entry in frontmatter.
  • Add new pages to the product documentation index (if applicable).

@tomek-labuk
tomek-labuk requested a review from a team as a code owner August 25, 2026 12:51
@netlify

netlify Bot commented Aug 25, 2026

Copy link
Copy Markdown

Deploy Preview for kongdeveloper ready!

Name Link
🔨 Latest commit 936e515
🔍 Latest deploy log https://app.netlify.com/projects/kongdeveloper/deploys/6a8d8fc8bdb194000826d82d
😎 Deploy Preview https://deploy-preview-6807--kongdeveloper.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@cloudjumpercat cloudjumpercat left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few nitpicks/link fixes. I flagged it in a comment, but just wanted to mention that some of the schema links didn't seem active and the linked params were missing from the schema in the docs. I"m guessing that's because we haven't updated the schema in the docs yet? Either way, I'm approving this just in case the schema will be updated later.


- q: How do I authenticate to an upstream service that requires AWS IAM (SigV4) signing?
a: |
Configure [`config.upstream.auth`](#schema-aigateway-mcpserver-config-upstream) with `type: aws`. {{site.ai_gateway}}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not seeing upstream.auth in the schema, maybe the schema in the docs hasn't been updated yet? Just wanted to flag this.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually, that applies to all the schema links in this FAQ, I can't find any of them in the schema in the docs.

Comment on lines +436 to +438
* Static IAM user credentials, `access_key_id` and `secret_access_key`, optionally paired with a `session_token` for temporary credentials.
* Environment auto-detection when you omit `access_key_id` and `secret_access_key`, for example, an EC2 instance profile or environment variables.
* Role assumption through `assume_role_arn` and `role_session_name`, layered on top of either credential source. Recommended for production use and cross-account access.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* Static IAM user credentials, `access_key_id` and `secret_access_key`, optionally paired with a `session_token` for temporary credentials.
* Environment auto-detection when you omit `access_key_id` and `secret_access_key`, for example, an EC2 instance profile or environment variables.
* Role assumption through `assume_role_arn` and `role_session_name`, layered on top of either credential source. Recommended for production use and cross-account access.
* Static IAM user credentials, `access_key_id` and `secret_access_key`, optionally paired with a `session_token` for temporary credentials
* Environment auto-detection when you omit `access_key_id` and `secret_access_key`, for example, an EC2 instance profile or environment variables
* Role assumption through `assume_role_arn` and `role_session_name`, layered on top of either credential source. Recommended for production use and cross-account access.

Create an AI Policy when you want to add governance, security, transformation, or observability to {{site.ai_gateway}} traffic. For example:
- Redact sensitive data with [AI PII Sanitizer](/ai-gateway/policies/ai-sanitizer/)
- Manage request volume with [AI Rate Limiting Advanced](/ai-gateway/policies/ai-rate-limiting-advanced/)
- Validate prompts with [AI Prompt Guard](/ai-gateway/policies/ai-prompt-guard/) or [other guardrail Policies](/ai-gateway/#guardrails-and-content-safety)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Validate prompts with [AI Prompt Guard](/ai-gateway/policies/ai-prompt-guard/) or [other guardrail Policies](/ai-gateway/#guardrails-and-content-safety)
- Validate prompts with [AI Prompt Guard](/ai-gateway/policies/ai-prompt-guard/) or [other guardrail Policies](/ai-gateway/policies/?terms=guardrail)

The original link didn't go anywhere

- Validate prompts with [AI Prompt Guard](/ai-gateway/policies/ai-prompt-guard/) or [other guardrail Policies](/ai-gateway/#guardrails-and-content-safety)
- Track requests and responses for observability with [logging Policies](/ai-gateway/policies/?category=logging)

To control access and verify identity, assign an [AI Identity Provider](/ai-gateway/entities/ai-identity-provider/) instead of an AI Policy.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To control access and verify identity, assign an [AI Identity Provider](/ai-gateway/entities/ai-identity-provider/) instead of an AI Policy.
To control access and verify identity, assign an [AI Auth Strategy](/ai-gateway/entities/ai-auth-strategy/) instead of an AI Policy.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants