檢視次數:
將您的環境設置為使用 Bash (cURL) 或 PowerShell 通過 API 向 伺服器與工作負載保護 發送 HTTP 請求。
注意
注意
在執行任何其他食譜之前，請先完成此食譜。

Bash 還是 PowerShell？ 上層主題

如果您是腳本編寫的新手，可能對這些工具不熟悉，這沒關係。您的作業系統決定您將使用哪一個：
  • Windows: PowerShell
  • Mac or Linux: Bash
如果您使用的是 Windows，您可以暫不處理有關 Bash（和 cURL）的信息。相反，如果您將使用 Bash，您可以暫不處理所有有關 PowerShell 的信息。

檢查您的環境 上層主題

檢查您是否可以訪問 伺服器與工作負載保護 並且已安裝所需的軟體。您將檢查您的軟體版本，以確保其支援 伺服器與工作負載保護 用於保護 HTTPS 連接的 TLS 1.2。

檢查您與伺服器與工作負載保護的連線 上層主題

使用您的網頁瀏覽器導航至 伺服器與工作負載保護 https://cloudone.trendmicro.com：
  • 如果頁面打開，則表示您擁有所需的網路存取權限
  • 如果您無法打開該頁面，請檢查您是否有網路連線以及您的 URL 是否正確

檢查您的 cURL 軟體（適用於 Bash） 上層主題

如果您想使用 Bash（通常是 Linux 或 Mac 用戶），請檢查已安裝的 cURL 和 OpenSSL 或 NSS 或 LibreSSL 的版本。打開終端或您偏好的命令行工具，並輸入以下命令：
curl --version
  • 請確保您擁有 cURL 7.34.0 或更高版本
  • 在輸出中找到以下其中一個庫：
    • OpenSSL 1.01 或更高版本（建議使用 1.02）
    • 網路安全服務 (NSS) 3.15.1 或更高版本
    • LibreSSL 2.1.4 或更高版本
    • 一個不同的函式庫，用於保護網路通訊並支援 TLS 1.2
如果任何所需的軟體未安裝或版本過舊，請參閱您作業系統的文件以獲取有關安裝或升級的資訊。

檢查您的 PowerShell 軟體 上層主題

如果您想使用 PowerShell（Windows），請檢查已安裝的 PowerShell 和 .NET Framework 版本。

步驟

  1. 要檢查您的 PowerShell 版本是否為 3.0 或更高版本，請打開 PowerShell，輸入以下命令，並檢查 PSVersion 的值是否為 3.0 或更高：
    $psversiontable
  2. 要檢查您的 .NET Framework 版本是否為 4.5 或更高版本，請輸入以下命令以從註冊表中返回版本：
    (Get-Childitem 'HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full').GetValue("Version")

接下來需執行的動作

如果未安裝 PowerShell 或 .NET Framework，或版本過舊，請參閱您的 Windows 文件以獲取有關安裝或升級的資訊。

建立 API 金鑰 上層主題

建立 API 金鑰以驗證您的 API 呼叫。當您建立金鑰時，會顯示一個金鑰密碼，您必須儲存以供日後使用。
注意
注意
以安全的方式存儲密鑰秘密，並且不要分享。
如果您不確定自己是使用新帳戶還是舊帳戶，請參閱 Trend Micro Cloud One 帳戶的變更。

測試您的設置 上層主題

Bash 上層主題

步驟

  1. 打開終端機或您偏好的命令行工具。
  2. 輸入以下命令以儲存有關您請求的詳細資訊，將 <YOUR URL> 替換為 y伺服器與工作負載保護 的 URL，並將 <YOUR SECRET KEY> 替換為您 API 金鑰中的密鑰：
    • url=<您的 URL>
      例如，url=https://cloudone.trendmicro.com
    • secret=<您的秘密金鑰>
      例如，secret=5C58EADA-04BC-4ABC-45CF-B72925A0B674:aFBgpPV8eJQGaY2Dk0LmyQMD7nUGvyIDfIbIQo8Zgm8=
  3. 輸入以下命令以發送請求：
    curl -X GET $url/api/apikeys -H "api-secret-key: $secret" -H "api-version: v1" -s -w "\n\nresponse code: %{response_code}\n"
  4. 如果回應以response code: 200結束，則表示您的呼叫成功且您的設置已驗證。

接下來需執行的動作

PowerShell 上層主題

步驟

  1. 開啟 PowerShell。
  2. 輸入以下命令以使用 TLS 1.2：
    [Net.ServicePointManager]::SecurityProtocol += [Net.SecurityProtocolType]::Tls12
  3. 輸入以下命令來儲存有關您請求的詳細資訊，將 <YOUR URL> 替換為 伺服器與工作負載保護 的 URL，並將 <YOUR SECRET KEY> 替換為您 API 金鑰的密鑰：
    • $url = "_<您的 URL>_" 例如，url=https://cloudone.trendmicro.com
    • $secret = "_<您的 API 金鑰 秘密>_" 例如，$secret="5C58EADA-04BC-4ABC-45CF-B72725A0B674:aFBgpPV8eJQGaY2Dk0LmyQMD7nUGvyIDfIbIQo8Zgm8="
    • $headers = @{'api-version' = "v1"; 'api-secret-key' = $secret}
  4. 輸入以下命令以發送請求：Invoke-WebRequest "$url/api/apikeys" -Headers $headers
  5. 如果出現的回應包括 StatusCode : 200，則表示您的呼叫成功且您的設置已驗證。
    秘訣
    秘訣
    如果您收到錯誤訊息 The underlying connection was closed: An unexpected error occurred on a send，請關閉 PowerShell，重新打開 PowerShell，並嘗試重複測試。

接下來需執行的動作

最終意見 上層主題

在您成功向伺服器與工作負載保護發送請求以驗證您的設置後，您就可以使用其他食譜了。

Related resources 上層主題