istio:ambient-waypoint

Configure L7 AuthorizationPolicy in Istio Ambient mode with waypoint proxies.

292|103|Updated Mar 27, 2025
One-click install
npx skills add https://github.com/kagenti/kagenti --skill istio-ambient-waypoint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: istio:ambient-waypoint
Source: https://github.com/kagenti/kagenti/tree/main/.claude/skills/istio%3Aambient-waypoint
Command: npx skills add https://github.com/kagenti/kagenti --skill istio-ambient-waypoint

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the configuration of L7 AuthorizationPolicies in Istio Ambient mode, enabling fine-grained access control for services without sidecars.

Core Features & Use Cases

  • Waypoint Gateway Configuration: Define and deploy waypoint gateways for L7 traffic inspection.
  • Service Integration: Label services to direct traffic through configured waypoints.
  • AuthorizationPolicy with targetRefs: Implement path, method, and principal-based access controls using Istio's AuthorizationPolicy resource with targetRefs.
  • Use Case: Securely expose an MLflow service, allowing only the OTEL collector to POST traces to /v1/traces and the Kagenti UI to access all other endpoints.

Quick Start

Configure an Istio Ambient Waypoint for the 'mlflow' service in the 'kagenti-system' namespace to allow POST requests to '/v1/traces' from the 'otel-collector' service account.

Frequently Asked Questions about istio:ambient-waypoint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure L7 AuthorizationPolicy in Istio Ambient mode?

You configure L7 AuthorizationPolicy in Istio Ambient mode by deploying waypoint proxies and labeling services to route traffic through them. This enables layer seven traffic inspection for granular access control without sidecars.

Why do I need a waypoint proxy when using Istio Ambient mesh?

You need a waypoint proxy in Istio Ambient mesh because the default ztunnel only handles L4 traffic. Waypoint proxies provide the L7 traffic evaluation required to enforce granular access controls based on HTTP methods and paths.

How do I restrict HTTP methods and paths for specific service accounts in Istio?

You restrict HTTP methods and paths in Istio by defining an AuthorizationPolicy with targetRefs attached to a waypoint. This enforces principal-based access control for specific HTTP requests like POSTing to designated paths.

Can I secure service access in Kubernetes without using sidecar proxies?

Yes, you can secure service access in Kubernetes without sidecar proxies by using Istio Ambient mode. You deploy waypoint gateways and apply AuthorizationPolicy resources with targetRefs to enforce L7 access controls directly.

How do I label a Kubernetes service to route traffic through an Istio waypoint?

You label a Kubernetes service to route traffic through an Istio waypoint by applying the appropriate service labels. This directs the service traffic through the configured waypoint gateway for L7 inspection and policy enforcement.