Documentation

21. 设置社交身份认证

身份验证方法可简化最终用户的登录过程,使用现有登录信息提供单点登录以登录到第三方网站,而不是为该网站专门创建新登录帐户。

帐户身份验证可以在 automation controller 用户界面中配置并保存到 PostgreSQL 数据库。如需了解具体步骤,请参阅 Controller 配置 部分。

automation controller 中的帐户身份验证可以被配置为集中使用 OAuth2,企业级帐户身份验证可以配置 SAML、RADIUS 或 LDAP 作为身份验证信息来源。请参阅 设置企业级身份验证

对于提供帐户信息的网站,如 Microsoft Azure、Google 或 GitHub,则通常使用 OAuth 标准来实施帐户信息。OAuth 是一个安全授权协议,通常与帐户身份验证一同使用,以授予第 3 个方应用“会话令牌”,允许它们代表用户向提供程序发出 API 调用。

SAML(Security Assertion Markup Language)是一个基于 XML 的、开放式的数据格式,用于在身份提供程序和服务提供程序之间交换帐户身份验证和授权数据。

使用 RADIUS 分布式客户端/服务器系统,您可以保护网络不受未授权访问的影响,并可在为远程用户维护网络访问时需要高安全性的网络环境中实施。

21.1. GitHub 设置

要设置 GitHub 的社交身份验证,您需要获取 web 应用的 OAuth2 密钥和 secret。 要做到这一点,必须首先将新应用程序注册到 GitHub: https://github.com/settings/developers.。要注册应用程序,您必须为其提供一个主页 URL,这是 GitHub 默认设置页的 Details 选项卡中的 Callback URL。 OAuth2 key(Client ID)和 secret(Client Secret)将用于提供 automation controller 用户界面中所需的字段。

  1. 点左侧导航栏中的 Settings

  2. 在 Settings 窗口左侧,点 Authentication 选项列表中的 GitHub settings

  3. 如果还没有选择,点 GitHub Default 标签页。

GitHub OAuth2 Callback URL 字段已预先填充且不可编辑。在应用程序被注册后,GitHub 会显示客户端 ID 和客户端 Secret。

  1. Edit,将 GitHub 的客户端 ID 复制到 GitHub OAuth2 Key 字段中。

  2. 将 GitHub 的客户端 Secret 复制到 GitHub OAuth2 Secret 字段中。

  3. 如需完成映射字段的详情,请参阅 机构和团队映射

  4. 完成后请点击 Save

  5. 要验证是否已正确配置了身份验证,请注销 automation controller,登录屏幕现在将会显示 GitHub 徽标,以允许使用这些凭证登录。

_images/configure-tower-auth-github-logo.png

21.1.1. GitHub 机构设置

当使用机构或者机构中团队定义帐户身份验证时,您应该使用特定的机构和团队设置。帐户身份验证可以受机构以及机构中团队的限制。

您还可以通过指定基于非机构或非团队的设置(如上所示)来选择允许所有设置。

您可以限制只有某个机构或者机构中的某个团队的用户才可以登陆到控制器。

要为 GitHub 机构设置社交身份验证,您需要获取 web 应用的 OAuth2 密钥和 secret。为此,您必须首先在 https://github.com/organizations/<yourorg>/settings/applications 中注册您的机构拥有的应用。为了注册应用,您必须为其提供授权回调 URL,这是 Details 页中显示的 Callback URL。每个密钥和 secret 都必须属于一个唯一的应用,且不能在不同的后端间共享或重用。OAuth2(客户端 ID)和 secret(客户端 Secret)将用于提供 automation controller 用户界面中所需的字段。

  1. 点左侧导航栏中的 Settings

  2. 在 Settings 窗口左侧,点 Authentication 选项列表中的 GitHub settings

  3. GitHub Organization 标签页。

GitHub Organization OAuth2 Callback URL 字段已预先填充且不可编辑。

