We're working on improvements and are looking into registering GitBook on Okta's app marketplace, but in the meantime, this guide should help you get set up and running.
Here's what you need to at a high level:
Setup a new SAML 2.0 app in Okta, go through the process putting in "invalid" ACS URLs (that's the awkward part)
Get the IDP info from Okta to configure SAML on GitBook
Return to Okta to redo the setup (step 1) now that GitBook shows the URLs you need to paste into Okta's app setup.
Go to your Okta admin dashboard, then click
Create New App :
Then create a SAML 2.0 App:
When prompted to put in the Single-Sign-on URL just paste in
https://www.example.com (or any other URL), we will fix this later.
After going through the setup process for Okta, you should see the following page:
That will show you a page with all the info to fill in to this form in GitBook:
Now go back to your Okta admin dashboard and reconfigure the app we set up in the 1st step.
Paste in the ACS URL that GitBook now shows in your SSO settings. Now you should be all set 🎉
If you encounter any issue or need help setting this up, please contact us 👋.