Reproduire le lab au travail (K8s + IdP)

À garder identique

Ce qui ne change pas

Concept	Valeur du lab	Au travail
Protocole MCP	ORDS standalone `/mcp`	Identique (pas de Tomcat pour MCP)
Validation JWT	iss, aud, JWKS	Issuer d’entreprise + JWKS
Claim des rôles	`roles2` (ou nom sûr)	Mapper des groupes → mêmes chaînes, ou changer le pointeur ORDS
Chaînes de rôle	`POOL.HR`, `POOL.FIN`	Rôles / groupes applicatifs stables
Scope MCP global	`urn:oracle:dbtools:ords:mcpserver:all`	Même chaîne sur l’API / le scope
Liaison pool	`mcp.role` + `mcp.scope` par pool	Un pool par vraie base de données
Client	OpenCode OAuth PKCE	OpenCode ou autre client MCP avec OAuth

À faire changer

Ce qui doit changer

Lab	Travail
API Identifier / URL MCP `http://127.0.0.1:8080/mcp`	URL publique HTTPS, ex. `https://ords-mcp.company.com/mcp` (hôte dédié ; ne pas retirer `/ords` — voir reverse proxy)
Tenant Auth0 gratuit	Entra ID / Okta / Auth0 Enterprise
Un Oracle Free, deux schémas	N bases ; un pool MCP par base
Docker Compose	Deployment + Ingress + Secrets + NetworkPolicy
Mots de passe d’exemple dans `.env`	Vault / External Secrets

⚠️ Règle qui reste absolue L’API Identifier (audience) IdP = l’URL MCP exacte utilisée par le client (schéma et chemin compris), parce que les clients envoient OAuth resource= égal à cette URL. MCP est à /mcp sur l’hôte ORDS, pas sous /ords. Un mapping https://my-proxy/ords/ → http://ords fait annoncer à ORDS https://my-proxy/mcp.

Déploiement suggéré

Feuille de route

POC (ce lab) — OpenCode + Auth0 + isolation par rôle prouvée.
ORDS en staging — Ingress HTTPS ; API Identifier = URL publique du MCP ; même modèle roles2 + permissions.
Bascule IdP — pointer le profil JWT ORDS vers l’issuer/JWKS d’entreprise ; mapper les groupes vers POOL.* (ou renommer pools/rôles de façon cohérente).
Catalogue de pools — table GitOps : nom du pool, connexion DB, mcp.role, équipe propriétaire.
Durcissement — utilisateurs DB en lecture seule, réplicas, NetworkPolicy, audit (DBTOOLS$MCP_LOG, module/action de session), jetons de courte durée.

Réglages ORDS à exporter

Depuis scripts/configure-mcp.sh / config courante :

feature.mcp = true
mcp.security.jwt.profile.issuer
mcp.security.jwt.profile.audience          # = URL publique du MCP
mcp.security.jwt.profile.jwk.url
mcp.security.jwt.profile.authorization.server.url
mcp.security.jwt.profile.role.claim.name   # /roles2 ou pointeur du claim entreprise
# par pool :
db.hostname, db.port, db.servicename, db.username
mcp.role, mcp.scope
db.password (wallet / secret)

Mapping IdP

Notes de correspondance

Auth0 (lab)	Exemple entreprise
Rôle `POOL.FIN`	Rôle d’application ou groupe `POOL.FIN`
Claim `roles2`	Claim personnalisé (éviter les noms réservés par l’IdP)
Permission sur le rôle	Le rôle d’app inclut le scope/permission de l’API MCP
App Native + PKCE	Client public pour les postes des développeurs
Action post-login	Entra : optional claims / token configuration

OpenCode au bureau

Les callback URLs doivent inclure la redirection OpenCode (lab : http://127.0.0.1:19876/mcp/oauth/callback).
Le Conditional Access / la conformité d’appareil de l’entreprise peuvent s’appliquer à l’app Auth0/Entra.
Préférer des apps Auth0/Entra séparées : interactive (Native) vs automatisation (M2M).

Socle de sécurité

Baseline

Utilisateurs DB de pool en moindre privilège, idéalement lecture seule
Préférer des réplicas / environnements non-prod pour le SQL d’IA
TLS partout dans les environnements partagés
Audience verrouillée sur l’URL MCP
Auditer le SQL MCP et les sessions
Séparer le processus ORDS du Tomcat REST/APEX classique s’ils coexistent
Pas de mots de passe DB de longue durée sur les portables

Matrice de validation

Tests à réutiliser

Test	Résultat attendu
Utilisateur avec POOL.FIN seulement	`database_list` = pool fin uniquement
Utilisateur avec POOL.HR seulement	pool hr uniquement
Utilisateur avec les deux	les deux pools
Jeton sans permission MCP	403 / client en `needs_auth`
Jeton sans claim de rôle	401 Missing Role Claim
Mauvaise audience	401

Passer à l’image de production →