From 0097abdf24efaee1abe0cd9afad12b29ffe7d5d1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Richard=20K=C3=B6rber?= Date: Wed, 5 Feb 2020 19:54:24 +0100 Subject: [PATCH] Docs: Keep the response online until status change --- src/doc/docs/usage/order.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/doc/docs/usage/order.md b/src/doc/docs/usage/order.md index 968a1c0f..07a597ed 100644 --- a/src/doc/docs/usage/order.md +++ b/src/doc/docs/usage/order.md @@ -65,6 +65,8 @@ This is a very simple example. You should limit the number of loop iterations, a The CA server may start the validation immediately after `trigger()` is invoked, so make sure your server is ready to respond to requests before invoking `trigger()`. Otherwise the challenge might fail immediately. +Also keep your response available until the status has changed to `VALID` or `INVALID`. The ACME server may check your response multiple times, and from different IPs. + `update()` may throw an `AcmeRetryAfterException`, giving an estimated instant in `getRetryAfter()` when the authorization is completed. You should then wait until that moment has been reached, before trying again. The state of the `Authorization` instance is still updated when this exception is thrown. When the authorization status is `VALID`, you have successfully authorized your domain.