--- title: SAML 2.0 SSO Integration Guide (Generic) description: SAML 2.0 SSO --- [Skip to content](https://support.bucketlistrewards.com/en/knowledge/saml2-sso#main-content) English Show submenu for translations [Contact Support](https://support.bucketlistrewards.com/en/knowledge/kb-tickets/new?hsLang=en) [![bucketlist-full-logo (2)-4](https://support.bucketlistrewards.com/hs-fs/hubfs/bucketlist-full-logo%20(2)-4.png?width=300&height=97&name=bucketlist-full-logo%20(2)-4.png)](https://bucketlistrewards.com/) Open main navigation Close main navigation - English Show submenu for translations - [Contact Support](https://support.bucketlistrewards.com/en/knowledge/kb-tickets/new) - [Contact Support](https://support.bucketlistrewards.com/en/knowledge/kb-tickets/new) [Contact Support](https://support.bucketlistrewards.com/en/knowledge/kb-tickets/new?hsLang=en) Welcome to the Bucketlist Help Center. - There are no suggestions because the search field is empty. 1. [Bucketlist Help Center](https://support.bucketlistrewards.com/en/knowledge?hsLang=en) 2. [Integrations and IT](https://support.bucketlistrewards.com/en/knowledge/integrations-and-it?hsLang=en) 3. [SSO](https://support.bucketlistrewards.com/en/knowledge/integrations-and-it?hsLang=en#sso) # SAML 2.0 SSO Integration Guide (Generic) ## This article is a guide to help you setup SAML 2.0. We do not have access to all SSO systems, so this is a generic overview of the requirements Bucketlist has to connect SAML SSO successfully **Guide to setting up SAML 2.0 SSO with Bucketlist Rewards** *For Platform Administrators: this article is intended for Bucketlist platform administrators configuring SSO.*  This guide applies to any SAML 2.0-compliant Identity Provider (IdP) — for example Okta, Azure AD / Entra ID, Google Workspace, OneLogin, Ping Identity, JumpCloud, or a custom IdP. The configuration fields are the same across providers; only the screens and terminology used to enter them will differ. --- 1\. Information you'll need to configure your IdP When creating the SAML application in your IdP, you will be asked for the following values. These identify Bucketlist Rewards as the Service Provider (SP). | **Field** | **Value** | | --- | --- | | **Single Sign-On URL** (also called ACS URL, Reply URL, or Recipient URL) | US Server: https://\.bucketlist.org/saml2/acs/   CAD Server: https://\.bucketlistrewards.ca/saml2/acs/ | | **Audience URI** (also called SP Entity ID or Identifier) | US Server: https://\.bucketlist.org/saml2/metadata/ CAD Server: https://\.bucketlistrewards.ca/saml2/metadata/ | | **Name ID Format** | Email Address | | **Application Username / Subject** | Email | Replace \ with your company's Bucketlist subdomain. Important: Both URLs above must end with a trailing slash (/). SSO login will not work without it. ### Attribute mappings Configure the following attribute statements. The Name Format for each should be set to Unspecified. | **IdP Attribute Name** | **Maps to** | **Name Format** | | --- | --- | --- | | mail | user.email | Unspecified | | cn | user.firstName | Unspecified | | sn | user.lastName | Unspecified | Note: some IdPs use different default attribute names (e.g. email, firstName, lastName, or givenName/surname). Use whichever attribute in your directory holds the corresponding value — the mapping shown above uses common LDAP/Active Directory attribute names as an example. ### Signing certificate Bucketlist needs your IdP's public signing certificate to verify SAML assertions. This is provided as part of your IdP's metadata (see below), so a separate certificate upload usually isn't needed unless your IdP doesn't generate combined metadata. --- 2\. Information you'll need to provide to Bucketlist Once your SAML application is configured, export your IdP's metadata in XML format and send it to the Bucketlist product team. This file should include everything between the opening \ declaration and the closing \ (or equivalent root closing tag). Once we receive your metadata, request that the Bucketlist product team enable SAML SSO for your company. --- 3\. Generic step-by-step configuration guide The exact screens vary by provider, but setting up SAML SSO with Bucketlist generally follows these steps in any IdP admin console: 1. Log in to your IdP's admin console and navigate to the Applications (or "Apps" / "Enterprise Applications") section. 2. Create a new application and choose SAML 2.0 as the sign-in / protocol method (sometimes labeled "Add custom SAML app" or "Create App Integration"). 3. General settings: Give the application a name, e.g. "Bucketlist Rewards." 4. Configure SAML settings, entering the values from the table in Section 1: 1. Single Sign-On URL / ACS URL / Reply URL 2. Audience URI / SP Entity ID / Identifier 3. Name ID format: Email Address 4. Application username / Subject: Email 5. Remember to use your correct server (US or CAD) and include the trailing slash on both URLs. 5. Add attribute statements/mappings using the table in Section 1, setting the Name Format to Unspecified where that option exists. 6. Finish creating the application, selecting whatever completion/feedback option is appropriate for your organization. 7. Assign the application to users or groups. The application will not be usable until it is assigned to the people (or groups) who should have access. Confirm that each user's username/login is set to their email address. 8. Locate and download the IdP metadata, usually found under a "Sign On," "SAML Setup," or "Federation Metadata" section of the application you created. This is typically offered either as a metadata URL or a direct XML download/copy option. 9. Send the metadata XML to the Bucketlist product team as described in Section 2, and request that SAML SSO be enabled for your company. --- This guide is intended as a general reference for SAML 2.0 setup across identity providers. If your IdP requires provider-specific steps not covered here, please reach out to the Bucketlist support team for assistance. - [Service Updates](https://support.bucketlistrewards.com/en/knowledge/service-updates?hsLang=en) - [Bucketlist Overview](https://support.bucketlistrewards.com/en/knowledge/bucketlist-overview?hsLang=en) - [Log In Issues](https://support.bucketlistrewards.com/en/knowledge/log-in-issues?hsLang=en) - [Rewards & the Marketplace](https://support.bucketlistrewards.com/en/knowledge/rewards-the-marketplace?hsLang=en#main-content) - [Pre Paid Visa and Mastercards](https://support.bucketlistrewards.com/en/knowledge/rewards-the-marketplace?hsLang=en#pre-paid-visa-and-mastercards) - [Designing Your R&R Program](https://support.bucketlistrewards.com/en/knowledge/designing-your-rr-program?hsLang=en#main-content) - [Designing your Program](https://support.bucketlistrewards.com/en/knowledge/designing-your-rr-program?hsLang=en#designing-your-program) - [Recognition Tips and Best Practices](https://support.bucketlistrewards.com/en/knowledge/designing-your-rr-program?hsLang=en#recognition-tips-and-best-practices) - [Marketing and Launch Materials](https://support.bucketlistrewards.com/en/knowledge/marketing-and-launch-materials?hsLang=en#main-content) - [Program Launch Questions](https://support.bucketlistrewards.com/en/knowledge/marketing-and-launch-materials?hsLang=en#program-launch-questions) - [Marketing Materials](https://support.bucketlistrewards.com/en/knowledge/marketing-and-launch-materials?hsLang=en#marketing-materials) - [Platform Set Up for Admins](https://support.bucketlistrewards.com/en/knowledge/platform-set-up-for-admins?hsLang=en#main-content) - [Members Tab](https://support.bucketlistrewards.com/en/knowledge/platform-set-up-for-admins?hsLang=en#members-tab) - [Settings](https://support.bucketlistrewards.com/en/knowledge/platform-set-up-for-admins?hsLang=en#settings) - [Awards & Nominations](https://support.bucketlistrewards.com/en/knowledge/platform-set-up-for-admins?hsLang=en#awards-nominations) - [Reports & Dashboard](https://support.bucketlistrewards.com/en/knowledge/platform-set-up-for-admins?hsLang=en#reports-dashboard) - [Resource Tab](https://support.bucketlistrewards.com/en/knowledge/platform-set-up-for-admins?hsLang=en#resource-tab) - [Events](https://support.bucketlistrewards.com/en/knowledge/platform-set-up-for-admins?hsLang=en#events) - [Redeem Tab](https://support.bucketlistrewards.com/en/knowledge/platform-set-up-for-admins?hsLang=en#redeem-tab) - [User Provisioning Solutions](https://support.bucketlistrewards.com/en/knowledge/user-provisioning-solutions?hsLang=en#main-content) - [SFTP](https://support.bucketlistrewards.com/en/knowledge/user-provisioning-solutions?hsLang=en#sftp) - [ADP](https://support.bucketlistrewards.com/en/knowledge/user-provisioning-solutions?hsLang=en#adp) - [BambooHR](https://support.bucketlistrewards.com/en/knowledge/user-provisioning-solutions?hsLang=en#bamboohr) - [Beekeeper](https://support.bucketlistrewards.com/en/knowledge/user-provisioning-solutions?hsLang=en#beekeeper) - [Dayforce](https://support.bucketlistrewards.com/en/knowledge/user-provisioning-solutions?hsLang=en#dayforce) - [HiBob](https://support.bucketlistrewards.com/en/knowledge/user-provisioning-solutions?hsLang=en#hibob) - [Paylocity](https://support.bucketlistrewards.com/en/knowledge/user-provisioning-solutions?hsLang=en#paylocity) - [SAP SuccessFactors](https://support.bucketlistrewards.com/en/knowledge/user-provisioning-solutions?hsLang=en#sap-successfactors) - [Workday](https://support.bucketlistrewards.com/en/knowledge/user-provisioning-solutions?hsLang=en#workday) - [UKG](https://support.bucketlistrewards.com/en/knowledge/user-provisioning-solutions?hsLang=en#ukg) - [Integrations and IT](https://support.bucketlistrewards.com/en/knowledge/integrations-and-it?hsLang=en#main-content) - [Bucketlist App](https://support.bucketlistrewards.com/en/knowledge/integrations-and-it?hsLang=en#bucketlist-app) - [Whitelisting Emails](https://support.bucketlistrewards.com/en/knowledge/integrations-and-it?hsLang=en#whitelisting-emails) - [SSO](https://support.bucketlistrewards.com/en/knowledge/integrations-and-it?hsLang=en#sso) - [Outlook](https://support.bucketlistrewards.com/en/knowledge/integrations-and-it?hsLang=en#outlook) - [Microsoft Teams](https://support.bucketlistrewards.com/en/knowledge/integrations-and-it?hsLang=en#microsoft-teams) - [Slack](https://support.bucketlistrewards.com/en/knowledge/integrations-and-it?hsLang=en#slack) - [Gmail](https://support.bucketlistrewards.com/en/knowledge/integrations-and-it?hsLang=en#gmail) - [Webhook](https://support.bucketlistrewards.com/en/knowledge/integrations-and-it?hsLang=en#webhook) - [Widgets](https://support.bucketlistrewards.com/en/knowledge/integrations-and-it?hsLang=en#widgets) - [My Profile](https://support.bucketlistrewards.com/en/knowledge/my-profile?hsLang=en) - [Recognitions & Points](https://support.bucketlistrewards.com/en/knowledge/recognitions-points?hsLang=en#main-content) - [Content Moderation](https://support.bucketlistrewards.com/en/knowledge/recognitions-points?hsLang=en#content-moderation) - [AI Suggestions](https://support.bucketlistrewards.com/en/knowledge/recognitions-points?hsLang=en#ai-suggestions) - [Rewards Float & Funding](https://support.bucketlistrewards.com/en/knowledge/rewards-float-funding?hsLang=en) - [Amazon Marketplace](https://support.bucketlistrewards.com/en/knowledge/amazon-marketplace?hsLang=en) - [Insights](https://support.bucketlistrewards.com/en/knowledge/insights?hsLang=en) - [Bucketlist Features](https://support.bucketlistrewards.com/en/knowledge/bucketlist-features?hsLang=en#main-content) - [Surveys](https://support.bucketlistrewards.com/en/knowledge/bucketlist-features?hsLang=en#surveys) - [Banners](https://support.bucketlistrewards.com/en/knowledge/bucketlist-features?hsLang=en#banners) - [External Recognitions](https://support.bucketlistrewards.com/en/knowledge/bucketlist-features?hsLang=en#external-recognitions) - [How to Contact Bucketlist](https://support.bucketlistrewards.com/en/knowledge/how-to-contact-bucketlist?hsLang=en#main-content) - [Support Asks](https://support.bucketlistrewards.com/en/knowledge/how-to-contact-bucketlist?hsLang=en#support-asks) - [Nomination Awards](https://support.bucketlistrewards.com/en/knowledge/nomination-awards?hsLang=en) [![bucketlist-full-logo (2)-4](https://support.bucketlistrewards.com/hs-fs/hubfs/bucketlist-full-logo%20(2)-4.png?width=250&height=81&name=bucketlist-full-logo%20(2)-4.png "bucketlist-full-logo (2)-4")](https://bucketlistrewards.com/) We’re on a mission to build the best cultures in the world.   Copyright © 2026, Bucketlist Rewards & Recognition