Skip to main content

Web Portal Sign-in Fails

You sign in to the aprity web portal at https://<your-organization>.app.aprity.ai with Sign in with Salesforce. aprity never sees your password: Salesforce signs you in, then tells aprity who you are.

"Unknown host. The aprity portal must be accessed via <tenant>.app.aprity.ai."​

The address you opened is not a portal address. Use your organization's portal address, for example from the Web portal entry of the aprity app in Salesforce. Bookmark that address.

"Invalid Salesforce configuration. Please contact your aprity administrator."​

The portal address is known, but its Salesforce sign-in settings are not valid. Ask your aprity administrator to contact aprity support.

"Unable to sign in at the moment. Please try again in a few moments."​

A temporary problem. Retry after a moment. If it persists, contact support.

Salesforce shows an error page​

The problem is in the External Client App that your Salesforce administrator set up. The most common Salesforce messages:

  • redirect_uri_mismatch — the portal callback URL is missing from the app's Callback URL field. The setup wizard lists the callback URLs to paste, one per line; the portal needs its own line.
  • user hasn't approved this consumer — your profile is not in the app's Selected Profiles. Your administrator must add the profile of every portal user (for example Standard User), not only the integration user's profile.
  • An error about the token exchange — in the app's Security settings, Require secret for Web Server Flow and Require secret for Refresh Token Flow must be unchecked, and Require Proof Key for Code Exchange (PKCE) must stay checked.

The setup wizard in the aprity app describes each of these settings. See also Connected App Setup.

"Access denied. Your session is invalid — please sign in again."​

Salesforce signed you in, but aprity did not give you access. Common causes:

  1. No aprity permission set. Portal access requires aprity User (read) or aprity Admin. Ask your Salesforce administrator to assign one to your user. Adding your profile to the External Client App is not enough on its own.
  2. Wrong Salesforce org. The portal is linked to one org. If you signed in with a user from another org (for example a sandbox instead of production), aprity does not recognize you. Sign out of Salesforce and sign in with a user of the right org.
  3. Expired session. Sign in again from the portal home page.

You come back to the sign-in page​

  • Close every tab of the portal and of Salesforce sign-in, then try again in a new tab.
  • Allow cookies for app.aprity.ai. Browsers or extensions that block cookies can drop the session right after sign-in.
  • Try a private window with extensions disabled.

Contact support​

Contact aprity support with:

  • The portal address you used.
  • Your Salesforce username and Org ID.
  • The exact message, or a screenshot of the error page.