RFC 9670

JSON Meta Application Protocol (JMAP) Sharing

πŸ“… published November 2024, from ietf

JSON Meta Application Protocol (JMAP) Sharing πŸŽ€

Okay bestie, let's get into RFC 9670 πŸ’– It's a Standards Track doc from the IETF, and it's the one that gives JMAP a proper way to share data between users. The editor is N. Jenkins from Fastmail πŸ’… It was published in November 2024, with ISSN 2070-1721, and it updates RFC 8620, which is the core JMAP spec. It doesn't obsolete anything, so it's an add-on, not a replacement πŸ¦‹

Here's the cute little stuff up top 🌸

Abstract ✨

This doc spells out a data model for sharing data between users over the JSON Meta Application Protocol (JMAP). Future docs can point back to it when they define data types, so everyone's sharing model stays consistent 🫢

Status of This Memo πŸ“œ

This is an Internet Standards Track document, so it's official πŸ’…

It's a product of the Internet Engineering Task Force (IETF) and represents the consensus of the IETF community. It went through public review and got approved for publication by the Internet Engineering Steering Group (IESG). If you want more on Internet Standards, check out Section 2 of RFC 7841 🧚

For the current status, any errata, and how to give feedback, head to https://www.rfc-editor.org/info/rfc9670 πŸ”—

Copyright (c) 2024 IETF Trust and the persons identified as the document authors. All rights reserved.

This doc is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) as they stand on the publication date. Please actually read these, because they're about your rights and restrictions with this document πŸ™ˆ

Code Components pulled out of this document must include Revised BSD License text, as described in Section 4.e of the Trust Legal Provisions. They're provided without warranty, as described in the Revised BSD License πŸ’œ


Table of Contents πŸ“š

1.  Introduction
  1.1.  Notational Conventions
  1.2.  Terminology
  1.3.  Data Model Overview
  1.4.  Subscribing to Shared Data
  1.5.  Addition to the Capabilities Object
    1.5.1.  urn:ietf:params:jmap:principals
    1.5.2.  urn:ietf:params:jmap:principals:owner
2.  Principals
  2.1.  Principal/get
  2.2.  Principal/changes
  2.3.  Principal/set
  2.4.  Principal/query
    2.4.1.  Filtering
  2.5.  Principal/queryChanges
3.  ShareNotifications
  3.1.  ShareNotification/get
  3.2.  ShareNotification/changes
  3.3.  ShareNotification/set
  3.4.  ShareNotification/query
    3.4.1.  Filtering
    3.4.2.  Sorting
  3.5.  ShareNotification/queryChanges
4.  Framework for Shared Data
  4.1.  Example
5.  Internationalization Considerations
6.  Security Considerations
  6.1.  Spoofing
  6.2.  Unnoticed Sharing
  6.3.  Denial of Service
  6.4.  Unauthorized Principals
7.  IANA Considerations
  7.1.  JMAP Capability Registration for "principals"
  7.2.  JMAP Capability Registration for "principals:owner"
  7.3.  JMAP Data Type Registration for "Principal"
  7.4.  JMAP Data Type Registration for "ShareNotification"
8.  References
  8.1.  Normative References
  8.2.  Informative References
Author's Address

1. Introduction ✨

Okay so JMAP ([RFC8620]) is a generic protocol for syncing data, like mail, calendars, or contacts, between a client and a server πŸ“¬ It's built for mobile and web, and it gives you one consistent way to query, read, and modify different data types, with proper error handling too. Iconic πŸ’…

This spec is all about a data model for representing entities in a collaborative setting, plus a framework for sharing data between them. The goal is a sharing model that works across different data types. It does not define _what_ can be shared or how granular the permissions are, because that depends on the data itself πŸ¦‹

1.1. Notational Conventions πŸŽ€

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be read as described in BCP 14 [RFC2119] [RFC8174], but only when they show up in all capitals, like they do here πŸ™ˆ

Type signatures, examples, and property descriptions follow the conventions in Section 1.1 of [RFC8620]. The data types from the core spec are also used here πŸ’–

Examples of API exchanges only show the methodCalls array of the Request object or the methodResponses array of the Response object. The rest of the Request/Response object is left out to keep things compact ✨

1.2. Terminology πŸ“–

Same terminology as the core JMAP spec, so check [RFC8620], Section 1.6 if you need it 🧚

The terms "Principal" and "ShareNotification" (with this exact capitalization) refer to the data types defined in this document, as well as instances of those types πŸ’œ

