Lucanet bei Verwendung der OIDC-Methode als App in MS Entra ID registrieren

Dokumentation

Getting Started

Globale Funktionen

Lucanet Lume

Administration

Benutzerverwaltung

CFO Solution Platform verwalten

Lucanet-Lizenzen verwalten

Externe Authentifizierung konfigurieren

Lucanet bei Verwendung der OIDC-Methode als App in MS Entra ID registrieren

Lucanet SAML Single Sign-On mit Microsoft Entra ID/Azure konfigurieren

SEA-Zertifikate erzeugen und herunterladen

Kundenspezifische Anpassungen konfigurieren

Wechselkursverwaltung

Data Hub

Consolidation & Financial Planning

Lease Accounting

Extended Planning and Analysis (xP&A)

ESG Reporting

Disclosure Management

XBRL-Tagger

Tax Compliance & Reporting

Banking & Cash Management

Data Collection

Glossar

Wenn Sie Microsoft Entra ID (ehemals Azure Active Directory) als Identity-Provider verwenden und die OIDC-Methode für die externe Authentifizierung der Lucanet CFO Solution Platform wählen, müssen Sie zunächst Lucanet als App in Microsoft Entra ID registrieren.

Nach erfolgreicher Registrierung und Konfiguration können Sie die Authentifizierungsparameter in Microsoft Entra ID kopieren und in die Lucanet CFO Solution Platform einfügen, um die Konfiguration der externen Authentifizierung abzuschließen.

So legen Sie im Microsoft Entra Admin Center eine App-Registrierung für Lucanet an:

Öffnen Sie das Microsoft Entra Admin Center unter https://entra.microsoft.com oder das Azure Portal.

Navigieren Sie zu Applications | App registrations.

Zeigt das Navigationsmenü des Microsoft Entra Admin Center mit dem aufgeklappten Bereich 'Identity'. Rot hervorgehoben sind der Eintrag 'Applications' und der darunterliegende Eintrag 'App registrations'. — Arbeitsbereich 'App registrations' im Microsoft Entra Admin Center

Klicken Sie auf New registration.

Zeigt die Seite 'App registrations' in Microsoft Entra ID mit den Optionen 'New registration' und 'Endpoints'. Rot hervorgehoben ist die Option 'New registration'. — Schaltfläche zur Registrierung einer neuen App

Die Seite Register an application wird angezeigt.

Geben Sie im Feld unter Name den Anzeigenamen der App an.

Zeigt das Feld 'Name' für den Anzeigenamen der Anwendung in Microsoft Entra ID mit einem eingegebenen Beispielnamen. — Anzeigenamen der App angeben

Wählen Sie unter Supported account types die Option Accounts in this organizational directory only ( <Ihr Unternehmen> only - Single tenant).

Zeigt den Bereich 'Supported account types' in Microsoft Entra ID mit der gewählten Single-Tenant-Option 'Accounts in this organizational directory only'. — Auswahl des unterstützten Kontotyps

Kopieren Sie im Arbeitsbereich Externe Authentifizierung in der Lucanet CFO Solution Platform die URI unter Sign-in Umleitungs-URL(s).

Zeigt das Feld 'Sign-in Umleitungs-URL(s)' mit einer Umleitungs-URL und dem Tooltip 'Kopiert' nach dem Kopieren in der CFO Solution Platform. Rot hervorgehoben ist die Umleitungs-URL. — Umleitungs-URL aus der Lucanet CFO Solution Platform kopieren

Wählen Sie in Microsoft Entra ID ggf. im Bereich Redirect URI (optional) aus der Dropdown-Liste Web und fügen Sie die URI in das Feld hinter Web ein.

Zeigt den Bereich 'Redirect URI (optional)' in Microsoft Entra ID mit dem in der Dropdown-Liste gewählten Eintrag 'Web' und einer im Feld daneben eingegebenen Redirect-URI. — Konfiguration der Redirect-URI

Klicken Sie auf Register.

Zeigt die Schaltfläche 'Register' unter dem Hinweis auf die Microsoft Platform Policies in Microsoft Entra ID. — App-Registrierung abschließen

Navigieren Sie zu der neu erstellten App-Registrierung und führen Sie die folgenden Schritte aus, um Lucanet als App in Microsoft Entra ID zu konfigurieren:

So aktivieren Sie die ID-Token für die App-Registrierung in Microsoft Entra ID:

Navigieren Sie zu Manage | Authentication.

Zeigt die Navigationsleiste der App-Registrierung in Microsoft Entra ID mit dem gewählten Eintrag 'Authentication' unter 'Manage'. — Arbeitsbereich 'Authentication' in der Navigationsleiste

Aktivieren Sie im Bereich Implicit grant and hybrid flows das Kontrollkästchen ID tokens (used for implicit and hybrid flows).

Zeigt den Bereich 'Implicit grant and hybrid flows' in Microsoft Entra ID mit dem aktivierten Kontrollkästchen 'ID tokens (used for implicit and hybrid flows)' und dem nicht aktivierten Kontrollkästchen 'Access tokens (used for implicit flows)'. — 'ID tokens' aktivieren

