在开发者门户上使用联合凭据

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息

联合登录是指您使用一个身份管理系统（称为“记录系统”）中的凭据登录另一个系统的过程。例如，您使用 Google 或 Twitter 凭据登录 Apigee 开发者门户。联合登录的优势在于，您要登录的系统永远不会看到与您的凭据关联的密码。这意味着，您无需将密码复制到不同的系统。

开发者服务门户支持使用多种常见提供商的凭据进行联合登录，包括：

  • GitHub
  • Google
  • OpenID
  • Twitter

此外，如果您已经有 Apigee Edge 账号，则可以使用这些凭据登录开发者门户。

每种受支持的凭据提供程序都需要不同的配置流程，如下所述。

在开发者门户中使用联合凭据

如需访问该门户，开发者需要在门户上注册新账号，并指定用户名、电子邮件地址和密码。然后，用户可以通过提供其门户用户名和密码作为凭据来登录门户。

在门户上使用联合登录功能时，您可以使用第三方凭据登录现有门户账号。也就是说，您需要先在该门户上拥有账号，然后才能使用第三方凭据登录。您可以使用 Apigee 支持的任何联合凭据登录现有门户账号。此外，您还可以使用 Google 和 Apigee 凭据在门户上注册新账号。

登录现有门户账号

使用任何受支持的联合凭据登录现有门户账号。例如，使用您的 Twitter 凭据登录。首次使用 Twitter 凭据登录时，该门户会提示您将 Twitter 凭据与现有门户账号相关联。您只需执行一次此关联。完成后，您可以使用 Twitter 凭据登录，而该门户会保留关联信息。

注册新的门户账号

使用您的 Google 或 Apigee 凭据在门户上注册新账号。当您使用联合身份凭据在门户上注册为新开发者时，开发者门户会尝试从记录系统获取信息（通常是电子邮件地址）。例如，您使用 Google 凭据在该门户上创建新的开发者账号。系统会提示您批准从 Google 传回到门户的信息。即使记录系统会将信息返回到门户，新注册者通常也需要输入一些信息，例如接受条款及条件。

使用 Apigee 凭据注册或登录

如果您已有 Apigee Edge 账号，则可以使用这些凭据在开发者门户上注册账号或登录现有账号。默认情况下，开发者门户的注册页面和登录页面上都会显示以下按钮：

该按钮仅显示在网址以 apigee.com 结尾的门户上，也就是说，Apigee 网域中的门户。例如，网址的格式为 http://myCompany.devportal.apigee.com。如果网址未以该网域结尾，您将无法使用 Apigee Edge 凭据在该门户上登录或注册。

如需将现有 Apigee Edge 用户注册为新的门户开发者，请执行以下操作：

注意：注册流程假定您已将门户配置为允许任何人无需管理员批准即可注册。如需详细了解如何控制哪些人可以注册，请参阅添加和管理用户账号。

  1. 确保您已有 Apigee Edge 账号。
  2. 选择开发者门户上的“注册”链接。
  3. 在注册页面上，选择“使用 Apigee 进行身份验证”按钮。
    • 如果您尚未登录 Apigee Edge，请输入您的 Apigee Edge 凭据，然后选择“登录”。
  4. 如果注册时不需要提供其他信息，您将会使用新账号登录开发者门户。
    系统会向与您的 Apigee 账号关联的电子邮件地址发送一封电子邮件，其中包含有关完成注册流程的信息，例如设置密码。
  5. 如果您需要提供其他信息才能完成注册流程（例如接受条款及条件），系统会自动将您重定向回“注册”页面，并在相应字段中输入您 Apigee Edge 账号的用户名和电子邮件信息。
  6. 指定任何其他必要的注册信息以完成注册流程。
  7. 选择“创建新账号”。
    系统会向与您的 Apigee 账号关联的电子邮件地址发送一封电子邮件，其中包含有关完成注册流程的信息，例如设置密码。

如需使用 Apigee 账号以现有门户开发者的身份登录，请执行以下操作：

  1. 选择开发者门户上的“登录”链接。
  2. 在登录页面上，选择“使用 Apigee 进行身份验证”按钮。
    • 如果您已登录 Apigee Edge，则会自动登录开发者门户。
    • 如果您尚未登录 Apigee Edge，请输入您的 Apigee Edge 凭据，然后选择“登录”。

