Sie sind bereits NinjaOne-Kunde? Melden Sie sich an, um weitere Leitfäden und die neuesten Updates zu sehen.

SentinelOne-API-Token verstehen

Thema

Dieser Artikel beschreibt deren Eigenschaften und erklärt, wie man sie generiert.

Informationen dazu, wie Sie SentinelOne in der NinjaOne-Konsole aktivieren, finden Sie im „SentinelOne: Integrationshandbuch“.

Umgebung

  • NinjaOne-Integrationen
  • SentinelOne 

Beschreibung

SentinelOne verwendet Token für den Zugriff auf die API-Verwaltungskonsole (Application Programming Interface). Sie können Token auch nutzen, um die SentinelOne-Integration mit NinjaOne zu aktivieren. Wählen Sie ein Thema aus, um fortzufahren.

Informationen zu API-Tokens in SentinelOne

Voraussetzungen

Die Zugriffsebene „Account scope“ muss für den SentinelOne-Benutzer im Bereich „Scope of Access“ aktiviert sein. Weitere Anforderungen an den Zugriffsbereich finden Sie im SentinelOne: Integration Guide – NinjaOne Dojo.

Eigenschaften von SentinelOne-API-Tokens

Benutzer benötigen ein Token, um auf die API-Verwaltungskonsole zugreifen zu können. Bei der Bereitstellung von Tokens für SentinelOne sind mehrere Punkte zu beachten:

  • Ein SentinelOne-Benutzer kann nur über ein Token verfügen.
  • Sie können die Verlängerung dieses Tokens automatisieren. Wir empfehlen die Verwendung einer beliebigen Rolle, die Optionen zur Verlängerung der 30-tägigen Gültigkeitsdauer unterstützt.
  • Das API-Token ist für die Nutzung von Skripten erforderlich.
  • Das API-Token umgeht die Zwei-Faktor-Authentifizierung (2FA).
  • Sie sind für die Sicherheit des API-Tokens verantwortlich.
  • Sie können das Token über die SentinelOne-Konsole (diese Optionen finden Sie nach der Generierung Ihres Tokens unter „Benutzerdetails“ ) oder über die API widerrufen oder neu generieren.
Wenn Sie die Erneuerung des Tokens und die Verlängerungsoptionen lieber automatisieren möchten, können Sie einen Service-Benutzer anlegen. Eine Anleitung dazu finden Sie unter https://{Ihr Domainname}.sentinelone.net/docs/en/creating-service-users.html.

Bewährte Verfahren für API-Token

Beachten Sie die folgenden Best Practices, um die Sicherheit und Leistung Ihrer API-Integration zu gewährleisten:

  • Speichern Sie das heruntergeladene API-Token in der Datei oder an dem Speicherort, den Ihre API-Anfragen verwenden.
  • Um Skripte gemeinsam zu nutzen, sollte jeder Benutzer sein API-Token unter demselben Pfadnamen speichern.
  • Schützen Sie die API-Token-Datei vor versehentlichem Verlust oder böswilliger Manipulation.

API-Token generieren

Jeder NinjaOne-Benutzer kann nur ein Token generieren, das 30 Tage lang gültig bleibt. Führen Sie dazu den folgenden Arbeitsablauf durch.

Bevor Sie beginnen: Um einen API-Token zu generieren, müssen Benutzer über Administratorrechte in SentinelOne verfügen. Weitere Informationen zur Vergabe dieser Rechte finden Sie unter https://{Ihr Domainname}.sentinelone.net/docs/en/control-api-token-generation.html.
  1. Melden Sie sich bei Ihrer SentinelOne-Web-Verwaltungskonsole an.
  2. Klicken Sie im oberen Navigationsmenü auf das Dropdown-Menü „Kontoname“ und wählen Sie „Mein Benutzer“ aus.

Abbildung 1: Kontoname → „Mein Benutzer“ (zum Vergrößern anklicken)

  1. Klicken Sie im sich öffnenden Benutzerdetailfenster auf die Schaltfläche „Aktionen “.
  2. Navigieren Sie im Dropdown-Menü „Aktionen “ zu „API-Token-Vorgänge“.
  3. Wenn Sie zum ersten Mal ein Token für dieses Konto generieren, wählen Sie „API-Token generieren“. Wenn Sie ein neues Token für den Benutzer generieren, wählen Sie „API-Token neu generieren“.