注册应用程序后,GitHub 会显示客户端 ID 和客户端 Secret。

  1. Edit,将 GitHub 的客户端 ID 复制到 GitHub Organization OAuth2 Key 字段中。

  2. 将 GitHub 的客户端 Secret 复制并粘贴到 GitHub Organization OAuth2 Secret 字段中。

  3. 输入您的 GitHub 机构名称,如 GitHub Organization Name 项中使用的您的组织 URL (如 https://github.com/<yourorg>/)。

  4. 如需完成映射字段的详情,请参阅 机构和团队映射

  5. 完成后请点击 Save

  6. 要验证是否已正确配置了身份验证,请先退出 automation controller。登录屏幕现在将会显示 GitHub 机构徽标来允许使用这些凭证登陆。

_images/configure-tower-auth-github-orgs-logo.png

21.1.2. GitHub 团队设置

要为 GitHub 团队设置社交身份验证,您需要获取 web 应用的 OAuth2 密钥和 secret。为此,您必须首先在 https://github.com/organizations/<yourorg>/settings/applications 中注册您的团队拥有的应用。为了注册应用,您必须为其提供授权回调 URL,这是 Details 页中显示的 Callback URL。每个密钥和 secret 都必须属于一个唯一的应用,且不能在不同的后端间共享或重用。OAuth2(客户端 ID)和 secret(客户端 Secret)将用于提供 automation controller 用户界面中所需的字段。

  1. 使用 GitHub API 查找团队 ID:http://fabian-kostadinov.github.io/2015/01/16/how-to-find-a-github-team-id/.。团队 ID 将用于提供 automation controller 用户界面中所需的字段。

  2. 点左侧导航栏中的 Settings

  3. 在 Settings 窗口左侧,点 Authentication 选项列表中的 GitHub settings

  4. GitHub Team 标签页。

GitHub Team OAuth2 Callback URL 字段已预先填充且不可编辑。在应用程序被注册后,GitHub 会显示客户端 ID 和客户端 Secret。

  1. Edit,将 GitHub 的客户端 ID 复制到 GitHub Team OAuth2 Key 字段中。

  2. 将 GitHub 的客户端 Secret 复制并粘贴到 GitHub Team OAuth2 Secret 字段中。

  3. GitHub Team ID 字段中复制并粘贴 GitHub 团队 ID。

  4. 如需完成映射字段的详情,请参阅 机构和团队映射

  5. 完成后请点击 Save

  6. 要验证是否已正确配置了身份验证,请注销 automation controller,登录屏幕现在将会显示 GitHub 团队徽标,以允许使用这些凭证登录。

_images/configure-tower-auth-github-teams-logo.png

21.1.3. GitHub Enterprise 设置

要为 GitHub Enterprise 设置社交身份验证,您需要获取 web 应用的 GitHub Enterprise URL、API URL、OAuth2 密钥和 secret。 要获得 URL,请参阅 GitHub Enterprise administration 中的 GitHub 文档。 要获取密钥和 secret,您必须首先在 https://github.com/organizations/<yourorg>/settings/applications 上注册您的企业拥有的应用程序。 要注册应用程序,需要为其提供授权回调 URL,即 Details 页面中显示的 Callback URL。 因为它托管在站点而不是 github.com 上,所以您必须指定它要与之通信的 auth 适配器。

每个密钥和 secret 必须属于一个唯一的应用,且不能在不同的身份验证后端之间共享或重复使用。OAuth2 密钥(客户端 ID)和 secret(客户端 Secret)将用于提供 automation controller 用户界面中所需的字段。

  1. 点左侧导航栏中的 Settings

  2. 在 Settings 窗口左侧,点 Authentication 选项列表中的 GitHub settings

  3. GitHub Enterprise 标签页。

GitHub Enterprise OAuth2 Callback URL 字段已预先填充且不可编辑。在应用程序被注册后,GitHub 会显示客户端 ID 和客户端 Secret。

  1. Edit 配置 GitHub Enterprise 设置。

  2. GitHub Enterprise URL 字段中,输入 GitHub Enterprise 实例的主机名(例如 https://github.example.com)。

  3. GitHub Enterprise API URL 字段中,输入 GitHub Enterprise 实例的 API URL(例如 https://github.example.com/api/v3

  4. 将 GitHub 的客户端 ID 复制并粘贴到 GitHub Enterprise OAuth2 Key 字段中。

  5. 将 GitHub 的客户端 Secret 复制并粘贴到 GitHub Enterprise OAuth2 Secret 字段中。

  6. 如需完成映射字段的详情,请参阅 机构和团队映射

  7. 完成后请点击 Save

  8. 要验证是否已正确配置了身份验证,请注销 automation controller,登录屏幕现在将会显示 GitHub Enterprise 徽标,以允许使用这些凭证登录。

_images/configure-tower-auth-github-ent-logo.png

21.1.4. GitHub Enterprise 组织设置

要为 GitHub Enterprise Org 设置社交身份验证,您需要获取 web 应用的 GitHub Enterprise Org URL、Org API URL、Org OAuth2 密钥和 secret。 要获得 URL,请参阅 GitHub Enterprise administration 中的 GitHub 文档。 要获取密钥和 secret,您必须首先在 https://github.com/organizations/<yourorg>/settings/applications 上注册您的企业拥有的应用程序。 要注册应用程序,需要为其提供授权回调 URL,即 Details 页面中显示的 Callback URL。 因为它托管在站点而不是 github.com 上,所以您必须指定它要与之通信的 auth 适配器。

每个密钥和 secret 必须属于一个唯一的应用,且不能在不同的身份验证后端之间共享或重复使用。OAuth2 密钥(客户端 ID)和 secret(客户端 Secret)将用于提供 automation controller 用户界面中所需的字段。

  1. 点左侧导航栏中的 Settings

  2. 在 Settings 窗口左侧,点 Authentication 选项列表中的 GitHub settings

  3. GitHub Enterprise Organization 标签页。

GitHub Enterprise Organization OAuth2 Callback URL 字段已预先填充且不可编辑。在应用程序被注册后,GitHub 会显示客户端 ID 和客户端 Secret。

  1. Edit 配置 GitHub Enterprise Organization 设置。

  2. GitHub Enterprise Organization URL 字段中,输入 GitHub Enterprise Org 实例的主机名(例如 https://github.orgexample.com)。

  3. GitHub Enterprise Organization API URL 字段中,输入 GitHub Enterprise Org 实例的 API URL(例如 https://github.orgexample.com/api/v3

  4. 将 GitHub 的客户端 ID 复制并粘贴到 GitHub Enterprise Organization OAuth2 Key 字段中。

  5. 将 GitHub 的客户端 Secret 复制并粘贴到 GitHub Enterprise Organization OAuth2 Secret 字段中。

  6. 输入您的 GitHub 机构名称,如 GitHub Enterprise Organization Name 项中使用的您的组织 URL (如 https://github.com/<yourorg>/)。

  7. 如需完成映射字段的详情,请参阅 机构和团队映射

  8. 完成后请点击 Save

  9. 要验证是否已正确配置了身份验证,请先退出 automation controller。登录屏幕现在将会显示 GitHub Enterprise Organization 徽标来允许使用这些凭证登陆。

_images/configure-tower-auth-github-ent-org-logo.png

21.1.5. GitHub Enterprise Team 设置

要为 GitHub Enterprise Org 团队设置社交身份验证,您需要获取 web 应用的 GitHub Enterprise Org URL、Org API URL、Org OAuth2 密钥和 secret。 要获得 URL,请参阅 GitHub Enterprise administration 中的 GitHub 文档。 要获取密钥和 secret,您必须首先在 https://github.com/organizations/<yourorg>/settings/applications 上注册您的团队拥有的应用程序。 要注册应用程序,需要为其提供授权回调 URL,即 Details 页面中显示的 Callback URL。 因为它托管在站点而不是 github.com 上,所以您必须指定它要与之通信的 auth 适配器。

每个密钥和 secret 必须属于一个唯一的应用,且不能在不同的身份验证后端之间共享或重复使用。OAuth2 密钥(客户端 ID)和 secret(客户端 Secret)将用于提供 automation controller 用户界面中所需的字段。

  1. 使用 GitHub API 查找团队 ID:http://fabian-kostadinov.github.io/2015/01/16/how-to-find-a-github-team-id/.。团队 ID 将用于提供 automation controller 用户界面中所需的字段。

  2. 点左侧导航栏中的 Settings

  3. 在 Settings 窗口左侧,点 Authentication 选项列表中的 GitHub settings

  4. GitHub Enterprise Team 标签页。

GitHub Enterprise Team OAuth2 Callback URL 字段已预先填充且不可编辑。在应用程序被注册后,GitHub 会显示客户端 ID 和客户端 Secret。

  1. Edit 配置 GitHub Enterprise Team 设置。

  2. GitHub Enterprise Team URL 字段中,输入 GitHub Enterprise 团队实例的主机名(例如 https://github.teamexample.com)。

  3. GitHub Enterprise Team API URL 字段中,输入 GitHub Enterprise 团队实例的 API URL(例如 https://github.teamexample.com/api/v3

  4. 将 GitHub 的客户端 ID 复制并粘贴到 GitHub Enterprise Team OAuth2 Key 字段中。

  5. 将 GitHub 的客户端 Secret 复制并粘贴到 GitHub Enterprise Team OAuth2 Secret 字段中。

  6. GitHub Enterprise Team ID 字段中复制并粘贴 GitHub 的团队 ID。

  7. 如需完成映射字段的详情,请参阅 机构和团队映射

  8. 完成后请点击 Save

  9. 要验证是否已正确配置了身份验证,请注销 automation controller,登录屏幕现在将会显示 GitHub Enterprise Team 徽标,以允许使用这些凭证登录。

_images/configure-tower-auth-github-ent-teams-logo.png

21.2. Google OAuth2 设置

要设置 Google 的身份验证,您需要获取 web 应用程序的 OAuth2 密钥和 secret。为此,您必须首先创建一个项目并使用 Google 进行设置。如需相关说明,请参阅 https://support.google.com/googleapi/answer/6158849。如果您已经完成了设置过程,您可以进入 Google API Manager Console 的 Credentials 部分来访问这些凭证。OAuth2 密钥(客户端 ID)和 secret(客户端 secret)将用于提供 automation controller 用户界面中所需的字段。

  1. 点左侧导航栏中的 Settings

  2. 在 Settings 窗口左侧,点 Authentication 选项列表中的 Google OAuth 2 settings

Google OAuth2 Callback URL 字段已预先填充且不可编辑。

  1. 以下字段也会预先填充。如果没有,请使用 web 应用设置过程中提供的 Google 凭证,并寻找与以下示例中所示相同格式的值:

  • Edit,将 Google 的客户端 ID 复制到 Google OAuth2 Key 字段中。

  • 将 Google 的客户端 secret 复制并粘贴到 Google OAuth2 Secret 字段中。

    _images/configure-tower-auth-google.png
  1. 要完成剩余的可选字段,请参考每个字段中的工具提示,以获得说明和所需格式。

  2. 如需完成映射字段的详情,请参阅 机构和团队映射

  3. 完成后请点击 Save

  4. 要验证是否已正确配置了身份验证,请注销 automation controller,登录屏幕现在将会显示 Google 徽标,以指定它作为登录 automation controller 的替代方法。

_images/configure-tower-auth-google-logo.png

21.3. 机构和团队映射

21.3.1. 机构映射

您将需要根据用户名和电子邮件地址控制哪些用户放置到哪个控制器机构(从社交或企业身份验证帐户映射您的机构管理员/用户)。

字典键是机构名称。如果不存在机构以及许可证允许多个机构,则将创建机构。否则,无论键是什么均使用单一默认机构。

值是字典,用于定义每个机构成员资格的选项。对于每个机构来说,可以指定哪个用户自动成为机构的用户,以及哪个用户可以管理机构。

admins:None、True/False、字符串或字符串的列表/元组。

  • 如果为 None,机构管理员将不会更新。

  • 如果为 True,使用帐户身份验证的所有用户将自动添加为机构管理员。

  • 如果为 False,则没有帐户身份验证用户自动添加为机构的管理员。

  • 如果为字符串或字符串列表,指定要添加到机构中的用户的用户名和电子邮件。以 / 开头和结尾的字符串将编译成正则表达式;修饰符 i (区分大小写)和 m``(多行)可在结束 ``/ 后指定。

remove_admins:True/False。默认为 True

  • 当为 True 时,不匹配的用户将从机构的管理列表中删除。

users:None、True/False、字符串或字符串列表/元组。应用的规则与 admins 相同。

remove_users:True/False。默认为 True。应用的规则与 remove_admins 相同。

{
    "Default": {
        "users": true
    },
    "Test Org": {
        "admins": ["[email protected]"],
        "users": true
    },
    "Test Org 2": {
        "admins": ["[email protected]", "/^controller-[^@]+?@.*$/i"],
        "users": "/^[^@].*?@example\\.com$/"
    }
}

可以为每个帐户身份验证后端单独指定机构映射。如果已定义,这些配置将优先于上述全局配置。

SOCIAL_AUTH_GOOGLE_OAUTH2_ORGANIZATION_MAP = {}
SOCIAL_AUTH_GITHUB_ORGANIZATION_MAP = {}
SOCIAL_AUTH_GITHUB_ORG_ORGANIZATION_MAP = {}
SOCIAL_AUTH_GITHUB_TEAM_ORGANIZATION_MAP = {}
SOCIAL_AUTH_SAML_ORGANIZATION_MAP = {}

21.3.2. 团队映射

团队映射是从社交身份验证帐户的团队成员(用户)的映射。键是团队名称(如果不存在就会创建)。值是每个团队成员资格选项的字典,其中每项可以包含以下参数:

organization:字符串。团队所属机构的名称。如果机构和团队名称的组合不存在,则会创建团队。如果该机构不存在,则会首先创建机构。如果许可证不允许多个机构,团队将始终被分配给单一的默认机构。

users:None、True/False、字符串或字符串列表/元组。

  • 如果为 None,则不会更新团队成员。

  • 如果为 True/False,则所有社交身份验证用户将作为团队成员添加/删除。

  • 如果为字符串或字符串列表,指定用于匹配用户的表达式。如果用户名或电子邮件匹配,用户将被添加为团队成员。以 / 开头和结尾的字符串将编译成正则表达式;修饰符 i``(区分大小)和 ``m``(多行)可以在 ``/ 结束后指定。

remove:True/False。默认为 True。当 True 时,与规则不匹配的用户将从团队中删除。

{
    "My Team": {
        "organization": "Test Org",
        "users": ["/^[^@]+?@test\\.example\\.com$/"],
        "remove": true
    },
    "Other Team": {
        "organization": "Test Org 2",
        "users": ["/^[^@]+?@test\\.example\\.com$/"],
        "remove": false
    }
}

可以根据您的设置,为每个帐户身份验证后端单独指定团队映射。定义后,这些配置优先于上面的全局配置。

SOCIAL_AUTH_GOOGLE_OAUTH2_TEAM_MAP = {}
SOCIAL_AUTH_GITHUB_TEAM_MAP = {}
SOCIAL_AUTH_GITHUB_ORG_TEAM_MAP = {}
SOCIAL_AUTH_GITHUB_TEAM_TEAM_MAP = {}
SOCIAL_AUTH_SAML_TEAM_MAP = {}

取消注释以下行(即将 SOCIAL_AUTH_USER_FIELDS 设置为空列表),以防止创建新用户帐户。只有之前已经使用社交或企业级身份验证登录或用户帐户有匹配电子邮件地址的用户才能登录控制器。

SOCIAL_AUTH_USER_FIELDS = []