Nonvoluntary Professional Mangling
Unleash awesomeness. Private packages, team management tools, and powerful integrations. Get started with npm Orgs »

@articulate/kongfig

1.2.4 • Public • Published

Kongfig

A tool for Kong to allow declarative configuration.

Simply define your list of api's and consumers in json and then run kongfig to ensure that your Kong is configured correctly.

Build Status

Install

Manually

We recommend installing Kongfig globally

npm install -g kongfig

Puppet

Use our Puppet-Kongfig module to install and configure Kongfig

puppet module install mybuilder-kongfig

Quick start

You can follow the quick start to get going in 5 minutes.

Apply config

You can have your config in json, yaml, or js if you need to support multiple environments.

kongfig apply --path config.yml --host localhost:8001

Dump config

You can dump the existing configuration to a file or view it on a screen

kongfig dump --host localhost:8001 > config.yml

You can omit the --host option if kong is on localhost:8001 as this is the default value

You can specify the desired format by giving --format option with possible options of json, yaml, or screen that prints the config with colours.

kongfig dump --format screen

Schema

Api schema:

apis:
  name: mockbin # unique api name 
    attributes:
      request_host:
      request_path:
      strip_request_path:
      preserve_host:
      upstream_url: # (required) 

Api plugin schema:

apis:
  name: mockbin # unique api name 
    attributes: # ... 
    plugins:
      name: rate-limiting # kong plugin name 
      attributes: # the plugin attributes 
          consumer_id:
          config:
 

All of the kong plugins should be supported if you find one that doesn't work please add an issue.

Consumer schema:

consumers:
  username: iphone-app

Consumer credential schema:

consumers:
  username: iphone-app
    credentials:
      name: key-auth
        attributes: # credential config attributes 

Consumer ACL schema:

consumers:
  username: iphone-app
    acls:
      group: acl-group-name

Supported consumer credentials

Key Authentication

apis:
  name: mockbin # unique api name 
    attributes: # ... 
    plugins:
      name: key-auth
      attributes:
          config:
            key_names:
            hide_credentials:
 
consumers:
  username: iphone-app
    credentials:
      name: key-auth
        attributes:
          key: # required 

Basic Authentication

apis:
  name: mockbin
    attributes: # ... 
    plugins:
      name: key-auth
      attributes:
          config:
            hide_credentials:
 
consumers:
  username: iphone-app
    credentials:
      name: basic-auth
        attributes:
          username: # required 
          password:

OAuth 2.0 Authentication

apis:
  name: mockbin
    attributes: # ... 
    plugins:
      name: oauth2
      attributes:
          config:
            scopes:
            mandatory_scope:
            token_expiration:
            enable_authorization_code:
            enable_client_credentials:
            enable_implicit_grant:
            enable_password_grant:
            hide_credentials:
 
consumers:
  username: iphone-app
    credentials:
      name: oauth2
        attributes:
          name:
          client_id: # required 
          client_secret:
          redirect_uri: # required by kong 

HMAC Authentication

apis:
  name: mockbin
    attributes: # ... 
    plugins:
      name: hmac-auth
      attributes:
          config:
            hide_credentials:
            clock_skew:
 
consumers:
  username: iphone-app
    credentials:
      name: hmac-auth
        attributes:
          username: # required 
          secret:

JWT

apis:
  name: mockbin
    attributes: # ... 
    plugins:
      name: jwt
      attributes:
          config:
            uri_param_names:
            claims_to_verify:
 
consumers:
  username: iphone-app
    credentials:
      name: jwt
        attributes:
          key: # required 
          secret:

ACL Support

Kong ACL documentation

apis:
  name: mockbin
    attributes: # ... 
    plugins:
      name: "acl"
        ensure: "present"
        attributes:
          config.whitelist: "foo-group"
 
consumers:
  username: "some-username"
    ensure: "present"
    acls:
      group: "foo-group"
        ensure: "present"
 
      group: "bar-group"
        ensure: "present"

Created by MyBuilder - Check out our blog for more information and our other open-source projects.

Contributing to Kongfig

We are very grateful for any contributions you can make to the project.

Visit the Contributing documentation for submission guidelines.

Keywords

none

install

npm i @articulate/kongfig

Downloadsweekly downloads

2

version

1.2.4

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
Report a vulnerability