微应用

集成 Adobe Sign

部署 ADOSIGN 集成,快速安全地将每份协议和审批数字化。

使用 Citrix Adobe Sign 集成,用户可以执行以下操作:

  • 向收件人发送模板并上传协议以供签名。
  • 等待用户签名的 Adobe Sign 协议列表。用户可以从 Citrix Workspace 签署协议。
  • 列出已发送的 Adobe Sign 协议以供签名。用户还可以取消已发送的协议。
  • 列出已完成的 Adobe Sign 协议和详细信息用户还可以共享收到的协议。
  • 列出已取消的 Adobe Sign 协议和详细信息
  • 管理和编辑模板协议。

衷心期盼您的反馈信息!请在使 用此集成模板时提供反馈 。对于任何问题,我们的团队还将每天监控我们的 专门论坛

有关微应用的全面详细信息,请参阅 使用 Adobe Sign 微应用。

查看必备项

在与 Adobe Sign 设置此集成后,您需要以下工件才能在 Citrix Workspace 微应用中添加集成:

  • 基本 URLhttps://api.in1.adobesign.com/
  • Adobe Sign 群组 ID:此群组 ID 表示管理员帐户的用户组 ID。
  • 每个用户的协议数:这是每个用户要在缓存中存储的协议数量。最大值为 100。我们建议每位用户达成 15—30 个协议。
  • 授权 URLhttps://{HostName}.com/public/oauth
  • 令牌 URLhttps://{HostName}.com/oauth/token
  • 刷新令牌 URLhttps://{HostName}.com/oauth/refresh
  • 范围user_read:self user_write:自己 user_write:自我用户登录:自我协议 _ 读:自我协议 _ 写:自我协议 _ 发送:自我申请 _ 写:自我库 _ 写:自我
  • 客户端 ID:客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。
  • 客户端密钥:客户端密钥是设置目标应用程序集成时发出的唯一字符串。
  • 中继状态:无
  • 请求速率限制:每秒 500 个请求
  • 请求超时:120

注意

建议您始终使用 OAuth 2.0 作为可用的服务身份验证方法。OAuth 2.0 可确保您的集成符合配置的微应用的最高安全性合规性。

创建服务账号

集成需要定期访问您的 Adobe Sign 实例。我们建议创建一个专用的用户帐户。此帐户必须是具有完全管理员权限的 Adobe Sign 管理员帐户。

要设置新帐户,请参阅 创建免费的 Adobe Sign 帐户

启用 API

Adobe Sign 中没有提到任何 API 限制。以下链接中提到了 Adobe Sign 交易限制: https://helpx.adobe.com/in/sign/using/transaction-limits.html. 可以根据您的要求选择计划。

配置 OAuth 客户端应用

将 OAuth 客户端配置为通过集成写回数据。有关使用 Adobe Sign 的更多信息,请参阅 入门指南(Adobe Sign)

  1. 登录到 Adobe Sign 管理员帐户: https://secure.echosign.com/public/login
  2. 选择 帐户 ,然后在 Adobe SignAPI 部分下选择 API 应用程序
  3. 选择 创建 并创建两个新 应用程序
  4. 对于第一个应用程序,将重定向 URL 粘贴到 重定向 Uri 字段中。

    • https://{yourmicroappserverurl}.us.iws.cloud.com/app/api/auth/serviceAction/callback
    • https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext
  5. 选择并选择 OAuth Configure 选项,然后启用所有带修饰符的作用域作为
  6. 对第二个 OAuth 应用程序重复相同的步骤。
  7. 从两个 OAuth 应用程序收集 客户端 ID和客户端密钥 详细信息并保存以备将来使用。配置集成时,您可以将这些值用于服务身份验证和服务操作身份验证。

配置组并获取组 ID

