💎 SSO is available exclusively with a Branded App, which is a paid add-on.
If you have purchased the Branded App or the White-label add-on, you can set up SSO via SAML directly from the Studio without any additional charges. However, if you require technical assistance or need help implementing SSO using a different protocol, additional fees will apply.
What is Single Sign-On (SSO)?
Single Sign-On (SSO) is a convenient authentication method that lets users access multiple apps with just one login. It simplifies the login process, enhances security, and reduces the need for users to manage multiple passwords.
With SSO, you can customize how attendees log in to your branded app, offering better control over authentication.
Swapcard supports SSO through the SAML 2.0 protocol, acting as both an Identity Provider and a Service Provider.
This article will guide you on how to implement SAML 2.0 SSO with Swapcard as the Service Provider.
Why Use SAML 2.0 SSO?
Using SAML 2.0 SSO has several benefits for your event:
Improved User Experience: Attendees can access the app with just one login, eliminating the need to remember multiple credentials.
Enhanced Security: Fewer passwords mean reduced risks of security breaches.
Simplified Management: Event organizers can easily configure and manage login settings to match event needs.
How to add SAML SSO to your Branded App
Access the Studio
Log in and navigate to the "Application" tab in the main menu. This is where you can manage your event app's setting.
Set Up SSO
In the "Login & SSO" tab, you can:
Set up a new SSO
Manage existing configurations
We can also upload a Metadata file that avoid to input manually each field.
To implement SAML SSO, you'll need to provide the required metadata and certificates. You can also customize the SSO button label and set up error messages to help attendees with login issues.
SSO can be added alongside or as a replacement for the regular login method (email with password / one-time code). If you have multiple sign-in methods, you can arrange them using the drag-and-drop function.
Preview Your Login Page
You can preview the login page as your attendees and exhibitors will see it, ensuring everything is set up to your liking.
We are able to download Swapcard metadata file, and this file allow you to configure the login page on your side.
Useful information
Swapcard metadata comes second. You can download the Swapcard metadata file only once your SSO configuration exists, after you upload your identity provider's metadata file or fill in its fields. If your identity provider needs the Swapcard metadata first, create the configuration with temporary values, download the Swapcard file, then replace the values in the same configuration.
The email attribute is required. Swapcard identifies each user with the email address sent in an attribute of the SAML response. The attribute name in the email mapping of your SSO configuration must match the name your identity provider sends exactly, including upper and lower case:
emailandEmailare different. The NameID alone isn't enough. If the attribute is missing or named differently, the login fails.SSO doesn't create accounts. Users can log in with SSO only if they already have a Swapcard account with the email address sent by your identity provider. Add your attendees and exhibitors to your event first (registration, import or integration), with the same email address: SSO doesn't register anyone to your event.
When a login fails, users come back to your app's login page with the error message set in your SSO configuration. Check the email attribute first, then that the user is registered with the same email address.
Certificate changes: if your identity provider's certificate changes, update it in your SSO configuration, otherwise logins fail.
Test early. Log in with a registered test account well before you open your app to attendees.
How to customize the welcome subtitle on the Login page?
If your app uses the standard email/password or one-time code login, you can customize the welcome subtitle (default: "Please enter the email address you provided during registration"). Here’s how:
Go to your branded app settings in Studio.
Open the "Login & SSO" tab.
Click the three-dot icon next to "Email with password or one-time"
Edit the welcome subtitle and customize it for different languages, if necessary.

