# Reconnecting / Resetting Credentials

**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

1.  Go to **Forms → Settings → Asana Integration**.
2.  If prompted, enter you Client ID and secret again, then click the
    Authorize button again.
3.  Log in with your Asana account and grant access.
4.  Confirm that the account now shows as connected.

------------------------------------------------------------------------

#### 4. Resetting Credentials

If reconnecting does not work:

1.  In Asana, revoke the app’s authorization for this site/account.
2.  In WordPress, go to **Forms → Settings → Asana Integration** and
    re‑enter your **Client ID** and **Client Secret**.
3.  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.
