Product Guide

ReadMe Documentation

Welcome to the ReadMe Documentation, where you'll find comprehensive guides and community support to help you start working with ReadMe as quickly as possible!

Get Started

Setting Up Okta


Setting up Okta and ReadMe allows members in your organization to authenticate with Okta and access various projects under ReadMe.

Required information

If you haven't already, please fill out the form in this link. Shoot us an email and once we've reviewed the information, we'll make some changes on our end to register it with our service. You won't have all of the information until you've created your SAML 2.0 application on your end.

Setting up Okta

  1. Go to applications within your admin dashboard in okta. It's important that you are in the classic UI.
  2. Select "Create New App"
  3. Choose SAML 2.0 for the sign in method.
  4. Refer back to the TypeForm section regarding Single Sign On URL. Set the Single Sign On URL to the one specific in the form. It should look something like this:
  5. Do the same thing for Audience URI. It should look something like this: urn:auth0:readmeio:yourcompanyname
  6. Set the attribute statements as specified below.
  7. Set the groups mapping as specified below. You can read more about group mappings here.
  8. Create the app!
  9. View the "Sign On" tab in the application settings, and follow the instructions under "View Setup Instructions". The documentation in "View Setup Instructions" will give you all the credentials required to fill in the Typeform form.
  10. Once you fill out the TypeForm, shoot us a message and we'll set up the dependencies to finalize your Okta configuration!

Click "Create New App"

Set up your Single Sign-On URL & Audience URI

Attribute & Group Attribute Statements

"View Setup Instructions"

Updated 9 months ago

Setting Up Okta

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.