您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息
本部分提供了常见问题解答，这些解答汇总自 Apigee 社区或 Apigee 支持团队中发布的问题。
| 类别 | 常见问题解答 |
|---|---|
| 设置 Drupal 开发者门户 | |
| 管理门户环境 | |
| 自定义门户外观和风格 | |
| 自定义用户和应用注册 | |
| 备份、恢复和高可用性 | |
| 保护门户安全 | |
| 控制内容访问权限 | |
| 配置电子邮件和通知 | |
| 排查问题 | |
| 访问代码 |
设置 Drupal 开发者门户
如何设置 Drupal 开发者门户？
自 2020 年 5 月 31 日起，Apigee 赞助的基于 Drupal 的门户托管已结束。如需了解如何配置现有开发者门户，请参阅创建开发者门户。
该门户支持哪些浏览器和浏览器版本？
请参阅支持的软件和支持的版本。
管理门户环境
如何在公共云中管理门户环境？
Apigee 使用网站管理服务 Pantheon 托管基于云的开发者服务门户版本。如需了解详情，请参阅使用 Pantheon。
Apigee 使用网站管理服务 Acquia 在欧洲联盟 (EU) 托管基于云的开发者服务门户版本。如需了解详情，请参阅使用 Acquia。
Pantheon 和 Acquia 都提供了工具，可让您在安全的环境中开发、测试和发布基于 Drupal 的门户。
如何在私有云中管理门户环境？
作为 Apigee Edge Private Cloud 客户，您需要自行管理门户环境。如需获取建议，请参阅 Drupal 开发和服务器环境最佳实践。
如何将 Apigee 更新应用于公共云中的开发者门户？
如需将 Apigee 更新应用于公有云中的开发者门户，请执行以下操作：
-
Pantheon：当 Apigee 发布门户的新版本时，Pantheon 信息中心会显示一条消息。您应定期检查更新，并立即应用安全更新。如需了解详情，请参阅将 Apigee 更新应用于您的门户。
注意：在环境的“状态”区域（通过信息中心左侧的“状态”菜单项访问），您可能会看到 Drupal 模块有可用更新。请忽略这些更新。Apigee 会自动将 Drupal 模块的更新纳入到门户的下一版本中。允许 Apigee 为您更新 Drupal 模块后，Apigee 会确保这些更新已针对最新的门户代码进行测试。如果您在正常的 Apigee 门户发布周期之外更新 Drupal 模块，可能会遇到意外问题。
- Acquia：Apigee 会定期自动将门户中的模块和主题更新到最新版本。更新仅应用于开发环境，并带有标记，以指明需要将其迁移到其他门户环境。如需了解详情，请参阅 向门户应用模块和主题更新。
如何将 Apigee 更新应用于私有云中的开发者门户？
对于 Apigee Edge for Private Cloud 客户，当 Apigee 发布门户的新版本时，您可以将开发者门户升级到最新版本，如升级开发者服务门户中所述。
在 Apigee Edge 私有云版本之间，您可能会收到有关有新版 Drupal 可用的消息。新版本可以是指 Drupal 功能版本、补丁、安全更新或其他类型的 Drupal 更新。如果是安全更新，您需要尽快升级 Drupal 安装，以确保您的网站保持安全。 如需了解详情，请参阅升级私有云安装的 Drupal 版本。
自定义门户外观和风格
如何自定义门户的外观？
使用 Drupal，您可以通过调整 Drupal 主题和添加自定义模块来创建高度自定义的门户。
注意：实现更高级的 Drupal 自定义需要一定的学习过程。您可以决定聘请具有 Drupal 专业知识的第三方，以便在所需时间范围内实现所需的外观和风格。
以下是一些资源，可帮助您使用 Drupal 自定义门户：
- 自定义外观
- 自定义主题
- Drupal 7 文档
- Lynda.com 上的 Drupal 7 培训课程，包括：
- Drupal 7 必备培训
- 高级 Drupal 7
- Drupal 7：自定义模块开发
- Drupal 7：生成报告和直观呈现数据
如何在公有云中向门户添加自定义模块和主题？
您可以添加自己的自定义模块和主题，从而扩展门户的功能。
如需向基于云的门户添加自定义模块和主题，请根据您是使用 Patheon 还是 Acquia 来管理门户，参阅以下某个部分：
- Pantheon：添加自定义模块和主题
- Acquia：添加自定义模块和主题
注意：请仅修改 /sites/all 目录中的内容。如果您修改 /sites/all 目录之外的内容，则在将更改签入 Git 时可能会遇到合并冲突。
如需了解最佳实践以及有关添加和更新自定义模块的信息，请参阅 Drupal 文档中的添加模块和主题和更新模块。
如何在私有云中的门户中添加自定义模块和主题？
您可以添加自己的自定义模块和主题，从而扩展门户的功能。 如需了解最佳实践以及有关添加和更新自定义模块的信息，请参阅 Drupal 文档中的添加模块和主题和更新模块。
注意：请仅修改 /sites/all 目录中的内容。如果您修改 /sites/all 目录之外的内容，则在将更改签入 Git 时可能会遇到合并冲突。
自定义用户和应用注册
如何自定义新用户注册页面？
当用户在门户上注册账号时，门户会显示默认的注册页面，其中包含“名字”“姓氏”“用户名”“电子邮件地址”和“密码”字段。 作为 API 提供方，您可能需要修改此表单，以提示用户提供公司名称、邮寄地址或其他信息等其他信息。如需了解详情，请参阅：
如何自定义应用注册页面？
当应用开发者注册应用时，门户会显示一个默认表单。作为 API 提供商，您可能需要修改应用注册表单，以提示开发者提供其他信息，例如客户 ID、应用的目标平台或其他信息。如需了解详情，请参阅：
- 自定义用于注册应用的表单字段
- Apigee 面向开发者的 4 分钟视频 (4MV4D)：自定义应用注册表单
如何在开发者门户上使用 LDAP 进行身份验证？
以下资源介绍了如何使用 LDAP 进行身份验证：
Apigee 社区
Drupal 文档
如何使用我的 Twitter、Google 或 GitHub 凭据登录门户？
联合登录是指您使用一个身份管理系统（称为“记录系统”）中的凭据登录另一个系统的过程。例如，您使用 Google 或 Twitter 凭据登录 Apigee 开发者门户。该门户支持使用多种常见提供商（包括 GitHub、Google、OpenID 和 Twitter）的凭据进行联合登录。 如需了解详情，请参阅在开发者门户上使用联合凭据。
如何为手动 API 密钥审批应用工作流？
您可以在创建 API 产品时为应用注册配置手动 API 密钥批准。在这种情况下，当应用开发者注册应用时，您必须手动批准 API 密钥。
如需有关应用工作流来进行手动 API 密钥审批的建议，请参阅以下社区文章：在开发者门户中，应用工作流来进行手动 API 密钥审批的最佳方式是什么？。
备份、恢复和高可用性
如何在公共云中备份和恢复门户？
在公有云中备份门户的步骤因您是使用 Pantheon 还是 Acquia 管理门户而异：
如何在私有云中备份和恢复门户？
您可以使用 Postgres pg_dump 和 pg_restore 命令在私有云中备份和恢复门户。如需了解详情，请参阅备份门户。
如何确保我公共云中的开发者门户的高可用性？
Pantheon 和 Acquia Drupal 管理工具可保证其托管的门户的可用性达到 99.5%。如需了解详情，请参阅：
- Pantheon：Pantheon 安全
- Acquia：Acquia Cloud Enterprise 可用性和灾难恢复
如何确保私有云中的开发者门户的高可用性？
没有一种放之四海而皆准的方法可以确保开发者门户的高可用性。我们强烈建议您寻求以下领域的专家帮助：
- 在高可用性配置中设置文件系统和数据库
- Drupal 7 门户开发
如果您需要帮助，请与 Apigee 客户成功团队联系。此外，请参阅以下社区文章：
保护门户安全
如何配置门户安全性？
在构建门户时，您还应熟悉 Drupal 的许多安全功能。如需了解详情，请参阅保护门户。
如何将门户配置为使用 TLS/HTTPS？
TLS（传输层安全协议，其前身是 SSL）是一种标准安全技术，用于在网络服务器和网络客户端（例如浏览器或应用）之间建立加密链接。加密链接可确保在网络服务器和客户端之间传递的所有数据都保持私密。如需了解如何通过门户配置 TLS，请参阅在门户上使用 TLS。
如何应用 Drupal 安全补丁？
对于 Apigee Edge Public Cloud 客户：
- Pantheon：当 Apigee 发布门户的新版本时，Pantheon 信息中心会显示一条消息。您应定期检查更新，并立即应用安全更新。如需了解详情，请参阅将 Apigee 更新应用于您的门户。
- Acquia：Apigee 会定期自动将您门户中的模块和主题更新到最新版本。更新仅应用于开发环境，并带有标记，以指明需要将其迁移到其他门户环境。如需了解详情，请参阅将模块和主题更新应用于门户。
对于 Apigee Edge for Private Cloud 客户，您会收到有关有新版 Drupal 可用的消息通知。新版本可以是指 Drupal 功能版本、补丁、安全更新或其他类型的 Drupal 更新。如果是安全更新，您需要尽快升级 Drupal 安装，以确保您的网站保持安全。如需了解详情，请参阅升级私有云安装的 Drupal 版本。
如何注册接收安全更新？
注册接收 Drupal 和 Apigee 的更新：
- 已注册接收此页面上提供的 Drupal 安全公告和通告：https://www.drupal.org/security。
- 已注册接收 Apigee 更新和安全建议：http://status.apigee.com/。
对于公共云客户，您还可以向 Drupal 网站托管商注册：
- Pantheon 用户可以访问 http://status.getpantheon.com 订阅 Pantheon 专用状态更新。点击订阅更新即可注册。
- Acquia 用户可以订阅 Acquia 专用状态更新，如订阅状态更新中所述
如何防止用户名枚举？
用户名枚举是指攻击者使用忘记密码表单（默认情况下，该表单用于指明指定密码是否存在）来识别现有用户名的一种方法。攻击者可以一直尝试用户名，直到找到有效的用户为止。如需防止用户名枚举，请安装用户名枚举防范模块。
如何启用双重身份验证？
如果您使用 Apigee 开发者门户发布 API，请勿在 Apigee Edge 上启用双重身份验证。否则，开发者门户将无法与 Edge 通信。
Edge 凭据如何在 Drupal 门户中存储和加密？
以下来源详细介绍了 Edge 凭据如何在 Drupal 门户中存储和加密：
Apigee 社区：
控制内容访问权限
如何控制对门户内容的访问权限？
以下资源介绍了如何控制对门户内容的访问权限：
Apigee 社区：
Drupal 文档：
如何按角色控制对 API 产品的访问权限？
以下资源介绍了如何按角色控制对 API 产品的访问权限：
- Apigee 面向开发者的 4 分钟视频 (4MV4D)：按角色限制 API 产品
- Apigee 社区：API 产品角色访问权限 - 默认值（社区）
配置电子邮件和通知
如何为门户指定 SMTP 邮件服务器？
开发者门户要求您配置 SMTP 服务器以发送电子邮件。配置 SMTP 服务器后，开发者门户发送的所有电子邮件都会使用该 SMTP 服务器。这些电子邮件包括发送给新开发者的电子邮件、发送给忘记密码的开发者的电子邮件，以及发送给账号被屏蔽的开发者的电子邮件。如需了解详情，请参阅配置电子邮件。
如何在开发者注册应用（或发生其他事件）时发送电子邮件？
借助 Drupal 规则，您可以定义门户在发生特定事件时执行的操作。规则的一种常见用途是根据事件生成电子邮件。该门户内置了针对预定义事件（例如新开发者注册账号时）生成电子邮件的功能。不过，您可以添加自己的规则来生成电子邮件。例如，您可以在开发者添加、移除或修改应用时生成电子邮件。如需了解详情，请参阅在发生事件时生成电子邮件。
如何自定义从门户发送的电子邮件？
您可以配置各种电子邮件通知，以便在发生特定活动（例如注册、删除、屏蔽和取消屏蔽开发者账号）时发送通知。如需了解详情，请参阅配置和设置电子邮件通知的格式。
如何防止在门户上收到垃圾邮件？
在门户上防范垃圾内容的一种方法是，通过启用 Drupal CAPTCHA 和 reCAPTCHA 模块，在登录页面和其他页面中添加 CAPTCHA。如需了解详情，请参阅以下主题：
- 添加和管理用户账号
- Apigee 面向开发者的 4 分钟视频 (4MV4D)：Drupal 模块的强大功能
排查问题
如何查看门户日志文件？
在 Drupal 菜单中选择报告，以查看日志和其他报告的列表。 例如，依次选择报告 > 近期日志消息，即可查看近期日志消息的表格。
视频：观看一段短视频，详细了解日志报告和调试设置。
访问代码
如何访问 Drupal 7 开发者门户源代码？
对于托管在 Pantheon 或 Acquia 上的网站，您可以通过托管网站信息中心访问 Drupal 7 开发者门户源代码，如以下部分所述：
您可以直接访问 Drupal 7 源代码库：https://github.com/apigee/drupal7-drops。Pantheon 和 Acquia 网站都将此代码库用作其源代码上游。