|
1
|
% Usage et personnalisation
|
|
2
|
% UAuth: Portail captif dans le Cloud
|
|
3
|
% Entr'ouvert SCOP -- http://www.entrouvert.com
|
|
4
|
|
|
5
|
Thème
|
|
6
|
=========
|
|
7
|
|
|
8
|
Il est possible de personnaliser la page d'accueil d'une organisation en
|
|
9
|
surchageant le templates et en ajoutant des feuilles des styles, images, etc.
|
|
10
|
|
|
11
|
Ces fichiers peuvent être chargés dans le compartiment *Theme* de l'interface
|
|
12
|
de gestion:
|
|
13
|
|
|
14
|
\ 
|
|
15
|
|
|
16
|
Templates
|
|
17
|
---------
|
|
18
|
Seule la page d'accueil d'une organisation est personnalisable.
|
|
19
|
|
|
20
|
Cela peut être fait en chargeant un fichier template *base.html*. C'est un
|
|
21
|
fichier doit contenir des balises
|
|
22
|
Django(https://docs.djangoproject.com/en/dev/topics/templates/) définissant la
|
|
23
|
structure personnalisée de la page.
|
|
24
|
|
|
25
|
Il doit impérativement définir le block:
|
|
26
|
|
|
27
|
```html
|
|
28
|
{% block content %}
|
|
29
|
{% endblock %}
|
|
30
|
```
|
|
31
|
|
|
32
|
utilisé pour afficher la liste des fournisseurs d'identité et la formulaire de
|
|
33
|
connexion invité.
|
|
34
|
|
|
35
|
Feuilles de styles et les statics
|
|
36
|
---------------------------------
|
|
37
|
|
|
38
|
Des feuilles de style peuvent être chargées par le fichier *base.html* défini
|
|
39
|
précedemment de façon suivante:
|
|
40
|
|
|
41
|
```html
|
|
42
|
{% load staticfiles %}
|
|
43
|
...
|
|
44
|
<head>
|
|
45
|
...
|
|
46
|
<link href="{% static "entrouvert/eo.css" %}" media="all" rel="stylesheet" type="text/css" />
|
|
47
|
...
|
|
48
|
</head>
|
|
49
|
```
|
|
50
|
|
|
51
|
Afin que le fichier de style personnalisé *eo.css* soit chargé, il doit être
|
|
52
|
préfixé par le *slug* de l'organisation dont le thème est modifié.
|
|
53
|
|
|
54
|
Si l'organisation est *psl*, le static doit être défini de façon suivante:
|
|
55
|
|
|
56
|
```html
|
|
57
|
{% static "psl/eo.css" %}
|
|
58
|
```
|
|
59
|
|
|
60
|
Les images peuvent être chargées au même endroit que les feuilles de style et utilisées de la même façon dans le template:
|
|
61
|
```html
|
|
62
|
<img src="{% static "psl/logo.jpg" %}" />
|
|
63
|
```
|
|
64
|
|
|
65
|
Un exemple de thème est fourni dans le paquet debian sous */usr/share/u-auth/theme-example*, dont le rendu est le suivant:
|
|
66
|
|
|
67
|
\ 
|
|
68
|
|
|
69
|
|
|
70
|
Federations
|
|
71
|
===========
|
|
72
|
|
|
73
|
La liste des fournisseurs d'identité auprès desquels les utilisateurs peuvent
|
|
74
|
être authentifiés peut être définie en chargeant des fichiers .xml des
|
|
75
|
fédérations dans l'onglet *Fédérations* sur l'interface de gestion.
|
|
76
|
|
|
77
|
Les fournisseurs d'identité présents dans ces fichiers seront affichés sur la
|
|
78
|
page d'accueil.
|
|
79
|
|
|
80
|
|
|
81
|
Comptes locaux
|
|
82
|
==============
|
|
83
|
|
|
84
|
Des comptes locaux peuvent être définis dans l'interface de gestion afin de
|
|
85
|
permettre l'authentification sans utiliser un fournisseur d'identité.
|
|
86
|
|
|
87
|
Les comptes peuvent être créés un par un ou plusieurs à la fois.
|
|
88
|
|
|
89
|
\ 
|
|
90
|
|
|
91
|
Le champ *mot de passe* peut être omis lors de la création du compte, il sera
|
|
92
|
auto-généré. Il peut ensuite être visualisé en cliquant sur le nom de l'utilisateur:
|
|
93
|
|
|
94
|
\ 
|
|
95
|
|
|
96
|
Un compte utilisateur peut être desactivé à tout moment, soit une date
|
|
97
|
d'expiration peut être définie.
|
|
98
|
|
|
99
|
\ 
|
|
100
|
|
|
101
|
|
|
102
|
Importer des comptes à partir d'un fichier
|
|
103
|
------------------------------------------
|
|
104
|
Les comptes locaux peuvent être également importé à partir d'un fichier *.csv*
|
|
105
|
|
|
106
|
\ 
|