使用開發人員入口網站的聯合憑證

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊

聯合登入程序，使用某個身分識別管理系統 (稱為記錄系統) 中的憑證登入另一個系統。例如，您可以使用 Google 或 Twitter 憑證登入 Apigee 開發人員入口網站。聯合登入的優點在於您登入的系統絕不會看見與憑證相關聯的密碼。也就是說，密碼不必複製到其他系統。

Developer Services 入口網站支援使用多種常見供應商的憑證聯合登入，包括：

  • GitHub
  • Google
  • OpenID
  • Twitter

另外，如果您已有 Apigee Edge 帳戶，也可以使用這些憑證登入開發人員入口網站。

每個支援的憑證提供者都需要不同的設定程序，如下所述。

透過開發人員入口網站使用聯合憑證

為取得入口網站的存取權，開發人員會在入口網站上註冊新帳戶，並指定使用者名稱、電子郵件地址和密碼。接著，使用者只要提供入口網站的使用者名稱和密碼做為憑證，就能登入入口網站。

透過入口網站的聯合登入功能，您可以使用第三方的憑證登入現有的入口網站帳戶。也就是說，您必須先在入口網站上登入帳戶，才能使用第三方憑證登入。您可以使用 Apigee 支援的任何聯合憑證登入現有的入口網站帳戶。另外，您也可以使用 Google 和 Apigee 憑證，在入口網站上註冊新帳戶。

登入現有入口網站帳戶

使用系統支援的任何聯合憑證登入現有入口網站帳戶。例如，使用您的 Twitter 憑證登入。在您第一次使用 Twitter 憑證登入時，入口網站會提示您將 Twitter 憑證與現有的入口網站帳戶建立關聯。您只須執行這項關聯一次。之後，您可以使用 Twitter 憑證登入，入口網站會保留關聯資訊。

註冊新的入口網站帳戶

在入口網站使用您的 Google 或 Apigee 憑證註冊新帳戶。使用聯合憑證在入口網站上註冊成為新開發人員時，開發人員入口網站會嘗試從記錄系統取得資訊 (通常是電子郵件地址)。舉例來說，您可以使用 Google 憑證在入口網站上建立新的開發人員帳戶。系統會提示您核准傳回從 Google 傳回入口網站的資訊。即使記錄系統可將資訊傳回入口網站，新的註冊作業通常仍須輸入一些資訊，例如接受條款及細則。

使用 Apigee 憑證註冊或登入

如果您已有 Apigee Edge 帳戶，您可以使用這些憑證註冊帳戶或登入開發人員入口網站上的現有帳戶。根據預設，開發人員入口網站的註冊頁面和登入頁面都會顯示以下按鈕：

此按鈕只會顯示在網址結尾為 apigee.com (即 Apigee 網域中的入口網站) 的入口網站。例如，網址格式為 http://myCompany.devportal.apigee.com。如果網址不是以該網域結尾，您就無法使用 Apigee Edge 憑證登入或註冊在入口網站上。

如何將現有的 Apigee Edge 使用者註冊為新的入口網站開發人員：

注意：註冊程序假設您已將入口網站設為允許任何人在未經管理員核准的情況下註冊。如要進一步瞭解如何控管可以註冊的對象，請參閱「新增及管理使用者帳戶」。

  1. 確認您已有 Apigee Edge 帳戶。
  2. 選取開發人員入口網站上的「註冊」連結。
  3. 選取註冊頁面中的「使用 Apigee 進行驗證」按鈕。
    • 如果您尚未登入 Apigee Edge，請輸入 Apigee Edge 憑證並選取「登入」。
  4. 如果註冊時無須提供其他資訊，系統就會使用新的帳戶登入開發人員入口網站。
    您將收到一封與您的 Apigee 帳戶相關聯的電子郵件地址，信中會提供完成註冊程序 (例如設定密碼) 的資訊。
  5. 如要完成註冊程序所需的其他資訊，例如接受條款及細則，系統會自動將您重新導向回「註冊」頁面，並在適當的欄位中輸入您的 Apigee Edge 帳戶使用者名稱和電子郵件資訊。
  6. 指定任何其他必要的註冊資訊，以完成註冊程序。
  7. 選取「建立新帳戶」。
    我們會將電子郵件寄到與您 Apigee 帳戶相關聯的電子郵件地址，信中會提供完成註冊程序 (例如設定密碼) 的相關資訊。

如何使用 Apigee 帳戶以現有入口網站開發人員的身分登入：

  1. 選取開發人員入口網站上的「登入」連結。
  2. 選取登入頁面上的「使用 Apigee 進行驗證」按鈕。
    • 如果您已登入 Apigee Edge，系統會自動將您登入開發人員入口網站。
    • 如果您尚未登入 Apigee Edge，請輸入 Apigee Edge 憑證並選取「登入」。

