微应用

集成 Covid-19 自我证明

使用 Citrix Workspace 的自我证明回复部署 Covid-19 自我证明集成以提交您的 Covid-19 自我证明状态。

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

有关此微应用的全面详细信息,请参阅使用 Covid 自我证明微应用

查看必备项

此集成需要 COVID 自我认证 Podio 应用包。有关更多信息,请参阅在 Citrix Podio 中获取和配置 Covid 自我证明应用程序

与 Covid-19 自我证明设置此集成后,您需要以下工件才能在 Citrix Workspace 微应用中添加集成:

  • 基本 URLhttps://api.podio.com
  • Covid 自我认证应用程序 ID:输入您的 Podio 工作空间应用程序 ID。请参阅 收集应用程序 ID 和应用令牌
  • Covid 自我认证查看 ID:输入您的 Podio 工作空间应用程序视图 ID。请参阅 收集视图 ID
  • 国家/地区数据应用程序 ID:输入 Covid-19 自我认证中可用的国家数据应用程序 ID。请参阅 收集国家数据应用程序 ID
  • 身份验证方法:OAuth 2.0

    注意:

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

  • 授权类型流程:授权码
  • 予类型值:授权_code
  • 回调 URLhttps://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext
  • 令牌授权:请求正文
  • 令牌内容类型:URL 编码表单
  • 授权 URLhttps://podio.com/oauth/authorize
  • 令牌 URLhttps://podio.com/oauth/token
  • 客户端 ID:客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。
  • 客户端密钥:客户端密钥是设置目标应用程序集成时发出的唯一字符串。
  • 刷新令牌 URL:不适用
  • 范围:不适用
  • 中继状态:无
  • 访问令牌参数:按照以下说明输入名称和值参数:
    1. app_id:输入 Podio 工作空间应用程序 ID。请参阅 收集应用程序 ID 和应用令牌
    2. app_token:输入 Podio 工作空间应用程序令牌。请参阅 收集应用程序 ID 和应用令牌
    3. grant_type:应用程序
  • 请求速率限制:每分钟 15 个请求
  • 请求超时:120

创建服务账号

集成需要定期访问您的 Covid 自我证明实例,因此我们建议您创建一个专用的用户帐户。此帐户必须是 Covid 自我证明 Podio Workspace 应用程序的管理员或成员。

要向 Covid 自我证明 Podio 工作区添加多个管理员/成员,请参阅邀请和添加成员到 Podio 工作区

在 Citrix Podio 中获取并配置 Covid 自我证明应用程序

此集成需要 COVID 自我认证应用程序包。该应用包包括 Covid 自我认证应用程序和国家/地区数据应用程序。从 Podio 应用市场安装此应用程序包: COVID 自我认证应用程序包

要配置应用程序,请按照下列步骤操作:

  1. 登录到您的 Citrix Podio 实例: https://podio.com/
  2. 使用适当的名称创建一个工作区。
  3. 将国 家/地区数据 应用添加到您的工作区,然后将以下四个字段插入国家/地区数据应用
    1. 区域:添加一个名为的 文本 组件 Region ,用于存储区域名称。
    2. 国家/地区:添加名为的 文本 组件, Countries 该组件存储要向最终用户显示的国家或城市(与地区有关)。
    3. 准则:添加名为的 文本 组件, Guidelines 该组件存储最终用户需要遵循的准则或条件。
    4. 图片:添加名为的 链接 组件, Image 该组件存储适合您所在地区的任何图像。
  4. Covid 自我证明 应用程序添加到您的工作区中,然后将以下六个字段插入 Covid 自我证明应用程序:
    1. 名称:添加一个名为的 文本 组件 Name ,用于存储员工/用户的姓名。
    2. 电子邮件:添加名为的 电子邮 件组件 Email ,用于存储员工/用户的电子邮件。
    3. 条件:添加名为的 C ateg ory 组件 Condition 并插入两个类别选项: AgreeDisagree
    4. CreateDon:添加一个名为的 日期 组件, CreatedOn 该组件存储已同意/不同意的日期和时间值。
    5. 区域:添加名为的 文本 组件 Region ,用于存储用户/员工选择的区域值。
    6. 国家/地区:添加名为的 文本 组件, Country 该组件存储用户/员工选择的国家/地区值。

配置 OAuth 客户端应用

  1. 以 Podio Worspace 应用程序管理员的身份登录 Podio 开发者网站: https://developers.podio.com
  2. 选择 生成您的 API 密钥
  3. 选择 立即获取 API 密钥 ,然后按照以下说明输入 应用程序名称 字段和 字段。
    1. 应用程序名称: 输入您的应用名称。
    2. 域:返回 URL 的完整域(无协议)输入微应用实例 URL。URL 的这一部分 {yourmicroappserverurl} 由租户部分、区域部分和环境部分组成: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com
  4. 选择 生成 API 密钥
  5. 您的 API 密钥下,复制并保存 客户端 ID 和客 户端密 钥值,以备将来参考。

有关详细信息,请参阅 https://docs.citrix.com/en-us/citrix-microapps/set-up-template-integrations/integrate-podio.html#collect-client-id-and-client-secret

收集应用程序 ID 和应用令牌

