authsignal/authsignal-php

Authsignal is a passwordless authentication/multifactor authentication step up service with a FraudOps rules engine

1.0.3 2024-04-02 23:48 UTC

Requires

• firebase/php-jwt: ^6.8

Requires (Dev)

• donatj/mock-webserver: ^2.5
• phpunit/phpunit: ^9.5

MIT

README

Check out our official PHP SDK documentation.

Installation

1. Add Authsignal's library as a depependency in composer.json

"require": {
    ...
    "authsignal/authsignal-php" : "0.1.5"
    ...
}

1. Run composer update.
2. Now Authsignal will be autoloaded into your project.

Initialization

Initialize the Authsignal SDK, ensuring you do not hard code the Authsignal Secret Key, always keep this safe.

Authsignal::setApiKey('secretKey');

You can find your secretKey in the Authsignal Portal.

Region selection

Authsignal has multiple api hosting regions. To view your hostname for your tenant, find it in the Authsignal Portal.

Region	Base URL
US (Oregon)	https://signal.authsignal.com/v1
AU (Sydney)	https://au.signal.authsignal.com/v1
EU (Dublin)	https://eu.signal.authsignal.com/v1

You can set the hostname via the following code. If the setApiHostname function is not called, the api call defaults to the main Authsignal US region hostname https://signal.authsignal.com

An example setting the client to use the AU region.

Authsignal::setApiHostname("https://au.signal.authsignal.com");

Alternatively, an environment variable can be used to set the base URL:

AUTHSIGNAL_SERVER_API_ENDPOINT=https://au.signal.authsignal.com/v1

Usage

Authsignal's server side signal API has five main calls track, getAction, getUser, enrollVerifiedAuthenticator, verifyChallenge

For more details on these api calls, refer to our official PHP SDK docs.

License

The library is available as open source under the terms of the MIT License.