您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊
本節說明如何規劃及執行將 Drupal 7 入口網站資產遷移至整合式入口網站的指引。
步驟 1：建立整合式入口網站
必須先建立整合式入口網站，才能遷移 Drupal 7 入口網站資產。
如何建立整合式入口網站：
建立整合式入口網站時，系統會提供一組起始網頁，供您做為跳轉點使用。 新手網頁會提供示範內容，協助您以自己的獨特內容取代文字和圖片，啟發您的入口網站開發。 詳情請參閱「關於範例入口網站」。
步驟 2：建構整合式入口網站
按照建構入口網站的步驟所述，建構整合式入口網站。
您至少需要執行下表所列的步驟。
| 步驟 | 說明 |
|---|---|
| 開發入口網站內容 | 例如概念和入門資訊。 您可以選擇建立網頁，然後直接從現有的 Drupal 7 入口網站複製及貼上網頁內容。 |
| 設定導覽功能 | 建立與現有結構相符的必要導覽功能。 |
| 自訂主題 | 請至少根據自己的品牌宣傳需求自訂下列元件： |
| 新增自訂指令碼 | 視需要將自訂 JavaScript 程式碼新增至入口網站。 |
| 設定電子郵件 | 設定 SMTP 伺服器和電子郵件通知內容。 注意：Apigee 混合型整合入口網站目前無法使用電子郵件通知設定。 |
| 管理預設顯示設定 | 管理特定資源的預設瀏覽權限。 |
| 設定內容安全政策 | 為入口網站的所有網頁設定內容安全性政策 (CSP)，並視需要防範跨網站指令碼 (XSS) 和其他程式碼插入攻擊。 附註：這項功能目前不適用於 Apigee 混合式整合入口網站。 |
步驟 3：設定識別資訊提供者
根據驗證類型在整合式入口網站上設定識別資訊提供者，如下表所示。
| 驗證 | 說明 |
|---|---|
| 內建識別資訊提供者 (使用者名稱/密碼) | 在整合式入口網站上設定內建識別資訊提供者。 |
| 使用 SAML 的單一登入 (SSO) 服務 | 在整合式入口網站上設定 SAML 識別資訊提供者 (Beta 版)。
注意：
|
開發人員登入入口網站後，您就可以按照管理開發人員帳戶的說明管理他們的帳戶。
步驟 4：使用目標對象控管資源存取權
如果您利用 Drupal 7 中的角色來控管一組資源的存取權 (例如 API 文件或建立 API 金鑰的 API 金鑰)，就可以在整合式入口網站上使用目標對象達到同樣的功能。
具體來說，您可以在整合式入口網站上，使用目標對象控管下列資源的存取權：
- 入口網站中的網頁
- 已發布的 API 產品
如要新增目標對象及管理個別使用者和開發人員團隊指派項目，請參閱「管理目標對象」。新使用者建立新帳戶並登入入口網站時，您必須視需要為他們指派一或多個目標對象，詳情請參閱「管理目標對象的指派作業」一節。
為了簡化遷移程序，您不妨參考下列提示：
- 以他們要取代的 Drupal 角色命名目標對象。
- 透過開發人員團隊管理目標對象成員資格。開發人員會建立團隊來共同承擔應用程式責任，並管理團隊成員。
步驟 5：發布 API
如要在整合式入口網站上使用 SmartDocs 發布 API 並自動產生 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 (分析) 或您的自訂分析追蹤服務設定 Analytics (分析) 追蹤。 |
| 建立自訂搜尋頁面 | 建立自訂搜尋網頁並嵌入 Google 自訂搜尋引擎。 |