MS Entra Einbindung – voll easy, Digga. 🔥

#1. Unternehmensanwendung erstellen

#Schritt 1.1: Zu Unternehmens-Apps navigieren

Im Microsoft Entra Admin Center: Links in der Leiste suchst du nach:

• Home (Haus-Icon)

• Entra ID (erweiterter Bereich)

• Unternehmens-Apps – klick da rein

#Schritt 1.2: "Neue Anwendung" klicken

Auf der Unternehmens-Apps-Seite: Aktionsbuttons oben – check die aus.

#Schritt 1.3: "Eigene Anwendung erstellen" auswählen

Modal-Fenster poppt auf mit Optionen. Such nach:

• Eigene Anwendung erstellen – klick da

• Seitenpanel für Config öffnet sich

#Schritt 1.4: Anwendungsdetails konfigurieren

Im Seitenpanel:

• Name: Dein App-Name (z. B. Kibi demo app)

• Wichtig: Wähl Integrieren Sie jede andere Anwendung, die Sie nicht in der Galerie finden (Nicht-Galerie)

#Schritt 1.5: Anwendungserstellung bestätigen

Nach Klick auf Erstellen: Weiterleitung zur Übersichtsseite. Check ab:

• Dein App-Name steht im Titel

• Anwendungs-ID (Client-ID) ist sichtbar

• App taucht in deiner Unternehmens-Apps-Liste auf

#2. App-Geheimnisschlüssel erstellen

#Schritt 2.1: Zu App-Registrierungen navigieren

Links in der Leiste: Such nach App-Registrierungen und klick da.

• Wähl Alle Anwendungen

• Such deine App in der Liste und wähl sie aus

#Schritt 2.2: Auf Zertifikate und Geheimnisse zugreifen

In den App-Details: Links im Menü suchst du Zertifikate und Geheimnisse – klick da.

#Schritt 2.3: Neues Client-Geheimnis erstellen

Auf der Zertifikate und Geheimnisse-Seite:

• Klick auf + Neues Client-Geheimnis

• Beschreibung rein (z. B. Kibi Connect Integration)

• Ablauf wählen (empfehlenswert: 12 Monate oder länger)

• Klick auf Hinzufügen

#Schritt 2.4: Den Geheimniswert kopieren

WICHTIG: Nach dem Erstellen siehst du den Geheimniswert nur einmal. Kopier ihn sofort!

Warnung: Der Geheimniswert verschwindet, wenn du die Seite verlässt. Speicher ihn sicher ab.

#3. Anwendungsberechtigungen konfigurieren

#Schritt 3.1: Zu App-Registrierungen navigieren

Links in der Leiste: Such nach App-Registrierungen und klick da.

• Wähl Alle Anwendungen

• Such deine App in der Liste und wähl sie aus

#Schritt 3.2: API-Berechtigungen

In den App-Details: Links im Menü suchst du API-Berechtigungen – klick da.

#Schritt 3.3: Microsoft Graph Berechtigungen hinzufügen

Auf der API-Berechtigungen-Seite:

• Klick auf + Berechtigung hinzufügen

• Wähl Microsoft Graph

• Wähl Anwendungsberechtigungen

• Such nach User.Read.All unter Benutzer

• Such nach Directory.Read.All unter Verzeichnis

• Klick auf Berechtigungen hinzufügen

#Schritt 3.4: Administrator-Einwilligung erteilen

WICHTIG: Ohne Admin-Einwilligung läuft die Sync nicht. Also:

• Klick auf Administrator-Einwilligung erteilen

• Klick auf Ja

#Schritt 3.5: Berechtigungen für Single Sign-On (Delegierte Berechtigungen)

Falls du SSO ("Mit Microsoft anmelden") nutzen willst, brauchst du zusätzlich delegierte Berechtigungen:

• Klick nochmal auf + Berechtigung hinzufügen

• Wähl Microsoft Graph

• Wähl diesmal Delegierte Berechtigungen

• Such und aktivier folgende Berechtigungen:

• openid – OpenID Connect Anmeldung

• profile – Benutzerprofil lesen

• email – E-Mail-Adresse lesen

• User.Read – Angemeldetes Benutzerprofil lesen

Klick auf Berechtigungen hinzufügen. Dann nochmal Admin-Einwilligung erteilen.

#3b. Redirect URI für SSO konfigurieren

Nur nötig, wenn du Single Sign-On (SSO) nutzen willst.

#Schritt 3b.1: Umleitungs-URI eintragen

In deiner App-Registrierung: Links im Menü klick auf Authentifizierung.

• Klick auf + Plattform hinzufügen

• Wähl Web

• Trag folgende Redirect URI ein:

Klick auf Konfigurieren.

#4. Benutzer Ihrer Anwendung zuweisen (Optional)

