If you use Microsoft Entra ID (formerly Azure Active Directory) as your identity provider and choose the SAML method for external authentication of the Lucanet CFO Solution Platform, you must first register Lucanet as an enterprise application in the Microsoft Entra admin center.

After completing the registration and configuration in Microsoft Entra ID, you can copy the authentication parameters from Microsoft Entra ID and paste them into the Lucanet CFO Solution Platform to complete the configuration of external authentication.

To create an Enterprise application for Lucanet in Microsoft Entra ID:

1

Open the Azure Portal or the Microsoft Entra admin center at https://entra.microsoft.com.

2

Navigate to Enterprise applications. Click + New application.

Shows the 'Enterprise applications | All applications' page in Microsoft Entra ID, opened in the 'Microsoft Azure' portal, with the 'New application' and 'Refresh' buttons.
'Enterprise applications' workspace in the Microsoft Entra admin center
3

On the displayed page Browse Microsoft Entra Gallery, click Create your own application.

Shows the 'Browse Microsoft Entra Gallery' page in Microsoft Entra ID with the 'Create your own application' button.
'Create your own application' button
4

Enter a name for the application and choose Integrate any other application you don't find in the gallery (Non-gallery). For example, you can name the application Lucanet CFO Platform Authentication SAML 2.

Shows the 'Create your own application' panel in Microsoft Entra ID with the name 'Lucanet CFO Platform Authentication SAML2' entered under 'What's the name of your app?' and the option 'Integrate any other application you don't find in the gallery (Non-gallery)' selected.
Creating your own application
5

Click Create.

We recommend setting Assignment required to No in the Properties to simplify the configuration and reduce administrative effort. This allows all users in your Microsoft Entra ID organization to access the application automatically, without the need to manually assign individual users or groups.

However, if your organization requires stricter access control for security or compliance reasons, you can keep the setting at Yes.

To configure user assignment for the enterprise application for Lucanet in Microsoft Entra ID:

1

In the created enterprise application, navigate to Manage | Properties.

Shows the menu of the enterprise application in Microsoft Entra ID with the 'Properties' entry selected under 'Manage'.
'Properties' section
2

Set the Assignment required toggle based on your requirements:

Shows the 'Assignment required?' toggle in Microsoft Entra ID set to 'No'.
Setting 'Assignment required' to 'no'
3

Click Save.

Go to the newly created enterprise application and perform the following steps to configure Single Sign-On for Lucanet in Microsoft Entra ID:

1

Navigate to Manage | Single sign-on.

Shows the menu of the enterprise application in Microsoft Entra ID with the entries 'Properties', 'Owners', 'Roles and administrators', 'Users and groups', and 'Single sign-on' under 'Manage'. The 'Single sign-on' entry is selected.
'Single sign-on' workspace in the Microsoft Entra admin center
2

Select SAML as the single sign-on method.

Shows the 'Select a single sign-on method' page in Microsoft Entra ID with the options 'Disabled' and 'SAML'.
Selecting 'SAML' as the single sign-on method

The options for the Basic SAML Configuration are displayed as follows:

Shows the 'Set up Single Sign-On with SAML' page in Microsoft Entra ID with the 'Basic SAML Configuration' area and its 'Edit' button. 'Identifier (Entity ID)' and 'Reply URL (Assertion Consumer Service URL)' are marked as 'Required'; 'Sign on URL', 'Relay State (Optional)', and 'Logout Url (Optional)' are marked as 'Optional'.
Options for Basic SAML Configuration on the 'Set up Single Sign-On with SAML' page
3

Copy the Entity ID from the External authentication workspace in the Lucanet CFO Solution Platform.

Shows the 'Administration' menu in the CFO Solution Platform. Highlighted in red is the 'External authentication' entry under 'Platform management'.
'External authentication' workspace in Lucanet
Shows the 'Entity ID' value in the 'External authentication' workspace in the CFO Solution Platform with the 'Copied' tooltip on the copy icon.
Copying the 'Entity ID' from Lucanet CFO Solution Platform
4

In the Basic SAML Configuration area in the Microsoft Entra admin center, click Add identifier under Identifier (Entity ID).

Shows the 'Basic SAML Configuration' panel in Microsoft Entra ID with the description of the 'Identifier (Entity ID)' field and the 'Add identifier' link.
Button for adding Entity ID in the Microsoft Entra admin center
5

Paste the Entity ID copied from Lucanet into the corresponding field.

Shows the 'Identifier (Entity ID)' area in Microsoft Entra ID with an entity ID starting with 'urn:amazon:cognito:sp:' entered in the field.
Entity ID added in the Microsoft Entra admin center
6

Copy the Reply URL from the External authentication workspace in the Lucanet CFO Solution Platform.