组允许您拥有单独的用户子集,这些子集可以访问不同的图书馆文档和不同的设置。有关详细信息,请参阅 创建和管理群组 (Adobe Sign.

  1. 登录到 Adobe Sign 管理员帐户: https://secure.echosign.com/public/login
  2. 选择 帐户,然后选择 部分。
  3. 选择 创建新组 以添加新组。
  4. 为组输入适当的名称。
  5. 选择并选择 组设置 选项以在配置页面上查找 组 ID
  6. 向组添加或导入用户。

将集成添加到 Citrix Workspace 微应用

将 Adobe Sign 集成添加到 Citrix Workspace 微应用程序以连接到您的应用程序。这样可以提供带有预配置通知和操作的开箱即用的微应用,这些通知和操作随时可以在 Workspace 中使用。

请按照以下步骤进行操作:

  1. 微应用集成 页面中,选择 添加新集成,然后 从 Citrix 提供的模板中添加新集成。
  2. 选择 Adobe Sign 磁贴。
  3. 输入集成的名称。
  4. 输入 连接器参数

    • 输入实例基本 URL: https://api.in1.adobesign.com/
    • 从图标库中选择用于集成的图标,或将其保留为默认图标。
    • 输入您的 Adobe Sign 群组 ID。有关更多信息,请参阅: 配置组并获取组 ID
    • 输入 每个用户的协议。这是每个用户要在缓存中存储的协议数量。最大值为 100。我们建议每位用户达成 15—30 个协议。
  5. 在服务身份验证下,从身份验证方法菜单中选择 OAuth 2.0,然后填写身份验证详细信息。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为可用的服务身份验证方法。OAuth 2.0 可确保您的集成符合配置的微应用的最高安全性合规性。

    1. 授权类型菜单中选择授权码 。这会授予客户端用来交换访问令牌的临时代码。该代码从授权服务器获取,您可以在其中查看客户端请求的信息。只有这种授权类型才能启用安全的用户模拟。这将显示您在注册应用程序时使用的回调 URL。
    2. 令牌授权 菜单中选择 请求正 文,然后选择 令牌内容类型 作为 URL 编码表单。
    3. 输入 刷新令牌 URLhttps://{HostName}/oauth/refresh
    4. 确保为 范围: user_read: self user_write: self user_write: self user_log: 自我同意 _ 阅读:自我协议 _ 写:自我协议 _ 发送:自我申请 _ 写:自我申请 _ 写:self library_write: self
    5. 输入您的 客户 ID。客户端 ID 是表示授权服务器特有的客户端注册信息的字符串。您在配置 OAuth 服务器时收集此密钥和密钥。添加您在集成配置页面上看到的回调 URL。
    6. 输入您的 客户端密钥。客户端密钥是设置目标应用程序集成时发出的唯一字符串。
  6. 在服务操作身份验证下,启用在操作中使用单独的用户身份验证开关服务操作身份验证在服务操作级别进行身份验证。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。

    1. 身份验证方法 菜单中选择 OAuth 2.0 ,然后填写身份验证详细信息。
    2. 授权类型菜单中选择授权码。这会授予客户端用来交换访问令牌的临时代码。该代码从授权服务器获取,您可以在其中查看客户端请求的信息。只有这种授权类型才能启用安全的用户模拟。这将显示您在注册应用程序时使用的回调 URL。
    3. 令牌授权菜单中选择请求正文
    4. 授权 URL 是预先填写的。
    5. 牌 URL 已预填。
    6. 确保为 范围: user_read: self user_write: self user_write: self user_log: 自我协议 _ 阅读:自我协议 _ 写:自我协议 _ 发送:自我申请 _write: self library_write: self library_write: self library_read: self library_read: self
    7. 输入您的 客户 ID。客户端 ID 是表示授权服务器特有的客户端注册信息的字符串。您在配置 OAuth 客户端时收集此密钥和密钥。添加您在集成配置页面上看到的回调 URL。
    8. 输入您的 客户端密钥。客户端密钥是设置目标应用程序集成时发出的唯一字符串。
  7. 选择 保存 以继续。
  8. OAuth 授权下,选择 授权 以使用您的服务帐户登录。出现一个带有 Google 登录屏幕的弹出窗口。

    1. 输入您的服务帐 户用户名 和密码,然后选择 登录
    2. 选择 接受

将重定向操作添加到开放协议按钮

使用以下按钮的主机名配置此转到 URL 操作,以便为这些微应用启用开放协议按钮功能。此转到 URL 配置将用户重定向到 DocuSign 中的特定信封详情页面。导航到下面列出的每个按钮以执行此操作:

微应用 页面 按钮
进行中协议 进行中协议详情 开放协议
取消的协议 已取消协议详情 开放协议
取消的协议 协议已取消 开放协议
完成的协议 已完成协议详情 开放协议
完成的协议 协议已完成 开放协议

请按照以下步骤进行操作:

  1. 导航到上面列出的第一个按钮,选择该按钮,然后选择右侧的 “ 操作 ” 选项卡。
  2. 在 “ 添加操作 ” 字段中,选择 “ 转到 URL”。
  3. URL 模板 字段中,将 URL 的 {Your Adobe Sign Host} 部分替换为您的主机名。按照此模型,在 Adobe Sign 实例 URL 中查找您的 Adobe Sign 主机名: https://{hostname}.in1.adobesign.com/public/login。例如,https://citrixwsi.in1.adobesign.com/public/login
  4. 现在对其他按钮重复此过程,将 URL 的 {Your Abobe Sign Host} 部分替换为您的主机名。

    “转到 URL” 操作

现在,您已准备好设置和运行第一次数据同步。有关同步规则、不符合其计划的同步和否决规则的完整信息,请参阅同步数据

有关 API 端点和表实体的更多详细信息,请参阅 Adobe Sign 连接器规范

使用 Adobe Sign 微应用

现有的应用程序集成随现成的微应用程序一起提供。从这些微应用开始,然后根据您的需求自定义它们。

发送协议: 发送模板并将协议上传给收件人以供签名。

通知或页 用例工作流
“我的模板” 页 提供可供用户使用的模板协议列表,其中包含使用上载选项 创建 和发送给用户以供协议的选项。
“发送协议” 页 允许用户使用上传选项向收件人发送协议。
“发送模板” 页 允许用户向收件人发送模板协议。

我收到的协议: 提供等待用户签名的 Adobe Sign 协议的列表。用户可以签署协议表

通知或页 用例工作流
收到新协议通知 收件人会收到创建的所有新协议的通知。
新协议已更改通知 收件人会收到所有使用 “ 订单依据 ” 选项创建的新协议的通知。
协议提醒通知 收件人会收到有待处理一周的未签署协议的通知。
“我收到的协议” 页 提供所有收到的协议的个性化列表。
“我收到的协议详情” 页 将显示收到的协议的详细信息以及 “ 签署协议” 和 “发送给其他收件人” 选项。
已收到协议页 将显示收到的协议的详细信息,以及 “ 签署协议” 和 “发送给其他收件人” 的选项。
股票协议页面 允许收件人与其他用户共享收到的协议。
“签署协议” 页 允许收件人签署和完成协议。

进行中的协议: 正在进行的要签署的 Adobe Sign 协议列表。用户还可以取消已发送的协议。

通知或页 用例工作流
我的已发送协议页面 提供已发送协议的个性化列表。
进行中的协议详细信息页 允许用户查看所选已发送协议的详细信息,以及 “取 消协议” 和 “开放协” 选项。

已完成的协议: 已完成的 Adobe Sign 协议和详细信息列表。用户还可以共享收到的协议。

通知或页 用例工作流
已签署协议通知 协议的发件人会收到有关已签署协议的通知。
已完成的协议页 提供已完成协议的个性化列表。
已完成的协议详情页 允许用户通过操作页面中的 “ 发送给其他收件人 ” 和 “ 打开协议” 选项查看所选已完成协议 的详细信息。
协议已完成页 允许用户查看所选已完成协议的详细信息,其中包含 “ 发送给其他收件人 ” 和 “ 打开协议” 的选项。从通知源中。
股票协议页面 允许收件人将收到的协议共享给其他用户。

已取消的协议: 已取消的 Adobe Sign 协议和详细信息列表。

通知或页 用例工作流
已取消协议通知 系统会通知协议的收件人已取消协议。
已取消协议页 提供已取消协议的个性化列表。
已取消协议详情页面 允许用户查看选定已取消协议的详细信息,并可以选择 打开协议
协议已取消页 允许用户查看选定已取消协议的详细信息,并可以选择 打开协议

管理协议: 管理和编辑模板协议。

通知或页 用例工作流
我的模板页面 提供个性化的模板列表。
“管理模板” 页 允许用户在 Citrix Workspace 中编辑选定的模板。