認證指南

Adobe Experience Platform查詢服務可讓您與外部用戶端連線。 您可以使用到期憑證或非到期憑證來連線至這些外部用戶端。

即將到期的憑據

您可以使用到期憑證來快速設定與外部用戶端的連線。

「查詢」儀表板「憑據」頁簽，其中「即將到期的憑據」部分突出顯示。

此 即將到期的憑據 一節提供下列資訊：

  • 主機:將客戶端連接到的主機的名稱。 這會合併Platform UI頂端功能區中顯示的組織名稱。
  • 埠:要連接的主機的埠號。
  • 資料庫:要連接客戶端的資料庫的名稱。
  • 使用者名稱:用於連接到查詢服務的用戶名。
  • 密碼:用於連接到查詢服務的密碼。 UI中的密碼已經過雜湊處理，以確保安全性。 選取復製圖示(復製圖示。)，將完整、未雜湊的憑證複製到剪貼簿。
  • PSQL命令:一個命令，它自動插入了所有相關資訊，以便您使用命令行上的PSQL連接到查詢服務。
  • 過期:即將到期的憑據的到期日期和時間。 代號的預設有效期間為24小時，但可在Admin Console的進階設定中變更。
秘訣

若要將到期憑證連線的工作階段期間變更為Query Service，請導覽至 Admin Console 並在畫面選項上選取下列項目： 設定 > 隱私權與安全性 > 驗證設定 > 進階設定 > 最大會話期.

「Admin Console設定」標籤中，「隱私與安全」、「驗證設定」和「工作階段最長」壽命已反白顯示。

如需以下項目的詳細資訊，請參閱Adobe說明檔案： 進階設定 由Admin Console提供。

未到期的憑據

您可以使用非到期憑證來設定與外部用戶端的更永久連線。

先決條件

您必須先在Adobe Admin Console中完成下列步驟，才能產生非到期憑證：

  1. 登入 Adobe Admin Console 並從頂端導覽列選取相關組織。
  2. 選取產品設定檔。
  3. 設定 沙箱 和 管理查詢服務整合 權限 針對產品設定檔。
  4. 將新使用者新增至產品設定檔 因此，系統會授予這些使用者已設定的權限。
  5. 將使用者新增為產品設定檔管理員 允許為任何作用中的產品設定檔建立帳戶。
  6. 將使用者新增為產品設定檔開發人員 以建立整合。

若要進一步了解如何指派權限，請參閱 存取控制.

使用者現在可在Adobe Developer Console中設定所有必要權限，以使用即將到期的憑證功能。

生成憑據

若要建立一組未到期的憑證，請返回Platform UI並選取 查詢 從左側導覽器存取 查詢 工作區。 下一步，選取 憑證 標籤後面 生成憑據.

突出顯示「Credentials（憑據）」頁簽和「Generate（生成）」憑據的「Querys（查詢）」儀表板。

此時將顯示一個對話框，允許您生成憑據。 若要建立未到期的憑證，您必須提供下列詳細資料：

  • 名稱:您正在生成的憑據的名稱。
  • 說明:（選用）您要產生的憑證說明。
  • 指派給:將為其分配憑據的用戶。 此值應為建立憑證之使用者的電子郵件地址。
  • 密碼 （可選）您的憑證的選用密碼。 如果未設定密碼，Adobe將自動為您生成密碼。

提供所有必要的詳細資訊後，請選取 生成憑據 來產生您的憑證。

將突出顯示「生成憑據」對話框。

重要

當 生成憑據 選取後，配置JSON檔案會下載到您的本地電腦。 因為Adobe有 not 記錄生成的憑據，您必須安全地儲存下載的檔案並保留憑據的記錄。

此外，如果90天內未使用憑證，則會清除憑證。

設定JSON檔案包含技術帳戶名稱、技術帳戶ID和憑證等資訊。 以下列格式提供。

{"technicalAccountName":"9F0A21EE-B8F3-4165-9871-846D3C8BC49E@TECHACCT.ADOBE.COM","credential":"3d184fa9e0b94f33a7781905c05203ee","technicalAccountId":"4F2611B8613AA3670A495E55"}

儲存產生的憑證後，請選取 關閉. 您現在可以看到所有未到期憑證的清單。

突出顯示了「查詢儀表板憑據」頁簽的「非到期憑據」部分。

您可以編輯或刪除未到期的憑證。 要編輯未到期的憑據，請選擇鉛筆表徵圖(鉛筆圖示。)。要刪除未到期的憑據，請選擇刪除表徵圖(垃圾桶圖示。)。

編輯未到期的憑證時，會出現強制回應視窗。 您可以提供下列詳細資料以進行更新：

  • 名稱:您正在生成的憑據的名稱。
  • 說明:（選用）您要產生的憑證說明。
  • 指派給:將為其分配憑據的用戶。 此值應為建立憑證之使用者的電子郵件地址。

「更新帳戶」對話框。

提供所有必要的詳細資訊後，請選取 更新帳戶 完成憑據的更新。

使用憑據連接到外部客戶端

您可以使用即將到期或未到期的憑據來連接外部客戶端，如Aqua Data Studio、Looker或Power BI。 這些憑證的輸入方法會因外部用戶端而異。 請參閱外部客戶端的文檔，以了解有關使用這些憑據的具體說明。

影像會指出UI中找到之每個參數的位置，但非即將到期憑證的密碼除外。 雖然其JSON設定檔案提供了非到期憑證，但您可以在 憑證 標籤。

「查詢工作區憑據」頁簽，其中「即將到期的憑據」部分突出顯示。

下表概述了連接到外部客戶端通常所需的參數。

注意

使用非到期憑證連線至主機時，仍需使用 即將到期的憑據 區段，但密碼和使用者名稱除外。
輸入用戶名和密碼的格式使用冒號分隔值，如本示例所示 username:{your_username} 和 password:{password_string}.

參數 說明
伺服器/主機 要連接的伺服器/主機的名稱。
  • 此值用於即將到期的憑據和未到期的憑據，其形式為 server.adobe.io. 值位於 主機 在 即將到期的憑據 區段。
連接埠 要連接的伺服器/主機的埠。
  • 此值用於即將到期的憑據和非即將到期的憑據，可在以下找到 埠 在 即將到期的憑據 區段。 埠的範例值為 80.
資料庫 您要連接的資料庫。
  • 此值用於即將到期的憑證和非即將到期的憑證，可在 資料庫 在 即將到期的憑據 區段。 資料庫的範例值為 prod:all.
使用者名稱 連接到外部客戶端的用戶的用戶名。
  • 此值用於即將到期的憑據和非即將到期的憑據。 其格式為字母數字字串 @AdobeOrg. 此值位於 使用者名稱.
密碼 連接到外部客戶端的用戶的密碼。
  • 如果您使用即將到期的憑證，可在 密碼 在 即將到期的憑據 區段。
  • 如果您使用的是未到期的憑證，此值是來自technicalAccountID的串連引數，以及來自設定JSON檔案的憑證。 密碼值採用以下形式： {technicalAccountId}:{credential}.

後續步驟

現在您已了解過期和未過期的憑證如何運作，您可以使用這些憑證連線至外部用戶端。 有關外部客戶端的詳細資訊，請閱讀 將客戶端連接到查詢服務指南.

本頁內容