Shows the 'Administration' menu in the CFO Solution Platform. Highlighted in red is the 'External authentication' entry under 'Platform management'.
'External authentication' workspace in Lucanet
Shows the 'Reply URL' value in the 'External authentication' workspace in the CFO Solution Platform with the 'Copied' tooltip on the copy icon.
Copying the 'Reply URL' from the Lucanet CFO Solution Platform
7

In the Basic SAML Configuration area in the Microsoft Entra admin center, click Add reply URL under Reply URL (Assertion Consumer Service URL).

Shows the 'Basic SAML Configuration' panel in Microsoft Entra ID with the 'Identifier (Entity ID)' and 'Reply URL (Assertion Consumer Service URL)' areas and the 'Add reply URL' link.
Button for adding reply URL in the Microsoft Entra admin center
8

Paste the Reply URL copied from Lucanet into the corresponding field.

Shows the 'Reply URL (Assertion Consumer Service URL)' area in Microsoft Entra ID with a reply URL entered in the field and the 'Index' value '0'.
Reply URL added in the Microsoft Entra admin center
9

Click Save.

After configuring the enterprise application and Single Sign-On in Microsoft Entra ID, you need to retrieve specific authentication parameters and add them to the Lucanet CFO Solution Platform to complete the external authentication setup.

To configure authentication parameters for the Lucanet CFO Solution Platform:

1

Get the App Federation Metadata Url from the Microsoft Entra admin center:

In the Enterprise application for Lucanet, navigate to Manage | Single sign-on | Set up Single Sign-on with SAML. In the SAML Certificates area, copy the App Federation Metadata Url.

Shows the 'SAML Certificates' area in Microsoft Entra ID with the 'Token signing certificate' details and the 'Copy to clipboard' button next to the 'App Federation Metadata Url' value.
Copying App Federation Metadata URL
2

Add the App Federation Metadata Url to the Lucanet CFO Solution Platform:

In the Lucanet CFO Solution Platform, navigate to the External authentication workspace.

Shows the 'Administration' menu in the CFO Solution Platform. Highlighted in red is the 'External authentication' entry under 'Platform management'.
'External authentication' workspace in Lucanet

Paste the App Federation Metadata Url into the Metadata document URL field.

Shows the 'External authentication' workspace in the CFO Solution Platform with the status 'Not active', the 'Activate external authentication' check box activated, the option 'SAML - Entra' selected in the drop-down list under 'Please choose the authentication procedure.', and a URL starting with 'https://login.microsoftonline.com/' in the 'Metadata document URL' field.
'Metadata document URL' field in Lucanet
3

Get the Attribute value from the Microsoft Entra admin center:

In the Enterprise application for Lucanet, navigate to Manage | Single sign-on | Set up Single Sign-on with SAML.

Shows the menu of the enterprise application in Microsoft Entra ID with the entries 'Properties', 'Owners', 'Roles and administrators', 'Users and groups', and 'Single sign-on' under 'Manage'. The 'Single sign-on' entry is selected.
'Single sign-on' workspace in the Microsoft Entra admin center

In the Attributes & Claims area, click Edit. The Attributes & Claims page will be displayed as follows, for example:

Shows the 'Attributes & Claims' page in Microsoft Entra ID with the 'Required claim' and 'Additional claims' areas. The pointer is on the 'user.mail' value of the first additional claim.
'Attributes & Claims' page in the Microsoft Entra admin center

In the Additional claims area, click the row with the value user.mail. The Manage claim page will be displayed as follows, for example:

Shows the 'Manage claim' page in Microsoft Entra ID with the 'Name' value 'emailaddress' and the selected 'Namespace' value 'http://schemas.xmlsoap.org/ws/2005/05/identity/claims'.
'Manage claim' page with the claim 'Name' and the 'Namespace'

Copy the Namespace field value and the Name field value. Combine them to create the Attribute value using the following structure:

Namespace/Name

Example:

  • Namespace: http://schemas.xmlsoap.org/ws/2005/05/identity/claims
  • Name: emailaddress
  • Attribute: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
4

Add the Attribute value to the Lucanet CFO Solution Platform:

In the Lucanet CFO Solution Platform, navigate to the External authentication workspace.

Shows the 'Administration' menu in the CFO Solution Platform. Highlighted in red is the 'External authentication' entry under 'Platform management'.
'External authentication' workspace in Lucanet

Paste the Attribute value into the Attribute field.

Shows the 'Attribute' field in the 'External authentication' workspace in the CFO Solution Platform with a value starting with 'http://schemas.xmlsoap.org/ws/2005/05/identity/claims/'.
'Attribute' field in Lucanet

Attention: The e-mail address of a user on the Lucanet CFO Solution Platform must be identical to the e-mail address in Microsoft Entra ID. The upper and lower case of e-mail addresses must match exactly.

You can find additional information on how to use the parameters when configuring the external authentication for the Lucanet CFO Solution Platform with the SAML method in the section Configuring SAML in Configuring External Authentication.

This content was generated using AI and reviewed by Lucanet subject matter experts before publication.