Skip to content

Single Sign-On in Neptune#

Neptune supports Single Sign-On (SSO), which lets users log in by using a third-party account for authentication.

SSO for teams#

Using SSO for your team simplifies user management by eliminating the need for Neptune-specific login credentials.

SSO requirement for specific domain#

Enforcing SSO for your organization means that when people use a certain email domain to log in, they are required to log in via SSO. This option doesn't involve external providers.

This doesn't automatically limit workspace members to a certain email domain. It only enforces SSO when using a certain email domain to log in.

Workspace admins must still ensure to not invite members based on personal or other emails.

SSO for self-hosted Neptune#

Customized SSO/LDAP integration is available for the self-hosted (on-prem) version of Neptune. Neptune supports SAML 2.0-based identity providers, such as Okta and Google.1

Once your identity provider is integrated with Neptune, members can sign in using the SSO option on the login screen.

SSO requires configuration on both Neptune's and the identity provider's end. To get started, contact support.

Admins: Inviting users#

To add new users to a team workspace:

  1. In the Neptune app, navigate to the workspace.
  2. In the top-left corner, expand the workspace menu and select People.

  3. Invite users by their emails. For example, name@company.com.

    For more information, see:

Result: Invited users receive an email with an invite link to join the workspace. To log in, they must follow the below Members: SSO login procedure.

Members: SSO login#

If SSO has been set up for your Neptune team workspace:

  1. Find the email containing the invitation to the Neptune workspace and follow the link to join.
  2. On the login screen, select SSO.
  3. Enter the name of the team workspace.
  4. Complete the registration steps.
  5. Accept the invitation to join the team workspace.

To log in to Neptune in the future, you can use:

https://app.neptune.ai/sso/?workspace=WorkspaceName

where WorkspaceName is the name of your team workspace.

Using SSO with existing Neptune account#

You can link an SSO option to an existing Neptune account, provided that the email address used for each account is the same.

Note

If your team uses SSO, check with your team lead or workspace admin before proceeding.

  1. Log out of Neptune.
  2. Go to neptune.ai/login.
  3. Select one of the available options for third-party authentication: GitHub, Google, or Microsoft.
  4. Log in to the selected account and authorize Neptune to access it.
  5. If you have a Neptune account registered with the email address used for the third-party account, you now have the option to link the accounts.
    • If the email is correct, click Add to existing account.
    • If you want to link the login method to another Neptune account instead, click Review profile and enter a different email to use.
    • If there is no Neptune account associated with the email, you'll be taken to registration.
  6. To finish linking the accounts, click the confirmation link in the email sent from Neptune.

Getting help#

If you need help with changing your email or login methods, email us at support@neptune.ai or send us a chat message.

  1. For other identity providers, contact us. ↩