Connections are the way Ranger establishes and maintains access to your various applications. Note: Ranger currently only supports Connections via OAuth2. 

  1. Navigate to Connection creation form.

  2. Name your Connection. We'd recommend using the name of the app you are connecting. 

  3. Enter the API Key and API Secret into the text boxes.

    1. Note: If each account will require its own API Credentials, users will be prompted for this information when creating their account. 

  4. Include the Authorization URL in the text box provided.

  5. Open the Authorization Parameters menu and include any parameters needed for making the authorization request. 

    1. You do not need to include redirect URL or the API credentials, just parameters like response_type or any scope information.

  6. In the Token Exchange section, enter the Token Exchange URL for your application and any parameters in the Exchange Parameters menu. 

  7. In the Access Token Field text box, enter the path to access token in the response to the Token Exchange call. 

    1. If the access token is accessible on the first level of the response, just enter access_token or the correct field name.

    2. If the response is nested, enter the path to the correct access token field with '/' separation. If the response is structured like:

      1. {"user":{"access_token":'123453abcd'}} 

      2. enter user/access_token

  8. If you app uses refresh tokens, click the Setup Refresh Tokens checkbox and use the same pattern for the Access Token field to tell Ranger where to access the refresh token.

  9. Click Save