⚙️ 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.

Post-installation steps

User with a System Administrator profile should set the following settings:

Create Connected App

Open Setup → Apps → App Manager
Press «New Connected App»

Fill required fields:

• Connected App Name;
• Contact Email;
• Check Enable OAuth Settings.

Callback URL

https://your_domain/apex/xetfer__AccessTokenPage

How to find your_domain?

Setup → Company Settings → My Domain

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

• In 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)

Press «Save»

Click «View» on created connected App:

Click «Manage Consumer Details»:

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

Set Remote Site Settings

1. Open Setup → Security → Remote Site Settings.
2. Press New Remote Site.
3. Set Remote Site Name field (Example: Xetfer).
4. Set Remote Site URL field equals https://cloud.xetfer.com
5. Press Save button.

Set Trusted URL

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

Set Trust IP

1. Open Setup → Security → Network Access.
2. Press the New button.
3. Add start and end IP of 35.88.169.83
4. Press Save button.

Set Permission Set to User with System Administration Profile for Registration Page:

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

Set Permission Sets to other Users for 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 Setup → Users → Permission Sets.
2. Choose Xetfer Admin Access.
3. Press Manage Assignments button.
4. Press Add Assignments button.
5. Check user.
6. Press Assign button.
7. Press Done button.

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

1. Open Setup → Users → Permission Sets.
2. Choose Xetfer User Access.
3. Press Manage Assignments button.
4. Press Add Assignments button.
5. Check user.
6. Press Assign button.
7. Press Done button.

Pass Registration

1. Open App Launcher → Find and open Xetfer Registration page.

2. Click Endpoint Settings button.

3. Input your data to form:

   • Set Middleware URL field equals https://cloud.xetfer.com
   • Set Consumer Key value copied on previous steps.
   • Set Consumer Secret value copied on previous steps.

4. Press Save button.
5. After configuring endpoint settings, click «Register User» button.

Pop-up Instructions

• Should appear pop up!
• If your browser blocks it, allow popups.
• Input your current org credentials (where Xetfer package is installed) to form → Press Allow button.

Verification:

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

Note

warning

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

• 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