Lemonldap::NG gère les applications par leurs noms d'hôtes(hôtes virtuels d'Apache). Rules are used to protect applications, headers are HTTP headers added to the request to give datas to the application (for logs, profiles,…).
$ENV{<cgi-header>}
which correspond to CGI header ($ENV{REMOTE_ADDR}
for example).
The %ENV table provides:
User-Agent
becomes HTTP_USER_AGENT
)fastcgi_param
with Nginx),fastcgi_param
commands.See also extended functions.
A rule associates a regular expression to a Perl boolean expression or a keyword.
Exemples :
But | Expression régulière | Règle |
---|---|---|
Restreindre le répertoire /admin/ à l'utilisateur bart.simpson | ^/admin/ | $uid eq "bart.simpson" |
Restreindre les répertoires /js/ et /css/ aux utilisateurs authentifiés | ^/(css|js)/ | accept |
Interdire l'accès au répertoire /config/ | ^/config/ | deny |
Ne pas restreindre /public/ | ^/public/ | skip |
Makes authentication optional, but authenticated users are seen as such (that is, user data are sent to the app through HTTP headers) | ^/forum/ | unprotect |
Restrict access to the whole site to users that have the LDAP description field set to “LDAP administrator” (must be set in exported variables) | default | $description eq "LDAP administrator" |
La règle d'accès “default” est utilisée si aucune règle ne correspond à l'URL courante.
Les règles peuvent également être utilisées pour intercepter les URL de déconnexion :
But | Expression régulière | Règle |
---|---|---|
Déconnecte l'utilisateur de Lemonldap::NG le redirige vers http://intranet/ | ^/index.php\?logout | logout_sso http://intranet/ |
Logout user from current application and redirect it to the menu (Apache only) | ^/index.php\?logout | logout_app https://auth.example.com/ |
Logout user from current application and from Lemonldap::NG and redirect it to http://intranet/ (Apache only) | ^/index.php\?logout | logout_app_sso http://intranet/ |
logout_app
and logout_app_sso
rules are not available on Nginx, only on Apache.
Par défaut, l'utilisateur est redirigé vers le portail si aucune URL n'est définie ou vers l'URL indiquée sinon.
LLNG set an “authentication level” during authentication process. This level is the value of the authentication backend used for this user. Default values are:
There are two way to impose users to have a high authentication level:
$authenticationLevel > 3
Les en-têtes sont des associations entre un nom d'en-tête et une expression perl qui retourne une chaîne. Les en-têtes sont utilisés pour donner aux applications les données utilisateurs.
Exemples :
But | Nom d'en-tête | Valeur d'en-tête |
---|---|---|
Donne l'uid (pour la traçabilité) | Auth-User | $uid |
Donne une valeur statique | Some-Thing | “static-value” |
Donne le nom à afficher | Display-Name | $givenName.“ ”.$surName |
Done une valeur non-ascii | Display-Name | encode_base64($givenName." ".$surName) |
Comme indiqué au chapître performances, on peut utiliser des macros, macros locales,…
Session-ID => $_session_id
In addition to macros and name, you can use some functions in rules and headers:
Since 2.0, a wildcard can be used in virtualhost name (not in aliases !): *.example.com
matches all hostnames that belong to example.com
domain.
Even if a wildcard exists, if a virtualhost is explicitly declared, this rule is applied. Example with precedence order: