Single Sign-On

Single sign-on (SSO) is an authentication method that allows users to securely log in to multiple related software systems using a single ID (or username) and password. This allows users to log in once to be able to access services without re-authenticating.

InEvent supports integration with the SSO methods listed below:

• Security Assertion Markup Language (SAML 2.0)
• Azure Active Directory (OIDC)
• OpenID Connect

This article will take you through the steps of configuring SSO integration to handle user sign-in process.

How do I configure SSO integration?

This section will guide you to configure SSO integration with SAML 2.0, Azure Active Directory (OIDC), and OpenID Connect.

Whitelisting your domain

Before starting to configure SSO integration, it is necessary to first whitelist your domain(s). To whitelist your domain(s), contact InEvent by submitting a Question using the Issue report feature.

Once your domain has been whitelisted, it will appear under Whitelisted domains on the Company details page, as seen below:

InEvent will generate a DNS setting which you need to add to your domain for verification purposes. Once this step has been completed, your domain status will change from Not verified to Verified, and you can proceed to configure SSO integration.

Configuring SAML 2.0 SSO integration

This section describes how you can integrate SAML 2.0 SSO to InEvent with OneLogin as an example.

Setting up SAML 2.0 SSO with OneLogin

Check out the video linked below to set up SAML 2.0 SSO with OneLogin:

Preparing OneLogin SSO with SAML 2.0 Protocol

This section will guide you on how to set up OneLogin SSO with SAML 2.0 protocol with OneLogin as the SAML initiator. Follow the steps below:

1. Navigate to Applications > Applications from your OneLogin administrator dashboard.
2. Select the SAML Custom Connector (Advanced) from the list of available applications.

1. Enter your portal name, icon, and description details as needed.
2. Click Save. You will be taken to the information page of your newly created app.

1. Navigate to the Configuration tab.
2. Enter the details below into the corresponding fields, along with other fields if applicable:

• ACS (Consumer) URL Validator: ^https:\/\/app\.inevent\.com\/{{company nickname}}\/sso\-auth\.php

• ACS (Consumer) URL: https://app.inevent.com/{{company nickname}}/sso-auth.php

1. Click Save.

1. Navigate to the SSO tab.
2. Locate and copy the X.509 Certificate, Issuer URL, SAML 2.0 Endpoint (HTTP), and SLO Endpoint (HTTP) details. These details will be entered at the InEvent platform at the next step.

Integrating OneLogin SSO to InEvent with SAML 2.0 protocol

Once you have finished configuring the SSO integration at OneLogin and collected the necessary details, you can proceed to integrate it to the InEvent platform by completing the following steps:

1. Navigate to Integrations > SSO from the Company level.

1. Choose SAML 2.0 entry in the Sign on method drop-down box.
2. Insert the parameters below into the corresponding fields:

• Issuer Name: OneLogin
• Issuer Label (login button): Login with OneLogin, or the desired label to be displayed on the login screen
• Issuer URL (previously copied from OneLogin)
• SAML 2.0 Endpoint (HTTP) (previously copied from OneLogin)
• SLO Endpoint (HTTP) (previously copied from OneLogin)
• X-509 Certificate (previously copied from OneLogin)

1. Press the green Link account button to finish the configuration.

Configuring Azure Active Directory SSO integration

This section will guide you to configure SSO integration with Microsoft Azure Active DIrectory. This integration uses the Open ID Connect (OIDC) authentication protocol. After completing these steps, user log-ins will be handled by Azure Active Directory.

Preparing Azure Active Directory SSO integration within InEvent

1. Navigate to Integrations > SSO from the Company level.

1. Select Azure ID (OIDC) in the Sign on method drop down box.
2. Locate and copy Redirect URI within the page. This URI is necessary for setting up your app in Azure Active Directory.

Setting up your app in Azure Active Directory

1. Log in to Microsoft Azure Portal.
2. Navigate to Active Directory under Azure services within the Azure Management Portal.

