62. pepsi-stage-quarantine

Retient un message jusqu’à ce qu’un opérateur le libère ou le supprime.

62.1. Rôle

pepsi-stage-quarantine est l’endroit où attend le courrier mis en quarantaine. Une demande de quarantaine d’un milter (QUARANTINE_STAGE de pepsi-stage-milter, ou un milter pré-file dans pepsi-ingress), QUARANTINE_STAGE de pepsi-stage-decrypt ou tout autre acheminement peut y envoyer un message. L’étape le retient jusqu’à ce qu’un opérateur agisse avec pepsi-queue quarantine, et n’envoie aucun avis de son propre chef. Comme la quarantaine est une étape, un site peut mettre un autre gestionnaire à sa place. Référence : pepsi-stage-quarantine(1).

62.2. Fonctionnalités

  • Retenu sans minuterie : à l’arrivée, l’étape note state.quarantine.since et laisse la ligne paused sans timeout, de sorte que pepsi-dispatch ne la réveille jamais de lui-même.

  • Libéré par un opérateur : pepsi-queue quarantine release TOKEN rend la ligne à l’étape, qui note released_at et fait suivre le message vers RELEASE_STAGE. pepsi-queue quarantine delete TOKEN le supprime (noté dans le journal de courrier, s’il est activé). Le webhook de paiement (POST /resume de pepsi-httpd) ne touche pas à un message retenu.

  • Une fin facultative : avec MAX_HOLD (par exemple 14 days), la rétention prend fin d’elle-même ; le message va alors à EXPIRE_STAGE, marqué comme pepsi-queue gc marque une quarantaine expirée (failure_class = quarantine-expired, seul le bloc d’en-têtes dans une DSN), ou il est supprimé. Sans MAX_HOLD, pepsi-queue gc génère un rebond pour un message encore retenu [pepsi-queue] QUARANTINE_MAX_AGE_DAYS (14) jours après son arrivée, comme à toute étape de quarantaine, car le courrier retenu est stocké en clair.

  • Pas d’oracle à la fin : la copie d’une contribution de liste destinée à un membre, et un message dont le contenu provient d’un texte chiffré sans protection d’intégrité, sont supprimés à l’expiration au lieu d’être acheminés (Les rebonds et les réponses au courrier chiffré).

  • Retenu à nouveau après une libération : un message qui revient à une étape de quarantaine après une libération antérieure commence une nouvelle rétention.

  • Pas laissé aux correspondants : les options sont lues depuis la configuration de base, jamais depuis les paramètres par adresse.

62.3. Configuration

[stage-<name>] : PROGRAM = pepsi-stage-quarantine, RELEASE_STAGE (par défaut NEXT_STAGE ; l’une des deux est obligatoire), MAX_HOLD (un intervalle ; un jour compte pour 24 heures) et EXPIRE_STAGE (nécessite MAX_HOLD). Un message que l’ingress a mis en quarantaine a sauté toutes les étapes précédant celle-ci ; pour cet usage, RELEASE_STAGE vaut donc normalement init. pepsi-setup validate et la vérification de démarrage du worker refusent une cible qui n’existe pas ou qui est l’étape elle-même.

62.4. État

  • Entrées : state.quarantine.reason et by, écrits par celui qui a envoyé le message ici.

  • Sorties : state.quarantine : since, until (avec MAX_HOLD), released_at ou expired (pepsi.state(7)).

62.5. Voir aussi

pepsi-queue, pepsi-stage-milter, Exploiter Pepsi, pepsi-stage-quarantine(1).