docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

sso: add callout to certificate instructions (#22193) 

## Description
- Good callout that we should clarify that copy/pasting the certificate
values includes the `----BEGIN CERTIFICATE---` and `----END
CERTIFICATE----` lines. This applies to both Okta and Entra examples, as
confirmed in my test org
- I will pass on to IAM about adding placeholder text, I think would be
more valuable than an example in docs

## Related issues or tickets
https://github.com/docker/docs/issues/22176#event-16632900876

## Reviews
- [ ] Editorial review
This commit is contained in:
Sarah Sanders 2025-03-07 11:26:05 -05:00 committed by GitHub
parent dbe3017d19
commit fee0d8b5a4
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 13 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
content/manuals/security/for-admins/single-sign-on/connect.md
View File

@ -144,6 +144,12 @@ After creating your connection in Docker and your IdP, you can cross-connect the
2. Copy the following values from the Okta SAML setup instruction page: 2. Copy the following values from the Okta SAML setup instruction page:
- **SAML Sign-in URL** - **SAML Sign-in URL**
- **x509 Certificate** - **x509 Certificate**
> [!IMPORTANT]
>
> You must copy the entire contents of your **x509 Certificate**,
including the `----BEGIN CERTIFICATE----` and `----END CERTIFICATE----` lines.
3. Open Docker Hub or the Admin Console. Your SSO configuration page should still be open from Step one of this guide. 3. Open Docker Hub or the Admin Console. Your SSO configuration page should still be open from Step one of this guide.
4. Select **Next** to open the **Update single-sign on connection** page. 4. Select **Next** to open the **Update single-sign on connection** page.
5. Paste your Okta **SAML Sign-in URL** and **x509 Certificate** values in Docker. 5. Paste your Okta **SAML Sign-in URL** and **x509 Certificate** values in Docker.
@ -158,7 +164,13 @@ After creating your connection in Docker and your IdP, you can cross-connect the
2. Open your downloaded **Certificate (Base64)** in a text editor. 2. Open your downloaded **Certificate (Base64)** in a text editor.
3. Copy the following values: 3. Copy the following values:
- From Azure AD: **Login URL** - From Azure AD: **Login URL**
- Copy your the contents of your **Certificate (Base64)** file from your text editor - Copy the contents of your **Certificate (Base64)** file from your text editor
> [!IMPORTANT]
>
> You must copy the entire contents of your **Certificate (base64)**,
including the `----BEGIN CERTIFICATE----` and `----END CERTIFICATE----` lines.
4. Open Docker Hub or the Admin Console. Your SSO configuration page should still be open from Step one of this guide. 4. Open Docker Hub or the Admin Console. Your SSO configuration page should still be open from Step one of this guide.
5. Paste your **Login URL** and **Certificate (Base64)** values in Docker. 5. Paste your **Login URL** and **Certificate (Base64)** values in Docker.
6. Select **Next**. 6. Select **Next**.