4b4362520b
The guide still told users to "leave authserv_id unset" when their server's host varies, which now drops every message that needs an authenticated From:. State that the pin is required, how to find it (the token before the first ';' of the topmost Authentication-Results header your server writes), what to do when it seems to vary (RFC 8601 authserv-id names the administrative domain, so configure a stable one and pin it), and that the only alternative is the explicit require_authenticated_sender: false / EMAIL_TRUST_FROM_HEADER=true opt-out. Mirror the reference tables, plugin.yaml prompt and zh-Hans translation. Co-authored-by: JiuYue0820 <287222957+FirmaSpring@users.noreply.github.com>
44 lines
1.4 KiB
YAML
44 lines
1.4 KiB
YAML
name: email-platform
|
|
label: Email
|
|
kind: platform
|
|
version: 1.0.0
|
|
description: >
|
|
Email gateway adapter for Hermes Agent. Polls an IMAP mailbox for inbound
|
|
messages and replies over SMTP, relaying email threads to and from the
|
|
Hermes agent.
|
|
author: NousResearch
|
|
requires_env:
|
|
- name: EMAIL_ADDRESS
|
|
description: "Email account address"
|
|
prompt: "Email address"
|
|
password: false
|
|
- name: EMAIL_PASSWORD
|
|
description: "Email account password / app password"
|
|
prompt: "Email password"
|
|
password: true
|
|
- name: EMAIL_SMTP_HOST
|
|
description: "SMTP host (e.g. smtp.gmail.com)"
|
|
prompt: "SMTP host"
|
|
password: false
|
|
optional_env:
|
|
- name: EMAIL_SMTP_PORT
|
|
description: "SMTP port (default 587)"
|
|
prompt: "SMTP port"
|
|
password: false
|
|
- name: EMAIL_IMAP_HOST
|
|
description: "IMAP host for inbound polling (e.g. imap.gmail.com)"
|
|
prompt: "IMAP host"
|
|
password: false
|
|
- name: EMAIL_ALLOWED_USERS
|
|
description: "Comma-separated email addresses allowed to talk to the bot"
|
|
prompt: "Allowed users (comma-separated)"
|
|
password: false
|
|
- name: EMAIL_HOME_ADDRESS
|
|
description: "Default address for cron / notification delivery"
|
|
prompt: "Home address"
|
|
password: false
|
|
- name: EMAIL_AUTHSERV_ID
|
|
description: "Exact authserv-id on your mail server's topmost Authentication-Results header, e.g. mx.google.com (required unless EMAIL_TRUST_FROM_HEADER=true)"
|
|
prompt: "Receiving MTA authserv-id"
|
|
password: false
|