要删除批准，请转到 Audience > Accounts > Usage Rules 的 Signup 部分，确保选中 Developers 选项。 另外，如果您启用了帐户和服务计划，请向下滚动页面并确保两个情况下都 直接启用更改计划 ：

另外，如果您启用了帐户和服务计划，请选择那些帐户的默认计划 帐户计划（可选） 服务计划（可选）

完成所需的设置更改后，进入开发人员门户并尝试注册新的开发人员，以测试结果。试验并做出必要的调整，以准确获取 API 的正确工作流。当您对工作流感到满意时，最好检查您的电子邮件通知，以确保他们为开发人员提供正确的信息。

您应该熟悉布局和页面创建步骤，以及 Liquid 格式标签的基础知识。有关 quid 标签的详情，请参阅 Liquid 参考 。"多个服务"功能必须在您的帐户上启用（可用于 Pro Plan 和 up）。 强烈建议您阅读有关 注册工作流 的信息，因此您将准备好整个设置，并了解它的工作原理。

通过创建新布局来启动该过程，该布局将作为您的多服务注册页面的模板。进入 CMS 系统的布局部分，并创建新的布局。您可以将其称为 multipleservicesignup（多服务注册） ，以方便将其与其他布局区分。在编辑器中，粘贴标准布局（如家或主布局）的一般结构。现在，删除您不需要的一切 - 所有容器、侧边栏、附加框等。 创建了一个布局的后退性，请继续自定义代码以进行注册。

默认情况下，开发人员门户上启用了用户名/电子邮件和密码身份验证。通常，此处未进行更改，因为这是开发人员创建帐户和登录的标准方法。 但是，在某些情况下，您可能需要删除这个验证类型。要做到这一点，编辑 Login > New 模板，如下屏幕截图中： 如果您需要向开发人员门户添加用户名/电子邮件和密码身份验证，只需删除上一步中添加的 liquid 注释标签即可。

要启用自己的 GitHub 应用，首先您需要创建一个并检索对应的凭据。 您可以通过 GitHub 配置身份验证的方法有两种： 使用 3scale GitHub 应用程序（默认为托管 3scale 帐户） 使用您自己的 GitHub 应用程序（用于内部安装） 要更改此默认配置，您可以进入 3scale 管理门户，在 Audience > Developer Portal > SSO Integrations 中，您会看到以下屏幕： 点击 GitHub 访问配置屏幕： 在此屏幕中，您可以： 在您的开发人员门户上提供或不可用 GitHub 身份验证，只需选中或取消选中"推送"框。 选择 3scale 品牌 GitHub 应用或添加您自己的 GitHub 应用 - 3scale GitHub 应用程序默认为启用（发布）。您可以通过单击 Edit 并输入 GitHub 中创建 OAuth 应用程序的详细信息（"Client"和"Client secret"），来配置自己的 GitHub 应用。请注意，为了使集成可以与您自己的 GitHub 应用程序正常工作，您应该使用 "Callback URL" 配置 GitHub 应用程序的授权回调 URL，以便在切换到"自定义品牌"选项后（例如 https://yourdomain.3scale.net/auth/github/callback ）。 测试配置的身份验证流是否按预期工作。

作为 API 供应商，配置 3scale 以允许使用红帽单点登录(RH-SSO)进行身份验证。 默认不通过 RH-SSO 进行身份验证。RH-SSO 仅适用于企业 3scale 帐户，因此您需要要求您的帐户管理器通过 RH-SSO 启用身份验证。 您的企业 3scale 帐户设置为启用 RH-SSO。 配置 RH SSO 以验证开发人员门户 后，您已了解以下信息： 客户端 ：在 RH-SSO 中客户端的名称 客户端机密 : RH-SSO 中的客户端 secret realm : Realm name 和 URL 地址到您的 RH-SSO 帐户 在 3scale 管理门户中，选择 Audience > Developer Portal > SSO Integrations 。 点 Red Hat Single Sign-On 。 指定您在 第 5.4.2 节 “配置 RH SSO 以验证开发人员门户” 中配置 RH-SSO 客户端的详细信息：客户端、客户端 secret 和 realm。 要保存您的更改，请点击 Create Red Hat Single Sign-On

首先，API 使用者必须在开发人员门户中有一个帐户。您可以使用帐户管理 API 将用户导入到 3scale，或者手动创建它们。在您的管理门户中找到 3scale ActiveDocs 的账户管理 API，位于您的管理门户，位于 右上角的文档（question mark icon(?)→ 3scale API Docs 部分。

用户存在后，您可以使用 API 请求调用来生成带有内置 SSO 令牌的 URL:

