How to link your Limio and Limio for Salesforce applications

Here are the steps to link your Limio for Salesforce application to Limio

Step 1. First, make sure you have an OpenID authentication provider in Limio > Settings > Authentication Provider.

Step 2. Request from Limio Support your Consumer Key and Consumer ID.

Step 3. Go to Salesforce Setup > Auth Providers

1. 1. Create a new Auth Provider
   2. Populate the fields as defined on the OpenID token on Limio
      1. Fill in the Consumer Key and Consumer ID provided by Limio Support
      2. Use Limio as a Name or you can use a different name. 
      3. Use https://{{tenant}}.prod.limio.com/api/sf/oauth2/authorize?authProvider=app and https://{{tenant}}.prod.limio.com/api/sf/oauth2/token?authProvider=app for Authorize Endpoint URL and Token Endpoint URL
      4. Keep Send access token in header and Inculde Consumer Secret in API responses ticked.

Step 4. Go to Salesforce Setup > Named Credentials

1. 1. Create a new Named Credentials
   2. Populate the fields:
      1. Name & Label: limio (⚠️ make sure to use lowercase)

      2. URL: the URL to your Limio Subscription Commerce Platform, for example https://{{tenant}}.prod.limio.com/

      3. Identity Type: Named Principal

      4. Authentication Protocol: OAuth 2.0

      5. Authentication Provider: Use the identity created in Step 2

      6. Scope: <the link to your Limio Subscription Commerce Platform + /api > (e.g. https://{{tenant}}.prod.limio.com/api)

      7. Keep Generate Authorization Header ticked and leave Certificate empty\
      8. Upon saving, you will be prompted to authenticate in the corresponding limio environment. If the authentication is successful, after saving the Authentication Status of the named credential will show as Authenticated; if not, it will show as Pending