Salesforce installation
This guide installs and configures the Safecube package in a Salesforce environment. The procedure is done only once per Salesforce instance. Using the Safecube app once installed is described in the Salesforce user guide.
Before you start
- The Salesforce integration is a custom add-on, not part of a Safecube plan: Safecube gives access to it on request. Contact the Safecube team before installing.
- Step 5 needs the API key of your Safecube workspace. Only an Admin or an Owner of the workspace can open it, as described in API credentials.
1. Install the Safecube package
Open the Safecube package installation link. Salesforce then asks to:
- log in to the Salesforce environment;
- confirm the installation of a non-Salesforce application;
- authorize
api.sinay.aito send container tracking data to Salesforce.
2. Assign the Safecube permission set
Every Salesforce user who needs Safecube must have the Safecube permission set:
- Open Setup in Salesforce.
- In the Quick Find box, type Permission Sets and select it.
- Click the
Safecubepermission set. - Click Manage Assignments, then Add Assignments.
- Select the users who need access, click Next, then Assign.
3. Activate a site to get a public URL
Salesforce requires a public site URL for external integrations:
- Open Setup in Salesforce.
- In the Quick Find box, type Sites and select it.
- Click New to create a site.
- Fill in the site information:
Field Value Site Label SafecubeSite Name SafecubeDefault Web Address SafecubeActive Checked Active Site Home Page Unauthorized - Click Save.
4. Assign the guest user permission set
A technical guest user holds the permissions on the Safecube application settings, including the API key:
- In the Quick Find box, type Sites and select it.
- Click the Safecube site.
- Select Public Access Settings, then View Users.
- Click Site Guest User.
- Select Permission Set Assignment, then Edit Assignments.
- Search for Safecube Guest User, click Add, then Save.
5. Configure the Safecube API key
The API key gives Salesforce the right to access container tracking data:
- In the Quick Find box, type Custom Settings and select it.
- Next to Safecube Settings, select Manage, then New.
- In another browser tab, open the Safecube platform as an Admin or an Owner, select Developers in the sidebar, then the API Credentials tab, and select Copy key.
- Back in the Safecube Settings of Salesforce, paste the API key in the API Key field and click Save.
6. Set up the Safecube public URL
Safecube sends tracking data to the Salesforce instance through this public URL:
- In the Quick Find box, type Sites and select it.
- On the Safecube site, right-click the Domain Name and select Copy link address.
- In the Quick Find box, type Custom Settings and select Safecube Settings.
- Select Manage, then Edit.
- Paste the public URL and click Save.
7. Activate the endpoint
- Open the App Launcher, then the Safecube application.
- Select the Safecube Settings tab.
- Click Create endpoint.
The installation is complete: the Safecube container tracking app is ready to use in the Salesforce instance.
For any issue during the installation, contact the Safecube support team.