There are several cases in which you will need to connect GRAX to Salesforce via OAuth:
- New GRAX installations
- Moving to a different Integration/Service user
- Repairing a broken OAuth connection to the same user
- Moving a sandbox app to a new sandbox
New installations of GRAX will connect to Salesforce with a unique flow, but otherwise the flow is initiated in the same manner. See the sections below for more information.
If you've just finished installing GRAX and it's reachable at
[your-grax-domain-and-port]/web, you're all set to connect to Salesforce. You'll be greeted by this page:
If you're connecting to a production Salesforce instance (including some Developer/Einstein orgs), choose
production in the dropdown. Otherwise, choose
sandbox. Click on the "Establish OAuth Connection to Salesforce" button. Follow the Salesforce OAuth login flow as normal, remembering to use your org's custom domain if applicable.
A successful connection attempt will land you back on
[your-grax-domain-and-port]/login, which looks slightly different now. Login with your personal Salesforce user to enter the GRAX application via SSO.
If you've been using GRAX with a Salesforce org and would like to change the connected user or org for any of the reasons listed above, you can initiate that flow from the GRAX Settings page:
If you're connecting to a production Salesforce instance (including some Developer/Einstein orgs), click the production-labeled button. Otherwise, click the sandbox-labeled button. Follow the standard Salesforce login flow for the new user. A successful connection will send you to the
[your-grax-domain-and-port]/login screen to have you log in with your personal user from the new org.
If you're in the process of installing GRAX for the first time or need to otherwise (re)connect your longterm storage, see our related documentation.
Updated 22 days ago