通过

教程：Microsoft Entra SSO 与 Atlassian Cloud 集成

  • 项目

本教程介绍如何将 Atlassian Cloud 与 Microsoft Entra ID 相集成。 将 Atlassian Cloud 与 Microsoft Entra ID 集成后，可以：

  • 在 Microsoft Entra ID 中控制谁有权访问 Atlassian Cloud。
  • 让用户能够使用其 Microsoft Entra 帐户自动登录到 Atlassian Cloud。
  • 在中心位置管理帐户。

先决条件

若要开始操作，需备齐以下项目：

  • 一个 Microsoft Entra 订阅。 如果你没有订阅，可以获取一个免费帐户。
  • 已启用 Atlassian Cloud 单一登录 (SSO) 的订阅。
  • 若要对 Atlassian Cloud 产品启用安全断言标记语言 (SAML) 单一登录，需要设置 Atlassian Access。 详细了解 Atlassian Access。

注意

此集成也可以通过 Microsoft Entra 美国政府云环境使用。 你可以在“Microsoft Entra 美国政府云应用程序库”中找到此应用程序，并以公有云相同的方式对其进行配置。

方案描述

在本教程中，你将在测试环境中配置并测试 Microsoft Entra SSO。

要配置 Atlassian Cloud 与 Microsoft Entra ID 的集成，需要从库中将 Atlassian Cloud 添加到托管 SaaS 应用列表。

  1. 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
  2. 浏览至“标识”>“应用程序”>“企业应用程序”>“新建应用程序”。
  3. 在“从库中添加”部分的搜索框中，键入“Atlassian Cloud” 。
  4. 从结果面板中选择“Atlassian Cloud”，然后添加该应用 。 在该应用添加到租户时等待几秒钟。

或者，也可以使用企业应用配置向导。 在此向导中，可以将应用程序添加到租户、将用户/组添加到应用、分配角色，以及逐步完成 SSO 配置。 可以在此处详细了解 Microsoft 365 向导。

配置并测试 Microsoft Entra SSO

使用名为 B.Simon 的测试用户配置并测试 Atlassian Cloud 的 Microsoft Entra SSO。 若要使 SSO 正常工作，需要在 Microsoft Entra 用户与 Atlassian Cloud 中的相关用户之间建立关联。

若要配置并测试 Atlassian Cloud 的 Microsoft Entra SSO，请执行以下步骤：

  1. 配置 Atlassian Cloud 的 Microsoft Entra ID SSO - 以使用户能够将基于 Microsoft Entra ID 的 SAML SSO 用于 Atlassian Cloud。
    1. 创建 Microsoft Entra 测试用户 - 使用 B.Simon 测试 Microsoft Entra 单一登录。
    2. 分配 Microsoft Entra 测试用户 - 使 B.Simon 能够使用 Microsoft Entra 单一登录。
  2. 创建 Atlassian Cloud 测试用户 - 在 Atlassian Cloud 中创建 B.Simon 的对应用户，并将其链接到该用户的 Microsoft Entra 表示形式。
  3. 测试 SSO - 验证配置是否正常工作。

使用 Atlassian Cloud SSO 配置 Microsoft Entra ID

按照以下步骤启用 Microsoft Entra SSO。

  1. 在另一个 Web 浏览器窗口中，以管理员身份登录到 Atlassian Cloud 公司站点

  2. 在 ATLASSIAN 管理员门户中，导航到“安全性”>“标识提供者”>“Microsoft Entra ID”。

  3. 输入目录名称并单击“添加”按钮。

  4. 选择“设置 SAML 单一登录”按钮，将标识提供者连接到 Atlassian 组织。

    屏幕截图显示标识提供者的安全性。

  5. 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。

  6. 浏览到 Identity>Applications Enterprise 应用程序>>Atlassian Cloud 应用程序集成页。 查找“ 管理 ”部分。 在“入门”下，选择“设置单一登录”。

  7. 在“选择单一登录方法”页上选择“SAML” 。

  8. 在 “使用 SAML 设置单一登录”页上，向下滚动到 “设置 Atlassian Cloud”。

    a. 单击“配置 URL”。

    b. 复制“登录 URL”值，将其粘贴至 Atlassian 的“标识提供者 SSO URL”文本框中。

    c. 从 Microsoft Azure 门户复制“Microsoft Entra 标识符”值，将其粘贴至 Atlassian 中的“标识提供者实体 ID”文本框中。

    屏幕截图显示配置值。

  9. 在“设置 SAML 单一登录”页的“SAML 签名证书”部分中，找到“证书(Base64)”，选择“下载”以下载该证书并将其保存到计算机上 。

    签名证书

    屏幕截图显示 Azure 中的证书。

  10. 在 Atlassian 中保存 SAML 配置并单击“下一步”。

  11. 在“基本 SAML 配置”部分中，按照以下步骤操作。

    a. 从 Atlassian 复制“服务提供商实体 URL”值，将其粘贴至 Azure 的“标识符(实体 ID)”框中，并将其设置为默认值。

    b. 从 Atlassian 复制“服务提供商断言使用者服务 URL”值，在 Azure 中将其粘贴至“回复 URL (断言使用者服务 URL)”框中，并将其设置为默认值。

    c. 单击“下一步” 。

    屏幕截图显示服务提供商图像。

    屏幕截图显示服务提供商值。

  12. Atlassian Cloud 应用程序需要特定格式的 SAML 断言，这需要向“SAML 令牌属性”配置添加自定义属性映射。 可单击“编辑”图标来编辑属性映射。

    attributes

    1. 针对具备 Microsoft 365 许可证的 Microsoft Entra 租户的属性映射。

      a. 单击“唯一用户标识符(名称 ID)”声明。

      属性和声明

      b. Atlassian Cloud 期望 nameidentifier（唯一用户标识符）映射到用户的电子邮件 (user.email) 。 编辑“源属性”，并将其更改为 user.mail 。 保存对声明所做的更改。

      唯一用户 ID

      c. 最终属性映射应如下所示。

      图像 2

    2. 针对不具备 Microsoft 365 许可证的 Microsoft Entra 租户的属性映射。

      a. 单击 http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress 声明。

      图像 3

      b. 尽管 Azure 不会为在 Microsoft Entra 租户中创建的没有 Microsoft 365 许可证的用户填充 user.mail 属性，但会将此类用户的电子邮件存储在 userprincipalname 属性中。 Atlassian Cloud 期望 nameidentifier（唯一用户标识符）映射到用户的电子邮件 (user.userprincipalname) 。 编辑“源属性”，并将其更改为 user.userprincipalname。 保存对声明所做的更改。

      设置电子邮箱

      c. 最终属性映射应如下所示。

      图 4

  13. 单击“停止并保存 SAML”按钮。

    屏幕截图显示保存配置的图像。

  14. 如需在身份验证策略中强制实施 SAML 单一登录，请执行以下步骤。

    a. 在“Atlassian 管理门户”中，选择“安全”选项卡，然后单击“身份验证策略”。

    b. 对于要强制实施的策略，请选择“编辑”。

    c. 在“设置”中，为托管用户启用“强制单一登录”，进行 SAML 重定向。

    d. 单击“更新” 。

    显示身份验证策略的屏幕截图。

    注意

    管理员可以测试 SAML 配置，只需先在单独的身份验证策略上为一部分用户启用强制 SSO，如果没有问题就可为所有用户启用该策略。

