Skip to main content
Skip table of contents

EvObserve 5.6 - SAML integration

This documentation will guide you through the configuration of SAML integration between EvObserve by EASYVISTA (formerly ServiceNav by COSERVIT) and TrustBuilder. Follow the steps below to set up this integration and enable secure SSO authentication for your users.

Prerequisites

Before you begin, ensure you have the following:

  • Administrator access to your EvObserve by EASYVISTA tenant.

  • Administrator access to your TrustBuilder account.

Step 1: Download EvObserve metadata

  1. Log in to your EvObserve/serviceNav admin console.

  2. Go to Administration > Integrations > SAML to access SAML configuration.

  3. Give the SAML integration a name (for example: SAML_Client TB or SAML Integration TrustBuilder).

  4. Click on button “Export XML” and save the file with the name: SAML_Export_EvObserve.xml

Step 2: Configuring TrustBuilder

Create a SAML connector

  1. Login to TrustBuilder administration console.

  2. Go to the Secure Sites tab.

  3. In the "connectors” section, click on Add a connector of type… and select SAML 2.0.

  4. Name your connector (SAML 2.0 -ServiceNav-EvObserve).

  5. Click on Add to create the connector.
    The SAML connector on TrustBuilder side has been created.

  6. Download the TrustBuilder metadata in XML format. You will need it later in EvObserve configuration.

Provide the EvObserve metadata to TrustBuilder

TrustBuilder connector needs to know the metadata of your EvObserve instance to communicate with it.

  1. In the SAML 2.0 connector you have created, paste SAML_Export_EvObserve.xml content (downloaded in step 1).

    Une image contenant texte, logiciel, Page web, Site web  Description générée automatiquement
  2. Click on Update to save the configuration.

Create a secure site

  1. Go to the Secure Sites tab.

  2. Click on “Add a Secure Site of type” and select the SAML connector name you configured related to your SAML connector for EvObserve.

  3. In the opening window, set the Secure Site name of your choice and the Called URL to point to your EvObserve.

    • The Called URL setting is only used to set a bookmark for the user on My account portal, it has no impact on the security.

  4. Click on Add to save the configuration.

The secure site related to your SAML connector for EvObserve, has been successfully created.

Step 3: Configuring EvObserve 

Provide TrustBuilder metadata to EvObserve 

  1. Go back to your EvObserve/serviceNav admin console, to the SAML configuration (Administration > Integrations > SAML).

  2. Import TrustBuilder metadata in XML format you downloaded at step 2.

  3. Enter the Attribute name “mail”.

  4. Click on Enable SAML Authentication.

    Une image contenant texte, Police, logo, Graphique  Description générée automatiquement

Convert Users from “Locale” authentication to “SAML”

  1. Go to Users tab. (utilisateurs)

    Une image contenant texte, logiciel, nombre, Page web  Description générée automatiquement
  2. Select the user(s) for whom you want to convert to SAML authentication. 

  3. Click on Convert.

  4. Go to Administration > Application > Users accounts (Comptes utilisateurs).

  5. Check that the authentication type has been set to SAML.

Step 4: Testing

  1. Log out of EvObserve.

  2. Go to the EvObserve login page.

  3. Enter your login (email address).

  4. Click on Log in with TrustBuilder.

  5. You should be redirected to the TrustBuilder login page.

  6. Log in with your TrustBuilder token.

  7. You should be redirected back to EvObserve by EASYVISTA and authenticated automatically.

Until v5.6

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.