使用 Google 憑證註冊或登入

根據預設，開發人員入口網站會啟用聯合註冊和使用 Google 憑證登入的功能。註冊和登入頁面都會顯示下列按鈕：

您可以使用 Google 憑證註冊成為新開發人員，或以現有開發人員的身分登入。舉例來說，如果您有 Gmail 帳戶，可以使用 Gmail 憑證登入。

開發人員入口網站會將 Google OpenID 儲存在入口網站設定檔中，藉此將 Google 憑證與您的入口網站帳戶建立關聯。將 Google 憑證與入口網站帳戶建立關聯後，只要在開發人員入口網站的頂層選單中依序選取您的電子郵件地址 > 編輯個人資料，然後選取「管理您的 OpenID」，即可查看 OpenID。

如何使用 Google 憑證註冊成為新開發人員：

注意：註冊程序假設您已將入口網站設為允許任何人在未經管理員核准的情況下註冊。如要進一步瞭解如何控管可以註冊的對象，請參閱「新增及管理使用者帳戶」。

  1. 確認您已擁有 Google 帳戶，例如 Gmail 帳戶。
  2. 選取開發人員入口網站上的「註冊」連結
  3. 選取註冊頁面上的「透過 Google 驗證」按鈕。
    系統會將您導向一個 Google 網頁，要求您接受開發人員入口網站存取您的 Google 電子郵件地址和基本資訊。
  4. 選取「接受」即可核准。
  5. 系統會將您重新導向回開發人員入口網站的註冊頁面，並從 Google 預先填入註冊欄位的資訊。
  6. 指定任何缺少的必要資訊，以便完成註冊程序。
  7. 選取「建立新帳戶」。
    您將收到一封電子郵件至您的 Gmail 帳戶，信中會說明如何完成註冊程序。

如何以現有開發人員身分登入：

  1. 選取開發人員入口網站上的「登入」連結。
  2. 選取登入頁面上的「透過 Google 進行驗證」按鈕。
    • 如果您已登入 Google，系統會將您登入入口網站。
    • 如果尚未登入 Google，請輸入 Google 憑證以登入入口網站。
  3. 如果您是第一次使用 Google 憑證登入，系統會將您重新導向至入口網站的頁面，您必須將您的 Google 帳戶與開發人員入口網站上的現有帳戶建立關聯：

  4. 複製您的 OpenID 底下的網址。
  5. 選取頁面頂端的登入連結，然後使用現有的開發人員入口網站憑證登入。
  6. 在開發人員入口網站的頂層選單中，依序選取您的電子郵件地址 > 編輯個人資料。
  7. 在個人資料頁面上，選取「管理你的 OpenID」。
  8. 輸入 OpenID 網址，然後選取 [新增 OpenID]。
    您現在可以使用 Google 憑證登入。

使用 Twitter 憑證登入

您可以使用 Twitter 憑證以現有開發人員身分登入，但無法註冊為新使用者。

您必須啟用開發人員入口網站中的 Drupal Twitter Signin 模組，才能使用 Twitter 憑證聯合登入。啟用該模組後，您會在登入頁面上看到下列按鈕：

開發人員入口網站和 Twitter 之間的連線會使用 OAuth 進行驗證。因此，您必須先建立 Twitter 應用程式，才能使用 Twitter 憑證登入開發人員入口網站。接著，該應用程式會產生開發人員入口網站和 Twitter 用來進行通訊的用戶端金鑰和用戶端密鑰。

在下方的程序中，您必須先在開發人員入口網站啟用 Twitter 登入模組，然後建立 Twitter 應用程式。建立應用程式後，請返回 Twitter 登入模組，並從 Twitter 應用程式新增必要設定資訊。

如何啟用 Twitter 登入模組：

  1. 以具備管理員權限的使用者的身分登入入口網站。
  2. 在 Drupal 管理選單中選取「模組」。系統會顯示所有已安裝的 Drupal 模組清單。
  3. 向下捲動頁面，然後勾選 Twitter 登入模組旁的核取方塊。
  4. 儲存設定。
    啟用 Twitter 登入模組時，您可能會收到必須一併啟用其他模組的通知。請務必啟用這些模組。
  5. 啟用 Twitter 登入模組後，請在 Drupal 選單中選取「設定」>「網路服務」>「Twitter」，
    系統隨即會顯示 Twitter 設定畫面。
  6. 選取 [設定] 分頁。
  7. 複製回呼網址。網址格式如下：

    http://{env}-{org-name}.devportal.apigee.com/twitter/oauth

    您需要這個網址才能建立 Twitter 應用程式。