1. Click App registrations from the left panel.
2. Click New registration.

1. Enter the necessary details below:

• Name: An identifier to the app you will be using Azure log in for.
• Supported account types (required): Group of user accounts to be permitted to log in. Select as needed.

• Redirect URI: Azure will return authentication responses to this URI after authenticating users successfully. This URI is found by navigating to the Company level in the InEvent platform > Integrations > SSO > Sign on method: Azure ID (OIDC) > Redirect URI.

Once you have entered the required information, you will be redirected to the Overview page of the newly created app.

1. Locate Application (client) ID and Directory (tenant) ID within the Essentials section. Copy these IDs as they are needed to configure SSO integration within the InEvent platform.

1. Navigate to Certificates & Secrets.
2. Press New client secret to generate Azure Application Secret Value.

1. Enter the client secret description and expiration period as needed. This will generate a Secret Value.

1. Locate the newly generated Secret Value. Copy this secret as it is needed to configure SSO integration within the InEvent platform.

Integrating Azure Active Directory SSO to InEvent

Once you have finished setting up your app in Azure Active Directory and collected the necessary details, you can proceed to integrate Azure Active Directory SSO to the InEvent platform. Complete the following steps:

1. Navigate to Integrations > SSO from the Company level and select Azure AD (OIDC) in the Sign on method drop down box.

1. Insert the parameters below into the corresponding field:

• Issuer Name
• Issuer Label (login button): The label to be displayed on the login screen.
• Azure Directory (tenant) ID (previously copied from your Azure AD account)
• Azure Application (client) ID (previously copied from your Azure AD account)
• Azure Application Secret Value (previously copied from your Azure AD account)

1. Press Link account to finish the configuration process.

Once the integration is complete, you can set the session duration and also click on the Get metadata and Access login portal.

Configuring OpenID Connect SSO integration

InEvent supports certified SSO OIDC Identity Providers, such as:

• OneLogin
• G Suite
• Other Identity Providers that use OAuth 2.0 authentication protocol

Preparing and setting up your app in the OpenID Connect SSO IdP platform

Before integrating an OpenID Connect SSO with InEvent, it is necessary to create a new app or project in your preferred OIDC IdP platform. The steps to create a new app or project may vary, depending on the platform.

When creating a new app, the platform will require OpenID Connect Redirect URI to be entered. The URI can be found by navigating to Integrations > SSO from the Company level and selecting to create a new OpenID Connect SSO integration.

Integrating OpenID Connect SSO with InEvent

1. Navigate to Integrations > SSO from the Company level.

1. Select Open ID Connect in the Sign on method drop down box.
2. Insert the parameters below into the corresponding field:

• Issuer Name: The name of the SSO Identity Provider (IdP).
• Issuer Label (login button): The label to be displayed on the login screen.
• OpenID Connect URL: The URL that accepts the OpenID Connect request.
• OpenID Connect App ID: OpenID Connect Client ID provided by your IdP.
• OpenID Connect App Secret: OpenID Connect secret provided by your IdP.

1. Press Link account to finish the configuration process.

Log in experience

After successfully integrating SSO to InEvent, users will undergo a slightly different log in process.

Event organizers

Event organizers with administrator permissions will see the interface below when logging into the platform (with OneLogin as an example):

Upon pressing Login with OneLogin, they will be directed to the SSO portal to enter their user credentials, as shown below (with OneLogin as an example).

Once the log in process has been completed, they will be redirected to the InEvent platform.

Attendees

Attendees will see the interface below when logging into the platform (with OneLogin as an example):

Upon pressing ONELOGIN (using OneLogin as an SSO example), they will be directed to the SSO portal to enter their user credentials, as shown below:

Once the log in process has been completed, they will be redirected to the InEvent platform.

Log in through the app

Attendees logging in using the Android and iOS app can also log in to your events using the integrated SSO.

Upon pressing the desired SSO button, they will be directed to the SSO portal to enter their user credentials, as shown below, using OneLogin as an example.

