Search by

vested-networks / phonemgr-socialite

wg-vn

Sign in with Phone Manager: a Socialite driver for Phone Manager's OpenID Connect provider, and verification of its provisioning tokens.

Package info

github.com/Vested-Networks/phonemgr-socialite

pkg:composer/vested-networks/phonemgr-socialite

Statistics

Installs: 3

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v0.1.1 2026-11-19 00:06 UTC

This package is auto-updated.

Last update: 2026-11-19 00:20:23 UTC


README

Sign in with Phone Manager in a Laravel app: a Socialite driver phonemgr for Phone Manager's OpenID Connect provider, and verification of the tokens Phone Manager signs when it calls the app's provisioning API.

Install

composer require vested-networks/phonemgr-socialite

The service provider is auto-discovered and registers the phonemgr driver.

Configure

In config/services.php:

'phonemgr' => [
    'issuer' => env('PHONEMGR_ISSUER'),             // public URL; the browser goes here, and `iss` must match it
    'internal_url' => env('PHONEMGR_INTERNAL_URL'), // where the app reaches Phone Manager server to server
    'client_id' => ...,
    'client_secret' => ...,
    'redirect' => ...,                               // the app's callback URL, registered in Phone Manager
],

internal_url may equal issuer when there is no private network between the app and Phone Manager. The client id, secret and redirect can also be set at runtime, before Socialite::driver('phonemgr').

Sign in

return Socialite::driver('phonemgr')->redirect();

// callback
$account = Socialite::driver('phonemgr')->user();
$account->getId();          // `sub`, permanent: match the local account by this only
$account->getRaw()['role']; // the person's role in this app

Authorization code flow with PKCE S256, scopes openid profile email phonemgr. The code is exchanged at {internal_url}/oauth/token, and the account is read from the id_token, checked against the keys at {internal_url}/oauth/jwks (cached for an hour, refetched once for an unknown key). A callback with error=access_denied means Phone Manager refused the person; show that, do not retry.

Provisioning API

Phone Manager creates, updates and deactivates the app's accounts by calling PUT and DELETE {provisioning-url}/owners/{sub} with Authorization: Bearer <JWT>. Check that token in the app's middleware:

use VestedNetworks\PhoneManager\PhoneManagerTokens;

try {
    app(PhoneManagerTokens::class)->verifyProvisioning((string) $request->bearerToken(), $clientId);
} catch (UnexpectedValueException) {
    abort(401);
}

It accepts only an RS256 token signed with a key from Phone Manager's JWKS, with iss = the issuer, aud = the app's client id, sub = phonemgr, and not expired.

Tests

composer install
composer test

Releasing

Add a section for the version to CHANGELOG.md, then push a tag such as v0.1.2. Packagist picks up the tag through its GitHub webhook, and the Release workflow creates the GitHub release from that section.

License

MIT. See LICENSE.