Documentation

Gestion des templates pour le portail d’authentification

Lors d’une authentification de type HTML Form (cf : Authentification des utilisateurs) il est nécessaire d’utiliser un template d’authentification. Pour cela l’onglet « Templates » de la GUI propose la création et la gestion des différents templates.

admin-template-portal-img-1

Importer une image

Pour importer une image, il suffit d’aller das l’onglet Images et de cliquer sur ADD AN ENTRY. Le formulaire d’importation suivant s’affichera :

admin-template-portal-img-8

Une fois le nom donné à votre image et le fichier sélectonné, sauvegarder pour imporetr l’image. Celle-ci sera alors disponible dans la liste ci-dessous :

admin-template-portal-img-7

  • Preview : Une miniature de votre image.
  • Name : Le nom donné à votre image.
  • URI : L’URI à indiquer dans la balise <img> de votre template.
  • Action : Les actions associées à l’image.

Note : Lors de la création d’un template, un accès simplifié à vos images est disponible. (cf. ci-dessous)

Création d’un template

Lors de la création d’un nouveau template d’authentification, Vulture génère un template par défaut dont le rendu final est celui-ci :

admin-template-portal-img-2

Vulture propose l’édition du CSS et du HTML de toutes les pages correspondant aux fonctionnalités du portail afin de pouvoir les personnaliser. L’édition HTML supporte la syntaxe Jinja2 (http://jinja.pocoo.org/docs/dev/).

admin-template-portal-img-3

La zone de droite documente les balises définies par Vulture utilisables dans chacune des pages du portail. Celles-ci correspondent aux éléments utilisés par le portail d’authentification Vulture.

admin-template-portal-img-4

Le bouton “PREVIEW” permet à tout moment d’avoir un rendu du template édité.

L’édition du template de l’onglet “Messaging Settings” permet d’éditer les e-mail envoyés lors de l’oubli de mot de passe ainsi que le message affiché ensuite par le portail.

admin-template-portal-img-5

L’édition du template de l’onglet “Error” permet d’éditer la page d’erreur affichée lorsqu’une application protégée renvoit une erreur de type 403, 404 ou 500 ainsi que le message d’erreur affiché.

admin-template-portal-img-6

Lors de l’édtition de vos templates, les images importées précédemment sont disponibles en cliquant sur le bouton :

admin-template-portal-img-9

Dans la fenêtre, il suffit de cliquer sur l’image ou sur le lien pour copier l’URI de celle-ci. Il suffit de ensuite de coller le lien dans votre template.

admin-template-portal-img-10

A noter :

  • Lors de la prévisualisation du template, le Jinja n’est pas interprété et des messages examples sont affichés. Il est possible que certaines balises Jinja ne soient pas prises en compte à ce moment mais le soient lors de l’utilisation du portail.
  • Tout ce que ce qui sera saisi dans le CSS se substituera au champ {{style}} dans les templates HTML.
  • Les images importées ne sont pas visibles car elles possèdent une URL très restrictive non accessible depuis la GUI.