您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息
本部分提供了最常见问题的解答,其中汇总了发布到 Apigee 社区或 Apigee 支持的问题。
Category | 常见问题解答 |
---|---|
设置 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 客户,当 Apigee 发布门户的新版本时,您可以将开发者门户升级到最新版本,如升级开发者服务门户中所述。
在 Apigee Edge Private Cloud 发布期间,您可能会收到一条通知,告知 Drupal 已推出新版本。新版本可能表示 Drupal 功能版本、补丁、安全更新或其他类型的 Drupal 更新。如果出现安全更新,您希望尽快升级 Drupal,以确保您的网站仍然安全。如需了解详情,请参阅升级 Private Cloud 安装的 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)是在网络服务器和 Web 客户端(例如浏览器或应用)之间建立加密链接的标准安全技术。加密链接可确保网络服务器与客户端之间传递的所有数据保持私密状态。如需了解如何为门户配置 TLS,请参阅在门户上使用 TLS。
如何应用 Drupal 安全补丁?
对于 Apigee Edge 公有云客户:
- Pantheon:当 Apigee 发布门户的新版本时,Pantheon 信息中心会显示一条消息。您应该定期检查更新,并立即应用安全更新。如需了解详情,请参阅将 Apigee 更新应用于您的门户。
- Acquia:Apigee 会定期将您门户中的模块和主题自动更新到最新版本。仅对开发环境进行更新,并添加标签,以指示需要将其迁移到其他门户环境。如需了解详情,请参阅将模块和主题更新应用于门户。
对于适用于私有云的 Apigee Edge 客户,您将收到一条通知,告知 Drupal 已推出新版本。新版本可能意味着 Drupal 功能版本、补丁、安全更新或其他类型的 Drupal 更新。如果出现安全更新,您需要尽快升级 Drupal 的安装,以确保您的网站仍然安全。如需了解详情,请参阅升级 Private Cloud 安装的 Drupal 版本。
如何注册安全更新?
注册以接收 Drupal 和 Apigee 的最新动态:
- 已在以下页面注册接收 Drupal 安全公告和公告:https://www.drupal.org/security。
- 已注册接收来自 http://status.apigee.com/ 的 Apigee 更新和安全建议。
对于公有云客户,您还可以向 Drupal 网站托管服务商注册:
- Pantheon 用户可以访问 http://status.getpantheon.com 订阅 Pantheon 专属状态更新。点击订阅更新即可注册。
- Acquia 用户可以订阅 Acquia 特定的状态更新,如订阅状态更新中所述
如何阻止用户名枚举?
用户名枚举是指攻击者使用忘记密码表单来识别已存在的用户名的方法,该表单默认指示指定的密码是否存在。攻击者可以不断尝试输入用户名,直到找到有效用户。为防止用户名枚举,请安装用户名枚举防范模块。
如何启用双重身份验证?
如果使用 Apigee 开发者门户发布 API,请勿在 Apigee Edge 上启用双重身份验证。否则,开发者门户将无法与 Edge 通信。
如何在 Drupal 门户中存储和加密边缘凭据?
以下来源详细介绍了 Edge 凭据在 Drupal 门户中的存储和加密方式:
Apigee 社区:
控制内容访问权限
如何控制对门户的内容访问权限?
以下来源介绍了如何控制对门户的内容访问权限:
Apigee 社区:
Drupal 文档:
如何按角色控制对 API 产品的访问权限?
以下来源介绍了如何按角色控制对 API 产品的访问权限:
- 面向开发者的 Apigee 4 分钟视频 (4MV4D):按角色限制 API 产品
- Apigee 社区:API 产品角色访问权限 - 默认值(社区)
配置电子邮件和通知
如何为门户指定 SMTP 邮件服务器?
开发者门户要求您配置 SMTP 服务器才能发送电子邮件。配置 SMTP 服务器后,开发者门户发送的所有电子邮件都将使用 SMTP 服务器。这些电子邮件包括发送给新开发者的电子邮件、发送给密码丢失的开发者的电子邮件,以及发送给账号被屏蔽的开发者的电子邮件。有关详情,请参阅配置电子邮件。
如何在开发者注册应用(或其他事件发生)时发送电子邮件?
借助 Drupal 规则,您可以定义门户在响应特定事件时执行的操作。规则的一种常见用途是生成电子邮件来响应事件。该门户内置支持为预定义事件(例如新开发者注册帐号时)生成电子邮件。不过,您可以添加自己的规则来生成电子邮件。例如,您可以在开发者添加、移除或修改应用时生成电子邮件。如需了解详情,请参阅在事件发生时生成电子邮件。
如何自定义从门户发送的电子邮件?
您可以配置为了响应特定活动(例如注册、删除、屏蔽和取消屏蔽开发者帐号等)而发送的各种电子邮件通知。如需了解相关信息,请参阅配置电子邮件通知并设置其格式。
如何防止门户网站上出现垃圾内容?
防止门户上出现垃圾内容的一种方法是,通过启用 Drupal CAPTCHA 和 reCAPTCHA 模块,向登录页面和其他页面添加人机识别系统。有关信息,请参阅:
- 添加和管理用户帐号
- 面向开发者的 Apigee 4 分钟视频 (4MV4D):Power of Drupal 模块
排查问题
如何查看入口日志文件?
选择 Drupal 菜单中的报告,以查看日志和其他报告的列表。 例如,选择报告 > 最近的日志消息可查看近期日志消息的表。
视频:观看一小段视频,详细了解日志报告和调试设置。
访问代码
如何访问 Drupal 7 开发者门户源代码?
对于在 Pantheon 或 Acquia 上托管的网站,您可以通过托管网站的信息中心访问 Drupal 7 开发者门户源代码,如以下部分所述:
您可以直接在以下网址访问 Drupal 7 源代码库:https://github.com/apigee/drupal7-drops。Pantheon 和 Acquia 网站都将此代码库用于其上游源代码。