Skip to content

Commit 0385f54

Browse files
committed
Replace some fields on [Client|Server]Verifier with policy property. (docs)
1 parent 775c83d commit 0385f54

File tree

1 file changed

+17
-25
lines changed

1 file changed

+17
-25
lines changed

docs/x509/verification.rst

+17-25
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,10 @@ the root of trust:
133133

134134
.. versionadded:: 43.0.0
135135

136+
.. versionchanged:: 44.0.0
137+
``verification_time`` and ``max_chain_depth`` were replaced by the
138+
``policy`` property that provides access to these values.
139+
136140
A ClientVerifier verifies client certificates.
137141

138142
It contains and describes various pieces of configurable path
@@ -142,17 +146,11 @@ the root of trust:
142146
ClientVerifier instances cannot be constructed directly;
143147
:class:`PolicyBuilder` must be used.
144148

145-
.. attribute:: validation_time
146-
147-
:type: :class:`datetime.datetime`
148-
149-
The verifier's validation time.
149+
.. attribute:: policy
150150

151-
.. attribute:: max_chain_depth
152-
153-
:type: :class:`int`
151+
:type: :class:`Policy`
154152

155-
The verifier's maximum intermediate CA chain depth.
153+
The policy used by the verifier. Can be used to access verification time, chain depth, etc.
156154

157155
.. attribute:: store
158156

@@ -181,6 +179,11 @@ the root of trust:
181179

182180
.. versionadded:: 42.0.0
183181

182+
.. versionchanged:: 44.0.0
183+
``subject``, ``verification_time`` and ``max_chain_depth`` were replaced by the
184+
``policy`` property that provides access to these values.
185+
186+
184187
A ServerVerifier verifies server certificates.
185188

186189
It contains and describes various pieces of configurable path
@@ -191,23 +194,11 @@ the root of trust:
191194
ServerVerifier instances cannot be constructed directly;
192195
:class:`PolicyBuilder` must be used.
193196

194-
.. attribute:: subject
195-
196-
:type: :class:`Subject`
197-
198-
The verifier's subject.
199-
200-
.. attribute:: validation_time
201-
202-
:type: :class:`datetime.datetime`
203-
204-
The verifier's validation time.
205-
206-
.. attribute:: max_chain_depth
197+
.. attribute:: policy
207198

208-
:type: :class:`int`
199+
:type: :class:`Policy`
209200

210-
The verifier's maximum intermediate CA chain depth.
201+
The policy used by the verifier. Can be used to access verification time, chain depth, etc.
211202

212203
.. attribute:: store
213204

@@ -407,7 +398,8 @@ the root of trust:
407398

408399
.. versionadded:: 44.0.0
409400

410-
Represents a policy for certificate verification. Passed to extension validator callbacks.
401+
Represents a policy for certificate verification. Passed to extension validator callbacks and
402+
accessible via :class:`ClientVerifier` and :class:`ServerVerifier`.
411403

412404
.. attribute:: max_chain_depth
413405

0 commit comments

Comments
 (0)