您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info
本節將說明如何規劃及執行 Drupal 7 入口網站資產遷移至整合式入口網站。
步驟 1：建立整合式入口網站
遷移 Drupal 7 入口網站資產前，您必須建立整合式入口網站。
如何建立整合式入口網站：
建立整合式入口網站時，系統會提供一組入門網頁，供您做為起點使用。這些起始網頁包含示範內容，可激發您開發自己的入口網站時的靈感，您只需將文字和圖片替換為自己的內容即可。 詳情請參閱「樣本入口網站簡介」。
步驟 2：建構整合式入口網站
按照「建構入口網站的步驟」一節所述，建立整合式入口網站。
您至少需要執行下表所列的步驟。
| 步驟 | 說明 |
|---|---|
| 開發入口網站內容 | 例如概念和入門資訊。 您可以選擇建立網頁，然後直接從現有的 Drupal 7 入口網站複製及貼上網頁內容。 |
| 設定導覽功能 | 建立符合現有結構的必要導覽。 |
| 自訂主題 | 請至少自訂下列元件，以符合品牌需求： |
| 新增自訂指令碼 | 視需要在入口網站中加入自訂 JavaScript 程式碼。 |
| 設定電子郵件 | 設定 SMTP 伺服器和電子郵件通知內容。 注意：Apigee hybrid 整合式入口網站目前不支援電子郵件通知設定。 |
| 管理預設瀏覽權限 | 管理特定資源的預設瀏覽權限。 |
| 設定內容安全性政策 | 如有需要，請為入口網站中的所有網頁設定內容安全政策 (CSP)，以防範跨網站指令碼攻擊 (XSS) 和其他程式碼植入攻擊。
注意：這項功能目前不適用於 Apigee 混合式整合入口網站。 |
步驟 3：設定識別資訊提供者
請根據下表所述的驗證類型，在整合式入口網站上設定識別資訊提供者。
| 驗證 | 說明 |
|---|---|
| 內建的識別資訊提供者 (使用者名稱/密碼) | 在整合式入口網站上設定內建的識別資訊提供者。 |
| 使用 SAML 的單一登入 (SSO) | 在整合式入口網站上設定 SAML 識別資訊提供者 (Beta 版)。
注意事項：
|
開發人員登入入口網站後，您就可以管理他們的帳戶，詳情請參閱「管理開發人員帳戶」。
步驟 4：使用目標對象控管資源存取權
如果您在 Drupal 7 中使用角色來控管一組資源的存取權，例如 API 產品的 API 說明文件或 API 金鑰建立權限，您可以在整合式入口網站上使用目標對象來達成相同的功能。
具體來說，您可以使用目標對象控管整合式入口網站上的下列資源存取權：
- 入口網站中的網頁
- 已發布的 API 產品
如要新增目標對象，並管理個別使用者和開發人員團隊指派，請參閱「管理目標對象」。新使用者建立帳戶並登入入口網站時，您需要視需要將他們指派給一或多個目標對象，詳情請參閱「管理目標對象的指派」一文。
為了簡化遷移作業，您可以考慮下列提示：
- 請根據要取代的 Drupal 角色命名目標對象。
- 使用開發人員團隊管理目標對象成員。開發人員建立團隊，以便分擔應用程式的責任，並管理團隊成員。
步驟 5：發布 API
如要在整合式入口網站上發布 API，並使用 SmartDocs 自動產生 API 參考說明文件，您必須能存取與 API 相關聯的 OpenAPI 規格。
雖然您可能已使用 OpenAPI 規範，在 Drupal 7 中自動產生 SmartDocs，但內容最終會以內部格式儲存，且不會與原始 OpenAPI 規範建立任何關聯。使用 Apigee Edge 的 API 團隊通常會將 OpenAPI 規格儲存在 Apigee Edge 規格儲存庫中。
接著，將 API 發布至入口網站。請準備好：
- 指定要用來做為文件來源的 OpenAPI 規格，可從規格儲存庫、本機目錄或網址中選擇
- 設定說明文件的瀏覽權限 (公開、已驗證使用者或特定目標對象)
- 視需要設定回呼網址
- 視需要在 API 目錄中為顯示內容新增圖片
步驟 6：使用開發人員團隊分擔應用程式的責任
如果開發人員在 Drupal 7 中使用公司應用程式來分擔應用程式的責任，他們可以在整合式入口網站上使用開發人員團隊來達成相同的功能。
開發人員會建立開發人員團隊，以便分擔應用程式的責任，並管理團隊成員，詳情請參閱「使用開發人員團隊分擔應用程式的責任 (Beta 版)」。
您可以向開發人員社群介紹開發人員團隊，並鼓勵他們將應用程式遷移至使用開發人員團隊，以便分擔責任，並改用新的 API 金鑰。接著，您可以使用 Edge API 移除所有公司應用程式和相關構件。
或者，您也可以將公司應用程式遷移至開發人員團隊應用程式，詳情請參閱以下社群文章：將公司擁有的應用程式遷移至開發人員團隊。
步驟 7：準備發布整合式入口網站
在將整合的入口網站發布至正式環境前，請考慮執行下表所定義的步驟。
| 步驟 | 說明 |
| 自訂網域 | 提供自訂網域名稱，為網站打造個人化風格。 注意：這項功能目前不適用於 Apigee 混合式整合入口網站。 |
| 設定 Analytics 追蹤 | 使用 Google Analytics 或自訂的數據分析追蹤服務設定數據分析追蹤。 |
| 建立自訂搜尋網頁 | 建立自訂搜尋網頁，並嵌入 Google 自訂搜尋引擎。 |