Aller au contenu

CORS

Une origine identifie l'adresse d'une application dans le navigateur : protocole, nom d'hôte et port. https://smartagt.example.test:9000 et https://smartagt.example.test sont deux origines différentes. En HTTPS, un port absent désigne 443.

Le Frontend service contrôle les origines des requêtes du navigateur. La même liste protège notamment la connexion et la déconnexion : une origine non admise peut provoquer un refus 403, même si la page s'affiche et que son certificat est valide.

Configuration du Frontend

Dans /app/config/bff/smartagt-bff-core.yaml, ou C:\app\config\bff\smartagt-bff-core.yaml sous Windows, fusionnez ce fragment avec le bloc smartagt existant. Le bloc http se place sous smartagt, au même niveau que core : mal placé, il est ignoré sans erreur.

smartagt:
  http:
    cors:
      allow_origins:
        - "https://smartagt.example.test:9000"

Remplacez l'exemple par l'origine visible dans la barre d'adresse des utilisateurs. Plusieurs origines se déclarent sur des lignes distinctes. Redémarrez ensuite le Frontend service : Exploitation.

Situation Origine à déclarer
Accès direct au Frontend sur 9000 https://smartagt.example.test:9000
Reverse proxy public sur 443, Frontend interne sur 9000 https://smartagt.example.test
Autre nom d'accès utilisé par les utilisateurs Son origine exacte, en plus des autres accès conservés

Une entrée contient uniquement le protocole, le nom d'hôte et, si nécessaire, le port : aucun chemin, paramètre ou fragment. N'utilisez ni *, ni joker de sous-domaine, ni l'adresse d'écoute 0.0.0.0. Les méthodes, les en-têtes et la prise en charge des cookies sont définis par SmartAGT ; seul allow_origins se configure ici.

L'origine de l'URL publique de l'installation est aussi admise automatiquement. Le YAML ajoute des origines à celle-ci ; retirer une entrée du YAML ne révoque donc pas l'origine de l'URL publique. Un changement d'adresse publique se déclare dans Plateforme > Général, champ URL publique de la plateforme.

Si le SSO est utilisé

Le Backend contrôle lui aussi l'origine du Frontend pour le SSO. L'origine de l'URL publique est admise automatiquement ; pour une adresse supplémentaire, ajoutez-la dans le YAML du Backend, puis redémarrez l'API :

smartagt:
  iam:
    oidc:
      frontend_allowed_origins:
        - "https://smartagt.example.test:9000"

Conservez les origines encore utilisées. Si l'adresse publique change, adaptez aussi les URL de retour déclarées auprès du fournisseur d'identité. Le réglage CORS du Frontend et la liste SSO du Backend ont chacun leur rôle : modifier l'un ne modifie pas l'autre.

Vérification

Ouvrez le Frontend par l'adresse déclarée, connectez-vous, rechargez la page puis déconnectez-vous. Si une action est refusée, comparez l'en-tête Origin de la requête dans les outils réseau du navigateur avec les origines admises : la réponse refusée porte le motif origin_refused. Le journal du Frontend service écrit chaque refus en WARNING, au plus 10 par minute et par motif puis une ligne de synthèse, par exemple Refus (POST /auth/login) : 403, origin_refused. Le motif précise la cause : origin_refused pour une origine absente de la liste, origin_missing sans en-tête Origin, origin_multiple pour plusieurs en-têtes Origin, origin_malformed pour un en-tête illisible. La première fois dans l'heure, le journal nomme aussi l'origine refusée. Au démarrage, il liste les origines lues dans le YAML, après origines YAML=.

Un défaut de confiance du certificat se corrige avec Installer vos certificats. Un changement du port d'écoute se prépare avec Changer les ports.