SXAccessSXAccessDoku
Dashboard öffnen

Organisationseinstellungen

Die Schalter für die ganze Organisation und wo jeder davon liegt: Gerätesitzungen und Inaktivität, wer die Geräteliste sieht, Connect on demand, Zwei-Faktor und Passkeys sowie die interne Domain.

Die Schalter, die für die ganze Organisation gelten, liegen an zwei Stellen. Settings in der Seitenleiste hat zwei Reiter: Security für Gerätesitzungen und das, was Mitglieder sehen, und Authentication für Zwei-Faktor und Passkeys. Organization settings im Organisationsmenü oben in der Seitenleiste enthält die interne Domain und die Wildcard-Auflösung. Die Gruppenweitergabe liegt bei den Gruppen, unter People → Groups.

Mitglieder mit der Rolle Owner oder Admin können diese Einstellungen ändern; Network Admin und Auditor können sie nur ansehen. Mitglieder mit der Rolle User sehen sie nicht.

Settings → Security: Sicherheitsregeln

Diese Zeilen stehen auf der Karte Security rules. Ändern Sie, was nötig ist, und wählen Sie Save security rules; Geräte übernehmen die neuen Regeln beim nächsten Abgleich.

EinstellungStandardWirkung
Expire device sessionsanEin per Anmeldung registriertes Gerät muss sich neu anmelden, wenn seine Sitzung abläuft. Mit einem Registrierungsschlüssel registrierte Geräte sind nie betroffen
Session length24 StundenWie lange ein solches Gerät angemeldet bleibt, bevor sich die Person darauf erneut anmelden muss. 1 Stunde bis 180 Tage, einstellbar in Stunden oder Tagen
Disconnect inactive devicesaus, 10 MinutenBeendet die Sitzung eines per Anmeldung registrierten Geräts, wenn es so lange keine Verbindung zum Dienst hatte; die Zeit läuft ab dem Moment, in dem das Gerät die Verbindung verliert. Nur verfügbar, solange Expire device sessions an ist. 1 Minute bis 180 Tage. Gerät und Gruppen bleiben erhalten; die Person muss sich darauf erneut anmelden, damit es sich wieder verbindet

Settings → Security: was Mitglieder sehen

Diese Zeilen stehen auf der Karte What members can see, die ihre eigene Schaltfläche Save hat.

EinstellungStandardWirkung
Hide other people's devices from regular membersanSolange die Einstellung an ist, bekommen Mitglieder mit der Rolle User überhaupt keine Geräteliste: Devices verschwindet aus ihrer Seitenleiste, und die Seite bietet stattdessen an, ein Gerät hinzuzufügen. Ist sie aus, sehen sie ihre eigenen Geräte und die Geräte, die ihre eigenen Geräte erreichen können. Mitglieder mit der Rolle Owner, Admin, Network Admin oder Auditor sehen immer alle Geräte. Das ändert, was Dashboard und API anzeigen, nicht, was ein Gerät erreichen kann
Connect on demandausExperimentell. Geräte bauen einen Tunnel zu einem anderen Gerät erst auf, wenn tatsächlich Verkehr dorthin geht, statt jeden Tunnel offen zu halten
Der Reiter „Security“ unter „Settings“ mit den Sicherheitsregeln oben und dem, was Mitglieder sehen, darunter.
Settings → Security: oben die Sicherheitsregeln, darunter, was Mitglieder sehen.

Ausnahmen für ein einzelnes Gerät

Auf der Seite eines Geräts lassen sich die beiden Sitzungsregeln nur für dieses Gerät abschalten. Unter Devices → das Gerät → Configuration schaltet Session Expiration den Ablauf für das Gerät ein oder aus, und Require login after disconnect tut dasselbe für die Inaktivitätsregel; dafür muss Session Expiration an sein. Beide gibt es nur für per Anmeldung registrierte Geräte, und beide sind zunächst an, sodass die Einstellungen der Organisation entscheiden, bis Sie sie ändern.

Wenn Sie Session Expiration ausschalten, läuft das Gerät nie ab; abgemeldet wird es dadurch nicht. Soll sich jemand auf einem Gerät sofort neu anmelden müssen, sperren Sie das Mitglied oder löschen Sie das Gerät.

Settings → Authentication

Die Karten Two-factor authentication und Passwordless sign-in haben jeweils ihre eigene Schaltfläche Save changes. Keiner der beiden Schalter gilt für Zugriffstoken, die ein Programm authentifizieren und nie über die Anmeldung laufen. Was die beiden Regeln für Mitglieder bedeuten, beschreibt Was die Organisation verlangt; die Anmeldeseite selbst beschreibt Anmeldung.

