Ansichten:
Sie können die API verwenden, um Computer zu Server- und Workload Protection hinzuzufügen, als Teil des Prozesses zum Schutz neuer Assets.
Tipp
Tipp
Bevor Sie die API verwenden, sollten Sie die folgenden Arten von geplanten Aufgaben in Betracht ziehen, um Computer automatisch zu entdecken und hinzuzufügen:
  • Computer entdecken
  • Cloud-Konto synchronisieren
  • Verzeichnis synchronisieren
  • Synchronisieren Sie VMware vCenter
Für weitere Informationen siehe Schutz mit geplanten Aufgaben aufrechterhalten oder Server- und Workload Protection planen, um Aufgaben auszuführen.
Verwenden Sie das folgende allgemeine Verfahren, um einen Computer hinzuzufügen:

Prozedur

  1. Erstellen Sie ein Computer-Objekt und legen Sie den Hostnamen fest. Der Hostname ist die einzige erforderliche Eigenschaft. Der Wert muss der Hostname oder die IP-Adresse sein, die auf den Computer verweist.
    computer = api.Computer()
computer.host_name = hostname
  2. Konfigurieren Sie alle anderen Eigenschaften nach Wunsch. Siehe die Create a Computer-Operation im API-Referenzhandbuch für die verfügbaren Eigenschaften.
  3. Erstellen Sie ein ComputersApi-Objekt und verwenden Sie es, um den Computer auf Server- und Workload Protection zu erstellen.
    computers_api = api.ComputersApi(api.ApiClient(configuration))
new_computer = computers_api.create_computer(computer, api_version)
    Um die konfigurierbaren Eigenschaften zu sehen, lesen Sie die Create a Computer-Operation im API-Referenzhandbuch.
    Tipp
    Tipp
    Sie können auch die Server- und Workload Protection-Konsole verwenden, um eine Aufgabe zu erstellen, die Computer automatisch konfiguriert, wenn sie hinzugefügt werden. Siehe Automatische Aufgaben ausführen, wenn ein Computer hinzugefügt oder geändert wird.
    Tipp
    Tipp
    Sie können die Legacy-REST-API verwenden, um das Relay auf einem Computer zu aktivieren, auf dem ein aktivierter Agent läuft. Das Deep Security Git-Repository enthält Skripte, die diese Aufgabe erledigen:
    Weitere Informationen finden Sie unter Sicherheits- und Software-Updates mit Relays verteilen.

Nächste Schritte

Quelle anzeigen
# Create the computer object
computer = api.Computer()
computer.host_name = hostname

# Add the computer to Server- und Workload Protection
computers_api = api.ComputersApi(api.ApiClient(configuration))
new_computer = computers_api.create_computer(computer, api_version)
return new_computer.id