-
Notifications
You must be signed in to change notification settings - Fork 27
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Added Troubleshooting doc for Salesforce (#440)
Added a new Troubleshooting doc & updated special NLPs doc for salesforce.
- Loading branch information
1 parent
5df5545
commit 064e77a
Showing
3 changed files
with
164 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
126 changes: 126 additions & 0 deletions
126
src/pages/docs/troubleshooting/salesforce-testing/most-common-issues.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,126 @@ | ||
--- | ||
title: "Issues While Testing Apps Built on Salesforce" | ||
page_title: "Troubleshooting Some General Issues" | ||
metadesc: "Learn how to resolve some of the general issues while testing applications built on Salesforce | Troubleshooting general issues in Salesforce Testing" | ||
noindex: false | ||
order: 23.911 | ||
page_id: "Troubleshooting Guide for Salesforce Testing" | ||
warning: false | ||
contextual_links: | ||
- type: section | ||
name: "Contents" | ||
- type: link | ||
name: "Authorization Failure" | ||
url: "#authorization-failure" | ||
- type: link | ||
name: "Login NLP is Not Working" | ||
url: "#login-nlp-is-not-working" | ||
- type: link | ||
name: "MFA Challenge" | ||
url: "#mfa-challenge" | ||
--- | ||
|
||
--- | ||
|
||
This troubleshooting guide for Salesforce Testing in Testsigma provides solutions to common issues while testing applications built on Salesforce. | ||
|
||
--- | ||
|
||
## **Authorization Failure** | ||
|
||
### **Symptoms:** | ||
![Auth Failure](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfauthfailure.png) | ||
|
||
### **Possible Causes:** | ||
- **ClientId** and **Secret** are incorrect. | ||
- **Environment** might be wrong (e.g., production vs. development). | ||
- **Callback URL** is incorrect. | ||
|
||
### **Steps to Resolve** | ||
|
||
**1. Verify ClientId and Secret:** | ||
- Doubl check the **ClientId** and **Secret** provided by the service and ensure there are no typos. | ||
- Regenerate the **ClientId** and **Secret** if necessary. | ||
|
||
**2. Check Environment Settings:** | ||
- Ensure the correct **Environment** is selected (development, staging, production). | ||
- Confirm your application's configuration. | ||
|
||
**3. Check Callback URL:** | ||
- Ensure the **Callback URL** matches the service provider's settings and check if there are typos. | ||
- Ensure your server is configured to handle the callback request. | ||
|
||
**4. Additional Notes:** | ||
- Ensure the application's **permissions** and **scopes** are set correctly while creating a connected app. | ||
- Check network & firewall settings for blocks on the authorization endpoint. | ||
|
||
For more information, refer to [creating a connected application](https://testsigma.com/docs/salesforce-testing/connected-app/). | ||
|
||
--- | ||
|
||
## **Login NLP is Not Working** | ||
|
||
### **Symptoms:** | ||
Users can sync metadata but the login step fails. | ||
|
||
|
||
### **Possible Causes:** | ||
|
||
- Salesforce **Access Token** and **Refresh Token** might have expired. | ||
- The same connected app is being used by multiple users simultaneously. | ||
- Users might have changed the connected app configuration in the Salesforce org. | ||
|
||
### **Steps to Resolve** | ||
|
||
**1. Re-authenticate Salesforce Connection:** | ||
|
||
- Try to authenticate the Salesforce connection again and obtain a new Access Token and Refresh Token. | ||
|
||
**2. Verify Connected App Settings:** | ||
|
||
- Check the connected app configuration in Salesforce and ensure all settings are correct. | ||
|
||
**3. Best Practices:** | ||
|
||
- Use different connections for different testing environments to avoid conflicts. | ||
|
||
|
||
--- | ||
|
||
## **MFA Challenge** | ||
|
||
### **Symptoms:** | ||
Users can sync metadata but encounter an MFA challenge during the process. | ||
|
||
### **Possible Causes:** | ||
- Salesforce org configuration needs verification. | ||
|
||
### **Steps to Resolve** | ||
|
||
**1. Disable Org Level MFA Configurations:** | ||
|
||
- Disable the **Require multi-factor authentication (MFA) for all direct UI logins to your Salesforce org** setting. | ||
![Disable MFA Config](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmla.png) | ||
|
||
**2. Disable User Level MFA Configurations:** | ||
- Ensure that user-level MFA settings follow the required configuration. If not, adjust them accordingly by navigating to **Account > Settings > Advanced User Settings > User Details > Profile** | ||
|
||
![MFA APIs](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmla2.png) | ||
|
||
![API Only User](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmla3.png) | ||
|
||
**3. Best Practices:** | ||
|
||
**Waive MFA for Exempt Users:** | ||
|
||
- Ask customers to enable **Waive Multi-Factor Authentication for Exempt Users** in Salesforce. | ||
![Waive MFA](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/waivemfasf.png) | ||
|
||
|
||
**Create a Permission Set for Automation Users:** | ||
|
||
- Create a new permission set specifically for automation users. | ||
|
||
- Assign this permission set to users who are performing Salesforce authentication. | ||
|
||
--- |