Passport by FriendsOfFlarum

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

• Flarum Discuss post
• Source code on GitHub
• Report an issue
• Download via Packagist

An extension by FriendsOfFlarum