Download the PHP package socialiteproviders/microsoft without Composer
On this page you can find all versions of the php package socialiteproviders/microsoft. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package microsoft
Microsoft
Installation & Basic Usage
Please see the Base Installation Guide, then follow the provider specific instructions below.
Add configuration to config/services.php
Add provider event listener
Laravel 11+
In Laravel 11, the default EventServiceProvider
provider was removed. Instead, add the listener using the listen
method on the Event
facade, in your AppServiceProvider
boot
method.
- Note: You do not need to add anything for the built-in socialite providers unless you override them with your own providers.
Laravel 10 or below
Configure the package's listener to listen for `SocialiteWasCalled` events. Add the event to your `listen[]` array in `app/Providers/EventServiceProvider`. See the [Base Installation Guide](https://socialiteproviders.com/usage/) for detailed instructions.Usage
You should now be able to use the provider like you would regularly use Socialite (assuming you have the facade installed):
Extended features
Tenant Details
You can also retrieve Tenant information at the same time as you retrieve users, this can be useful if you need to allow only your tenant/s or filter certain tenants.
To do this you first need to edit your config/services.php
file and within your microsoft settings array include 'include_tenant_info' like the following:
NOTE: if you use 'tenant' => env('MICROSOFT_TENANT_ID')
then you should ensure that your .env file still uses 'common' as the tenant ID.
The default tenant fields returned are:
- ID
- displayName
- city
- country
- countryLetterCode
- state
- street
- verifiedDomains
Refresh token
By default Microsoft doesn't return a refresh token. But if you do need a refresh token you need to add the offline_access
scope.
Adding the scope is done on the redirect
method as is described in the Laravel docs.
Tenant types
The supported values (defined by MS Identity Platform) for 'tenant' are listed below and can be used to control who can sign into the application.
common
- for both Microsoft accounts and work or school accounts (most permissive),organizations
- for work or school accounts only,consumers
- for Microsoft accounts only (only services like Xbox, Teams for Life, or Outlook),tenant identifiers
- such as the tenant ID or domain name (most restrictive).
Note: when configuring the services.php microsoft entry with
tenant => 'common'
include_tenant_info => true
and attempting to login with a 'consumer' account, the user's tenant value will be null
e.g.
Additional tenant fields tenant_fields
Any additional fields can be returned with the attribute names detailed here.
e.g. 'tenantType', 'technicalNotificationMails'
can be requested as such
All versions of microsoft with dependencies
ext-json Version *
firebase/php-jwt Version ^6.8
socialiteproviders/manager Version ^4.4