本文档描述如何创建应用。
应用
应用(Application),在OAuth2.0 体系里称呼为Client,我们可以理解为 操作资源的工具。
按照应用形态有:
Web服务端应用(有服务端的)
Web浏览器端应用(纯前端的)
桌面端和移动端
JWT应用
应用形态对比
应用类型 | 描述 | 是否需要用户授权(支持 OAuth2.0 授权) | 应用场景 |
Web服务端应用 | Web页面+后端服务 | 是 | 除了调用 PDS API 还有其他业务逻辑需要后端服务支持 |
Web浏览器端应用 | Web页面 | 是 | 只需调用 PDS API 即可满足需求 |
Native应用 | 桌面端和移动端 | 是 | 桌面客户端,移动端等客户端 |
JWT应用 | 服务端 | 否 | 当你的应用调用 PDS 时,不需要用户干预,如后端服务、后台进程、命令行或者其他自定义登录方式接入等,请求是代表应用,而非最终用户。 |
PDS 应用分为官方应用和自建应用。
官方应用:官方提供的应用,所有域在授权允许访问其资源,可以直接使用。
自建应用:用户可以根据需求,创建出适合不同场景的应用。
关于OAuth2.0
PDS API 使用 OAuth2.0 协议认证和授权,支持通用的 OAuth2.0 方案,例如 Web 服务应用,客户端应用等。
首先,请在 PDS 控制台配置登录方式,具体请看PDS支持的用户体系介绍。然后,创建对应的应用以得到凭证(如:AppId 和 AppSecret),您的客户端应用程序请求 PDS 授权服务器以获取访问令牌,从响应中提取令牌,然后将该令牌发送到您要访问的 PDS API。如有必要,刷新访问令牌。
不同类型的应用OAuth2.0流程差异对比
应用类型 | 应用描述 | 请求授权时的 responseType 取值 | 是否需要 app_secret | 是否能刷新 token |
Web 服务端应用 | 带有后端服务的 Web应用。 | code | 必须,secret 放在服务端的配置中 | 可以 |
Native 应用 | 桌面客户端,移动端应用。 | code | 不需要, secret 放在客户端不安全 | 可以通过服务端刷新token |
Web 浏览器应用 | 纯 js 前端应用,单页面应用(SPA),widget等。 | access_token | 不需要, secret 放在客户端不安全 | 无法刷新token |
创建应用的时候,请根据具体的场景选择应用类型。
针对不同类型的应用,OAuth2.0 接入协议有所不同, 详细请看: