From 876200885ed6fc3ee34b970ad2653a2ec1886d2f Mon Sep 17 00:00:00 2001 From: Mandrak-Kimigo Date: Thu, 5 Nov 2026 20:56:35 +0100 Subject: [PATCH] build: passe l'image sur Docker Hardened Images (Python 3.14) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit L'image de base devient dhi.io/python:3.14-debian13 pour réduire la surface d'attaque (pas de shell ni de gestionnaire de paquets au runtime, quasi aucune CVE, SBOM et provenance signés) et diviser la taille de l'image par deux (196 Mo contre 469 Mo). - Dockerfile en deux stages : dépendances installées avec uv dans la variante -dev, seul le venv est copié dans l'image runtime. L'utilisateur nonroot (uid 65532) de DHI remplace l'utilisateur 10001 créé à la main ; les certificats CA sont fournis par l'image. - CI GitHub et GitLab : login sur dhi.io avec DOCKERHUB_USERNAME / DOCKERHUB_TOKEN (pull authentifié obligatoire), en plus du registre de publication. - Job ruff GitLab aligné sur Python 3.14. - CONTRIBUTING : docker login dhi.io requis pour builder en local ; section Sécurité corrigée (HTTP_VERIFY_TLS vaut true par défaut) ; ligne vide avant une liste (MD032). Testé en local : build, démarrage, login Keycloak complet. Signed-off-by: Mandrak-Kimigo --- .github/workflows/build-image.yml | 8 ++++++ .gitlab-ci.yml | 8 ++++-- CONTRIBUTING.md | 5 ++-- Dockerfile | 42 ++++++++++++++++++------------- 4 files changed, 42 insertions(+), 21 deletions(-) diff --git a/.github/workflows/build-image.yml b/.github/workflows/build-image.yml index da3cc15..8b4dd5c 100644 --- a/.github/workflows/build-image.yml +++ b/.github/workflows/build-image.yml @@ -32,6 +32,14 @@ jobs: - name: Set up Docker Buildx uses: docker/setup-buildx-action@v4 + # Images de base Docker Hardened Images (dhi.io) : pull authentifie Docker Hub. + - name: Login to DHI + uses: docker/login-action@v4 + with: + registry: dhi.io + username: ${{ secrets.DOCKERHUB_USERNAME }} + password: ${{ secrets.DOCKERHUB_TOKEN }} + - name: Login to GHCR uses: docker/login-action@v4 with: diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml index 1409259..64139b0 100644 --- a/.gitlab-ci.yml +++ b/.gitlab-ci.yml @@ -14,7 +14,7 @@ stages: ruff: stage: lint - image: python:3.12-slim + image: python:3.14-slim rules: - if: '$CI_PIPELINE_SOURCE == "merge_request_event" && $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "main"' before_script: @@ -53,6 +53,10 @@ build-image: rules: - if: '$CI_COMMIT_TAG =~ /^v/' script: - - echo "{\"auths\":{\"$CI_REGISTRY\":{\"auth\":\"$(printf "%s:%s" "$CI_REGISTRY_USER" "$CI_REGISTRY_PASSWORD" | base64 | tr -d '\n')\"}}}" > /kaniko/.docker/config.json + # Deux registres : celui de GitLab (push) et dhi.io (pull des images de base DHI, + # variables CI/CD masquees DOCKERHUB_USERNAME / DOCKERHUB_TOKEN). + - CI_AUTH=$(printf "%s:%s" "$CI_REGISTRY_USER" "$CI_REGISTRY_PASSWORD" | base64 | tr -d '\n') + - DHI_AUTH=$(printf "%s:%s" "$DOCKERHUB_USERNAME" "$DOCKERHUB_TOKEN" | base64 | tr -d '\n') + - echo "{\"auths\":{\"$CI_REGISTRY\":{\"auth\":\"$CI_AUTH\"},\"dhi.io\":{\"auth\":\"$DHI_AUTH\"}}}" > /kaniko/.docker/config.json - IMAGE=$(echo "$CI_REGISTRY_IMAGE" | tr '[:upper:]' '[:lower:]') - /kaniko/executor --context "$CI_PROJECT_DIR" --dockerfile "$CI_PROJECT_DIR/Dockerfile" --destination "${IMAGE}:${CI_COMMIT_TAG}" --destination "${IMAGE}:latest" diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 6140c80..1c0957c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -6,7 +6,7 @@ Merci de vouloir contribuer ! Ce document résume comment mettre en place l'envi - Python 3.12+ - [uv](https://docs.astral.sh/uv/) pour la gestion des dépendances -- Docker (optionnel, pour tester l'image ou builder en local) +- Docker (optionnel, pour tester l'image ou builder en local) — l'image part des [Docker Hardened Images](https://docs.docker.com/dhi/) : faire `docker login dhi.io` avec un compte Docker Hub avant le premier `docker build`, sinon le pull des images de base échoue en `unauthorized` - Un realm Keycloak accessible (local ou distant) pour tester le standard flow de bout en bout ## Mettre en place l'environnement local @@ -45,6 +45,7 @@ uv run ruff check . # lint La CI refuse la fusion si l'un des deux échoue. Pour un fix automatique des problèmes sûrs : `uv run ruff check --fix .`. Conventions générales du projet : + - Pas de commentaire pour expliquer *ce que* fait le code (les noms doivent suffire) — seulement le *pourquoi* quand c'est non évident (contrainte cachée, contournement, comportement surprenant). - Pas d'abstraction ou de configuration ajoutée pour un besoin hypothétique : on code ce dont on a besoin maintenant. - Toute variable de configuration fonctionnelle passe par `app/config.py` (`Settings`), pas de valeur en dur éparpillée dans le code. @@ -68,7 +69,7 @@ Si vous ajoutez un comportement difficile à valider manuellement (ex. un cas d' ## Sécurité -`tokenlab` est un outil de debug : il affiche des tokens complets et désactive volontairement certaines vérifications (`HTTP_VERIFY_TLS=false` figé au build de l'image via le `Dockerfile`, décodage JWT non vérifié). Toute contribution touchant à ces zones doit préserver le fait que ces comportements restent **explicites et opt-in**, jamais un défaut silencieux — et pour `HTTP_VERIFY_TLS`, jamais surchargeable au déploiement. +`tokenlab` est un outil de debug : il affiche des tokens complets, décode les JWT sans vérifier leur signature, et permet de désactiver la vérification TLS (`HTTP_VERIFY_TLS`, à `true` par défaut et figé au build de l'image via le `Dockerfile` : ne le passer à `false` que pour une image de dev face à un certificat auto-signé). Toute contribution touchant à ces zones doit préserver le fait que ces comportements restent **explicites et opt-in**, jamais un défaut silencieux — et pour `HTTP_VERIFY_TLS`, jamais surchargeable au déploiement. Pour signaler une vulnérabilité, ouvrir une issue privée ou contacter directement le mainteneur plutôt qu'une issue publique. diff --git a/Dockerfile b/Dockerfile index a64bbf5..b00ebb3 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,17 +1,32 @@ -FROM python:3.12-slim AS base +# Images Docker Hardened Images (DHI) : pull authentifie avec un compte Docker Hub +# (docker login dhi.io). -RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates \ - && update-ca-certificates \ - && rm -rf /var/lib/apt/lists/* +# --- Stage de build : variante -dev (shell, apt) pour installer les dependances --- +FROM dhi.io/python:3.14-debian13-dev AS build # Binaire uv officiel (image distroless dediee), pas d'installation via pip necessaire. -COPY --from=ghcr.io/astral-sh/uv:0.12.13 /uv /uvx /usr/local/bin/ +COPY --from=ghcr.io/astral-sh/uv:0.12.13 /uv /usr/local/bin/ -ENV PYTHONDONTWRITEBYTECODE=1 \ - PYTHONUNBUFFERED=1 \ - UV_LINK_MODE=copy \ +# UV_PYTHON_DOWNLOADS=never : le venv doit utiliser le Python de l'image (meme chemin +# dans le stage runtime), jamais un Python telecharge par uv. +ENV UV_LINK_MODE=copy \ + UV_COMPILE_BYTECODE=1 \ + UV_PYTHON_DOWNLOADS=never \ UV_PROJECT_ENVIRONMENT=/app/.venv +WORKDIR /app + +# Couche dependances seule, pour beneficier du cache Docker tant que pyproject/uv.lock ne changent pas. +COPY pyproject.toml uv.lock ./ +RUN uv sync --frozen --no-dev + +# --- Stage runtime : image minimale, sans shell ni gestionnaire de paquets --- +# Certificats CA inclus, utilisateur non-root (nonroot, uid 65532) par defaut. +FROM dhi.io/python:3.14-debian13 AS runtime + +ENV PYTHONDONTWRITEBYTECODE=1 \ + PYTHONUNBUFFERED=1 + # Verification TLS des appels HTTP vers Keycloak, figee au build de l'image (et non au # deploiement) : passer a "false" ici uniquement pour une image de dev face a un # certificat auto-signe, jamais en dehors de ce cas. Non surchargeable via .env/ConfigMap. @@ -19,17 +34,10 @@ ENV HTTP_VERIFY_TLS=true WORKDIR /app -# Couche dependances seule, pour beneficier du cache Docker tant que pyproject/uv.lock ne changent pas. -COPY pyproject.toml uv.lock ./ -RUN uv sync --frozen --no-dev - +# Fichiers en lecture seule pour l'utilisateur d'execution (proprietaire root). +COPY --from=build /app/.venv /app/.venv COPY app ./app -RUN addgroup --system --gid 10001 tokenlab \ - && adduser --system --uid 10001 --ingroup tokenlab tokenlab \ - && chown -R tokenlab:tokenlab /app -USER 10001 - EXPOSE 8080 CMD ["/app/.venv/bin/uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8080"]