95.1.56. pepsi-secure-link¶

inspect and manage messages held in the portal

Section du manuel:

1

95.1.56.1.1. Nom¶

pepsi-secure-link - CLI d’opérateur pour le portail de repli à liens sécurisés.

95.1.56.1.2. Synopsis¶

pepsi-secure-link [GLOBAL-OPTIONS] list [–limit N] [–expired] [–json]
pepsi-secure-link [GLOBAL-OPTIONS] show TOKEN [–json]
pepsi-secure-link [GLOBAL-OPTIONS] revoke TOKEN
pepsi-secure-link [GLOBAL-OPTIONS] prune [–grace-hours N]

95.1.56.1.3. Description¶

pepsi-secure-link inspecte et gère les messages détenus dans le portail de repli à liens sécurisés (voir pepsi-stage-secure-link(1) et pepsi-httpd(1)). C’est un outil d’opérateur, pas une étape.

Les options globales (-c/--config, -L/--log, -v) viennent avant la sous-commande. Lorsqu’il est lancé en tant que root, l’outil adopte le compte de service pepsi et s’authentifie donc auprès de PostgreSQL en tant que rôle propriétaire de la file d’attente.

95.1.56.1.4. Ce qu’il peut et ne peut pas montrer¶

Il rapporte qui et quand, jamais quoi. Il n’existe aucune sous-commande qui affiche un message stocké, aucun indicateur --decrypt et aucune clé de séquestre : la clé de contenu est dérivée avec Argon2id du PIN du destinataire, d’un sel par message et d’un poivre côté serveur, et le PIN n’est jamais stocké. Rien de ce que détient un administrateur ne permet de reconstruire la clé : ni la base de données, ni le poivre, ni les deux ensemble.

Ainsi, lorsqu’un destinataire perd le PIN, l’expéditeur envoie de nouveau le message ; un nouveau PIN est émis et un nouveau lien envoyé par courrier. Il n’y a pas de « renvoyer le PIN », car le PIN n’existe nulle part ailleurs qu’entre les mains des correspondants.

95.1.56.1.5. Commandes¶

list

Les messages en attente, les plus récents d’abord : jeton, expéditeur, destinataire, expiration, nombre de lectures, nombre d’échecs de PIN et tout verrouillage. --expired montre en plus les messages arrivés à échéance mais pas encore élagués. --limit plafonne le listage (50 par défaut) et --json imprime les mêmes champs en JSON.

show TOKEN

Les métadonnées d’un message plus son journal d’accès : quand chaque tentative a eu lieu, depuis quelle adresse, et comment elle s’est terminée (read, bad-pin, locked, reply). Le journal est plafonné par message par [pepsi-secure-link] ACCESS_LOG_ROWS, qui est aussi le nombre de lignes qu’affiche show, et est supprimé avec le message.

revoke TOKEN

Détruit un message. Cela ne remet pas le courrier dans la file d’attente ; cela le retire, et le lien du destinataire cesse de fonctionner. Si la révocation était une erreur, l’expéditeur renvoie le message.

prune

Supprime chaque message passé son expiration, ainsi que son journal d’accès ; le message stocké est l’unique copie. La commande est destinée à une tâche cron quotidienne ou à un timer systemd, comme pepsi-tlsrpt prune ; le paquet Debian livre pepsi-secure-link-prune.timer, qui l’exécute chaque jour en tant que root (l’outil adopte alors le compte pepsi). --grace-hours conserve un peu plus longtemps les messages expirés. Un déploiement qui n’élague jamais conserve à jamais du texte chiffré illisible dans la base de données : le portail refuse déjà un jeton expiré, le problème touche donc la taille de la base plutôt que la confidentialité, mais cela reste un problème.

95.1.56.1.6. Privilèges¶

L’outil s’exécute sous le rôle de base pepsi, à qui sont accordés INSERT et DELETE sur pepsi.secure_message et SELECT sur chacune de ses colonnes sauf ciphertext, plus SELECT et DELETE sur le journal d’accès (pepsi.secure_access). Seul le rôle pepsi-httpd, qui sert le portail, peut lire le texte chiffré. C’est pourquoi list et show fonctionnent et pourquoi rien ici ne peut afficher un message, fût-ce par accident ; pepsi-setup vérifie cette limite contre la base de données en service à chaque exécution.

95.1.56.1.7. Code de sortie¶

0 en cas de succès, non nul en cas d’erreur (y compris show/revoke pour un jeton qui n’existe pas).

95.1.56.1.8. Voir aussi¶

pepsi-stage-secure-link(1), pepsi-stage-encrypt(1), pepsi-httpd(1), pepsi-setup(1), pepsi.conf(5)

