OAuth2.0登录
方舟从 5.0 版本开始集成了 OAuth2.0 授权登录认证 ，具体流程如下：
- 1.用户打开方舟系统的登录页面，点击 “OAuth 登录” 按钮（仅配置后才有该按钮），浏览器会跳转到配置的登录页面（OAuth2.0 认证服务端提供的登录页面）
- 2.用户在认证服务端上完成登录认证后（首次将请求用户授权方舟获取必要的用户资料），完成授权后将跳转回方舟系统。
1、由于方舟系统是具有平台成员和项目成员两级权限设计，所以第一次通过OAuth2授权登录的用户，会同步用户信息到方舟平台权限体系。
2、通过OAuth2授权登录的用户，需要项目管理员在方舟中对该用户分配相应的项目权限，这样该用户就能在授权登录后，能够直接访问授权的项目。
3、授权码模式(Authentication Code)是OAuth2.0各种认证模式中功能最完整、流程最严密的授权模式
方舟接入OAuth2服务认证，根据方舟部署情况（是全新部署还是升级到5.0)存在两种情况，配置步骤上部分差异：
- 1.
- 2.
1）打开
Ambari管理平台登录（http://{ARK1_HOST}:8080/，具体地址请联系方舟项目经理）
armbar登录界面
2）打开方舟应用服务
Ark Web 参数配置中心：登录后，在
Ambari主界面，左侧服务列表中，找到 Ark Web服务，点击进入，在右侧内容页，选择Configs 标签卡，最后点开 Advanced ark-web-app-api-server 参数配置项，操作如下图所示：如下图所示：
ark web 配置页面
3）填写OAuth2 参数配置项，保存修改好的参数
下滑页面，在
Advanced ark-web-app-api-server的类别下找到arkweb.oauth2 和 security.oauth2 开头的参数，按照OAuth2服务端情况填写正确的OAuth2接入配置，确保配置无误后，点击右上角 Save按钮进行保存。操作步骤如下：
备注：图示中的配置项已有部分变更，所有配置项以第二节 《配置项说明表格》为准
4）重启方舟
Ark Web 服务，启动OAuth2第三方登录确认OAuth2参数配置正确配置和保存后，重启
Ark Web 服务，使OAuth2第三方登录配置生效。操作步骤如下：
若从5.0 以下版本升级上来的，在
Ambari参数配置中心的Advanced ark-web-app-api-server类别中是找不到OAuth2相关配置项，这时候需要手动在Custom ark-web-app-api-server 中添加 配置项，即可生效，操作步骤如下：1）打开自定义参数配置中心，添加自定义属性
在
Ambari主界面，左侧服务列表中，找到 Ark Web服务，点击进入，在右侧内容页，选择Configs 标签卡，最后点开 Custom ark-web-app-api-server 参数配置项，点击 Add Property，操作如下图所示：
2）添加OAuth2配置参数
在弹出的浮窗中，可以批量添加参数配置，一行对应一个参数设 置，参数配置可以复制：
# 请根据OAuth2服务器情况变更以下参数
arkweb.oauth2.enable=true
arkweb.oauth2.url.base_url=http://ark2:4005
arkweb.oauth2.user_info.name_key=preferred_username
security.oauth2.client.scope=all
security.oauth2.client.client_id=abcd1234
security.oauth2.client.client_secret=XYZ1234
security.oauth2.resource.user-info-uri=https://api.github.com/user
security.oauth2.client.access-token-uri=https://github.com/login/oauth/access_token
security.oauth2.client.user-authorization-uri=https://github.com/login/oauth/authorize
操作步骤如下图：
3）保存配置项
再次检查参数是否正确配置，如果配置错误 ，在下面页面也是可以进行修改，确认无误，一定要记得点击右上角
Save按钮进行保存。操作步骤如下：
4）保存后，重启方舟
Ark Web 服务确认OAuth2参数配置正确配置和保存后，重启
Ark Web 服务，使OAuth2第三方登录配置生效。操作步骤如下：
参数 | 是否必填 | 参数说明 |
arkweb.oauth2.enable | Y | 是否开启OAuth2认证，开启则需要设置为true，默认为false |
arkweb.oauth2.url.base_url | Y | 方舟产品主页的 根域名 |
arkweb.oauth2.user_info.name_key | N | 在获取用户信息中，使用哪个属性作为方舟用户必需username。 默认为：preferred_username |
security.oauth2.client.scope | Y | 获取用户信息需要的权限列表 |
security.oauth2.client.client_id | Y | OAuth 2.0 服务端为方舟授权登录配置的客户端ID |
security.oauth2.client.client_secret | Y | OAuth 2.0 服务端为方舟授权登录配置的客户端密钥 |
security.oauth2.resource.user-info-uri | Y | OAuth 2.0 获取该用户信息的接口地址 |
security.oauth2.client.access-token-uri | Y | OAuth 2.0 获取 Access Token 的地址 |
security.oauth2.client.user-authorization-uri | Y | OAuth 2.0 的授权地址 |
最近更新 2yr ago