Skip to content

Commit a46947d

Browse files
bavshin-f5y82
authored andcommitted
Documented acme preferred_chain and profile directives.
1 parent 4ff366a commit a46947d

File tree

1 file changed

+41
-1
lines changed

1 file changed

+41
-1
lines changed

xml/en/docs/http/ngx_http_acme_module.xml

Lines changed: 41 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
<module name="Module ngx_http_acme_module"
1010
link="/en/docs/http/ngx_http_acme_module.html"
1111
lang="en"
12-
rev="2">
12+
rev="3">
1313

1414
<section id="summary">
1515

@@ -227,6 +227,46 @@ base64url</link>.
227227
</directive>
228228

229229

230+
<directive name="preferred_chain">
231+
<syntax><value>name</value></syntax>
232+
<default />
233+
<context>acme_issuer</context>
234+
<appeared-in>0.3.0</appeared-in>
235+
236+
<para>
237+
Specifies the preferred certificate chain.
238+
</para>
239+
240+
<para>
241+
If the ACME server offers multiple certificate chains,
242+
prefer the chain with the topmost certificate issued from the
243+
Subject Common Name <value>name</value>.
244+
If there are no matches, the default chain will be used.
245+
</para>
246+
247+
</directive>
248+
249+
250+
<directive name="profile">
251+
<syntax><value>name</value> [<literal>require</literal>]</syntax>
252+
<default />
253+
<context>acme_issuer</context>
254+
<appeared-in>0.3.0</appeared-in>
255+
256+
<para>
257+
Requests the
258+
<link url="https://datatracker.ietf.org/doc/html/draft-ietf-acme-profiles">
259+
certificate profile</link> <value>name</value> from the ACME server.
260+
</para>
261+
262+
<para>
263+
The <literal>require</literal> parameter will cause certificate renewals
264+
to fail if the server does not support the specified profile.
265+
</para>
266+
267+
</directive>
268+
269+
230270
<directive name="ssl_trusted_certificate">
231271
<syntax><value>file</value></syntax>
232272
<default/>

0 commit comments

Comments
 (0)