SXAccessSXAccessDoku
Dashboard öffnen

Geräte

Jede registrierte Maschine, was ihre Seite zeigt und was Sie daran ändern können.

Ein Gerät entsteht, wenn eine Maschine registriert wird, entweder durch die Anmeldung einer Person auf ihr oder mit einem Registrierungsschlüssel. Der Eintrag enthält den öffentlichen Schlüssel der Maschine, ihre Overlay-Adresse, ihre Gruppen und den Zeitpunkt, zu dem sie zuletzt verbunden war. Jedes Gerät gehört außerdem zur eingebauten Gruppe All, die es nie verlassen kann.

Das Dashboard führt die Geräte unter Devices auf. Wählen Sie eines aus, um seine Seite zu öffnen. Eine Maschine, die mehreren Organisationen beitritt, ist in jeder ein eigenes Gerät, mit eigener Adresse und eigenen Gruppen; siehe Organisationen anlegen und wechseln.

Die Geräteliste im SXAccess-Dashboard mit Overlay-Adresse, Gruppen, Zeitpunkt der letzten Verbindung und Betriebssystem je Gerät.
Ein neu registriertes Gerät erscheint binnen Sekunden - mit seiner Adresse und den Gruppen, denen es zugeordnet wurde.

Was die Seite eines Geräts zeigt

FeldBedeutung
NameStandardmäßig der Hostname der Maschine. Umbenennen können Sie das Gerät mit dem Stiftsymbol neben dem Namen. Der neue Name wird zugleich zum DNS-Label des Geräts; nutzt bereits ein anderes Gerät dieses Label, hängt SXAccess die letzten beiden Zahlen der Adresse dieses Geräts an, etwa build-12-34
EmailDas Mitglied, das das Gerät per Anmeldung registriert hat. Ein mit Schlüssel registriertes Gerät hat keinen Eigentümer
AddressDie bei der Registrierung vergebene Overlay-Adresse. Sie bleibt gleich, solange das Gerät existiert. Die Apps für macOS, Windows und Android zeigen sie als Tunnel address, die iOS-App als IP address. Siehe Overlay-Adressen
DomainDer vollständige DNS-Name des Geräts in Ihrer Organisation, dazu zusätzliche DNS-Labels, die sein Registrierungsschlüssel erlaubt hat
Public IP, RegionVon wo aus sich das Gerät zuletzt verbunden hat. Die Prüfung Country & Region einer Geräteanforderung verwendet diesen Standort
Operating system, Agent versionVom Gerät selbst gemeldet. Agent version ist der Wert, den die Prüfung SXAccess Client Version vergleicht
Last seenWann das Gerät zuletzt mit dem SXAccess-Dienst verbunden war; solange es verbunden ist, steht hier Just now
Assigned groupsDie Gruppen, die jede Zugriffsentscheidung für dieses Gerät steuern. Ändern Sie sie hier und wählen Sie Save changes. All steht ebenfalls in der Liste, lässt sich aber nicht entfernen, weil jedes Gerät immer dazugehört. Ein Gerät ohne weitere Gruppe wird nur von Zugriffsregeln erfasst, die für All geschrieben sind
SSH AccessSchaltet den eingebauten SSH-Server des Geräts ein. Siehe SSH-Zugriff
Die Seite eines Geräts mit Adressen, Betriebssystem, zugewiesenen Gruppen, Sitzungsablauf und SSH-Schalter.
Die Seite eines Geräts: wo es sich befindet, zu welchen Gruppen es gehört und welche Schalter dafür gelten.

Erreichbare Geräte und Routen

Unter den Details hat die Seite eines Geräts zwei Reiter:

  • Accessible devices listet jedes Gerät, das eine Zugriffsregel mit diesem verbindet, gleich in welcher Richtung, einschließlich der Routing-Geräte, über die es Netzwerkressourcen erreicht. Der Reiter beantwortet die Frage „Mit welchen Geräten kann diese Maschine kommunizieren?“, ohne dass Sie jede Regel lesen müssen.
  • Routes listet die Routen, die dieses Gerät als Routing-Gerät bedient. Add Route veröffentlicht darüber einen Netzbereich, Make this an Internet gateway leitet den Internetverkehr anderer Geräte darüber. Um ein privates Netz zu erreichen, ist Netzwerke und Ressourcen meist das bessere Werkzeug; wann eine Route passt, erklären Private Netze routen und Internet-Gateways.

Viele Geräte auf einmal ändern

Wenn Sie Geräte in der Liste ankreuzen, erscheint am unteren Rand der Seite eine Leiste. Die Auswahl umfasst die Geräte auf der Seite der Liste, die Sie gerade sehen.

  • Assign Groups fügt jedem ausgewählten Gerät die gewählten Gruppen hinzu. Mit Overwrite Existing Groups ersetzen Sie stattdessen deren bisherige Gruppen. All bleibt immer unberührt.
  • Delete All löscht nach einer Rückfrage jedes ausgewählte Gerät.

Ein Gerät löschen