So legen Sie in Microsoft Entra ID einen geheimen Client-Schlüssel (Client secret) für Lucanet an:

Navigieren Sie zu Manage | Certificates & secrets.

Zeigt die Navigationsleiste der App-Registrierung in Microsoft Entra ID mit dem gewählten Eintrag 'Certificates & secrets' unter 'Manage'. — Arbeitsbereich 'Certificates & secrets' in der Navigationsleiste

Klicken Sie auf dem Reiter Client secrets auf die Schaltfläche :

Geben Sie im Bereich Add a client secret im Feld Description einen Namen oder eine Beschreibung für das Secret an und wählen Sie ggf. aus der Dropdown-Liste Expires eine Gültigkeitsdauer für das Secret:

Zeigt den Bereich 'Add a client secret' in Microsoft Entra ID mit einer Beispielbeschreibung im Feld 'Description' und dem in der Dropdown-Liste 'Expires' gewählten Eintrag 'Recommended: 180 days (6 months)'. — Einstellungen im Bereich 'Add a client secret'

Klicken Sie auf Add. Ein Client-Schlüssel wird generiert, der auf dem Reiter Client secrets in der Spalte Value angezeigt wird:

Zeigt einen Client-Schlüssel in Microsoft Entra ID mit den Spalten 'Description', 'Expires', 'Value' und 'Secret ID' und dem Tooltip 'Copied' neben dem Wert. Rot hervorgehoben ist der Client-Schlüssel in der Spalte 'Value'. — Geheimen Client-Schlüssel aus Microsoft Entra ID kopieren

Fügen Sie den Wert in das Feld Geheimer Client-Schlüssel in der Lucanet CFO Solution Platform ein.

Zeigt den Arbeitsbereich 'Externe Authentifizierung' in der CFO Solution Platform mit dem gewählten Authentifizierungsverfahren 'OIDC' und den Feldern 'Client-ID', 'Geheimer Client-Schlüssel' und 'Aussteller-URL'. Rot hervorgehoben sind der Eintrag 'Externe Authentifizierung' unter 'Platform-Verwaltung' und das Feld 'Geheimer Client-Schlüssel'. — Feld 'Geheimer Client-Schlüssel' in Lucanet

So konfigurieren Sie optionale Ansprüche für Lucanet als App in Microsoft Entra ID:

Navigieren Sie zu Manage | Token configuration.

Zeigt die Navigationsleiste der App-Registrierung in Microsoft Entra ID mit dem gewählten Eintrag 'Token configuration' unter 'Manage'. — Arbeitsbereich 'Token configuration' in der Navigationsleiste

Klicken Sie auf die Schaltfläche .

Wählen Sie den Token-Typ ID und aktivieren Sie in der Spalte Claim das Kontrollkästchen email.

Zeigt die Einstellungen 'Token type' und 'Claim' in Microsoft Entra ID mit dem gewählten Token-Typ 'ID' und dem aktivierten Kontrollkästchen 'email' in der Spalte 'Claim'. — Einstellung für den Token-Typ 'ID'

Wählen Sie den Token-Typ Access und aktivieren Sie in der Spalte Claim das Kontrollkästchen email.

Zeigt die Einstellungen 'Token type' und 'Claim' in Microsoft Entra ID mit dem gewählten Token-Typ 'Access' und dem aktivierten Kontrollkästchen 'email' in der Spalte 'Claim'. — Einstellung für den Token-Typ 'Access'

Klicken Sie auf Save. Die optionalen Ansprüche werden hinzugefügt und z. B. wie folgt angezeigt:

Zeigt die optionalen Ansprüche in der Token-Konfiguration in Microsoft Entra ID mit dem Anspruch 'email' für die Token-Typen 'ID' und 'Access'. — Optionale Ansprüche konfiguriert

So richten Sie die API-Berechtigungen für Lucanet in Microsoft Entra ID ein:

Navigieren Sie zu Manage | API Permissions.

Zeigt die Navigationsleiste der App-Registrierung in Microsoft Entra ID mit dem gewählten Eintrag 'API permissions' unter 'Manage'. — Arbeitsbereich 'API permissions' in der Navigationsleiste

Klicken Sie im Bereich Configured permissions auf die Schaltfläche .

Klicken Sie auf dem Reiter Microsoft APIs auf Microsoft Graph.

Zeigt den Bereich 'Select an API' in Microsoft Entra ID mit dem Reiter 'Microsoft APIs' und der Kachel 'Microsoft Graph' unter 'Commonly used Microsoft APIs'. — 'Microsoft Graph' auf dem Reiter 'Microsoft APIs'

Klicken Sie auf Delegated permissions.

Zeigt die Option 'Delegated permissions' in Microsoft Entra ID mit der Beschreibung 'Your application needs to access the API as the signed-in user.' — Option 'Delegated permissions'

Aktivieren Sie im Bereich OpenId permissions die Kontrollkästchen email und openid.

