Eventscribe Expo Harvester Single Sign-on

Overview 

The Expo Harvester Single Sign-on (SSO) option is available for booth admins. Because Expo Harvester is an invitation-based module, implementing an SSO integration will introduce additional manual effort for event organizers, including ongoing maintenance of individual and company Member IDs in the user list should any records be imported or added manually. Please review the description below before pursuing an integration.

Cadmium supports Service Provider (SP)–initiated SSO integrations, meaning Cadmium handles the development required to connect with a customer’s third-party system. Customers should confirm with their third-party provider whether any fees apply for API access or integration. 

Cadmium can typically support integrations using OIDC or SAML 2.0. When integrating with an external system that is new to Cadmium, the third-party provider must supply technical documentation and a technical contact. Cadmium will conduct a feasibility analysis before proceeding. Please contact your Cadmium sales representative with any questions.

Description 

User accounts originate in the Identity Provider (IdP), which serves as the system of record (for example, an AMS, CRM, or other system). Users must already have an account in the IdP to log in via SSO

During login, Expo Harvester uses the individual Member ID to confirm the user’s identity and permissions, and the associated Company Member ID to determine which exhibiting company the user should access.

Booth Admin User Experience (Booth Rental Enabled)

For customers using Expo Harvester to manage both booth sales and exhibitor tasks:

  1. The user clicks a Cadmium login link.
  2. The user is redirected to the identity provider (IdP) for authentication.
  3. After authentication, the IdP redirects the user back to Expo Harvester with the Member ID and Company Member ID.
  4. Expo Harvester checks whether the company exists and whether the user is the assigned booth admin.
    1. If the company does not exist OR the booth isnot assigned:
      • The user is directed to the booth rental process.
      • Custom logic may be applied to display member or non-member pricing based on AMS/CRM identifiers (for example, member type or company type).
    2. If the company does exist, a booth is assigned, AND the user isthe booth admin:
      • The user is redirected to the exhibitor task portal for that company/booth.
    3. If the company does exist and a booth is assigned, BUT the user is notthe booth admin:
      • The user will see a No Access screen.

Booth Admin User Experience (Booth Rental Not Enabled)

For customers using Expo Harvester to manage exhibitor tasks only:

  1. The user clicks a Cadmium login link.
  2. The user is redirected to the identity provider (IdP) for authentication.
  3. After authentication, the IdP redirects the user back to Expo Harvester with the Member ID and Company Member ID.
  4. Expo Harvester checks whether the company exists and whether the user is the assigned booth admin.
    1. If the company does not exist OR the booth isnot assigned:
      • The user will see a No Access screen.
    2. If the company does exist, a booth is assigned, AND the user isthe booth admin:
      • The user is redirected to the exhibitor task portal for that company/booth.
    3. If the company does exist and a booth is assigned, BUT the user is notthe booth admin:
      • The user will see a No Access screen.

IMPORTANT NOTE

The individual user record must include a company identifier (Company Member ID) so Expo Harvester can determine which exhibiting company the user should access during login.

Field Mapping

The following fields are the standard user profile and member fields mapped from the Identity Provider (IdP) as the source of truth. Actual field availability and naming may vary by IdP.

Booth Admin

Field NameField TypeRequiredDescription
Unique Identifier
remote_user_idstringYesOften the same value as member_id
Profile Fields
first_namestringYes
middle_namestringNo
last_namestringYes
prefixstringNo
suffixstringNo
emailstringYes
organizationstringNo
organization_positionstringNo
departmentstringNo
credentialsstringNo
pronounsstringNo
address1stringNo
address2stringNo
address3stringNo
citystringNo
statestringNoISO 3166-2 compliant subdivision code
postal_codestringNo
country_codestringNoISO 3166-1 compliant country code
phone_workstringNo
phone_mobilestringNo
Member Fields
member_idstringYes
member_standingstring enumYesIndicates member status. Values are normalized to active or inactive. Defaults to inactive if not applicable.


Company

Field NameField TypeRequiredDescription
Unique Identifier
company_idstringYes
Profile Fields
company_namestringYes
company_emailstringYes
company_address1stringNo
company_address2stringNo
company_address3stringNo
company_citystringNo
company_statestringNoISO 3166-2 compliant subdivision code
company_postal_codestringNo
company_country_codestringNoISO 3166-1 compliant country code
company_phonestringNo


Considerations

  • The AMS/CRM must provide a Company Member ID associated with the individual user record so Expo Harvester can identify the correct exhibitor company during login.
  • If you plan to import users and/or company information AND offer a single sign-on, you must ensure all booth admins have a Member ID and the associated company records have a Company Member ID. This is required for the SSO to validate against. Otherwise, the SSO will return a 'no access' screen.

Troubleshooting

First, confirm the user is logging in with the IdP account associated with their user account. If the issue persists, submit a ticket to integrationservices@gocadmium.com including:

  • Exhibitor
  • Booth #
  • Email address
  • Password if possible (so we can try to recreate)
  • Company Member ID
  • Individual Member ID
  • Error message encountered

For security purposes, request that the user temporarily reset their password so they do not need to share their actual password.

 

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article