建立 Twitter 應用程式：

  1. 使用瀏覽器前往這個網頁：https://dev.twitter.com/apps/new，並登入您的 Twitter 帳戶。
  2. 輸入下列入口網站相關資訊：
    名稱，例如 MyApigeePortal
    說明：例如我的 Apigee 入口網站
    網站：例如 http://{env}-{org-name}.devportal.apigee.com/
    CallbackURL：從 Twitter 登入模組設定畫面複製回呼網址。
  3. 同意這些條款/條件。
    系統會將您導向至含有 OAuth 設定 (包括用戶端金鑰和用戶端密鑰) 的 Twitter 頁面。您需要這個金鑰和密鑰才能設定 Drupal Twitter 登入模組。
  4. 在「設定」標籤下方，將「應用程式類型存取權」變更為「讀取和寫入」。
  5. 選取 [更新這個 Twitter 應用程式的設定]。

如何設定 Twitter 登入模組：

  1. 以具備管理員權限的使用者的身分登入入口網站。
  2. 在 Drupal 選單中，依序選取「Configuration」>「Web Services」>「Twitter」。
    系統隨即會顯示 Twitter 設定畫面。
  3. 選取 [設定] 分頁。
  4. 將 Twitter 頁面上的「Consumer Key」(用戶端金鑰) 複製到「OAUTH Consumer Key」欄位。
  5. 將 Twitter 頁面上的用戶端密鑰複製到「OAUTH Consumer Secret」欄位。
  6. 選取「Save Configuration」。
  7. 選取「Twitter」分頁標籤。
  8. 你仍在使用建立 Twitter 應用程式的帳戶登入 Twitter，但請選取「前往 Twitter」按鈕新增已驗證帳戶。
  9. 選取登入標籤。
  10. 在「自動註冊新使用者」下方選取「否」。
  11. 儲存設定。
    Twitter 使用者現在可以在開發人員入口網站註冊，並使用 Twitter 憑證登入。

如何使用 Twitter 帳戶登入現有開發人員登入：

  1. 選取開發人員入口網站上的「登入」連結。
  2. 選取登入頁面上的「透過 Twitter 進行驗證」按鈕。
  3. 系統會將您重新導向至 Twitter 網頁。
    • 如果您已登入 Twitter，請選取「授權應用程式」。
    • 如果尚未登入 Twitter，請輸入 Twitter 憑證並選取「授權應用程式」。
  4. 如果您是第一次使用 Twitter 憑證登入，系統會將您重新導向至入口網站的頁面，您必須透過這個頁面，將 Twitter 帳戶與開發人員入口網站上的現有帳戶建立關聯。
  5. 輸入要連結至 Twitter 帳戶的帳戶使用者名稱和密碼。這項操作只需執行一次。
    下次您使用 Twitter 憑證登入時，就會直接登入入口網站。

使用 GitHub 憑證登入

您可以使用 GitHub 憑證以現有開發人員身分登入，但無法註冊為新使用者。

您必須啟用開發人員入口網站上的 Drupal GitHub Connect 模組，才能使用 GitHub 憑證聯合登入。啟用該模組後，您會在登入頁面上看到下列按鈕：

開發人員入口網站和 GitHub 之間的連線會使用 OAuth 進行驗證。因此，您必須先建立 GitHub 應用程式，才能使用 GitHub 憑證登入開發人員入口網站。接著，該應用程式會產生開發人員入口網站和 GitHub 用來進行通訊的用戶端金鑰和用戶端密鑰。

在下方程序中，您必須先建立 GitHub 應用程式。建立應用程式後，請啟用 GitHub Connection 模組，並透過 GitHub 應用程式新增用戶端 ID 和用戶端密鑰。

建立 GitHub 應用程式：

  1. 使用瀏覽器前往這個頁面：https://github.com/settings/applications/new。如有需要，請登入 GitHub 帳戶。
  2. 輸入下列入口網站相關資訊：
    Application 名稱：例如 MyApigeePortal
    說明：例如我的 Apigee 入口網站
    網站：例如 http://{env}-{org-name}.devportal.apigee.com/
    CallbackURL：入口網站首頁的網址，副檔名為 /github/register/create。例如：

    http://{env}-{org-name}.devportal.apigee.com/github/register/create
  3. 視需要選擇一張圖片。
  4. 選取「註冊應用程式」。GitHub 網站會顯示您在開發人員入口網站上設定 GitHub 連線模組的用戶端 ID 和用戶端密鑰，格式如下：
    用戶端 ID: dbe86111e411d031d8fb
    用戶端密鑰：e6bd0f838a288113e8b4e531cb92487c
  5. 複製這些值，以便在設定 GitHub 連線模組時使用。

