fof/passport

The OAuth2 (and Laravel passport) compatible oauth extension

Fund package maintenance!
Open Collective

Installs: 162

Dependents: 0

Suggesters: 0

Security: 0

Stars: 14

Watchers: 3

Forks: 6

Open Issues: 4

Type:flarum-extension

0.3.0 2020-03-23 02:25 UTC

README

MIT license Latest Stable Version Total Downloads

The Laravel Passport compatible oauth extension.

Installation

Use Bazaar or install manually:

composer require fof/passport

Updating from Flagrow

This extension replaces Flagrow Passport.

To upgrade from the old extension to the new one:

  • Backup your data!

  • Disable the Passport extension in the admin panel.

  • Run:

composer require fof/passport

Composer should let you know that flagrow/passport has been automatically removed.

  • Enable the new extension in the admin panel.

  • Your existing settings will be migrated to FoF Passport automatically.

  • You should be good to go! All URLs stay the same.

Configuration

In the extension settings, you have to fill the following data:

Setting Example Description
OAuth authorization url https://example.com/oauth/authorize <your laravel install>/oauth/authorize
OAuth token url https://example.com/oauth/token <your laravel install>/oauth/token
Api URL providing user details when authenticated https://example.com/api/user Default Laravel installs have an /api/user route, otherwise point to a route returning the current user data (protected by the passport driver)
OAuth application id 1 The integer Client ID you've made in the Laravel app or via artisan passport:client
OAuth application secret abcdefghijABCDEFGHIJabcdefghijABCDEFGHIJ The Client secret provided by Laravel once you created the OAuth client
OAuth scopes to request Optional additional scopes to request during authorization, perhaps you want to protect the user url with a scope or add additional functionality
Label for login button Login with Example Label to place on the login button
Icon for login button far fa-id-card FontAwesome icon to place on the login button. List of available icons

Hint: When creating the OAuth client in your Laravel app, don't forget to set the redirect value to <your flarum install>/auth/passport or you might encounter invalid_client errors.

Links

An extension by FriendsOfFlarum