SXAccessSXAccessDoku
Dashboard öffnen

Organisationen anlegen und wechseln

Eine Organisation enthält Ihre Geräte, Mitglieder und Zugriffsregeln. Eine anlegen, mehreren angehören und im Dashboard, in den Apps und in der CLI zwischen ihnen wechseln.

Eine Organisation ist der Raum, in dem alles andere liegt. Ihre Geräte, Mitglieder, Gruppen, Zugriffsregeln, Netzwerke, DNS-Server, Registrierungsschlüssel und Einstellungen gehören nur ihr, und nichts, was Sie in einer Organisation einrichten, wirkt sich in einer anderen aus.

Eine Person kann Mitglied mehrerer Organisationen sein, in jeder mit einer anderen Rolle. Ihre Anmeldung ist überall dieselbe: ein Passwort, ein Satz zweiter Faktoren und Passkeys. Ein Gerät dagegen ist jeweils nur mit einer Organisation verbunden.

Eine Organisation anlegen

  1. 1

    Ohne Organisation anmelden

    Wählen Sie auf der Anmeldeseite unter app.sxaccess.com die Option Register, oder verwenden Sie Continue with Google, und melden Sie sich an. Solange Ihr Konto keiner Organisation angehört, öffnet das Dashboard statt seiner üblichen Seiten Create your Organization.

  2. 2

    Einen Namen wählen

    Verwenden Sie 3 bis 32 Zeichen: Kleinbuchstaben, Ziffern und Bindestriche, am Anfang und am Ende ein Buchstabe oder eine Ziffer, etwa acme-corp. Großbuchstaben werden in Kleinbuchstaben umgewandelt. Der Name darf noch nicht vergeben sein, und das Dashboard zeigt ihn danach nur noch an, ohne ihn ändern zu lassen; wählen Sie also einen, bei dem Sie bleiben möchten.

  3. 3

    Organisation anlegen

    Belassen Sie unter Choose a plan die bereits getroffene Auswahl und wählen Sie Create organization. Sie werden Eigentümer der Organisation, und das Dashboard öffnet sich in ihr. Laden Sie Ihr Team unter People → Members ein, wie unter Mitglieder hinzufügen beschrieben, und fügen Sie Ihr erstes Gerät mit Add device hinzu.

Einer weiteren Organisation beitreten

Um Sie aufzunehmen, lädt ein Eigentümer oder Administrator dieser Organisation Ihre E-Mail-Adresse unter People → Members → Invite member ein. Gibt es zu der Adresse schon ein SXAccess-Konto, werden Sie sofort hinzugefügt, mit der gewählten Rolle und den gewählten Gruppen. Eine E-Mail mit dem Betreff You were added to <Name der Organisation> on SXAccess teilt Ihnen das mit. Mehr ist nicht nötig: Melden Sie sich wie gewohnt an und wechseln Sie in die Organisation. Gibt es zu der Adresse noch kein Konto, führt Sie die Einladungs-E-Mail zuerst durch das Anlegen eines Kontos.

Rolle und Gruppen gelten je Organisation; Sie können also Eigentümer der einen und gewöhnliches Mitglied einer anderen sein. Werden Sie mit Remove from this organization aus einer Organisation entfernt, verlieren Sie dort Ihre Geräte und Ihren Zugriff, während Ihr Konto und Ihre anderen Organisationen unberührt bleiben.

Im Dashboard wechseln

Die Organisation, in der Sie arbeiten, steht oben in der Navigationsleiste; auf einem schmalen Bildschirm steht sie stattdessen in einer Leiste über der Seite, mit der Schaltfläche Switch. Öffnen Sie sie, um Your organizations zu sehen, und wählen Sie eine aus. Das Dashboard lädt in der gewählten Organisation neu, beginnend mit Overview, und dieser Browser merkt sich Ihre Wahl. Solange Sie noch nicht gewählt haben, öffnet das Dashboard die Organisation, in der Sie die höchste Rolle haben.

Ein Schild-Symbol neben einer Organisation in dieser Liste bedeutet, dass sie nach einem zweiten Faktor fragt; beim Wechsel dorthin kann Confirm it is you erscheinen, siehe Zwei-Faktor und Passkeys. Eine rote Markierung suspended kennzeichnet eine suspendierte Organisation; mehr dazu weiter unten. Darf Ihre Rolle Einstellungen sehen, führt dasselbe Menü zu Organization settings, beschrieben unter Organisationseinstellungen.

In den Apps wechseln

