Setting up automatic login with SAML
General information
Setup requires advanced knowledge of SAML 2.0, single sign-on, and your identity provider. Once initialized as described here, login can be configured via the nele.ai admin area at https://app.nele.ai/admin/sso; please also read the corresponding manual article on the topic.
Members who receive a nele.ai account automatically via single sign-on are not automatically deleted or deactivated. These members can be deleted manually at https://app.nele.ai/admin/users.
Identity provider settings
Create a new app in Microsoft Entra ID. Use the "New application" button and then select "Create your own application."

Then, choose an app name and select "Integrate any other application you don't find in the gallery”.

Set the single sign-on method to "SAML".

For the following configuration, ignore steps 1 and 2 for now, download the "Certificate (Base64)" from step 3, and copy the Microsoft Entra identifier and the login & logout URLs from step 4.

nele.ai settings
Enter the copied values into the nele.ai settings in the admin area at https://manage.nele.ai/sso.

- IDP entity ID – Microsoft Entra identifier from step 4
- IDP login URL – Login URL from step 4
- IDP logout URL – Logout URL from step 4
- IDP x509 certificate – Certificate (Base64) from step 3

Afterwards, you can save the configuration in nele.ai and open the generated metadata XML for the Entra ID configuration.

In step 1, enter the entityID (URL, ends in "/metadata") as the Identifier (Entity ID) and the "Reply URL" (URL, ends in "/acs").
In step 2, set the "Unique User Identifier (Name ID)" to "user.mail [nameid-format:emailAddress]".

To transfer group memberships, additionally add a group attribute named http://schemas.microsoft.com/ws/2008/06/identity/claims/groups.
The complete attribute configuration in the metadata XML looks like this:
<md:AttributeConsumingService index="1">
<md:ServiceName xml:lang="en">
nele.ai
</md:ServiceName>
<md:ServiceDescription xml:lang="en">
nele.ai SAML service provider
</md:ServiceDescription>
<md:RequestedAttribute
Name="http://schemas.microsoft.com/ws/2008/06/identity/claims/groups"
NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified"
isRequired="false"
/>
</md:AttributeConsumingService>
Configuring group transfer
Group memberships are not automatically transferred from Entra ID to nele.ai for all of a user's groups. Instead, you must explicitly define which groups should be transferred:
Create groups in Entra ID: First, create the desired groups in Microsoft Entra ID.
Assign users to groups: Assign the relevant users to the groups you have created.
Assign groups to the nele.ai app: Navigate to your nele.ai SAML application in Entra ID and assign the groups that should be transferred to nele.ai. Only groups explicitly assigned to the app will be included in the transfer.
Transfer logic: During login, only groups assigned to both the user and the nele.ai app in Entra ID are transferred. Groups assigned only to the user, but not to the app, will not be transferred.
This configuration gives you full control over which group memberships are shared with nele.ai.

You can test a successful configuration via a link in the administration area. If everything is set up correctly, you will be redirected to an overview page where you can choose, among other things, whether you want to log in to the desktop app or the web app. Alternatively, you can download nele.ai for various operating systems there.