1.3. Data Model Overview 🌸

A Principal (see Section 2) represents an individual, a team, or a resource, like a room or a projector 🏒 It holds info about the entity, such as a name, description, and time zone. It may also hold domain-specific info. A Principal can be linked to zero or more Accounts (see [RFC8620], Section 1.6.2) that contain data belonging to that Principal. Managing the set of Principals in a system is out of scope here, since it's super domain-specific. It'll probably map straight from a directory service or some other user management system πŸ—‚οΈ

Data types can let users share data with others by giving permissions to Principals. When a user's permissions change, a ShareNotification object gets created for them, so a client can tell the user what changed πŸ””

1.4. Subscribing to Shared Data πŸ“

Permissions tell you whether a user may access data, but not whether they want to πŸ‘€ Some shared data matters just as much as the user's own stuff, while other data is only there if they feel like going to find it. Clients usually want to tell these apart. For example, a company might share mailing list archives for every department with all employees, but a user is probably only into the few they belong to. They'd have permission to access lots of mailboxes but can subscribe to just the ones they care about. The client should give separate interfaces for reading mail in subscribed mailboxes and for browsing all the mailboxes they can access, so they can manage their subscriptions πŸ“¬

The JMAP Session object (see [RFC8620], Section 2) includes an object in the "accounts" property for every Account the user has access to. Collaborative systems can share data with a ton of Principals, and most of them don't matter to the user day to day 😭 For servers implementing this spec, the Session object MUST only include Accounts where either the user is subscribed to at least one record (see [RFC8620], Section 1.6.3) in the Account, or the Account belongs to the user. StateChange events ([RFC8620], Section 7.1) for changes to data SHOULD only be sent for data the user has subscribed to, and MUST NOT be sent for any Account where the user isn't subscribed to any records, except where that Account belongs to the user πŸ”₯

The server MAY reject the user's attempt to subscribe to some resources, even if they have permission to access them. A calendar that represents a location is a good example 🏒

A user can look up the set of Principals they can access with "Principal/query" (see Section 2.4). The Principal object will contain an Account object for every Account where the user has permission to access data for that Principal, even if they haven't subscribed yet πŸ’…

1.5. Addition to the Capabilities Object πŸŽ€

The capabilities object comes back as part of the JMAP Session object, see [RFC8620], Section 2. This document defines two additional capability URIs πŸ¦‹

1.5.1. urn:ietf:params:jmap:principals πŸ‘‘

The urn:ietf:params:jmap:principals capability represents support for the Principal and ShareNotification data types and their associated API methods ✨

In the JMAP Session capabilities property, the value of this capability is an empty object 🧚

In an Account's accountCapabilities property, the value is an object that MUST contain the following info about server capabilities and permissions for that Account:

  • currentUserPrincipalId: Id|null The id of the Principal in this Account that corresponds to the user fetching this object, if there is one πŸ’–

1.5.2. urn:ietf:params:jmap:principals:owner 🌈

The URI urn:ietf:params:jmap:principals:owner is only used as a key in an Account's accountCapabilities property. It does not show up in the JMAP Session capabilities. Support gets indicated by the urn:ietf:params:jmap:principals URI being present in the session capabilities instead 🫢

If urn:ietf:params:jmap:principals:owner is a key in an Account's accountCapabilities property, that Account (and the data in it) is owned by a Principal. Some Accounts may not be owned by a Principal, like the Account that holds the data for the Principals themselves. In that case, this property is left out πŸ™ˆ

The value of this property is an object with the following properties:

  • accountIdForPrincipal: Id The id of an Account with the urn:ietf:params:jmap:principals capability that contains the matching Principal object πŸ”‘
  • principalId: Id The id of the Principal that owns this Account πŸ‘‘

2. Principals ✨

Okay bestie, a Principal is anyone or anything that can show up in a shared space πŸ‘₯. That could be a person, a group, a location like a room ("Room 4B" πŸšͺ), a resource like a projector πŸ“½οΈ, or some other entity in a collab environment. Sharing in JMAP usually works by giving Principals rights to certain data inside an Account. So a user can let their team read their calendar πŸ“…, and that's the whole vibe.

In a shared environment like a workplace, a user might have access to a huge number of Principals 🏒✨.

Most systems give the user one Account containing Principal objects. Sometimes, like when data is pulled together from different places, there can be several Accounts with Principal objects 🧩.