使用 Google 凭据注册或登录

默认情况下，开发者门户上启用了使用 Google 凭据进行联合注册和登录的功能。在注册页面和登录页面上，您会看到以下按钮：

您可以使用 Google 凭据注册为新开发者，也可以登录为现有开发者。例如，如果您有 Gmail 账号，则可以使用 Gmail 凭据登录。

开发者门户会在您的门户个人资料中存储 Google OpenID，以便将 Google 凭据与您的门户账号相关联。将 Google 凭据与您的门户账号相关联后，您可以通过以下步骤查看 OpenID：在开发者门户的顶级菜单中依次选择您的电子邮件地址 >“修改个人资料”，然后选择“管理您的 OpenID”。

如需使用 Google 凭据注册为新开发者，请执行以下操作：

注意：注册流程假定您已将门户配置为允许任何人无需管理员批准即可注册。如需详细了解如何控制哪些人可以注册，请参阅添加和管理用户账号。

  1. 确保您拥有现有的 Google 账号，例如 Gmail 账号。
  2. 选择开发者门户上的“Register”（注册）链接
  3. 在注册页面上，选择“使用 Google 账号进行身份验证”按钮。
    系统会将您定向至一个 Google 页面，要求您同意开发者门户可以访问您的 Google 电子邮件地址和基本信息。
  4. 选择“接受”即可批准。
  5. 系统会将您重定向回开发者门户的注册页面，并在注册字段中预先填充 Google 提供的信息。
  6. 请指定缺少的任何必要信息，以便完成注册流程。
  7. 选择“创建新账号”。
    系统会向您的 Gmail 账号发送一封电子邮件，其中包含有关完成注册流程的信息。

如需以现有开发者身份登录，请执行以下操作：

  1. 选择开发者门户上的“登录”链接。
  2. 在登录页面上，选择“使用 Google 账号进行身份验证”按钮。
    • 如果您已登录 Google，则会直接登录该门户。
    • 如果您尚未登录 Google，请输入您的 Google 凭据以登录该门户。
  3. 如果这是您首次使用 Google 凭据登录，系统会将您重定向到门户上的某个页面，您必须在该页面上将您的 Google 账号与开发者门户上的现有账号相关联：

  4. 复制“您的 OpenID”下方的网址。
  5. 选择页面顶部的登录链接，然后使用您现有的开发者门户凭据登录。
  6. 在开发者门户的顶级菜单中，依次选择您的电子邮件地址 > 修改个人资料。
  7. 在您的个人资料页面上，选择“管理您的 OpenID”。
  8. 输入 OpenID 网址，然后选择“添加 OpenID”。
    您现在可以使用 Google 凭据登录了。

使用 Twitter 凭据登录

您可以使用 Twitter 凭据登录现有开发者账号，但无法注册为新用户。

如需使用 Twitter 凭据进行联合登录，您需要在开发者门户上启用 Drupal Twitter Signin 模块。启用该模块后，您会在登录页面上看到以下按钮：

开发者门户与 Twitter 之间的连接使用 OAuth 进行身份验证。 因此，您必须先创建一个 Twitter 应用，然后该应用才能生成开发者门户和 Twitter 用于通信的使用方密钥和使用方密码，然后您才能使用 Twitter 凭据登录开发者门户。

在下文中，您需要先在开发者门户上启用 Twitter 登录模块，然后创建 Twitter 应用。创建应用后，返回 Twitter 登录模块，然后从 Twitter 应用中添加所需的配置信息。

如需启用 Twitter 登录模块，请执行以下操作：

  1. 以具有管理员权限的用户身份登录门户。
  2. 在 Drupal 管理菜单中，选择“模块”。系统随即会显示所有已安装的 Drupal 模块的列表。
  3. 向下滚动页面，然后选中“Twitter 登录”模块旁边的复选框。
  4. 保存配置。
    启用 Twitter 登录模块时，您可能会收到通知，告知您还必须启用其他模块。请务必启用这些模块。
  5. 启用 Twitter 登录模块后，在 Drupal 菜单中依次选择“配置”>“Web 服务”>“Twitter”。
    系统随即会显示 Twitter 配置屏幕。
  6. 选择“设置”标签。
  7. 复制回调网址。此网址的格式为：

    http://{env}-{org-name}.devportal.apigee.com/twitter/oauth

    您需要此网址才能创建 Twitter 应用。

