如何在刷新访问令牌时在文档中请求扩展范围刷新令牌

Question

我在为 oauth 代码授予流生成授权 URI 时包含了“扩展”范围，但在刷新访问令牌时，在响应中我将范围作为“签名”。刷新访问令牌时如何获取具有扩展范围的刷新令牌。我已附加我的代码以从刷新令牌中获取访问令牌。

        auth_string = "{0}:{1}".format(
            DOCUSIGN_CLIENT_ID, DOCUSIGN_CLIENT_SECRET
        )
        auth_encoded_hash = b64encode(auth_string.encode("utf-8"))
        auth_header = auth_encoded_hash.decode("utf-8")

 
        url = "https://account-d.docusign.com/oauth/token"

        headers = {
            "Authorization": "Basic {0}".format(auth_header),
            "Content-Type": "application/x-www-form-urlencoded",
        }

        body = {"grant_type": "refresh_token", "refresh_token": refresh_token}
        _response = requests.post(url, data=body, headers=headers)
        response = _response.json() # here I am getting scope as 'signature'

我对此的第二个后续问题，如果刷新令牌本身在刷新访问令牌时过期，我将在上面的响应中收到什么错误消息？

Answer 1

刷新操作请求不包括范围。 刷新操作response可能包含之前请求的范围。

这里是刷新操作：

curl --location --request POST 'https://account-d.docusign.com/oauth/token' \
--header 'Authorization: Basic 'NWYxZTg4…………...TJkOGI2Yg==' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'refresh_token=eyJ0eX…………...Dp_hA' \
--data-urlencode 'grant_type=refresh_token'

如果刷新操作成功，则响应包含一个新的访问令牌和一个新的刷新令牌。

接下来，扔掉旧的刷新令牌，并使用新收到的刷新令牌，直到下一次。

换句话说：

• 第一次刷新 API 调用使用授权码授权流程返回的刷新令牌
• 然后每个后续的刷新 API 调用都使用之前的刷新 API 调用返回的刷新令牌

Blog post about using refresh tokens

Answer 2

当您最初同意并从用户那里获取令牌时，需要“扩展”范围，以便刷新令牌在 30 天内不会过期。不需要每次使用所述刷新令牌来获取新的访问令牌。

过期令牌的错误消息通常会得到 invalid grant 错误，但该错误可能会发生变化，您应该处理所有错误而不是查找特定的错误字符串。

有关类似问题/答案，请参阅 Which is the error returned when a DocuSign refresh token is expired?。