A Principal object has these properties πŸ’…:

  • id: Id (immutable; server-set). The id of the Principal.
  • type: String. This MUST be one of the following values:
    • "individual": This represents a single person.
    • "group": This represents a group of other Principals.
    • "resource": This represents some resource, e.g., a projector.
    • "location": This represents a location.
    • "other": This represents some other undefined Principal.
  • name: String. The name of the Principal, e.g., "Jane Doe" or "Room 4B" πŸŽ€.
  • description: String|null. A longer description of the Principal, for example details about the facilities of a resource, or null if no description is available.
  • email: String|null. An email address for the Principal, or null if no email is available. If given, the value MUST conform to the "addr-spec" syntax, as defined in [RFC5322], Section 3.4.1.
  • timeZone: String|null. The time zone for this Principal, if known. If not null, the value MUST be a time zone name from the IANA Time Zone Database [IANA-TZDB] 🌍.
  • capabilities: String[Object] (server-set). A map of JMAP capability URIs to domain-specific information about the Principal in relation to that capability, as defined in the document that registered the capability.
  • accounts: Id[Account]|null (server-set). A map of Account id to Account object for each JMAP Account containing data for this Principal that the user has access to, or null if none.

2.1. Principal/get

This is a standard "/get" method as described in [RFC8620], Section 5.1. Nothing extra to see here, it's giving familiar πŸ¦‹.

2.2. Principal/changes

This is a standard "/changes" method as described in [RFC8620], Section 5.2.

   |  Note: Implementations backed by an external directory may be
   |  unable to calculate changes.  In this case, they will always
   |  return a "cannotCalculateChanges" error as described in the
   |  core JMAP specification.

2.3. Principal/set

This is a standard "/set" method as described in [RFC8620], Section 5.3.

Managing Principals is probably tied to a directory service or some other vendor-specific solution πŸ—οΈ. That management might happen out of band, or through an extra capability defined somewhere else. Letting users directly change properties comes with security considerations, which you'll find in Section 6, so be careful πŸ™ˆ. A server MUST reject any change it doesn't allow with a "forbidden" SetError 🚫.

If a server does support changes through this API, it SHOULD allow updates to the "name", "description", and "timeZone" properties of the Principal whose id matches the "currentUserPrincipalId" in the Account capabilities. That way, users can update their own details πŸ’–.

2.4. Principal/query

This is a standard "/query" method as described in [RFC8620], Section 5.5.

2.4.1. Filtering

A FilterCondition object has these properties, and every single one is optional 🧁:

  • accountIds: String[]. A list of Account ids. The Principal matches if any of the ids in this list are keys in the Principal's "accounts" property (i.e., if any of the Account ids belong to the Principal).
  • email: String. The email property of the Principal contains the given string.
  • name: String. The name property of the Principal contains the given string.
  • text: String. The name, email, or description property of the Principal contains the given string.
  • type: String. The type must be exactly as given to match the condition.
  • timeZone: String. The timeZone must be exactly as given to match the condition.

All given conditions in the FilterCondition object must match for the Principal to match 🎯.

Text matches for "contains" SHOULD be simple substring matches πŸ”.

2.5. Principal/queryChanges

This is a standard "/queryChanges" method as described in [RFC8620], Section 5.6.

   |  Note: Implementations backed by an external directory may be
   |  unable to calculate changes.  In this case, they will always
   |  return a "cannotCalculateChanges" error as described in the
   |  core JMAP specification.

3. ShareNotifications

Here's the tea β˜•. The ShareNotification data type records when the user's permissions to access a shared object change πŸ””. Only the server can create ShareNotifications, so users can't make them themselves. They're stored in the same Account as the Principals.

Clients can show the user their list of notifications and let them dismiss the ones they don't need 🫢. To dismiss one, use a standard "/set" call to destroy it.

The server SHOULD create a ShareNotification whenever the user's permissions change on an object. It MAY choose not to create a notification for permission changes to a group Principal, even if the user is in the group, if that's more likely to be overwhelming than helpful, or if it would create excessive notifications within the system πŸ“­.

The server MAY limit the maximum number of notifications it stores for a user. When that limit is reached, any new notification will cause the previously oldest notification to be automatically deleted πŸ—‘οΈ.

The server MAY coalesce notifications if that's appropriate, or remove notifications after a certain period of time, or once it decides they're no longer relevant ⏳.

