Purpose
Guide users through what happens when authentication credentials expire or break, and how to reconnect their Asana account to restore functionality.
1. Why This Happens #
- Security salts changed: WordPress can reset authentication salts, invalidating saved tokens.
- Credential corruption: Database or plugin errors can damage stored connection data.
- Revoked permissions: The connected Asana user revoked access in Asana.
When this occurs, the plugin cannot authenticate with Asana. You will see a notification in the plugin settings prompting you to re‑authenticate.
2. Symptoms #
- Tasks fail to create or update.
- An admin notice will appear in your WordPress dashboard informing you that the Asana connection needs to be re‑authenticated.
- Feed pages show connection errors.
3. How to Reconnect #
- Go to Forms → Settings → Asana Integration.
- If prompted, enter you Client ID and secret again, then click the Authorize button again.
- Log in with your Asana account and grant access.
- Confirm that the account now shows as connected.
4. Resetting Credentials #
If reconnecting does not work:
- In Asana, revoke the app’s authorization for this site/account.
- In WordPress, go to Forms → Settings → Asana Integration and re‑enter your Client ID and Client Secret.
- Click Authorize to start a fresh OAuth flow and grant access again.
5. Tips & Best Practices #
- Use a dedicated Asana service account (not a personal user) to avoid accidental revokes.
- If issues persist, enable Gravity Forms logging and send the logs to support.
- After reconnecting, check dropdowns to ensure projects and users are syncing correctly.
