此页面由 Cloud Translation API 翻译。

将 Drupal 7 门户迁移到集成式门户

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

本部分将指导您如何规划和执行将 Drupal 7 门户资源迁移到集成门户的操作。

第 1 步：创建集成式门户

在迁移 Drupal 7 门户资源之前，您必须创建集成式门户。

如需创建集成式门户，请执行以下操作：

创建集成式门户时，系统会提供一组入门页面供您快速跳转。入门页面包含演示内容，可以在您将文本和图片替换为独特的内容时，启发您进行自己的门户开发。如需了解详情，请参阅示例门户简介。

按照构建门户的步骤中的说明构建集成式门户。

您至少需要执行下表中列出的步骤。

步骤	说明
开发门户内容	例如概念信息和入门信息。您可以选择创建页面，然后直接从现有的 Drupal 7 门户复制并粘贴页面内容。
设置导航	创建与现有结构相匹配的所需导航栏。
自定义主题	至少，您需要自定义以下组件，以符合您的品牌推广要求：徽标和 Favicon 调色板和字体系列和样式背景图片
添加自定义脚本	根据需要向您的门户添加自定义 JavaScript 代码。
配置电子邮件	配置电子邮件通知的 SMTP 服务器和内容。注意：电子邮件通知配置目前不适用于 Apigee Hybrid 集成式门户。
管理默认公开范围	管理特定资源的默认公开范围。
配置内容安全政策	根据需要，为门户中的所有网页配置内容安全政策 (CSP)，以防范跨站点脚本攻击 (XSS) 和其他代码注入攻击。注意：此功能目前不适用于 Apigee Hybrid 集成门户。

根据身份验证类型在集成门户上配置身份提供方，如下表所示。

身份验证	说明
内置身份提供程序（用户名/密码）	在集成式门户上配置内置身份提供商。
使用 SAML 的单点登录 (SSO)	在集成门户上配置 SAML 身份提供商（Beta 版）。注意：如需了解设置自定义网域的提示，请参阅通过 SAML 身份提供商使用自定义网域。集成门户不支持将 SAML 断言映射到 Drupal 7 角色。而是需要使用受众群体控制对资源的访问权限。 SAML 身份提供商目前不适用于 Apigee Hybrid 集成门户。

身份验证

说明

内置身份提供程序（用户名/密码）

使用 SAML 的单点登录 (SSO)

注意：

开发者登录门户后，您可以管理其账号，如管理开发者账号中所述。

如果您在 Drupal 7 中使用角色来控制对一组资源的访问权限（例如 API 文档或 API 产品的 API 密钥创建），则可以在集成的门户上使用受众群体实现相同的功能。

具体而言，您可以使用受众群体控制对集成式门户上以下资源的访问权限：

如需添加受众群体并管理个人用户和开发者团队分配，请参阅管理受众群体。当新用户创建账号并登录您的门户时，您需要根据需要将其分配给一个或多个受众群体，如管理受众群体的分配中所述。

为简化迁移，您可以考虑以下提示：

若要在集成的门户上使用 SmartDocs 发布 API 并自动生成 API 参考文档，您需要访问与 API 关联的 OpenAPI 规范。

虽然您可能使用 OpenAPI 规范在 Drupal 7 中自动生成了 SmartDocs，但最终内容是使用内部格式存储的，与原始 OpenAPI 规范没有任何关联。使用 Apigee Edge 的 API 团队通常会在 Apigee Edge 规范存储区中存储 OpenAPI 规范。

然后，将 API 发布到您的门户。请做好以下准备：

如果您的开发者在 Drupal 7 中使用公司应用来共担应用的责任，则他们可以在集成式门户上使用开发者团队实现相同的功能。

您的开发者可以创建开发者团队，以共担应用的责任并管理团队成员资格，如使用开发者团队（Beta 版）共担应用的责任中所述。

您可能需要向开发者社区介绍开发者团队，并鼓励他们迁移应用以使用开发者团队来共担责任，并改用新的 API 密钥。然后，您可以使用 Edge API 移除所有公司应用和相关工件。

或者，您也可以将公司应用迁移到开发者团队应用，如以下社区文章所述：将公司拥有的应用迁移到开发者团队。

在将集成门户发布到生产环境之前，不妨考虑执行下表中定义的步骤。

步骤	说明
自定义您的域名	提供您自己的自定义域名，以个性化您的网站。注意：此功能目前不适用于 Apigee Hybrid 集成门户。
配置 Google Analytics 跟踪	使用 Google Analytics 或您自己的自定义分析跟踪服务配置分析跟踪。
创建自定义搜索页	创建自定义搜索页并嵌入 Google 自定义搜索引擎。