* Suivez les instructions, lisez les messages, vérifiez les éventuels conflits de ports et redémarrez

<!-- TOC -->
- [T-Pot - La plateforme multi honeypots tout-en-un](#t-pot---the-all-in-one-multi-honeypot-platform)
- [TL;DR](#tldr)
- [Avertissement](#disclaimer)
- [Concept technique](#technical-concept)
  - [Honeypots et outils](#honeypots-and-tools)
  - [Architecture technique](#technical-architecture)
  - [Services](#services)
  - [Types d'utilisateurs](#user-types)
- [Configuration système requise](#system-requirements)
  - [Exécution dans une VM](#running-in-a-vm)
  - [Exécution sur du matériel](#running-on-hardware)
  - [Exécution dans le cloud](#running-in-a-cloud)
  - [Ports requis](#required-ports)
  - [Honeypots basés sur LLM](#llm-based-honeypots)
    - [Ollama](#ollama)
    - [ChatGPT](#chatgpt)
- [Placement du système](#system-placement)
- [Installation](#installation)
  - [Choisissez votre distribution](#choose-your-distro)
  - [Support Raspberry Pi 4 (8 Go)](#raspberry-pi-4-8gb-support)
  - [Obtenez et installez T-Pot](#get-and-install-t-pot)
  - [macOS et Windows](#macos--windows)
  - [Red Hat Enterprise Linux](#red-hat-enterprise-linux)
  - [Types d'installation](#installation-types)
    - [Standard / Ruche](#standard--hive)
    - [Distribuée](#distributed)
  - [Désinstaller T-Pot](#uninstall-t-pot)
- [Premier démarrage](#first-start)
  - [Premier démarrage autonome](#standalone-first-start)
  - [Déploiement distribué](#distributed-deployment)
    - [Planification et certificats](#planning-and-certificates)
    - [Déploiement des capteurs](#deploying-sensors)
    - [Suppression des capteurs](#removing-sensors)
  - [Soumission de données à la communauté](#community-data-submission)
  - [Soumission de données HPFEEDS (opt-in)](#opt-in-hpfeeds-data-submission)
- [Accès à distance et outils](#remote-access-and-tools)
  - [SSH](#ssh)
  - [Page d'accueil de T-Pot](#t-pot-landing-page)
  - [Tableau de bord Kibana](#kibana-dashboard)
  - [Carte des attaques](#attack-map)
  - [Cyberchef](#cyberchef)
  - [Elasticvue](#elasticvue)
  - [Spiderfoot](#spiderfoot)
- [Configuration](#configuration)
  - [Fichier de configuration T-Pot](#t-pot-config-file)
  - [Personnaliser les honeypots et services T-Pot](#customize-t-pot-honeypots-and-services)
- [Maintenance](#maintenance)
  - [Mises à jour générales](#general-updates)
  - [Script de mise à jour](#update-script)
  - [Redémarrage quotidien](#daily-reboot)
  - [Problèmes connus](#known-issues)
    - [Échec du téléchargement des images Docker](#docker-images-fail-to-download)
    - [Échec du réseau T-Pot](#t-pot-networking-fails)
  - [Démarrer T-Pot](#start-t-pot)
  - [Arrêter T-Pot](#stop-t-pot)
  - [Dossier de données T-Pot](#t-pot-data-folder)
  - [Persistance des journaux](#log-persistence)
  - [Réinitialisation d'usine](#factory-reset)
  - [Afficher les conteneurs et images](#show-containers-and-images)
  - [Blackhole](#blackhole)
  - [Ajouter des utilisateurs à Nginx (interface Web T-Pot)](#add-users-to-nginx-t-pot-webui)
  - [Importer et exporter des objets Kibana](#import-and-export-kibana-objects)
    - [Exportation](#export)
    - [Importation](#import)
- [Dépannage](#troubleshooting)
  - [Journaux](#logs)
  - [RAM et stockage](#ram-and-storage)
- [Contact](#contact)
  - [Problèmes](#issues)
  - [Discussions](#discussions)
- [Licences](#licenses)
- [Crédits](#credits)
  - [Les développeurs et communautés de développement de](#the-developers-and-development-communities-of)
  - [**Les entreprises et organisations suivantes**](#the-following-companies-and-organizations)
  - [**Et bien sûr ***VOUS*** pour rejoindre la communauté !**](#and-of-course-you-for-joining-the-community)
- [Témoignages](#testimonials)
- [Merci 💖](#thank-you-)
<!-- TOC -->
<br><br>

# Avertissement
- Vous installez et exécutez T-Pot sous votre responsabilité. Choisissez votre déploiement avec soin, car une compromission du système ne peut jamais être exclue.
- Pour une aide rapide, consultez les [Problèmes](https://github.com/telekom-security/tpotce/issues) et [Discussions](https://github.com/telekom-security/tpotce/discussions).
- Le logiciel est conçu et proposé avec la meilleure intention possible. En tant que projet communautaire et open source, il utilise de nombreux autres logiciels open source et peut contenir des bugs et des problèmes. Signalez-les de manière responsable.
- Les honeypots – par conception – ne doivent pas héberger de données sensibles. Assurez-vous de ne pas en ajouter.
- Par défaut, vos données sont soumises à [Sicherheitstacho](https://www.sicherheitstacho.eu/start/main). Vous pouvez désactiver cela dans la configuration (`~/tpotce/docker-compose.yml`) en [supprimant](#community-data-submission) la section `ewsposter`. Mais dans ce cas, partager c'est prendre soin !
<br><br>

# Concept technique
Les principaux composants de T-Pot ont été déplacés dans l'image Docker `tpotinit`, permettant ainsi à T-Pot de supporter désormais plusieurs distributions Linux, voire macOS et Windows (bien que tous deux limités aux fonctionnalités de Docker Desktop). T-Pot utilise [docker](https://www.docker.com/) et [docker compose](https://docs.docker.com/compose/) pour atteindre son objectif d'exécuter le plus grand nombre de honeypots et d'outils possible simultanément, exploitant ainsi au maximum le matériel de l'hôte.
<br><br>

## Honeypots et outils
- T-Pot propose des images Docker pour les honeypots suivants :<br>
[adbhoney](https://github.com/huuck/ADBHoney),
[beelzebub](https://github.com/beelzebub-labs/beelzebub),
[ciscoasa](https://github.com/Cymmetria/ciscoasa_honeypot),
[citrixhoneypot](https://github.com/MalwareTech/CitrixHoneypot),
[conpot](http://conpot.org/),
[cowrie](https://github.com/cowrie/cowrie),
[ddospot](https://github.com/aelth/ddospot),
[dicompot](https://github.com/nsmfoo/dicompot),
[dionaea](https://github.com/DinoTools/dionaea),
[elasticpot](https://gitlab.com/bontchev/elasticpot),
[endlessh](https://github.com/skeeto/endlessh),
[galah](https://github.com/0x4D31/galah),
[go-pot](https://github.com/ryanolee/go-pot),
[glutton](https://github.com/mushorg/glutton),
[h0neytr4p](https://github.com/pbssubhash/h0neytr4p),
[hellpot](https://github.com/yunginnanet/HellPot),
[heralding](https://github.com/johnnykv/heralding),
[honeyaml](https://github.com/mmta/honeyaml),
[honeypots](https://github.com/qeeqbox/honeypots),
[honeytrap](https://github.com/armedpot/honeytrap/),
[ipphoney](https://gitlab.com/bontchev/ipphoney),
[log4pot](https://github.com/thomaspatzke/Log4Pot),
[mailoney](https://github.com/phin3has/mailoney),
[medpot](https://github.com/schmalle/medpot),
[miniprint](https://github.com/sa7mon/miniprint),
[redishoneypot](https://github.com/cypwnpwnsocute/RedisHoneyPot),
[rdphoneypot](https://gitlab.com/bontchev/rdphoneypot),
[sentrypeer](https://github.com/SentryPeer/SentryPeer),
[snare](http://mushmush.org/),
[tanner](http://mushmush.org/),
[wordpot](https://github.com/gbrindisi/wordpot)

Aux côtés des outils suivants :
* [Autoheal](https://github.com/willfarrell/docker-autoheal) un outil pour redémarrer automatiquement les conteneurs dont les contrôles de santé ont échoué.
* [Cyberchef](https://gchq.github.io/CyberChef/) une application web pour le chiffrement, l'encodage, la compression et l'analyse de données.
* [Elastic Stack](https://www.elastic.co/videos) pour visualiser magnifiquement tous les événements capturés par T-Pot.
* [Elasticvue](https://github.com/cars10/elasticvue/) une interface web frontale pour naviguer et interagir avec un cluster Elasticsearch.
* [Fatt](https://github.com/0x4D31/fatt) un script basé sur pyshark pour extraire les métadonnées réseau et les empreintes digitales à partir de fichiers pcap et du trafic réseau en direct.
* [T-Pot-Attack-Map](https://github.com/telekom-security/t-pot-attack-map) une carte d'attaque magnifiquement animée pour T-Pot.
* [P0f](https://lcamtuf.coredump.cx/p0f3/) est un outil pour l'empreinte passive pure du trafic.
* [Spiderfoot](https://github.com/smicallef/spiderfoot) un outil d'automatisation de renseignement open source.
* [Suricata](https://suricata.io/) un moteur de surveillance de la sécurité réseau.

... pour vous offrir la meilleure expérience prête à l'emploi possible et un système multi-honeypot facile à utiliser.
<br><br>


## Architecture technique
![Architecture](https://assets.kitploit.com/production/public/readmes/4462/3fe1e953817d210102d0a4c79a55bebd32d23014d6ddefa058719411cfc9d178.png)

Le code source et les fichiers de configuration sont entièrement stockés dans le référentiel GitHub de T-Pot. Les images Docker sont construites et préconfigurées pour l'environnement T-Pot.

Les Dockerfiles et configurations individuels se trouvent dans le [dossier docker](https://github.com/telekom-security/tpotce/tree/master/docker).
<br><br>

## Services
T-Pot offre un certain nombre de services qui sont essentiellement divisés en cinq groupes :
1. Services système fournis par le système d'exploitation
    * SSH pour l'accès à distance sécurisé.
2. Elastic Stack
    * Elasticsearch pour le stockage des événements.
    * Logstash pour l'ingestion, la réception et l'envoi d'événements à Elasticsearch.
    * Kibana pour l'affichage des événements sur des tableaux de bord magnifiquement rendus.
3. Outils
    * NGINX fournit un accès à distance sécurisé (proxy inverse) à Kibana, CyberChef, Elasticvue, GeoIP AttackMap, Spiderfoot et permet aux capteurs T-Pot de transmettre en toute sécurité les données d'événements à la ruche T-Pot.
    * CyberChef une application web pour le chiffrement, l'encodage, la compression et l'analyse de données.
    * Elasticvue une interface web frontale pour naviguer et interagir avec un cluster Elasticsearch.
    * T-Pot Attack Map une carte d'attaque magnifiquement animée pour T-Pot.
    * Spiderfoot un outil d'automatisation de renseignement open source.
4. Honeypots
    * Une sélection des 23 honeypots disponibles basée sur le `docker-compose.yml` choisi.
5. Surveillance de la sécurité réseau (NSM)
    * Fatt un script basé sur pyshark pour extraire les métadonnées réseau et les empreintes digitales à partir de fichiers pcap et du trafic réseau en direct.
    * P0f est un outil pour l'empreinte passive pure du trafic.
    * Suricata un moteur de surveillance de la sécurité réseau.
<br><br>

## Types d'utilisateurs
Pendant l'installation et lors de l'utilisation de T-Pot, il existe deux types différents de comptes avec lesquels vous allez travailler. Assurez-vous de connaître les différences entre les différents types de comptes, car c'est **de loin** la raison la plus courante des erreurs d'authentification.

| Service          | Type de compte | Nom d'utilisateur / Groupe | Description                                                        |
|:-----------------|:---------------|:---------------------------|:-------------------------------------------------------------------|
| SSH              | OS             | `<OS_USERNAME>`            | L'utilisateur que vous avez choisi lors de l'installation du système d'exploitation.              |
| Nginx            | BasicAuth      | `<WEB_USER>`               | Le `<web_user>` que vous avez choisi lors de l'installation de T-Pot.           |
| CyberChef        | BasicAuth      | `<WEB_USER>`               | Le `<web_user>` que vous avez choisi lors de l'installation de T-Pot.           |
| Elasticvue       | BasicAuth      | `<WEB_USER>`               | Le `<web_user>` que vous avez choisi lors de l'installation de T-Pot.           |
| Geoip Attack Map | BasicAuth      | `<WEB_USER>`               | Le `<web_user>` que vous avez choisi lors de l'installation de T-Pot.           |
| Spiderfoot       | BasicAuth      | `<WEB_USER>`               | Le `<web_user>` que vous avez choisi lors de l'installation de T-Pot.           |
| T-Pot            | OS             | `tpot`                     | `tpot` cet utilisateur / groupe est toujours réservé par les services T-Pot. |
| Journaux T-Pot   | BasicAuth      | `<LS_WEB_USER>`            | Les `LS_WEB_USER` sont gérés automatiquement.                           |


<br><br>

# Configuration système requise

Selon les [images de distribution Linux supportées](#choose-your-distro), la ruche / capteur, l'installation sur [matériel réel](#running-on-hardware), dans une [machine virtuelle](#running-in-a-vm) ou d'autres environnements, il existe différents types d'exigences à respecter concernant le système d'exploitation, la RAM, le stockage et le réseau pour une installation réussie de T-Pot (vous pouvez toujours ajuster `~/tpotce/docker-compose.yml` et `~/tpotce/.env` selon vos besoins pour surmonter ces exigences).
<br><br>

| Type T-Pot | RAM  | Stockage   | Description                                                                                      |
|:-----------|:-----|:-----------|:-------------------------------------------------------------------------------------------------|
| Ruche      | 16 Go | 256 Go SSD | En règle générale, plus il y a de honeypots, capteurs et données, plus il faut de RAM et de stockage.      |
| Capteur    | 8 Go  | 128 Go SSD | Étant donné que les journaux des honeypots sont conservés (~/tpotce/data) pendant 30 jours, le stockage dépend du volume d'attaques. |

T-Pot nécessite ...
- une adresse IPv4 via DHCP ou attribuée statiquement
- une connexion Internet fonctionnelle et non proxyée
... pour une installation et un fonctionnement réussis.
<br><br>
*Si vous avez besoin du support proxy ou d'autres fonctionnalités non standard, vous devriez consulter la documentation des [images de distribution Linux supportées](#choose-your-distro) et/ou la [documentation Docker](https://docs.docker.com/).*
<br><br>

## Exécution dans une VM
Toutes les [images de distribution Linux supportées](#choose-your-distro) s'exécuteront dans une VM, ce qui signifie que T-Pot fonctionnera très bien. Les suivantes ont été testées / signalées comme fonctionnant :
* [UTM (Intel et Apple Silicon)](https://mac.getutm.app/)
* [VirtualBox](https://www.virtualbox.org/)
* [VMWare Fusion](https://www.vmware.com/products/desktop-hypervisor/workstation-and-fusion) et [VMWare Workstation](https://www.vmware.com/products/desktop-hypervisor/workstation-and-fusion)
* KVM est également signalé comme fonctionnant.

***Quelques conseils de configuration / mise en place :***
- Bien que les versions Intel soient stables, le support Apple Silicon (arm64) présente des problèmes connus qui, dans UTM, peuvent nécessiter de passer l'`Affichage` en `Console uniquement` lors de l'installation initiale du système d'exploitation, puis de revenir à `Plein écran graphique`.
- Lors de la configuration, vous devrez peut-être activer le mode promiscuité pour l'interface réseau afin que fatt, suricata et p0f fonctionnent correctement.
- Si vous souhaitez utiliser une carte Wi-Fi comme interface réseau principale pour T-Pot, veuillez noter que tous les pilotes d'interface réseau ne prennent pas en charge toutes les cartes sans fil. Dans VirtualBox par exemple, vous devez choisir le modèle *"MT SERVER"* de la carte NIC.
<br><br>

## Exécution sur du matériel
T-Pot est uniquement limité par le support matériel des [images de distribution Linux supportées](#choose-your-distro). Il est recommandé de vérifier la HCL (liste de compatibilité matérielle) et de tester les distributions supportées avec T-Pot avant d'investir dans du matériel dédié.
<br><br>

## Exécution dans le cloud
T-Pot a été testé et est connu pour fonctionner sur ...
* Telekom OTC en utilisant la méthode post-installation
... d'autres peuvent fonctionner, mais restent non testés.

Certains utilisateurs signalent des installations fonctionnelles sur d'autres clouds et hébergeurs, par exemple Azure et GCP. Les exigences matérielles peuvent être différentes. Si vous n'êtes pas sûr, vous devriez rechercher les [problèmes](https://github.com/telekom-security/tpotce/issues) et les [discussions](https://github.com/telekom-security/tpotce/discussions) et effectuer quelques tests fonctionnels. Avec T-Pot 24.04.0 et versions ultérieures, nous avons veillé à supprimer les paramètres connus pour interférer avec les installations cloud.
<br><br>

## Ports requis
Outre les ports généralement nécessaires au système d'exploitation, par exemple pour obtenir un bail DHCP, DNS, etc., T-Pot nécessitera les ports suivants pour les connexions entrantes / sortantes. Consultez l'[Architecture T-Pot](#technical-architecture) pour une représentation visuelle. Certains ports apparaîtront en double, ce qui est normal car utilisés dans différentes éditions.| Port                                                                                                                               | Protocole | Direction | Description                                                                                                     |
|:-----------------------------------------------------------------------------------------------------------------------------------|:----------|:----------|:----------------------------------------------------------------------------------------------------------------|
| 80, 443                                                                                                                            | tcp       | sortant   | Gestion T-Pot : Installation, mises à jour, logs (p. ex. OS, GitHub, DockerHub, Sicherheitstacho, etc.)         |
| 11434                                                                                                                              | tcp       | sortant   | Honeypots basés sur LLM : Accès à votre installation Ollama                                                     |
| 64294                                                                                                                              | tcp       | entrant   | Gestion T-Pot : Transmission des données des capteurs vers la ruche (via proxy inverse NGINX) vers 127.0.0.1:64305 |
| 64295                                                                                                                              | tcp       | entrant   | Gestion T-Pot : Accès SSH                                                                                      |
| 64297                                                                                                                              | tcp       | entrant   | Gestion T-Pot : Accès au proxy inverse NGINX                                                                    |
| 5555                                                                                                                               | tcp       | entrant   | Honeypot : ADBHoney                                                                                            |
| 22                                                                                                                                 | tcp       | entrant   | Honeypot : Beelzebub (LLM requis)                                                                               |
| 5000                                                                                                                               | udp       | entrant   | Honeypot : CiscoASA                                                                                            |
| 8443                                                                                                                               | tcp       | entrant   | Honeypot : CiscoASA                                                                                            |
| 443                                                                                                                                | tcp       | entrant   | Honeypot : CitrixHoneypot                                                                                      |
| 80, 102, 502, 1025, 2404, 10001, 44818, 47808, 50100                                                                               | tcp       | entrant   | Honeypot : Conpot                                                                                              |
| 161, 623                                                                                                                           | udp       | entrant   | Honeypot : Conpot                                                                                              |
| 22, 23                                                                                                                             | tcp       | entrant   | Honeypot : Cowrie                                                                                              |
| 19, 53, 123, 1900                                                                                                                  | udp       | entrant   | Honeypot : Ddospot                                                                                             |
| 11112                                                                                                                              | tcp       | entrant   | Honeypot : Dicompot                                                                                            |
| 21, 42, 135, 443, 445, 1433, 1723, 1883, 3306, 8081                                                                                | tcp       | entrant   | Honeypot : Dionaea                                                                                             |
| 69                                                                                                                                 | udp       | entrant   | Honeypot : Dionaea                                                                                             |
| 9200                                                                                                                               | tcp       | entrant   | Honeypot : Elasticpot                                                                                          |
| 22                                                                                                                                 | tcp       | entrant   | Honeypot : Endlessh                                                                                            |
| 80, 443, 8080, 8443                                                                                                                | tcp       | entrant   | Honeypot : Galah (LLM requis)                                                                                  |
| 8080                                                                                                                               | tcp       | entrant   | Honeypot : Go-pot                                                                                              |
| 80, 443                                                                                                                            | tcp       | entrant   | Honeypot : H0neytr4p                                                                                           |
| 21, 22, 23, 25, 80, 110, 143, 443, 993, 995, 1080, 5432, 5900                                                                      | tcp       | entrant   | Honeypot : Heralding                                                                                           |
| 3000                                                                                                                               | tcp       | entrant   | Honeypot : Honeyaml                                                                                            |
| 21, 22, 23, 25, 80, 110, 143, 389, 443, 445, 631, 1080, 1433, 1521, 3306, 3389, 5060, 5432, 5900, 6379, 6667, 8080, 9100, 9200, 11211 | tcp       | entrant   | Honeypot : qHoneypots                                                                                          |
| 53, 123, 161, 5060                                                                                                                 | udp       | entrant   | Honeypot : qHoneypots                                                                                          |
| 631                                                                                                                                | tcp       | entrant   | Honeypot : IPPHoney                                                                                            |
| 80, 443, 8080, 9200, 25565                                                                                                         | tcp       | entrant   | Honeypot : Log4Pot                                                                                             |
| 25                                                                                                                                 | tcp       | entrant   | Honeypot : Mailoney                                                                                            |
| 2575                                                                                                                               | tcp       | entrant   | Honeypot : Medpot                                                                                              |
| 9100                                                                                                                               | tcp       | entrant   | Honeypot : Miniprint                                                                                           |
| 6379                                                                                                                               | tcp       | entrant   | Honeypot : Redishoneypot                                                                                       |
| 3389                                                                                                                               | tcp       | entrant   | Honeypot : RDPHoneypot                                                                                         |
| 5060                                                                                                                               | tcp/udp   | entrant   | Honeypot : SentryPeer                                                                                          |
| 80                                                                                                                                 | tcp       | entrant   | Honeypot : Snare (Tanner)                                                                                      |
| 8090                                                                                                                               | tcp       | entrant   | Honeypot : Wordpot                                                                                             |

Les ports et la disponibilité des services SaaS peuvent varier en fonction de votre situation géographique.

Pour que certains honeypots atteignent leur pleine fonctionnalité (par exemple Cowrie ou Log4Pot), des connexions sortantes sont également nécessaires, afin qu'ils puissent télécharger les logiciels malveillants de l'attaquant. Veuillez consulter la documentation de chaque honeypot pour en savoir plus en suivant les [liens](#technical-concept) vers leurs dépôts.

## Honeypots basés sur LLM
Nous pensons que les honeypots basés sur LLM marquent le **début** d'un changement de paradigme dans le domaine de la tromperie / des honeypots. Par conséquent, à partir de la version **T-Pot 24.04.1**, deux honeypots basés sur LLM, **Beelzebub** et **Galah**, ont été introduits. Ces honeypots nécessitent une installation d'**Ollama**, qui doit être configurée dans le [fichier de configuration de T-Pot](#t-pot-config-file). Vous pouvez également ajuster les paramètres de ce fichier pour la prise en charge de **ChatGPT**, mais notez que des modifications seront également nécessaires dans le fichier docker compose (`~/tpotce/compose/llm.yml`) pour tenir compte de ces ajustements.<br><br>
Suivez les liens dans la section [Honeypots et outils](#honeypots-and-tools) pour en savoir plus sur **Beelzebub** et **Galah**.

### Ollama
🚨 **L'utilisation basée sur CPU n'est pas recommandée**, même pour les tests.<br><br>
Pour installer et exécuter **Ollama**, reportez-vous au [dépôt GitHub d'Ollama](https://github.com/ollama/ollama) pour les instructions. Pour une utilisation débutante ou de test, des résultats peuvent être obtenus avec une **Nvidia RTX 4060 Ti 16GB** ou équivalent (AMD ROCm est également pris en charge par Ollama), avec des modèles comme **openchat** et **Llama3**. En règle générale avec les systèmes basés sur LLM, plus le matériel est performant et abondant, plus les résultats seront rapides et précis, surtout lorsque les tâches sont déléguées à plusieurs GPU et à des modèles plus grands.

### ChatGPT
La prise en charge de ChatGPT pour ces honeypots restera non testée en relation avec T-Pot.
<br><br>

# Placement du système
Il est recommandé de vous familiariser avec le fonctionnement de T-Pot et des honeypots avant de commencer à exposer vers Internet. Pour un démarrage rapide, exécutez une installation de T-Pot dans une machine virtuelle.
<br><br>
Une fois que vous êtes familier avec le fonctionnement, vous devez choisir un réseau où vous soupçonnez la présence d'intrus ou d'où ils pourraient venir (par exemple Internet). Sinon, T-Pot ne capturera très probablement aucune attaque (à moins que vous ne vouliez prouver un point) ! Pour commencer, il est recommandé de placer T-Pot dans une zone non filtrée, où tout le trafic TCP et UDP est redirigé vers l'interface réseau de T-Pot. Pour éviter le sondage des ports de gestion de T-Pot, vous devez placer T-Pot derrière un pare-feu et rediriger tout le trafic TCP / UDP dans la plage de ports 1-64000 vers T-Pot, tout en autorisant l'accès aux ports > 64000 uniquement depuis des adresses IP de confiance et / ou en exposant uniquement les [ports](#required-ports) pertinents pour votre cas d'utilisation. Si vous souhaitez capturer le trafic de logiciels malveillants sur des ports inconnus, vous ne devez pas limiter les ports que vous redirigez, car glutton et honeytrap lient dynamiquement tout port TCP non occupé par d'autres démons honeypot, vous donnant ainsi une meilleure représentation des risques auxquels votre configuration est exposée.
<br><br>

# Installation
[Téléchargez](#choose-your-distro) l'une des [images de distribution Linux prises en charge](#choose-your-distro), suivez les instructions [TL;DR](#tldr) ou `git clone` le dépôt T-Pot et exécutez le programme d'installation `~/tpotce/install.sh`. Exécuter T-Pot sur un système Linux déjà en fonctionnement et pris en charge est possible, mais une installation propre est recommandée pour éviter les conflits de ports avec les services en cours d'exécution. Le programme d'installation de T-Pot nécessitera un accès direct à Internet comme décrit [ici](#required-ports).
<br><br>

## Choisissez votre distribution
**Étapes à suivre :**

1. Téléchargez une distribution Linux prise en charge depuis la liste ci-dessous. (REMARQUE : Red Hat Enterprise Linux >= 8 est pris en charge, mais omis de la liste ci-dessous en raison de sa nature basée sur un abonnement. Voir [Red Hat Enterprise Linux](#red-hat-enterprise-linux) pour plus de détails).
2. Pendant l'installation, choisissez une version **minimale**, **netinstall** ou **serveur** qui n'installera que les paquets essentiels.
3. **N'installez jamais** un environnement de bureau graphique tel que Gnome ou KDE. T-Pot échouera à fonctionner avec en raison de conflits de ports.
4. Assurez-vous d'installer SSH afin de pouvoir vous connecter à la machine à distance.

| Nom de la distribution                                                                 | x64                                                                                                                                   | arm64                                                                                                                                   |
|:---------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------|
| [Alma Linux OS 9.x Minimal ISO](https://almalinux.org)                                | [download](https://repo.almalinux.org/almalinux/9/isos/x86_64/AlmaLinux-9.8-x86_64-minimal.iso)                                        | [download](https://repo.almalinux.org/almalinux/9/isos/aarch64/AlmaLinux-9.8-aarch64-minimal.iso)                                        |
| [Debian 13 Network Install](https://www.debian.org/CD/netinst/index.en.html)       | [download](https://cdimage.debian.org/debian-cd/current/amd64/iso-cd/debian-13.5.0-amd64-netinst.iso)                                 | [download](https://cdimage.debian.org/debian-cd/current/arm64/iso-cd/debian-13.5.0-arm64-netinst.iso)                                   |
| [Fedora Server 42 Network Install](https://fedoraproject.org/server/download)      | [download](https://download.fedoraproject.org/pub/fedora/linux/releases/42/Server/x86_64/iso/Fedora-Server-netinst-x86_64-42-1.1.iso) | [download](https://download.fedoraproject.org/pub/fedora/linux/releases/42/Server/aarch64/iso/Fedora-Server-netinst-aarch64-42-1.1.iso) |
| [OpenSuse Tumbleweed Network Image](https://get.opensuse.org/tumbleweed/#download) | [download](https://download.opensuse.org/tumbleweed/iso/openSUSE-Tumbleweed-NET-x86_64-Current.iso)                                   | [download](https://download.opensuse.org/ports/aarch64/tumbleweed/iso/openSUSE-Tumbleweed-NET-aarch64-Current.iso)                      |
| [Rocky Linux OS 9.x Minimal ISO](https://rockylinux.org/download)                     | [download](https://download.rockylinux.org/pub/rocky/9/isos/x86_64/Rocky-9.8-x86_64-minimal.iso)                                      | [download](https://download.rockylinux.org/pub/rocky/9/isos/aarch64/Rocky-9.8-aarch64-minimal.iso)                                      |
| [Ubuntu 24.04.x Live Server](https://ubuntu.com/download/server)                   | [download](https://releases.ubuntu.com/24.04/ubuntu-24.04.3-live-server-amd64.iso)                                                    | [download](https://cdimage.ubuntu.com/releases/24.04/release/ubuntu-24.04.3-live-server-arm64.iso)                                      |

<br>

## Prise en charge du Raspberry Pi 4 (8 Go)
| Nom de la distribution                                                | arm64                                                                                                                                               |
|:----------------------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------|
| [Raspberry Pi OS (**64Bit, Lite**)](https://www.raspberrypi.com) | [download](https://downloads.raspberrypi.com/raspios_lite_arm64/images/raspios_lite_arm64-2024-03-15/2024-03-15-raspios-bookworm-arm64-lite.img.xz) |

<br><br> 
## Obtenir et installer T-Pot
1. Clonez le dépôt GitHub : `$ git clone https://github.com/telekom-security/tpotce` ou suivez le [TL;DR](#tldr) et sautez cette section.
2. Placez-vous dans le dossier **tpotce/** : `$ cd tpotce`
3. Exécutez le programme d'installation en tant que non-root : `$ ./install.sh` :
   * ⚠️ ***Selon la distribution Linux que vous avez choisie, le programme d'installation :***
     * Modifiera le port SSH en `tcp/64295`
     * Désactivera le DNS Stub Listener pour éviter les conflits de ports avec les honeypots
     * Configurera SELinux en mode surveillance
     * Définira la cible du pare-feu pour la zone publique sur ACCEPT
     * Ajoutera le dépôt Docker et installera Docker
     * Installera les paquets recommandés
     * Supprimera les paquets connus pour causer des problèmes
     * Ajoutera l'utilisateur actuel au groupe docker (permettant l'interaction avec docker sans `sudo`)
     * Ajoutera les alias `dps`, `dpsw` et `dim` pour des aperçus formatés des conteneurs et images
     * Ajoutera les alias `la`, `ll` et `ls` (pour `exa`, une commande `ls` améliorée)
     * Ajoutera `mi` (pour `micro`, une excellente alternative à `vi` et/ou `nano`)
     * Affichera les ports ouverts sur l'hôte (comparer avec les ports [requis](https://github.com/telekom-security/tpotce#required-ports) de T-Pot)
     * Ajoutera et activera `tpot.service` dans `/etc/systemd/system` afin que T-Pot puisse démarrer et s'arrêter automatiquement
4. Suivez les instructions du programme d'installation, vous devrez entrer votre mot de passe utilisateur (`sudo` ou `root`) au moins une fois
5. Vérifiez les messages du programme d'installation pour les erreurs et les ports ouverts qui pourraient causer des conflits
6. Redémarrez : `$ sudo reboot`
<br><br>## macOS & Windows
Il est parfois agréable de pouvoir lancer une instance T-Pot sur macOS ou Windows, par exemple pour le développement, les tests ou simplement pour le plaisir. Comme Docker Desktop est assez limité, tous les types de honeypots ou fonctionnalités de T-Pot ne sont pas pris en charge. Rappelez-vous également que, par défaut, le pare-feu de macOS et Windows bloque l'accès à distance, de sorte que les tests sont limités à l'hôte. Pour la production, il est recommandé d'exécuter T-Pot sur [Linux](#choose-your-distro).<br>
Pour mettre en place et faire fonctionner le tout, suivez simplement ces étapes :
1. Installez Docker Desktop pour [macOS](https://docs.docker.com/desktop/setup/install/mac-install/) ou [Windows](https://docs.docker.com/desktop/setup/install/windows-install/).
2. Clonez le dépôt GitHub : `git clone https://github.com/telekom-security/tpotce` (sous Windows, assurez-vous que le code est extrait avec `LF` au lieu de `CRLF` !)
3. Allez dans : `cd ~/tpotce`
4. Copiez `cp compose/mac_win.yml ./docker-compose.yml`
5. Créez un `WEB_USER` en exécutant `~/tpotce/genuser.sh` (macOS) ou `~/tpotce/genuserwin.ps1` (Windows)
6. Ajustez le fichier `.env` en changeant `TPOT_OSTYPE=linux` en `mac` ou `win` :   ```
   # OSType (linux, mac, win)
   #  Most docker features are available on linux
   TPOT_OSTYPE=mac