OTP-Anmeldung einrichten (E-Mail per SMTP)

CompanyWizard meldet Nutzer per Einmalcode (OTP) an: Der Code wird per E-Mail verschickt. Voraussetzung ist ein funktionierender SMTP-Versand. Den Anmeldeablauf aus Nutzersicht zeigt Erste Anmeldung.

SMTP konfigurieren

Im Abschnitt SMTP der Systemeinstellungen pflegen Sie: Server (Host), Port, SSL/TLS verwenden, Absenderadresse, sowie bei Bedarf Benutzername und Passwort. Ein Testmodus mit Test-Empfänger hilft beim Prüfen.

Alternativ über appsettings/Umgebung (Schlüssel Smtp:SmtpServer, Smtp:SmtpPort, Smtp:SmtpUseSsl, Smtp:SmtpEmailFrom, Smtp:SmtpUserName, Smtp:SmtpPassword). → Umgebungsvariablen & appsettings

Microsoft 365 (Exchange Online) ohne Passwort

Microsoft schaltet die Anmeldung mit Passwort (Basic Auth) für smtp.office365.com ab: ab Ende Dezember 2026 ist sie in bestehenden Mandanten standardmäßig aus, 2027 endgültig. Wer heute mit Benutzername und Passwort über Exchange Online versendet, verliert dann den Versand – und damit die Anmeldung. Der SMTP-Bereich warnt bei genau dieser Einstellung.

Zwei Wege führen weiter:

1. Versand über ein Microsoft-365-Postfach (empfohlen, ohne Passwort):

   1. Unter Admin → Postfächer ein Postfach mit Protokoll „Microsoft 365 (Exchange Online)“ anlegen, die Postfachadresse eintragen und „Mit Microsoft verbinden“. → Postfächer mit Microsoft 365
   2. In den Systemeinstellungen → SMTP bei Systemmails senden über „Microsoft-365-Postfach“ wählen und das Postfach aussuchen.
   3. „Verbindung testen“ – geprüft werden Verbindung und Senderecht, ohne eine Mail zu senden. Dann „Speichern“.

   Absender ist die Adresse des Postfachs. Für ein freigegebenes Postfach braucht das verbundene Microsoft-Konto dort „Senden als“ oder „Senden im Auftrag von“ (Exchange Admin Center → Postfächer → Delegierung). Das lässt sich erst beim ersten echten Versand prüfen; fehlt es, steht der Grund im Status des SMTP-Bereichs.

2. SMTP-Relay-Dienst (z. B. ein Versanddienstleister oder ein Exchange-Connector mit fester IP-Adresse): als normaler SMTP-Server eintragen. Davon ist die Abschaltung nicht betroffen.

Das Postfach trägt jetzt die Anmeldung

Solange ein Postfach die Systemmails sendet, lässt es sich nicht löschen, deaktivieren oder auf ein anderes Protokoll umstellen – stellen Sie zuerst den Versandweg um. Läuft die Microsoft-Anmeldung des Postfachs ab (Passwortwechsel, widerrufene Zustimmung), kommen keine Anmeldecodes mehr an; der Status im SMTP-Bereich wird dann rot. Notausgang: Smtp__IgnoreDatabaseSettings=true in der Umgebung zusammen mit einer SMTP-Konfiguration dort – dann gelten die Umgebungswerte, auch für den Versandweg.

Health-Check

Beim Start und nach jedem Speichern prüft ein SMTP-Health-Monitor Verbindung und Anmeldung. Das Ergebnis (Zeitpunkt der letzten Prüfung, ggf. Fehler) wird im Tab angezeigt – so erkennen Sie Fehlkonfigurationen, bevor sich Nutzer nicht mehr anmelden können. Beim Versand über ein Microsoft-365-Postfach aktualisiert zusätzlich jede versendete Mail den Status.

Grenzen & Hinweise

• Erfordert die Rolle Administrator.
• SMS-OTP ist im Code vorgesehen, aber derzeit nicht aktiv – produktiv läuft die E-Mail-Variante.
• Das SMTP-Passwort wird verschlüsselt gespeichert und nie im Klartext angezeigt.
• Im Server-/Web-Betrieb ist ein erreichbarer SMTP-Dienst zwingend für die Anmeldung.

Verwandt

• Erste Anmeldung (OTP)
• Admin-Tab: Systemeinstellungen