caredfor / socialite-azure-oauth
允许使用Laravel的Socialite库多连接到Azure AD
Requires
- guzzlehttp/guzzle: >6.3
- laravel/framework: >5.5
- laravel/socialite: ^5.0
README
受metrogistics/laravel-azure-ad-oauth启发,并更新以支持多Azure连接和更好的覆盖。
安装
发布配置并覆盖任何默认值
php artisan vendor:publish
添加必要的环境变量,根据您的配置文件中定义的内容。默认情况下
AZURE_AD_CLIENT_ID=XXXX
AZURE_AD_CLIENT_SECRET=XXXX
用法
创建一个控制器并导入AzureOAuthControllerTrait特质。它将为您提供Socialite OAuth的方法。然后,在配置文件中将您的控制器命名空间添加到键auth_controller
在设置您的Azure AD之后(见下文),您要做的只是将用户指向/login/microsoft
(可配置)路由进行登录。
登录后,用户将被重定向并触发您自己控制器中的handleOAuthUser()
方法。
Azure AD设置
-
导航到
Azure Active Directory
->应用程序注册
。 -
创建一个新的应用程序
-
选择一个名称
-
选择所需的受支持账户类型(由您决定)
-
在平台配置中,选择“客户端应用程序(Web,iOS,Android,桌面+设备)”
-
点击“创建”
-
点击新创建的应用程序。
-
“应用程序ID”是您需要用于
AZURE_AD_CLIENT_ID
环境变量的。 -
点击“重定向URI”。您需要在这里为应用程序白名单重定向路径。通常为
https://domain.com/login/microsoft/callback
。点击“保存” -
在“API权限”标签页中,选择您应用程序所需的权限。
-
在清单中添加任何必要的角色
-
点击“清单”标签页。
-
使用以下格式添加必要的角色
"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" } ],
-
点击“保存”
-
在“证书与密钥”标签页中,点击“新建客户端密钥”,输入描述(例如“应用程序密钥”)。设置“持续时间”为“永不过期”。点击“保存”。复制整个密钥。这不会再次显示。您需要此值用于
AZURE_AD_CLIENT_SECRET
环境变量。 -
返回到Azure活动目录并点击“企业应用程序”链接。然后点击应用程序名称
-
在“属性”标签页下,启用用户登录。强制用户分配。点击“保存”。
-
在“用户和组”标签页下,根据需要添加用户及其角色。
-
额外:配置发布域名以验证您的应用程序:[链接](https://docs.microsoft.com/fr-be/azure/active-directory/develop/howto-configure-publisher-domain#configure-publisher-domain-using-the-azure-portal)