treehouselabs/keystone-client

An HTTP client with automatic authentication for an OpenStack Identity Service API a.k.a. Keystone

Keystone Client

![Software License][ico-license] ![Coverage Status][ico-scrutinizer] , _(*1)

A client to use when communicating with Keystone services. Uses Guzzle as the actual HTTP client library., _(*2)

Installation

composer require treehouselabs/keystone-client:~3.0

Usage

Use the ClientFactory to create a Guzzle Client with. The factory attaches middleware that automatically requests a Keystone token and signs outgoing requests with it., _(*3)

In the case of an expired token, and the request fails, a new token is fetched automatically and the request is retried with the new token., _(*4)

use TreeHouse\Cache\CacheInterface;
use TreeHouse\Keystone\Client\ClientFactory;
use TreeHouse\Keystone\Client\Model\Tenant;

$tokenUrl     = 'http://example.org/tokens';
$username     = 'acme';
$password     = 's3cr4t';
$serviceType  = 'compute';
$serviceName  = 'api';

// $cache is a TreeHouse\Cache\CacheInterface instance
$tenant  = new Tenant($tokenUrl, $username, $password, $serviceType, $serviceName);
$client  = (new ClientFactory($cache))->createClient($tenant);

// now just use $client as you would a regular Guzzle client
$response = $client->get('posts/');

Testing

bash composer test, _(*5)

Security

If you discover any security related issues, please email peter@treehouse.nl instead of using the issue tracker., _(*6)

License

The MIT License (MIT). Please see License File for more information., _(*7)

Credits

• Peter Kruithof
• All Contributors