Ein Gerät zwischen Organisationen verschieben
Eine Maschine kann mehreren Organisationen angehören und mit einem Befehl zwischen ihnen wechseln. Das erledigen die Befehle von sxaccess tenant, und sie sind nicht dasselbe wie Identitäten.
Das Notebook eines externen Dienstleisters, eine gemeinsam genutzte Build-Maschine, ein Entwickler, der für zwei Firmen arbeitet: ein Gerät, mehrere Organisationen. Mit sxaccess tenant verschiebt die CLI dieses Gerät zwischen ihnen. Jede Organisation, der das Gerät auf diesem Weg beitritt, erhält eine eigene Registrierung, die auf dem Gerät erhalten bleibt; ein späterer Rückwechsel ist also ein Befehl und kein neuer Beitritt. Organisationen anlegen und wechseln fasst das kurz zusammen und beschreibt außerdem den Wechsel im Dashboard und in den Apps.
Eine Regel macht den Rest dieser Seite verständlich: Solange eine Organisation aktiv ist, verwendet der Agent deren Registrierung. Er lädt die Konfiguration der aktiven Organisation statt der Konfiguration der Identität - beim Start, bei der Anmeldung, beim Verbinden und beim Wechsel der Identität. Einstellungen sind die Ausnahme: Die Optionen, die Sie sxaccess start mitgeben, werden zusammen mit der Identität gespeichert und gelten daher nicht, solange eine Organisation aktiv ist.
Einer zweiten Organisation beitreten und zwischen beiden wechseln
- 1
Beim ersten Mal ohne Argument beginnen
Das Gerät kennt nur Organisationen, die ihm gezeigt wurden. Angenommen, Sie haben es per Anmeldung in acme-corp registriert, als Ihr Konto nur acme-corp angehörte, und wurden inzwischen auch zu acme-labs hinzugefügt. Die Liste ist leer, der erste Schritt ist also
switchohne Argument. (Hätte Ihr Konto bei der Registrierung schon mehreren Organisationen angehört, hättestartSie damals gebeten, eine auszuwählen, undsxaccess tenant listwürde bereits alle zeigen.)switchmeldet Sie an - dabei verwendet es eine kürzlich erfolgte Anmeldung wieder, falls der Agent noch eine hat, und öffnet sonst einen Browser - und fragt dann, welcher Organisation das Gerät beitreten soll. Die Anmeldung trennt das Gerät; es bleibt offline, bis der Wechsel abgeschlossen ist.sxaccess tenant switch - 2
Aus der ausgegebenen Liste wählen
Sie erhalten eine nummerierte Liste und die Eingabeaufforderung
Enter choice:, auch wenn Ihr Konto nur einer einzigen Organisation angehört - die Überschrift spricht so oder so vonmultiple organizations. Geben Sie die Nummer ein. Alles, was keine aufgeführte Nummer ist, beendet den Befehl mitinvalid organization selectionund Ihrer Eingabe; das Gerät tritt keiner Organisation bei und bleibt getrennt, bis Siesxaccess startoder den Wechsel erneut ausführen.Das Gerät wird in der gewählten Organisation registriert und anschließend verbunden - dieser eine Befehl bringt Sie also vom abgemeldeten Zustand direkt ins Netzwerk.
You belong to multiple organizations. Select the one to enroll this device into: 1) acme-corp 2) acme-labsEnter choice: 2Switched to organization "acme-labs". - 3
Prüfen, was das Gerät nun kennt
listläuft lokal und kostet nichts.*markiert die aktive Organisation.✓markiert jede Organisation, für die das Gerät eine eigene Registrierung hat: Bei einem Wechsel dorthin meldet sich das Gerät mit seinem Schlüssel an, ohne Browser. Die Markierung erscheint allerdings, sobald ein Beitritt beginnt; auch eine Organisation, deren erster Beitritt gescheitert ist oder abgebrochen wurde, trägt sie also.Einer Organisation ohne
✓ist das Gerät auf diesem Weg noch nicht beigetreten. Hier gilt das auch für acme-corp, in der das Gerät vor Ihrem ersten Wechsel registriert wurde: Diese Registrierung gehört zur Identität, nicht zu dieser Liste.$ sxaccess tenant listYour organizations (* = active, ✓ = joined on this device): acme-corp (d3h0k2ss5ltc73a9h6v0) * ✓ acme-labs (d3h1a8ss5ltc73a9h6vg)Switch with: sxaccess tenant switch <name> - 4
Über den Namen wechseln
Übergeben Sie
switcheinen Namen oder eine ID auslist; bei Namen spielt die Groß- und Kleinschreibung keine Rolle. Der Befehl trennt die Verbindung, aktiviert diese Organisation, meldet sich an und verbindet erneut. Bei einer Organisation mit✓meldet er sich mit dem Schlüssel des Geräts an, ohne Browser und ohne Rückfrage.Hier trägt acme-corp kein
✓; dieser Wechsel ist also ein Erstbeitritt. Lesen Sie den Hinweis nach diesen Schritten, bevor Sie ihn ausführen.$ sxaccess tenant switch acme-corpSwitched to organization acme-corp - 5
Bestätigen, welche aktiv ist
currentgibt die aktive Organisation und ihre ID aus. Verstehen Sie die Ausgabe als das, was sie ist: der Vermerk des Agenten, welche Organisation ausgewählt ist, und kein Nachweis, dass die Verbindung steht. Dafür verwenden Siesxaccess info- beachten Sie dazu den Hinweis unten, wasinfonicht anzeigt.$ sxaccess tenant currentacme-corp (d3h0k2ss5ltc73a9h6v0)
Die Befehle
Alle kommunizieren mit dem Agenten, er muss also laufen. Keiner hat eigene Optionen, und keiner liest SX_-Umgebungsvariablen.
| Befehl | Wirkung |
|---|---|
sxaccess tenant list | Jede Organisation, die dieses Gerät kennt, mit Markierung der aktiven und derjenigen, denen das Gerät beigetreten ist. Ein Gerät, dem noch keine gezeigt wurde, antwortet No organizations known yet. Run 'sxaccess tenant switch' to log in and pick one. |
sxaccess tenant current | Die aktive Organisation und ihre ID. Solange das Gerät noch die Registrierung seiner Identität verwendet, antwortet es No active organization. - siehe die Warnung unten |
sxaccess tenant switch | Ohne Argument: anmelden, die Organisationen Ihres Kontos auflisten, nach der gewünschten fragen, beitreten und verbinden |
sxaccess tenant switch <Name> | Mit Argument: über den Namen, ohne Beachtung der Groß- und Kleinschreibung, oder über die ID mit den bekannten Organisationen abgleichen. Trennen, aktivieren, anmelden, verbinden |
Die Organisation bei der Registrierung wählen
Gehört Ihr Konto mehreren Organisationen an, fragen sxaccess start und sxaccess enroll nach der Anmeldung im Browser mit derselben nummerierten Liste, welcher Organisation das Gerät beitreten soll. Um die Frage vorab zu beantworten, geben Sie die ID der Organisation an: sxaccess start --tenant d3h0k2ss5ltc73a9h6v0. Die ID ist der Wert in Klammern in sxaccess tenant list und das Feld id, das GET /api/organizations in der Öffentlichen API liefert.
Mit einem Registrierungsschlüssel wird --tenant ignoriert; der Schlüssel registriert das Gerät immer in seiner eigenen Organisation. Außerdem zählt die Option nur bei der Registrierung: Ein bereits registriertes Gerät behält seine Organisation, und auf einem verbundenen Gerät gibt start This device is already connected aus und ändert nichts. Um ein solches Gerät zu verschieben, verwenden Sie sxaccess tenant switch. Eine Registrierung mit --tenant gehört, wie eine mit Schlüssel, zur Identität: sxaccess tenant list und sxaccess tenant current zeigen sie nicht, und der erste switch lässt sie zurück.
Das ist nicht dasselbe wie eine Identität
Von außen sehen die beiden ähnlich aus, ihr Geltungsbereich ist aber ein anderer.
Eine Identität ist eine gespeicherte Anmeldung auf dieser Maschine: eigener Schlüssel, eigene Einstellungen, eigene Registrierung. Sie legen sie mit sxaccess identity add an; für den Server bedeutet sie nichts. Mit Identitäten führen Sie getrennte Anmeldungen nebeneinander auf einer Maschine - zwei Konten oder eine Installation, die einen anderen Registrierungsschlüssel verwendet.
Eine Organisation - nach ihr sind die Befehle unter sxaccess tenant benannt - ist eine, der Ihr Konto angehört. Die Liste kommt vom Server, nicht von Ihnen, und ein Beitritt registriert das Gerät dort.
Greifen Sie also zu sxaccess tenant, um zwischen Organisationen zu wechseln, denen Sie angehören, und zu Identitäten nur, um getrennte Anmeldungen auseinanderzuhalten. Sind beide gesetzt, gilt die Registrierung der Organisation.