Skip to content

Commit d026619

Browse files
authored
Update URLs for SAML to point to new dashboard (#12031)
This updates both the data URLs that users need to use and the dashboard pointer links.
1 parent d02bfd3 commit d026619

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

docs/user/guides/set-up-single-sign-on-saml.rst

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -27,13 +27,13 @@ In order to enable SSO with Okta, you need to create a new SAML application in y
2727
2. Click on :guilabel:`Applications`.
2828
3. Click on :guilabel:`Create App Integration`.
2929
4. Choose :guilabel:`SAML 2.0`, and click :guilabel:`Next`.
30-
5. Fill in the following fields with the information from `your SAML integration <https://readthedocs.com/organizations/choose/organization_saml/>`__:
30+
5. Fill in the following fields with the information from `your SAML integration <https://app.readthedocs.com/organizations/choose/organization_saml/>`__:
3131

3232
* :guilabel:`App name`: Read the Docs
3333
* :guilabel:`App logo`: Optionally you can use the `Read the Docs logo <https://brand-guidelines.readthedocs.org/_images/logo-wordmark-vertical-compact-dark.png>`__.
3434
* :guilabel:`App visibility`: (optional)
35-
* :guilabel:`Single Sign On URL`: ``https://readthedocs.com/accounts/saml/<organization-slug>/acs/`` (replace ``<organization-slug>`` with your organization slug)
36-
* :guilabel:`Audience URI (SP Entity ID)`: ``https://readthedocs.com/accounts/saml/<organization-slug>/metadata/`` (replace ``<organization-slug>`` with your organization slug)
35+
* :guilabel:`Single Sign On URL`: ``https://app.readthedocs.com/accounts/saml/<organization-slug>/acs/`` (replace ``<organization-slug>`` with your organization slug)
36+
* :guilabel:`Audience URI (SP Entity ID)`: ``https://app.readthedocs.com/accounts/saml/<organization-slug>/metadata/`` (replace ``<organization-slug>`` with your organization slug)
3737
* :guilabel:`Name ID format`: ``EmailAddress``
3838
* :guilabel:`Application username`: ``Email``
3939
* Leave the rest of the fields as default.
@@ -63,7 +63,7 @@ Once you have created the SAML application in Okta, you need to enable SAML on R
6363
* Click on the :guilabel:`Sign On` tab.
6464
* Copy the :guilabel:`Metadata URL`.
6565

66-
2. Go you your `organization's SAML settings page <https://readthedocs.com/organizations/choose/organization_saml/>`__.
66+
2. Go you your `organization's SAML settings page <https://app.readthedocs.com/organizations/choose/organization_saml/>`__.
6767
3. Paste the Metadata URL in the :guilabel:`Metadata URL` field.
6868
4. Leave the domain field empty.
6969
5. Click :guilabel:`Save`.
@@ -81,7 +81,7 @@ You can delete this team, or configure a different team or teams for users to jo
8181

8282
To configure a team for users to join automatically:
8383

84-
1. Navigate to the `teams management page <https://readthedocs.com/organizations/choose/organization_team_list/>`__.
84+
1. Navigate to the `teams management page <https://app.readthedocs.com/organizations/choose/organization_team_list/>`__.
8585
2. Click the :guilabel:`<team name>`.
8686
3. Click :guilabel:`Edit team`
8787
4. Enable *Auto join users with an organization's email address to this team*.
@@ -107,8 +107,8 @@ If you want to enforce SAML for existing users, you have the following options:
107107

108108
- Users can delete their accounts, and sign up again using SAML.
109109
- Users can link their existing accounts to their SAML identity by following this link while logged in their Read the Docs account:
110-
``https://readthedocs.com/accounts/saml/<organization-slug>/login/?process=connect`` (replace ``<organization-slug>`` with your organization slug).
111-
You can find this link in your `organization's SAML settings page <https://readthedocs.com/organizations/choose/organization_saml/>`__.
110+
``https://app.readthedocs.com/accounts/saml/<organization-slug>/login/?process=connect`` (replace ``<organization-slug>`` with your organization slug).
111+
You can find this link in your `organization's SAML settings page <https://app.readthedocs.com/organizations/choose/organization_saml/>`__.
112112

113113
Outside collaborators
114114
~~~~~~~~~~~~~~~~~~~~~

0 commit comments

Comments
 (0)