Eventscribe Expo Harvester Single Sign-on (SSO)

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. User clicks a Cadmium login link.
2. User is redirected to the 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 no company exists or no booth is assigned:
      • The user is directed to the booth rental process. 
      • Custom logic can be applied to display member or non-member pricing based on AMS/CRM identifiers (e.g., member type, company type).
   2. If the company exists, a booth is assigned, and the user is the booth admin:
      • The user is redirected to the task portal.
   3. If the company exists and a booth is assigned, but the user is not the 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. User clicks a Cadmium login link.
2. User is redirected to the 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 user is not the booth admin:
      • The user will see a no access screen.
   2. If the company exists and the user is the booth admin:
      • The user is redirected to the task portal.

Supported Fields ( Booth Admin)

Expo Harvester uses field mapping to associate user data received from the Identity Provider (IdP) with corresponding booth admin profile fields. The fields listed below represent Cadmium’s standard SSO field mappings. Actual field availability and naming may vary by IdP.

• member_id (required)
• member_status (Active or Non-Member)
• first_name (required)
• middle_name 
• last_name (required)
• prefix 
• suffix 
• credentials 
• pronouns
• organization_position
• organization 
• email (required)
• phone_work 
• phone_mobile 
• address1 
• address2 
• address3 
• city 
• state 
• postal_code 
• country_code

Supported Fields (Company)

Expo Harvester uses field mapping to associate company data received from the Identity Provider (IdP) with corresponding company profile fields. The fields listed below represent Cadmium’s standard SSO field mappings. Actual field availability and naming may vary by IdP.

• company_member_ID (required)
• company_name (required) 
• company_email
• company_phone
• company_address1
• company_address2
• company_address3
• company_city
• company_state
• company_postal_code
• company_country_code

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.