创建 Twitter 应用：

  1. 在浏览器中前往此页面：https://dev.twitter.com/apps/new，然后登录您的 Twitter 账号。
  2. 输入门户的以下信息：
    名称：例如 MyApigeePortal
    说明：例如 My Apigee Portal
    网站：例如 http://{env}-{org-name}.devportal.apigee.com/
    Callback网址：从“Twitter 登录”模块配置界面复制回调网址。
  3. 同意条款/条件。
    您将被定向至包含 OAuth 设置（包括使用方密钥和使用方密码）的 Twitter 页面。您需要使用密钥和密文来配置 Drupal Twitter 登录模块。
  4. 在“设置”标签页下，将“应用类型访问权限”更改为“读取和写入”。
  5. 选择“更新此 Twitter 应用的设置”。

如需配置 Twitter 登录模块，请执行以下操作：

  1. 以具有管理员权限的用户身份登录门户。
  2. 在 Drupal 菜单中，依次选择“配置”>“Web 服务”>“Twitter”。
    系统随即会显示 Twitter 配置屏幕。
  3. 选择“设置”标签。
  4. 将 Twitter 页面中的使用方密钥复制到“OAUTH 使用方密钥”字段。
  5. 将 Twitter 页面中的使用方 Secret 复制到 OAUTH 使用方 Secret 字段。
  6. 选择“保存配置”。
  7. 选择“Twitter”标签页。
  8. 在仍使用创建 Twitter 应用的账号登录 Twitter 的情况下，选择“前往 Twitter”按钮以添加经过身份验证的账号。
  9. 选择“登录”标签页。
  10. 在“自动注册新用户”下方，选择“否”。
  11. 保存配置。
    Twitter 用户现在可以在开发者门户上注册，并使用其 Twitter 凭据登录。

如需使用 Twitter 账号登录现有开发者账号，请执行以下操作：

  1. 选择开发者门户上的“登录”链接。
  2. 选择登录页面上的“使用 Twitter 进行身份验证”按钮。
  3. 您会被重定向到 Twitter 页面。
    • 如果您已登录 Twitter，请选择“授权应用”。
    • 如果您尚未登录 Twitter，请输入您的 Twitter 凭据，然后选择“授权应用”。
  4. 如果这是您首次使用 Twitter 凭据登录，系统会将您重定向到门户上的某个页面，您必须在该页面上将您的 Twitter 账号与开发者门户上的现有账号相关联。
  5. 输入您要与 Twitter 账号关联的账号的用户名和密码。您只需执行此操作一次。
    下次使用 Twitter 凭据登录时，您将直接登录该门户。

使用 GitHub 凭据登录

您可以使用 GitHub 凭据以现有开发者的身份登录，但无法注册为新用户。

若要使用 GitHub 凭据进行联合登录，您需要在开发者门户上启用 Drupal GitHub Connect 模块。启用该模块后，您会在登录页面上看到以下按钮：

开发者门户与 GitHub 之间的连接使用 OAuth 进行身份验证。 因此，您必须先创建 GitHub 应用，然后才能使用 GitHub 凭据登录开发者门户。该应用随后会生成开发者门户和 GitHub 用于通信的消费者密钥和消费者密钥。

在下文中，您需要先创建 GitHub 应用。创建应用后，启用 GitHub 连接模块，然后添加 GitHub 应用中的客户端 ID 和客户端密钥。

创建 GitHub 应用：

  1. 在浏览器中前往以下页面：https://github.com/settings/applications/new，并根据需要登录您的 GitHub 账号。
  2. 输入门户的以下信息：
    应用名称：例如 MyApigeePortal
    说明：例如 My Apigee Portal
    网站：例如 http://{env}-{org-name}.devportal.apigee.com/
    Callback网址：门户首页的网址，后缀为 /github/register/create。例如：

    http://{env}-{org-name}.devportal.apigee.com/github/register/create
  3. 您可以选择添加图片。
  4. 选择“注册应用”。GitHub 网站会显示您需要在开发者门户上配置 GitHub 关联模块的客户端 ID 和客户端密钥，格式如下：
    客户端 ID：dbe86111e411d031d8fb
    客户端密钥：e6bd0f838a288113e8b4e531cb6a9487c27f2d79
  5. 复制这些值，以便在配置 GitHub 连接模块时使用。

