ADFS Authentication (SAML)

Ivanti Neurons currently offers the option to choose ADFS (Active Directory Federation Services) as the external authentication provider for your tenant. ADFS authentication is a single sign-on (SSO) system that enables users to securely access applications and resources across different domains with a single login using security tokens. This streamlines user experience, improves security by reducing password reuse, and simplifies identity management for organizations.

ADFS authentication only supports the SAML based sign-in method.

Konfigurieren und Aktivieren der externen Authentifizierung

  1. Wechseln Sie auf der Ivanti Neurons-Plattform zu Admin > Authentifizierung.

    Die Seite Authentifizierung wird angezeigt.

  2. Klicken Sie im Abschnitt Externe Authentifizierung (SSO) auf Konfigurieren & aktivieren.

    Die Seite Externe Authentifizierung aktivieren (SSO) wird angezeigt.

  3. From the Provider drop-down, select ADFS.

    The ADFS SAML 2.0 Configuration Settings page appears. It is recommended to leave this tab open for future reference when configuring details in the ADFS Service Manager console.

  4. On the ADFS SAML 2.0 Configuration Settings section, you can select the following options:

    • Enable Signed requests: Enable this option to send digitally signed requests to an external authentication provider and configure the provider to validate whether the signed requests are from the Ivanti Neurons tenant. Alternatively, you can disable this option to stop sending signed requests.

    • Enable Encrypted assertions: Enable this option to receive encrypted user information from the external authentication provider, and you can configure the Neurons tenant to decrypt the information. Alternatively, you can disable this option to stop receiving encrypted user information.

  5. Click Apply Changes.
    Once you apply the changes, you can download the identity information, such as service provider metadata and certificate, for a SAML-based SSO system as given below:

    • Download SP metadata: Click this option to download the service provider metadata along with the certificate in XML format.

    • Download certificate only: Click this option to download only the certificate (in .pem format).

  1. Log in to the ADFS Service Manager console.
    The Dashboard appears.

  2. From the Service Manager's Dashboard, navigate to Tools > AD FS Management.
    The AD FS management wizard appears.

  3. On the Actions section, expand AD FS and select the Add Relying Party Trust option.

    The Add Relying Party Trust Wizard appears with multiple steps to perform the configuration.

  4. On the Welcome step, select the Claims aware option and click Start.

  5. On the Select Data Sources step, select Enter data about the relying party trust manually. Then, click Next.

  6. On the Specify Display Name step, enter a name for the relying party trust. Then, click Next.

  7. On the Configure Certificate step, you can upload the encryption certificate (in .cer format) that you downloaded from Ivanti Neurons.
    To upload an encryption certificate, click Browse. This configures the encrypted assertions for ADFS. Then, click Next.

    For more information about downloading the certificate, refer to the steps under the Configure and Enable External Authentication (Ivanti Neurons Platform) section.

  1. On the Configure URL step, select Enable support for the SAML 2.0 WebSSO protocol options and copy-paste the service URL from the Neurons Platform. Then, click Next.

    For the service URL, go back to the Ivanti Neurons and copy the Assertion Consumer Service URL from the ADFS SAML 2.0 Configuration Settings section.

  2. On the Configure Identifiers step, enter the Relying party trust identifier, and click Add. Then, click Next.

    For the Relying party trust identifier, go back to Ivanti Neurons and copy the Entity ID under the ADFS SAML 2.0 Configuration Settings section.

  1. On the Choose Access Control Policy step, choose a policy under the Choose an access control policy section based on your organizational requirements. Then, click Next to complete the setup.

    This closes the Add Relying Party Trust Wizard and creates the relying party trust configuration.

  1. On the AD FS management wizard, select the Relying Party Trusts folder.
    This displays the relying party trust configuration you created.

  2. Double-click the relying party trust configuration you created and navigate to the Signature tab.

  3. Click Add to browse and upload the signature verification certificate.

    For more information about downloading the certificate, refer to steps under the Configure and Enable External Authentication (Ivanti Neurons Platform) section.

Ensure that the ADFS configuration includes the required claims that are applicable for Ivanti Neurons.

  1. On the AD FS management wizard, click the Edit Claim Issuance Policy option under the Actions section.

    The Edit Claim Issuance Policy wizard for the selected relying party trust configuration you created.

  2. Click Add Rule.

    The Add Transformation Claim Rule Wizard appears with configuration steps.

  3. On the Choose Rule Type step, select Send LDAP Attributes as Claims option and click Next.

  4. On the Configure Claim Rule step, enter a claim name, select attribute store, and perform required mappings for LDAP attributes.

    Ensure that, the following mappings are configured:

    • E-mail-Addresses -> E-mail Address

    • Given-Name -> Given Name

    • Surname -> Surname

    • E-mail-Addresses -> Name ID

  5. Then, click Finish.
    The Edit Claim Issuance Policy wizard appears.

  6. Click Apply.

