luketowers / oc-azureadsso-plugin
OctoberCMS plugin to add support for logging into the backend with Azure AD SSO OAuth.
Installs: 343
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 2
Forks: 7
Open Issues: 1
Type:october-plugin
Requires
This package is auto-updated.
Last update: 2024-10-15 14:37:56 UTC
README
Adds support for logging into the backend with Azure Active Directory Single Sign On (SSO) OAuth.
Installation
To install from the Marketplace, click on the "Add to Project" button and then select the project you wish to add it to before updating the project to pull in the plugin.
To install from the backend, go to Settings -> Updates & Plugins -> Install Plugins and then search for LukeTowers.AzureADSSO
.
To install from the repository, clone it into plugins/luketowers/azureadsso and then run composer update
from your project root in order to pull in the dependencies.
To install it with Composer, run composer require luketowers/oc-azureadsso-plugin
from your project root.
Setup
- Go to
Azure Active Directory
->App registrations
- Create a new application (registration)
- Choose a name (Example: "My OctoberCMS Application Sign-in Helper")
- If asked, select the "Web app / API" Application Type
- Provide the Redirect URI (by default will be
https://example.com/luketowers/azureadsso/login/microsoft/callback
, replacehttps://example.com
with the URL to your OctoberCMS instance) - Click Register
- Select your newly created application
- Copy the "Application (client) ID" value and put it into your
.env
file for theAZURE_AD_CLIENT_ID
env variable - Select the permissions required for your app in the "API Permissions" tab (recommended at least Microsft Graph ->
User.Read
,email
, &profile
) - Go to the Certificates & Secrets tab and create a new Client Secret (recommended to set it to "Never" expire). Copy this value down and use it for the
AZURE_AD_CLIENT_SECRET
env variable in your.env
file.