curl -X POST -d "provider_key=YOUR_PROVIDER_KEY&username=USERNAME&expires_in=60" https://YOUR_ADMIN_PORTAL.3scale.net/admin/api/sso_tokens.xml

此调用中有 2 个参数：username，用于指定您要请求令牌的人员和 expires_in，这是令牌的有效秒数（默认值为 10 分钟）。 您还可以传递额外的参数 redirect_url，该位置在成功登录后重定向用户。这个参数应该 采用百分比编码 。XML 响应将包含一个 URL，其中包含了一个 secret 令牌：

<?xml version="1.0" encoding="UTF-8"?>
<sso_url>
https://YOUR_DEVELOPER_PORTAL/session/create?expires_at=1365087501&token=Q0dNWGtjL2h2MnloR11yWmNwazVZY0NhenlabnBoRUNaNUlyWjZaVG8wMnBGdVNhT0VGN1NUb3FRc1pwSnRrclBZSTIwOUFwRkVTc3NuK1JTbjUrMEE9PS0tY1ZrOGFldzFJNkxna1hrQzQyZ0NGQT09--712f2990ac9248ab4b8962be6467fb149b346000
</sso_url>

响应包含一个带有令牌的 RH SSO 登录 URL：

https://YOUR_DEVELOPER_PORTAL/session/create?expires_at=1365087501&token=Q0dNWGtjL2h2MnloR11yWmNwazVZY0NhenlabnBoRUNaNUlyWjZaVG8wMnBGdVNhT0VGN1NUb3FRc1pwSnRrclBZSTIwOUFwRkVTc3NuK1JTbjUrMEE9PS0tY1ZrOGFldzFJNkxna1hrQzQyZ0NGQT09--712f2990ac9248ab4b8962be6467fb149b346000

URL 包含 3scale Developer Portal SSO 登录所需的所有信息。您可以直接嵌入 web 中。但是，URL 可以在用户单击之前过期，因此建议您在页面上有一个通用链接，此链接会动态请求新的 SSO URL 并重定向到它。这样，用户就可以无缝登录到开发人员门户。 URL 地址需要取消转义。如果要在浏览器中手动尝试它，请记得在浏览器中将 &amp 替换为 & 。此外，令牌中的任何 % 编码都需要替换为其未转义的字符。

在创建受限部分时，执行它以便每个部分映射到用户的逻辑组非常有用。在本例中，假设有一组名为"合作伙伴"的开发人员。 在 Developer Portal 中创建一个新部分，用于您要限制访问的每个页面或一组页面。取消选中"public"状态字段。然后拖放您想要的页面。 创建一个组，并授予它对您创建的部分的访问权限。 现在，每次您必须授予一个用户对这个部分的访问权限时，您要做的只是将它们分配给这个组。为此，请进入相应的帐户详细信息页面，然后进入"组权限"。 一旦进入，请选中您要允许的部分的框。

需要的标记是自定义开发人员门户的一种非常强大方式。请在此处根据条件来隐藏或显示页面的部分。3scale 允许您为帐户、应用程序和用户创建自定义字段。您可以使用它来存储有助于作为 API 提供程序的信息。在这里，您要创建一个附加到所有帐户的自定义字段，并使用它来指明指定帐户是否为合作伙伴。您可以通过转至 Audience > Account > Field Definitions 来创建此字段。向 Account 部分添加一个字段，并将它标记为隐藏，这样它就不会显示在注册页面上，或门户上的任何其他位置。 现在您可以使用自定义字段向合作伙伴展示特殊内容，方法是将其嵌套成以下代码片段中的条件：

{{ if current_account.extra_fields.partner == 'true' }}
  // content only accessible to partners
{{ endif }}

或者，如果您的情况更好，使用 inverse 逻辑：

{{ unless current_account.extra_fields.partner == 'true' }}
  // content forbidden for partners
{{ endunless }}

在这里，每当您想要向用户显示这些隐藏内容时，您要做的都是在其帐户详细信息页面的"true"字段中键入的。

您可以根据状态的变化，为开发人员提供对受限内容的访问。例如，升级应用程序计划的时间。 通过与帐户管理 API 结合使用 webhook 来简化调配的过程。帐户管理 API 位于 3scale ActiveDocs 中，您的管理门户可提供： 单击 Documentation ，即窗口右上角的问号图标(?)。 选择 3scale API 文档 。 通过检查 webhook 请求发送的消息，获取访问受限内容的开发人员的新计划。 根据开发人员的新计划，通过调用 API 更新 合作伙伴 字段来授予对私有内容的访问权限。

除了限制对上述内容的访问的两种方法外，还有另一种非常有用的技术：需要已登录的用户。 这非常容易使用 Liquid 标签来实现。您要做的就是包装内容，该内容仅适用于以下条件内的登录用户：

