Ansichten:
Richten Sie Ihre Umgebung ein, um Bash (cURL) oder PowerShell zu verwenden, um HTTP-Anfragen an Server- und Workload Protection über die API zu senden.
Hinweis
Hinweis
Schließen Sie dieses Rezept ab, bevor Sie andere Kochbuchrezepte ausführen.

Bash oder PowerShell? Übergeordnetes Thema

Wenn Sie neu im Skripten sind, sind Ihnen diese Tools möglicherweise nicht vertraut, was in Ordnung ist. Ihr Betriebssystem bestimmt, welches Sie verwenden werden:
  • Windows: PowerShell
  • Mac or Linux: Bash
Wenn Sie Windows verwenden, können Sie die Informationen über Bash (und cURL) ignorieren. Umgekehrt, wenn Sie Bash verwenden, können Sie alle Informationen über PowerShell ignorieren.

Überprüfen Sie Ihre Umgebung Übergeordnetes Thema

Überprüfen Sie, ob Sie auf Server- und Workload Protection zugreifen können und ob die erforderliche Software installiert ist. Sie werden die Version Ihrer Software überprüfen, um sicherzustellen, dass sie TLS 1.2 unterstützt, das Server- und Workload Protection für die Sicherung von HTTPS-Verbindungen verwendet.

Überprüfen Sie Ihre Verbindung zu Server- und Workload Protection Übergeordnetes Thema

Verwenden Sie Ihren Webbrowser, um zu Server- und Workload Protection https://cloudone.trendmicro.com zu navigieren:
  • Wenn die Seite geöffnet wird, haben Sie den erforderlichen Netzwerkzugriff
  • Wenn Sie die Seite nicht öffnen können, überprüfen Sie, ob Sie eine Netzwerkverbindung haben und ob Ihre URL korrekt ist

Überprüfen Sie Ihre cURL-Software (für Bash) Übergeordnetes Thema

Wenn Sie Bash verwenden möchten (typischerweise Linux- oder Mac-Benutzer), überprüfen Sie die Version von cURL und OpenSSL oder NSS oder LibreSSL, die installiert sind. Öffnen Sie das Terminal oder Ihr bevorzugtes Befehlszeilenwerkzeug und geben Sie den folgenden Befehl ein:
curl --version
  • Stellen Sie sicher, dass Sie cURL 7.34.0 oder höher haben
  • Suchen Sie eine der folgenden Bibliotheken im Output:
    • OpenSSL 1.01 oder höher (1.02 empfohlen)
    • Netzwerksicherheitsdienste (NSS) 3.15.1 oder später
    • LibreSSL 2.1.4 oder höher
    • Eine andere Bibliothek, die Netzwerkkommunikation sichert und TLS 1.2 unterstützt
Falls eine der erforderlichen Softwarekomponenten nicht installiert oder zu alt ist, konsultieren Sie die Dokumentation Ihres Betriebssystems, um Informationen zur Installation oder Aktualisierung zu erhalten.

Überprüfen Sie Ihre PowerShell-Software Übergeordnetes Thema

Wenn Sie PowerShell (Windows) verwenden möchten, überprüfen Sie die installierte Version von PowerShell und .NET Framework.

Prozedur

  1. Um zu überprüfen, ob Ihre Version von PowerShell 3.0 oder höher ist, öffnen Sie PowerShell, geben Sie den folgenden Befehl ein und überprüfen Sie, ob der Wert von PSVersion 3.0 oder höher ist:
    $psversiontable
  2. Um zu überprüfen, ob Ihre Version des .NET Framework 4.5 oder höher ist, geben Sie den folgenden Befehl ein, der die Version aus der Registrierung zurückgibt:
    (Get-Childitem 'HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full').GetValue("Version")

Nächste Schritte

Wenn PowerShell oder das .NET Framework nicht installiert oder zu alt ist, konsultieren Sie Ihre Windows-Dokumentation, um Informationen zur Installation oder Aktualisierung zu erhalten.