Zeigt den Bereich 'OpenId permissions (2)' in Microsoft Entra ID mit den aktivierten Kontrollkästchen 'email' und 'openid' und dem nicht aktivierten Kontrollkästchen 'offline_access'. — Einstellungen im Bereich 'OpenId permissions'

Klicken Sie auf Add permissions.

Klicken Sie im Bereich Configured permissions auf Grant Admin consent for <Ihr Unternehmen>.

Zeigt die Option 'Add a permission' und die Schaltfläche 'Grant admin consent for' mit dem Unternehmensnamen in Microsoft Entra ID. — Schaltfläche für die Erteilung der Admin-Zustimmung

Klicken Sie im daraufhin angezeigten Dialog Grant admin consent confirmation auf Yes.

Die eingerichteten Berechtigungen werden z. B. wie folgt angezeigt:

Zeigt den Bereich 'Configured permissions' in Microsoft Entra ID mit den delegierten 'Microsoft Graph'-Berechtigungen 'email', 'openid' und 'User.Read', die jeweils für das Unternehmen erteilt sind. — API-Berechtigungen in Microsoft Entra ID

Weitere Informationen zur Konfiguration der App-Registrierung in Microsoft Entra ID finden Sie in der Dokumentation von Microsoft.

Nachdem Sie die App-Registrierung in Microsoft Entra ID angelegt und konfiguriert haben, müssen Sie bestimmte Authentifizierungsparameter kopieren und der Lucanet CFO Solution Platform hinzufügen, um die Einrichtung der externen Authentifizierung abzuschließen.

So konfigurieren Sie die Authentifizierungsparameter für die Lucanet CFO Solution Platform:

Kopieren Sie die Client ID aus dem Microsoft Entra Admin Center:

Sie finden die Client ID hinter Application (client) ID im Bereich Essentials auf der Seite Overview:

Zeigt die Navigationsleiste der App-Registrierung in Microsoft Entra ID mit dem gewählten Eintrag 'Overview'. — 'Overview' im Microsoft Entra Admin Center

Zeigt den Bereich 'Essentials' in Microsoft Entra ID mit den Einträgen 'Display name', 'Application (client) ID', 'Object ID', 'Directory (tenant) ID' und 'Supported account types' und dem Tooltip 'Copied' neben der Application (client) ID. Rot hervorgehoben ist 'Application (client) ID'. — Client-ID aus Microsoft Entra ID kopieren

Fügen Sie die Client ID in das Feld Client-ID in der Lucanet CFO Solution Platform ein.

Fügen Sie den Wert Client secret in das Feld Geheimer Client-Schlüssel in der Lucanet CFO Solution Platform ein, falls dies nicht bereits in vorherigen Schritten konfiguriert wurde (siehe Geheimen Client-Schlüssel (Client Secret) anlegen).

Kopieren Sie die Issuer URL aus dem Microsoft Entra Admin Center:

Wählen Sie in den App registrations Ihre Anwendung aus. Klicken Sie auf der Seite Overview auf Endpoints.

Kopieren Sie im Panel Endpoints die Tenant ID aus dem Feld Authority URL (Accounts in this organizational directory only). Verwenden Sie den Teil, der im unten stehenden Screenshot-Beispiel im roten Kasten hervorgehoben ist. Dieser Teil ist die Tenant-ID, die auf https://login.microsoftonline.com/ folgt.

Die Aussteller-URL hat die folgende Notation:

https://sts.windows.net/ <Ihre Tenant-ID in Microsoft Entra ID >

Beispiel:

Wenn Ihre Tenant-ID 123bfsd-as34-sd34-34fg-f35gh67h8 ist, lautet die Aussteller-URL https://sts.windows.net/123bfsd-as34-sd34-34fg-f35gh67h8.

Zeigt das Panel 'Endpoints' in Microsoft Entra ID mit dem Feld 'Authority URL (Accounts in this organizational directory only)', das mit 'https://login.microsoftonline.com' beginnt. Rot hervorgehoben ist die Tenant-ID nach 'https://login.microsoftonline.com/'. — Bereich 'Endpoints' auf der Seite 'Overview' in Microsoft Entra ID

Fügen Sie die Issuer URL in das Feld Aussteller-URL in der Lucanet CFO Solution Platform ein.

Achtung: Die E-Mail-Adresse eines Benutzers in der Lucanet CFO Solution Platform muss mit der E-Mail-Adresse in Microsoft Entra ID identisch sein. Die Groß- und Kleinschreibung der E-Mail-Adressen muss genau übereinstimmen.

Weitere Informationen zur Verwendung der Parameter bei der Konfiguration der externen Authentifizierung für die Lucanet CFO Solution Platform mit der OIDC-Methode finden Sie im Abschnitt OIDC konfigurieren im Kapitel Externe Authentifizierung konfigurieren.

Wenn Ihr User Principal Name und Ihre E-Mail-Adresse in Microsoft Entra ID unterschiedlich sind, funktioniert die OIDC-Konfiguration nicht wie auf dieser Seite beschrieben. Bitte wählen Sie stattdessen SAML als Authentifizierungsmethode.