添加 Microsoft Exchange IMAP 应用程序

了解如何将 Microsoft™ Exchange 应用程序添加到 IBM RPA。 此应用程序使用 IMAP 从电子邮件服务访问数据。

如果要添加基于 Microsoft™ Exchange Web Service (EWS) 的应用程序,请参阅 添加 Microsoft Exchange 旧应用程序

❕ 重要信息: 此过程仅适用于本地 IBM RPA 。缺省情况下,
IBM RPA SaaS 提供应用程序。 创建与此应用程序的连接以在 IBM RPA SaaS上使用此应用程序。 有关更多信息,请参阅 向应用程序添加连接

开始之前

以下列表显示了创建 Microsoft™ Exchange 应用程序的先决条件:

过程

执行以下步骤以创建 Microsoft™ Exchange 应用程序:

  1. 创建 Microsoft Entra ID 应用程序
  2. 获取客户机值和应用程序标识
  3. 添加应用程序

创建 Microsoft Entra ID 应用程序

  1. 登录到 Azure 帐户 🡥

  2. 在搜索栏中,搜索 Microsoft Entra ID,然后将其选中。

  3. 管理 菜单中,单击 应用程序注册 > 新建注册

  4. 名称 字段中,输入应用程序的名称,例如 Microsoft Exchange app

  5. 支持的帐户类型中,单击任何组织目录中的帐户(任何 Microsoft Entra ID 租户 - 多租户)和个人 Microsoft 帐户(如 Skype、Xbox) 选项。

  6. 重定向 URI 部分中,输入以下值:

    • 选择平台 列表中,选择 Web
    • URL 字段中,输入 API URL ,如 https://192.158.1.38:7790 ,其中 192.158.1.38 是服务器 IP, 7790 是 IBM RPA 的 API 使用的端口, OAuth2 规范 /integration/oauth2。 以下是具有 OAuth2 规范的有效 URL 的示例:
      • https://192.51.100.38:7790/integration/oauth2
      • https://api.example.com/integration/oauth2

    🛈 记住: 将 URL 替换为相应的服务器 API URL。

  7. 单击注册

获取客户机值和应用程序标识

  1. 可选:搜索您创建的 Microsoft Entra ID 应用程序。
  2. 管理 菜单中,单击 证书和私钥
  3. 单击新建客户机密钥按钮。
  4. 描述 字段中,输入凭证的描述。
  5. 到期 列表中,选择凭证的到期日期。
  6. 单击添加
  7. 复制 列中的值,例如 b47ga196-5d6a-5842-be6c-13f6d6525630
  8. 从 " 概述 " 页面,复制 应用程序 (客户机) 标识 值,例如 abc-xyz-3e3s-grgr234-dfedvcefger

添加应用程序

  1. 登录到 IBM RPA Control Center。

  2. 执行下列其中一项操作:

    • 如果在 V 21.0.7上,请单击主菜单上的 应用程序
    • 如果在 V 21.0.5 或 21.0.6上,请单击主菜单上的 连接 ,然后单击 应用程序 选项卡。
  3. 单击添加应用程序

  4. 名称 字段中,输入应用程序名称。

  5. 描述 字段中,输入应用程序描述。

  6. 应用程序标记 字段中,选择用于标识应用程序的标记。 该标记用于过滤应用程序。

  7. 单击下一步

  8. 客户端 ID 字段中,输入从 Microsoft Entra ID 应用程序获得的应用程序(客户端)ID,例如 abc-xyz-3e3s-grgr234-dfedvcefger

  9. 客户端秘密字段中,输入从 Microsoft Entra ID 应用程序中获取的客户端值,例如 b47ga196-5d6a-5842-be6c-13f6d6525630

  10. 重定向 URL 字段中,输入您提供给 Microsoft Entra ID 应用程序的重定向 URL ,例如 https://192.51.100.38:7790/integration/oauth2

  11. 授权 URL 字段中,输入 https://login.microsoftonline.com/common/oauth2/v2.0/authorize

  12. 授权模板参数 字段中,输入以下代码片段:

    client_id={clientId}&response_type=code&redirect_uri={redirectUri}
    

    🛈 请记住: IBM RPA 会自动将 {clientId}{redirectUri} 的值分别替换为客户 ID重定向 URL 中定义的值。

  13. 令牌 URL 字段中,输入 https://login.microsoftonline.com/common/oauth2/v2.0/token

  14. API URL 字段中,输入 https://graph.microsoft.com/v1.0/

  15. 作用域 字段中,输入 openid email offline_access https://outlook.office.com/User.Read https://outlook.office.com/IMAP.AccessAsUser.All https://outlook.office.com/SMTP.Send

  16. 单击下一步

  17. 查看您输入的数据的摘要,然后单击 添加

结果

因此,您可以查看声明已成功添加应用程序的通知。 您还可以在应用程序列表中查看应用程序。

如果失败,您还可以查看通知。 在这种情况下,请查看您输入的数据,然后重试创建应用程序。

下一步

  • 创建连接
    创建连接以授权应用程序。 有关更多信息,请参阅 连接

  • 编辑应用程序
    如果要编辑应用程序,请执行下列其中一项操作:

    • 如果在 V 21.0.7上,单击主菜单中的 应用程序 ,然后单击 垂直省略号按钮,以进行编辑 > 编辑
    • 如果在 V 21.0.5 或 21.0.6上,请单击主菜单中的 连接 ,然后单击 应用程序 > 垂直省略号按钮,以进行编辑 > 编辑

    ⚠ 注意: 如果更改应用程序数据,那么必须重新授权与其绑定的连接。

    1. 在 IBM RPA Control Center上,执行下列其中一项操作:
      1. 如果在 V 21.0.7上,请单击 连接 菜单。
      2. 如果在 V 21.0.5 或 21.0.6上,请单击主菜单中的 连接 ,然后单击 连接
    2. 在连接上,单击 垂直省略号按钮, > 重新授权
  • 使应用程序过时
    如果要将应用程序标记为过时,请执行下列其中一项操作:

    • 如果在 V 21.0.7上,单击主菜单中的 应用程序 ,然后单击 垂直省略符按钮,即表示 > 使其过时
    • 如果在 V 21.0.5 或 21.0.6上,请单击主菜单中的 连接 ,然后单击 应用程序 > 垂直省略号按钮,以用于 > 使其过时

    ⚠ 注意: 将应用程序标记为过时不会将其永久移除。 使用该应用程序的所有现有连接都保持活动状态,尽管您无法创建与该应用程序的新连接。

  • 重新激活过时的应用程序
    从 21.0.7: 如果要重新激活过时的应用程序,请在 应用程序 菜单中单击 垂直省略符按钮, > 重新激活

  • 删除应用程序
    从 21.0.7: 如果要删除未与之连接的应用程序或过时的应用程序,请在 应用程序 菜单中单击 垂直省略号按钮, > 删除

    ⚠ 注意: 这将从系统中永久除去应用程序。