You are browsing documentation for an older version. See the latest documentation here.

Guides

Follow one of the guides to learn more about how to use the Kong Ingress Controller:

Getting started with the Kong Ingress Controller
Getting started using Istio with the Kong Ingress Controller and Istio
Using KongPlugin resource This guide walks through setting up plugins in Kong using a declarative approach.
Using KongIngress resource This guide explains how the KongIngress resource can be used to change Kong specific settings like load-balancing, health-checking and proxy behaviour.
Using KongConsumer resources This guide walks through how Kubernetes native declarative configuration can be used to dynamically provision credentials for authentication purposes in the Ingress layer.
Using JWT and ACL KongPlugin resources This guides walks you through configuring the JWT plugin and ACL plugin for authentication purposes at the Ingress layer
Using cert-manager with Kong This guide walks through how to use cert-manager along with Kong Ingress Controller to automate TLS certificate provisioning and using them to encrypt your API traffic.
Configuring a fallback service This guide walks through how to setup a fallback service using Ingress resource. The fallback service will receive all requests that don’t match against any of the defined Ingress rules.
Using external service This guide shows how to expose services running outside Kubernetes via Kong, using External Name Services in Kubernetes.
Configuring HTTPS redirects for your services This guide walks through how to configure the Kong Ingress Controller to redirect HTTP request to HTTPS so that all communication from the external world to your APIs and microservices is encrypted.
Using Redis for rate-limiting This guide walks through how to use Redis for storing rate-limit information in a multi-node Kong deployment.
Integrate the Kong Ingress Controller with Prometheus/Grafana This guide walks through the steps of how to deploy the Kong Ingress Controller and Prometheus to obtain metrics for the traffic flowing into your Kubernetes cluster.
Configuring circuit-breaker and health-checking This guide walks through the usage of Circuit-breaking and health-checking features of the Kong Ingress Controller.
Setting up custom plugin This guide walks through installation of a custom plugin into Kong using ConfigMaps and Volumes.
Setting up upstream mTLS This guide gives an overview of how to setup mutual TLS authentication between Kong and your upstream server.
Preserving Client IP address This guide gives an overview of different methods to preserve the Client IP address.
Using KongClusterPlugin resource This guide walks through setting up plugins that can be shared across Kubernetes namespaces.
Using Kong with Knative This guide gives an overview of how to setup Kong as the Ingress point for Knative workloads.
Exposing TCP/UDP/gRPC services
- Exposing TCP-based service This guide gives an overview of how to use TCPIngress/TCPRoute resources to expose non-HTTP-based services outside a Kubernetes cluster.
- Exposing UDP-based service This guide gives an overview of how to use UDPIngress/UDPRoute resources to expose non-HTTP-based services outside a Kubernetes cluster.
- Exposing gRPC-based service This guide gives an overview of how to use Ingress/GRPCRoute resources to expose gRPC-based services outside a Kubernetes cluster.
Using mtls-auth plugin This guide gives an overview of how to use mtls-auth plugin and CA certificates to authenticate requests using client certificates.
Using OpenID-connect plugin This guide walks through steps necessary to set up OIDC authentication.
Allow Multiple Authentication Plugins This guide walks through the steps for configuring multiple authentication options for consumers.
Using Gateway Discovery This guide walks through the steps for configuring Kong Gateway and Kong Ingress Controller in separate deployments with KIC being able to dynamically discover Gateways.