fof / passport
The OAuth2 (and Laravel passport) compatible oauth extension
Fund package maintenance!
Website
Installs: 3 684
Dependents: 1
Suggesters: 0
Security: 0
Stars: 24
Watchers: 4
Forks: 11
Open Issues: 8
Type:flarum-extension
Requires
- flarum/core: ^1.0
- league/oauth2-client: ^2.3.0
Replaces
- dev-master
- 1.0.0
- 0.6.0
- 0.5.1
- 0.5.0
- 0.4.0
- 0.3.0
- 0.2.0-beta
- 0.1.0-beta.1
- dev-dependabot/npm_and_yarn/js/json5-1.0.2
- dev-dependabot/npm_and_yarn/js/decode-uri-component-0.2.2
- dev-dependabot/npm_and_yarn/js/loader-utils-1.4.2
- dev-dependabot/npm_and_yarn/js/terser-4.8.1
- dev-dependabot/npm_and_yarn/js/minimist-1.2.6
- dev-flarum-1-0-update
This package is auto-updated.
Last update: 2023-02-07 04:07:40 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