Einrichtung und Anmeldung¶
Der erste Administrator¶
Eine neue Instanz hat kein Konto. Die Anmeldeseite zeigt Ersteinrichtung und fragt nach dem
Einrichtungscode. Das Backend schreibt ihn bei jedem Start in sein Log (docker logs <Backend-Container>),
oder es ist der Wert von SETUP_CODE in der Umgebung. Mit dem Code gibt es zwei Wege:
- Mit Microsoft anmelden (empfohlen): Sie werden der erste Administrator, und danach können sich nur Personen Ihrer Microsoft-Organisation anmelden. Es braucht ein Microsoft-Geschäftskonto; private Konten werden abgelehnt.
- oder lokalen Administrator anlegen: E-Mail und Passwort (mindestens 12 Zeichen).
Danach ist die Einrichtung geschlossen; ein zweiter Versuch meldet «Die Einrichtung ist schon abgeschlossen».
Einrichtungsassistent¶
Gleich nach der ersten Anmeldung öffnet Pulse für Administratoren den Einrichtungsassistenten. Er führt durch die Schritte unten; jeder Schritt zeigt denselben Block wie die Einstellungen, Sie richten also nichts doppelt ein. Optionale Schritte haben Überspringen. Später schliesst den Assistenten, beim nächsten Mal geht es beim selben Schritt weiter. Mit Einrichtungsassistent oben in den Einstellungen gehen Sie ihn jederzeit noch einmal durch.
| Schritt | Was Sie tun |
|---|---|
| Tenant | Den Tenant anlegen, dessen Geräte Pulse betreut, und verbinden (siehe Tenants und Verbindung). Weiter geht erst, wenn ein Tenant existiert. |
| Rollen aus Entra ID (optional) | Ihren Microsoft-Tenant hinzufügen, damit die Entra-App-Rollen Ihres Teams zählen (siehe Konten und Rollen). |
| Lizenz (optional) | Den Lizenzschlüssel aus Scalio Compass eintragen. Ohne Schlüssel läuft Pulse als Free-Edition (siehe Lizenz). |
Eine Instanz, die schon vor dieser Version im Einsatz war, gilt als eingerichtet: Dort öffnet sich der Assistent nicht von selbst.
Anmeldung mit Passwort¶
Konten und Rollen → Anmeldung (Administratoren) legt fest, wer sich mit Passwort anmelden darf:
| Einstellung | Wirkung |
|---|---|
| Erlaubt | Passwort und Passkeys funktionieren für alle lokalen Konten. |
| Nur Notfall-Administrator | Alle melden sich mit Microsoft an, ausser den als Notfall-Administrator markierten Administratoren. |
| Aus (nur Microsoft) | Passwörter und Passkeys funktionieren nicht mehr. |
Die beiden strengeren Werte lassen sich erst wählen, wenn mindestens ein Notfall-Administrator existiert.
Markieren Sie mindestens einen Administrator mit Passwort als Notfall-Administrator: Dieses Konto ist der Weg hinein, wenn Microsoft nicht erreichbar ist.
Ausgesperrt?
Ist die Anmeldung mit Passwort aus und Microsoft nicht erreichbar, setzen Sie FORCE_LOCAL_LOGIN=true in
der Umgebung des Backends und starten es neu. Dann funktionieren Passwörter für alle, und Pulse zeigt
eine Warnung, bis Sie die Einstellung wieder entfernen.
E-Mail-Versand¶
Vorgabe verwenden (empfohlen): Den Versand legen Sie einmal für alle Scalio-Apps fest, im SaaS in Scalio Compass unter Microsoft-Tenants → E-Mail-Versand für alle Apps, Self-hosted in der Datei mail.env der Installation. Mit dieser Auswahl übernimmt die App die Vorgabe; die Seite zeigt, woher sie kommt und mit welchem Absender gesendet wird. Neue Installationen stehen auf dieser Auswahl; ohne Vorgabe sendet die App nichts. Hat Scalio für Ihre Organisation «Über Scalio» eingeschaltet und Sie keine eigene Vorgabe eingetragen, sendet die App über Scalio (Absender noreply@scaliocloud.com, «Ihr Name über Scalio»). Wählen Sie unten einen eigenen Weg, gilt er nur für diese App, zum Beispiel für ein anderes Absender-Postfach.
Einstellungen → Benachrichtigungen → E-Mail-Versand (Administratoren): Wählen Sie SMTP-Server (Server, Port, Verschlüsselung, Benutzername, Passwort) oder Microsoft 365 (Tenant-ID, Client-ID, geheimer Clientschlüssel, sendendes Postfach), dazu Absenderadresse und Absendername, und prüfen Sie den Versand mit Testmail senden. Passwort und Clientschlüssel werden verschlüsselt gespeichert und nie mehr angezeigt. Letzte Mails zeigt, was gesendet wurde; eine fehlgeschlagene Mail versucht Pulse bis zu fünfmal.
Microsoft 365 über die Tenant-Verbindung sendet mit der Verbindung eines verbundenen Tenants, ohne zweite
App-Registrierung und ohne Secret: Wählen Sie den Tenant, der sendet, und das Postfach, das sendet (zum
Beispiel ein freigegebenes Postfach it@…), und speichern Sie. Das Senderecht geben Sie danach unter Senderecht in
Exchange Online mit Skript anzeigen: Führen Sie das Skript einmal als Exchange-Administrator in der Azure Cloud
Shell (PowerShell) aus. Es erlaubt der App mit «RBAC for Applications» nur das Senden als dieses Postfach; eine
Berechtigung Mail.Send in Entra ID braucht es nicht. Exchange übernimmt das Recht nach bis zu zwei Stunden, danach
klappt die Testmail. Nach einem Wechsel des Postfachs führen Sie das Skript erneut aus. Für Microsoft 365 mit
eigener App-Registrierung zeigt die Seite dasselbe Skript.
Zweiter Faktor¶
Wer ein Passwort hat, kann unter Profil → Sicherheit eine Authenticator-App, Backup-Codes und Passkeys einrichten (siehe Anmelden). Bei der Anmeldung mit Microsoft gilt der zweite Faktor Ihrer Microsoft-Organisation.