Erstellen eines API-Schlüssels Übergeordnetes Thema

Erstellen Sie einen API-Schlüssel zur Authentifizierung Ihrer API-Aufrufe. Wenn Sie den Schlüssel erstellen, wird ein geheimer Schlüssel angezeigt, den Sie für die spätere Verwendung speichern müssen.
Hinweis
Hinweis
Speichern Sie den geheimen Schlüssel auf sichere Weise und teilen Sie ihn nicht.
Wenn Sie sich nicht sicher sind, ob Sie ein neues Konto oder ein Legacy-Konto verwenden, sehen Sie unter Änderungen an Trend Micro Cloud One-Konten nach.

Testen Sie Ihre Einrichtung Übergeordnetes Thema

Bash Übergeordnetes Thema

Prozedur

  1. Öffnen Sie das Terminal oder Ihr bevorzugtes Befehlszeilenwerkzeug.
  2. Geben Sie die folgenden Befehle ein, um Details zu Ihrer Anfrage zu speichern, wobei Sie <YOUR URL> durch die URL von yServer- und Workload Protection und <YOUR SECRET KEY> durch das Geheimnis Ihres API-Schlüssels ersetzen:
    • url=<YOUR URL>
      zum Beispiel, url=https://cloudone.trendmicro.com
    • secret=<YOUR SECRET KEY>
      zum Beispiel, secret=5C58EADA-04BC-4ABC-45CF-B72925A0B674:aFBgpPV8eJQGaY2Dk0LmyQMD7nUGvyIDfIbIQo8Zgm8=
  3. Geben Sie folgenden Befehl ein, um die Anfrage zu senden:
    curl -X GET $url/api/apikeys -H "api-secret-key: $secret" -H "api-version: v1" -s -w "\n\nresponse code: %{response_code}\n"
  4. Wenn die Antwort mit response code: 200 endet, war Ihr Anruf erfolgreich und Ihre Einrichtung ist validiert.

Nächste Schritte

PowerShell Übergeordnetes Thema

Prozedur

  1. PowerShell öffnen.
  2. Geben Sie folgenden Befehl ein, um TLS 1.2 zu verwenden:
    [Net.ServicePointManager]::SecurityProtocol += [Net.SecurityProtocolType]::Tls12
  3. Geben Sie die folgenden Befehle ein, um Details zu Ihrer Anfrage zu speichern. Ersetzen Sie dabei <YOUR URL> durch die URL von Server- und Workload Protection und <YOUR SECRET KEY> durch das Geheimnis Ihres API-Schlüssels:
    • $url = "_<YOUR URL>_" zum Beispiel, url=https://cloudone.trendmicro.com
    • $secret = "_<YOUR API KEY SECRET>_" zum Beispiel, $secret="5C58EADA-04BC-4ABC-45CF-B72725A0B674:aFBgpPV8eJQGaY2Dk0LmyQMD7nUGvyIDfIbIQo8Zgm8="
    • $headers = @{'api-version' = "v1"; 'api-secret-key' = $secret}
  4. Geben Sie den folgenden Befehl ein, um die Anfrage zu senden: Invoke-WebRequest "$url/api/apikeys" -Headers $headers
  5. Wenn die Antwort, die erscheint, StatusCode : 200 enthält, war Ihr Anruf erfolgreich und Ihre Einrichtung ist validiert.
    Tipp
    Tipp
    Wenn Sie die Fehlermeldung The underlying connection was closed: An unexpected error occurred on a send erhalten, schließen Sie PowerShell, öffnen Sie PowerShell erneut und versuchen Sie, den Test zu wiederholen.

Nächste Schritte

Abschließende Kommentare Übergeordnetes Thema

Nachdem Sie erfolgreich eine Anfrage an Server- und Workload Protection gesendet haben, um Ihre Einrichtung zu validieren, können Sie die anderen Kochbuchrezepte verwenden.