1. Home
  2. Docs
  3. Snowplow Console
  4. Adding and removing users in Console

Adding and removing users in Console

There are two ways to add and remove users in console; directly managed in console, or managed through your SSO provider.

Managing users directly in console

For organizations not using SSO, users can be added and removed directly in Console by navigating to Manage users in the navigation and creating a new user, or removing an existing user from there.

Newly added users will receive an email to set their password and will be added with limited permission, which you can then widen.

Setting up Single-Sign-On authentication

SSO is an authentication process that allows users to access multiple applications after signing in to a central Identity Provider. Snowplow supports SSO integration for the majority of identity providers.

Permissions

Only system administrators can set up SSO for their company.

Requirements

  • SSO is available to customers on the Ascent & Summit tiers.
  • Your identity provider must adhere to the OASIS SAML 2.0 protocol.
  • All users of an SSO-enabled instance of Snowplow must authenticate through the identity provider.

How to enable SSO for your account

Setting up SSO for your account requires some information to be exchanged between you as the Identity Provider and Snowplow as the Service Provider.

Depending on your Identity Provider the information that is required is slightly different.

To enable SSO for Snowplow please contact your Customer Success representative or send a support ticket requesting SSO to be enabled. We will then work with you to exchange the relevant information and set up the SSO connection. 

Which Identity Providers (IdPs) are supported?

Snowplow’s SSO capability enables connections with many IdPs, including: 

  • Active Directory/LDAP
  • ADFS
  • Azure Active Directory
  • Azure Active Directory Native
  • Google Workspace
  • OpenID Connect
  • Okta
  • PingFederate
  • SAML

Note that because we can support OpenID Connect and SAML, it should be possible to support virtually any external Identity Provider that uses those standards.

What information will you need from us?

This will differ depending on your Identity Provider, but typically will include information such as:

  • Entity ID – the URL that identifies the identity provider issuing a SAML request,  this will be specific to your identity provider.
  • Metadata URL – the URL that allows access to obtain SSO configuration data,  this will be specific to your identity provider.
  • Redirect Login URL – the URL where users in the company sign in to the identity provider.
  • Security Certificate Fingerprint – the SHA-1 or SHA-256 fingerprint of the SAML certificate that can be obtained from your identity provider and allows us to create a secure connection.
  • User information mapping – locations of information required by Snowplow console such as first name, last name and, optionally, job title.

What happens when SSO is enabled?

Adding new users

Snowplow supports just-in-time provisioning with SSO connections. When a user logs in for the first time, a corresponding user account with the same email is created in Snowplow.

A new user created via SSO will have a custom permissions set that allows them to view-only, as outlined below. This can then be edited by anyone with the Admin role on your account. For more details on setting user access, see [LINK](Setting User Permissions).

Console featurePermissions
User managementNo access
EnvironmentsView access
Data structuresView access
Data models & jobsView access
API keysView access

Existing users

If a user already has a Snowplow account prior to SSO being enabled, the two accounts will be merged the users current permissions will be applied.

Logging in 

When SSO is enabled, anybody who signs into Snowplow Console with an email address that uses your specified domain will be authenticated via SSO and your Identity Provider.

Once SSO is enabled, users on your domain can no longer sign in with their old email address and password, or manage their personal details or password as these will all be managed within your Identity Provider.

Disabling SSO

If your company enables SSO, and later decides to disable it:

  • Users who did not set up a password before SSO was enabled must click Reset password on the login page to obtain a password.
  • Users who set up a password before SSO was enabled can login with their old username and password.