部署连接器以存档 Twitter 数据

本文介绍部署连接器的过程,该连接器使用 Microsoft 365 导入服务将数据从组织的 Twitter 帐户导入到 Microsoft 365。 有关此过程的高级概述和部署 Twitter 连接器所需的先决条件列表,请参阅 设置连接器以存档 Twitter 数据

步骤 1:在 Microsoft Entra ID 中创建应用

  1. 转到 https://portal.azure.com 并使用全局管理员帐户的凭据登录。

    重要

    Microsoft 建议使用权限最少的角色。 最大程度地减少具有全局管理员角色的用户数,有助于提高组织的安全性。 详细了解 Microsoft Purview 角色和权限

    全局管理员凭据的Azure 门户登录页的屏幕截图。

  2. 在左侧导航栏中,选择“Microsoft Entra ID”。

    左侧导航窗格的屏幕截图,其中Azure 门户选择了Microsoft Entra ID。

  3. 在左侧导航栏中,选择“应用注册 (预览) ”,然后选择“新建注册”。

    “Microsoft Entra ID 应用注册”页的屏幕截图,其中显示了“新建注册”选项。

  4. 注册应用程序。 在 “重定向 URI (可选) ”下,在应用程序类型下拉列表中选择“ Web ”,然后在 https://portal.azure.com 框中键入 URI 的框中。

    应用注册设置的屏幕截图,其中显示了配置为Azure 门户的重定向 URI。

  5. 复制 应用程序 (客户端) ID目录 (租户) ID ,并将其保存到文本文件或其他安全位置。 在后续步骤中使用这些 ID。

    应用概述页的屏幕截图,其中显示了应用程序 (客户端) ID 和目录 (租户) ID。

  6. 转到 新应用的“证书 & 机密 ”,在“ 客户端机密”下,选择“ 新建客户端密码”。

    “证书 & 机密”页的屏幕截图,其中包含用于创建新客户端密码的选项。

  7. 创建新机密。 在说明框中,键入机密,然后选择过期期限。

    客户端机密窗体的屏幕截图,其中包含说明字段和过期期限选项。

  8. 复制机密的值并将其保存到文本文件或其他存储位置。 这是在后续步骤中使用的Microsoft Entra应用程序机密。

    显示用于复制和保存的客户端密码值的屏幕截图。

步骤 2:将连接器 Web 服务从 GitHub 部署到Azure帐户

  1. 转到此 GitHub 站点,然后选择“部署到Azure”。

    GitHub 存储库页的屏幕截图,其中突出显示了“部署到Azure”按钮。

  2. 选择“部署到Azure”后,会重定向到包含自定义模板页的Azure 门户。 填写 “基本信息 ”和 “设置” 详细信息,然后选择“ 购买”。

    Azure 门户自定义模板页的屏幕截图,其中包含连接器部署的“基本信息”和“设置”字段。

    • 订阅:选择要将 Twitter 连接器 Web 服务部署到的Azure订阅。
    • 资源组: 选择或创建新资源组。 资源组是一个容器,用于保存Azure解决方案的相关资源。
    • 位置: 选择一个位置。
    • Web 应用名称: 为连接器 Web 应用提供唯一名称。 名称的长度必须介于 3 到 18 个字符之间。 此名称用于创建Azure应用服务 URL;例如,如果提供 twitterconnector 的 Web 应用名称,则 twitterconnector.azurewebsites.net Azure应用服务 URL。
    • tenantId:在步骤 1 中创建 Twitter 连接器应用后复制的 Microsoft 365 组织的租户 ID Microsoft Entra ID。
    • APISecretKey: 可以键入任何值作为机密。 此值用于访问步骤 5 中的连接器 Web 应用。
  3. 部署成功后,页面类似于以下屏幕截图:

    显示成功部署连接器 Web 服务Azure 门户的屏幕截图。