A ShareNotification object has these properties:

  • id: String (immutable; server-set). The id of the ShareNotification.
  • created: UTCDate (immutable; server-set). The time this notification was created.
  • changedBy: Entity (immutable; server-set). Who made the change. An Entity object has these properties:
    • name: String. The name of the entity who made the change.
    • email: String|null. The email of the entity who made the change, or null if no email is available.
    • principalId: Id|null. The id of the Principal corresponding to the entity who made the change, or null if there is no associated Principal.
  • objectType: String (immutable; server-set). The name of the data type for the object whose permissions have changed, as registered in the IANA "JMAP Data Types" registry [IANA-JMAP], e.g., "Calendar" or "Mailbox" πŸ—‚οΈ.
  • objectAccountId: Id (immutable; server-set). The id of the Account where this object exists.
  • objectId: Id (immutable; server-set). The id of the object that this notification is about.
  • oldRights: String[Boolean]|null (immutable; server-set). The "myRights" property of the object for the user before the change.
  • newRights: String[Boolean]|null (immutable; server-set). The "myRights" property of the object for the user after the change.
  • name: String (immutable; server-set). The name of the object at the time the notification was made. How you figure out the name depends on the data type in question. For example, it might be the "title" property of a CalendarEvent or the "name" of a Mailbox. The name is there to show users who've lost access to an object what it is they can no longer get to 😭.

3.1. ShareNotification/get

This is a standard "/get" method as described in [RFC8620], Section 5.1.

3.2. ShareNotification/changes

This is a standard "/changes" method as described in [RFC8620], Section 5.2.

3.3. ShareNotification/set

This is a standard "/set" method as described in [RFC8620], Section 5.3.

Only destroy is supported. Any attempt to create or update MUST be rejected with a "forbidden" SetError πŸ™…β€β™€οΈ.

3.4. ShareNotification/query

This is a standard "/query" method as described in [RFC8620], Section 5.5.

3.4.1. Filtering

A FilterCondition object has these properties, all optional πŸ’«:

  • after: UTCDate|null. The creation date must be on or after this date to match the condition.
  • before: UTCDate|null. The creation date must be before this date to match the condition.
  • objectType: String. The objectType value must be identical to the given value to match the condition.
  • objectAccountId: Id. The objectAccountId value must be identical to the given value to match the condition.

All given conditions in the FilterCondition object must match for the ShareNotification to match 🎯.

3.4.2. Sorting

The "created" property MUST be supported for sorting ⏰.

3.5. ShareNotification/queryChanges

This is a standard "/queryChanges" method as described in [RFC8620], Section 5.6.

4. Framework for Shared Data ✨

Shareable data types MUST define the following three properties πŸ‘‘:

  • isSubscribed: Boolean. The value true indicates that the user wishes to subscribe to see this data. The value false indicates that the user does not wish to subscribe to see this data. The initial value for this property when data is shared by another user is implementation dependent, although data types may give advice on appropriate defaults 🌸.
  • myRights: String[Boolean]. The set of permissions the user currently has. Appropriate permissions are domain specific and must be defined per data type. Each key is the name of a permission defined for that data type. The value for the key is true if the user has the permission or false if they do not πŸ”.
  • shareWith: Id[String[Boolean]]|null. The value of this property is null if the data is not shared with anyone. Otherwise, it is a map where each key is the id of a Principal with which this data is shared, and the value associated with that key is the rights to give that Principal, in the same format as the "myRights" property. The Account id for the Principal id can be found in the capabilities of the Account this object is in (see Section 1.5.2) πŸ¦‹.

Users with appropriate permission may set this property to modify who the data is shared with. The Principal that owns the Account that this data is in MUST NOT be in the map, since the owner's rights are implicit πŸ‘‘βœ¨.

4.1. Example πŸŽ€

Okay so picture this: we're designing a data model for a super simple to-do list πŸ“πŸŒΈ There's a Todo data type for one item to do, and each Todo belongs to a single TodoList. The spec makes TodoLists shareable by referencing this document and defining the common properties ✨

First, it defines a set of domain-specific rights πŸ’… A TodoListRights object may have these properties:

  • mayRead: Boolean. The user may fetch this TodoList and any Todos that belong to this TodoList. πŸ“–
  • mayWrite: Boolean. The user may create, update, or destroy Todos that belong to this TodoList, and may change the "name" property of this TodoList. ✏️
  • mayAdmin: Boolean. The user may see and modify the "myRights" property of this TodoList, and may destroy this TodoList. πŸ‘‘

