MailMaint N.M. Jenkins, Ed. Internet-Draft Fastmail Intended status: Informational 16 October 2024 Expires: 19 April 2025 Registration of further IMAP/JMAP keywords and mailbox names draft-jenkins-mail-keywords-00 Abstract Fastmail uses a number of keywords and mailbox names to implement mail functionality that others may wish to interoperate with. This document notes what they are and how to use them, and registers them with IANA to avoid name collisions. Status of This Memo This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at https://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." This Internet-Draft will expire on 19 April 2025. Copyright Notice Copyright (c) 2024 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/ license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License. Jenkins Expires 19 April 2025 [Page 1] Internet-Draft OAuth Public October 2024 Table of Contents 1. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 2 2. IMAP/JMAP Keyword Registrations . . . . . . . . . . . . . . . 2 2.1. $notify keyword registration . . . . . . . . . . . . . . 2 2.2. $muted keyword registration . . . . . . . . . . . . . . . 3 2.3. $followed keyword registration . . . . . . . . . . . . . 4 2.4. $memo keyword registration . . . . . . . . . . . . . . . 5 2.5. $hasmemo keyword registration . . . . . . . . . . . . . . 6 2.6. $hasattachment keyword registration . . . . . . . . . . . 6 2.7. $autosent keyword registration . . . . . . . . . . . . . 7 2.8. $unsubscribed keyword registration . . . . . . . . . . . 8 2.9. $canunsubscribe keyword registration . . . . . . . . . . 8 2.10. $imported keyword registration . . . . . . . . . . . . . 9 2.11. $istrusted keyword registration . . . . . . . . . . . . . 10 2.12. $maskedemail keyword registration . . . . . . . . . . . . 10 2.13. $new keyword registration . . . . . . . . . . . . . . . . 11 3. IMAP/JMAP Mailbox Name Registrations . . . . . . . . . . . . 11 3.1. Snoozed mailbox name attribute registration . . . . . . . 12 3.2. Scheduled mailbox name attribute registration . . . . . . 12 3.3. Memos mailbox name attribute registration . . . . . . . . 12 4. Normative References . . . . . . . . . . . . . . . . . . . . 12 Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 13 1. IANA Considerations This document is all IANA considerations! A number of IMAP/JMAP keywords are registered in the IMAP/JMAP keywords registry, as established in RFC5788. It also registers three new entries for the Mailbox name attributes registry, as established in RFC8457, Section 6. 2. IMAP/JMAP Keyword Registrations 2.1. $notify keyword registration IMAP/JMAP keyword name: $notify Purpose: Indicate to the client that a notification should be shown for this message. Private or Shared on a server: SHARED Is it an advisory keyword or may it cause an automatic action: This keyword can cause automatic action. On supporting clients, when a new message is added to the mailstore with this keyword, the client should show the user a notification. Jenkins Expires 19 April 2025 [Page 2] Internet-Draft OAuth Public October 2024 Mail clients commonly show notifications for new mail, but often the only option is to show a notification for every message that arrvies in the inbox. This keyword allows the user to create rules (or the server to automatically determine) specific messages that should show a notification. Notifications for these messages may be in addition to notifications for messages matching other criteria, according to user preference set on the client. When/by whom the keyword is set/cleared: This keyword is set by an IMAP or JMAP server on delivery when a message meets criteria such that the user should be shown a notification. It may be cleared by a client when the user opens, archives, or otherwise interacts with th message. Other clients connected to the same account may choose to automatically close the notification if the flag is cleared. Related keywords: None Related IMAP capabilities: None Security considerations: None Published specification: This document Intended usage: COMMON Owner/Change controller: IESG 2.2. $muted keyword registration IMAP/JMAP keyword name: $muted Purpose: Indicate to the server that the user is not interested in future replies to a particular thread. Private or Shared on a server: SHARED Is it an advisory keyword or may it cause an automatic action: This keyword can cause automatic action. On supporting servers, when a new message arrives that is in the same thread as a message with this keyword the server may automatically process it in some way to deprioritise it for the user, for example by moving it to the archive or trash, or marking it read. The exact action, whether this is customisable by the user, and interaction with user rules is vendor specific. Jenkins Expires 19 April 2025 [Page 3] Internet-Draft OAuth Public October 2024 A message is defined to be in the same thread as another if the server assigns them both the same thread id, as defined in [RFC8474] Section 5.2 for IMAP or [RFC8621], Section 3 for JMAP. When/by whom the keyword is set/cleared: This keyword is set by an IMAP or JMAP client when the user indicates they wish to mute or unmute a thread. When unmuting a thread, the client must remove the keyword from every message in the thread that has it. Related keywords: Mutually exclusive with $followed. If both are specified on a thread, servers MUST behave as though only $followed were set. Related IMAP capabilities: None Security considerations: Muting a thread can mean a user won't see a reply. If someone compromises a user's account, they may mute threads where they don't want the user to see the reply, for example when sending phishing to the user's contacts. There are many other ways an attacker with access to the user's mailbox can also achieve this however, so this is not greatly increasing the attack surface. Published specification: This document Intended usage: COMMON Owner/Change controller: IESG 2.3. $followed keyword registration IMAP/JMAP keyword name: $followed Purpose: Indicate to the server that the user is particularly interested in future replies to a particular thread. Private or Shared on a server: SHARED Is it an advisory keyword or may it cause an automatic action: This keyword can cause automatic action. On supporting servers, when a new message arrives that is in the same thread as a message with this keyword the server may automatically process it in some way to prioritise it for the user, for example by ignoring rules that would make it skip the inbox, or automatically adding the $notify keyword. The exact action, whether this is customisable by the user, and interaction with user rules is vendor specific. Jenkins Expires 19 April 2025 [Page 4] Internet-Draft OAuth Public October 2024 A message is defined to be in the same thread as another if the server assigns them both the same thread id, as defined in [RFC8474] Section 5.2 for IMAP or [RFC8621], Section 3 for JMAP. When/by whom the keyword is set/cleared: This keyword is set by an IMAP or JMAP client when the user indicates they wish to follow or unfollow a thread. When unfollowing a thread, the client must remove the keyword from every message in the thread that has it. Related keywords: Mutually exclusive with $muted. If both are specified on a thread, servers MUST behave as though only $followed were set. Related IMAP capabilities: None Security considerations: None Published specification: This document Intended usage: COMMON Owner/Change controller: IESG 2.4. $memo keyword registration IMAP/JMAP keyword name: $memo Purpose: Indicate to the client that a message is a note-to-self from the user regarding another message in the same thread. Private or Shared on a server: SHARED Is it an advisory keyword or may it cause an automatic action: This keyword is advisory. When/by whom the keyword is set/cleared: This keyword is set by an IMAP or JMAP client when creating such a message. The message should otherwise be contructed like a reply to the message to which this memo is attached (i.e. appropriate Subject and Reply-To headers set). In supporting clients, messages with this flag may be presented differently to the user, attached to the message the memo is commenting on, and may offer the user the ability to edit or delete the memo. (As messages are immutable, editing requires replacing the message.) Related keywords: The $hasmemo keyword should be set/cleared at the same time. Jenkins Expires 19 April 2025 [Page 5] Internet-Draft OAuth Public October 2024 Related IMAP capabilities: None Security considerations: None Published specification: This document Intended usage: COMMON Owner/Change controller: IESG 2.5. $hasmemo keyword registration IMAP/JMAP keyword name: $hasmemo Purpose: Indicate to the client that a message has an associated memo with the $memo keyword. Private or Shared on a server: SHARED Is it an advisory keyword or may it cause an automatic action: This keyword is advisory. When/by whom the keyword is set/cleared: This keyword is set by an IMAP or JMAP client when creating a memo. The memo gets the $memo keyword, the message it is a note for gets the $hasmemo keyword. This keyword can help in searching for messages with memos, or deciding whether to fetch the whole thread to look for memos when loading a mailbox. Related keywords: A message with the $memo keyword should be created/ destroyed at the same time. Related IMAP capabilities: None Security considerations: None Published specification: This document Intended usage: COMMON Owner/Change controller: IESG 2.6. $hasattachment keyword registration IMAP/JMAP keyword name: $hasattachment Purpose: Indicate to the client that a message has an attachment. Jenkins Expires 19 April 2025 [Page 6] Internet-Draft OAuth Public October 2024 Private or Shared on a server: SHARED Is it an advisory keyword or may it cause an automatic action: This keyword is advisory. When/by whom the keyword is set/cleared: This keyword is set by an IMAP or JMAP server on messages it determines have an attachment. This can help mailbox clients indicate this to the user without having to fetch the full message body structure. Over JMAP, the "hasAttachment" Email property should indicate the same value. Related keywords: None Related IMAP capabilities: None Security considerations: None Published specification: This document Intended usage: COMMON Owner/Change controller: IESG 2.7. $autosent keyword registration IMAP/JMAP keyword name: $autosent Purpose: Indicate to the client that a message was sent automatically as a response due to a user rule or setting. Private or Shared on a server: SHARED Is it an advisory keyword or may it cause an automatic action: This keyword is advisory. When/by whom the keyword is set/cleared: This keyword is set by an IMAP or JMAP server on the user's copy of their vacation response and other automated messages sent on behalf of the user. Clients may use this to indicate to the user that this message was sent automatically, as if they have forgotten the rule or vacation response is set up they may be surprised to see it among their sent items. Related keywords: None Related IMAP capabilities: None Security considerations: None Jenkins Expires 19 April 2025 [Page 7] Internet-Draft OAuth Public October 2024 Published specification: This document Intended usage: COMMON Owner/Change controller: IESG 2.8. $unsubscribed keyword registration IMAP/JMAP keyword name: $unsubscribed Purpose: Indicate to the client that it has unsubscribed from the thread this message is on. Private or Shared on a server: SHARED Is it an advisory keyword or may it cause an automatic action: This keyword is advisory. When/by whom the keyword is set/cleared: This keyword is set by an IMAP or JMAP client on a message after attempting to unsubscribe from the mailing list this message came from (e.g., after attempting RFC8058 one-click List-Unsubscribe). It allows clients to remind the user that they have unsubscribed if they open the message again. Related keywords: None Related IMAP capabilities: None Security considerations: None Published specification: This document Intended usage: COMMON Owner/Change controller: IESG 2.9. $canunsubscribe keyword registration IMAP/JMAP keyword name: $canunsubscribe Purpose: Indicate to the client that this message has an RFC8058-compliant List-Unsubscribe header. Private or Shared on a server: SHARED Is it an advisory keyword or may it cause an automatic action: This keyword is advisory. Jenkins Expires 19 April 2025 [Page 8] Internet-Draft OAuth Public October 2024 When/by whom the keyword is set/cleared: This keyword is set by an IMAP or JMAP server on messages with an RFC8058-compliant List- Unsubscribe header. It may only do so if the message passes vendor- specific reputation checks. It is intended to indicate to clients that they may be able to do a one-click unsubscribe, without them having to fetch the List-Unsubscribe header to determint themself. Related keywords: None Related IMAP capabilities: None Security considerations: None Published specification: This document Intended usage: COMMON Owner/Change controller: IESG 2.10. $imported keyword registration IMAP/JMAP keyword name: $imported Purpose: Indicate to the client that this message was imported from another mailbox. Private or Shared on a server: SHARED Is it an advisory keyword or may it cause an automatic action: This keyword is advisory. When/by whom the keyword is set/cleared: This keyword is set by an IMAP or JMAP server on messages in imports from another mailbox. Related keywords: None Related IMAP capabilities: None Security considerations: None Published specification: This document Intended usage: COMMON Owner/Change controller: IESG Jenkins Expires 19 April 2025 [Page 9] Internet-Draft OAuth Public October 2024 2.11. $istrusted keyword registration IMAP/JMAP keyword name: $istrusted Purpose: Indicate to the client that the authenticity of the from name and email address have been verified with complete confidence by the server. Private or Shared on a server: SHARED Is it an advisory keyword or may it cause an automatic action: This keyword is advisory. Clients may show a verification mark (often a tick icon) on messages with this keyword to indicate their trusted status to the user. When/by whom the keyword is set/cleared: This keyword is set by an IMAP or JMAP server on messages it delivers where it wishes to confirm to the user that this is a legitimate email they can trust. It is usually only used for the mailbox provider's own messages to the customer, where they can know with absolute certainty that the friendly from name and email address are legitimate. Related keywords: None Related IMAP capabilities: None Security considerations: Servers should make sure this keyword is only set for messages that really are trusted! Published specification: This document Intended usage: COMMON Owner/Change controller: IESG 2.12. $maskedemail keyword registration IMAP/JMAP keyword name: $maskedemail Purpose: Indicate to the client that the message was received via an alias created for an individual sender. Private or Shared on a server: SHARED Is it an advisory keyword or may it cause an automatic action: This keyword is advisory. Clients may show an icon to indicate to the user this was received via a masked email address - an alias created for a specific sender to hide the user's real email address. Jenkins Expires 19 April 2025 [Page 10] Internet-Draft OAuth Public October 2024 When/by whom the keyword is set/cleared: This keyword is set by an IMAP or JMAP server on messages it delivers that arrived via such an alias. Related keywords: None Related IMAP capabilities: None Security considerations: None Published specification: This document Intended usage: LIMITED Owner/Change controller: IESG 2.13. $new keyword registration IMAP/JMAP keyword name: $new Purpose: Indicate to the client that a message should be made more prominent to the user due to a recent action. Private or Shared on a server: SHARED Is it an advisory keyword or may it cause an automatic action: This keyword is advisory. Clients may show the status of the message. When/by whom the keyword is set/cleared: This keyword is set by an IMAP or JMAP server on messages after awakening them from snooze. Clients should clear the keyword when the message is opened. Related keywords: None Related IMAP capabilities: None Security considerations: None Published specification: This document Intended usage: LIMITED Owner/Change controller: IESG 3. IMAP/JMAP Mailbox Name Registrations Jenkins Expires 19 April 2025 [Page 11] Internet-Draft OAuth Public October 2024 3.1. Snoozed mailbox name attribute registration Attribute Name: Snoozed Description: Messages that have been snoozed are moved to this mailbox until the "awaken" time, when they are moved out of it again automatically by the server. Reference: This document. Usage Notes: Snooze functionality is common among services but not yet standardised. This attribute marks the mailbox where snoozed messages may be found, but does not on its own provide a way for clients to snooze messages. 3.2. Scheduled mailbox name attribute registration Attribute Name: Scheduled Description: Messages that have been scheduled to send at a later time. Once the server has sent them at the scheduled time, they will automatically be deleted or moved from this mailbox by the server (probably to the \Sent mailbox). Reference: This document. Usage Notes: Scheduled sending functionality is common among services but not yet standardised. This attribute marks the mailbox where scheduled messages may be found, but does not on its own provide a way for clients to schedule messages for sending. 3.3. Memos mailbox name attribute registration Attribute Name: Memos Description: Messages that have the $memo keyword. Clients creating memos are recommended to store them in this mailbox. This allows them to more easily be hidden from the user as "messages", and presented only as memos instead. Reference: This document. Usage Notes: None. 4. Normative References Jenkins Expires 19 April 2025 [Page 12] Internet-Draft OAuth Public October 2024 [RFC8474] Gondwana, B., Ed., "IMAP Extension for Object Identifiers", RFC 8474, DOI 10.17487/RFC8474, September 2018, . [RFC8621] Jenkins, N. and C. Newman, "The JSON Meta Application Protocol (JMAP) for Mail", RFC 8621, DOI 10.17487/RFC8621, August 2019, . Author's Address Neil Jenkins (editor) Fastmail PO Box 234, Collins St West Melbourne VIC 8007 Australia Email: neilj@fastmailteam.com URI: https://www.fastmail.com Jenkins Expires 19 April 2025 [Page 13]