{{ if current_user }}
  // only visible if the user is logged in
{{ endif }}

本节介绍如何在布局和页面中启用流动标记处理。

<!-- if we are inside '/documentation' URL -->
<li class="{% if request.request_uri contains "/documentation" %}active{% endif %}"><!-- add the active class to the menu item -->
  <a href="/documentation">Documentation</a>
</li>

本节介绍如何使用相关的标签来自定义电子邮件模板。

此故障排除部分将帮助您调试和修复可能出现的典型错误。

这些电子邮件模板属于帐户管理类别： 已确认购买帐户 购买者帐户已批准 买者帐户被拒绝 对于这些模板，您可以使用以下 liquid drops： user ⇒ User domain ⇒ String account ⇒ Account provider ⇒ Provider support_email ⇒ String 另外，以下模板： 用于购买者的密码恢复 具有对这些 quid 丢弃的访问权限： user ⇒ User provider ⇒ Provider url ⇒ url 向帐户邀请其他用户的电子邮件： 具有以下权限： account ⇒ Account provider ⇒ Provider url ⇒ url

以下电子邮件模板均处理应用程序和应用程序计划通知。 为供应商创建的应用程序 他们可以访问： url ⇒ url 应用程序计划更改请求通知电子邮件模板： 计划购买者的更改请求 计划更改供应商请求 他们可以访问： application ⇒ Application provider ⇒ Provider account ⇒ Account user ⇒ User plan ⇒ Plan credit_card_url ⇒ credit_card_url 以下电子邮件模板包含多个可用 drop，例如： 为购买者更改应用程序计划 为供应商更改了应用程序计划 对于购买者，应用程序试用期已过期 他们可以访问： provider ⇒ Provider account ⇒ Account user ⇒ User plan ⇒ Plan 以及上述所有 liquid drops，以下应用程序计划消息…​ 暂停应用程序以购买者 已接受购买者的应用程序 拒绝购买者的应用程序 已取消供应商应用程序合同 使列出额外的 quid 丢弃 application ⇒ Application service ⇒ Service 针对应用程序键的以下电子邮件模板会更提示： 为购买者创建的应用程序密钥 为购买者删除应用程序密钥 key ⇒ key

以下电子邮件模板…​ 在为供应商支付支付前查看发票 具有以下权限： provider ⇒ Provider url ⇒ String > 另外，以下 templates…​ 没有重试的供应商的发票费用失败 为购买者提供的发票 带有重试的供应商的发票费用失败 对不重试的买家的发票失败 成功向买方收取发票 重试的买方的发票失败 分享以下 liquids： account ⇒ Account provider ⇒ Provider cost ⇒ cost invoice_url ⇒ invoice_url payment_url ⇒ payment_url

以下电子邮件模板： 供应商已取消服务合同 购买者已过期服务试用期 为供应商更改了服务计划 为购买者暂停服务合同 可以访问： provider ⇒ Provider account ⇒ Account user ⇒ User plan ⇒ Plan 以及以上 liquid drops，以下服务模板…​ 为供应商创建的服务 为购买者接受的服务 为购买者拒绝的服务 另外列出了 liquid drops： service ⇒ Service service_contract ⇒ Contract subscription ⇒ Contract

以下电子邮件模板…​ 供应商的注册通知 购买者的注册通知 可以访问： user ⇒ User provider ⇒ Provider url ⇒ activate_url

有默认的样式表 default.css 。它非常大、复杂，而不是扩展它，最好为您自己的自定义创建自己的风格表来覆盖默认值。您可以创建一个新样式表的方式创建页面（请记得在高级页面设置中选择适当的 MIME 内容类型）。 务必要确保所选的布局为空。否则，页面布局 HTML 将模糊处理 CSS 规则。

在链接到 bootstrap.css 的链接后，将每个布局模板（或部分有共同的 HEAD 部分）链接到您的自定义 CSS 的链接。例如：

<link rel="stylesheet" href="/stylesheets/custom.css">

现在，享受您自己的独一无二的品牌！

常规理念是为您的门户中的每个不同的页面风格定义一个单独的布局。启动时有一个名为" 主布局 "的标准布局。在使用 Developer Portal 的专家之前，不要对此布局进行任何更改，因为所有系统生成的页面都使用这个布局。 通常，您希望在门户的主页中唯一风格。 Main 布局 模板是您的自定义起点。要创建页面布局模板： Open Main 布局 ，并将其代码复制到剪贴板中。 创建新布局，为它指定标题和系统名称，然后选择 "激活 "。 将 主布局 代码粘贴到您的新布局中。 通过从您的新布局中删除此行来删除侧边栏菜单：