创建 Microsoft Entra 测试用户

在本部分，你将创建名为 B.Simon 的测试用户。

  1. 至少以用户管理员身份登录到 Microsoft Entra 管理中心。
  2. 浏览到“标识”>“用户”>“所有用户”。
  3. 选择屏幕顶部的“新建用户”>“创建新用户”。
  4. 在“用户”属性中执行以下步骤：
    1. 在“显示名称”字段中输入 B.Simon。
    2. 在“用户主体名称”字段中，输入 username@companydomain.extension。 例如 B.Simon@contoso.com。
    3. 选中“显示密码”复选框，然后记下“密码”框中显示的值。
    4. 选择“查看 + 创建”。
  5. 选择“创建”。

分配 Microsoft Entra 测试用户

在本部分中，通过授予 B.Simon 访问 Atlassian Cloud 的权限，允许其使用单一登录。

  1. 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
  2. 浏览至“标识”>“应用程序”>“企业应用程序”>“Atlassian Cloud”。
  3. 在应用的概述页面中，选择“用户和组”。
  4. 选择“添加用户/组”，然后在“添加分配”对话框中选择“用户和组” 。
    1. 在“用户和组”对话框中，从“用户”列表中选择“B.Simon”，然后单击屏幕底部的“选择”按钮。
    2. 如果你希望将某角色分配给用户，可以从“选择角色”下拉列表中选择该角色。 如果尚未为此应用设置任何角色，你将看到选择了“默认访问权限”角色。
    3. 在“添加分配”对话框中，单击“分配”按钮。

创建 Atlassian Cloud 测试用户

要使 Microsoft Entra 用户登录至 Atlassian Cloud，请执行以下操作，在 Atlassian Cloud 中手动预配用户帐户：

  1. 转至“产品”选项卡，选择“用户”，单击“邀请用户”。

    Atlassian Cloud“用户”链接

  2. 在“电子邮件地址”框中输入该用户的电子邮件地址，单击“邀请用户”。

    创建 Atlassian Cloud 用户

测试 SSO

在本部分，你将使用以下选项测试 Microsoft Entra 单一登录配置。

SP 启动的：

  • 单击“测试此应用程序”，这会重定向到 Atlassian Cloud 登录 URL，可以从那里启动登录流。

  • 直接转到 Atlassian Cloud 登录 URL，从此处启动登录流。

IDP 启动的：

  • 单击“测试此应用程序”后，你应当会自动登录到为其设置了 SSO 的 Atlassian Cloud。

还可以使用 Microsoft“我的应用”在任何模式下测试此应用程序。 单击“我的应用”中的 Atlassian Cloud 磁贴时，如果是在 SP 模式下配置的，系统会将你重定向到应用程序登录页面来启动登录流；如果是在 IDP 模式下配置的，你会自动登录到为其设置了 SSO 的 Atlassian Cloud。 有关“我的应用”的详细信息，请参阅“我的应用”简介。

后续步骤

配置 Atlassian Cloud 后，就可以强制实施会话控制，从而实时保护组织的敏感数据免于外泄和渗透。 会话控制从条件访问扩展而来。 了解如何通过 Microsoft Defender for Cloud Apps 强制实施会话控制。