步骤 3:创建 Twitter 应用

  1. 转到 https://developer.twitter.com,使用组织的开发人员帐户的凭据登录,然后选择“ 应用”。

    Twitter 开发人员门户主页的屏幕截图,其中包含“应用”选项。

  2. 选择“ 创建应用”。

    Twitter 开发人员门户“应用”页的屏幕截图,其中包含创建新应用的选项。

  3. “应用详细信息”下,输入有关应用程序的信息。

    用于输入应用程序信息的 Twitter 应用详细信息表单的屏幕截图。

  4. 在 Twitter 开发人员仪表板,选择刚刚创建的应用,然后选择“详细信息”。

    Twitter 开发人员仪表板的屏幕截图,其中显示了应用详细信息和应用 ID。

  5. 在“ 密钥和令牌 ”选项卡上的“ 使用者 API 密钥”下,复制 API 密钥和 API 密钥,并将其保存到文本文件或其他存储位置。 然后选择“ 创建 ”以生成访问令牌和访问令牌机密,并将其复制到文本文件或其他存储位置。

    Twitter 开发人员应用密钥和令牌页的屏幕截图,其中显示了 API 密钥。

    选择“ 创建 ”以生成访问令牌和访问令牌机密,并将其复制到文本文件或其他存储位置。

  6. 选择“ 权限 ”选项卡并配置权限,如以下屏幕截图所示:

    “Twitter 应用权限”选项卡的屏幕截图,其中配置了所需权限。

  7. 保存权限设置后,选择“ 应用详细信息 ”选项卡,然后选择 “编辑 > 编辑详细信息”。

    Twitter 应用详细信息页面的屏幕截图,其中选择了“编辑详细信息”选项。

  8. 完成以下任务:

    • 选中复选框以允许连接器应用登录到 Twitter。
    • 使用以下格式添加 OAuth 重定向 URI:<connectorserviceuri>/Views/TwitterOAuth,其中 connectorserviceuri 的值是组织的Azure应用服务 URL。

    Twitter 应用设置的屏幕截图,其中显示了已启用登录权限并配置了 OAuth 重定向 URI。

Twitter 开发人员应用现已可供使用。

步骤 4:配置连接器 Web 应用

  1. 转到 https://<AzureAppResourceName>.azurewebsites.net (,其中 AzureAppResourceName 是在步骤 2) 中指定的Azure应用资源的名称。 应用的主页如以下屏幕截图所示:

    Azure托管连接器 Web 应用主页的屏幕截图。

  2. 选择“ 配置 ”以显示登录页。

    从“配置”选项打开的连接器 Web 应用登录页的屏幕截图。

  3. 在“租户 ID”框中,从Microsoft Entra应用注册) 键入或粘贴 (目录 (租户) ID Microsoft Entra租户 ID。 在密码框中,键入或粘贴Azure部署模板设置中的 APISecretKey 值,然后选择“设置配置设置”以显示配置详细信息页。

    包含“租户 ID”和“API 密钥”字段的登录页的屏幕截图。

  4. 输入以下配置设置:

    • Twitter Api 密钥: 在步骤 3 中创建的 Twitter 应用程序的 API 密钥。
    • Twitter Api 密钥: 在步骤 3 中创建的 Twitter 应用程序的 API 密钥。
    • Twitter 访问令牌: 在步骤 3 中创建的访问令牌。
    • Twitter 访问令牌机密: 在步骤 3 中创建的访问令牌机密。
    • Microsoft Entra应用程序 ID:在步骤 1 中创建的 Microsoft Entra 应用的应用程序 ID
    • Microsoft Entra应用程序机密:在 Microsoft Entra ID 中的应用注册期间创建的Microsoft Entra应用程序客户端密码的值。
  5. 选择“ 保存” 以保存连接器设置。

步骤 5:设置 Twitter 连接器

  1. 登录到 Microsoft Purview 门户

  2. 选择 “设置”>“数据连接器”。

  3. 选择 “我的连接器”,然后选择“ 添加连接器”。

  4. 从列表中选择“ Twitter”。

  5. “服务条款 ”页上,选择“ 接受”。

  6. “为连接器应用添加凭据 ”页上,输入以下信息,然后选择“ 验证连接”。

    • 在“ 名称 ”框中,键入连接器的名称,例如 Twitter 帮助句柄
    • 在“连接器 URL”框中,键入或粘贴Azure应用服务 URL。
    • 在“密码”框中,键入或粘贴Azure部署模板设置中的 APISecretKey 值。
    • 在“Azure 应用 ID”框中,键入或粘贴Azure 应用程序应用 ID 的值, (也称为在步骤 1 中获取的客户端 ID) 。
  7. 成功验证连接后,选择“ 下一步”。

  8. “授权 Microsoft 365 导入数据 ”页上,再次键入或粘贴 APISecretKey,然后选择“ 登录 Web 应用”。

  9. 选择 “使用 Twitter 登录”。

  10. 在 Twitter 登录页上,使用组织的 Twitter 帐户凭据登录。 登录后,Twitter 页面会显示以下消息“Twitter 连接器作业已成功设置”。

  11. 选择“ 继续 ”以完成 Twitter 连接器的设置。

  12. “设置筛选器 ”页上,可以应用筛选器来最初导入具有特定期限的项目。 选择一个年龄,然后选择“ 下一步”。

  13. “选择存储位置 ”页上,键入 Twitter 项目导入到的 Microsoft 365 邮箱的电子邮件地址,然后选择“ 下一步”。

  14. 选择“ 下一步 ”查看连接器设置,然后选择“ 完成 ”以完成连接器设置。