PHPackages burnthebook/craft-flarum-sso - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. burnthebook/craft-flarum-sso ActiveCraft-plugin burnthebook/craft-flarum-sso ============================ Adds Single Sign On (SSO) for Craft 4 as master with Flarum as slave 1.0.6(1y ago)33162mitPHPPHP >=8.0.2 Since Feb 7Pushed 1y ago1 watchersCompare [ Source](https://github.com/Burnthebook/craft-flarum-sso)[ Packagist](https://packagist.org/packages/burnthebook/craft-flarum-sso)[ RSS](/packages/burnthebook-craft-flarum-sso/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (6)Versions (8)Used By (0) Flarum SSO for Craft 4 ====================== [](#flarum-sso-for-craft-4) Adds Single Sign On (SSO) for Craft 4 as a parent with Flarum as child Requirements ------------ [](#requirements) This plugin requires Craft CMS 4.5.0 or later, and PHP 8.0.2 or later. This plugin also requires the [Flarum SSO Extension](https://github.com/maicol07/flarum-ext-sso) installing and configuring on your Flarum installation. Installation ------------ [](#installation) You can install this plugin from the Plugin Store or with Composer. #### From the Plugin Store [](#from-the-plugin-store) Go to the Plugin Store in your project’s Control Panel and search for “Flarum SSO for Craft 4”. Then press “Install”. #### With Composer [](#with-composer) Open your terminal and run the following commands: ``` # go to the project directory cd /path/to/my-project.test # tell Composer to load the plugin composer require burnthebook/craft-flarum-sso # tell Craft to install the plugin ./craft plugin/install flarum-sso ``` Configuration ------------- [](#configuration) To configure the plugin, head on over to Settings > Plugins (Section at bottom of page) > Flarum SSO for Craft 4 and click the icon. There are three required settings: **Flarum URL***The URL to your Flarum installation. This is recommended to be a subdomain of your Craft CMS installation, e.g. * **Flarum API Key***The API key you manually inserted into your Flarum installations api\_keys database table* **Forum SSO Cookie - Domain***The root domain for the SSO Cookie. If your Craft CMS installation is on [www.craftcms.com](http://www.craftcms.com), and your Flarum installation is on discuss.craftcms.com, you would set this to 'craftcms.com'* The rest of the settings on the Settings page are optional and pre-configured to work correctly with the `maicol07/flarum-ext-sso` package that you will be installing on your Flarum installation, and so can be left as-is unless you need to configure the cookie settings for security purposes. Usage ----- [](#usage) This plugin automatically hooks into CraftCMS's login, register and logout events in order to replicate these events on the Flarum side of things. E.g. you log in to CraftCMS, you're logged into Flarum. You create an account on CraftCMS, your account is created on Flarum. Additionally, if you have pre-existing users on Craft CMS that don't exist in Flarum, upon logging into your Craft CMS site after this plugin has been installed, a user will be created for them on Flarum automatically - they will not need to sign up again. Troubleshooting / FAQs ---------------------- [](#troubleshooting--faqs) **Q: I am not logged into Flarum after I am logged into Craft** A: Ensure your root domain matches, due to cookies it is best to have the Flarum forum on a subdomain and the Craft CMS either on another subdomain or a root domain. Additionally, ensure your cookie domain is set up within the Plugin Settings as detailed within the Configuration section. ***For Example:** If your Craft CMS installation is on craftcms.com, you'd want to have your Flarum installation on discuss.craftcms.com and your cookie domain set up as "craftcms.com" in Plugin Settings* **Q: I am recieving "Authentication failed: Unauthorized" upon logging in or creating accounts in Craft CMS even though I know the username and password are correct** A: Ensure your API Key is correctly set up within the Plugin Settings as detailed within the Configuration section. Ensure there are no trailing or leading spaces or extraneous characters. *Optionally, ensure your API Key set in the Flarum `api_keys` table (has to be inserted manually) is for an Administrator user.* **Q: I want to see more detailed logs of what the API is returning rather than the friendly error messages output by the plugin** A: Sure, we log all raw error responses to the storage/logs/flarum-sso--- .log file**Q: How do I log in as an admin to Flarum?** A: Because of how `maicol07/flarum-ext-sso` and Flarum works, you will need to have the same username and password for both your Flarum installation and your Craft CMS installation for your administrator account. Then, when you log into Craft CMS as an administrator, you will automatically be logged into your administrator account on Flarum. This is important to note when setting up your Flarum installation for the first time. **Q: Can all of my Craft CMS users go into a usergroup within Flarum to indicate that they came from CraftCMS?** A: This functionality (or any groups functionality) is not currently supported, but if there is enough interest we can consider it. **Q: Can my users still log into Flarum without a Craft CMS account?** A: No, your users will require a Craft CMS account to log into Flarum once this plugin is installed to Craft CMS and maicol07/flarum-ext-sso is installed to Flarum. Craft CMS becomes the parent application and Flarum becomes the child application, so all user management should be performed within CraftCMS. **Q: What if I have existing users within Flarum?** A: This plugin is intended for use with brand new Flarum installations as of plugin version 1.0.0. If there is enough interest, in future we may add logic that checks if the user already exists within Flarum and create the user within CraftCMS, but as of now we only check if the user exists within Craft CMS and if they do and have authenticated with the correct credentials, create them within Flarum, and authenticate them. ### Health Score 34 — LowBetter than 77% of packages Maintenance45 Moderate activity, may be stable Popularity19 Limited adoption so far Community11 Small or concentrated contributor base Maturity51 Maturing project, gaining track record Bus Factor1 Top contributor holds 96% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~65 days Total 7 Last Release 432d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/d39c603a5be3e48327795a4557e3008c4c9f5e19496db2949be7b5fe7da5f1e0?d=identicon)[burnthebook](/maintainers/burnthebook) --- Top Contributors [![MadMikeyB](https://avatars.githubusercontent.com/u/831828?v=4)](https://github.com/MadMikeyB "MadMikeyB (24 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)") ### Embed Badge ![Health badge](/badges/burnthebook-craft-flarum-sso/health.svg) ``` [![Health](https://phpackages.com/badges/burnthebook-craft-flarum-sso/health.svg)](https://phpackages.com/packages/burnthebook-craft-flarum-sso) ``` ### Alternatives [neuron-core/neuron-ai The PHP Agentic Framework. 1.8k245.3k21](/packages/neuron-core-neuron-ai)[acclaro/translations Easily launch and manage multilingual Craft websites without having to copy/paste content or manually track updates. 1229.5k](/packages/acclaro-translations)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 245.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)