https://github.com/stone-payments/kong-plugin-template-transformer

Kong API Gateway plugin to transform requests with Lua templates
https://github.com/stone-payments/kong-plugin-template-transformer

api-gateway kong kong-plugin lua satisfacao-do-cliente

Last synced: about 2 months ago
JSON representation

Kong API Gateway plugin to transform requests with Lua templates

• Host: GitHub
• URL: https://github.com/stone-payments/kong-plugin-template-transformer
• Owner: stone-payments
• License: apache-2.0
• Created: 2018-04-10T20:27:13.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-01-15T19:13:44.000Z (8 months ago)
• Last Synced: 2024-06-22T23:51:04.829Z (3 months ago)
• Topics: api-gateway, kong, kong-plugin, lua, satisfacao-do-cliente
• Language: Lua
• Homepage:
• Size: 340 KB
• Stars: 43
• Watchers: 33
• Forks: 14
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
# Kong-plugin-template-transformer

[![Build Status](https://travis-ci.org/stone-payments/kong-plugin-template-transformer.svg?branch=master)](https://travis-ci.org/stone-payments/kong-plugin-template-transformer)

This is a Kong middleware to transform requests / responses, using pre-configured templates. This plugin has been tested to work along with kong >= 2.6.x, for a legacy version of this plugin, please check [this link](https://github.com/stone-payments/kong-plugin-template-transformer/tree/legacy/v0).

## The Problem

When using Kong, you can create routes that proxy to an upstream. The problem lies when the upstream has an ugly response/request contract. Sometimes the [kong bundled request transformer](https://docs.konghq.com/hub/kong-inc/request-transformer/) is not enough. This plugin was created for those situations, it can apply a [template](https://github.com/bungle/lua-resty-template) to JSON requests and responses, transforming them pretty much however you like.

## Project Structure

The plugin folder should contain at least a `schema.lua` and a `handler.lua`, alongside with a `spec` folder and a `.rockspec` file specifying the current version of the package.

## Writing Templates

We use [lua-resty-template](https://github.com/bungle/lua-resty-template) to write templates. It's also **very important** that you don't leave any `\t` in the files. We also only support JSON requests and responses for now.

## Examples

Inside `kong-plugin-template-transformer/template-transformer/validator/json/examples` you'll find some examples for json templates and request files.

## Rockspec Format

The `.rockspec` file should follow [LuaRocks' conventions](https://github.com/luarocks/luarocks/wiki/Rockspec-format)

## Configuration

### Enabling the plugin on a Route

Configure this plugin on a Route with:

```bash

curl -X POST http://kong:8001/routes/{route_id}/plugins \

    --data "name=kong-plugin-template-transformer"  \

    --data "config.request_template=http://new-url.com"

    --data "config.response_template=http://new-url.com"

    --data "config.hidden_fields=http://new-url.com"

```

- route_id: the id of the Route that this plugin configuration will target.

- config.request_template: Optional, the template to be applied before proxying to the upstream.

- config.response_template: Optional, the template to be applied before returning to the client.

- config.hidden_fields: Optional, a list of request or response fields that you do not want Kong to save them in a log file.

## Developing

### In docker

```bash

docker build . -t kong-plugin-template-transformer-dev

docker run -it -v ${PWD}/template-transformer:/template-transformer kong-plugin-template-transformer-dev bash

```

## Credits

made with :heart: by Stone Payments