Once the log in process is completed, they will be directed to the company's event directory, from where they have to select their target event.

Azure Active Directory log out experience

When Azure Active Directory SSO is integrated with the InEvent platform, users who are logged in using Azure AD SSO benefit from a simplified login and logout experience. When logging out from InEvent, they will also be logged out from Azure Active Directory.

When Azure Active Directory is integrated using SAML 2.0, users are redirected to the SAML logout page before returning to InEvent. When it is integrated using OpenID Connect, users are redirected to the Microsoft logout interface, where manual confirmation is required to complete the logout process.

Redirect users after logging out

You can configure the target redirect page that will be seen by the attendees after logging out. To do so, enter the URL of the target redirect page in the Single Logout Service Redirect URL and save your changes.

Below is the default logout behavior, which leads to the Website or Landing page of your event, depending on your event's configurations.

Below is the behavior when a redirect page is configured in the Single Logout Service Redirect URL field, using the InEvent FAQ as an example.

SSO login button display options

After successfully configuring your SSO integration, you can display or hide the SSO Login button for user logins from the Company level, Event level, or both. To do so, press the Edit button and check or uncheck the appropriate boxes:

• Display on Company Level: Display the SSO Login button when logging in at the Company level.
• Display on Event Level: Display the SSO Login button when logging in at the Event level.

Then, press the End button to save your changes.

Use custom domain for redirect

When using SSO on a Custom domain-enabled company or event, the domain changes affect SSO redirect URLs. In order to ensure SSO integration is not interrupted by domain changes, click on Edit and check on the Use custom domain for redirect box after configuring your SSO integration.

SSO login session duration

You can determine the duration of a SSO login session directly from the SSO configuration interface. This way, users who log in to the InEvent platform using the target SSO integration will be logged out after the set duration has elapsed since their log in, and they will have to log in again. To do so, press the Edit button and enter the desired session duration in minutes.

After entering the desired session duration, press the End to save your changes.

Multiple SSO integrations

You can use multiple SSO integrations to handle the account authorization process in your company and event on the InEvent platform. To do so, simply integrate more than one SSO integrations from the Company level and set them to be displayed from the desired level (Company level only, Event level only, or both levels).

Below is how the Company level log in interface will look like with multiple SSO integrations enabled and displayed.

Below is how the Event level log in interface will look like with multiple SSO integrations enabled and displayed.

Mandatory SSO Auth

After integrating SSO to InEvent, you can enable the Mandatory SSO Auth tool so that users can only enroll to your event if they are authenticated through the integrated SSO methods.

To enable Mandatory SSO Auth, follow the steps below:

1. Navigate to Settings > Tools from the Event level.
2. Press the Edit button on the top right corner of the page.
3. Locate the Login section.
4. Enable Mandatory SSO Auth by checking the corresponding box.

1. Press the End button to save your changes.

After completing the steps above, users will see the following log in interface when accessing your Registration form, with multiple SSO directories enabled as an example.

Allow non-SSO log in

It is possible to allow non-SSO log in when SSO is enabled and activated. In order to allow non-SSO login, follow the steps below:

1. Navigate to Account > Tools from the Company level.

1. Click Edit.
2. Locate Allow non-SSO login under the Login section.
3. Check the box to enable the function.

1. Press End to save your changes.

After completing the steps above, attendees will see the following screen when logging in to your event.

Auto register with SSO

You can allow users who log in using SSO to be automatically registered to your event, even if they were not added to the event's list of attendees.

To allow the automatic registration of users who log in using SSO, follow the steps below:

1. Navigate to Settings > Tools from the Event level.
2. Click Edit.
3. Locate Auto register with SSO under the Login section.
4. Check the box to enable the function.
5. Press End to save your changes.

After completing the steps above, users who log in using SSO will be automatically registered to your event as an attendee. Therefore, they will be directed to the Virtual Lobby without being prompted to complete the Registration form, even if they were not added to the event's list of attendees.