Wie übernehme ich gefundene Geräte in den Bestand?

Ab Tarif Pro

Kurzantwort

Nach einem Scan listet Notory die erreichbaren Hosts als entdeckte Geräte (Status Neu). In der Liste Entdeckte Geräte übernimmst du ein Gerät mit Importieren in den Bestand (dabei entsteht ein Asset) oder blendest es mit Ignorieren aus.

Voraussetzungen

Modul Discovery, ab Tarif Pro. Beim Import greift zusätzlich das Asset-Limit deiner Lizenz.

Entdeckte Geräte öffnen. Wähle im Modul Discovery einen abgeschlossenen Scan und dann Geräte anzeigen, oder öffne über Alle anzeigen sämtliche entdeckten Geräte. Die Tabelle zeigt IP-Adresse, Hostname, Offene Ports und OS (Vermutung).

Screenshot ausstehend discovery-geraete-01 Tabelle 'Entdeckte Geräte' mit IP, Hostname, offenen Ports und den Aktionen Importieren und Ignorieren

Die Liste entdeckter Geräte mit den Aktionen 'Importieren' und 'Ignorieren'.
Übernehmen oder ignorieren.
- Importieren: legt ein Asset an (Standardtyp Hardware; Name aus Hostname bzw. IP). Das Gerät wechselt auf Status Importiert.
- Ignorieren: markiert das Gerät als Ignoriert, ohne ein Asset anzulegen.
Ergebnis prüfen. Importierte Geräte findest du sofort unter Assets; IP, MAC, offene Ports und OS-Vermutung landen in den Zusatzfeldern des Assets.

Die entdeckten Geräte holst du per GET /api/v1/discovery/devices (optional gefiltert nach scan_job_id oder status):

curl -H "Authorization: Bearer inv_dein_token" \
  "https://demo.notory.io/api/v1/discovery/devices?status=new"

Ein Gerät übernimmst du per POST /api/v1/discovery/devices/{id}/import. Alle Felder sind optional. Ohne Angabe gilt asset_type = hardware und der Name kommt aus Hostname/IP:

curl -X POST https://demo.notory.io/api/v1/discovery/devices/0190f3c1-2e20-7b30-ac40-3d50e60f7a80/import \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "srv-web-01",
    "asset_type": "hardware",
    "location": "Hauptsitz Muenchen / RZ-1",
    "department": "IT-Betrieb"
  }'

{
  "id": "0190f3c1-2e20-7b30-ac40-3d50e60f7a80",
  "scan_job_id": "0190f3c0-1d10-7a20-9b30-2c40d50e6f70",
  "ip_address": "10.0.0.20",
  "hostname": "srv-web-01",
  "mac_address": null,
  "open_ports": [22, 80, 443],
  "os_guess": "Linux/Unix",
  "status": "imported",
  "asset_id": "0190f3c2-3f30-7c40-bd50-4e60f70a8b90",
  "created_at": "2026-07-08T10:35:00Z"
}

Zum Ausblenden dient POST /api/v1/discovery/devices/{id}/ignore (setzt den Status auf ignored).

Mögliche Fehler: 401, 403 (kein Schreibrecht oder Asset-Limit der Lizenz erreicht), 404 (Gerät nicht gefunden), 409 (Gerät bereits importiert).

Was passiert dabei?

Asset-Anlage beim Import: Notory erzeugt ein Asset mit Status Aktiv, dem Namen aus deiner Angabe bzw. Hostname/IP und der Notiz „Imported from network discovery”. IP, MAC, offene Ports und die OS-Vermutung werden als Zusatzfelder (custom_fields) übernommen; du wirst als Ersteller vermerkt.
Lizenz-Prüfung (Gating): Vor der Anlage prüft Notory das Asset-Limit deiner Lizenz. Ist es erreicht, wird der Import mit 403 abgelehnt.
Doppelte Übernahme verhindert: Ein bereits importiertes Gerät lässt sich nicht erneut importieren. Der zweite Versuch endet mit 409 Conflict. Das Gerät verweist über asset_id dauerhaft auf das erzeugte Asset.
Ignorieren ist reversibel gemeint: „Ignoriert” blendet ein Gerät nur aus der Bearbeitung aus; es wird kein Asset angelegt und nichts gelöscht.