Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions .github/workflows/build-image.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
8 changes: 6 additions & 2 deletions .gitlab-ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down Expand Up @@ -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"
5 changes: 3 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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.
Expand All @@ -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.

Expand Down
42 changes: 25 additions & 17 deletions Dockerfile
Original file line number Diff line number Diff line change
@@ -1,35 +1,43 @@
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.
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"]
Loading