noriel0010/third-party-sso

PHP Library to verify and validate 3rd party AccessToken/IdToken from different Social Media (facebook, microsoft, google, linkedin and apple) and authenticate a User with mentioned social media id

1.0.0 2021-03-29 05:51 UTC

Requires

• php: ^7.1
• ext-mbstring: *
• ext-openssl: *
• guzzlehttp/guzzle: ^6.0|^7.0
• lcobucci/jwt: 3.3.3
• phpseclib/phpseclib: ^2.0

Requires (Dev)

• phpunit/phpunit: ^9

MIT

• Noriel Francisco

• SSO
• google
• facebook
• apple
• linkedin
• microsoft
• apple id
• apple sign in
• Apple log in
• Apple authentication
• Third Party
• Third Party SSO
• Third Party authentication
• Facebook log in
• Facebook sign in
• Facebook ID
• Facebook authentication
• Google log in
• Google sign in
• Google ID
• Google authentication
• Microsoft log in
• Microsoft sign in
• Microsoft ID
• Microsoft authentication
• Linkedin log in
• Linkedin sign in
• Linkedin ID
• Linkedin authentication

README

Installation

Install this library through Composer.

composer require noriel0010/third-party-sso

Sample Usage

use Noriel\SSO\Auth\Service\ThirdPartyService;

$service = new ThirdPartyService();

try {
    $apple = $service->apple('apple.identity.token', 'your.app.as.audience')->authenticate();
    $facebook = $service->facebook('facebook.access.token')->authenticate();
    $google = $service->google('google.access.token', 'google_key')->authenticate();
    $linkedin = $service->linkedin('linkedin.access.token')->authenticate();
    $microsoft = $service->microsoft('microsoft.access.token')->authenticate();
} catch (\Throwable $th) {
    echo $th->getMessage();
}

The authenticate() method returns Object Data Type

Apple

For Apple, this assumes that you already have generated identityToken either from accessToken or from refresh_token. Remember that identityToken is valid ONLY for 10 minutes.

Uses

• Apple ID API
• Lcobucci JSON Web Token 3.3.3
• Guzzle
• https://appleid.apple.com as Default issuer

Test

To test Apple, you can paste your freshly generated identityToken in test/Apple/AppleTest.php:24 and your audience in test/Apple/AppleTest.php:25 then run .\vendor\bin\phpunit test/Apple.

Facebook

For Facebook, this assumes that you already have generated accessToken.

Uses

• Graph Facebook v4.0
• Guzzle
• id,name,email as Default Facebook Fields

Test

To test Facebook, you can paste your freshly generated accessToken in test/Facebook/FacebookTest.php:24 then run .\vendor\bin\phpunit test/Facebook.

Google

For Google, this assumes that you already have generated accessToken and Google API key.

Uses

• Google Person API v1
• Guzzle
• names,emailAddresses as Default Google personFields Query Parameter

Test

To test Google, you can paste your freshly generated accessToken in test/Google/GoogleTest.php:24 and your key in test/Google/GoogleTest.php:25 then run .\vendor\bin\phpunit test/Google.

LinkedIn

For LinkedIn, this assumes that you already have generated accessToken.

Uses

• Linkedin API v2
• Guzzle
• (elements*(handle~)) as Default Linkedin Email Projection

Test

To test Linkedin, you can paste your freshly generated accessToken in test/Linkedin/LinkedinTest.php:24 then run .\vendor\bin\phpunit test/Linkedin.

Microsoft

For Microsoft, this assumes that you already have generated accessToken.

Uses

• Graph Microsoft API v1
• Guzzle

Test

To test Microsoft, you can paste your freshly generated accessToken in test/Microsoft/MicrosoftTest.php:24 then run .\vendor\bin\phpunit test/Microsoft.