# Installation Salesforce

> L'installation du package Safecube dans Salesforce se fait en sept étapes, une seule fois par instance Salesforce — installer le package, affecter les permission sets, créer un site public, puis configurer la clé d'API et l'endpoint.

Ce guide installe et configure le package Safecube dans un environnement Salesforce. La procédure ne se fait qu'une fois par instance Salesforce. L'utilisation de l'app Safecube une fois installée est décrite dans le [guide d'utilisation Salesforce](/fr/platform/integrations/salesforce-user-guide).

## Avant de commencer

- L'intégration Salesforce est un add-on sur mesure, qui ne fait partie d'aucun plan Safecube : Safecube en ouvre l'accès sur demande. [Contactez l'équipe Safecube](https://app.safecube.ai/contact) avant l'installation.
- L'étape 5 demande la clé d'API de votre espace de travail Safecube. Seul un Admin ou un Owner de l'espace de travail peut l'ouvrir, comme décrit dans [Identifiants d'API](/fr/platform/developers/api-credentials).

Les libellés de Salesforce sont cités en anglais, tels qu'ils apparaissent dans l'interface anglaise de Salesforce.

## 1. Installer le package Safecube

Ouvrez le [lien d'installation du package Safecube](https://login.salesforce.com/packaging/installPackage.apexp?p0=04tgK0000001qcTQAQ). Salesforce demande alors de :

- se connecter à l'environnement Salesforce ;
- confirmer l'installation d'une application non-Salesforce ;
- autoriser `api.sinay.ai` à envoyer les données de suivi de conteneurs à Salesforce.

## 2. Affecter le permission set Safecube

Chaque utilisateur Salesforce qui a besoin de Safecube doit avoir le permission set `Safecube` :

1. Ouvrez **Setup** dans Salesforce.
2. Dans la zone Quick Find, saisissez **Permission Sets** et sélectionnez-le.
3. Cliquez sur le permission set `Safecube`.
4. Cliquez sur **Manage Assignments**, puis sur **Add Assignments**.
5. Sélectionnez les utilisateurs qui ont besoin d'un accès, cliquez sur **Next**, puis sur **Assign**.

## 3. Activer un site pour obtenir une URL publique

Salesforce exige une URL de site public pour les intégrations externes :

1. Ouvrez **Setup** dans Salesforce.
2. Dans la zone Quick Find, saisissez **Sites** et sélectionnez-le.
3. Cliquez sur **New** pour créer un site.
4. Renseignez les informations du site :

   | Champ                 | Valeur         |
   | --------------------- | -------------- |
   | Site Label            | `Safecube`     |
   | Site Name             | `Safecube`     |
   | Default Web Address   | `Safecube`     |
   | Active                | Coché          |
   | Active Site Home Page | `Unauthorized` |

5. Cliquez sur **Save**.

## 4. Affecter le permission set de l'utilisateur invité

Un utilisateur invité technique porte les permissions sur les paramètres de l'application Safecube, clé d'API comprise :

1. Dans la zone Quick Find, saisissez **Sites** et sélectionnez-le.
2. Cliquez sur le site **Safecube**.
3. Sélectionnez **Public Access Settings**, puis **View Users**.
4. Cliquez sur **Site Guest User**.
5. Sélectionnez **Permission Set Assignment**, puis **Edit Assignments**.
6. Recherchez **Safecube Guest User**, cliquez sur **Add**, puis sur **Save**.

## 5. Configurer la clé d'API Safecube

La clé d'API donne à Salesforce le droit d'accéder aux données de suivi de conteneurs :

1. Dans la zone Quick Find, saisissez **Custom Settings** et sélectionnez-le.
2. À côté de **Safecube Settings**, sélectionnez **Manage**, puis **New**.
3. Dans un autre onglet du navigateur, ouvrez la plateforme Safecube en tant qu'Admin ou Owner, sélectionnez **Developers** dans la barre latérale, puis l'onglet **API Credentials**, et sélectionnez **Copy key**.
4. De retour dans les Safecube Settings de Salesforce, collez la clé d'API dans le champ **API Key** et cliquez sur **Save**.

::callout{type="warning"}
Le renouvellement de la clé d'API dans Safecube invalide aussitôt l'ancienne clé : toute requête que Salesforce envoie à Safecube avec l'ancienne clé échoue jusqu'à ce que vous colliez la nouvelle clé dans le champ **API Key** des Safecube Settings. Le renouvellement est décrit dans [Identifiants d'API](/fr/platform/developers/api-credentials).
::

## 6. Configurer l'URL publique Safecube

Safecube envoie les données de suivi à l'instance Salesforce par cette URL publique :

1. Dans la zone Quick Find, saisissez **Sites** et sélectionnez-le.
2. Sur le site **Safecube**, faites un clic droit sur le **Domain Name** et sélectionnez **Copier l'adresse du lien**.
3. Dans la zone Quick Find, saisissez **Custom Settings** et sélectionnez **Safecube Settings**.
4. Sélectionnez **Manage**, puis **Edit**.
5. Collez l'URL publique et cliquez sur **Save**.

::callout{type="warning"}
Copiez le nom de domaine avec **Copier l'adresse du lien**, pas en sélectionnant le texte. Une URL copiée depuis une sélection de texte ne fonctionne pas, et l'endpoint ne peut pas être créé à l'étape 7.
::

## 7. Activer l'endpoint

1. Ouvrez l'App Launcher, puis l'application **Safecube**.
2. Sélectionnez l'onglet **Safecube Settings**.
3. Cliquez sur **Create endpoint**.

L'installation est terminée : l'app de suivi de conteneurs Safecube est prête à l'emploi dans l'instance Salesforce.

Pour tout problème pendant l'installation, [contactez le support Safecube](https://app.safecube.ai/contact).
