使用授权代码流配置并使用贵组织的自定义OAuth 2应用程序
要与Workfront集成并允许您的客户端应用程序代表用户与Workfront进行通信，您必须：
- 创建OAuth2应用程序
- 配置第三方应用程序
- 链接到您的用户的“授权”页面
- 设置授权代码流：用户登录到Workfront实例，并同意他们允许客户端应用程序代表他们连接到Workfront。 因此，您将获得一个授权代码，以便与访问和刷新令牌进行交换。
- 设置刷新令牌流程：在此流程中，您可以使用刷新令牌在旧令牌过期时获取新的访问令牌。
创建OAuth2应用程序
有关创建OAuth2应用程序的说明，请参阅为Workfront集成创建OAuth2应用程序中的使用用户凭据创建OAuth2应用程序（授权代码流）
链接到您的用户的“授权”页面
您的用户需要登录才能在自己的帐户中授权此集成。 用户可授权的页面具有特定的格式，如下所述。 使用此信息确定应用程序的授权页面地址，并为用户提供该地址或指向该地址的链接。
-
组织域的完整URL。 示例：
code language-none https://myorganization.my.workfront.com -
client_id：这是您在Workfront中创建OAuth2应用程序时生成的客户端ID。 -
redirect_uri：此URL必须与您在创建OAuth2应用程序时在Workfront中输入的重定向URL相同。 您的用户在为其帐户授权应用程序后，将被定向到此页面。 -
response_type：必须具有值code。
因此，授权页面的URL为：
https://<URL of your organization's domain>/integrations/oauth2/authorize?client_id=<Your ClientID>&redirect_uri=<Your redirect URL>&response_type=code
配置第三方应用程序
第三方应用程序可能需要配置。 下表包含有关配置第三方应用程序时可能需要的字段的信息。
设置授权代码流
要使用OAuth2登录用户，请使用以下流程：
-
当用户打开授权页面时，它会重定向到Workfront登录页面，以便用户能够登录到Workfront。 如果用户具有SSO配置，将打开身份提供程序登录页。
如果用户已在同一浏览器上登录到Workfront，或者用户已成功登录到Workfront，则用户将被重定向到同意屏幕：
-
如果用户允许访问，页面将被重定向到
redirect_url。 重定向必须包含以下查询参数：
-
code：获取访问/刷新令牌所需的授权代码。 -
domain：您组织的域。 示例：在myorganization.my.workfront.com中，域是myorganization。 -
lane：请求的通道。 示例：在myorganization.preview.workfront.com中，车道是preview。note important IMPORTANT code仅在2分钟内有效。 因此，您必须在这段时间内获得刷新和访问令牌。
-
如果您拥有代码，则可以通过将该代码和客户端应用程序凭据一起发送到
/integrations/oauth2/api/v1/token端点来请求刷新和访问令牌。完整的令牌请求URL为
code language-none https://<URL of your organization's domain></span>/integrations/oauth2/api/v1/token示例： 对令牌端点的CURL调用示例：
示例1
code language-none curl --location --request POST '**<workfront host>**/integrations/oauth2/api/v1/token' \ --header 'Authorization: Basic **<base64(client_id:client_secret)>**' \ --header 'Content-Type: application/json' \ --data-raw '{ "code": "**<code>**", "grant_type": "**authorization_code**", "redirect_uri": "**<redirect_url>**" }'示例2
code language-none curl --location --request POST '**<workfront host>**/integrations/oauth2/api/v1/token' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'grant_type=**authorization_code**' \ --data-urlencode 'redirect_uri=**<redirect_url>**' \ --data-urlencode 'code=**<code>**' \ --data-urlencode 'client_id=**<client_id>**' \ --data-urlencode 'client_secret=**<client_secret>**'note important IMPORTANT 在Workfront中注册应用程序时生成了客户端密钥。 你应该把它存放在安全的地方，因为如果它丢失了，它是无法恢复的。 当所有传递的参数均正确时，令牌端点返回以下有效负载：
code language-none { "token_type": "sessionID", "access_token": "string", // the value of sessionID "refresh_token": "string", "expires_in": 0, "wid": "string" }访问令牌与
sessionID相同，过期方式与常规sessionID相同note important IMPORTANT 将刷新令牌存储在安全位置。 旧令牌过期后，您需要它才能获取新的刷新令牌。 Workfront不会存储您的刷新令牌。 -
现在，当您拥有访问令牌时，您可以对Workfront进行API调用
code language-none curl --request GET 'https://<workfront host>/attask/api/v14.0/proj/search \ --header 'sessionID: <access_token>'
设置刷新访问令牌
要刷新access_token，我们再次需要对令牌端点进行“POST”调用。 这次我们发送了不同的表单数据，如下所示：
curl --location --request POST '<workfront host>/integrations/oauth2/api/v1/token' \
--header 'Authorization: Basic <base64(client_id:client_secret)>' \
--header 'Content-Type: application/json' \
--data-raw '{
"grant_type": "refresh_token",
"refresh_token": "<refresh_token>"
}'
###### OR
curl --location --request POST '<workfront host>/integrations/oauth2/api/v1/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=refresh_token' \
--data-urlencode 'redirect_uri=<redirect_url>' \
--data-urlencode 'refresh_token=<refresh_token>' \
--data-urlencode 'client_id=<client_id>' \
--data-urlencode 'client_secret=<client_secret>'
它将返回以下结果：
{
"token_type": "sessionID",
"access_token": "string", // the value of sessionID
"refresh_token": "string",
"expires_in": 0,
"wid": "string"
}
访问令牌也是sessionID，可用于向Workfront发出API请求。