Log in using SSO - Knowledge base site

Prev Next

Sign in to your organization's knowledge base site with single sign-on (SSO) so you can read the content shared with you, without a separate Document360 password. You see the login page when you open a private knowledge base, or a private section of a mixed-access knowledge base. Depending on how your organization set it up, you sign in through an identity provider (IdP) such as Okta, Microsoft Entra ID or Google Workspace (SAML or OpenID Connect), or through your organization's own application (JWT).

This article is for readers of the knowledge base site. If you are a team member signing in to the knowledge base portal to write or manage content, see Log in using SSO - Knowledge base portal.


Before you begin

  • SSO or JWT must already be configured for your project by an Owner or Admin. If you don't see an SSO option on the login page, contact your knowledge base administrator.
  • Have the URL of the knowledge base site you want to read.
  • If the knowledge base is public, you don't need to sign in. Readers see the login page only on private and mixed-access knowledge bases.
  • The login option appears as soon as you switch reader access to Private or Mixed. It is not something you turn on separately. If neither SSO nor JWT is configured yet, readers see the standard Document360 email and password login form, with no SSO or JWT buttons. Set up your sign-in method before switching to Mixed or Private, so readers aren't shown a login prompt before they can actually sign in.

How to sign in to the knowledge base site with SSO

Use these steps if your organization signs you in through an IdP with SAML or OpenID Connect.

  1. In your browser, open the knowledge base site URL.
    The login page appears.
  2. Click Login with SSO.
    If your organization offers several sign-in options, the first two appear as buttons and the rest are listed under Other login options.
  3. On your IdP's login page, enter your credentials.

After your IdP confirms your identity, you are signed in to the knowledge base site and can read the content your administrator has given you access to.

NOTE

Login with SSO is the default button text. Your administrator can change it, so the button on your login page may have a different label.

If your administrator turned on IdP-initiated sign-in, you can also open Document360 from your IdP's dashboard. For details, see Log in from your IdP dashboard.


How to sign in to the knowledge base site with JWT

Use these steps if your organization signs you in through its own application. JWT sign-in is available only for readers on the knowledge base site. You can't use it to log in to the knowledge base portal. For more information, see JWT.

  1. In your browser, open the knowledge base site URL.
    If JWT is the only sign-in method your organization uses, you may go straight to your organization's sign-in page. Skip to step 3.
  2. On the login page, click your organization's JWT login button. If you don't see a button for your organization and the page shows a Domain name field, enter your organization's domain name instead.
  3. Sign in on your organization's sign-in page.

By default, you land on the Home page of the knowledge base site after you sign in.


What you see on the login page

The login page depends on which sign-in methods your administrator has turned on and whether the standard email and password login is turned off.

Standard email and password login Sign-in methods turned on What you see
On SSO Email and password form with SSO login buttons
On SSO and JWT Email and password form with SSO and JWT login buttons
On JWT Email and password form with JWT login buttons
Off SSO SSO login buttons only
Off JWT Domain name field with JWT login buttons
Off SSO and JWT Domain name field with JWT login buttons and SSO

If your administrator turned on social login, the page also shows Google workspace or Microsoft sign-in buttons.


If you can't sign in

  • You can't find your organization's button: check Other login options. If it isn't listed there either, contact your administrator.
  • The page says no login options are available: the standard login is turned off and no SSO or JWT sign-in method is currently active. Contact your administrator.
  • You see "Sorry, you're not authorized to access this documentation": you are signed in, but your reader account doesn't have access to that content. Ask your administrator to check your reader access. For the full list of causes, see Authentication and authorization issues.
  • You see a session expired error: on a private knowledge base, your session can expire after more than 15 minutes of inactivity. Refresh the page to restore access.
  • You signed in through your IdP, but private content is missing or your profile icon doesn't appear: on a mixed-access knowledge base, opening the site from a bookmark, your browser history or the knowledge base portal may skip the sign-in, especially if your browser has stored data from an earlier visit. Go to <knowledge base URL>/login to sign in. If the content still doesn't appear, clear your browser data for the site and sign in again. If this keeps happening, ask your administrator to set RelayState in your IdP. See Send people to the knowledge base site instead of the portal.

For SSO error messages and fixes, see SSO login issues.


FAQ

Why can I see only some articles after I sign in?

Your administrator controls which content each reader and reader group can see. If your administrator turned on Auto assign reader group, you are added to the selected reader groups the first time you sign in with SSO. If you need access to more content, contact your administrator.

Can I create my own reader account instead of using SSO?

Yes, if your administrator turned on reader self-registration and the standard email and password login is on. Click Sign up on the login page. SSO alone does not block self-registration. If you don't see Sign up, ask your administrator to give you access. For the steps, see Self registration on a knowledge base site.

Can I use JWT to sign in to the knowledge base portal?

No. JWT signs in readers to the knowledge base site only. To sign in to the knowledge base portal, use SAML or OpenID Connect SSO, as described in Log in using SSO - Knowledge base portal.

Can I sign in with my Google workspace or Microsoft account?

Yes, if your administrator turned on these options for the knowledge base site. They are off by default.