通過 DLP API 驗證

您必須先向 DLP API 進行驗證，才能使用該 API。DLP API 可處理 API 金鑰和驗證。這兩種方法的主要差異如下：

  • API 金鑰用於識別呼叫的專案，即正在呼叫 API 的應用程式或網站。
  • 驗證憑證用於識別使用者，即使用專案的人。

將 API 金鑰用於未經驗證的存取

您可以使用 Google Cloud 控制台 API 金鑰，向 DLP API 驗證某些方法，包括所有 projects.content.* 和 projects.image.* 方法。

  1. 按照操作說明，為 Google Cloud 控制台專案建立 API 金鑰。
  2. 提出任何 DLP API 要求時，請將金鑰做為 key 參數的值傳遞。例如：
    curl https://dlp.googleapis.com/v2/infoTypes?key=[YOUR_API_KEY]

請務必妥善保護您的 API 金鑰以免遭到未經授權的使用。如需上述操作的相關建議，請參閱安全使用 API 金鑰的最佳做法說明。

使用服務帳戶

如何使用服務帳戶通過 DLP API 驗證：

  • 按照操作說明建立服務帳戶。選取「JSON」做為金鑰類型，並授予使用者「DLP 使用者」角色 (roles/dlp.user)。

如要進一步瞭解如何將角色授予服務帳戶，請參閱為服務帳戶授予角色一文。

完成之後，服務帳戶金鑰會下載到瀏覽器的預設位置。

接著，決定要以不記名權杖的形式提供服務帳戶驗證，還是使用應用程式預設憑證。

使用服務帳戶的不記名權杖

如果您直接呼叫 DLP API (例如使用 cURL 提出 HTTP 要求)，則須在 HTTP 授權要求標頭中，以不記名權杖的形式傳遞驗證資訊。如要使用服務帳戶取得不記名權杖，請按照下列步驟操作：

  1. 安裝 Google Cloud CLI。
  2. 通過服務帳戶驗證，將以下 [KEY_FILE] 替換為服務帳戶金鑰檔案的路徑：
    gcloud auth activate-service-account --key-file [KEY_FILE]
  3. 使用服務帳戶取得授權憑證：
    gcloud auth print-access-token
     指令會傳回存取權杖值。
  4. 呼叫 API 時，請在 Authorization 標頭中將權杖值做為 bearer 權杖傳遞：
    curl -s -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer [ACCESS_TOKEN]' \
  'https://dlp.googleapis.com/v2/infoTypes'

應用程式預設憑證

如果您使用用戶端程式庫呼叫 DLP API，請使用應用程式預設憑證 (ADC)。

使用 ADC 的服務會尋找 GOOGLE_APPLICATION_CREDENTIALS 環境變數內的憑證。除非您特別希望讓 ADC 使用其他憑證 (例如使用者憑證)，否則請將這個環境變數設為指向您的服務帳戶金鑰檔案。

export GOOGLE_APPLICATION_CREDENTIALS=[PATH_TO_KEY_FILE]

透過 Compute Engine VM 使用 Sensitive Data Protection

如要從 VM 執行個體存取 DLP API，請在建立 VM 時，選取「Identity and API Access」(身分和 API 存取權) 區段下方的「Allow full access to all Cloud APIs」(允許所有 Cloud API 的完整存取權)。