SAML Linking Experience

Problem to solve

Our current messaging when a user links a SAML identity is confusing to new users. We should improve the language so a user understands what it means to link their GitLab account to SAML.

SSO zero state	GitLab sign in to connect	Signed in warning	Success

Intended users

Anyone in a SAML enabled group!

User experience goal

Users understand:

• What it means to link a SAML identity
• That they need to log in
• When they need to create a new account

Proposal

• The set up process is the awkward part.
• Documentation fix?
• Banner: You have followed an SSO link, if you have a Gitlab account you want to link to this account, Sign in with your gitlab account and click authorize.
• Log in SSO panel: by linking your gitlab account (_____) to your SSO/IDP(URL)

Figma working file

Proposed Updated Text

	SSO zero state	GitLab sign in to connect	Signed in warning	Success
updated text	To access GROUP NAME you need to sign in with your organization's SSO credentials	Connect your GitLab account to your organization's SSO credentials	Clicking Authorize will transfer ownership of your GitLab account to your Organization	Your organization's SSO has been connected to your GitLab account
Occurence in UI
updated in UI

Availability & Testing

Please run the package-and-qa job to ensure all existing SAML tests are fine.