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.

Externe verificatie configureren en inschakelen

  1. Navigeer op het Ivanti Neurons-platform naar Beheer > Verificatie.

    De pagina Verificatie verschijnt.

  2. Klik in de sectie Externe verificatie (SSO) op Configureren en inschakelen.

    De pagina Externe verificatie inschakelen (SSO) verschijnt.

  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. Klik op de pagina Verbindingsinstellingen valideren op Instellingen valideren.

    De validatie gebeurt automatisch. U krijgt een bevestigingsscherm als de aanmelding is gelukt.

  2. Keer terug naar de pagina Verbindingsinstellingen valideren en schakel het selectievakje in om een gelukte aanmelding te bevestigen.

  3. Klik op Doorgaan om door te gaan naar de pagina Uw Ivanti Neurons-platformaccount converteren.

Okta is nu geconfigureerd, maar niet ingeschakeld.

Om dit in te schakelen, moet u uw Ivanti Neurons Platform-accounts converteren om in plaats daarvan Okta te gebruiken.

  1. Klik op de pagina Ivanti Neurons Platform-accounts inschakelen op Afmelden en inschakelen.
    De pagina Aanmelden bij Ivanti Neurons verschijnt.
  2. Select the Sign In with ADFS and enter your ADFS credentials, the conversion will then be complete.
    Om te verifiëren: meld aan bij Neurons, ga naar Beheer > Authenticatie en zorg dat Entra ID de externe verificatieprovider is.

    3. Dezelfde gebruiker moet Entra ID-verificatie en Aanmelden configureren en moet de referenties valideren in Ivanti Neurons om een fout Toegang geweigerd te vermijden.

Alle leden zullen een e-mail ontvangen om te bevestigen dat de account werd geconverteerd en dat ze de tenant voortaan openen met Okta-gegevens. Als het lid geen Okta-referenties heeft, zal deze geen toegang krijgen tot Ivanti Neurons.

Externe authenticatie (SSO) zal nu verschijnen met de status Ingeschakeld.

Automatische provisionering configureren

Het inschakelen van automatische inrichting zal automatisch toegang verlenen tot Ivanti Neurons voor alle leden binnen de registratie van de Entra-ID-app zonder dat u het handmatige uitnodigingsproces doorloopt. Wanneer een nieuw lid voor het eerst aanmeldt, wordt een nieuwe account voor het Ivanti Neurons-platform ingericht in Ivanti Neurons > Leden. Alle nieuwe automatisch ingerichte leden zullen rollen worden verleend voor toegangsbeheer, gedefinieerd in de instelling.

  1. Navigeer op het Ivanti Neurons-platform naar Instelling > Verificatie.

    De pagina Verificatiemethode verschijnt.

  2. Klik in de sectie Externe authenticatie op Acties en selecteer Automatische inrichting inschakelen.

  3. Kies in de vervolgkeuzelijst Standaardrollen voor de toegangsbeheerrol die u aan alle nieuwe beheerders wilt toewijzen.

    Om Rollen in te stellen, gaat u naar Ivanti Neurons >Beheer> rollenOm Rollen in te stellen, gaat u naar Ivanti Neurons > Admin > Rollen.

  4. Klik op Automatische inrichting inschakelen om de rolselectie te bevestigen en de automatische inrichting in te schakelen voor alle nieuwe leden.

Zodra dit is ingeschakeld, kunt u de standaard rollen voor toegangsbeheer bewerken en automatisch inrichten uitschakelen. Deze wijzigingen zullen alleen van toepassing zijn op leden die zijn ingericht na de wijzigingen en zullen de bestaande leden niet beïnvloeden.

(Optional) Update Provider Setting (Ivanti Neurons Platform)

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

  1. Beheer> Verificatie.

    De pagina Verificatie verschijnt.

  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. Klik op Doorgaan om de metagegevens te valideren.

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

  7. Een nieuw tabblad opent op de aanmeldingspagina van uw organisatie. Voer uw referenties in en meld aan.

    De validatie gebeurt automatisch. U krijgt een bevestigingsscherm als de aanmelding is gelukt.

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

  9. Click Continue to proceed.

  10. Klik op Wijzigingen opslaan om het proces te voltooien.

    Een melding die de gelukte update van het klantgeheim bevestigt, is ontvangen.

(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. Beheer> Verificatie.
    De pagina Verificatie verschijnt.

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

  3. Klik op Doorgaan.
    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.
    De validatie gebeurt automatisch. U krijgt een bevestigingsscherm als de aanmelding is gelukt.

  7. Keer terug naar de pagina Verbindingsinstellingen valideren en schakel het selectievakje in om een gelukte aanmelding te bevestigen.

  8. Klik op Doorgaan.
    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. Navigeer op het Ivanti Neurons-platform naar Beheer > Verificatie.

    De pagina Verificatie verschijnt.

  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.

(Optioneel) Verificatiemethode verwijderen (Ivanti Neurons-platform)

  1. Navigeer op het Ivanti Neurons-platform naar Beheer > Verificatie.

    De pagina Verificatie verschijnt.

  2. Klik in de sectie Externe verificatie op Acties > Verificatiemethode verwijderen.

    Het scherm Externe authenticatie verwijderen verschijnt.

  3. Klik op Afmelden en opnieuw verifiëren.

    Ivanti Neurons is afgemeld.

  4. Klik op Aanmelden met e-mail en wachtwoord.

  5. Voer de referenties in en klik op Aanmelden.

  6. Navigeer naar Beheer > Verificatie > Externe verificatie en klik dan op Acties > Verificatiemethode verwijderen.

    Het scherm Externe authenticatie verwijderen verschijnt.

  7. Klik op Verificatiemethode verwijderen.

    De bestaande verificatiemethode wordt nu verwijderd.