Delete auf der Seite eines Geräts entfernt das Gerät und trennt die Maschine sofort. Um zurückzukommen, muss sich die Maschine neu registrieren: mit einem noch gültigen Registrierungsschlüssel (ein Einmalschlüssel ist bereits verbraucht) oder indem sich jemand auf ihr anmeldet. Die Maschine erscheint dann als neues Gerät, mit einer neuen, zufällig gewählten Adresse und nur mit den Gruppen, die ihr Schlüssel oder ihr Mitglied zuweist.

Einen Schalter, der ein einzelnes Gerät sperrt, gibt es nicht. Damit sich ein Gerät erneut anmelden muss, löschen Sie es oder sperren das Mitglied, das es registriert hat: Block user im Reiter Profile des Mitglieds lässt sofort jedes Gerät ablaufen, das es per Anmeldung registriert hat. Das Entsperren holt diese Geräte nicht zurück; jedes muss sich erneut anmelden. Remove from this organization geht weiter und löscht sie. Siehe Offboarding.

Sitzungsablauf

Ablaufen können nur Geräte, die per Anmeldung registriert wurden. Ein mit Registrierungsschlüssel registriertes Gerät hat weder Eigentümer noch Sitzung: Es läuft nie ab und bleibt, bis Sie es löschen (oder, wenn sein Schlüssel temporäre Geräte erzeugt, bis es 10 Minuten offline war).

Die Regeln für die ganze Organisation stehen unter Settings → Security:

  • Expire device sessions, standardmäßig eingeschaltet, mit Session length, standardmäßig 24 Stunden. Ein Gerät muss sich erneut anmelden, sobald seit seiner letzten Anmeldung so viel Zeit vergangen ist.
  • Disconnect inactive devices, standardmäßig ausgeschaltet und nur verfügbar, solange der Sitzungsablauf eingeschaltet ist. Ein Gerät muss sich erneut anmelden, nachdem es so lange vom SXAccess-Dienst getrennt war, wie Sie festlegen: von 1 Minute bis 180 Tage.

Die Seite jedes Geräts hat unter Configuration zwei passende Schalter. Session Expiration entscheidet, ob die Sitzung dieses Geräts überhaupt ablaufen kann: Ausschalten meldet niemanden ab, sondern bedeutet, dass sich das Gerät nie wieder anmelden muss. Require login after disconnect wendet die Inaktivitätsregel auf dieses Gerät an und kann nur eingeschaltet sein, solange auch Session Expiration eingeschaltet ist. Beide sind bei einem per Anmeldung registrierten Gerät zunächst eingeschaltet. In der Geräteliste bietet das Zeilenmenü den ersten Schalter als Enable Session Expiration oder Disable Session Expiration an.

Für ein mit Schlüssel registriertes Gerät gilt keiner der beiden Schalter. Auf seiner Seite ist Session Expiration ausgegraut, und Require login after disconnect erscheint gar nicht. In der Geräteliste ist der Eintrag im Zeilenmenü ebenfalls ausgegraut, mit der Erklärung Expiration is disabled for all devices added with an enrollment key.

Ein abgelaufenes Gerät zeigt auf seiner Seite Login expired und bleibt getrennt, bis sich jemand erneut darauf anmeldet.

Was Mitglieder sehen

Mitglieder mit den Rollen Owner, Admin, Network Admin und Auditor sehen jedes Gerät. Mitglieder mit der Rolle User sehen, was Hide other people's devices from regular members unter Settings → Security zulässt. Die Einstellung ist standardmäßig eingeschaltet.

  • Solange sie eingeschaltet ist, erhalten diese Mitglieder überhaupt keine Geräteliste: Devices verschwindet aus ihrem Menü, und die Seite zeigt stattdessen, wie sich ein Gerät hinzufügen lässt.
  • Solange sie ausgeschaltet ist, sehen sie die Geräte, die sie selbst registriert haben, und dazu jedes Gerät, das eine Zugriffsregel mit einem ihrer Geräte verbindet.

Was jede Rolle ändern darf, steht unter Rollen und Berechtigungen.

Von der Maschine aus

Nicht alles erledigen Sie im Dashboard. Auf einem Gerät mit dem CLI-Agenten listet sxaccess info -d die Geräte auf, die dieser Maschine mitgeteilt wurden, jeweils mit ihrem Zustand und mit der Angabe, ob der Pfad P2P oder Relayed ist. Das ist meist schneller, als Zugriffsregeln von der anderen Seite her zu durchdenken. --json gibt dasselbe für ein Skript aus.

Die Geräteliste ist auch über die API unter https://app.sxaccess.com/api/devices abrufbar, mit einem Zugriffstoken im Header Authorization: Token.

shell - auf einem Gerät mit dem CLI-Agenten
sxaccess info -dsxaccess info --json | jq '.devices.items[] | {dnsName, address, state, path}'
shell - von überall, mit einem Zugriffstoken
curl -sS https://app.sxaccess.com/api/devices -H "Authorization: Token $SXACCESS_TOKEN"