From 66f67913e8ddf20b5d778efc0605e255a8352ddc Mon Sep 17 00:00:00 2001 From: Loic Dachary Date: Sun, 28 Jan 2018 23:26:00 +0100 Subject: [PATCH] docs: admin and journalist guide regarding daily notifications --- docs/install.rst | 9 +++++++++ docs/journalist.rst | 20 ++++++++++++++++++++ 2 files changed, 29 insertions(+) diff --git a/docs/install.rst b/docs/install.rst index 37f40319918..8759d175cf4 100644 --- a/docs/install.rst +++ b/docs/install.rst @@ -69,6 +69,15 @@ continuing: can add more later) - The username of the system admin +You can also, optionally, require that :doc:`daily notifications about +the number of submissions ` received in the past 24h are +sent via email so journalists know if it is worth checking the +*Journalist Interface*. For this you will need: + +- The Journalist Alert Key +- The Journalist Alert Key fingerprint +- The email address that will receive the daily notifications + You will have to copy the following required files to ``install_files/ansible-base``: diff --git a/docs/journalist.rst b/docs/journalist.rst index e7f3c62c5fa..32a0546535b 100644 --- a/docs/journalist.rst +++ b/docs/journalist.rst @@ -57,6 +57,26 @@ Journalist Interface `.) |Journalist Interface Login| +Receiving daily notifications about submissions +----------------------------------------------- + +When a SecureDrop has little activity and receives only a few +submissions every other week, checking the *Journalist Interface* +daily only to find nothing is waiting is a burden. It is more +convenient for journalists to be notified daily via email about the +number of submissions received in the past 24h. + +If the email shows submissions were received, the journalist can +connect to the *Journalist Interface* to get it. + +This is an optional feature that must be activated :doc:`by the +administrator `. In the simplest case a journalist provides +her/his email and GPG public key to the admin. If a team of journalist +want to receive these daily notifications, they should share a GPG +public key and ask the admin to setup a mail alias (SecureDrop does +not provide that) so they all receive the daily notificaitons and are +able to decrypt them. + Interacting With Sources ------------------------