kong-plugin-route-by-cookie

Kong plugin for dynamically change upstream url based on cookies.

Overview

This Kong plugin allows you to route client request based on user cookies. It is inspired by Route By Header.

Usage

Enabling the plugin on a Service

curl -X POST http://kong:8001/services/{service}/plugins \
    --data "name=route-by-cookie"  \
    --data "config.target_upstream=new-upstream" \
    --data "config.cookie_name=COOKIE_NAME" \
    --data "config.cookie_val=value"

Enabling the plugin on a Route

curl -X POST http://kong:8001/routes/{route_id}/plugins \
    --data "name=route-by-cookie"  \
    --data "config.target_upstream=new-upstream" \
    --data "config.cookie_name=COOKIE_NAME" \
    --data "config.cookie_val=value"

Config

• target_upstream: Kong Upstream which we want to route the request to
• config.cookie_name: Cookie name which we will check at
• config.cookie_val: If user's cookie value equals this, Kong will route the user to target_upstream

Supported Kong Releases

Kong >= 2.0

Should work with 1.X but not tested

Installation

luarocks install kong-plugin-route-by-cookie

Tests

You need Pongo to run the tests.

pongo run

Expected output:

Kong version: 2.2.0
●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●
49 successes / 0 failures / 0 errors / 0 pending : 5.379104 seconds

Maintainers

redhoyasa utix