从 Podio 收集应用程序 ID 和应用令牌,以应用而不是用户身份进行身份验证。通过应用 ID 访问权限,用户只能访问相关 Podio 工作区中应用的数据。您可以从 Podio 工作区的 Podio 应用程序中收集此 ID。如果一个工作区中有多个应用程序,则可以使用与工作区关联的任何应用程序 ID。

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

  1. 登录 Podio,然后导航到 Podio 应用程序。
  2. 选择应用程序名称 旁边的工具图标
  3. 应用下,选择 开发人员
  4. 复制并保存 “ 应用程序 ID ” 和 “ 令牌 ” 字段。在设置集成时,您可以将这些值作为 访问令牌参数 输入。

有关详细信息,请参阅 https://docs.citrix.com/en-us/citrix-microapps/set-up-template-integrations/integrate-podio.html#collect-app-id-and-app-token

收集视图 ID

  1. 登录 Podio,然后导航到 Podio 应用程序。
  2. 将鼠标悬停在上面指定的字段上可以在浏览器的左下角查看视图 ID。对于 covid-19 自我认证,请将光标置于 “同 意/不同意 ” 上,然后在 URL 链接中 查找您的视图 ID

有关详细信息,请参阅 https://docs.citrix.com/en-us/citrix-microapps/set-up-template-integrations/integrate-podio.html#collect-view-id

收集国家/地区数据应用程序ID

  1. 登录 Podio,然后导航到 Podio 应用程序。
  2. 选择应用程序名称旁边的 工具 图标。
  3. 国家数据应用下,选择 开发人员
  4. 复制并保存 “ 应用程序 ID ” 和 “ 令牌 ” 字段。在设置集成时,您可以将这些值作为 访问令牌参数 输入。

将集成添加到 Citrix Workspace 微应用

将 Covid 自我证明集成添加到 Citrix Workspace 微应用程序以连接到您的应用程序。这样可以提供带有预配置通知和操作的开箱即用的微应用程序,这些通知和操作可在工作区中使用

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

  1. 微应用集成 页面中,选择 添加新集成,然后 从 Citrix 提供的模板中添加新集成。
  2. 选择 Covid 自我证明 磁贴。
  3. 输入 集成的集成名称
  4. 输入 连接器参数
    • 输入实例 基本 URLhttps://api.podio.com
    • 输入你的 Podio 应用程序 ID
    • 输入 Podio 工作空间 应用程序视图 ID

    Covid 配置设置

  5. 服务身份验证下,从身份验证 方法 菜单中选择 OAuth 2.0 ,然后填写身份验证详细信息。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为可用的服务身份验证方法。OAuth 2.0 可确保您的集成符合配置的微应用的最大安全合规性。

    1. 授权类型流程菜单中选择授权码
    2. 授权类型值字段中输入 authorization_code
    3. https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext回调 URL 字段中输入。
    4. 令牌授权菜单中选择请求正文
    5. 令牌内容类型 菜单中选择 URL 编码表 单。
    6. https://podio.com/oauth/authorize授权 URL 字段中输入。
    7. 确认令 牌 URL 字段。此值已预先填充:https://podio.com/oauth/token
    8. 输入您的 客户端 ID:客户端 ID 是表示授权服务器特有的客户端注册信息的字符串。您在生成 API 密钥时收集此密钥和客户端密钥。请参阅 配置 OAuth 客户端应用程序
    9. 输入您的 客户端密钥:客户端密钥是设置目标应用程序集成时发出的唯一字符串。您在生成 API 密钥时收集此 ID 和客户端 ID。请参阅 配置 OAuth 客户端应用程序
  6. 刷新令牌 URL:不适用
  7. 范围:不适用
  8. 中继状态:无

    Covid 身份验证设置

  9. 添加以下 访问令牌参数。有关更多信息,请参阅 收集应用程序 ID 和应用令牌
    1. app_id:输入 Podio 工作空间应用程序 ID
    2. app_token:输入 Podio 工作空间应用程序令牌
    3. grant_type:应用程序

Covid 令牌设置

  1. OAuth 授权下,选择 授权 以使用您的服务帐户登录。出现一个带有 Google 登录屏幕的弹出窗口。
    1. 输入您的 服务帐户用户名服务帐户密码 ,然后选择 登录
    2. 选择 接受
  2. 请求速率限制字段中输入每分钟 15个请求
  3. 120 在请 求超时 字段中输入。
  4. 选择 保存 以继续。

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

注意:

我们建议每小时触发一次增量同步,每天触发两次或三次完全同步。

有关 API 端点和表实体的更多详细信息,请参阅 Covid-19 自我证明连接器规范

使用 Covid 自我证明微应用

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

自我证明:从 Citrix Workspace 提交每日 covid-19 自我证明状态回复。

通知或页面 用例工作流
Covid 自我证明 - 同意:项目变更通知 获得所有同意的 covid-19 自我认证回复的通知。
Covid 自我证明 - 不同意:项目变更通知 收到所有不同意的 covid-19 自我认证回复提交的通知。
新的自我证明 - 同意:项目新通知 获得所有同意的 covid-19 自我认证回复的通知(新用户)。
新的自我证明 - 不同意:项目新通知 收到所有不同意的 covid-19 自我认证回复提交的通知(新用户)。
“选择区域:项目” 页 选择他们的工作地点。
自我认证指南页面 提交每日自我证明的回复。
同意自我证明:项目页 查看每日自我证明的同意回复详细信息。
已确认自我认证页面 从他们的通知源中查看每日自我证明的商定回复详细信息。
自我证书被拒绝页 查看每日自我证明的不同意回复详细信息。
自我认证不同意页面 从他们的通知源中查看每日自我证明的不同意回复详细信息。