This feature only exists on Read the Docs for Business.
Single Sign-On is supported on Read the Docs for Business for Pro and Enterprise plans. SSO will allow you to grant permissions to your organization’s projects in an easy way.
Currently, we support two different types of Single Sign-On:
Authentication and authorization are managed by the Identity Provider (e.g. GitHub, Bitbucket or GitLab)
Authentication (only) is managed by the Identity Provider (e.g. an active Google Workspace account with a verified email address)
Using an Identity Provider that supports authentication and authorization allows you to manage “who have access to what projects on Read the Docs” directly from the provider itself. In case you want a user to have access to your documentation project under Read the Docs, that user just needs to be granted permissions in the VCS repository associated with it.
You can enable this feature in your organization by going to your organization’s detail page > Settings > Authorization and selecting GitHub, GitLab or Bitbucket as provider.
Note the users created under Read the Docs must have their GitHub, Bitbucket or GitLab account connected in order to make SSO to work.
You can read more about granting permissions on GitHub.
By granting read (or more) permissions to a user in the VCS repository you are giving access to read the documentation of the associated project on Read the Docs to that user.
By granting write permission to a user in the VCS repository you are giving access to read the documentation and to be an administrator of the associated project on Read the Docs to that user.
When SSO with VCS provider is enabled only owners of the Read the Docs organization can import projects. Adding users as owners of your organization will give them permissions to import projects.
Note that to be able to import a project, that user must have admin permissions in the VCS repository associated.
If a user should not have access anymore to a project for any reason, a VCS repository’s admin (e.g. user with Admin role on GitHub for that specific repository) can revoke access to the VCS repository and this will be automatically reflected in Read the Docs.
The same process is followed in case you need to remove admin access, but still want that user to have access to read the documentation. Instead of revoking access completely, just need lower down permissions to read only.
Using your company’s Google email address (e.g.
firstname.lastname@example.org) allows you to
manage authentication for your organization’s members.
As this Identity Provider does not provide authorization over each repositories/projects per user,
permissions are managed by the internal Read the Docs’s Teams authorization system.
By default, users that Sign Up with a Google account do not have any permissions over any project. However, you can define which Teams users matching your company’s domain email address will auto-join when they Sign Up. Read the following sections to learn how to grant read and admin access.
You can enable this feature in your organization by going to your organization’s detail page > Settings > Authorization and selecting Google as provider and specifying your Google Workspace domain in the Domain field.
You can add a user under a “Read Only Team” to grant read permissions to all the projects under that Team. This can be done under your organization’s detail page > Teams > Read Only > Invite Member.
To avoid this repetitive task for each employee of your company, the owner of the Read the Docs organization can mark one or many Teams for users matching the company’s domain email to join these Teams automaically when they Sign Up.
For example, you can create a “General Documentation (Read Only)” team
with the projects that all employees of your company should have access to
and mark it as Auto join users with an organization’s email address to this team.
Then all users that Sign Up with their
email@example.com email will automatically join this Team and have read access to those projects.
You can add a user under an “Admin Team” to grant admin permissions to all the projects under that Team. This can be done under your organization’s detail page > Teams > Admins > Invite Member.
Making the user member of any “Admin Team” under your organization (as mentioned in the previous section), they will be granted access to import a project.
Note that to be able to import a project, that user must have admin permissions in the GitHub, Bitbucket or GitLab repository associated, and their social account connected with Read the Docs.
To revoke access to a project for a particular user, you should remove that user from the Team that contains that Project. This can be done under your organization’s detail page > Teams > Read Only and click Remove next to the user you want to revoke access.