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

Bash 還是 PowerShell？ 上層主題

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

檢查您的環境 上層主題

檢查您是否可以訪問 Server & Workload Security保護 並且已安裝所需的軟體。您將檢查您的軟體版本，以確保其支援 Server & Workload Security保護 用於保護 HTTPS 連接的 TLS 1.2。

檢查您與Server & Workload Security保護的連線 上層主題

使用您的網頁瀏覽器導航至 Server & Workload Security保護 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> 替換為 yServer & Workload Security保護 的 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> 替換為 Server & Workload Security保護 的 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，並嘗試重複測試。

接下來需執行的動作

最終意見 上層主題

在您成功向Server & Workload Security保護發送請求以驗證您的設置後，您就可以使用其他食譜了。

Related resources 上層主題