Voraussetzungen:
Bevor du mit der Einrichtung startest, stelle sicher, dass du Zugriff auf das Microsoft Entra ID Konto hast und die benötigten Administratorrechte für beide Anwendungen (seventhings und Entra) vorliegen.
Einrichtung von Microsoft Entra ID in seventhings
Navigiere in der Menüleiste zu Integrationen und wähle SSO mit Microsoft Entra ID (Azure AD) aus.
Du wirst nun aufgefordert, drei Werte in seventhings zu hinterlegen, die du aus deiner MicrosoftEntra ID Anwendung entnimmst:
Client ID
Client Secret
Tenant ID
Einrichtung in Microsoft Entra ID
Registriere seventhings als Anwendung in deinem Microsoft-Entra-ID-Mandanten. Öffne dazu das Microsoft Entra Admin Center.
Melde dich mit deinem geschäftlichen Microsoft-Konto an und wähle den Mandanten aus, den du für die Anmeldung in seventhings verwenden möchtest.
Klicke auf den Bereich Microsoft Entra ID.
Wähle App-Registrierungen (App registrations) aus. Falls noch keine App-Registrierung für seventhings vorhanden ist, lege sie wie folgt an:
Klicke auf Neue Registrierung (New registration).
Gib einen aussagekräftigen Namen ein, zum Beispiel seventhings SSO.
Wähle die unterstützten Kontotypen. Für die Anmeldung ausschließlich mit Konten aus deinem eigenen Mandanten wähle Nur Konten in diesem Organisationsverzeichnis (einzelner Mandant).
Die Umleitungs-URIs richtest du im nächsten Schritt ein. Klicke auf Registrieren (Register).
Öffne anschließend die neu erstellte App-Registrierung. Wenn bereits eine passende App-Registrierung für seventhings vorhanden ist, öffne diese.
Öffne in der App-Registrierung den Bereich Authentifizierung (Authentication), um die Umleitungs-URIs (Redirect URIs) zu konfigurieren. Falls noch keine Web-Plattform vorhanden ist, klicke auf Plattform hinzufügen (Add a platform) und wähle Web.
Kopiere die beiden Werte Mobile Redirect URL und Web Redirect URL aus dem Konfigurationsbildschirm von seventhings (siehe zweiter Screenshot oben). Hinterlege beide URLs in Microsoft Entra ID unter der Plattform Web als Umleitungs-URIs. Verwende zum Ergänzen URI hinzufügen (Add URI) und speichere die Änderungen. Übernimm die URLs exakt aus deiner seventhings-Instanz; die URLs im Screenshot sind nur Beispiele.
Öffne die Übersicht (Overview) der App-Registrierung. Kopiere die Anwendungs-ID (Client) / Application (client) ID in das Feld Client ID und die Verzeichnis-ID (Mandant) / Directory (tenant) ID in das Feld Tenant ID im Konfigurationsbildschirm von seventhings.
Erstelle ein Client Secret. Dieser Schritt ist für die hier beschriebene SSO-Einrichtung erforderlich. Öffne dazu in der App-Registrierung Zertifikate & Geheimnisse (Certificates & secrets). Alternativ gelangst du über Client Credentials in der Übersicht dorthin.
Wähle unter Geheime Clientschlüssel (Client secrets) den Eintrag Neuer geheimer Clientschlüssel (New client secret). Gib eine Beschreibung ein, wähle eine Gültigkeitsdauer und klicke auf Hinzufügen (Add). Kopiere anschließend sofort den Inhalt der Spalte Wert (Value) und füge ihn im Feld Client Secret im Konfigurationsbildschirm von seventhings ein. Wichtig: Verwende den Wert des Secrets, nicht die Geheimnis-ID (Secret ID).
Der Wert des Client Secrets wird nur unmittelbar nach der Erstellung angezeigt. Sichere ihn bei Bedarf in einem Passwort-Safe. Wenn du den Wert nicht kopiert hast und er nicht mehr angezeigt wird, erstelle ein neues Secret. In seventhings kannst du das Secret nach dem Speichern nicht mehr einsehen, da es verschlüsselt in der Datenbank abgelegt wird.
Öffne API-Berechtigungen (API permissions) und füge über Berechtigung hinzufügen (Add a permission) unter Microsoft Graph → Delegierte Berechtigungen (Delegated permissions) die folgenden Berechtigungen hinzu, sofern sie noch nicht vorhanden sind:
openid – Benutzer anmelden.
User.Read – Benutzer anmelden und Benutzerprofil lesen.
Erteile anschließend mit den erforderlichen Administratorrechten die Zustimmung über Administratorzustimmung erteilen für <Mandantenname> (Grant admin consent for <tenant name>). Prüfe, dass beide Berechtigungen als genehmigt angezeigt werden. Der Name im Button richtet sich nach deinem Mandanten.
Wichtig:
Microsoft Entra ID begrenzt die Gültigkeit deines Secrets. Ohne gültiges Secret schlägt der SSO-Login für dein Team in seventhings fehl.
Erstelle rechtzeitig ein neues Secret in deiner Entra ID App. Trage den neuen Wert danach in seventhings unter Integrationen > SSO mit Microsoft Entra ID im Feld Client Secret ein.