Le manuel de Pepsi : « The secure-link fallback portal » (la construction et ses conséquences), « Sécurité » (les mécanismes du portail de lien sécurisé) et « Modèle de menace » (le bien que constitue le message stocké et le voleur de base de données).

Logo

Pepsi 0.1.2

Langues

  • English
  • Deutsch
  • français

Navigation

Sommaire

  • 1. Introduction
  • 2. Principes de conception
  • 3. Démarrage sur un VPS bon marché
  • 4. Installation
  • 5. Paquets Debian
  • 6. L’assistant
  • 7. Configuration
  • 8. Exploiter Pepsi
  • 9. Utiliser Pepsi : un guide pour les utilisateurs
  • 10. Dépannage
  • 11. Fonctionnalités prises en charge
  • 12. Extensions du protocole SMTP
  • 13. Gestion des clés
  • 14. Le portail de repli par lien sécurisé
  • 15. Interopérabilité des clients
  • 16. Modèle de menace
  • 17. Modèle de sécurité
  • 18. Dépendances
  • 19. Microsoft Exchange comme passerelle
  • 20. Extensions pour clients de messagerie
  • 21. Listes de diffusion
  • 22. Archives
  • 23. L’API REST de GNU Mailman 3
  • 24. L’API d’administration
  • 25. La console d’administration
  • 26. Architecture
  • 27. L’état du message
  • 28. Étendre le pipeline
  • 29. Suite de tests
  • 30. Suite de benchmarks
  • 31. Performance
  • 32. pepsi-ingress
  • 33. pepsi-dispatch
  • 34. pepsi-httpd
  • 35. pepsi-stage-arc
  • 36. pepsi-stage-srs
  • 37. pepsi-stage-encrypt
  • 38. pepsi-stage-decrypt
  • 39. pepsi-stage-dkim-sign
  • 40. pepsi-stage-bounce
  • 41. pepsi-stage-aliases
  • 42. pepsi-stage-relay-to-internet
  • 43. pepsi-stage-relay-to-smarthost
  • 44. pepsi-stage-relay-to-maildir
  • 45. pepsi-stage-dot-forward
  • 46. pepsi-stage-relay-to-lmtp
  • 47. pepsi-stage-discard
  • 48. pepsi-stage-anti-spam
  • 49. pepsi-stage-auto-pay
  • 50. pepsi-stage-check-whitelist
  • 51. pepsi-stage-auto-whitelist
  • 52. pepsi-stage-autocrypt-learn
  • 53. pepsi-stage-reencrypt
  • 54. pepsi-stage-detect-language
  • 55. pepsi-detect-language
  • 56. pepsi-stage-block-language
  • 57. pepsi-stage-vacation
  • 58. pepsi-stage-secretary
  • 59. pepsi-stage-edit-settings
  • 60. pepsi-stage-if
  • 61. pepsi-stage-milter
  • 62. pepsi-stage-quarantine
  • 63. pepsi-stage-route
  • 64. pepsi-stage-vks-confirm
  • 65. pepsi-stage-dmarc-report
  • 66. pepsi-stage-defang
  • 67. pepsi-stage-secure-link
  • 68. pepsi-setup
  • 69. pepsi-queue
  • 70. pepsi-status
  • 71. pepsi-reputation
  • 72. pepsi-greylist
  • 73. pepsi-dkim
  • 74. pepsi-sendmail
  • 75. pepsi-whitelist
  • 76. pepsi-keys
  • 77. pepsi-keydisc
  • 78. pepsi-settings
  • 79. pepsi-list
  • 80. pepsi-archive
  • 81. pepsi-stage-list
  • 82. pepsi-stage-list-post
  • 83. pepsi-stage-list-deliver
  • 84. pepsi-stage-list-command
  • 85. pepsi-stage-list-bounce
  • 86. pepsi-tlsrpt
  • 87. pepsi-secure-link
  • 88. pepsi-failure-bouncer
  • 89. pepsi-quota
  • 90. pepsi-helper-token-refresh
  • 91. pepsi-telemetry
  • 92. pepsi-telemetry-client
  • 93. pepsi-config
  • 94. Stabilité des fonctionnalités
  • 95. Pages de manuel
    • 95.1. Commandes (section 1)
    • 95.2. Fichier de configuration (section 5)
    • 95.3. État du message (section 7)
  • 96. Vulnérabilités des implémentations du courrier électronique
  • 97. Index des RFC
  • 98. Bibliographie

Related Topics

  • Documentation overview
    • 95. Pages de manuel
      • Previous: 95.1.55. pepsi-tlsrpt
      • Next: 95.1.57. pepsi-failure-bouncer

Recherche rapide

©2026, GNUnet e.V.. | Powered by Sphinx 9.1.0 & Alabaster 0.7.16 | Page source