Zum Hauptinhalt springen

Endpunktkonflikte in Level beheben

Fix agent identity conflicts caused by device cloning. Check automatic recovery or rotate the ID on Windows, macOS, and Linux when needed.

Einführung

Wenn Sie ein Gerät klonen, auf dem bereits der Level-Agent installiert ist, teilen sich das Original und der Klon dieselbe Agent-ID. Dies führt zu einem Konflikt: Die beiden Geräte konkurrieren um denselben Eintrag in Level, und eines oder beide zeigen eine unzuverlässige Verbindung. Dieser Artikel erläutert die automatische Identitätswiederherstellung und erklärt, wie die Agent-ID auf dem geklonten Gerät rotiert werden kann, wenn der Konflikt weiterhin besteht.

ℹ️ HINWEIS: Dies betrifft nur geklonte Geräte. Eine Neuinstallation des Agents auf einem vorhandenen Gerät ändert dessen ID nicht. Level behält die ursprüngliche ID auch bei Neuinstallationen bei, um doppelte Einträge zu vermeiden.

ℹ️ HINWEIS: Autopilot-Zurücksetzen und erneutes Registrieren ist ein anderer Fall. Entra-verbundene Autopilot-Geräte mit aktuellen Agents werden über die maschinenweite Entra-Geräte-ID wieder derselben Level-Zeile zugeordnet. Rotieren Sie die Agent-ID nicht, um eine Autopilot-Neuregistrierung zu „beheben". Siehe Installation über Intune unter Windows.


Automatische Identitätswiederherstellung

Bei Agents, die die automatische Identitätswiederherstellung unterstützen, kann Level den meldenden Agent auffordern, seine ID zu ändern, wenn wiederholte Änderungen sowohl am Hostnamen als auch an der Seriennummer unter derselben Agent-Identität erkannt werden. Der Bericht, der die Zurücksetzung auslöst, muss eine Seriennummer enthalten, die von der aktuell gespeicherten abweicht. Eine alleinige Änderung des Hostnamens reicht nicht aus.

Der Agent ersetzt seine gespeicherte ID durch eine zufällige UUID. Wenn er sich mit seinem vorhandenen Installationsschlüssel erfolgreich neu registriert, erscheint er als separater Geräteeintrag im mit diesem Schlüssel verknüpften Arbeitsbereich. Diese Wiederherstellung führt weder eine Zusammenführung noch eine Löschung des vorhandenen Eintrags durch.

Wenn der Installationsschlüssel eine Gruppe angibt, wird der neue Eintrag dieser Gruppe zugewiesen. Die aktuelle Gruppenzuweisung des vorhandenen Eintrags wird nicht übernommen.

Die automatische Wiederherstellung ist nicht für jeden Klon garantiert. Klone, die denselben Hostnamen oder dieselbe Seriennummer melden, erfüllen die Erkennungskriterien möglicherweise nicht. Die Wiederherstellung hängt außerdem davon ab, ob der Agent die Zurücksetzungsanforderung empfängt und seine neue Identität erfolgreich registriert.

Prüfen, ob der Konflikt behoben wurde

  1. Identifizieren Sie das Originalgerät und den Klon anhand ihrer Hostnamen und Hardwaredetails. Öffnen Sie die System Reiter und überprüfen Sie den Seriennummer im System Abschnitt mit dem erwarteten Gerät ab. Siehe Gerätesystem.

  2. Stellen Sie sicher, dass jedes Gerät seinen eigenen Eintrag hat. Überprüfen Sie nachfolgende Berichte, um sicherzustellen, dass Hostname und Seriennummer nicht mehr zwischen Geräten in einem Eintrag wechseln. Ein neuer Eintrag allein beweist nicht, dass beide Geräte korrekt kommunizieren.

  3. Überprüfen Sie Gruppe, Tags und benutzerdefinierte Feldwerte des neuen Eintrags und wenden Sie die erforderlichen Einstellungen an.

Wenn die Geräte weiterhin einen Eintrag teilen oder deren Details ständig wechseln, verwenden Sie die nachstehenden ID-Rotationsverfahren auf dem bestätigten Klon oder wenden Sie sich an den Level-Support. Wenn ein Gerät offline bleibt, folgen Sie auch Fehlerbehebung bei Agent-Problemen anstatt davon auszugehen, dass der Identitätskonflikt die einzige Ursache ist.

Löschen Sie einen Eintrag nicht allein deshalb, weil ein zweiter Eintrag erschienen ist. Bestätigen Sie zuerst, welches Gerät jeder Eintrag repräsentiert.

Die Agent-ID per Befehl rotieren

Bei einem bestätigten Klonkonflikt, der sich nicht selbst behoben hat, --new-agent-id Flag generiert die Identitätskonfiguration des Agents neu und versucht, den Agent-Dienst neu zu starten.

Führen Sie diesen Befehl auf dem geklonten Gerät:

🖥️ PLATTFORMHINWEIS:

  • Windows: & 'C:\Program Files\Level\level.exe' --new-agent-id

  • macOS: sudo /usr/local/bin/level --new-agent-id

  • Linux: sudo /usr/local/bin/level --new-agent-id

