Access Red Hat services using your company credentials with single sign-on (SSO) integration

Company single sign-on is an integration between the Red Hat single sign-on system and your organization’s identity provider (IdP).

This type of integration is commonly known as “3rd party IdP” or “federated IdP.” This type of integration allows users to access Red Hat services, like the Customer Portal, Hybrid Cloud Console, and Partner Connect using their existing company credentials. This integration ensures that the same login used for internal resources also grants authenticated access to the Red Hat ecosystem. Any Red Hat website, app, or service using the Red Hat single sign-on system for authentication is accessible through company single sign-on integration.

Learn about the scope of single sign-on (SSO)

Organization Administrators can directly manage authentication security protocols for Red Hat services through the authentication requirements of your company's single sign-on system.

Single sign-on provides a better authentication experience for users, as users themselves can maintain one less set of login credentials. Currently, company single sign-on integration has the following scope:

  • Link the same company IdP with multiple Red Hat accounts.
  • Link one company user identity with one Red Hat user identity.
  • Use corporate SSO/IdP to authenticate to the Red Hat Customer Portal or any Red Hat application with a web-based authentication flow which uses the Red Hat single sign-on system.
  • Support for OpenID Connect (OIDC).
  • Support for Security Assertion Markup Language (SAML).

Check account eligibility for single sign-on (SSO) integration

Existing Red Hat users can authenticate to Red Hat with their company single sign-on credentials when their company SSO is integrated with Red Hat SSO.

You can integrate your identity provider with Red Hat SSO by using the self-service identity provider integration support.

Self-service SSO integration is supported for the following Red Hat account types:

  • A Red Hat Corporate account type with an active, non-evaluation subscription.
  • An approved Red Hat partner account type.
Note
Personal account types are not supported.

Navigate limitations of single sign-on (SSO) integration

When you integrate your identity provider (IdP) or single sign-on (SSO) with the Red Hat single sign-on to create a federated SSO, any user who cannot authenticate your SSO also cannot authenticate to any Red Hat service with a web-based authentication flow.

A limited number of Red Hat services do not use web-based authentication; these services are not compatible with single sign-on. This means you can revoke a user’s corporate customer IdP credentials, but they can still use their Red Hat account username and password to authenticate to Red Hat services that do not use web-based authentication.

To remove access to all Red Hat services, the Organization Administrator must use the user management tool to deactivate a Red Hat user account. A deactivated account can no longer be used to access any Red Hat service.

Note
Company single sign-on integration does not support the syncing or automated creation of users. Users must be created through currently supported means, such as inviting users or auto-user registration.

Users without accounts in the customer IdP will not be able to authenticate. For example, this can affect vendor/partner relationships where today the vendor/partner user has a Red Hat login within the customer’s Red Hat company account. Once company single sign-on is enabled, if the customer is not able to allow the vendor/partner user to have an account in the customer IdP, the vendor/partner user will no longer be able to log in.

Manage your authentication and access your Red Hat account

Once integrated, you can use your company single sign-on to login to your Red Hat account.

The following procedures describe how to log in to your Red Hat account and configure your company single sign-on integration:
  • Log in without company single sign-on (SSO) integration.
  • Link your Red Hat account to your company SSO for the first time and log in.
  • Log in to your Red Hat account when company single sign-on is enabled.
  • Update your linked company SSO.
Note

If you previously used a social login to log in to your Red Hat account, you will see an error message when company single sign-on (SSO) is enabled for your organization. A message appears on your Red Hat account screen:

Log in with company single sign-on.
Company single sign-on is required to access your account.

Click the link Log in with company single sign-on. to continue.

Log in without company single sign-on (SSO) integration

Use your Red Hat login to log in your Red Hat account when it is not set up to use company single sign-on (SSO) integration. This is the default instance.

Before you begin

  • Ensure you have a registered Red Hat user account.
  • Confirm that your Red Hat company account is not set up to use company SSO integration.

Procedure

  1. Use your browser to navigate to access.redhat.com
  2. Enter your Red Hat login.
  3. Enter your Red Hat password.

Results

After a successful login, the avatar that is associated with your user account appears in the navigation bar in place of the login icon. Click the avatar for additional account information.

Link your Red Hat account to your company SSO for the first time

Use your Red Hat login to log in your Red Hat account when it is enabled to use company single sign-on (SSO) integration. The first time you log in, you must link your Red Hat account to your company SSO account.

Before you begin

  • Ensure you have a registered Red Hat user account.
  • Ensure your company account is set up to use company SSO integration.
  • Confirm that your Red Hat user account is not yet linked to your company SSO user.
Note
This procedure is only required the first time that you authenticate, which is when Red Hat initially detects that your Red Hat company account has single sign-on (SSO) integration enabled.

Procedure

  1. Use your browser to navigate to access.redhat.com(or any Red Hat website or application)
  2. Enter your Red Hat login. You are redirected to your company single sign-on login screen.
  3. Enter your company credentials and log in.
    You are redirected to sso.redhat.com where a message appears for the next step: One-time account linking required.
  4. Enter your Red Hat account password.
  5. Click the Link account button.

Results

After a successful login, the avatar that is associated with your user account appears in the navigation bar in place of the login icon. Click the avatar for additional account information.

Note
If the linking action fails, check that the Red Hat login and password are correct and are associated with the corporate account connected to your company SSO.

Access your Red Hat account after linking your company SSO

Use your Red Hat login to log in to your Red Hat account when it is enabled to use company single sign-on (SSO) integration.

Before you begin

  • Ensure you have a registered Red Hat user account.
  • Confirm that your Red Hat company account is set up to use company SSO integration.

Procedure

  1. Use your browser to navigate to access.redhat.com
  2. Enter your Red Hat login.
    You are redirected to your company single sign-on login screen.
  3. Enter your company username and password credentials. This is the same information you use to log in to your company single sign-on system, which also provides access to your Red Hat account because it is federated with Red Hat’s single-sign on system.

Results

After a successful login, the avatar that is associated with your user account appears in the navigation bar in place of the login icon. Click the avatar for additional account information.

Terms and definitions

The following table provides more information on commonly used terms throughout this section.

Table 1. Terms and definitions
Term Definition

Federated identity

An electronic identity linked across multiple distinct identity management systems. See the Wikipedia Federated identity reference.

IdP

Identity provider. See the Wikipedia Identity provider reference.

SSO

Single sign-on. True single sign-on allows the user to log in once and access services without re-entering authentication factors. See the Wikipedia Single_sign-on reference.