# abdssamiaglagal8-star/projet-keycloak architecture

> Architecture diagram of the GitHub repository abdssamiaglagal8-star/projet-keycloak, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abdssamiaglagal8-star/projet-keycloak
- Repository: https://github.com/abdssamiaglagal8-star/projet-keycloak

## Overview

This repository provides a Keycloak authentication extension: the main workflow is an authentication flow presenting an email OTP challenge, sending a code, and accepting or rejecting the submitted code. It also includes a separate Cloudflare Turnstile CAPTCHA authenticator. The sampled source shows both authenticators and their factories; the README documents a separate theme, but its files are absent from the tree. The deployment README focuses on email OTP, so the Turnstile branch is based on sampled source rather than that README.

Main entry points: [`keycloak-security-extension/src/main/java/ma/s2m/itsp/security/EmailOtpAuthenticator.java`](https://github.com/abdssamiaglagal8-star/projet-keycloak/blob/socle/keycloak-security-extension/src/main/java/ma/s2m/itsp/security/EmailOtpAuthenticator.java) (OTP Authenticator), [`keycloak-security-extension/src/main/java/ma/s2m/itsp/security/TurnstileAuthenticator.java`](https://github.com/abdssamiaglagal8-star/projet-keycloak/blob/socle/keycloak-security-extension/src/main/java/ma/s2m/itsp/security/TurnstileAuthenticator.java) (CAPTCHA Authenticator), [`keycloak-security-extension/src/main/java/ma/s2m/itsp/security/EmailOtpAuthenticatorFactory.java`](https://github.com/abdssamiaglagal8-star/projet-keycloak/blob/socle/keycloak-security-extension/src/main/java/ma/s2m/itsp/security/EmailOtpAuthenticatorFactory.java) (OTP Factory), [`keycloak-security-extension/src/main/java/ma/s2m/itsp/security/TurnstileAuthenticatorFactory.java`](https://github.com/abdssamiaglagal8-star/projet-keycloak/blob/socle/keycloak-security-extension/src/main/java/ma/s2m/itsp/security/TurnstileAuthenticatorFactory.java) (CAPTCHA Factory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_otp["Email OTP"]
  node_email_auth["OTP Authenticator"]
  node_otp_theme["OTP Forms"]
  node_email_provider["Email Provider"]
end

subgraph group_captcha["Turnstile CAPTCHA"]
  node_turnstile_auth["CAPTCHA Authenticator"]
  node_cloudflare["Cloudflare Verify"]
end

subgraph group_extension["Provider Setup"]
  node_email_factory["OTP Factory"]
  node_turnstile_factory["CAPTCHA Factory"]
end

node_keycloak(("Keycloak Flow"))

node_email_factory -->|"creates"| node_email_auth
node_turnstile_factory -->|"creates"| node_turnstile_auth
node_keycloak -->|"runs"| node_email_auth
node_keycloak -.->|"runs"| node_turnstile_auth
node_email_auth -->|"sends code"| node_email_provider
node_email_auth -->|"renders form"| node_otp_theme
node_turnstile_auth -->|"verifies token"| node_cloudflare

click node_email_factory "https://github.com/abdssamiaglagal8-star/projet-keycloak/blob/socle/keycloak-security-extension/src/main/java/ma/s2m/itsp/security/EmailOtpAuthenticatorFactory.java"
click node_email_auth "https://github.com/abdssamiaglagal8-star/projet-keycloak/blob/socle/keycloak-security-extension/src/main/java/ma/s2m/itsp/security/EmailOtpAuthenticator.java"
click node_turnstile_factory "https://github.com/abdssamiaglagal8-star/projet-keycloak/blob/socle/keycloak-security-extension/src/main/java/ma/s2m/itsp/security/TurnstileAuthenticatorFactory.java"
click node_turnstile_auth "https://github.com/abdssamiaglagal8-star/projet-keycloak/blob/socle/keycloak-security-extension/src/main/java/ma/s2m/itsp/security/TurnstileAuthenticator.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_email_auth,node_otp_theme,node_email_provider toneBlue
class node_turnstile_auth,node_cloudflare toneAmber
class node_email_factory,node_turnstile_factory toneMint
class node_keycloak toneIndigo
```

## Components

### Email OTP

- [OTP Authenticator](https://github.com/abdssamiaglagal8-star/projet-keycloak/blob/socle/keycloak-security-extension/src/main/java/ma/s2m/itsp/security/EmailOtpAuthenticator.java): `keycloak-security-extension/src/main/java/ma/s2m/itsp/security/EmailOtpAuthenticator.java`
- **OTP Forms**
- **Email Provider**

### Turnstile CAPTCHA

- [CAPTCHA Authenticator](https://github.com/abdssamiaglagal8-star/projet-keycloak/blob/socle/keycloak-security-extension/src/main/java/ma/s2m/itsp/security/TurnstileAuthenticator.java): `keycloak-security-extension/src/main/java/ma/s2m/itsp/security/TurnstileAuthenticator.java`
- **Cloudflare Verify**

### Provider Setup

- [OTP Factory](https://github.com/abdssamiaglagal8-star/projet-keycloak/blob/socle/keycloak-security-extension/src/main/java/ma/s2m/itsp/security/EmailOtpAuthenticatorFactory.java): `keycloak-security-extension/src/main/java/ma/s2m/itsp/security/EmailOtpAuthenticatorFactory.java`
- [CAPTCHA Factory](https://github.com/abdssamiaglagal8-star/projet-keycloak/blob/socle/keycloak-security-extension/src/main/java/ma/s2m/itsp/security/TurnstileAuthenticatorFactory.java): `keycloak-security-extension/src/main/java/ma/s2m/itsp/security/TurnstileAuthenticatorFactory.java`

### Other components

- **Keycloak Flow**

## Connections

- OTP Factory → OTP Authenticator: creates (evidence: `keycloak-security-extension/src/main/java/ma/s2m/itsp/security/EmailOtpAuthenticatorFactory.java`)
- CAPTCHA Factory → CAPTCHA Authenticator: creates (evidence: `keycloak-security-extension/src/main/java/ma/s2m/itsp/security/TurnstileAuthenticatorFactory.java`)
- Keycloak Flow → OTP Authenticator: runs (evidence: `README.md`)
- Keycloak Flow → CAPTCHA Authenticator: runs
- OTP Authenticator → Email Provider: sends code (evidence: `keycloak-security-extension/src/main/java/ma/s2m/itsp/security/EmailOtpAuthenticator.java`)
- OTP Authenticator → OTP Forms: renders form (evidence: `keycloak-security-extension/src/main/java/ma/s2m/itsp/security/EmailOtpAuthenticator.java`)
- CAPTCHA Authenticator → Cloudflare Verify: verifies token (evidence: `keycloak-security-extension/src/main/java/ma/s2m/itsp/security/TurnstileAuthenticator.java`)
