Language IO for Salesforce | (Legacy Basic Auth) Named Credential Configuration

Your Salesforce Named Credential stores your Language IO authentication URL and parameters. It allows Language IO applications installed in Salesforce to make external callouts to Language IO.

• Prerequisities
• Creating an External Auth Identity Provider for OAuth 2.0
  • Configuring the Customer Request Parameters for OAuth 2.0
• Creating an External Credential
  • Configuring the External Credential Principal
  • Configuring the Custom Header for Basic Auth
• Creating a Named Credential
• Configuring and Assigning External Credential Principal Access

Prerequisities

• You will need your Language IO consumer username and password.

Creating an External Credential

1. In Salesforce, go to Setup → "Named Credentials".
2. In the "External Credentials" tab, click "New".
3. Give the new External Credential a "Label", "Name", and "Description".
4. Set the "Authentication Protocol" to "Custom".
5. Click "Save".

Configuring the External Credential Principal

1. With your External Credential open, scroll down to "Principals".
2. In the "Principals" section, click "New".
3. Set a "Parameter Name".
4. Click the "Add" button twice to add two parameters.
5. For the first parameter's "Name", enter: Username
6. Set "Value" to your Language IO Basic Auth username.
7. For the second parameter's "Name", enter: Password
8. Set "Value" to your Language IO Basic Auth password.
9. Click "Save".

Configuring the Custom Header

1. With your External Credential open, scroll down to "Custom Headers".
2. In the "Custom Headers" section, click "New".
3. Set "Name" to "Authorization".
4. Set "Value" to the following formula (replace "[External_Credential_Name]" with the name of your External Credential):
   {!'Basic ' & BASE64ENCODE(BLOB($Credential.[External_Credential_Name].Username & ':' & $Credential.[External_Credential_Name].Password))}
5. Click "Save".

Creating a Named Credential

1. In Salesforce, go to Setup → "Named Credentials".
2. In the "Named Credentials" tab, click "New".
3. Give the new Named Credential a "Label" and "Name".
4. Enable "Enabled for Callouts".
5. For "URL", enter: https://golinguist.com/linguistnow/resources/
   Note: If Language IO has informed you that your account exclusively uses our EU infrastructure, use https://eu.golinguist.com/linguistnow/resources/ instead.
6. In the "Authentication" section, set "External Credential" to your External Credential.
7. In the "Callout Options" section:
   1. Disable "Generate Authorization Header".
   2. Enable "Allow Formula in HTTP Header".
8. In the "Managed Package Access" section, list the namespaces of the applications that will use this Named Credential (comma-separated):
   • Language IO Case: LanguageIO
   • Language IO Enhanced Chat: Lio
   • Language IO Article: LIOAT
   • Language IO API: Lio
9. Click "Save".

Configuring and Assigning External Credential Principal Access

Agents must have access to the External Credential Principal and read access to the User External Credentials object. You can create a new permission set for these permissions, or add them to an existing permission set.

1. Open your Permission Set overview
2. Click "External Credential Principal Access".
3. Enable your External Credential Principal.
4. Click "Save".
5. Back in the overview, click "Object Settings".
6. Find and click "User External Credentials".
7. Click "Edit"
8. Enable "Read"
9. Click "Save".
10. Finally, assign the permission set to all users who will use this credential.