如需启用 Github 连接模块，请执行以下操作：

  1. 以具有管理员权限的用户身份登录门户。
  2. 在 Drupal 管理菜单中，选择“模块”。系统随即会显示所有已安装的 Drupal 模块的列表。
  3. 向下滚动页面，然后选中“GitHub 连接”模块旁边的复选框。
  4. 保存配置。
    启用 GitHub 关联模块时，您可能会收到通知，告知您还必须启用其他模块。这些功能应该会自动启用。
  5. 启用 GitHub 关联模块后，在 Drupal 菜单中依次选择“配置”>“用户”>“GitHub”。
    系统会显示 GitHub 配置界面。
  6. 输入 GitHub 应用的客户端 ID 和客户端密钥。
  7. 将 GitHub Connect 代码块放置在您希望显示的位置。
  8. 保存配置。

如需使用 GitHub 账号登录现有开发者账号，请执行以下操作：

  1. 选择开发者门户上的“登录”链接。
  2. 在登录页面上，选择“使用 GitHub 账号登录”按钮。
  3. 您会被重定向到 GitHub 页面。
    • 如果您已登录 GitHub，请选择“允许访问”。
    • 如果您尚未登录 GitHub，请输入您的 GitHub 凭据，然后选择“授权应用”。
  4. 如果这是您首次使用 GitHub 凭据登录，系统会将您重定向到该门户上的某个页面，您必须在该页面上将您的 GitHub 账号与开发者门户上的现有账号相关联。
  5. 输入您要与 GitHub 账号关联的账号的用户名和密码。您只需执行此操作一次。
    下次使用 GitHub 凭据登录时，您将直接登录该门户。

使用 OpenID 凭据登录

借助 OpenID，您可以创建一个用户名和密码，然后使用该用户名和密码登录任何支持 OpenID 的网站。使用 OpenID 时，您的密码不会被分享，而是仅存储在 OpenID 提供方处。OpenID 提供方可以向其他网站验证您的身份。如需详细了解 OpenID，请访问 http://openid.net/。

如果您在一些热门网站（例如 Google 或 Yahoo）上拥有账号，则表示您已经拥有 OpenID。例如，Yahoo 电子邮件用户的 OpenID 格式如下：

https://me.yahoo.com/a/UniqueID

其中，UniqueID 由 Yahoo 生成。您可以使用此 OpenID 登录开发者门户。

如需通过开发者门户支持 OpenID，您必须启用 Drupal OpenID 模块。您无需在开发者门户上进行其他配置。启用 OpenID 模块后，系统会自动将以下链接添加到开发者门户登录页面：

开发者门户会将 OpenID 存储在您的门户个人资料中，以便将 OpenID 与您的门户账号相关联。将 OpenID 与您的门户账号相关联后，您可以通过以下步骤查看该 OpenID：在开发者门户的顶级菜单中依次选择您的电子邮件地址 >“修改个人资料”，然后选择“管理您的 OpenID”。

如需启用 OpenID 模块，请执行以下操作：

  1. 以具有管理员权限的用户身份登录门户。
  2. 在 Drupal 管理菜单中，选择“模块”。系统随即会显示所有已安装的 Drupal 模块的列表。
  3. 向下滚动页面，然后选中 OpenID 模块旁边的复选框。
  4. 保存配置。
    开发者门户上无需进行其他配置。

如需使用 OpenID 以现有开发者的身份登录，请执行以下操作：

  1. 使用您的开发者门户凭据登录开发者门户。
  2. 依次选择菜单栏中的电子邮件地址 > 修改个人资料。
  3. 在您的个人资料页面上，选择“管理您的 OpenID”。
  4. 输入您的 OpenID，然后选择“添加 OpenID”。
    您现在可以使用 OpenID 登录了。
  5. 退出开发者门户。
  6. 选择“登录”。
  7. 在登录页面上，选择“使用 OpenID 登录”。
  8. 输入您的 OpenID。
  9. 选择“登录”。

或者，您也可以使用 OpenID 直接登录现有的开发者门户账号。首次执行此操作时，系统会要求您使用开发者门户凭据登录。首次登录时，系统会自动将您的 OpenID 与开发者门户账号相关联。您现在可以直接使用 OpenID 登录。