添加 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. 获取客户机值和应用程序标识
  4. 添加应用程序

创建 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

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

  7. 单击注册

为应用程序添加应用程序接口权限

注册应用程序后,必须添加创建连接所需的 API 权限:

  1. 从应用程序概览页面进入应用程序的 API 权限页面。
  2. 单击 " 添加权限 ",然后在弹出窗口中选择 Microsoft Graph
  3. 选择 " 委托权限 ",然后使用搜索框查找并选择以下权限:
    • openid
    • email
    • offline_access
    • User.Read
    • IMAP.AccessAsUser.All
    • SMTP.Send

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

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

添加应用程序

  1. 登录到 IBM RPA 控制中心

  2. 单击主菜单上的 应用程序

  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. 查看您输入的数据的摘要,然后单击 添加

结果

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

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

下一步

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

  • 编辑应用程序
    要编辑应用程序,请单击主菜单中的 应用程序 ,然后单击 垂直省略号按钮, > 编辑

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

    1. 在 IBM RPA Control Center上,单击 连接 菜单。
    2. 在连接上,单击 垂直省略号按钮, > 重新授权
  • 使应用程序过时
    要使应用程序过时,请单击主菜单中的 应用程序 ,然后单击 垂直省略号按钮,以 > 过时

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

  • 重新激活过时的应用程序
    要重新激活过时的应用程序,请在 应用程序 菜单中单击 垂直省略号按钮 > 重新激活

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

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