summaryrefslogtreecommitdiffstats
path: root/src/man/include/krb5_options.xml
blob: d82be7bfa18b9bae4638c1baab47bd8ed9e3fbb5 (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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
<variablelist>
    <varlistentry>
        <term>krb5_auth_timeout (integer)</term>
        <listitem>
            <para>
                Timeout in seconds after an online authentication request
                or change password request is aborted. If possible, the
                authentication request is continued offline.
            </para>
            <para>
                Default: 6
            </para>
        </listitem>
    </varlistentry>

    <varlistentry>
        <term>krb5_validate (boolean)</term>
        <listitem>
            <para>
                Verify with the help of krb5_keytab that the TGT
                obtained has not been spoofed. The keytab is checked for
                entries sequentially, and the first entry with a matching
                realm is used for validation. If no entry matches the realm, the last
                entry in the keytab is used. This process can be used to validate
                environments using cross-realm trust by placing the appropriate
                keytab entry as the last entry or the only entry in the keytab file.
            </para>
            <para>
                Default: false (IPA and AD provider: true)
            </para>
            <para>
                Please note that the ticket validation is the first step when
		checking the PAC (see 'pac_check' in the
                <citerefentry>
                    <refentrytitle>sssd.conf</refentrytitle>
                    <manvolnum>5</manvolnum>
                </citerefentry> manual page for details). If ticket
                validation is disabled the PAC checks will be skipped as well.
            </para>
        </listitem>
    </varlistentry>

    <varlistentry>
        <term>krb5_renewable_lifetime (string)</term>
        <listitem>
            <para>
                Request a renewable ticket with a total
                lifetime, given as an integer immediately followed
                by a time unit:
            </para>
            <para>
                <emphasis>s</emphasis> for seconds
            </para>
            <para>
                <emphasis>m</emphasis> for minutes
            </para>
            <para>
                <emphasis>h</emphasis> for hours
            </para>
            <para>
                <emphasis>d</emphasis> for days.
            </para>
            <para>
                If there is no unit given, <emphasis>s</emphasis> is
                assumed.
            </para>
            <para>
                NOTE: It is not possible to mix units.  To set
                the renewable lifetime to one and a half hours,
                use '90m' instead of '1h30m'.
            </para>
            <para>
                Default: not set, i.e. the TGT is not renewable
            </para>
        </listitem>
    </varlistentry>

    <varlistentry>
        <term>krb5_lifetime (string)</term>
        <listitem>
            <para>
                Request ticket with a lifetime, given as an
                integer immediately followed by a time unit:
            </para>
            <para>
                <emphasis>s</emphasis> for seconds
            </para>
            <para>
                <emphasis>m</emphasis> for minutes
            </para>
            <para>
                <emphasis>h</emphasis> for hours
            </para>
            <para>
                <emphasis>d</emphasis> for days.
            </para>
            <para>
                If there is no unit given <emphasis>s</emphasis> is
                assumed.
            </para>
            <para>
                NOTE: It is not possible to mix units.
                To set the lifetime to one and a half
                hours please use '90m' instead of '1h30m'.
            </para>
            <para>
                Default: not set, i.e. the default ticket lifetime
                configured on the KDC.
            </para>
        </listitem>
    </varlistentry>

    <varlistentry>
        <term>krb5_renew_interval (string)</term>
        <listitem>
            <para>
                The time in seconds between two checks if the TGT
                should be renewed. TGTs are renewed if about half
                of their lifetime is exceeded, given as an integer
                immediately followed by a time unit:
            </para>
            <para>
                <emphasis>s</emphasis> for seconds
            </para>
            <para>
                <emphasis>m</emphasis> for minutes
            </para>
            <para>
                <emphasis>h</emphasis> for hours
            </para>
            <para>
                <emphasis>d</emphasis> for days.
            </para>
            <para>
                If there is no unit given, <emphasis>s</emphasis> is
                assumed.
            </para>
            <para>
                NOTE: It is not possible to mix units.  To set
                the renewable lifetime to one and a half hours,
                use '90m' instead of '1h30m'.
            </para>
            <para>
                 If this option is not set or is 0 the automatic
                 renewal is disabled.
            </para>
            <para>
                Default: not set
            </para>
        </listitem>
    </varlistentry>

    <varlistentry>
        <term>krb5_canonicalize (boolean)</term>
        <listitem>
            <para>
                Specifies if the host and user principal should be
                canonicalized. This feature is available with MIT
                Kerberos 1.7 and later versions.
            </para>

            <para>
                Default: false
            </para>
        </listitem>
    </varlistentry>
</variablelist>