From 7fd1719ffe942e59273971776db1a925255848e9 Mon Sep 17 00:00:00 2001 From: Nikos Sklikas Date: Tue, 15 Oct 2019 16:50:58 +0300 Subject: Update documentation with mdq freshness_period --- docs/howto/config.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/howto/config.rst b/docs/howto/config.rst index 0e3be8a8..91195b34 100644 --- a/docs/howto/config.rst +++ b/docs/howto/config.rst @@ -209,6 +209,7 @@ For example:: { "url": "http://mdq.ukfederation.org.uk/", "cert": "ukfederation-mdq.pem", + "freshness_period": "P0Y0M0DT2H0M0S", }, ], }, @@ -221,6 +222,14 @@ metadata signing certificates should be used. These public keys must be acquired by some secure out-of-band method before being placed on the local file system. +When using MDQ, the `freshness_period` option can be set to define +a period for which the metadata fetched from the the MDQ server are considered +fresh. After that period has passed the metadata are not valid anymore and must +be fetched again. The period must be in the format defined in `iso 8601 `_. + +By default, if `freshness_period` is not defined, the metadata are fetched +only the first time they are requested and never refreshed. + organization ^^^^^^^^^^^^ -- cgit v1.2.1