Die Apps sind jeweils nur mit einer Organisation verbunden, und Sie wechseln nur, während die Verbindung steht. Wenn Sie eine Organisation wählen, wird nie sofort gewechselt: Zuerst zeigt eine Bestätigung, was passieren wird. Beim Wechsel in eine Organisation, der dieses Gerät schon beigetreten ist, behält es seine Geräteidentität, und es ist kein Browser nötig. Der erste Beitritt registriert das Gerät dort mit einer neuen Geräteidentität und öffnet den Browser, falls Ihre Anmeldung erneuert werden muss. In beiden Fällen trennt sich das Gerät von der Organisation, die es verlässt.

AppWo Sie wechseln
macOS und WindowsDas Organisationsfeld unten in der Seitenleiste öffnet Switch organization; jede Organisation ist dort mit CURRENT, ENROLLED oder NOT JOINED markiert. Ein Mac, der mit einem Registrierungsschlüssel registriert wurde, hat kein solches Feld. Siehe macOS und Windows
iPhone und AndroidDas Organisationsfeld oben im Bildschirm Shield, das erscheint, sobald Sie mehr als einer Organisation angehören. Siehe iOS und Android

Mit der CLI wechseln

Auf einem Rechner mit dem CLI-Agenten können Sie mit sxaccess tenant Organisationen auflisten, anzeigen und wechseln. sxaccess tenant switch ohne Namen meldet Sie bei Bedarf an, listet alle Organisationen auf, denen Ihr Konto angehört, und tritt der gewählten bei. Mit dem Namen einer Organisation, der dieses Gerät schon beigetreten ist, wechselt der Befehl direkt dorthin, ohne Browser. sxaccess tenant current gibt die aktive Organisation aus oder No active organization.

Wenn Sie sich mit sxaccess start anmelden und mehreren Organisationen angehören, fragt die CLI, in welcher Organisation der Rechner registriert werden soll; --tenant mit einer Organisations-ID beantwortet das im Voraus. Ein Registrierungsschlüssel registriert ein Gerät immer in der Organisation, in der er erstellt wurde. Die ausführliche Anleitung steht unter Organisation wechseln.

shell - Organisationen auflisten und wechseln
$ sxaccess tenant listYour organizations (* = active, ✓ = joined on this device): * ✓  acme-corp (d3h0k2ss5ltc73a9h6v0)   ✓  acme-labs (d3h1a8ss5ltc73a9h6vg)Switch with: sxaccess tenant switch <name>$ sxaccess tenant switch acme-labsSwitched to organization acme-labs

Eine Organisation je Registrierung

Jede Organisation, der ein Gerät beitritt, ist eine eigene Registrierung. Das Gerät erscheint in jeder dieser Organisationen als eigenes Gerät, mit einer Overlay-Adresse, Gruppen und Zugriffsregeln aus der jeweiligen Organisation; die Apps zeigen die Adresse als Tunnel address. Wird es aus einer Organisation entfernt, bleibt seine Registrierung in den anderen bestehen. Ein Gerät, das mit einem Registrierungsschlüssel registriert wurde, gehört zur Organisation des Schlüssels. In den Apps hat es keine Organisationsliste zum Wechseln; mit der CLI meldet sich sxaccess tenant switch mit dem Konto eines Mitglieds an und registriert den Rechner als eigenes Gerät in einer weiteren Organisation.

In der API

Jeder API-Aufruf wirkt in genau einer Organisation. Ein Zugriffstoken wirkt immer in der Organisation, in der es erstellt wurde. Eine Anfrage mit der Anmeldung eines Mitglieds, wie sie das Dashboard stellt, wirkt in der Organisation, die der Header X-Organization-Id nennt; nennt er eine, der das Mitglied nicht angehört, wird die Anfrage abgelehnt. Ohne den Header wirkt sie in der Standardorganisation des Mitglieds: der Organisation, in der es die höchste Rolle hat und die auch das Dashboard öffnet, bevor eine Wahl getroffen wurde. Siehe Öffentliche API.

Wenn eine Organisation suspendiert ist

Eine suspendierte Organisation ist für alle Mitglieder zugleich geschlossen. Im Dashboard lassen sich ihre Seiten nicht mehr öffnen, das Organisationsmenü zeigt eine rote Markierung suspended, und der Eigentümer sieht den Hinweis This organization is suspended. Ihre Geräte können keine Verbindung aufbauen: Die Apps melden Organization suspended, und sxaccess info auf einem Rechner mit der CLI meldet, dass die Organisation des Geräts suspendiert ist.

Niemand muss sich neu anmelden oder etwas neu installieren. Die Geräte versuchen es etwa alle fünf Minuten erneut und verbinden sich von selbst, sobald die Suspendierung aufgehoben ist. Sind Sie der Eigentümer, schreiben Sie an support@sxaccess.com; alle anderen wenden sich an den Eigentümer oder einen Administrator der Organisation.