Golang 如何实现一个 Oauth2 客户端程序 (1)
#

欢迎star demo007x/oauth2-client: Oauth2 Client package for Golang (github.com)

授权码流程
#

Web 和移动应用程序使用授权码授权类型。它与大多数其他授权类型不同，首先要求应用程序启动浏览器以开始流程。具有以下步骤：

应用程序打开浏览器请求发送到 OAuth 服务器
用户看到授权提示并批准应用程序的请求
授权成功后将用户重定向回应用程序并携带授权码
应用程序携带访问令牌交换授权代码

获得用户的许可
#

OAuth 就是让用户能够授予对应用程序的有限访问权限。应用程序首先需要决定它请求的权限，然后将用户发送到浏览器以获得他们的权限。开始授权流程，应用程序构建如下所示的 URL 并打开浏览器访问该 URL。

https://authorization-server.com/auth  
?response_type=code  
&client_id=29352915982374239857  
&redirect_uri=https%3A%2F%2Fexample-app.com%2Fcallback  
&scope=create+delete  
&state=xcoiv98y2kd22vusuye3kch

以下是对每个查询参数的解释：

response_type=code 这告诉授权服务器应用程序正在启动授权请求。
client_id- 应用程序的公共标识符，在开发人员首次注册应用程序时获得。
redirect_uri- 告诉授权服务器在用户批准请求后将用户重定向回何处。
scope- 一个或多个空格分隔的字符串，指示应用程序请求的权限。您使用的特定 OAuth API 将定义它支持的范围。
state- 应用程序生成一个随机字符串并将其包含在请求中。然后它应该检查在用户授权应用程序后是否返回相同的值。这用于防止CSRF 攻击。

当用户访问此 URL 时，授权服务器将向他们显示一个提示，询问他们是否愿意授权此应用程序的请求。

重定向回应用程序
#

如果用户批准请求，授权服务器会将浏览器重定向回redirect_uri应用程序指定的浏览器，并在查询字符串中添加code和state

例如，用户将被重定向回一个 URL，例如

https://example-app.com/redirect?code=g0ZGZmNjVmOWIjNTk2NTk4ZTYyZGI3&state=xcoiv98y2kd22vusuye3kch

该state值将与应用程序最初在请求中设置的值相同。应用程序应检查重定向中的状态是否与它最初设置的状态相匹配。这可以防止 CSRF 和其他相关攻击。

code是授权服务器生成的授权码。此代码的生命周期相对较短，通常会持续 1 到 10 分钟,有的 Oauth 服务只允许使用一次就会失效. 具体取决于 OAuth 服务。

使用授权码交换为访问令牌
#

我们即将结束流程。现在应用程序有了授权代码，它可以使用它来获取访问令牌。

应用程序使用以下参数向服务的令牌端点发出 POST 请求：

grant_type=authorization_code 这告诉 Oauth 服务端应用程序正在使用授权代码授权类型。
code 应用程序包含在重定向中提供的授权代码。
redirect_uri- 请求代码时使用的相同重定向 URI。某些 API 不需要此参数，因此需要仔细检查您正在访问的特定 API 的文档,有的服务商可能需要。
client_id- 应用程序的客户端 ID。
client_secret- 应用程序的客户端机密。这确保获取访问令牌的请求仅来自应用程序，而不是来自可能拦截授权代码的潜在攻击者。

client_id,client_secret 的传参数需要参考 Oauth 服务商的约定.一般都回在header中传递 Basic 类型的 Authorization. 加密规则:base64_encode(client_id:client_secret)

令牌端点将验证请求中的所有参数，确保代码没有过期并且客户端 ID 和密码匹配。如果一切正常，它将生成一个访问令牌并在响应中返回它！

HTTP/1.1 200 OK  
Content-Type: application/json  
Cache-Control: no-store  
Pragma: no-cache  
  
{  
"access_token":"MTQ0NjJkZmQ5OTM2NDE1ZTZjNGZmZjI3",  
"token_type":"bearer",  
"expires_in":3600,  
"refresh_token":"IwOGYzYTlmM2YxOTQ5MGE3YmNmMDFkNTVk",  
"scope":"create delete"  
}