Installation Guide

Install Xetfer package

Get Xetfer by installing the package on your Salesforce Org (all editions are supported):

Installation link:

/packaging/installPackage.apexp?p0=04tfK000000ARerQAG

We are in the process of publishing Xetfer on AppExchange.

Timeline

Post-installation steps

A user with a System Administrator profile has to configure the following settings:

Create Connected App

Open Setup → Apps → External Client AppsExternal Client App Manager
Press New External Client App

Salesforce External Client App Manager

Fill in the required fields:

  • External Client App Name;
  • API Name;
  • Contact Email;
  • Distribution State (leave the default value – Local);
  • Check Enable OAuth Settings.

Callback URL

https://your_domain/apex/xetfer__AccessTokenPage

How to find your_domain?

Example of the Callback URL:
https://xetfer-dev.ed.develop.my.salesforce.com/apex/xetfer__AccessTokenPage

  • In the Selected OAuth Scopes choose:
    • Manage user data via APIs (api)
    • Manage user data via Web browsers (web)
    • Perform requests at any time (refresh_token, offline_access)

Uncheck any other checkboxes selected by default

Salesforce External Client App

Press Create

Select Settings Tab on created External Client App and press Edit

Salesforce External Client App Settings

Click Consumer Key and Secret

Salesforce External Client App Consumer Key and Secret

You can see Consumer Key and Consumer Secret. It will be used in the next steps. Copy it.

Salesforce External Client App Consumer Key and Secret

Set Trust IP

  1. Open SetupSecurityNetwork Access.
  2. Press New button.
  3. Set Start IP Address and End IP Address to 35.88.169.83
  4. Press Save button.
Trust IP

Set Remote Site Settings

  1. Open Setup → Security → Remote Site Settings.
  2. Press New Remote Site.
  3. Set Remote Site Name field to (Example: Xetfer).
  4. Set Remote Site URL field to https://cloud.xetfer.com
  5. Make sure that Active checkbox is checked ☑️
  6. Press Save button.
Remote Site Settings

Set Trusted URL

  1. Open Setup → Security → Trusted URLs.
  2. Press New Trusted URL.
  3. Set the API Name field to (Example: Xetfer).
  4. Set the URL field to https://cloud.xetfer.com
  5. Check CSP Context to «Lightning Experience Pages»
  6. Check CSP Directives «content-src (scripts)» ☑️
  7. Press Save button.
Trusted URL

Set the Permission Set to the User with the System Administrator Profile for the Registration Page:

  1. Open SetupUsersPermission Sets.
  2. Choose Xetfer Registration User Access.
  3. Press Manage Assignments button.
  4. Press Add Assignments button.
  5. Check the user.
  6. Press Assign button.
  7. Press Done button.

Set the Permission Sets to the other Users for the Access to the Application Depending on Your Needs

Full Access, Access to All Xetfer Records (Connections, Templates, Jobs, Files, Runs, allow to edit Settings):

  1. Open SetupUsersPermission Sets.
  2. Choose Xetfer Admin Access.
  3. Press Manage Assignments button.
  4. Press Add Assignments button.
  5. Check the user.
  6. Press Assign button.
  7. Press Done button.

Restricted Access, Access to Only Own Records (Connections, Templates, Jobs, Files, Runs):

  1. Open SetupUsersPermission Sets.
  2. Choose Xetfer User Access.
  3. Press Manage Assignments button.
  4. Press Add Assignments button.
  5. Check the user.
  6. Press Assign button.
  7. Press Done button.

Pass Registration

  1. Open App Launcher → Find and open Xetfer Registration page. 
    Xetfer Registration page
  2. Click Endpoint Settings button.
  3. Input your data to the form:
    • Set Middleware URL field to https://cloud.xetfer.com
    • Set Consumer Key value copied on the previous steps.
    • Set Consumer Secret value copied on the previous steps.
Registration
  1. Press Save button.
  2. After the configuring endpoint settings, click Register User button.

Pop-up Instructions

  • Should appear a pop up!
  • If your browser blocks it, then allow popups.
  • Input your current org credentials (where the Xetfer package has been installed) to the form → Press Allow button.
Auth Pop up

Verification:

  • You should see the message «Successful authorization» ?
  • Setup is complete.
Successful authorization

Note

warning

Next time, if you press the Deregister User button on the Registration page, then all application records will be deleted.

Deregister button
  • Additionally, please, do not use xetfer__AppData in Title field for ContentDocument sObject. This name is used by the Xetfer, and these files will be deleted after deregistration on the «Registration Page».

Next step:

Get a free license