diff --git a/reference-lib/package-lock.json b/reference-lib/package-lock.json index 42e0f00..e6b5fac 100644 --- a/reference-lib/package-lock.json +++ b/reference-lib/package-lock.json @@ -1,12 +1,12 @@ { "name": "@nginx/reference-lib", - "version": "1.1.18", + "version": "1.1.19", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "@nginx/reference-lib", - "version": "1.1.18", + "version": "1.1.19", "license": "Apache-2.0", "devDependencies": { "@rollup/plugin-json": "^6.1.0", diff --git a/reference-lib/package.json b/reference-lib/package.json index 6bbec25..4af86e8 100644 --- a/reference-lib/package.json +++ b/reference-lib/package.json @@ -1,6 +1,6 @@ { "name": "@nginx/reference-lib", - "version": "1.1.18", + "version": "1.1.19", "description": "", "main": "dist/index.js", "type": "module", diff --git a/reference-lib/src/reference.json b/reference-lib/src/reference.json index bde843e..d1d4f8d 100644 --- a/reference-lib/src/reference.json +++ b/reference-lib/src/reference.json @@ -77,8 +77,8 @@ "

uri

\n" ], "isBlock": false, - "description_md": "The\n[directory URL](https://www.rfc-editor.org/rfc/rfc8555#section-7.1.1)\nof the ACME server.\nThis directive is mandatory.", - "description_html": "

The\ndirectory URL\nof the ACME server.\nThis directive is mandatory.

\n" + "description_md": "The\n[directory URL](https://datatracker.ietf.org/doc/html/rfc8555#section-7.1.1)\nof the ACME server.\nThis directive is mandatory.", + "description_html": "

The\ndirectory URL\nof the ACME server.\nThis directive is mandatory.

\n" }, { "name": "account_key", @@ -96,6 +96,22 @@ "description_md": "The account's private key used for request authentication.\n\nAccepted values:\n- `ecdsa`:*`256`*/*`384`*/*`521`*\n for ES256, ES384, or ES512 JSON Web Signature algorithms\n- `rsa`:*`2048`*/*`3072`*/*`4096`*\n for RS256.\n- File path for an existing key, using one of the algorithms above.\n\nThe generated account keys are preserved across reloads,\nbut will be lost on restart unless [`state_path`](https://nginx.org/en/docs/http/ngx_http_acme_module.html#state_path) is configured.", "description_html": "

The account’s private key used for request authentication.

\n\n

Accepted values:

\n\n\n\n

The generated account keys are preserved across reloads,\nbut will be lost on restart unless state_path is configured.

\n" }, + { + "name": "challenge", + "default": "http-01", + "contexts": [ + "acme_issuer" + ], + "syntax_md": [ + "*`type`*" + ], + "syntax_html": [ + "

type

\n" + ], + "isBlock": false, + "description_md": "Specifies the ACME challenge type to be used for the issuer.\n\nAccepted values:\n- `http-01` (`http`)\n- `tls-alpn-01` (`tls-alpn`)\n\n> ACME challenges are versioned.\n> If an unversioned name is specified,\n> the module automatically selects the latest implemented version.", + "description_html": "

Specifies the ACME challenge type to be used for the issuer.

\n\n

Accepted values:

\n\n\n\n
\n

ACME challenges are versioned.\nIf an unversioned name is specified,\nthe module automatically selects the latest implemented version.

\n
\n" + }, { "name": "contact", "default": "", @@ -112,6 +128,22 @@ "description_md": "Sets an array of URLs that the ACME server can use\nto contact the client regarding account issues.\nThe `mailto:` scheme will be used\nunless specified explicitly.", "description_html": "

Sets an array of URLs that the ACME server can use\nto contact the client regarding account issues.\nThe mailto: scheme will be used\nunless specified explicitly.

\n" }, + { + "name": "external_account_key", + "default": "", + "contexts": [ + "acme_issuer" + ], + "syntax_md": [ + "*`kid`* *`file`*" + ], + "syntax_html": [ + "

kid file

\n" + ], + "isBlock": false, + "description_md": "Specifies a key identifier *`kid`* and a *`file`*\nwith the MAC key for\n[ external account authorization](https://datatracker.ietf.org/doc/html/rfc8555#section-7.3.4).\n\nThe value `data`:*`key`* can be specified\ninstead of the *`file`*, which loads a key directly from\nthe configuration without using intermediate files.\n\nIn both cases, the key is expected to be encoded in\n[ base64url](https://datatracker.ietf.org/doc/html/rfc4648#section-5).", + "description_html": "

Specifies a key identifier kid and a file\nwith the MAC key for\n external account authorization.

\n\n

The value data:key can be specified\ninstead of the file, which loads a key directly from\nthe configuration without using intermediate files.

\n\n

In both cases, the key is expected to be encoded in\n base64url.

\n" + }, { "name": "ssl_trusted_certificate", "default": "", @@ -146,19 +178,19 @@ }, { "name": "state_path", - "default": "", + "default": "acme_", "contexts": [ "acme_issuer" ], "syntax_md": [ - "*`path`*" + "*`path`* | `off`" ], "syntax_html": [ - "

path

\n" + "

path | off

\n" ], "isBlock": false, - "description_md": "Defines a directory for storing the module data\nthat can be persisted across restarts.\nThis can improve the load time by skipping some requests on startup,\nand avoid hitting request rate limits on the ACME server.\n\nThe directory contains sensitive content, such as\nthe account key, issued certificates, and private keys.", - "description_html": "

Defines a directory for storing the module data\nthat can be persisted across restarts.\nThis can improve the load time by skipping some requests on startup,\nand avoid hitting request rate limits on the ACME server.

\n\n

The directory contains sensitive content, such as\nthe account key, issued certificates, and private keys.

\n" + "description_md": "Defines a directory for storing the module data\nthat can be persisted across restarts.\nThis can improve the load time by skipping some requests on startup,\nand avoid hitting request rate limits on the ACME server.\n\nThe directory contains sensitive content, such as\nthe account key, issued certificates, and private keys.\n\nThe `off` parameter (0.2.0) disables storing the account\ninformation and issued certificates on disk.\n\n> Prior to version 0.2.0, the state directory was not created by default.", + "description_html": "

Defines a directory for storing the module data\nthat can be persisted across restarts.\nThis can improve the load time by skipping some requests on startup,\nand avoid hitting request rate limits on the ACME server.

\n\n

The directory contains sensitive content, such as\nthe account key, issued certificates, and private keys.

\n\n

The off parameter (0.2.0) disables storing the account\ninformation and issued certificates on disk.

\n\n
\n

Prior to version 0.2.0, the state directory was not created by default.

\n
\n" }, { "name": "accept_terms_of_service", @@ -17346,5 +17378,5 @@ ] } ], - "version": "https://github.com/nginx/nginx.org/commit/8f7b354b3593482446c9ef7e24dc84686c5cba60" + "version": "https://github.com/nginx/nginx.org/commit/a42f51d66b765d47e9048b9d9646aaf1084a2b09" }