iPortal 支持使用基于 OAuth2.0 协议的第三方账户登录。目前 iPortal 可直接配置使用 QQ、 新浪微博、微信的账户登录,也支持通过扩展的方式使用其他遵循 OAuth2.0 协议的第三方账户登录,请参考:遵循 OAuth2 协议的第三方登录方式扩展。 配置了第三方登录以后,您就可以直接使用 QQ 、新浪微博、微信等第三方账户登录 iPortal,也可以将第三方账户与 iPortal 账户绑定使用。
第三方登录配置
以管理员身份登录 iPortal,依次点击“管理”>“安全”>“登录配置”>“第三方登录”,进入“第三方登录配置”页面,可以添加或管理第三方登录配置。
配置 QQ 账号登录
- 第一步:创建应用。管理员在 QQ 互联官网(https://connect.qq.com)申请成为开发者,完成注册并通过资质审核后,选择“应用管理”>“网站应用”>“创建应用”,进行应用的创建,具体的操作流程可详见:网站接入介绍。
- 第二步:完善应用信息。填写应用的名称、域名、回调地址等信息,其中“网站名称”需与备案登记的名称严格一致,“回调地址”需按如下格式进行填写:http(s)://{IP}:{port}/{contextPath}/services/security/login/QQ/callback。其中 ip 可为 IP 地址或域名,使用域名时,http 协议的默认端口号为 80,https 协议 的默认端口号为 443。具体的示例如下:https://iptl.supermap.io:443/iportal/services/security/login/QQ/callback。填写完成后提交并等待审核,审核通过后,可在应用管理中查看应用对应的 App ID 与 App Key。
- 第三步:配置 iPortal。以管理员身份登录 iPortal,在“第三方登录配置”页面点击“添加第三方登录配置”按钮,打开添加第三方登录配置对话框:
- 登录方式:选择“ QQ 账号登录”
- App ID(客户端标识):填写在 QQ 互联平台创建的应用的 App ID。
- App Key:填写在 QQ 互联平台创建的应用的 App Key。
- 回调域名:此处的回调域名与在第二步中填写的回调地址有所不同,只填写 IP 或域名即可,如:iptl.supermap.io。
点击“确定”按钮,即可完成 QQ 账号登录方式的配置。
配置新浪微博账号登录
- 第一步:创建应用。管理员在新浪微博互联开放平台(https://open.weibo.com)注册并申请成为开发者后,选择“微连接”>“网站接入”>“立即接入”,进行应用的创建,具体的操作流程可详见:网站接入介绍。应用创建完成后,微博开放平台会发放应用所对应的 App Key 和 App Secret。
- 第二步:完善应用信息。填写应用的基本信息、高级信息与测试信息,其中高级信息的“OAuth 2.0 授权设置”项,授权回调页需按如下格式进行填写:http(s)://{IP}:{port}/{contextPath}/services/security/login/WEIBO/callback。其中 ip 可为 IP 地址或域名,使用域名时,http 协议的默认端口号为 80,https 协议 的默认端口号为 443。具体的示例如下:https://iptl.supermap.io:443/iportal/services/security/login/WEIBO/callback。取消授权回调页是指微博用户取消自己账号对 iPortal 的授权后的回调地址,如不需要可不进行设置。
- 第三步:配置 iPortal。以管理员身份登录 iPortal,在“第三方登录配置”页面点击“添加第三方登录配置”按钮,打开添加第三方登录配置对话框:
- 登录方式:选择“微博账号登录”
- App Key(客户端标识):填写在微博开放平台创建的应用的 App Key。
- App Secret:填写在微博开放平台创建的应用的 App Secret。
- 回调域名:此处的回调域名与在第二步中填写的回调域名有所不同,只填写 IP 或域名即可,如:iptl.supermap.io。
点击“确定”按钮,即可完成新浪微博账号登录方式的配置。
在创建的应用未通过微博开放平台审核前,您只能使用应用测试信息中指定的新浪微博测试账号登录,待提交审核并通过后,您可以使用所有新浪微博账号登录。
配置微信账号登录
- 第一步:创建应用。管理员在微信开放平台(https://open.weixin.qq.com )申请成为开发者,完成注册并通过资质审核后,选择“管理中心”>“网站应用”>“创建网站应用”,进行应用的创建,具体的操作流程可详见:网站接入介绍。
- 第二步:完善应用信息。填写应用的名称、域名、回调地址等信息,其中“网站名称”需与备案登记的名称严格一致,“回调地址”需按如下格式进行填写:http(s)://{IP}:{port}/{contextPath}/services/security/login/WX/callback。其中 ip 可为 IP 地址或域名,使用域名时,http 协议的默认端口号为 80,https 协议 的默认端口号为 443。具体的示例如下:https://iptl.supermap.io:443/iportal/services/security/login/WX/callback。填写完成后提交并等待审核,审核通过后,可在应用管理中查看应用对应的 App ID 与 App Secret。
- 第三步:配置 iPortal。以管理员身份登录 iPortal,在“第三方登录配置”页面点击“添加第三方登录配置”按钮,打开添加第三方登录配置对话框:
- 登录方式:选择“ 微信账号登录”
- App ID(应用唯一标识):填写在微信开放平台创建的应用的 App ID。
- App Secret(应用密钥):填写在微信开放平台创建的应用的 App Secret。
- 回调域名:此处的回调域名与在第二步中填写的回调地址有所不同,只填写 IP 或域名即可,如:iptl.supermap.io。
点击“确定”按钮,即可完成微信账号登录方式的配置。
管理第三方账号登录配置
管理员可以在“第三方登录配置”页面查看已成功配置的所有第三方账号登录方式,并可以删除、编辑和启用/停用该登录方式。
使用第三方账号登录
配置完第三方登录方式后,在 iPortal 登录页面中会出现 QQ/微博/微信登录按钮,您可以使用这些第三方登录方式登录 iPortal。
以使用 QQ 账号登录为例进行说明,点击登录页面的“QQ 登录”按钮,会弹出 QQ 认证授权页面,输入 QQ 账号和密码或扫描二维码认证成功后,如果您是第一次使用 QQ 账号登录 iportal ,会弹出如下对话框:
如果您已经有 iPortal 账号,请您点击“绑定 iPortal 账号”按钮,实现 QQ 账号与 iPortal 账号的绑定, 您下次既可以使用 iPortal 账号也可以使用 QQ 账号登录 iPortal 。当您使用 QQ 账号登录 iPortal 时,您拥有与 QQ 账号绑定的 iPortal 账号同等的角色与权限。
如果您还没有 iPortal 账号或是有 iPortal 账号但不希望与 QQ 账号绑定,请您点击“立即登录 iPortal”按钮,即可使用 QQ 账号登录 iPortal 。这时的用户名是一个随机字符串,在用户管理页面可以查看这个随机字符串。需要注意的是如果您第一次登录时没有绑定已有的 iPortal 账号,以后就只能用 QQ 账号登录 iPortal。