Getting Started
Prerequisites
Corsha's integration with Kong's API gateway requires a few prerequisites:
- An active Corsha Enterprise or Corsha Cloud deployment
- Corsha Kong Plugin Binary
Obtaining the Binary
For this integration, we will mount a binary of the Corsha Kong Plugin into a Kong image. To get the Corsha Kong Plugin binary, contact your Corsha TPOC.
Configuration Reference
tip
Corsha will provide you with the following values:
| Field | Description |
|---|---|
authServerProxyURL | URL to Corsha Auth Server’s Proxy endpoint |
authServerClientKey | MTLS client key for communicating with the Corsha Auth Server |
authServerClientCert | MTLS client cert for communicating with the Corsha Auth Server |
Example Configuration
Below you will see an example of a Kong declarative configuration for registering a server example-service with the corsha-kong-plugin.
_format_version: "3.0"
services:
- name: example-service
plugins:
- config:
authServerClientCert: |
-----BEGIN CERTIFICATE-----
<omitted>
-----END CERTIFICATE-----
authServerClientKey: |
-----BEGIN EC PRIVATE KEY-----
<omitted>
-----END EC PRIVATE KEY-----
authServerProxyURL: 'https://auth-server-example.domain.net'
name: corsha-kong-plugin
port: 80
routes:
- hosts:
- service.example.com
name: root
paths:
- /
url: https://kong-ee