Page de connexion
Fonctionnalité déployée et prise en charge. Les champs et commandes décrits ici sont stables au sein de la version v1alpha1.
Vos utilisateurs se connectent sur une page aux couleurs de votre organisation : logo, couleurs, thème, titre, liens vers vos conditions d'utilisation. Elle se règle une fois pour tout votre tenant, depuis la section Authentification → Page de connexion de la console, avec un aperçu en direct, ou avec sng iam login-page.
La personnalisation se fait par jetons : des valeurs typées (couleur, adresse HTTPS, choix dans une liste). Il n'y a ni CSS ni HTML libres, ce qui garde la page de connexion sûre ; la lisibilité est garantie (les couleurs de texte sont calculées pour rester contrastées).
Prérequis
- Une session sur le tenant :
sng tenant use acme. auth:ManageLoginPagepour modifier (policyreadwriteouadmin) ;auth:ListUserssuffit pour lire.
Les réglages
| Réglage | Valeurs | Défaut |
|---|---|---|
logoURL, logoDarkURL | adresse https:// d'une image PNG, WebP ou JPEG | logo StackNGO |
faviconURL | adresse https:// | icône StackNGO |
primaryColor, accentColor | #rrggbb | thème StackNGO |
backgroundColor | #rrggbb | fond du thème |
backgroundImageURL | adresse https:// | aucune |
theme | light, dark, auto | auto |
radius | none, sm, md, lg (arrondi des boutons) | md |
layout | centered ou split (image à gauche, formulaire à droite) | centered |
fontFamily | stackngo, inter, system | stackngo |
title, subtitle | texte brut par langue (fr, en), 200 caractères au plus | « Connexion à … » |
links.terms, links.privacy | adresses https:// | aucun |
supportEmail | adresse e-mail | aucune |
showPoweredBy | true ou false | true |
users.signup | invite ou open | invite |
Un champ laissé vide reprend la valeur par défaut. Les images SVG ne sont pas acceptées.
Étapes
1. Voir l'état actuel
sng iam login-page show
Sans réglage enregistré, la commande affiche la page par défaut avec l'inscription invite.
2. Modifier
sng iam login-page set --logo-url https://acme.example/logo.png --primary-color "#0a7cff" --signup invite
La commande couvre le logo, la couleur principale et la politique d'inscription ; la console donne accès à tous les réglages ci-dessus. Les champs refusés (couleur mal formée, adresse non HTTPS, contraste insuffisant) sont signalés un par un, rien n'est enregistré tant que l'un d'eux est refusé.
3. Contrôler l'aperçu
Dans la console, la page affiche un aperçu qui suit vos modifications avant l'enregistrement.
Propagation
Après l'enregistrement, la page de connexion change en quelques minutes. En attendant, sng iam login-page show distingue les réglages enregistrés de ceux déjà appliqués.
Inscription sur invitation ou ouverte
users.signup | Effet |
|---|---|
invite | seules les personnes invitées créent un compte |
open | toute personne qui se connecte avec un moyen de connexion activé crée son compte |
Passer à open n'a de sens que si vous acceptez que n'importe quel titulaire d'un compte Google, GitHub… (selon les moyens activés) puisse entrer : votre application reste libre de refuser les comptes sans rôle.
Vérification
sng iam login-page show
Ouvrez ensuite la page de connexion depuis votre application (flux authorization_code, voir Authentification de vos applications) : logo et couleurs apparaissent.
Limites
- Les réglages valent pour toutes les applications de votre annuaire.
- Seules les modifications faites depuis le cluster principal de votre tenant sont acceptées (sinon la commande répond
409). - Votre tenant doit avoir un annuaire activé (sinon
404).