| Package Data | |
|---|---|
| Maintainer Username: | Omranic |
| Maintainer Contact: | help@rinvex.com (Rinvex LLC) |
| Package Create Date: | 2016-11-17 |
| Package Last Update: | 2023-07-03 |
| Language: | PHP |
| License: | MIT |
| Last Refreshed: | 2024-11-08 03:09:17 |
| Package Statistics | |
|---|---|
| Total Downloads: | 62,435 |
| Monthly Downloads: | 1,579 |
| Daily Downloads: | 48 |
| Total Stars: | 34 |
| Total Watchers: | 4 |
| Total Forks: | 7 |
| Total Open Issues: | 0 |
This package is just a Laravel wrapper for rinvex/authy.
Rinvex Authy is a simple wrapper for Authy TOTP API, the best rated Two-Factor Authentication service for consumers, simplest 2fa Rest API for developers and a strong authentication platform for the enterprise.
Usage is pretty easy and straightforward:
Get Authy app instance and interact with it:
$authyApp = app('rinvex.authy.app');
$appStats = $authyApp->stats(); // Get app stats
$appDetails = $authyApp->details(); // Get app details
Get Authy user instance and interact with it:
$authyUser = app('rinvex.authy.user');
$user = $authyUser->register('user@domain.com', '317-338-9302', '54'); // Register user
$userActivity = $authyUser->registerActivity($user->get('user')['id'], 'cookie_login', 'Test Data'); // Register user activity
$userStatus = $authyUser->status($user->get('user')['id']); // Get user status
$userDeleted = $authyUser->delete($user->get('user')['id']); // Delete user
Get Authy token instance and interact with it:
$authyToken = app('rinvex.authy.token');
$smsTokenSent = $authyToken->send($user->get('user')['id'], 'sms'); // Send SMS token
$callTokenStarted = $authyToken->send($user->get('user')['id'], 'call'); // Start automated call
$tokenVerified = $authyToken->verify(54321, $user->get('user')['id']); // Verify token
Work Intuitively with Authy responses:
$body = $tokenVerified->body(); // Get all response body
$code = $tokenVerified->statusCode(); // Get response status code
$succeed = $tokenVerified->succeed(); // Check whether respose is a success
$failed = $tokenVerified->failed(); // Check whether respose is a failure
$message = $tokenVerified->message(); // Get response message
$item = $tokenVerified->get('item'); // Get response body item
$errors = $tokenVerified->errors(); // Get response errors
Note: All authy requests return authy response, with a unified interface for your convenience, so you can interact with all responses the same way as above.
Install the package via composer:
composer require rinvex/laravel-authy
If you don't have the following lines already, add them to your config/services.php file, before the end of the array:
'authy' => [
'secret' => env('AUTHY_SECRET'),
],
If you haven't already: Register an Authy account -> Sign in -> Access dashboard -> Create new application -> Copy your API Secret key
If you don't have the following lines already, add them to your project's .env file, at the end:
AUTHY_SECRET=AuthySecretKey
Note: make sure to replace
AuthySecretKeywith your key from the previous step.
Done! You can refer to Usage again.
Upgrading To v2.x From v1.x
API implementation is 100% backward compatible, but sandbox API has been dropped since it's officially deprecated. Also note that PHP7 is now required. Lastly the config options has been changed from services.authy.mode, services.authy.keys.production, and services.authy.keys.sandbox to only one key services.authy.secret for ease of use and consistency, accordingly the environment variables AUTHY_MODE, AUTHY_PRODUCTION_KEY, and AUTHY_SANDBOX_KEY are replaced with only one environment variable AUTHY_SECRET.
Refer to the Changelog for a full history of the project.
The following support channels are available at your fingertips:
Thank you for considering contributing to this project! The contribution guide can be found in CONTRIBUTING.md.
Bug reports, feature requests, and pull requests are very welcome.
If you discover a security vulnerability within this project, please send an e-mail to help@rinvex.com. All security vulnerabilities will be promptly addressed.
Rinvex is a software solutions startup, specialized in integrated enterprise solutions for SMEs established in Alexandria, Egypt since June 2016. We believe that our drive The Value, The Reach, and The Impact is what differentiates us and unleash the endless possibilities of our philosophy through the power of software. We like to call it Innovation At The Speed Of Life. That’s how we do our share of advancing humanity.
This software is released under The MIT License (MIT).
(c) 2016-2019 Rinvex LLC, Some rights reserved.