Then, in the TodoList data type, we include the three common properties from Section 4, plus any type-specific properties (like "name" here) 🧚

  • id: Id (immutable; server-set). The id of the object.
  • name: String. A name for this list of Todos.
  • isSubscribed: Boolean. True if the user has indicated they wish to see this list. If false, clients should not display this TodoList with the user's other TodoLists, but should provide a way for users to see and subscribe to all TodoLists that have been shared with them. 🫢
  • myRights: TodoListRights. The set of permissions the user currently has for this TodoList.
  • shareWith: Id[TodoListRights]|null. If it isn't shared with anyone, the value is null. Otherwise it's a map where the keys are Principal ids and the values are the rights given to those Principals. Users with the "mayAdmin" right may set this property to change who the data is shared with. The Principal that owns the Account this data lives in MUST NOT be in the map, since their rights are implicit πŸ”₯

We'd also define a new Principal capability with two properties:

  • accountId: Id|null. The accountId containing the Todo data for this Principal, if it has been shared with the requesting user.
  • mayShareWith: Boolean. The user may give this Principal permission to access a TodoList.

A client that wants to let the user configure sharing looks at the "capabilities" for the Account containing the user's Todo data, and finds the urn:ietf:params:jmap:principals:owner property, as per Section 1.5.2 πŸ¦‹ For example, the JMAP Session object might contain:

{
  "accounts": {
    "u12345678": {
      "name": "jane.doe@example.com",
      "isPersonal": true,
      "isReadOnly": false,
      "accountCapabilities": {
        "urn:com.example:jmap:todo": {},
        "urn:ietf:params:jmap:principals:owner": {
          "accountIdForPrincipal": "u33084183",
          "principalId": "P105aga511jaa"
        }
      }
    },
    ...
  },
  ...
}

Figure 1: Part of a JMAP Session Object

From this, the client now knows which Account has the Principal data, so it can fetch the list of Principals and offer to share with the user by making an API request like this πŸ’–

[[ "Principal/get", {
  "accountId": "u33084183",
  "ids": null
}, "0" ]]

Figure 2: "methodCalls" Property of a JMAP Request

Here's an example response (where "Joe Bloggs" is another user this user could share their TodoList with). Joe hasn't shared any of his own data with this user, so the "accounts" property is null 🌈

[[ "Principal/get", {
  "accountId": "u33084183",
  "state": "7b8eff5zz",
  "list": [{
    "id": "P2342fnddd20",
    "type": "individual",
    "name": "Joe Bloggs",
    "description": null,
    "email": "joe.bloggs@example.com",
    "timeZone": "Australia/Melbourne",
    "capabilities": {
        "urn:com.example:jmap:todo": {
            "accountId": null,
            "mayShareWith": true
        }
    },
    "accounts": null
  }, {
    "id": "P674pp24095qo49pr",
    "name": "Board room",
    "type": "location",
    ...
  }, ... ],
  "notFound": []
}, "0" ]]

Figure 3: "methodResponses" Property of a JMAP Response

And to share a TodoList with "Joe Bloggs", we update its shareWith property, like in this example request πŸ“

[[ "TodoList/set", {
  "accountId": "u12345678",
  "update": {
    "tl01n231": {
        "shareWith": {
            "P2342fnddd20": {
                "mayRead": true,
                "mayWrite": true,
                "mayAdmin": false
            }
        }
    }
  }
}, "0" ]]

Figure 4: "methodCalls" Property of a JMAP Request


5. Internationalization Considerations 🌍

Experience has shown that letting Unicode run totally unrestricted can cause problems, like inconsistent rendering, users reading text and understanding it differently than intended, and weird results when copying text from one place to another 😭 Servers MAY choose to mitigate this by restricting the set of characters allowed in otherwise unconstrained String fields. The FreeformClass, documented in [RFC8264], Section 4.3, might be a good starting point for this ✨

Attempts to set a value containing code points outside the permissible set can be handled in a few ways by the server. The first option is to just strip the forbidden characters and store the resulting string. This is likely to be right for control characters, for example, which can sneak into data by accident through copy-and-paste and are probably invisible to the end user πŸ™ˆ JMAP lets the server transform data on create/update, as long as any changed properties are returned to the client in the "/set" response, so it knows what changed, as per [RFC8620], Section 5.3. Alternatively, the server MAY just reject the create/update with an invalidProperties SetError πŸ’…


6. Security Considerations 🚨

All security considerations of JMAP [RFC8620] apply to this specification, and the additional considerations are detailed below. This section is serious business, bestie πŸ’€

6.1. Spoofing

