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"]