Wenn das geklonte Gerät sich mit einer neuen Agent-ID registriert, erscheint es als separater Eintrag in Level. Verwenden Sie die oben beschriebenen Wiederherstellungsprüfungen, um das Ergebnis zu überprüfen.

Auf Entra-verbundenen Windows-Geräten kann dieser Befehl die maschinenweite Entra-Geräte-ID wiederverwenden. Wenn die Einträge weiterhin in Konflikt stehen, verwenden Sie das manuelle Verfahren unten oder wenden Sie sich an den Level-Support.

Die Agent-ID manuell rotieren

Wenn Sie die Agent-Binärdatei nicht direkt ausführen können (z. B. weil der Agent gestoppt ist oder die Binärdatei nicht zugänglich ist), können Sie die ID direkt in der Konfiguration bearbeiten.

⚠️ WARNUNG: Setzen Sie den Wert auf eine gültige UUID v4 (zufällig generiert). Verwenden Sie keine ID von einem anderen Gerät und lassen Sie das Feld nicht leer. Starten Sie nach der Bearbeitung den Level-Dienst neu, damit die Änderung wirksam wird.

🖥️ PLATTFORMHINWEIS:

  • Windows, Registrierungsschlüssel:

    • Pfad: HKEY_LOCAL_MACHINE\SOFTWARE\Level

    • Schlüsselname: AgentID

    • Ändern Sie den Wert in eine neue UUID.

  • macOS, Konfigurationsdatei:

    • Pfad: /Library/Application Support/Level/config.yaml

    • Schlüsselname: agent-id

    • Ersetzen Sie den vorhandenen Wert durch eine neue UUID.

  • Linux, Konfigurationsdatei:

    • Pfad: /etc/level/config.yaml

    • Schlüsselname: agent-id

    • Ersetzen Sie den vorhandenen Wert durch eine neue UUID.

Starten Sie nach der Bearbeitung den Level-Dienst neu:

🖥️ PLATTFORMHINWEIS:

  • Windows: Restart-Service -Name Level

  • macOS: sudo launchctl kickstart -k system/Level

  • Linux: systemctl restart Level

Zukünftige Konflikte vermeiden

Zwei Optionen für auf Klonen basierte Bereitstellungsworkflows:

Option 1: UUID nach dem Klonen rotieren (empfohlen): Behalten Sie den Agent in Ihrem Master-Image und führen Sie --new-agent-id als Teil Ihres Bereitstellungsschritts nach dem Klonen (über MDM, Startskript oder RMM). Integrieren Sie die oben beschriebenen Wiederherstellungsprüfungen in Ihren Bereitstellungsprozess, um zu überprüfen, ob jeder Klon separat registriert wird.

Option 2: Vor dem Erstellen des Images deinstallieren: Entfernen Sie den Level-Agent, bevor Sie das Master-Image erstellen, und installieren Sie Level dann als Schritt nach dem Klonen. Jedes Gerät erhält eine neue Agent-ID aus der Installation.

💡 TIPP: Die Level-Installationsanleitungen für Windows, macOS und Linux enthalten Befehle zur automatischen Installation, die für Bereitstellungsskripte und MDM-Workflows nach dem Klonen geeignet sind.


Häufig gestellte Fragen

  • Auf welchem Gerät soll ich --new-agent-id ausführen, auf dem Original oder dem Klon? Führen Sie es auf dem Klon aus, nachdem Sie bestätigt haben, welches Gerät der Klon ist. Rotieren Sie die ID des Originalgeräts nicht als allgemeinen Bereinigungsschritt.

  • Übernimmt das geklonte Gerät nach der Rotation der ID die Gruppen, Tags und benutzerdefinierten Felder des Originals? Es wird als neues Gerät registriert, anstatt den ursprünglichen Eintrag zu kopieren. Wenn der Installationsschlüssel eine Gruppe angibt, weist Level es dieser Gruppe zu. Überprüfen Sie nach der Registrierung die Gruppe, Tags und benutzerdefinierten Feldwerte des neuen Eintrags.

  • Kann ich --new-agent-id über Level übertragen, wenn beide Geräte sporadisch erscheinen? Dies ist unzuverlässig, wenn zwei Geräte um dieselbe ID konkurrieren. Lokaler Zugriff oder ein anderes Remote-Werkzeug ist sicherer. Verwenden Sie nach der Rotation die oben beschriebenen Wiederherstellungsprüfungen, um separate Registrierungen und Verbindungen zu überprüfen.

  • Wie generiere ich eine gültige UUID für eine manuelle ID-Rotation? Unter Windows: [guid]::NewGuid().ToString() in PowerShell. Unter macOS/Linux: uuidgen. Beide erzeugen eine gültige UUID v4.

  • Mein Autopilot-Gerät hat nach einem Zurücksetzen eine zweite Zeile erstellt. Soll ich die Agent-ID rotieren? Nein. Dieser Artikel gilt für geklonte Geräte, die eine Agent-ID teilen. Autopilot-Zurücksetzen und erneutes Registrieren verwendet eine andere Identität. Siehe Installation über Intune unter Windows.

Hat dies deine Frage beantwortet?