Letting users edit their own Principal's name (and, to a lesser extent, email, description, or type) could let a user change their Principal to look like another user in the system, which could trick others into sharing private data with them 😱 Servers may choose to forbid this, and SHOULD keep logs of such changes to provide an audit trail.

Simply forbidding a name that's already in the system is NOT enough protection. A malicious user could still change their name to something easily confused with the existing one, using trivial misspellings or visually similar Unicode characters.

6.2. Unnoticed Sharing

Sharing data with another user lets someone turn a transitory account compromise (like brief access to an unlocked or logged-in client) into a persistent one, by setting up sharing with a user the attacker controls 🫣 This can be mitigated by requiring further authorization for configuring sharing, or by sending notifications to the sharer via another channel whenever a new permission is added.

6.3. Denial of Service

By creating lots of changes to the sharing status of objects, a user can cause lots of ShareNotifications to be generated, which could lead to resource exhaustion πŸŒͺ️ Servers can mitigate this by coalescing multiple changes to the same object into a single notification, limiting the maximum number of notifications stored per user, and/or rate-limiting changes to sharing permissions in the first place. Automatically deleting older notifications after reaching a limit can mean the user never learns about a sharing change, and that can itself be a security issue. For this reason, coalescing changes and using other mitigation strategies is the better move 🧠

6.4. Unauthorized Principals

The set of Principals within a shared environment MUST be strictly controlled. If adding a new Principal is open to the public, the risks include:

  • An increased risk of a user accidentally sharing data with an unintended person.
  • An attacker sharing unwanted or offensive information with the user.
  • An attacker sharing items with spam content in the names, in order to generate ShareNotification objects, which are likely to be prominently displayed to the user receiving them 🚫

7. IANA Considerations πŸ¦‹

7.1. JMAP Capability Registration for "principals"

IANA has registered "principals" in the "JMAP Capabilities" registry as follows:

Capability Name:  urn:ietf:params:jmap:principals
Intended Use:  common
Change Controller:  IETF
Security and Privacy Considerations:  RFC 9670, Section 6
Reference:  RFC 9670

7.2. JMAP Capability Registration for "principals:owner"

IANA has registered "principals:owner" in the "JMAP Capabilities" registry as follows:

Capability Name:  urn:ietf:params:jmap:principals:owner
Intended Use:  common
Change Controller:  IETF
Security and Privacy Considerations:  RFC 9670, Section 6
Reference:  RFC 9670

7.3. JMAP Data Type Registration for "Principal"

IANA has registered "Principal" in the "JMAP Data Types" registry as follows:

Type Name:  Principal
Can Reference Blobs:  No
Can Use for State Change:  Yes
Capability:  urn:ietf:params:jmap:principals
Reference:  RFC 9670

7.4. JMAP Data Type Registration for "ShareNotification"

IANA has registered "ShareNotification" in the "JMAP Data Types" registry as follows:

Type Name:  ShareNotification
Can Reference Blobs:  No
Can Use for State Change:  Yes
Capability:  urn:ietf:params:jmap:principals
Reference:  RFC 9670

8. References πŸ“š

8.1. Normative References

[RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
           Requirement Levels", BCP 14, RFC 2119,
           DOI 10.17487/RFC2119, March 1997,
           <https://www.rfc-editor.org/info/rfc2119>.

[RFC5322]  Resnick, P., Ed., "Internet Message Format", RFC 5322,
           DOI 10.17487/RFC5322, October 2008,
           <https://www.rfc-editor.org/info/rfc5322>.

[RFC8174]  Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC
           2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174,
           May 2017, <https://www.rfc-editor.org/info/rfc8174>.

[RFC8620]  Jenkins, N. and C. Newman, "The JSON Meta Application
           Protocol (JMAP)", RFC 8620, DOI 10.17487/RFC8620, July
           2019, <https://www.rfc-editor.org/info/rfc8620>.

8.2. Informative References

[IANA-JMAP]
           IANA, "JMAP Data Types",
           <https://www.iana.org/assignments/jmap>.

[IANA-TZDB]
           IANA, "Time Zone Database",
           <https://www.iana.org/time-zones>.

[RFC8264]  Saint-Andre, P. and M. Blanchet, "PRECIS Framework:
           Preparation, Enforcement, and Comparison of
           Internationalized Strings in Application Protocols",
           RFC 8264, DOI 10.17487/RFC8264, October 2017,
           <https://www.rfc-editor.org/info/rfc8264>.

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
πŸ“¦ where this page comes from