PHPackages credit-union-2-0-llc/laravel-azure-ad-oauth - 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. [Authentication & Authorization](/categories/authentication) 4. / 5. credit-union-2-0-llc/laravel-azure-ad-oauth ActiveLibrary[Authentication & Authorization](/categories/authentication) credit-union-2-0-llc/laravel-azure-ad-oauth =========================================== Provides single-sign-on ability to Microsoft Azure Active Directory enabled apps. v1.6.0(7y ago)015PHP Since Jan 4Pushed 7y ago1 watchersCompare [ Source](https://github.com/credit-union-2-0-llc/laravel-azure-ad-oauth)[ Packagist](https://packagist.org/packages/credit-union-2-0-llc/laravel-azure-ad-oauth)[ RSS](/packages/credit-union-2-0-llc-laravel-azure-ad-oauth/feed)WikiDiscussions master Synced yesterday READMEChangelog (4)Dependencies (3)Versions (12)Used By (0) Laravel Socialite Azure Active Directory Plugin =============================================== [](#laravel-socialite-azure-active-directory-plugin) Installation ------------ [](#installation) `composer require metrogistics/laravel-azure-ad-oauth` If you are using Laravel 5.5 or greater, the service provider will be detected and installed by Laravel automatically. Otherwise you will need to add the service provider and the facade (optional) to the `config/app.php` file: ``` Metrogistics\AzureSocialite\ServiceProvider::class, // ... 'AzureUser' => Metrogistics\AzureSocialite\AzureUserFacade::class, ``` Publish the config and override any defaults: ``` php artisan vendor publish ``` Add the necessary env vars: ``` AZURE_AD_CLIENT_ID=XXXX AZURE_AD_CLIENT_SECRET=XXXX ``` The only changes you should have to make to your application are: - You will need to make the password field in the users table nullable. - You will need to have a `VARCHAR` field on the users table that is 36 characters long to store the Azure AD ID for the user. The default name for the field is `azure_id` but that can be changed in the config file: `'user_id_field' => 'azure_id',`. Usage ----- [](#usage) All you need to do to make use of Azure AD SSO is to point a user to the `/login/microsoft` route (configurable) for login. Once a user has been logged in, they will be redirect to the home page (also configurable). After login, you can access the basic Laravel authenticate user as normal: ``` auth()->user(); ``` If you need to set additional user fields when the user model is created at login, you may provide a callback via the `UserFactory::userCallback()` method. A good place to do so would be in your AppServiceProvider's `boot` method: ``` \Metrogistics\AzureSocialite\UserFactory::userCallback(function($new_user){ $new_user->api_token = str_random(60); }); ``` Azure AD Setup -------------- [](#azure-ad-setup) 1. Navigate to `Azure Active Directory` -> `App registrations`. 2. Create a new application 3. Choose a name 4. Select the "Web app / API" Application Type 5. Add the "Sign-on URL". This will typically be `https://domain.com/auth/login` 6. Click "Create" 7. Click into the newly created app. 8. The "Application ID" is what you will need for your `AZURE_AD_CLIENT_ID` env variable. 9. Click into "Reply URLs". You will need to whitelist the redirection path for your app here. It will typically be `https://domain.com/login/microsoft/callback`. Click "Save" 10. Select the permissions required for you app in the "Required permissions" tab. 11. Add any necessary roles to the manifest: 12. Click on the "Manifest" tab. 13. Add roles as necessary using the following format: ``` "appRoles": [ { "allowedMemberTypes": [ "User" ], "displayName": "Manager Role", "id": "08b0e9e3-8d88-4d99-b630-b9642a70f51e",// Any unique GUID "isEnabled": true, "description": "Manage stuff with this role", "value": "manager" } ], ``` 14. Click "Save" 15. In the "Keys" tab, enter a description (something like "App Secret"). Set Duration to "Never Expires". Click "Save". Copy the whole key. This will not show again. You will need this value for the `AZURE_AD_CLIENT_SECRET` env variable. 16. Click on the "Managed application" link (It will be the name of the application); 17. Under the "Properties" tab, enable user sign-in. Make user assignment required. Click "Save". 18. Under the "Users and groups" tab, add users and their roles as needed. ### Health Score 29 — LowBetter than 60% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity6 Limited adoption so far Community9 Small or concentrated contributor base Maturity70 Established project with proven stability Bus Factor1 Top contributor holds 82.6% 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 ~41 days Recently: every ~100 days Total 11 Last Release 2633d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/42b97e9578c9c586fceb3a2712ec083b041b83c5f65d6aba5b1223ccb36c383f?d=identicon)[alex@cu-2.com](/maintainers/alex@cu-2.com) --- Top Contributors [![pstephan1187](https://avatars.githubusercontent.com/u/5191902?v=4)](https://github.com/pstephan1187 "pstephan1187 (19 commits)")[![alex-taffe](https://avatars.githubusercontent.com/u/6820226?v=4)](https://github.com/alex-taffe "alex-taffe (4 commits)") ### Embed Badge ![Health badge](/badges/credit-union-2-0-llc-laravel-azure-ad-oauth/health.svg) ``` [![Health](https://phpackages.com/badges/credit-union-2-0-llc-laravel-azure-ad-oauth/health.svg)](https://phpackages.com/packages/credit-union-2-0-llc-laravel-azure-ad-oauth) ``` ### Alternatives [unopim/unopim UnoPim Laravel PIM 9.4k1.8k](/packages/unopim-unopim)[metrogistics/laravel-azure-ad-oauth Provides single-sign-on ability to Microsoft Azure Active Directory enabled apps. 8679.1k1](/packages/metrogistics-laravel-azure-ad-oauth)[truckersmp/steam-socialite Laravel Socialite provider for Steam OpenID. 1516.7k](/packages/truckersmp-steam-socialite) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)