Abbildung 2: „Aktionen“ → „API-Token-Vorgänge“ → „API-Token generieren“

  1. SentinelOne generiert ein neues API-Token und zeigt es in einem Fenster zur einmaligen Verwendung an.

Abbildung 3: „Aktionen“ → „API-Token-Vorgänge“ → „API-Token generieren“

  1. Kopieren Sie den Wert des API-Tokens in die Zwischenablage Ihres Computers.
Vergewissern Sie sich, dass Sie den Token-Wert erfolgreich kopiert haben, bevor Sie das Fenster schließen. Sobald Sie das Fenster „API-Token“ schließen, können Sie den Wert nicht mehr einsehen.
  1. Klicken Sie auf„Schließen“.
  2. Navigieren Sie in NinjaOne zu „Administration“ → „Apps“ → „Installiert“ → „SentinelOne“ → „Allgemein“.
  3. Klicken Sie in der Kategorie„Einstellungen “ auf„Bearbeiten“.
  4. Fügen Sie den kopierten Wert in das Feld „API-Token“ ein.
  5. Klicken Sie auf„Speichern“.

edit sentinelone settings.png

Abbildung 4: SentinelOne-Einstellungen bearbeiten

API-Token-Status und Neusynchronisierung

Der Abschnitt „Synchronisationsstatus“ der SentinelOne-App in Ihrer NinjaOne-Instanz zeigt den Synchronisationsstatus der Integration an. Wenn das Authentifizierungstoken ungültig ist, wird im Feld „Sync-Status“ der Wert „Unbekannt“ angezeigt, auch wenn unter „Einstellungen“ → „Status“ der Status „Verbunden“ angezeigt wird.

Abbildung 5: Synchronisationsstatus (zum Vergrößern anklicken)

Bei erfolgreicher Synchronisierung wird im Feld „Sync-Status“ der Wert „Abruf abgeschlossen“ angezeigt. Außerdem werden Datum und Uhrzeit der letzten versuchten und erfolgreichen Synchronisierungen angezeigt.

Abbildung 6: Synchronisationsstatus

Die Integration führt alle fünf Minuten bis zu sechs Synchronisierungen durch. Im Falle eines Fehlers erscheint die in Abbildung 7 gezeigte Schaltfläche „Neu synchronisieren“ im Abschnitt „Synchronisationsstatus“ der SentinelOne-Integrations-App von NinjaOne.

Wenn ein anderer Status als „Abruf abgeschlossen“ angezeigt wird, klicken Sie auf die Schaltfläche, um den API-Poller zurückzusetzen und einen weiteren Synchronisierungsversuch zu starten.

Abbildung 7: „Re-sync“ (zum Vergrößern anklicken)

Benachrichtigungen zum Ablauf und zur Erneuerung von API-Token

NinjaOne versucht automatisch, Token zu erneuern. Nach der Generierung des ursprünglichen Tokens können Sie Benachrichtigungen einrichten, die Sie auf Fehlschläge bei der automatischen Erneuerung hinweisen, die zum Ablauf des Tokens führen und eine manuelle Erneuerung erforderlich machen.

Führen Sie dazu die folgenden Schritte aus:

  1. Navigieren Sie in NinjaOne zu „Administration“ → „Allgemein “ → „Aktivitäten“.
  2. Suchen Sie die Aktivitäten für SentinelOne.
  3. Aktivieren Sie die Benachrichtigungen, die Sie erhalten möchten. Wenn eine Neusynchronisierung erforderlich ist und fehlschlägt, bricht die Integration ab; wir empfehlen, mindestens die Optionen „Neusynchronisierung der Integration erforderlich“ und „Integration deaktiviert“ zu aktivieren, um sicherzustellen, dass Sie stets über kritische Dienstunterbrechungen informiert sind.

Abbildung 8: „Administration“ → „Allgemein“ → „Aktivitäten“ (zum Vergrößern anklicken)

  1. Sie können den Synchronisierungsstatus jederzeit in NinjaOne überprüfen, indem Sie zu „Administration“ → „Apps“ → „Installiert“ → „SentinelOne“ → „Allgemein“ navigieren.

Abbildung 9: Synchronisationsstatus (zum Vergrößern anklicken)

Weitere Ressourcen

Weitere Hilfe zur Integration in NinjaOne finden Sie in den folgenden Ressourcen:

FAQ

Nächste Schritte