Auth client

, _(*1)

This is a client library which encapsulates interaction with Jincor Auth. With its help you can: 1. Register users and tenants. 2. Get tokens for users and tenants after authorization. 3. Perform verification of tokens for users and tenants. 4. Deactivate tokens for users and tenants. 5. Remove users., _(*2)

The user can be attached to several tenants through the field tenant. It is filled from the tenant's token in the Jincor Auth service., _(*3)

Usage

Initialize Auth client

To interact with the HTTP protocol use Guzzle. Headers Accept: application/json and Content-Type: application/json are mandatory., _(*4)

$authClient = new AuthClient(new Client([
    'base_uri' => 'auth:3000',
    'headers' => [
        'Accept' => 'application/json',
        'Content-Type' => 'application/json',
    ]
]));

Work with Tenant

$tenant = $authClient->registerTenant('tenant@example.com', 'Passwpord');
echo $tenant->getId();
// 'af8b13ea-02a9-4e73-b8d9-58c8215757b9'
$tenantToken = $authClient->loginTenant('tenant@example.com', 'Passwpord');
$result = $authClient->verifyTenantToken($tenantToken);
echo $result->getAud();
// 'jincor.com'
$authClient->logoutTenant($tenantToken);

Work with User

To work with users you need a tenant token. Field scope is optional., _(*5)

$userData = [
    'email' => 'user@example.com',
    'password' => 'Password1',
    'login' => 'emp_dev',
    'sub' => '123',
    'scope' => [
        'admin',
        'settings' => 'setting',
    ]
];
$user = $authClient->createUser($userData, $tenantToken);
echo $user->getId();
// '55096b7d-0f14-446a-b50d-ee6bc8431e39'

$userData = [
    'login' => 'emp_dev',
    'password' => 'Password1',
    'deviceId' => '123',
];
$userToken = $authClient->loginUser($userData, $tenantToken);
$result = $authClient->verifyUserToken($userToken, $tenantToken);
$authClient->logoutUser($userToken, $tenantToken);

$authClient->deleteUser($userData['login'], $tenantToken);

More details can be received in the tests., _(*6)