Novelty Polygonal Mathematics
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

keycloak-admin-client

0.12.0 • Public • Published

Keycloak Admin Client

Greenkeeper badge

Coverage Status Build Status Known Vulnerabilities dependencies Status

NPM

An Extremely Experimental client for connecting to the Keycloak Admin REST API - http://www.keycloak.org/docs-api/3.2/rest-api/index.html

Project Info
License: Apache-2.0
Build: make
Documentation: http://www.keycloak.org/keycloak-admin-client/index.html
Issue tracker: https://github.com/keycloak/keycloak-admin-client/issues
Engines: Node.js 4.x, 6.x, 8.x

Installation

npm install keycloak-admin-client -S

Usage

'use strict';
 
let adminClient = require('./');
 
let settings = {
  baseUrl: 'http://127.0.0.1:8080/auth',
  username: 'admin',
  password: 'admin',
  grant_type: 'password',
  client_id: 'admin-cli'
};
 
adminClient(settings)
  .then((client) => {
  console.log('client', client);
  client.realms.find()
    .then((realms) => {
    console.log('realms', realms);
    });
  })
  .catch((err) => {
    console.log('Error', err);
  });

Development & Testing

To run the tests, you'll need to have a keycloak server running. No worries! This is all taken care of for you. Just run ./scripts/start-server.sh. If you don't already have a server downloaded, this script will download one for you, start it, initialize the admin user, and then restart.

Then just run the tests.

make test

To stop the server, run ./scripts/stop-server.sh.

Notable Changes from 0.1.0 to 0.2.0

The API has been changed to logically group up(namespace) functionality.

For example, the 0.1.0 way of getting a list of all realms was by calling the client.realms function.

Now in 0.2.0, you would do something like this: client.realms.find

find can also be used to get 1 realm by passing in the realmName: client.realms.find('master')

The other methods have been renamed too, for example, instead of calling client.updateRealm you would now call client.realms.update

Other

The current RFC is located here: https://github.com/bucharest-gold/entente/blob/master/rfcs/keycloak-admin-rest-api-node-client.md

Contributing

Please read the contributing guide

Reporting security vulnerabilities

If you've found a security vulnerability, please look at the instructions on how to properly report it

install

npm i keycloak-admin-client

Downloadsweekly downloads

397

version

0.12.0

license

Apache-2.0

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
  • avatar
  • avatar
  • avatar
  • avatar