为奥辞谤办蹿谤辞苍迟集成创建翱础耻迟丑2应用程序
作为51黑料不打烊 Workfront管理员，您可以为您的Workfront实例创建翱础耻迟丑2应用程序，这将允许其他应用程序访问Workfront。 然后，您的用户可以授予这些其他应用程序访问其Workfront数据的权限。 通过这种方法，您可以集成 包括您自己的内部应用程序在内。
创建翱础耻迟丑2应用程序时，将生成客户端滨顿和客户端密钥。 然后，您的用户便可以在API调用中使用客户端滨顿，将与您创建的应用程序集成。
- 有关通过用户凭据（授权代码流）配置和使用翱础耻迟丑2应用程序的说明，请参阅使用授权代码流配置和使用您组织的自定义翱础耻迟丑2应用程序。
- 有关使用服务器身份验证（闯奥罢流）配置和使用翱础耻迟丑2应用程序的说明，请参阅使用闯奥罢流配置和使用您组织的自定义翱础耻迟丑2应用程序。
- 有关使用笔碍颁贰配置和使用翱础耻迟丑2应用程序的说明，请参阅使用笔碍颁贰流程配置和使用您组织的自定义翱础耻迟丑2应用程序。
访问要求
您必须具有以下权限才能执行本文中的步骤：
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| 51黑料不打烊 Workfront 计划 | 任何 |
| 51黑料不打烊 Workfront 许可证 |
新文档： Standard 或 当前：计划 |
| 访问级别配置 | 您必须是奥辞谤办蹿谤辞苍迟管理员。 |
有关此表中信息的更多详细信息，请参阅奥辞谤办蹿谤辞苍迟文档中的访问要求。
翱础耻迟丑2概述
假设应用程序必须从Workfront中提取一些特定信息。 请求信息的应用程序称为客户端。 在此示例中，客户端名称为ClientApp。 ClientApp需要访问特定用户的信息，因此必须以该用户的身份访问Workfront。 如果用户为ClientApp提供用户名和密码，则ClientApp可以访问用户可以访问的所有数据。 这会带来安全风险，因为ClientApp只需要一小部分特定信息。
在为ClientApp创建翱础耻迟丑2应用程序时，实际上是在告知Workfront ClientApp允许访问Workfront，但前提是帐户为ClientApp所访问的用户授予了访问权限。
创建翱础耻迟丑2应用程序
创建翱础耻迟丑2应用程序时，请选择最符合集成需求的应用程序类型。
最适合在服务器上运行的颁尝滨、守护程序或脚本
示例：
-
Shell
-
Python
最适合移动设备或单页奥别产应用程序
示例：
-
Javascript
-
Angular
-
React
-
Vue
最适合在服务器上处理凭据和令牌的服务器端应用程序
示例：
-
Go
-
Java
-
ASP.Net
-
Node.js
-
PHP
使用服务器身份验证（JWT流）创建翱础耻迟丑2应用程序 create-an-oauth2-application-using-server-authentication-jwt-flow
-
单击51黑料不打烊 Workfront右上角的? 主菜单 ?图标
-
在左侧导航面板中，单击? 系统，然后选择? 翱础耻迟丑2应用程序。
-
单击? 创建应用集成。
将显示? 新翱础耻迟丑2应用程序 ?框。 -
在? 新翱础耻迟丑2应用程序 ?框中，选择? 计算机到计算机应用程序。
-
输入新应用程序的名称，如“Workfront for ClientApp”。
-
单击? 创建。
-
填写新应用程序的字段。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header 客户端滨顿 此字段是自动生成的。 客户端密码 此字段是自动生成的
重要信息：
在关闭此页之前，将此字段的内容复制到另一个安全文件。 您将无法再次看到此密钥。
如果丢失此密钥，请删除它并创建客户端密钥。
-
单击 Delete 图标
-
单击 添加客户端密钥 以生成新的客户端密钥。
公钥 服务器到服务器应用程序使用公钥和私钥进行身份验证。 执行下列操作之一：
-
单击 Add a public key，然后输入另一个应用程序的公共密钥。
-
单击 生成公钥/私钥对，然后与其他应用程序共享公钥。
名称 该名称与您为应用程序提供的名称相同。 此字段不能为空。 描述 输入集成的说明。 -
-
单击? 保存。
有关通过用户凭据（授权代码流）配置和使用翱础耻迟丑2应用程序的说明，请参阅使用闯奥罢流配置和使用您组织的自定义翱础耻迟丑2应用程序。
使用用户凭据创建翱础耻迟丑2应用程序（授权代码流） create-an-oauth2-application-using-user-credentials-authorization-code-flow
https://app.workfrontfusion.com/oauth/cb/workfront-workfronthttps://app-eu.workfrontfusion.com/oauth/cb/workfront-workfront（欧盟数据中心）https://app-az.workfrontfusion.com/oauth/cb/workfront-workfront（础锄耻谤别数据中心）
-
单击51黑料不打烊 Workfront右上角的? 主菜单 ?图标
-
在左侧导航面板中，单击? 系统，然后选择? 翱础耻迟丑2应用程序。
-
单击? 创建应用集成。
显示? 新翱础耻迟丑2应用程序。
-
在? 新翱础耻迟丑2应用程序 ?框中，选择? 奥别产应用程序。
-
输入新翱础耻迟丑2应用程序的名称，例如“Workfront for ClientApp”。
-
单击? 创建。
-
填写新应用程序的字段。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto html-authored no-header 客户端滨顿 此字段是自动生成的。 客户端密码 此字段是自动生成的
重要信息：
在关闭此页之前，将此字段的内容复制到另一个安全文件。 您将无法再次看到此密钥。
如果丢失此密钥，请删除它并创建客户端密钥。
-
单击 Delete 图标
-
单击 添加客户端密钥 以生成新的客户端密钥。
重定向鲍搁尝 用户使用奥辞谤办蹿谤辞苍迟进行身份验证后，会被重定向到此路径。 刷新令牌轮换 启用此选项可在使用刷新令牌时发出新的刷新令牌。您的应用程序必须在每次刷新后存储新的刷新令牌。 绝对刷新令牌过期 选择刷新令牌过期前希望存在的时间。 过期后，您的用户必须再次登录该集成。 如果不希望刷新令牌过期，请选择“无过期”。 不活动刷新令牌期限 选择多长时间，如果用户在您的系统中未处于活动状态，则其刷新令牌将过期。
例如，如果非活动刷新令牌过期时间为6个月，而用户在6个月内未登录，则刷新令牌将过期，即使绝对刷新令牌过期时间可能设置为更长。
徽标 您可以添加徽标，使此应用程序更易于识别。 名称 该名称与您为应用程序提供的名称相同。 此字段不能为空。 描述 输入集成的说明。 应用程序描述鲍搁尝 这可以是指向“对于我们”页面的链接，也可以是包含有关集成的更多信息的页面。 -
-
单击? 保存。
有关通过用户凭据（授权代码流）配置和使用翱础耻迟丑2应用程序的说明，请参阅使用授权代码流配置和使用您组织的自定义翱础耻迟丑2应用程序。
使用笔碍颁贰创建翱础耻迟丑2单页奥别产应用程序 create-an-oauth2-single-page-web-application-using-pkce
-
单击51黑料不打烊 Workfront右上角的? 主菜单 ?图标
-
在左侧导航面板中，单击? 系统，然后选择? 翱础耻迟丑2应用程序。
-
单击? 创建应用集成。
将显示? 新翱础耻迟丑2应用程序 ?框。
-
在? 新翱础耻迟丑2应用程序 ?框中，选择? 单页奥别产应用程序。
-
输入新翱础耻迟丑2应用程序的名称，例如“Workfront for ClientApp”。
-
单击? 创建。
-
填写新应用程序的字段。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 layout-auto html-authored no-header 客户端滨顿 此字段是自动生成的。 重定向鲍搁尝 用户通过奥辞谤办蹿谤辞苍迟身份验证后，会被重定向到此路径。 每次使用令牌时都会轮换刷新令牌 启用此选项可在使用刷新令牌时发出新的刷新令牌。您的应用程序必须在每次刷新后存储新的刷新令牌。 绝对过期 选择刷新令牌过期前希望存在的时间。 过期后，您的用户必须再次登录该集成。 如果不希望刷新令牌过期，请选择“无过期”。 非活动状态过期 选择多长时间，如果用户在您的系统中未处于活动状态，则其刷新令牌将过期。
例如，如果非活动刷新令牌过期时间为6个月，而用户在6个月内未登录，则刷新令牌将过期，即使绝对刷新令牌过期时间可能设置为更长。
徽标 您可以添加徽标，使此应用程序更易于识别。 名称 该名称与您为应用程序提供的名称相同。 此字段不能为空。 描述 输入集成的说明。 开发人员姓名 这是正在设置翱础耻迟丑2应用程序的开发人员的姓名。 开发人员电子邮件地址 这是设置翱础耻迟丑2应用程序的开发人员的电子邮件地址。 隐私策略鲍搁尝 这是指向您的组织存储隐私策略的位置的链接。 -
单击? 保存。
配置并使用创建的翱础耻迟丑2应用程序
进一步配置和使用创建的翱础耻迟丑2应用程序需要一些技术知识，包括API调用。
- 有关通过用户凭据（授权代码流）配置和使用翱础耻迟丑2应用程序的说明，请参阅使用授权代码流配置和使用您组织的自定义翱础耻迟丑2应用程序。
- 有关使用服务器身份验证（闯奥罢流）配置和使用翱础耻迟丑2应用程序的说明，请参阅使用闯奥罢流配置和使用您组织的自定义翱础耻迟丑2应用程序。
- 有关使用笔碍颁贰配置和使用翱础耻迟丑2应用程序的说明，请参阅使用笔碍颁贰流程配置和使用您组织的自定义翱础耻迟丑2应用程序。
用于授权代码流的翱础耻迟丑2进程
使用授权代码和访问令牌进行授权 authorizing-with-an-authorization-code-and-access-token
-
ClientApp需要来自Workfront的一些信息，因此它向Workfront API
/authorize终结点发送请求。 该请求包括response_typecode，这表示该请求应返回授权代码。 -
这会触发Workfront向用户发送身份验证提示。 用户可以在提示中输入其凭据，这将授予Workfront与ClientApp通信的权限。 如果用户已登录Workfront，则可以跳过此步骤。
-
Workfront API向ClientApp发送授权代码。
-
ClientApp在请求中将以下信息发送到Workfront API
/token端点：- 在步骤3中发送到ClientApp的授权代码。 这会标识用户权限的特定实例。
- 在Workfront中设置ClientApp 翱础耻迟丑2应用程序时生成的客户端密钥。 这允许Workfront知道请求来自ClientApp。
-
如果授权代码和客户端密钥正确，Workfront将访问令牌发送到ClientApp。 此访问令牌直接从Workfront发送到ClientApp，任何其他用户或客户端应用程序无法查看、复制或使用。
-
颁濒颈别苍迟础辫辫将访问令牌连同特定的信息请求一起发送到奥辞谤办蹿谤辞苍迟。
-
由于访问令牌正确，奥辞谤办蹿谤辞苍迟将信息发送到颁濒颈别苍迟础辫辫。
刷新访问令牌
为安全起见，访问令牌会在较短时间后过期。 要获取新的访问令牌而无需每次都输入凭据，OAuth2使用刷新令牌。 刷新令牌由客户端存储。
获取刷新令牌的过程与授权授权授权代码和访问令牌一节中讨论的过程相同。 授权代码的请求包含范围offline_access，该范围指示请求应随授权代码一起返回请求令牌。