> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/fr/pam/deploy-operate/install-single-node.md).

# Installer un nœud unique

Le parcours documenté pour monter une instance à partir de l'image d'appliance : configuration par la console, DNS, première connexion et licence, ainsi que les parties de la procédure que seul DataDi

{% hint style="warning" %}
**Validez cette procédure face à la version que vous déployez.** La procédure d'installation change d'une version à l'autre, et les sources à partir desquelles cette page est construite n'indiquent pas pour quelle version elles ont été écrites. Avant de commencer, confirmez auprès de DataDike la procédure en vigueur et l'image d'appliance appropriée.

L'image elle-même, le fichier de licence et les étapes d'installation de bas niveau sont maintenus par DataDike et ne sont pas reproduits ici. Rien sur cette page ne remplace les notes d'installation propres à la version.
{% endhint %}

## De quoi il s'agit et quand l'utiliser

Le parcours à nœud unique : une machine, qui exécute tout. C'est la forme adaptée à un laboratoire, à une preuve de concept, ou à un environnement de production qui n'a pas besoin de survivre à la perte du nœud. Si l'accès doit survivre à la panne d'un nœud, déployez plutôt un cluster ; voir [Installer un cluster à haute disponibilité](https://wiki.datadike.com/fr/pam/deploy-operate/install-cluster.md).

Le déploiement est conteneurisé et placé derrière nginx. Il est livré sous forme d'une image d'appliance que vous importez dans votre hyperviseur ou votre cloud, puis que vous configurez depuis un menu console au premier démarrage.

## Avant de commencer

* Une machine conforme aux [prérequis système](https://wiki.datadike.com/fr/pam/deploy-operate/requirements.md), avec le disque dimensionné pour votre rétention d'enregistrements plutôt que pour le chiffre minimal.
* Les règles de pare-feu issues des [prérequis réseau et connectivité](https://wiki.datadike.com/fr/pam/deploy-operate/network-requirements.md), convenues avant le déploiement de la machine et non après.
* L'image d'appliance et le fichier de licence, obtenus auprès de DataDike.
* Un nom DNS pour l'instance et la possibilité de créer l'enregistrement dans votre DNS privé. Un certificat wildcard ou de sous-domaine si vous terminez le HTTPS sur l'instance.
* Le contact du support de mise en œuvre. Deux des étapes ci-dessous, l'installation du certificat et toute modification du fichier de configuration de l'appliance, sont réalisées par cette équipe en ligne de commande sur l'appliance.

## Étapes

1. **Importez l'image d'appliance** dans l'hyperviseur ou le cloud et démarrez-la.
2. **Configurez la machine depuis la console de premier démarrage.** Connectez-vous à la console avec l'utilisateur d'appliance documenté (voir [Valeurs par défaut documentées](#valeurs-par-defaut-documentees), plus bas). Le menu couvre la configuration réseau, le nom d'hôte, les informations système, ainsi que le redémarrage et l'arrêt.
3. **Réglez correctement la date, l'heure et le fuseau horaire** avant d'aller plus loin. Une horloge qui a dérivé casse les mots de passe à usage unique et se confond aisément avec un défaut d'authentification.
4. **Atteignez la console par son nom, temporairement.** Tant que l'enregistrement DNS n'existe pas, ajoutez une entrée associant l'adresse de l'instance à son nom d'hôte dans le fichier hosts de votre propre poste de travail ; sous Windows, `C:\Windows\System32\drivers\etc\hosts`. Il s'agit d'une aide à la configuration limitée à votre machine, pas d'une étape du déploiement.
5. **Connectez-vous à la console** sur `https://<your-hostname>` avec le compte administrateur par défaut documenté, et changez son mot de passe immédiatement.
6. **Importez la licence.** Toutes les fonctions de la plateforme restent désactivées tant que la licence n'est pas importée : faites-le donc avant d'essayer autre chose et de conclure que l'installation est cassée.
7. **Installez le certificat HTTPS.** Cette opération est réalisée par l'équipe de support de mise en œuvre en ligne de commande sur l'appliance, avec votre certificat wildcard ou de sous-domaine.
8. **Créez les enregistrements DNS définitifs**, dans votre DNS privé et également dans le DNS public si vous publiez la console par NAT ou DNAT. Supprimez ensuite l'entrée hosts temporaire de votre poste de travail.
9. **Validez les règles de pare-feu** face aux [prérequis réseau et connectivité](https://wiki.datadike.com/fr/pam/deploy-operate/network-requirements.md), depuis un client placé là où se trouveront les utilisateurs réels.
10. **Raccordez vos sources d'authentification** et fixez les seuils d'inactivité et de désactivation automatique des comptes.
11. **Enregistrez les actifs** à protéger, manuellement, par import d'un tableur, ou par découverte et synchronisation.
12. **Enregistrez les comptes** à gérer sur ces actifs.
13. **Configurez le serveur de messagerie.** Il porte la livraison des sauvegardes, les alertes et les circuits d'approbation : sans lui, plusieurs fonctions ultérieures ne font silencieusement rien.
14. **Mettez en place la politique et l'automatisation de sauvegarde du coffre-fort**, et fixez les durées de rétention des journaux et des enregistrements de session.
15. **Coupez l'enregistrement des composants.** Une fois que tous les composants se sont enregistrés, décochez **Registration** dans **Paramètres système › Composants › Basique**. Tant qu'il est activé, tout composant connaissant l'adresse de l'instance peut s'enregistrer de lui-même. Ne le réactivez que le temps d'ajouter un nouveau composant.

## Ce que vous devez observer

La console répond en HTTPS sur son nom DNS, avec un certificat valide. Après l'import de la licence, les zones de menu jusque-là inertes deviennent utilisables. **Paramètres système › Composants** liste les microservices de la plateforme (l'API core, le service de tâches et les connecteurs terminal, graphique, base de données et applications virtuelles), chacun avec un **Load status** à **Normal** et une **Adresse distante** pointant sur le nœud.

## Comment vérifier que cela a fonctionné

Quatre contrôles, dans cet ordre. Chacun prouve quelque chose que le précédent ne prouve pas.

1. **Les dépendances de la plateforme elle-même.** Interrogez `/api/health/`, sans authentification. Le JSON renvoyé porte `status`, `db_status`, `db_time`, `redis_status`, `redis_time` et `time`. Une réponse saine prouve que la base de données et Redis sont joignables, ce qu'un simple « la page de connexion s'affiche » ne prouve pas.
2. **Les composants.** Dans **Paramètres système › Composants**, chaque composant affiche **Normal**. Tout composant marqué **Hors ligne** est un service qui n'est pas monté, et les connecteurs sont ceux que les utilisateurs remarqueront en premier.
3. **L'horloge et le second facteur.** Enrôlez un compte avec un mot de passe à usage unique et connectez-vous avec. Si le code est rejeté, c'est l'horloge qui est fausse, pas le compte.
4. **Une session réelle, de bout en bout.** Connectez-vous à un actif enregistré avec un compte géré, puis retrouvez cette session dans la piste d'audit, son enregistrement joint et lisible. C'est le seul contrôle qui éprouve tout le chemin : authentification, autorisation, injection de l'identifiant, connecteur et magasin d'enregistrements.

## Erreurs fréquentes

| Symptôme                                                                                                   | Cause                                                                                                                         | Correction                                                                                                                                      |
| ---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| La console s'affiche mais la plupart des fonctions sont indisponibles                                      | La licence n'a pas été importée                                                                                               | Importez la licence. Toutes les fonctions restent désactivées tant qu'elle n'est pas présente                                                   |
| Le nom d'hôte ne se résout pas pendant la configuration                                                    | L'enregistrement DNS n'a pas encore été créé                                                                                  | Ajoutez l'entrée hosts temporaire sur votre propre poste de travail, puis créez l'enregistrement définitif dans votre DNS privé                 |
| *OTP code invalid, or server time error* à chaque connexion                                                | L'horloge du nœud a dérivé ; le TOTP est validé à la seconde                                                                  | Synchronisez l'horloge par NTP et réglez le bon fuseau horaire                                                                                  |
| Un composant apparaît **Hors ligne** dans la liste des composants                                          | Le service n'a pas démarré sur le nœud où il est installé                                                                     | Vérifiez ce service sur ce nœud. Une API core hors ligne met toute la plateforme à terre ; un connecteur hors ligne supprime un type de session |
| Le disque du nœud se remplit en quelques semaines                                                          | Les enregistrements partent toujours vers le backend local **default**, qui n'a aucune redondance et ne passe pas à l'échelle | Configurez un stockage objet externe et faites-en le backend par défaut                                                                         |
| Les sessions issues d'un réseau client échouent alors qu'elles fonctionnent depuis le réseau de la console | Une règle de pare-feu a été validée depuis le mauvais endroit                                                                 | Retestez depuis un client placé là où se trouvent les utilisateurs réels                                                                        |

## Valeurs par défaut documentées

Voici les valeurs par défaut que documentent les sources. Considérez-les toutes comme des éléments à changer ou à confirmer, non comme une configuration à conserver.

| Élément                                  | Valeur par défaut documentée                    | Remarque                                                                                        |
| ---------------------------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Utilisateur de la console de l'appliance | `client` / `client@client`                      | À changer dans le cadre de l'installation                                                       |
| Administrateur de la console             | `admin` / `datadike`                            | À changer à la première connexion, avant que l'instance ne soit joignable par quiconque d'autre |
| Accès à la solution en ligne de commande | SSH sur le port 2222                            | Pas le port 22 ; celui-ci appartient aux actifs                                                 |
| Backend d'enregistrement                 | **default**, de type **Serveur** (disque local) | Ne convient pas à la production                                                                 |
| Enregistrement des composants            | Activé                                          | À désactiver une fois l'installation terminée                                                   |
| Délai de grâce de la licence             | 7 jours après l'expiration                      | C'est le temps de charger la nouvelle licence, pas une période sans licence                     |

{% hint style="danger" %}
Les deux identifiants par défaut ci-dessus sont publiés dans la documentation du fabricant, ce qui signifie qu'un attaquant les possède aussi. Changez-les tous les deux avant que l'instance ne soit joignable depuis autre chose que votre propre poste de travail.
{% endhint %}

## Pages associées

* [Prérequis système](https://wiki.datadike.com/fr/pam/deploy-operate/requirements.md)
* [Prérequis réseau et connectivité](https://wiki.datadike.com/fr/pam/deploy-operate/network-requirements.md)
* [Installer un cluster à haute disponibilité](https://wiki.datadike.com/fr/pam/deploy-operate/install-cluster.md)
* [LDAP et Active Directory](https://wiki.datadike.com/fr/pam/administration/identities/ldap-and-ad.md)
* [Concepts fondamentaux](https://wiki.datadike.com/fr/pam/get-started/core-concepts.md)
