How to Configure SAML 2.0 for ReadMe

Contents

• Configuration Steps
• Adding the readonly Custom Attribute

---

Configuration Steps

1. Go to https://readme.typeform.com/to/ht8llf, then click start:

   

2. Enter your Company Name, then click OK:

   

3. Enter your Shorthand company name, then click OK:

   

4. Make a copy of the value shown in red from the Single Sign On value, then click Done:

   

5. Enter the following:

   • Entry point URL: Copy and paste the following:

     Sign into the Okta Admin Dashboard to generate this variable.

     

   • X.509 Certificate: Save the following as cert.pem, then click Choose file to select and upload it.

     Sign into the Okta Admin Dashboard to generate this variable.

     

   • Identity Provider Issuer: Copy and paste the following:

     Sign into the Okta Admin Dashboard to generate this variable.

     

   • Click Submit.

6. In Okta, select the General tab for the Readme app, then click Edit.

   • Enter the value you copied in step 4 above into the Company Namefield.

   • Click Save.

   

7. Done!

Notes:

• The following attributes are supported:

  Note: See Adding the readonly Custom Attribute

  • user.firstName + ' ' + user.lastName
  • user.login
  • appuser.readonly

• SP-initiated flows, IdP-initiated flows, and Just In Time (JIT) provisioning are all supported.

For SP-initiated Flows

Go to: https://sso.readme.io/okta/login/[company_name].

---

Adding the readonly Custom Attribute

OPTIONAL

This section describes how to add the custom attribute readonly:

By default Okta only sends two SAML attributes in the SAML assertion: displayName and username. To send the custom attribute readonly, follow the steps below:

1. In Okta, navigate to Directory > Profile Editor:

   

2. Search for the Readme SAML app, then click Profile:

   

3. Click Add Attribute, then enter the following:

   • Display Name: Enter Readonly.

   • Variable Name: Enter readonly.

   • Click Save:

   

4. Now, when you assign users to the Readme SAML app, you can specify the attribute readonly:

   

5. Done