> For the complete documentation index, see [llms.txt](https://documentation.efalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.efalia.com/documentations/efalia-doc/integrations/integration-avec-efalia-safe.md).

# Intégration avec Efalia Safe

## Architecture cible

<figure><img src="/files/aN6kWeyqR8r3crFJBOw2" alt=""><figcaption></figcaption></figure>

## Configuration requise pour les **postes clients**

| **Application**                 | **Pré-requis**                                                                                                                                     |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Application Web Efalia Safe** | Un navigateur Web **récent** (moins de 2 ans). Chrome, Firefox, Edge, Opera,…… Il est nécessaire d’autoriser l’usage de Javascript et des Cookies. |

## Configuration requise pour le **serveur Efalia Safe**

Afin d’uniformiser les serveurs de production, nous utilisons notre image dédiée satisfaisant tous les prérequis systèmes : <http://vm.efalia.com/index.html>

Nous disposons actuellement d’une image pour les hyperviseurs :

* vSphere 6.5 et suivants.
* Hyper-V fonctionnant sur Windows 10 Entreprise 2016 et suivants.

Cette image est livrée avec un disque dynamique, qui s’adapte à la taille des données que contiendra la VM. Cependant, le stockage externe (via NFS ou Samba) reste la configuration recommandée.

Comme il s’agit d’une machine virtuelle, les ressources ne sont pas partagées.

### Spécifications matérielles

| É**léments**          | **Version**                                                                                  |
| --------------------- | -------------------------------------------------------------------------------------------- |
| **Machine virtuelle** | <p>Puissance minimale : 2 CPU, 4 Go de RAM<br>Puissance recommandée : 4 CPU, 8 Go de RAM</p> |
| **OS** dans la VM     | Linux Debian 10                                                                              |

### Configuration réseau

| É**léments**             | **Version**                                                                                                                                                                                          |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Installation**         | <p>– Accès temporaire à internet depuis la VM.<br>– Accès SSH direct à la VM depuis l’IP fixe 5.50.76.81 sur le port 22 ou autre (à préciser par le client).</p>                                     |
| **Accès**                | Les ports 443 et 1505 doivent être ouverts et accessibles en interne pour que les utilisateurs puissent accéder à l’application depuis leur navigateur (ou 80 et 2103 pour le HTTP).                 |
| **Horodatage**           | Le serveur doit avoir un accès total et constant à ws.universign.eu                                                                                                                                  |
| **Mise à jour**          | Accès temporaire à internet depuis la VM.                                                                                                                                                            |
| **Remontée des erreurs** | <p>La VM doit avoir accès constant, via le protocole HTTPS, au domaine suivant dans le cadre de la procédure de support : sentry.io<br><br>Note : cette fonctionnalité est désactivable.</p>         |
| **Traces d’usage**       | <p>La VM doit avoir accès constant, via le protocole HTTPS, au domaine suivant dans le cadre de la collecte de trace d’usage : mixpanel.com<br><br>Note : cette fonctionnalité est désactivable.</p> |

Si la VM ne peut pas accéder à tout internet lors de l’installation ou de la mise à jour de l’application, il est nécessaire qu’elle puisse accéder à certains domaines (liste sur demande, car cette liste est changeante).

## Installation d’une nouvelle instance

L’installation se fait exclusivement à distance par un technicien Efalia, via une connexion SSH directe et nécessite un accès temporaire à internet pour récupérer les nouveaux composants de l’application (voir la liste des domaines nécessaires ci-dessus)

## Mise à jour d’une instance

La mise à jour d’une instance se fait directement depuis son interface graphique et nécessite un accès temporaire à internet pour récupérer les nouveaux composants de l’application (voir la liste des domaines nécessaires ci-dessus).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://documentation.efalia.com/documentations/efalia-doc/integrations/integration-avec-efalia-safe.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