EinstellungStandardWirkung
Require it to enter this organizationausNiemand arbeitet in der Organisation ohne zweiten Faktor, auch nicht Mitglieder, die sich mit Google anmelden. Wer keinen hat, wird bei der nächsten Anmeldung oder beim Wechsel in diese Organisation gebeten, einen einzurichten, sodass niemand ausgesperrt wird
Allow signing in with a passkeyausMitglieder können in ihrem Profil unter Sign-in einen Passkey registrieren und ihn statt des Passworts verwenden; das Passwort funktioniert weiter. Solange die Option an ist, bietet die Anmeldeseite jeder Adresse einen Passkey an; Außenstehende können so erfahren, dass zu einer Adresse ein Passkey gehört, sich ohne das Gerät aber nicht anmelden
Sync groups from the provider auf der Karte Sign-in rules-Hier gibt es nichts einzuschalten. Die Schaltfläche Set up on People → Groups öffnet die Gruppenliste, und dort lässt sich keine Gruppensynchronisierung einrichten. Da Sie keinen eigenen Identitätsanbieter anbinden können, werden Gruppen in SXAccess gepflegt; siehe Gruppen

Gruppenweitergabe

Die Gruppenweitergabe steht nicht unter Settings. Ihr Schalter Enable user group propagation liegt unter People → Groups → Settings, ist standardmäßig an und wird mit Save group settings gespeichert. Er entscheidet, ob eine Änderung an den Gruppen eines Mitglieds auch dessen vorhandene Geräte verschiebt; siehe Gruppenweitergabe.

Das geöffnete Organisationsmenü mit drei Organisationen, die aktuelle mit Häkchen, und „Organization settings“ unten.
Das Organisationsmenü: Hier wechseln Sie die Organisation oder öffnen „Organization settings“.

Organization settings: Details

Öffnen Sie das Organisationsmenü oben in der Seitenleiste und wählen Sie Organization settings. Die übrigen Zeilen im Reiter Details sind mit Not connected yet markiert und ändern vorerst nichts.

EinstellungWirkung
Internal domainDie Domain, unter der Gerätenamen liegen, damit Personen einen Namen statt einer Adresse eingeben können. Setzen Sie Ihre eigene, etwa corp.example.com, ohne Wildcards, und wählen Sie Save organization details. Geräte übernehmen eine neue Domain beim nächsten Abgleich
Resolve wildcard domainsStandardmäßig an; die Änderung wird gespeichert, sobald Sie umschalten. Routing-Geräte antworten für jeden Namen unter einer Domain, die Sie routen, nicht nur für einzeln aufgeführte Namen. Eine Wildcard-Domain wie *.example.com funktioniert nur, solange die Einstellung an ist; ein einfacher Domainname funktioniert in beiden Fällen
Der Reiter „Details“ unter „Organization settings“ mit interner Domain, Wildcard-Auflösung und Zeilen mit „Not connected yet“.
Organization settings, Details. „Internal domain“ und „Resolve wildcard domains“ wirken; die mit „Not connected yet“ markierten Zeilen nicht.

Einstellungen über die API ändern

Lesen Sie die Organisation mit GET https://app.sxaccess.com/api/organizations. Die Antwort ist eine Liste mit einem Eintrag, Ihrer Organisation, samt id und settings. Schreiben Sie mit PUT https://app.sxaccess.com/api/organizations/{organizationId} und einem Body {"settings": {...}}, der das vollständige gelesene Einstellungsobjekt enthält, in dem nur die Felder geändert sind, die Sie ändern wollen. Zeitangaben erfolgen in Sekunden. Das Beispiel unten speichert die Organisation in org.json, setzt eine Sitzungsdauer von 7 Tagen (604800 Sekunden) und sendet das vollständige Einstellungsobjekt zurück. Siehe Öffentliche API.

shell - eine Einstellung über die API ändern
curl -sS https://app.sxaccess.com/api/organizations \  -H "Authorization: Token $SXACCESS_TOKEN" > org.jsonORG_ID=$(jq -r '.[0].id' org.json)jq '{settings: (.[0].settings | .device_login_expiration = 604800)}' org.json > body.jsoncurl -sS -X PUT https://app.sxaccess.com/api/organizations/$ORG_ID \  -H "Authorization: Token $SXACCESS_TOKEN" \  -H "Content-Type: application/json" \  --data @body.json