Once the ADFS configuration is complete, you must apply the identity provider metadata endpoint URL in the Ivanti Neurons application.

  1. Identify and copy the metadata URL of your ADFS provider.

    The IdP metadata URL of your ADFS provider will be in the following format:
    https://<adfs-federation-service-name>/FederationMetadata/2007-06/FederationMetadata.xml"

  2. Go back to Ivanti Neurons Platform and paste the URL in the Identity Provider Metadata Endpoint URL field.
    This will validate the URL.

  3. Click Continue to proceed.

You must connect with your ADFS server to validate your connection settings.

  1. Klicken Sie auf der Seite Verbindungseinstellungen validieren auf Einstellungen validieren.

    Die Validierung findet automatisch statt. Bei erfolgreicher Anmeldung wird eine Bestätigung angezeigt.

  2. Kehren Sie zurück zur Seite Verbindungseinstellungen validieren und markieren Sie das Kontrollkästchen, um die erfolgreiche Anmeldung zu bestätigen.

  3. Klicken Sie auf Weiter, um die Seite Ivanti Neurons-Plattformkonto konvertieren aufzurufen.

Okta ist jetzt konfiguriert, jedoch noch nicht aktiviert.

Für die Aktivierung müssen Sie Ihre Ivanti Neurons-Plattformkonten für die Verwendung von Okta konvertieren.

  1. Klicken Sie auf der Seite Ivanti Neurons-Plattformkonten aktivieren auf Abmelden & aktivieren.
    Die Ivanti Neurons-Anmeldeseite wird angezeigt.
  2. Select the Sign In with ADFS and enter your ADFS credentials, the conversion will then be complete.
    Melden Sie sich zur Überprüfung bei Neurons an, wechseln Sie zu Admin > Authentifizierung und vergewissern Sie sich, dass Entra ID als Anbieter für die externe Authentifizierung aufgeführt wird.

    3. Es muss ein und derselbe Benutzer die Entra ID-Authentifizierung und Anmeldung konfigurieren und die Anmeldeinformationen in Ivanti Neurons validieren, um Fehler vom Typ 'Zugriff verweigert' zu vermeiden.

Alle Mitglieder werden per E-Mail darüber informiert, dass das Konto konvertiert wurde und der Zugriff auf den Mandanten ab sofort über die Okta-Anmeldeinformationen erfolgt. Falls ein Mitglied keine Okta-Anmeldeinformationen besitzt, hat es keinen Zugriff auf Ivanti Neurons.

Die externe Authentifizierung (SSO) wird jetzt mit dem Status Aktiviert angezeigt.

Konfigurieren der automatischen Bereitstellung

Durch Aktivieren der automatischen Bereitstellung erhalten alle Mitglieder innerhalb der Entra ID-App-Registrierung automatisch Zugriff auf Ivanti Neurons, ohne dass der manuelle Einladungsprozess durchlaufen werden muss. Wenn sich ein Mitglied das erste Mal anmeldet, wird unter Ivanti Neurons > Mitglieder ein neues Ivanti Neurons-Plattformkonto angelegt. Allen neuen automatisch bereitgestellten Mitgliedern werden die im Setup definierten Zugriffskontrollregeln zugewiesen.

  1. Wechseln Sie auf der Ivanti Neurons-Plattform zu Setup > Authentifizierung.

    Die Seite Authentifizierungsmethode wird angezeigt.

  2. Klicken Sie im Abschnitt Externe Authentifizierung auf Aktionen und wählen Sie Automatische Bereitstellung aktivieren aus.

  3. Wählen Sie aus der Dropdownliste Standardrollen die Rolle für die Zugriffskontrolle aus, die allen neuen Mitgliedern zugewiesen werden soll.

    Rollen können Sie unter Ivanti Neurons > Admin > Rollen einrichten.

  4. Klicken Sie auf Automatische Bereitstellung aktivieren, um die Rollenauswahl zu bestätigen und die automatische Bereitstellung für alle neuen Mitglieder zu aktivieren.

Nach der Aktivierung können Sie die voreingestellten Zugriffskontrollrollen bearbeiten und die automatische Bereitstellung deaktivieren. Diese Änderungen wirken sich nur auf Mitglieder aus, die nach der Modifizierung bereitgestellt werden, nicht jedoch auf vorhandene Mitglieder.

(Optional) Update Provider Setting (Ivanti Neurons Platform)

