SAML 2.0 Setup

Tip: Don't want to manage certificates for your SSO connection? Then leave SAML behind and set up your connection through OpenID Connect instead. For details, see OpenID Connect (OIDC) Setup.

Security Assertion Markup Language (SAML) 2.0 is a standard protocol to exchange authentication data between security domains. To set up an SSO connection for users to sign in to Blackbaud solutions through a SAML 2.0 IdP, such as Google Workspace, OneLogin, Shibboleth, and Central Authentication Service (CAS), an organization admin (or another user with the necessary admin rights) must claim the organization's email domains, create a SAML 2.0 connection and configure its settings, test the connection, and then turn on SSO.

To prevent inadvertent lockouts, make sure to:

  • Complete the setup during a maintenance window for your organization's network.

  • Create a Blackbaud ID outside of your claimed domains with access to the Authentication settings page in Security.

Blackbaud doesn't support IdP-initiated connections. If you need to enable users to connect to Blackbaud solutions through an app in your IdP's portal, then after you turn on SSO, you must configure that app to use the redirect URL for your live connection. For information about the redirect URL, see Redirect Settings.

After you save your SSO configuration settings and turn off test mode, an Erase all single sign-on settings option appears after the SSO configuration steps. This option allows you to clear your configuration settings and start over. For example, you can select Erase all single sign-on settings if you need to select a different connection method or start over after you troubleshoot an issue. The option is only available after you save your configuration settings in step 2 and turn off test mode in step 3. When you turn on SSO, the option is no longer available, but you can turn off SSO to make it available again. For more information, see Single Sign-on Setup

Tip: For a visual reference of the SAML 2.0 setup that uses Okta as the IdP, see SAML 2.0 setup.