fof / passport
The OAuth2 (and Laravel passport) compatible oauth extension
Fund package maintenance!
Website
Installs: 2 844
Dependents: 1
Suggesters: 0
Security: 0
Stars: 21
Watchers: 4
Forks: 10
Open Issues: 4
Type:flarum-extension
Requires
- flarum/core: ^1.0
- league/oauth2-client: ^2.3.0
Replaces
This package is auto-updated.
Last update: 2022-05-09 19:54:01 UTC
README
The Laravel Passport compatible oauth extension.
Installation
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