This action enables you to choose whether to use a signed requests, encrypted assertions, or both.

  1. Wechseln Sie auf der Ivanti Neurons-Plattform zu Admin > Authentifizierung.

    Die Seite Authentifizierung wird angezeigt.

  2. In the External Authentication section, click Actions > Update provider setting.

    The Update SAML provider page appears.

  3. In ADFS Configuration Settings, you can select the following:

    • Enable Signed requests: Enable this option to send digitally signed requests to an external authentication provider and configure the provider to validate whether the signed requests are from Ivanti Neurons tenant. Alternatively, you can disable this option to stop sending signed requests.

    • Enable Encrypted assertions: Enable this option to receive an encrypted user information from the external authentication provider and you can configure the Neurons tenant to decrypt the information. Alternatively, you can disable this option to stop receiving encrypted user information.

  4. Click Apply Changes.

    Now, you can download the updated service provider metadata file and certificate based on your requirements.

    Once you have downloaded the updated encrypted certificate, ensure that the new certificate is uploaded to the ADFS system manager. To upload the certificate, refer to the ADFS Setup (Server Manager console) section.

  5. Klicken Sie auf Fortfahren, um die Metadaten zu validieren.

  6. On the Validate SAML Provider Setting page, click Validate Setting.

  7. Eine neue Registerkarte wird auf der Anmeldeseite Ihres Unternehmens angezeigt. Geben Sie Ihre Anmeldeinformationen ein, um sich anzumelden.

    Die Validierung findet automatisch statt. Bei erfolgreicher Anmeldung wird eine Bestätigung angezeigt.

  8. Return to the Validate New Provider Setting page and select the check box to confirm login success.

  9. Click Continue to proceed.

  10. Klicken Sie auf Änderungen speichern, um den Vorgang abzuschließen.

    Es wird eine Benachrichtigung empfangen, die bestätigt, dass der geheime Clientschlüssel aktualisiert wurde.

(Optional) Update Certificate (Ivanti Neurons Platform)

You can use this option to update the expired certificate or when a certificate is about to expire.

The renew function is intended to be used during low usage hours. Once Neurons renews the certificate, it begins using it immediately. This will cause failed authentication events at the Identity Provider until the IdP is updated to expect the new certificate. Please plan accordingly and ensure that coordinated changes occur in your IdP software.

  1. Wechseln Sie auf der Ivanti Neurons-Plattform zu Admin > Authentifizierung.
    Die Seite Authentifizierung wird angezeigt.

  2. In the External Authentication section, click Actions >Update certificate.
    The Update Certificate screen appears.

  3. Klicken Sie auf Fortfahren.
    The Update tab appears.

  4. On the Update tab, you can download the service provider metadata and certificate.

    Once you have downloaded the encrypted certificate, ensure that the new certificate is uploaded to the identity provider console before validating.

  5. Click Continue to go to the Validate New Certificate page.

  6. Click Validate Certificate.
    Die Validierung findet automatisch statt. Bei erfolgreicher Anmeldung wird eine Bestätigung angezeigt.

  7. Kehren Sie zurück zur Seite Verbindungseinstellungen validieren und markieren Sie das Kontrollkästchen, um die erfolgreiche Anmeldung zu bestätigen.

  8. Klicken Sie auf Fortfahren.
    The Save New Certificate page appears.

  9. Click Save Changes.

(Optional) Download SP Metadata or Certificate (Ivanti Neurons Platform)

If the external authentication setup for ADFS has to be redone due to issues or errors, it will require either the certificate or the SP metadata. These can be downloaded from the actions drop-down from Ivanti Neurons, as below:

  1. Wechseln Sie auf der Ivanti Neurons-Plattform zu Admin > Authentifizierung.

    Die Seite Authentifizierung wird angezeigt.

  2. In the External Authentication (SSO) section, click Actions. From the drop-down, you can click the following:

    • Download SP metadata: Click this option to download the service provider metadata along with the certificate in XML format.

    • Download certificate only: Click this option to download only the certificate (in .pem format).

    The SP metadata file would have the last saved version of provider configuration settings, and the certificate would be the last active certificate.

(Optional) Authentifizierungsmethode löschen (Ivanti Neurons Platform)

  1. Wechseln Sie auf der Ivanti Neurons-Plattform zu Admin > Authentifizierung.

    Die Seite Authentifizierung wird angezeigt.

  2. Klicken Sie im Abschnitt Externe Authentifizierung auf Aktionen > Authentifizierungsmethode löschen.

    Der Bildschirm Externe Authentifizierung löschen wird angezeigt.

  3. Klicken Sie auf Abmelden & neu authentifizieren.

    Ivanti Neurons wird abgemeldet.

  4. Klicken Sie auf Mit E-Mail-Adresse und Kennwort anmelden.

  5. Geben Sie die Anmeldeinformationen ein und klicken Sie auf Anmelden.

  6. Navigieren Sie zu Admin > Authentifizierung > Externe Authentifizierung und klicken Sie auf Aktionen > Authentifizierungsmethode löschen.

    Der Bildschirm Externe Authentifizierung löschen wird angezeigt.

  7. Klicken Sie auf Authentifizierungsmethode löschen.

    Die vorhandene Authentifizierungsmethode wird gelöscht.