Converting OAuth 2.0 Service Providers to OpenID Connect#

plans-img Available on Enterprise and Professional plans

deployment-img Cloud and self-hosted deployments

Also available in legacy Mattermost Enterprise Edition E20

Using the System Console, Mattermost Enterprise and Professional customers can migrate OAuth configuration to the OpenID Connect standard. A one-time, one-click conversion tool is available within the existing OAuth 2.0 page. You can also go to System Console > Authentication > OpenID Connect.

Select Convert to OpenID Connect to migrate your active service provider configuration to the new standard. No further changes are required.


  • Inactive service providers configured for OAuth 2.0 are also migrated to the new OpenID Connect standard.

Configuring OpenID Connect Single Sign-On#


deployment-img-yellow Available only for self-hosted deployments

For details on configuring Mattermost to use a service provider as a Single Sign-on (SSO) service for team creation, account creation, and user sign-in using OpenID Connect, refer to the following documentation: