Profile und Ausweis

Nach dieser Anleitung kennt die CLI Ihre Umgebung, Ihren Ausweis und den Schreibschutz — als Profil in einer Datei oder nur über Umgebungsvariablen — und szenera whoami zeigt, mit welchem Konto und welcher Organisation sie spricht.

Ein Profil bündelt zwei Dinge: den Ausweis und die Zuordnung Dienst → Basis-Adresse. Alles, was ein Befehl über seine Gegenseite wissen muss, steht dort — und nirgends sonst. Jedes Profil gehört einer Organisation.

Schritte#

1. Legen Sie die Profil-Datei an: ~/.config/szenera/profile.json (ein gesetztes $XDG_CONFIG_HOME wird beachtet). Die Form:

   {
     "default": "staging",
     "profiles": {
       "staging": {
         "services": { "*": "https://<basis-adresse-ihrer-umgebung>" },
         "credential": { "kind": "api-key", "key": "ak_…" },
         "readOnly": false
       },
       "prod": {
         "services": { "*": "https://<basis-adresse-der-produktion>" },
         "credential": { "kind": "api-key", "key": "ak_…" },
         "readOnly": true
       }
     }
   }
   

2. Tragen Sie unter services die Basis-Adresse ein. Der Eintrag * gilt für alles, was keinen eigenen Eintrag hat, und genügt heute; die Adresse muss mit http:// oder https:// beginnen, ein Schrägstrich am Ende wird entfernt.

3. Wählen Sie den Ausweis unter credential. Die Art api-key mit einem Wert ak_… unter key ist der Regelweg; die beiden anderen Arten stehen unter „Optionen".

4. Entscheiden Sie über readOnly. true sperrt jeden verändernden Befehl, bevor ein einziges Netzpaket entsteht; für ein Produktions-Profil bleibt das stehen. Fehlt die Angabe, gilt true.

5. Setzen Sie default auf das Profil, das ohne --profile= gelten soll. Führt die Datei genau ein Profil, gilt dieses auch ohne Vorgabe; führt sie mehrere ohne Vorgabe, bricht die CLI ab und nennt die Namen.

6. Prüfen Sie das Profil:

   szenera whoami
   szenera whoami --profile=prod --json
   

Optionen#

Ohne Datei: Umgebungsvariablen#

Umgebungsvariablen liegen über der Datei — jede gesetzte Variable ersetzt den entsprechenden Wert des gewählten Profils. SZENERA_BASE_URL und SZENERA_API_KEY allein tragen ein vollständiges Profil, ganz ohne Datei; es heißt dann environment und ist nicht schreibgeschützt.

SZENERA_BASE_URL="https://<basis-adresse>" SZENERA_API_KEY="ak_…" szenera device list

Wo die CLI sucht#

Der erste Treffer gewinnt:

Ausweisarten#

api-key — der Regelweg. Der Schlüssel reist als Authorization: Bearer an jedem Aufruf mit und läuft nicht nach einer Viertelstunde ab; die CLI braucht dafür weder Zwischenspeicher noch Auffrischung. Ein Wert ohne einen Präfix, den die API als Schlüssel kennt, wird abgewiesen, bevor ein Netzpaket entsteht — sobald ein Befehl den Ausweis braucht (Exit 2); --help und health laufen auch mit einem falschen Wert durch.

password — für den Menschen am Rechner. Das Profil trägt email und password, bei Zwei-Faktor zusätzlich totpSecret (Base32); den Einmalcode rechnet die CLI selbst. Das Zugriffsmerkmal liegt danach mit Rechten 0600 neben der Konfiguration (.szenera-token-<profil>.json), wird eine Minute vor Ablauf verworfen und vor jedem Aufruf erneuert, wenn es die nächste Rundreise nicht mehr trägt — auch mitten in einem Befehl, der Minuten wartet. Gehört das Konto zu mehreren Organisationen, bricht die Anmeldung ab, statt zu raten.

{ "credential": { "kind": "password", "email": "…", "password": "…", "totpSecret": "…" } }

none — nur öffentliche Routen. szenera health läuft damit; jeder andere Befehl bricht mit dem Hinweis ab, dass das Profil keinen Ausweis trägt.

Dienste je Domäne#

Statt * darf ein Eintrag unter services eine Domäne der Plattform nennen (etwa fleet oder composition) und ihr eine eigene Adresse geben; * bleibt für den Rest. Ein Name, der keine Domäne ist, wird beim Lesen abgewiesen — ein Tippfehler fällt nicht still auf * zurück.

Ergebnis prüfen#

• szenera whoami zeigt Kennung, E-Mail, Name, Organisation und die Zahl der Rollen (Route GET /v1/me).
• Steht dort eine andere Organisation als erwartet, zeigt das Profil woandershin, als gedacht — nicht der Schlüssel ist falsch, sondern die Wahl.

Wenn etwas nicht klappt#

Weiterführendes#

• Die CLI beziehen
• Ausgabe als JSON und Exit-Codes
• Einen API-Schlüssel erzeugen