diff --git a/changelog.d/added-18579-proof-failure-reason.md b/changelog.d/added-18579-proof-failure-reason.md new file mode 100644 index 0000000000..35ed18fc17 --- /dev/null +++ b/changelog.d/added-18579-proof-failure-reason.md @@ -0,0 +1 @@ +- **A calendar email whose proof mail was refused now says why** under **Settings, Meeting attendee, My calendar emails**, instead of only "pending": the reason in plain words with what to do (not authenticated by the sender's mail server, sent from a different address, naming the From address hive-mx saw, or the code expired), when it arrived, and the SPF, DKIM and alignment results hive-mx saw (results and domains only, never the message), with a **Check again** button. The calendar-emails API carries the same summary as `last_failure`. A proof mail whose code matches no address shows, sender masked, under the owner's **Recent proof attempts** (`recent_proof_attempts`, owner only). ([#18579](https://github.com/hivecommons/hive/issues/18579)) diff --git a/dashboard/openapi.json b/dashboard/openapi.json index de5cfe254f..a2fe094b40 100644 --- a/dashboard/openapi.json +++ b/dashboard/openapi.json @@ -807,7 +807,7 @@ "Meetings" ], "summary": "List my calendar emails", - "description": "The signed-in user's calendar email addresses with proof status and pending codes, the hive's address (hive@) and the meetings.email switches. ?all=1 adds the whole allowlist for the owner. Any role.", + "description": "The signed-in user's calendar email addresses with proof status and pending codes, the hive's address (hive@) and the meetings.email switches. An unproven address whose latest proof mail was refused carries last_failure. The owner also gets recent_proof_attempts (proof mails whose code matched no address, sender masked). ?all=1 adds the whole allowlist for the owner. Any role.", "parameters": [ { "name": "all", @@ -834,14 +834,14 @@ "type": "array", "items": { "type": "object", - "description": "Calendar email: email, proven, proven_at, code (pending proof code, own list only), code_expires_at, last_error, active (the user still has access), login (owner allowlist only)" + "description": "Calendar email: email, proven, proven_at, code (pending proof code, own list only), code_expires_at, last_error, active (the user still has access), login (owner allowlist only), last_failure (latest refused proof: reason not_aligned, from_mismatch or expired; at; from (from_mismatch only: the From address parsed, empty when missing, repeated or unparsable); from_domain, spf, spf_domain, spf_aligned, dkim [{domain, result}], dkim_aligned, dmarc, aligned; message, the reason in plain words with what to do)" } }, "allowlist": { "type": "array", "items": { "type": "object", - "description": "Calendar email: email, proven, proven_at, code (pending proof code, own list only), code_expires_at, last_error, active (the user still has access), login (owner allowlist only)" + "description": "Calendar email: email, proven, proven_at, code (pending proof code, own list only), code_expires_at, last_error, active (the user still has access), login (owner allowlist only), last_failure (latest refused proof: reason not_aligned, from_mismatch or expired; at; from (from_mismatch only: the From address parsed, empty when missing, repeated or unparsable); from_domain, spf, spf_domain, spf_aligned, dkim [{domain, result}], dkim_aligned, dmarc, aligned; message, the reason in plain words with what to do)" } }, "invites_enabled": { @@ -849,6 +849,14 @@ }, "files_enabled": { "type": "boolean" + }, + "recent_proof_attempts": { + "type": "array", + "description": "Owner only: recent proof mails whose code matched no address, newest first; kept in memory", + "items": { + "type": "object", + "description": "Proof attempt: at, from (masked, a***@example.com), reason (code not recognized)" + } } } } @@ -897,7 +905,7 @@ "properties": { "email": { "type": "object", - "description": "Calendar email: email, proven, proven_at, code (pending proof code, own list only), code_expires_at, last_error, active (the user still has access), login (owner allowlist only)" + "description": "Calendar email: email, proven, proven_at, code (pending proof code, own list only), code_expires_at, last_error, active (the user still has access), login (owner allowlist only), last_failure (latest refused proof: reason not_aligned, from_mismatch or expired; at; from (from_mismatch only: the From address parsed, empty when missing, repeated or unparsable); from_domain, spf, spf_domain, spf_aligned, dkim [{domain, result}], dkim_aligned, dmarc, aligned; message, the reason in plain words with what to do)" }, "address": { "type": "string" diff --git a/src/docs/api-reference/knowledge.md b/src/docs/api-reference/knowledge.md index dee53ced6e..a28f2ce86b 100644 --- a/src/docs/api-reference/knowledge.md +++ b/src/docs/api-reference/knowledge.md @@ -119,7 +119,7 @@ Part of the [Dashboard REST API reference](../api-reference.md); see that page f | `POST` | `/api/meetings/persona/sample` | Owner or read-write | Speak a short line through the meetings TTS service (Kokoro `POST /v1/audio/speech`) and return the audio (`audio/mpeg`, at most 2 MiB, `Cache-Control: no-store`). Optional `{voice?, language?, display_name?, text?}` (unsaved form values; `text` at most 200 characters, default the persona's sample line in its language). 503 "TTS not configured" until `meetings.tts_url` is set, 400 invalid, 502 the TTS service failed | `pkg/dashboard/api_meetings_persona.go:166` | | `GET` | `/api/meetings/persona/sample` | Owner or read-write | The same sample with `voice`, `language`, `display_name` and `text` as query parameters, for the dashboard's `