#Schritt 4.1: Zu Unternehmens-Apps navigieren

Links in der Leiste: Such nach Unternehmens-Apps und klick da.

• Wähl deine App aus der Liste

#Schritt 4.2: Auf Benutzer und Gruppen zugreifen

In den App-Details: Links im Menü suchst du Benutzer und Gruppen – klick da.

#Schritt 4.3: Benutzer Ihrer Anwendung zuweisen

Auf der Benutzer und Gruppen-Seite:

• Klick auf + Benutzer/Gruppe hinzufügen

#Schritt 4.4: Zuweisung bestätigen

Auf der Zuweisung hinzufügen-Seite:

• Klick auf Benutzer

• Wähl die Benutzer aus, die du zuweisen willst

• Klick auf Auswählen

#5. Kibi Connect Konfiguration

#Schritt 5.1: Zu Einstellungen in Kibi Connect navigieren

Links in der Leiste: Such nach Einstellungen und klick da.

• Scroll runter zum Microsoft Entra Integration-Abschnitt

• Klick auf Integration konfigurieren

#Schritt 5.2: Integration konfigurieren

Auf der Microsoft Entra Integration-Seite:

• Klick auf Integration aktivieren

#Schritt 5.3: Schlüssel zu Verbindungseinstellungen hinzufügen

Nach der Aktivierung siehst du diese Felder:

• Verbindungseinstellungen

• Synchronisationseinstellungen

• Aktionen

• Setup-Anleitung

Klick auf Verbindungseinstellungen, um die Schlüssel einzutragen.

Jetzt musst du die Schlüssel eintragen:

• Mandanten-ID

• Client-ID

• Client-Geheimnis

Die Schlüssel findest du in deiner neu erstellten App-Übersicht in Microsoft Entra unter App-Registrierungen.

Das Client-Geheimnis ist auf der Zertifikate und Geheimnisse-Seite (Schritt 2.4).

Trag die Schlüssel ein und klick dann auf Verbindungseinstellungen speichern.

#Schritt 5.4: Verbindung testen

Nach dem Speichern siehst du den Testverbindung-Button.

• Klick auf Verbindung testen

• Wenn alles klappt, kommt die Meldung: Anmeldedaten gültig

#Schritt 5.5: SSO aktivieren (Optional)

Falls du Single Sign-On nutzen willst und die Redirect URI (Schritt 3b) konfiguriert hast:

• Aktivier den Schalter Single Sign-On (SSO) aktivieren

• Check die angezeigte Redirect URL – muss mit der in Entra übereinstimmen

• Speicher die Einstellungen

Auf der Login-Seite erscheint jetzt ein "Mit Microsoft anmelden"-Button für deine User.

#Übersicht: Was wo konfiguriert wird

#6. Automatische Gruppenzuweisung

Kibi Connect kann User automatisch Gruppen zuweisen, basierend auf Infos aus Microsoft Entra (Active Directory). So landen neue Leute direkt in der richtigen Abteilungs- oder Standortgruppe.

#Schritt 6.1: Gruppen für die Zuordnung konfigurieren

Für jede Gruppe, die automatisch befüllt werden soll, musst du das passende Zuordnungsfeld setzen:

1. Gehe zur Gruppenbearbeitung in Kibi Connect.

2. Im Bereich Gruppeneinstellungen findest du zwei optionale Felder:

• MS Entra Department: Trag hier den exakten Abteilungsnamen ein, wie er in Microsoft Entra steht (z. B. "Kundenservice", "Marketing").

• MS Entra Office Location: Trag hier den exakten Standort ein, wie er in Microsoft Entra steht (z. B. "Berlin", "A13").

#Schritt 6.2: Funktionsweise der automatischen Zuordnung

Bei jeder Sync mit Microsoft Entra passiert Folgendes:

• Kibi Connect liest Abteilung und Standort jedes Users aus Microsoft Entra.

• Wenn eine Gruppe ein passendes MS Entra Department oder Office Location Feld hat, wird der User automatisch dieser Gruppe zugewiesen.

• Neue Gruppen werden automatisch erstellt, wenn mindestens 2 User mit derselben Abteilung oder demselben Standort existieren.

• Bestehende Gruppenmitgliedschaften bleiben erhalten.

#Schritt 6.3: Beispiel

Angenommen, du hast folgende Struktur in Microsoft Entra:

Und in Kibi Connect erstellst du:

• Gruppe "Vertrieb" mit MS Entra Department = "Vertrieb"

• Gruppe "Standort Berlin" mit MS Entra Office Location = "Berlin"

Nach der Sync wird Max Mustermann automatisch den Gruppen "Vertrieb" und "Standort Berlin" zugewiesen, Erika Musterfrau der Gruppe "Vertrieb" und Hans Beispiel den Gruppen "Marketing" (falls vorhanden) und "Standort Berlin".