如何啟用 GitHub 連線模組：

  1. 以具備管理員權限的使用者的身分登入入口網站。
  2. 在 Drupal 管理選單中選取「模組」。系統會顯示所有已安裝的 Drupal 模組清單。
  3. 向下捲動頁面，然後勾選 GitHub Connection 模組旁的核取方塊。
  4. 儲存設定。
    啟用 GitHub Connection 模組時，您可能會收到必須一併啟用其他模組的通知。系統會自動啟用這些功能。
  5. 啟用 GitHub Connection 模組後，請在 Drupal 選單中依序選取「Configuration」>「People」>「GitHub」。
    系統隨即會顯示 GitHub 設定畫面。
  6. 輸入 GitHub 應用程式中的用戶端 ID 和用戶端密鑰。
  7. 將 GitHub Connect 區塊置於要顯示的位置。
  8. 儲存設定。

如何使用 GitHub 帳戶以現有開發人員身分登入：

  1. 選取開發人員入口網站上的「登入」連結。
  2. 選取登入頁面上的「Login with GitHub」按鈕。
  3. 系統會將您重新導向至 GitHub 頁面。
    • 如果您已登入 GitHub，請選取「Allow access」。
    • 如果您尚未登入 GitHub，請輸入您的 GitHub 憑證並選取「授權應用程式」。
  4. 如果您是第一次使用 GitHub 憑證登入，系統會將您重新導向至入口網站的頁面，您必須透過這個頁面將 GitHub 帳戶連結至開發人員入口網站上的現有帳戶。
  5. 輸入要連結至 GitHub 帳戶的帳戶使用者名稱和密碼。這項操作只需執行一次。
    下次使用 GitHub 憑證登入時，您將直接登入入口網站。

使用 OpenID 憑證登入

OpenID 可讓您建立一組使用者名稱和密碼，然後用於登入任何支援 OpenID 的網站。使用 OpenID 時，您的密碼不會分享，只會提供給 OpenID 提供者。OpenID 提供者可全權決定您在其他網站的身分。如要進一步瞭解 OpenID，請參閱 http://openid.net/。

如果您在某些熱門網站 (例如 Google 或 Yahoo) 設有帳戶，則您已經擁有 OpenID。舉例來說，假設某個 Yahoo 電子郵件使用者擁有格式為 OpenID，格式如下：

https://me.yahoo.com/a/UniqueID

其中 UniqueID。您可以使用此 OpenID 登入開發人員入口網站。

如要透過開發人員入口網站支援 OpenID，您必須啟用 Drupal OpenID 模組。開發人員入口網站不需要其他設定。啟用 OpenID 模組後，下列連結會自動新增至開發人員入口網站登入頁面：

開發人員入口網站會將 OpenID 儲存在您的入口網站設定檔中，藉此將 OpenID 與您的入口網站帳戶建立關聯。將 OpenID 與入口網站帳戶建立關聯後，只要在開發人員入口網站的頂層選單中依序選取您的電子郵件地址 > [編輯個人資料]，接著選取「管理 OpenID」，即可查看 OpenID。

如何啟用 OpenID 模組：

  1. 以具備管理員權限的使用者的身分登入入口網站。
  2. 在 Drupal 管理選單中選取「模組」。系統會顯示所有已安裝的 Drupal 模組清單。
  3. 向下捲動頁面，然後勾選 OpenID 模組旁的核取方塊。
  4. 儲存設定。
    開發人員入口網站無須進行其他設定。

如何使用 OpenID 以現有開發人員身分登入：

  1. 使用開發人員入口網站憑證登入開發人員入口網站。
  2. 在選單列的頂層選單中，選取您的電子郵件地址 > 編輯個人資料。
  3. 在個人資料頁面上，選取「管理你的 OpenID」。
  4. 輸入 OpenID，然後選取 [新增 OpenID]。
    您現在可以使用 OpenID 登入了。
  5. 登出開發人員入口網站。
  6. 選取「登入」。
  7. 在登入頁面上，選取「使用 OpenID 登入」。
  8. 輸入 OpenID。
  9. 選取登入。

您也可以使用 OpenID 直接登入現有開發人員入口網站帳戶。首次登入時，系統會要求您使用開發人員入口網站憑證登入。首次登入時，系統會自動將您的 OpenID 與開發人員入口網站帳戶建立關聯。您現在可以使用 OpenID 直接登入。