summaryrefslogtreecommitdiffstats
path: root/doc/antora/modules/unlang/pages/xlat/attribute.adoc
blob: a3ee29bb0693271326ee3b1182836c06f4ee08ab (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
= Attribute References

Attributes in a list may be referenced via one of the following two
syntaxes:

`%{Attribute-Name}` +
`%{<list>:Attribute-Name}`

The `<list>:` prefix is optional. If given, it must be a valid
reference to an xref:list.adoc[attribute list].

If the `<list>:` prefix is omitted, then the `request` list is
assumed.

For EAP methods with tunneled authentication sessions (i.e. PEAP and
EAP-TTLS), the inner tunnel session can refer to a list for the outer
session by prefixing the list name with `outer.` ; for example,
`outer.request`.

When a reference is encountered, the given list is examined for an
attribute of the given name. If found, the variable reference in the
string is replaced with the value of that attribute. Otherwise, the
reference is replacedd with an empty string.

.Examples

`%{User-Name}` +
`%{request.User-Name} # same as above` +
`%{reply.User-Name}` +
`%{outer.request.User-Name} # from inside of a TTLS/PEAP tunnel`

Examples of using references inside of a string:

`"Hello %{User-Name}"` +
`"You, %{User-Name} are not allowed to use %{NAS-IP-Address}"`

== Additional Variations

`%{Attribute-Name[#]}`::
Returns an integer containing the number of named attributes

`%{Attribute-Name[0]}`::

When an attribute appears multiple times in a list, this syntax allows
you to address the attributes as with array entries.  `[0]` refers to
the first attributes, `[1]` refers to the second attribute, etc.

`%{Attribute-Name[*]}`::

Returns a comma-separated string containing all values for the named
attributes.

// Copyright (C) 2020 Network RADIUS SAS.  Licenced under CC-by-NC 4.0.
// Development of this documentation was sponsored by Network RADIUS SAS.