{% include 'submenu'%}

最重要的一点是确定要隐藏的内容。为此，请使用 Firebug（或其他开发人员工具，如 Chrome 开发人员工具或 Opera Dragonfly）。选择所需元素，并在控制台中点击它并选择 Copy CSS 路径。这样，您可以保存准确的 CSS 路径，以简化操作。请记住，如果元素是侧栏导航小部件的一部分，您还必须指定列表中的位置。对于这一点，您可以使用"+"选择器（例如，选择第 3 个部分），例如：ul + li + li + li + li + li）或 :nthild(n)CSS3 pseudoclass。

现在，已确定了元素，您可以更改其显示设置。根据元素类型，您可以从以下两种可能的方法中选择：CSS action 或 jQuery 脚本。CSS 操作更加轻便且更可靠，但对于很多页面存在的某些种类的元素（例如，管理门户控制面板侧栏的第 3 部分元素也存在不同的值）。某些棘手的实施需要使用 CSS3，而这些方案不受旧浏览器的支持。在接下来的两个步骤中，您将看到这两种方法。

例如，尝试在 Dashboard 页面中隐藏最新的元素。第一步，您已将其 CSS 路径识别为：

#three-scale .dashboard_bubble

请记住，这是第二个具有相同路径的方框，因此您将使用"+"选择器。您的路径现在类似如下：

.main_layout #three-scale .dashboard_bubble + .dashboard_bubble
/* or */
.main_layout #three-scale .dashboard_bubble:nth-child(1)

将 display 属性改为 none 会导致这个方框不可可见：

.main_layout #three-scale .dashboard_bubble:nth-child(1) {
  display: none;
}

如果您有复杂的元素来隐藏某一侧栏菜单元素，最好使用一些 jQuery。这些元素的 CSS 路径在 Dashboard 和 Account 部分中是一致的，您不想在这两个部分中隐藏元素。因此，请根据 CSS 路径和内容选择元素。在本例中，假设您想从 Dashboard 的边栏中隐藏 messages 部分。您的 CSS 路径为：

#three-scale #submenu li a

为了与内容匹配，您将使用 .text() 函数。您还会在文档头和就绪函数内包括代码，以便在生成所有内容后执行。 生成的代码片段类似如下：

$(function() {
  $('#three-scale #submenu li a').each(function() {
    if ($(this).text() == "Messages")
      $(this).parent().css('display', 'none');
				这不是唯一的解决方案。它只是显示这样一种可能的实现方法。同样的示例可以使用纯的 CSS 带有属性值的 CSS3 选择器。有关完整的 CSS3 选择器规范，请 在此处 查看。
			

该工作流部分通过下列步骤在管理门户中轻松设置。 进入 Audience > Developer Portal > Signup ，在其中会显示一个空白页面来填充您的签字法律条款。您可以使用 HTML、JavaScript 和 CSS 的任意组合。还可以通过单击 Insert togling 代码来提供一些切换的代码。您在此框中编写的内容只需在开发者门户的 Sign Up 页面上的 Sign Up 按钮上方出现。 填写了条款和条件后，点 Update 保存它们。 如果您使用切换代码，它将显示"通过签名，您同意以下法定条款和条件"，后跟一个链接，在显示和隐藏您指定的条件和条款之间切换的链接。 默认情况下，这放置在 Signup 页面上，但它是一个部分(signup_licence)，可在开发人员门户的任何位置包含。要从 Signup 页面删除它，只需在页面中删除 {% include 'signup_licence' %} 行。同样，如果要在其它位置包含它，您可以通过代码片段的其它部分使用相同部分，这些部分可以放置在开发人员门户网站中的任何位置。 您可能还希望用户在创建新应用程序时( new_application_licence partial)和/或订阅新服务( service_subscription_licence partial)时，用户接受另一组条款和条件。要设置这些设置，您可以按照上述步骤相同的步骤。

您还可以定义不同策略所在的其他 URL。要设置它们，请转至 Audience > Billing > credit Card Policies 并设置您的策略页面所在的路径。 要使这些链接正常工作，您将需要在 Developer Portal 中创建新页面。 完成后，您可以使用 URL 的 liquid drop 引用它们。例如：

<a href="{{ urls.credit_card_terms }}">Legal Terms</a>
<a href="{{ urls.credit_card_privacy }}">Privacy</a>
<a href="{{ urls.credit_card_refunds }}">Refunds</a>

And that’s it! The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/ . In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. Linux ® is the registered trademark of Linus Torvalds in the United States and other countries. Java ® is a registered trademark of Oracle and/or its affiliates. XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and other countries. Node.js ® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project. The OpenStack ® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community. All other trademarks are the property of their respective owners.