Network Working Group P. M. Hallam-Baker Internet-Draft ThresholdSecrets.com Intended status: Informational 2 November 2020 Expires: 6 May 2021 Mathematical Mesh 3.0 Part IV: Schema Reference draft-hallambaker-mesh-schema-06 Abstract The Mathematical Mesh 'The Mesh' is an end-to-end secure infrastructure that facilitates the exchange of configuration and credential data between multiple user devices. The core protocols of the Mesh are described with examples of common use cases and reference data. [Note to Readers] Discussion of this draft takes place on the MATHMESH mailing list (mathmesh@ietf.org), which is archived at https://mailarchive.ietf.org/arch/search/?email_list=mathmesh. This document is also available online at http://mathmesh.com/Documents/draft-hallambaker-mesh-schema.html. 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 6 May 2021. Copyright Notice Copyright (c) 2020 IETF Trust and the persons identified as the document authors. All rights reserved. Hallam-Baker Expires 6 May 2021 [Page 1] Internet-Draft Mesh Schema Reference November 2020 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. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 5 2. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 6 2.1. Requirements Language . . . . . . . . . . . . . . . . . . 6 2.2. Defined Terms . . . . . . . . . . . . . . . . . . . . . . 6 2.3. Related Specifications . . . . . . . . . . . . . . . . . 6 2.4. Implementation Status . . . . . . . . . . . . . . . . . . 6 3. Actors . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3.1. Accounts . . . . . . . . . . . . . . . . . . . . . . . . 7 3.2. Device . . . . . . . . . . . . . . . . . . . . . . . . . 9 3.2.1. Activation . . . . . . . . . . . . . . . . . . . . . 11 3.3. Service . . . . . . . . . . . . . . . . . . . . . . . . . 13 4. Catalogs . . . . . . . . . . . . . . . . . . . . . . . . . . 14 4.1. Access . . . . . . . . . . . . . . . . . . . . . . . . . 15 4.2. Application . . . . . . . . . . . . . . . . . . . . . . . 16 4.2.1. Mesh Account . . . . . . . . . . . . . . . . . . . . 16 4.2.2. SSH . . . . . . . . . . . . . . . . . . . . . . . . . 16 4.2.3. Mail . . . . . . . . . . . . . . . . . . . . . . . . 17 4.3. Bookmark . . . . . . . . . . . . . . . . . . . . . . . . 17 4.4. Contact . . . . . . . . . . . . . . . . . . . . . . . . . 17 4.5. Credential . . . . . . . . . . . . . . . . . . . . . . . 21 4.6. Device . . . . . . . . . . . . . . . . . . . . . . . . . 21 4.7. Network . . . . . . . . . . . . . . . . . . . . . . . . . 21 4.8. Publication . . . . . . . . . . . . . . . . . . . . . . . 21 4.9. Task . . . . . . . . . . . . . . . . . . . . . . . . . . 22 5. Spools . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 5.1. Outbound . . . . . . . . . . . . . . . . . . . . . . . . 23 5.2. Inbound . . . . . . . . . . . . . . . . . . . . . . . . . 23 5.3. Local . . . . . . . . . . . . . . . . . . . . . . . . . . 23 6. Cryptographic Operations . . . . . . . . . . . . . . . . . . 24 6.1. Key Derivation from Seed . . . . . . . . . . . . . . . . 24 6.2. Message Response Identifier . . . . . . . . . . . . . . . 24 6.3. Proof of Knowledge of PIN . . . . . . . . . . . . . . . . 25 6.4. EARL . . . . . . . . . . . . . . . . . . . . . . . . . . 27 6.5. Key Agreement . . . . . . . . . . . . . . . . . . . . . . 27 6.6. Service Cryptographic Operations . . . . . . . . . . . . 28 7. Mesh Assertions . . . . . . . . . . . . . . . . . . . . . . . 28 7.1. Encoding . . . . . . . . . . . . . . . . . . . . . . . . 29 7.2. Mesh Profiles . . . . . . . . . . . . . . . . . . . . . . 30 7.3. Mesh Connections . . . . . . . . . . . . . . . . . . . . 30 8. Architecture . . . . . . . . . . . . . . . . . . . . . . . . 31 Hallam-Baker Expires 6 May 2021 [Page 2] Internet-Draft Mesh Schema Reference November 2020 8.1. Device Management . . . . . . . . . . . . . . . . . . . . 32 8.1.1. Master Profile . . . . . . . . . . . . . . . . . . . 32 8.1.2. Mesh Devices . . . . . . . . . . . . . . . . . . . . 34 8.2. Mesh Accounts . . . . . . . . . . . . . . . . . . . . . . 35 8.2.1. Creating a ProfileAccount . . . . . . . . . . . . . . 36 8.2.2. Connecting a Device to an Account . . . . . . . . . . 36 8.2.3. Binding and Account to a Service . . . . . . . . . . 37 8.3. Mesh Services . . . . . . . . . . . . . . . . . . . . . . 37 8.3.1. Creating a ProfileService . . . . . . . . . . . . . . 37 8.3.2. Creating a ProfileHost . . . . . . . . . . . . . . . 38 8.3.3. Creating a ConnectionHost . . . . . . . . . . . . . . 38 8.4. Mesh Messaging . . . . . . . . . . . . . . . . . . . . . 38 8.4.1. Traffic Analysis . . . . . . . . . . . . . . . . . . 39 9. Mesh Messages . . . . . . . . . . . . . . . . . . . . . . . . 40 9.1. PIN . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 9.2. Completion . . . . . . . . . . . . . . . . . . . . . . . 40 9.3. Connection . . . . . . . . . . . . . . . . . . . . . . . 41 9.4. Contact . . . . . . . . . . . . . . . . . . . . . . . . . 48 9.5. Confirmation . . . . . . . . . . . . . . . . . . . . . . 51 10. Publications . . . . . . . . . . . . . . . . . . . . . . . . 52 10.1. Contact Exchange . . . . . . . . . . . . . . . . . . . . 52 10.2. Device Preconfiguration . . . . . . . . . . . . . . . . 52 11. Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 11.1. Shared Classes . . . . . . . . . . . . . . . . . . . . . 54 11.1.1. Classes describing keys . . . . . . . . . . . . . . 54 11.1.2. Structure: KeyData . . . . . . . . . . . . . . . . . 54 11.1.3. Structure: CompositePrivate . . . . . . . . . . . . 55 11.2. Assertion classes . . . . . . . . . . . . . . . . . . . 55 11.2.1. Structure: Assertion . . . . . . . . . . . . . . . . 55 11.2.2. Structure: Condition . . . . . . . . . . . . . . . . 55 11.2.3. Base Classes . . . . . . . . . . . . . . . . . . . . 55 11.2.4. Structure: Connection . . . . . . . . . . . . . . . 56 11.2.5. Structure: Activation . . . . . . . . . . . . . . . 56 11.2.6. Structure: ActivationEntry . . . . . . . . . . . . . 56 11.2.7. Mesh Profile Classes . . . . . . . . . . . . . . . . 56 11.2.8. Structure: Profile . . . . . . . . . . . . . . . . . 56 11.2.9. Structure: ProfileDevice . . . . . . . . . . . . . . 56 11.2.10. Structure: ProfileAccount . . . . . . . . . . . . . 57 11.2.11. Structure: ProfileUser . . . . . . . . . . . . . . . 57 11.2.12. Structure: ProfileGroup . . . . . . . . . . . . . . 58 11.2.13. Structure: ProfileService . . . . . . . . . . . . . 58 11.2.14. Structure: ProfileHost . . . . . . . . . . . . . . . 58 11.2.15. Connection Assertions . . . . . . . . . . . . . . . 58 11.2.16. Structure: ConnectionDevice . . . . . . . . . . . . 58 11.2.17. Structure: ConnectionApplication . . . . . . . . . . 59 11.2.18. Structure: ConnectionGroup . . . . . . . . . . . . . 59 11.2.19. Structure: ConnectionService . . . . . . . . . . . . 59 11.2.20. Structure: ConnectionHost . . . . . . . . . . . . . 59 Hallam-Baker Expires 6 May 2021 [Page 3] Internet-Draft Mesh Schema Reference November 2020 11.2.21. Activation Assertions . . . . . . . . . . . . . . . 59 11.2.22. Structure: ActivationDevice . . . . . . . . . . . . 59 11.2.23. Structure: ActivationAccount . . . . . . . . . . . . 60 11.2.24. Structure: ActivationApplication . . . . . . . . . . 60 11.3. Data Structures . . . . . . . . . . . . . . . . . . . . 60 11.3.1. Structure: Contact . . . . . . . . . . . . . . . . . 60 11.3.2. Structure: Anchor . . . . . . . . . . . . . . . . . 61 11.3.3. Structure: TaggedSource . . . . . . . . . . . . . . 61 11.3.4. Structure: ContactGroup . . . . . . . . . . . . . . 61 11.3.5. Structure: ContactPerson . . . . . . . . . . . . . . 61 11.3.6. Structure: ContactOrganization . . . . . . . . . . . 61 11.3.7. Structure: OrganizationName . . . . . . . . . . . . 62 11.3.8. Structure: PersonName . . . . . . . . . . . . . . . 62 11.3.9. Structure: NetworkAddress . . . . . . . . . . . . . 62 11.3.10. Structure: NetworkProtocol . . . . . . . . . . . . . 63 11.3.11. Structure: Role . . . . . . . . . . . . . . . . . . 63 11.3.12. Structure: Location . . . . . . . . . . . . . . . . 63 11.3.13. Structure: Bookmark . . . . . . . . . . . . . . . . 63 11.3.14. Structure: Reference . . . . . . . . . . . . . . . . 64 11.3.15. Structure: Task . . . . . . . . . . . . . . . . . . 64 11.4. Catalog Entries . . . . . . . . . . . . . . . . . . . . 64 11.4.1. Structure: CatalogedEntry . . . . . . . . . . . . . 64 11.4.2. Structure: CatalogedDevice . . . . . . . . . . . . . 65 11.4.3. Structure: CatalogedPublication . . . . . . . . . . 65 11.4.4. Structure: CatalogedCredential . . . . . . . . . . . 66 11.4.5. Structure: CatalogedNetwork . . . . . . . . . . . . 66 11.4.6. Structure: CatalogedContact . . . . . . . . . . . . 66 11.4.7. Structure: CatalogedAccess . . . . . . . . . . . . . 66 11.4.8. Structure: CryptographicCapability . . . . . . . . . 66 11.4.9. Structure: CapabilityDecrypt . . . . . . . . . . . . 67 11.4.10. Structure: CapabilityDecryptPartial . . . . . . . . 67 11.4.11. Structure: CapabilityDecryptServiced . . . . . . . . 67 11.4.12. Structure: CapabilitySign . . . . . . . . . . . . . 67 11.4.13. Structure: CapabilityKeyGenerate . . . . . . . . . . 68 11.4.14. Structure: CapabilityFairExchange . . . . . . . . . 68 11.4.15. Structure: CatalogedBookmark . . . . . . . . . . . . 68 11.4.16. Structure: CatalogedTask . . . . . . . . . . . . . . 68 11.4.17. Structure: CatalogedApplication . . . . . . . . . . 68 11.4.18. Structure: CatalogedMember . . . . . . . . . . . . . 69 11.4.19. Structure: CatalogedGroup . . . . . . . . . . . . . 69 11.4.20. Structure: CatalogedApplicationSSH . . . . . . . . . 69 11.4.21. Structure: CatalogedApplicationMail . . . . . . . . 69 11.4.22. Structure: CatalogedApplicationNetwork . . . . . . . 69 11.5. Publications . . . . . . . . . . . . . . . . . . . . . . 69 11.5.1. Structure: DevicePreconfiguration . . . . . . . . . 69 11.6. Messages . . . . . . . . . . . . . . . . . . . . . . . . 70 11.6.1. Structure: Message . . . . . . . . . . . . . . . . . 70 11.6.2. Structure: MessageError . . . . . . . . . . . . . . 70 Hallam-Baker Expires 6 May 2021 [Page 4] Internet-Draft Mesh Schema Reference November 2020 11.6.3. Structure: MessageComplete . . . . . . . . . . . . . 70 11.6.4. Structure: MessagePinValidated . . . . . . . . . . . 70 11.6.5. Structure: MessagePin . . . . . . . . . . . . . . . 70 11.6.6. Structure: RequestConnection . . . . . . . . . . . . 71 11.6.7. Structure: AcknowledgeConnection . . . . . . . . . . 71 11.6.8. Structure: RespondConnection . . . . . . . . . . . . 71 11.6.9. Structure: MessageContact . . . . . . . . . . . . . 72 11.6.10. Structure: GroupInvitation . . . . . . . . . . . . . 72 11.6.11. Structure: RequestConfirmation . . . . . . . . . . . 72 11.6.12. Structure: ResponseConfirmation . . . . . . . . . . 72 11.6.13. Structure: RequestTask . . . . . . . . . . . . . . . 72 11.6.14. Structure: MessageClaim . . . . . . . . . . . . . . 72 11.6.15. Structure: ProcessResult . . . . . . . . . . . . . . 73 12. Security Considerations . . . . . . . . . . . . . . . . . . . 73 13. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 73 14. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 73 15. Appendix A: Example Container Organization (not normative) . 73 15.1. Device . . . . . . . . . . . . . . . . . . . . . . . . . 73 15.1.1. Creating a new Mesh . . . . . . . . . . . . . . . . 74 15.1.2. Adding an Account . . . . . . . . . . . . . . . . . 74 15.1.3. Adding a Device . . . . . . . . . . . . . . . . . . 74 15.2. Service . . . . . . . . . . . . . . . . . . . . . . . . 74 15.2.1. Creating a Service . . . . . . . . . . . . . . . . . 74 15.2.2. Adding an Account . . . . . . . . . . . . . . . . . 74 16. Appendix B: Collected Authentication and Encryption Requirements . . . . . . . . . . . . . . . . . . . . . . . . 74 16.1. Mesh Messaging . . . . . . . . . . . . . . . . . . . . . 75 17. Normative References . . . . . . . . . . . . . . . . . . . . 75 18. Informative References . . . . . . . . . . . . . . . . . . . 76 1. Introduction This document describes the data structures of the Mathematical Mesh with illustrative examples. For an overview of the Mesh objectives and architecture, consult the accompanying _Architecture Guide_ [draft-hallambaker-mesh-architecture]. For information on the implementation of the Mesh Service protocol, consult the accompanying _Protocol Reference_ [draft-hallambaker-mesh-protocol] This document has two main sections. The first section presents examples of the Mesh assertions, catalog entry and messages in use. The second section contains the schema reference. All the material in both sections is generated from the Mesh reference implementation [draft-hallambaker-mesh-developer]. Although some of the services described in this document could be used to replace existing Internet protocols including FTP and SMTP, the principal value of any communication protocol lies in the size of Hallam-Baker Expires 6 May 2021 [Page 5] Internet-Draft Mesh Schema Reference November 2020 the audience it allows them to communicate with. Thus, while the Mesh Messaging service is designed to support efficient and reliable transfer of messages ranging in size from a few bytes to multiple terabytes, the near-term applications of these services will be to applications that are not adequately supported by existing protocols if at all. 2. Definitions This section presents the related specifications and standard, the terms that are used as terms of art within the documents and the terms used as requirements language. 2.1. Requirements Language The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119]. 2.2. Defined Terms The terms of art used in this document are described in the _Mesh Architecture Guide_ [draft-hallambaker-mesh-architecture]. 2.3. Related Specifications The architecture of the Mathematical Mesh is described in the _Mesh Architecture Guide_ [draft-hallambaker-mesh-architecture]. The Mesh documentation set and related specifications are described in this document. 2.4. Implementation Status The implementation status of the reference code base is described in the companion document [draft-hallambaker-mesh-developer]. 3. Actors The Mesh mediates interactions between three principal actors: *Accounts*, *Devices*, and *Services*. Hallam-Baker Expires 6 May 2021 [Page 6] Internet-Draft Mesh Schema Reference November 2020 Currently two account types are specified, *user accounts* which belong to an individual user and *group accounts* that are used to share access to confidential information between a group of users. It may prove useful to define new types of account over time or to eliminate the distinction entirely. When active a Mesh account is bound to a Mesh Service. The service to which an account is bound MAY be changed over time but an account can only be bound to a single service at a time. A Mesh account is an abstract construct that (when active) is instantiated across one or more physical machines called a device. Each device that is connected to an account has a separate set of cryptographic keys that are used to interact with other devices connected to the account and MAY be provisioned with access to the account private keys which MAY or MAY NOT be mediated by the current Mesh Service. A Mesh Service is an abstract construct that is provided by one or more physical machines called Hosts. A Mesh Host is a device that is attached to a service rather than an account. 3.1. Accounts A Mesh Account is described by a Profile descended from Profile Account and contains a set of Mesh stores. Currently two account profiles are defined: ProfileUser Describes a user account. ProfileGroup Describes a group account used to share confidential information between a group of users. Both types of profile specify the following fields: ProfileSignature The public signature key used to authenticate the profile itself AccountAddress The account name to which the account is currently bound. (e.g. "alice@example.com", "@alice"). ServiceUdf If the account is active, specifies the fingerprint of the service profile to which the account is currently bound. AdministratorSignature The public signature key used to verify administrative actions on the account. In particular addition of devices to a user account or members to a group account. AccountEncryption The public encryption key for the account. All Hallam-Baker Expires 6 May 2021 [Page 7] Internet-Draft Mesh Schema Reference November 2020 messages sent to the account MUST be encrypted under this key. By definition, all data encrypted under this account is encrypted under this key. User accounts specify two additional public keys, "AccountSignature" and "AccountAuthentication" which allow signature and authentication operations under the account context. Every account contains a set of catalogs and spools that are managed by the service as directed by the contents of the associated "Access" catalog. For example, the personal account profile Alice created is: Hallam-Baker Expires 6 May 2021 [Page 8] Internet-Draft Mesh Schema Reference November 2020 { "ProfileUser":{ "ProfileSignature":{ "Udf":"MAIH-QF2M-PVD3-NQJO-CWGX-G67S-JYEQ", "PublicParameters":{ "PublicKeyECDH":{ "crv":"Ed448", "Public":"LP6f4A0WTGxBGwVQxHEdm0nZEWk3_OlsDscWs9QjGMT82ka 7_TDJEqQ_pGto8260PD7AXEdsxUUA"}}}, "AccountAddress":"alice@example.com", "ServiceUdf":"MBSL-H45P-PM3W-NTYI-NMKG-L46T-5HWM", "AccountEncryption":{ "Udf":"MC2D-WX25-JK5S-6R7R-NPK5-XNQ7-O334", "PublicParameters":{ "PublicKeyECDH":{ "crv":"X448", "Public":"aBbYhik-VDUPmZ3Xh7N5Lppkn_f504MN6-YWmMnQAyiIJnK aWvPTTA889IgD3dx3GfBHmLj1iXMA"}}}, "AdministratorSignature":{ "Udf":"MAIH-QF2M-PVD3-NQJO-CWGX-G67S-JYEQ", "PublicParameters":{ "PublicKeyECDH":{ "crv":"Ed448", "Public":"LP6f4A0WTGxBGwVQxHEdm0nZEWk3_OlsDscWs9QjGMT82ka 7_TDJEqQ_pGto8260PD7AXEdsxUUA"}}}, "AccountAuthentication":{ "Udf":"MAGU-WLGH-QX7L-RQKS-KHP4-C5LR-5RG2", "PublicParameters":{ "PublicKeyECDH":{ "crv":"X448", "Public":"yoIi0dvQBNI4UtiUCA5LvYBirDHjlEQXHOgzV4ktsqQKPwh -lN4cEjCIinyi8J5GU_R94CF5he0A"}}}, "AccountSignature":{ "Udf":"MBVN-UC2H-EKC2-GLZA-CLSC-6XQ2-QZIA", "PublicParameters":{ "PublicKeyECDH":{ "crv":"Ed448", "Public":"EvPYHGRCJsZ0kmbBMu_sxcGuUIOHFXc4iz0oCyY19fpYUG5 qJyn467Wq85zuVWviBl8zd3-9X_wA"}}}}} 3.2. Device Every Mesh device has a set of private keys that are unique to that device. These keys MAY be installed during manufacture, installed from an external source after manufacture or generated on the device. If the platform capabilities allow, device private keys SHOULD be bound to the device so that they cannot be extracted or exported without substantial effort. Hallam-Baker Expires 6 May 2021 [Page 9] Internet-Draft Mesh Schema Reference November 2020 The public keys corresponding to the device private keys are specified in a ProfileDevice. This MUST contain at least the following fields: ProfileSignature The public signature key used to authenticate the profile itself. BaseEncryption Public encryption key used as a share contribution to generation of device encryption keys to be used in the context of an account and to decrypt data during the process of connecting to an account. BaseAuthentication Public authentication key used as a share contribution to generation of device authentication keys to be used in the context of an account and to authenticate the device to a service during the process of connecting to an account. BaseSignature Public signature key used as a share contribution to generation of device authentication keys to be used in the context of an account. For example, the device profile corresponding to Alice's coffee pot device is: Hallam-Baker Expires 6 May 2021 [Page 10] Internet-Draft Mesh Schema Reference November 2020 { "ProfileDevice":{ "ProfileSignature":{ "Udf":"MCQ7-FFN4-3WCY-NDYU-CPFQ-XFH4-EHNV", "PublicParameters":{ "PublicKeyECDH":{ "crv":"Ed448", "Public":"dyQgDeZX0Y7u5FElerLbzFhbGUTj3jrkO5biutnd9CuhtUP npNM7UDTk5otmloreiJ9OBln70L0A"}}}, "BaseEncryption":{ "Udf":"MAFF-4P54-ORYF-SBAN-6XQ7-CO6S-OXWQ", "PublicParameters":{ "PublicKeyECDH":{ "crv":"X448", "Public":"7rEjlTclEPAoytZLGJbf5-eO8mBWLlNaevJ3YAt_aRhJAhe -ROYL_ASfBuKEL9d0O8pCDlWzwA2A"}}}, "BaseAuthentication":{ "Udf":"MANB-DYXE-7CNC-W6LW-3R6I-BLAB-2TKC", "PublicParameters":{ "PublicKeyECDH":{ "crv":"X448", "Public":"BoY_wxLtxK1MsFOhOEs8LkY6HY6N6x46i0L_MJLMAMkqwsA yiymRk6pV4vvtCc6DzBO8LF_MWYgA"}}}, "BaseSignature":{ "Udf":"MAW7-YIO3-5A7M-55YU-OZ7W-BJFT-QTHW", "PublicParameters":{ "PublicKeyECDH":{ "crv":"Ed448", "Public":"Psf8tojE6O4Q7JYBXe4r-bdLQdy4E8tzMTE3ADCs4OwXKyn WrvlqO7cyGcX1Wn6bd2V5hLF48R8A"}}}}} 3.2.1. Activation The device private keys are only used to perform cryptographic operations during the process of connecting a device to an account. During that connection process, a threshold key generation scheme is used to generate a second set of device keys bound to the account by combining the base key held by the device with a second device private key provided by the administration device approving the connection of the device to the account. The resulting key is referred to as the device key. The process of combining the base keys with the contributions to form the device keys is called Activation. The activation record for Alice's coffee pot device is: Hallam-Baker Expires 6 May 2021 [Page 11] Internet-Draft Mesh Schema Reference November 2020 { "ActivationDevice":{ "ActivationKey":"ZAAQ-GBHF-AKLZ-WMGO-NWLQ-CYAB-ZLLY-6MLD-6QYJ-6 MR3-A4OV-YHMH-JLL7-URSL", "AccountUdf":"MCQ7-FFN4-3WCY-NDYU-CPFQ-XFH4-EHNV"}} The Mesh protocols are designed so that there is never a need to export or escrow private keys of any type associated with a device, neither the base key, nor the device key nor the contribution from the administration device. This approach to device configuration ensures that the keys that are used by the device when operating within the context of the account are entirely separate from those originally provided by the device manufacturer or generated on the device, provided only that the key contributions from the administration device are sufficiently random and unguessable. The public keys corresponding to the composite keys generated during the connection process are described in a "ConnectionUser" assertion signed by the administration key of the corresponding account. The connection record for Alice's coffee pot device is: { "ConnectionDevice":{ "DeviceSignature":{ "Udf":"MBTO-NNFK-P6K2-4FW4-WTKW-OLGU-GAZS", "PublicParameters":{ "PublicKeyECDH":{ "crv":"Ed448", "Public":"NXxkDFuagDESh6-FD7LSkkOSVgIW-S4E3TDHR9c5qbW4AUV kJMEh1nZlnVO2xwcGI8SNfov6RR8A"}}}, "DeviceEncryption":{ "Udf":"MAUU-Q2JT-BHOM-ZEPX-HOFG-XYU7-FGCJ", "PublicParameters":{ "PublicKeyECDH":{ "crv":"X448", "Public":"eSh00dco-Ee4X1sb96S9lkcdso7Qu8Uz6NnuDZSu7ww59JJ xF7lEZtWkkELe10cGfpeQZ-qxdkYA"}}}, "DeviceAuthentication":{ "Udf":"MCAY-A6DR-FSY6-2T4K-UD2B-OJHA-MT3H", "PublicParameters":{ "PublicKeyECDH":{ "crv":"X448", "Public":"XyBegJt8kgVMzFTcQWyathYay6aT5C3ubb_ktZc0Gevcz4x u0y9aJlEPNV-siXJxqwdr6bBgySIA"}}}}} Hallam-Baker Expires 6 May 2021 [Page 12] Internet-Draft Mesh Schema Reference November 2020 The "ConnectionUser" assertion MAY be used in the same fashion as an X.509v3/PKIX certificate to mediate interactions between devices connected to the same account without the need for interaction with the Mesh service. Thus, a coffee pot device connected to the account can receive and authenticate instructions issued by a voice recognition device connected to that account. While the "ConnectionUser" assertion MAY be used to mediate external interactions, this approach is typically undesirable as it provides the external parties with visibility to the internal configuration of the account, in particular which connected devices are being used on which occasions. Furthermore, the lack of the need to interact with the service means that the service is necessarily unable to mediate the exchange and enforce authorization policy on the interactions. Device keys are intended to be used to secure communications between devices connected to the same account. All communication between Mesh accounts SHOULD be mediated by a Mesh service. This enables abuse mitigation by applying access control to every outbound and every inbound message. Since Alice's coffee pot does not require the external communication right, the activation record for the coffee pot does not provide access to the account keys required to perform external communications. Alice's watch device does require access to the account keys so it can receive messages and task updates. But since it is a device that Alice has to carry on her person to use, it is a device that might easily be lost or stolen. Accordingly, the activation record for Alice's watch provides access to the account decryption and signature keys but in the form of threshold key shares mediated by the Mesh service. Thus, Alice's watch can sign and read message sent to the account but only under the control of the Mesh service. 3.3. Service Mesh services are described by a "ProfileService". This specifies the encryption, and signature authentication keys used to interact with the abstract service. Since Mesh accounts and services are both abstract constructs, they cannot interact directly. A device connected to an account can only interact with a service by interacted with a device authorized to provide services on behalf of one or more accounts connected to the service. Such a device is called a Mesh Host. Hallam-Baker Expires 6 May 2021 [Page 13] Internet-Draft Mesh Schema Reference November 2020 Mesh hosts MAY be managed using the same ProfileDevice and device connection mechanism provided for management of user devices or by whatever other management protocols prove convenient. The only part of the Service/Host interaction that is visible to devices connected to a profile and to hosts connected to other services is the ConnectionHost structure that describes the set of device keys to use in interactions with that specific host. 4. Catalogs Catalogs track sets of persistent objects associated with a Mesh Service Account. The Mesh Service has no access to the entries in any Mesh catalog except for the Device and Contacts catalog which are used in device authentication and authorization of inbound messages. Each Mesh Catalog managed by a Mesh Account has a name of the form: "_" Where "" is the IANA assigned service name. The assigned service name for the Mathematical Mesh is mmm. Thus, all catalogs specified by the Mesh schema have names prefixed with the sequence "mmm_". The following catalogs are currently specified within the Mathematical Mesh. Access: mmm_Access Describes access control policy for performing operations on the account. The Access catalog is the only Mesh catalog whose contents are readable by the Mesh Service under normal circumstances. Application: "mmm_Application" Describes configuration information for applications including mail (SMTP, IMAP, OpenPGP, S/MIME, etc) and SSH and for the MeshAccount application itself. Bookmark: "mmm_Bookmark" Describes Web bookmarks and other citations allowing them to be shared between devices connected to the profile. Contact: "mmm_Contact" Describes logical and physical contact information for people and organizations. Credential: "mmm_Credential" Describes credentials used to access network resources. Device: "mmm_Device" Describes the set of devices connected to the account and the permissions assigned to them Hallam-Baker Expires 6 May 2021 [Page 14] Internet-Draft Mesh Schema Reference November 2020 Network: "mmm_Network" Describes network settings such as WiFi access points, IPSEC and TLS VPN configurations, etc. Member: mmm_Member Describes the set of members connected to a group account. Publication: mmm_Publication Describes data published under the account context. The data MAY be stored in the publication catalog itself or on a separate service (e.g. a Web server). Task: "mmm_CatalogTask" Describes tasks assigned to the user including calendar entries and to do lists. The Access, Publication, Device and Member catalogs are involved in Mesh Service Protocol interactions. These interactions are further described in the Protocol Reference [draft-hallambaker-mesh-protocol]. In many cases, the Mesh Catalog offers capabilities that represent a superset of the capabilities of an existing application. For example, the task catalog supports the appointment tracking functions of a traditional calendar application and the task tracking function of the traditional 'to do list' application. Combining these functions allows tasks to be triggered by other events other than the passage of time such as completion of other tasks, geographical presence, etc. In such cases, the Mesh Catalog entries are designed to provide a superset of the data representation capabilities of the legacy formats and (where available) recent extensions. Where a catalog entry is derived from input presented in a legacy format, the original data representation MAY be attached verbatim to facilitate interoperability. 4.1. Access The access catalog "mmm_Access" contains a list of access control entries granting a party authenticated using a particular cryptographic credential a specific privilege such as: * Accept Mesh Messages of particular types * Perform an operation on a private key known to the service. Hallam-Baker Expires 6 May 2021 [Page 15] Internet-Draft Mesh Schema Reference November 2020 As with the publication catalog, the access catalog provides information that is necessary for the Mesh Service to act on behalf of the user. It is therefore necessary to grant a decryption capability for this catalog during the process of binding the account to a service. 4.2. Application The application catalog "mmm"_"Application" contains "CatalogEntryApplication" entries which describe the use of specific applications under the Mesh Service Account. Multiple application accounts for a single application MAY be connected to a single Mesh Service Account. Each account being specified in a separate entry. The "CatalogEntryApplication" entries only contain configuration information for the application as it applies to the account as a whole. If the application requires separate configuration for individual devices, this is specified in separate activation records specified in the corresponding "ConnectionDevice". 4.2.1. Mesh Account Mesh Accounts are described by "CatalogEntryAccount" entries. The corresponding activation records for the connected devices contain the contributions used to derive the private keys for use of the account. The "CatalogEntryAccount" entry is described in the section describing Mesh accounts above. 4.2.2. SSH SSH configuration profiles are described by "CatalogEntryApplicationSSH" entries. The corresponding activation records for the connected devices contain the contributions used to derive the private keys. A user may have separate SSH configurations for separate purposes within a single Mesh Account. This allows a system administrator servicing multiple clients to maintain separate SSH profiles for each of her customers allowing credentials to be easily (and verifiably) revoked at contract termination. The SSH profile contains the information that is stored in the "known_hosts" and "authorized_keys" files of SSH clients and servers. Hallam-Baker Expires 6 May 2021 [Page 16] Internet-Draft Mesh Schema Reference November 2020 4.2.3. Mail Mail configuration profiles are described by one or more "CatalogEntryApplicationMail" entries, one for each email account connected to the Mesh profile. The corresponding activation records for the connected devices contain information used to provide the device with the necessary decryption information. Entries specify the email account address(es), the inbound and outbound server configuration and the cryptographic keys to be used for S/MIME and OpenPGP encryption. 4.3. Bookmark The bookmark catalog "mmm_bookmark" contains "CatalogEntryBookmark" entries which describe Web bookmarks and other citations allowing them to be shared between devices connected to the profile. The fields currently supported by the Bookmarks catalog are currently limited to the fields required for tracking Web bookmarks. Specification of additional fields to track full academic citations is a work in progress. { "CatalogedBookmark":{ "Uri":"http://www.site1.com", "Title":"site1", "Path":"Sites.1"}} 4.4. Contact The contact catalog "mmm_contact" contains "CatalogEntryContact" entries which describe { "CatalogedContact":{ "Key":"MAIH-QF2M-PVD3-NQJO-CWGX-G67S-JYEQ", "Self":true, "Contact":{ "ContactPerson":{ "Id":"MAIH-QF2M-PVD3-NQJO-CWGX-G67S-JYEQ", "Anchors":[{ "Udf":"MAIH-QF2M-PVD3-NQJO-CWGX-G67S-JYEQ", "Validation":"Self"} ], "NetworkAddresses":[{ "Address":"alice@example.com", "EnvelopedProfileAccount":[{ Hallam-Baker Expires 6 May 2021 [Page 17] Internet-Draft Mesh Schema Reference November 2020 "EnvelopeID":"MAIH-QF2M-PVD3-NQJO-CWGX-G67S-JYEQ", "dig":"S512", "ContentMetaData":"ewogICJVbmlxdWVJRCI6ICJNQUlILVFG Mk0tUFZEMy1OUUpPLUNXR1gtRzY3Uy1KWUVRIiwKICAiTWVzc2FnZVR5cGUiOiAiU HJvZmlsZVVzZXIiLAogICJjdHkiOiAiYXBwbGljYXRpb24vbW1tL29iamVjdCIsCi AgIkNyZWF0ZWQiOiAiMjAyMC0xMS0wMlQxNzoyNTo1MVoifQ"}, "ewogICJQcm9maWxlVXNlciI6IHsKICAgICJQcm9maWxlU2lnbmF0 dXJlIjogewogICAgICAiVWRmIjogIk1BSUgtUUYyTS1QVkQzLU5RSk8tQ1dHWC1HN jdTLUpZRVEiLAogICAgICAiUHVibGljUGFyYW1ldGVycyI6IHsKICAgICAgICAiUH VibGljS2V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAiRWQ0NDgiLAogICAgICA gICAgIlB1YmxpYyI6ICJMUDZmNEEwV1RHeEJHd1ZReEhFZG0wblpFV2szX09sc0Rz Y1dzOVFqR01UODJrYTdfVERKCiAgRXFRX3BHdG84MjYwUEQ3QVhFZHN4VVVBIn19f SwKICAgICJBY2NvdW50QWRkcmVzcyI6ICJhbGljZUBleGFtcGxlLmNvbSIsCiAgIC AiU2VydmljZVVkZiI6ICJNQlNMLUg0NVAtUE0zVy1OVFlJLU5NS0ctTDQ2VC01SFd NIiwKICAgICJBY2NvdW50RW5jcnlwdGlvbiI6IHsKICAgICAgIlVkZiI6ICJNQzJE LVdYMjUtSks1Uy02UjdSLU5QSzUtWE5RNy1PMzM0IiwKICAgICAgIlB1YmxpY1Bhc mFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tleUVDREgiOiB7CiAgICAgICAgIC AiY3J2IjogIlg0NDgiLAogICAgICAgICAgIlB1YmxpYyI6ICJhQmJZaGlrLVZEVVB tWjNYaDdONUxwcGtuX2Y1MDRNTjYtWVdtTW5RQXlpSUpuS2FXdlBUCiAgVEE4ODlJ Z0QzZHgzR2ZCSG1MajFpWE1BIn19fSwKICAgICJBZG1pbmlzdHJhdG9yU2lnbmF0d XJlIjogewogICAgICAiVWRmIjogIk1BSUgtUUYyTS1QVkQzLU5RSk8tQ1dHWC1HNj dTLUpZRVEiLAogICAgICAiUHVibGljUGFyYW1ldGVycyI6IHsKICAgICAgICAiUHV ibGljS2V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAiRWQ0NDgiLAogICAgICAg ICAgIlB1YmxpYyI6ICJMUDZmNEEwV1RHeEJHd1ZReEhFZG0wblpFV2szX09sc0RzY 1dzOVFqR01UODJrYTdfVERKCiAgRXFRX3BHdG84MjYwUEQ3QVhFZHN4VVVBIn19fS wKICAgICJBY2NvdW50QXV0aGVudGljYXRpb24iOiB7CiAgICAgICJVZGYiOiAiTUF HVS1XTEdILVFYN0wtUlFLUy1LSFA0LUM1TFItNVJHMiIsCiAgICAgICJQdWJsaWNQ YXJhbWV0ZXJzIjogewogICAgICAgICJQdWJsaWNLZXlFQ0RIIjogewogICAgICAgI CAgImNydiI6ICJYNDQ4IiwKICAgICAgICAgICJQdWJsaWMiOiAieW9JaTBkdlFCTk k0VXRpVUNBNUx2WUJpckRIamxFUVhIT2d6VjRrdHNxUUtQd2gtbE40YwogIEVqQ0l pbnlpOEo1R1VfUjk0Q0Y1aGUwQSJ9fX0sCiAgICAiQWNjb3VudFNpZ25hdHVyZSI6 IHsKICAgICAgIlVkZiI6ICJNQlZOLVVDMkgtRUtDMi1HTFpBLUNMU0MtNlhRMi1RW klBIiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0 tleUVDREgiOiB7CiAgICAgICAgICAiY3J2IjogIkVkNDQ4IiwKICAgICAgICAgICJ QdWJsaWMiOiAiRXZQWUhHUkNKc1owa21iQk11X3N4Y0d1VUlPSEZYYzRpejBvQ3lZ MTlmcFlVRzVxSnluNAogIDY3V3E4NXp1Vld2aUJsOHpkMy05WF93QSJ9fX19fQ", { "signatures":[{ "alg":"S512", "kid":"MAIH-QF2M-PVD3-NQJO-CWGX-G67S-JYEQ", "signature":"PuG3M10QcqNXxUtJzk83C2LkExhO1jYqfB x_pcgl-_MH9lBPdT5JMiNSyVLsHRM9ZMUO-GVcDMiAITPUt5jG6t-GP3-6bdyEd6h DKavFUJYr4tWjKvro-3Uh7KP5BvFCz1VNoccCaiNhsrCf6uie4wkA"} ], "PayloadDigest":"OmGeYT1GZa5-mNx5fYmK0Jk2AzqPxuEJ-d RnTuoPLSgOSjHMzLnu8y1q6NTYxZomMK0ZfkuPtfD9Uyemy-npHQ"} ], "Protocols":[{ Hallam-Baker Expires 6 May 2021 [Page 18] Internet-Draft Mesh Schema Reference November 2020 "Protocol":"mmm"} ]} ], "Sources":[{ "Validation":"Self", "EnvelopedSource":[{ "dig":"S512", "ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJDb250 YWN0UGVyc29uIiwKICAiY3R5IjogImFwcGxpY2F0aW9uL21tbS9vYmplY3QiLAogI CJDcmVhdGVkIjogIjIwMjAtMTEtMDJUMTc6MjU6NTFaIn0"}, "ewogICJDb250YWN0UGVyc29uIjogewogICAgIkFuY2hvcnMiOiBb ewogICAgICAgICJVZGYiOiAiTUFJSC1RRjJNLVBWRDMtTlFKTy1DV0dYLUc2N1MtS llFUSIsCiAgICAgICAgIlZhbGlkYXRpb24iOiAiU2VsZiJ9XSwKICAgICJOZXR3b3 JrQWRkcmVzc2VzIjogW3sKICAgICAgICAiQWRkcmVzcyI6ICJhbGljZUBleGFtcGx lLmNvbSIsCiAgICAgICAgIkVudmVsb3BlZFByb2ZpbGVBY2NvdW50IjogW3sKICAg ICAgICAgICAgIkVudmVsb3BlSUQiOiAiTUFJSC1RRjJNLVBWRDMtTlFKTy1DV0dYL Uc2N1MtSllFUSIsCiAgICAgICAgICAgICJkaWciOiAiUzUxMiIsCiAgICAgICAgIC AgICJDb250ZW50TWV0YURhdGEiOiAiZXdvZ0lDSlZibWx4ZFdWSlJDSTZJQ0pOUVV sSUxWRkdNazB0VUZaRU15MQogIE9VVXBQTFVOWFIxZ3RSelkzVXkxS1dVVlJJaXdL SUNBaVRXVnpjMkZuWlZSNWNHVWlPaUFpVUhKdlptbHNaCiAgVlZ6WlhJaUxBb2dJQ 0pqZEhraU9pQWlZWEJ3YkdsallYUnBiMjR2YlcxdEwyOWlhbVZqZENJc0NpQWdJa0 4KICB5WldGMFpXUWlPaUFpTWpBeU1DMHhNUzB3TWxReE56b3lOVG8xTVZvaWZRIn0 sCiAgICAgICAgICAiZXdvZ0lDSlFjbTltYVd4bFZYTmxjaUk2SUhzS0lDQWdJQ0pR Y205bWFXeAogIGxVMmxuYm1GMGRYSmxJam9nZXdvZ0lDQWdJQ0FpVldSbUlqb2dJa zFCU1VndFVVWXlUUzFRVmtRekxVNVJTCiAgazh0UTFkSFdDMUhOamRUTFVwWlJWRW lMQW9nSUNBZ0lDQWlVSFZpYkdsalVHRnlZVzFsZEdWeWN5STZJSHMKICBLSUNBZ0l DQWdJQ0FpVUhWaWJHbGpTMlY1UlVORVNDSTZJSHNLSUNBZ0lDQWdJQ0FnSUNKamNu WWlPaUFpUgogIFdRME5EZ2lMQW9nSUNBZ0lDQWdJQ0FnSWxCMVlteHBZeUk2SUNKT VVEWm1ORUV3VjFSSGVFSkhkMVpSZUVoCiAgRlpHMHdibHBGVjJzelgwOXNjMFJ6WT Fkek9WRnFSMDFVT0RKcllUZGZWRVJLQ2lBZ1JYRlJYM0JIZEc4NE0KICBqWXdVRVE zUVZoRlpITjRWVlZCSW4xOWZTd0tJQ0FnSUNKQlkyTnZkVzUwUVdSa2NtVnpjeUk2 SUNKaGJHbAogIGpaVUJsZUdGdGNHeGxMbU52YlNJc0NpQWdJQ0FpVTJWeWRtbGpaV lZrWmlJNklDSk5RbE5NTFVnME5WQXRVCiAgRTB6VnkxT1ZGbEpMVTVOUzBjdFREUT JWQzAxU0ZkTklpd0tJQ0FnSUNKQlkyTnZkVzUwUlc1amNubHdkR2wKICB2YmlJNkl Ic0tJQ0FnSUNBZ0lsVmtaaUk2SUNKTlF6SkVMVmRZTWpVdFNrczFVeTAyVWpkU0xV NVFTelV0VwogIEU1Uk55MVBNek0wSWl3S0lDQWdJQ0FnSWxCMVlteHBZMUJoY21Gd FpYUmxjbk1pT2lCN0NpQWdJQ0FnSUNBCiAgZ0lsQjFZbXhwWTB0bGVVVkRSRWdpT2 lCN0NpQWdJQ0FnSUNBZ0lDQWlZM0oySWpvZ0lsZzBORGdpTEFvZ0kKICBDQWdJQ0F nSUNBZ0lsQjFZbXhwWXlJNklDSmhRbUpaYUdsckxWWkVWVkJ0V2pOWWFEZE9OVXh3 Y0d0dVgyWQogIDFNRFJOVGpZdFdWZHRUVzVSUVhscFNVcHVTMkZYZGxCVUNpQWdWR UU0T0RsSlowUXpaSGd6UjJaQ1NHMU1hCiAgakZwV0UxQkluMTlmU3dLSUNBZ0lDSk JaRzFwYm1semRISmhkRzl5VTJsbmJtRjBkWEpsSWpvZ2V3b2dJQ0EKICBnSUNBaVZ XUm1Jam9nSWsxQlNVZ3RVVVl5VFMxUVZrUXpMVTVSU2s4dFExZEhXQzFITmpkVExV cFpSVkVpTAogIEFvZ0lDQWdJQ0FpVUhWaWJHbGpVR0Z5WVcxbGRHVnljeUk2SUhzS 0lDQWdJQ0FnSUNBaVVIVmliR2xqUzJWCiAgNVJVTkVTQ0k2SUhzS0lDQWdJQ0FnSU NBZ0lDSmpjbllpT2lBaVJXUTBORGdpTEFvZ0lDQWdJQ0FnSUNBZ0kKICBsQjFZbXh wWXlJNklDSk1VRFptTkVFd1YxUkhlRUpIZDFaUmVFaEZaRzB3YmxwRlYyc3pYMDlz YzBSelkxZAogIHpPVkZxUjAxVU9ESnJZVGRmVkVSS0NpQWdSWEZSWDNCSGRHODRNa Hallam-Baker Expires 6 May 2021 [Page 19] Internet-Draft Mesh Schema Reference November 2020 ll3VUVRM1FWaEZaSE40VlZWQkluMTlmCiAgU3dLSUNBZ0lDSkJZMk52ZFc1MFFYVj BhR1Z1ZEdsallYUnBiMjRpT2lCN0NpQWdJQ0FnSUNKVlpHWWlPaUEKICBpVFVGSFZ TMVhURWRJTFZGWU4wd3RVbEZMVXkxTFNGQTBMVU0xVEZJdE5WSkhNaUlzQ2lBZ0lD QWdJQ0pRZAogIFdKc2FXTlFZWEpoYldWMFpYSnpJam9nZXdvZ0lDQWdJQ0FnSUNKU WRXSnNhV05MWlhsRlEwUklJam9nZXdvCiAgZ0lDQWdJQ0FnSUNBZ0ltTnlkaUk2SU NKWU5EUTRJaXdLSUNBZ0lDQWdJQ0FnSUNKUWRXSnNhV01pT2lBaWUKICBXOUphVEJ rZGxGQ1RrazBWWFJwVlVOQk5VeDJXVUpwY2tSSWFteEZVVmhJVDJkNlZqUnJkSE54 VVV0UWQyZwogIHRiRTQwWXdvZ0lFVnFRMGxwYm5scE9FbzFSMVZmVWprMFEwWTFhR 1V3UVNKOWZYMHNDaUFnSUNBaVFXTmpiCiAgM1Z1ZEZOcFoyNWhkSFZ5WlNJNklIc0 tJQ0FnSUNBZ0lsVmtaaUk2SUNKTlFsWk9MVlZETWtndFJVdERNaTEKICBIVEZwQkx VTk1VME10TmxoUk1pMVJXa2xCSWl3S0lDQWdJQ0FnSWxCMVlteHBZMUJoY21GdFpY Umxjbk1pTwogIGlCN0NpQWdJQ0FnSUNBZ0lsQjFZbXhwWTB0bGVVVkRSRWdpT2lCN 0NpQWdJQ0FnSUNBZ0lDQWlZM0oySWpvCiAgZ0lrVmtORFE0SWl3S0lDQWdJQ0FnSU NBZ0lDSlFkV0pzYVdNaU9pQWlSWFpRV1VoSFVrTktjMW93YTIxaVEKICBrMTFYM04 0WTBkMVZVbFBTRVpZWXpScGVqQnZRM2xaTVRsbWNGbFZSelZ4U25sdU5Bb2dJRFkz VjNFNE5YcAogIDFWbGQyYVVKc09IcGtNeTA1V0Y5M1FTSjlmWDE5ZlEiLAogICAgI CAgICAgewogICAgICAgICAgICAic2lnbmF0dXJlcyI6IFt7CiAgICAgICAgICAgIC AgICAiYWxnIjogIlM1MTIiLAogICAgICAgICAgICAgICAgImtpZCI6ICJNQUlILVF GMk0tUFZEMy1OUUpPLUNXR1gtRzY3Uy1KWUVRIiwKICAgICAgICAgICAgICAgICJz aWduYXR1cmUiOiAiUHVHM00xMFFjcU5YeFV0SnprODNDMkxrRXhoTzFqWXFmQnhfc GNnbC1fTUg5bEJQZAogIFQ1Sk1pTlN5VkxzSFJNOVpNVU8tR1ZjRE1pQUlUUFV0NW pHNnQtR1AzLTZiZHlFZDZoREthdkZVSllyNHRXCiAgakt2cm8tM1VoN0tQNUJ2RkN 6MVZOb2NjQ2FpTmhzckNmNnVpZTR3a0EifV0sCiAgICAgICAgICAgICJQYXlsb2Fk RGlnZXN0IjogIk9tR2VZVDFHWmE1LW1OeDVmWW1LMEprMkF6cVB4dUVKLWRSblR1b 1BMU2dPUwogIGpITXpMbnU4eTFxNk5UWXhab21NSzBaZmt1UHRmRDlVeWVteS1ucE hRIn1dLAogICAgICAgICJQcm90b2NvbHMiOiBbewogICAgICAgICAgICAiUHJvdG9 jb2wiOiAibW1tIn1dfV19fQ", { "signatures":[{ "alg":"S512", "kid":"MBVN-UC2H-EKC2-GLZA-CLSC-6XQ2-QZIA", "signature":"ueOrjyE-0-zJ_DRQW-zJIH0ZLcxvsjhzKV tNOnUYV116UBm740XP4gfHwkqR1WvL2Lpb25SWi66Aj7lTZtaSOFreEm9i0TgIBco g4_O49DFf7s4HK6wo53KUe8J5pbjvYCnY8bsRWA6ZNAtTbyT_YDEA"} ], "PayloadDigest":"h4lFjVf0eiHdZT1eg0iBK8eXYAXvB1dLo7 7beFR8LbEuFULlYds0eGH85HWrcZXyIZtzAZtv866fIqRWI2ARqQ"} ]} ]}}}} The fields of the contact catalog provide a superset of the capabilities of vCard [RFC2426]. The Contact catalog is typically used by the MeshService as a source of authorization information to perform access control on inbound and outbound message requests. For this reason, Mesh Service SHOULD be granted read access to the contacts catalog by providing a decryption entry for the service. Hallam-Baker Expires 6 May 2021 [Page 20] Internet-Draft Mesh Schema Reference November 2020 4.5. Credential The credential catalog "mmm_credential" contains "CatalogEntryCredential" entries which describe credentials used to access network resources. { "CatalogedCredential":{ "Service":"ftp.example.com", "Username":"alice1", "Password":"password"}} Only username/password credentials are stored in the credential catalog. If public key credentials are to be used, these SHOULD be managed as an application profile allowing separate credentials to be created for each device. 4.6. Device The device catalog "mmm_Device" contains "CatalogEntryDevice" entries which describe the devices connected to the account and the permissions assigned to them. Each device connected to a Mesh Account has an associated CatalogEntryDevice entry that includes the activation and connection records for the account. These records are described in further detail in section REF _Ref54628559 \r \h 0. 4.7. Network The network catalog contains "CatalogEntryNetwork" entries which describe network settings, IPSEC and TLS VPN configurations, etc. { "CatalogedNetwork":{ "Service":"myWiFi", "Password":"securePassword"}} 4.8. Publication The publication catalog "mmm_Publication" contains "CatalogEntryPublication" entries which describe content published through the account. Hallam-Baker Expires 6 May 2021 [Page 21] Internet-Draft Mesh Schema Reference November 2020 4.9. Task The Task catalog "mmm_Task" contains "CatalogEntryTask" entries which describe tasks assigned to the user including calendar entries and to do lists. The fields of the task catalog currently reflect those offered by the iCalendar specification [RFC5545]. Specification of additional fields to allow task triggering on geographic location and/or completion of other tasks is a work in progress. { "CatalogedTask":{ "Title":"SomeItem", "Key":"NCYK-YRNO-OHE5-3KZQ-IPS5-T3W4-WFHB"}} 5. Spools Spools are DARE Containers containing an append only list of messages sent or received by an account. Three spools are currently defined: Inbound Messages sent to the account. These are encrypted under the account encryption keys of the sender and receiver that were current at the time the message was sent. Outbound Messages sent from the account. These are encrypted under the account encryption keys of the sender and receiver that were current at the time the message was sent. Local Messages sent from the account for internal use. These are encrypted under the encryption key of the intended recipient alone. This is either the account administration encryption key or a device encryption key. Every Mesh Message has a unique message identifier. Messages created at the beginning of a new messaging protocol interaction are assigned a random message identifier. Responses to previous messages are assigned message identifiers formed from the message identifier to which they respond by means of a message digest function. Every Mesh Message stored in a spool is encapsulated in an envelope which bears a unique identifier that is formed by applying a message digest function to the message identifier. Each stored message has an associated state which is initially set to the state "Initial" and MAY be subsequently altered by one or more "MessageComplete" messages subsequently appended to the spool. The allowable message states depending upon the spool in question. Hallam-Baker Expires 6 May 2021 [Page 22] Internet-Draft Mesh Schema Reference November 2020 5.1. Outbound The outbound spool stores messages that are to be or have been sent and "MessageComplete" messages reporting changes to the status of the messages stored on the spool. Messages posted to the outbound spool have the state Initial, Sent, Received or Refused: Initial The initial state of a message posted to the spool. Sent The Mesh Service of the sender has delivered the message to the Mesh Service of the recipient which accepted it. Received The Mesh Service of the sender has delivered the message to the Mesh Service of the recipient and the recipient has acknowledged receipt. Refused The Mesh Service of the sender has delivered the message to the Mesh Service of the recipient which refused to accept it. "MessageComplete" messages are only valid when posted to the spool by the service. 5.2. Inbound The inbound spool stores messages that have been received by the Mesh service servicing the account and MessageComplete messages reporting changes to the status of the messages stored on the spool. Messages posted to the outbound spool have the state Initial, Read: Initial The initial state of a message posted to the spool. Read The message has been read. A message previously marked as read MAY be returned to the unread state by marking it as being in the Initial state. 5.3. Local The local spool stores messages that are used for administrative functions. In normal circumstances, only administrator devices and the Mesh Service require access to the local spool. Hallam-Baker Expires 6 May 2021 [Page 23] Internet-Draft Mesh Schema Reference November 2020 The local spool is used to store MessagePin messages used to notify administration devices that a PIN code has been registered for some purpose and RespondConnection messages used to inform a device of the result of a connection request. The local spool is used in a device connection operation to provide a device with the activation and connection records required to access the service as an authorized client. Servicing these requests requires that the service be able to access messages stored in the spool by envelope id. Messages posted to the outbound spool have the states Initial, Closed: Initial The initial state of a message posted to the spool. Closed The action associated with the message has been completed. 6. Cryptographic Operations The Mesh makes use of various cryptographic operations including threshold operations. For convenience, these are gathered here and specified as functions that are referenced by other parts of the specification. 6.1. Key Derivation from Seed Mesh Keys that derived from a seed value use the mechanism described in [draft-hallambaker-mesh-udf]. Use of the "keyname" parameter allows multiple keys for different uses to be derived from a single key. Thus escrow of a single seed value permits recovery of all the private keys associated with the profile. The keyname parameter is a string formed by concatenating identifiers specifying the key type, the actor that will use the key and the key operation: 6.2. Message Response Identifier Every Mesh message has a unique "MessageId". When encapsulated in a DARE Envelope, the EnvelopeId field of the envelope header is the UDF Content Digest of the enclosed MessageId as a string: public static string GetEnvelopeId(string messageID) => UDF.ContentDigestOfUDF(messageID); Hallam-Baker Expires 6 May 2021 [Page 24] Internet-Draft Mesh Schema Reference November 2020 When processing a Mesh message results in the creation of a response to the sender, the MessageId of the response is UDF Content Digest of the Binary Data Sequence of the original MessageId: static string MakeID(string udf, string content) { var (code, bds) = UDF.Parse(udf); return code switch { UdfTypeIdentifier.Digest_SHA_3_512 => UDF.ContentDigestOfDataString( bds, content, cryptoAlgorithmId: CryptoAlgorithmId.SHA_3_512), _ => UDF.ContentDigestOfDataString( bds, content, cryptoAlgorithmId: CryptoAlgorithmId.SHA_2_512), }; For example: [To be specified] 6.3. Proof of Knowledge of PIN Mesh Message classes that are subclasses of "MessagePinValidated" MAY be authenticated by means of a PIN. Currently two such messages are defined: "MessageContact" used in contact exchange and "RequestConnection" message used in device connection. The PIN codes used to authenticate "MessagePinValidated" messages are UDF Authenticator strings. The type code of the identifier specifies the algorithm to be used to authenticate the PIN code and the Binary Data Sequence value specifies the key. The inputs to the PIN proof of knowledge functions are: PIN: string A UDF Authenticator. The type code of the identifier specifies the algorithm to be used to authenticate the PIN code and the Binary Data Sequence value specifies the key. Action: string A code determining the specific action that the PIN code MAY be used to authenticate. By convention this is the name of the Mesh message type used to perform the action. Account: string The account for which the PIN code is issued. ClientNonce: binary Nonce value generated by the client using the PIN code to authenticate its message. Hallam-Baker Expires 6 May 2021 [Page 25] Internet-Draft Mesh Schema Reference November 2020 PayloadDigest: binary The PayloadDigest of a DARE Envelope that contains the message to be authenticated. Note that if the envelope is encrypted, this value is calculated over the ciphertext and does not provide proof of knowledge of the plaintext. The following values of Action are currently defined: +=====================+===================+===================+ | Code | Mesh Message | Purpose | +=====================+===================+===================+ | "MessageContact" | MessageContact | Contact exchange | +---------------------+-------------------+-------------------+ | "RequestConnection" | RequestConnection | Device connection | +---------------------+-------------------+-------------------+ Table 1 These inputs are used to derive values as follows: alg = UdfAlg (PIN) pinData = UdfBDS (PIN) saltedPINData = MAC (Action, pinData) saltedPIN = UDFPresent (Authenticator_HMAC_SHA_2_512 + saltedPINData) PinId = UDFPresent (MAC (Account, saltedPINData)) witnessData = Account.ToUTF8() + ClientNonce + PayloadDigest witnessValue = MAC (witnessData , saltedPINData) Eg. [To be specified] Where "MAC(data, key)" is the message authentication code algorithm specified by the value of "alg". When an administrative device issues a PIN code, a Message PIN is appended to the local spool. This has the MessageId PinId and specifies the value "saltedPIN" in the field of that name. When PIN code authentication is used, a message of type MessagePinValidated specifies the values ClientNonce, PinWitness and PinId in the fields of those names. [To be specified] Hallam-Baker Expires 6 May 2021 [Page 26] Internet-Draft Mesh Schema Reference November 2020 6.4. EARL The UDF Encrypted Authenticated Resource Locator mechanism is used to publish data and provide means of authentication and access through a static identifier such as a QR code. This mechanism is used to allow contact exchange by means of a QR code printed on a business card and to connect a device to an account using a static identifier printed on the device in the form of a QR code. In both cases, the information is passed using the EARL format described in [draft-hallambaker-mesh-udf]. 6.5. Key Agreement All Mesh Protocol requests except for the HelloRequest and every response MUST be authenticated under the device key of the host or device making the request. Initial authentication is achieved by performing a Key agreement under the "DeviceAuthentication" key of each of the hosts and combining the result with nonce values provided by the requestor and respondent using a KDF function as follows: Two bindings are currently planned. DARE Envelope over HTTPS The request or response is encapsulated in a DARE Envelope that is exchanged by means of a HTTP POST method over a TLS transport. The shared secret is used as the key on Message Authentication Code that authenticates the request payload. UDP Transport Presents the same information as for the DARE Envelope over HTTPS case but in a compact encoding using the shared secret and an authenticated encryption scheme to pass the required information. Once authentication has been performed, the same pair of devices MAY re-authenticate using the previously agreed key. To facilitate stateless implementation, a host specifies an opaque identifier to be used to identify the shared secret on subsequent uses which MAY be used to recover the shared secret from the opaque identifier. [To be specified] Hallam-Baker Expires 6 May 2021 [Page 27] Internet-Draft Mesh Schema Reference November 2020 6.6. Service Cryptographic Operations A Mesh Service acts as the counterparty for threshold operations allowing mitigation of the risk of compromise of an individual device connected to a user account or an insider threat from an individual member of a group account. When acting in this role, the Mesh service controls the use of the cryptographic function but does not have the ability to perform the action either by itself or by collaborating with other services to which the account has been bound in the past. Note that this approach limits rather than eliminates trust in the service. As with services presenting themselves as 'zero trust', a Mesh service becomes a trusted service after a sufficient number of breaches in other parts of the system have occurred. And the user trusts the service to provide availability of the service. Three service cryptographic operations are currently specified: Threshold Key Share A private key share _s_, held by the service is split into key shares _x_, _y_ such that _a_ = _x_ + _y_. One key share is encrypted under a decryption key held by the service. The other is encrypted under a public key specified by the party making the request. Threshold Key Agreement A private key share s, held by the service is used to calculate the value (_sl_+ _c_)._P_ where _l_, _c_ are integers specified by the requestor and _P_ is a point on the curve. Threshold Signature A private key share s, held by the service is used to calculate a contribution to a threshold signature scheme. The implementation of the cryptographic operations described above is described in [draft-hallambaker-threshold] and [draft-hallambaker-threshold-sigs]. 7. Mesh Assertions Mesh Assertions are signed DARE Envelopes that contain one of more claims. Mesh Assertions provide the basis for trust in the Mathematical Mesh. Hallam-Baker Expires 6 May 2021 [Page 28] Internet-Draft Mesh Schema Reference November 2020 Mesh Assertions are divided into two classes. Mesh Profiles are self-signed assertions. Assertions that are not self-signed are called declarations. The only type of declaration currently defined is a Connection Declaration describing the connection of a device to an account. (Artwork only available as svg: No external link available, see draft-hallambaker-mesh-schema-06.html for artwork.) Figure 1 7.1. Encoding The payload of a Mesh Assertion is a JSON encoded object that is a subclass of the Assertion class which defines the following fields: Identifier An identifier for the assertion. Updated The date and time at which the assertion was issued or last updated NotaryToken An assertion may optionally contain one or more notary tokens issued by a Mesh Notary service. These establish a proof that the assertion was signed after the date the notary token was created. Conditions A list of conditions that MAY be used to verify the status of the assertion if the relying party requires. The implementation of the NotaryToken and Conditions mechanisms is to be specified in [draft-hallambaker-mesh-notary] at a future date. Note that the implementation of Conditions differs significantly from that of SAML. Relying parties are required to process condition clauses in a SAML assertion to determine validity. Mesh Relying parties MAY verify the conditions clauses or rely on the trustworthiness of the provider. The reason for weakening the processing of conditions clauses in the Mesh is that it is only ever possible to validate a conditions clause of any type relative to a ground truth. In SAML applications, the relying party almost invariably has access to an independent source of ground truth. A Mesh device connected to a Mesh Service does not. Thus the types of verification that can be achieved in practice are limited to verifying the consistency of current and previous statements from the Mesh Service. Hallam-Baker Expires 6 May 2021 [Page 29] Internet-Draft Mesh Schema Reference November 2020 7.2. Mesh Profiles Mesh Profiles perform a similar role to X.509v3 certificates but with important differences: * Profiles describe credentials, they do not make identity statements * Profiles do not expire, there is therefore no need to support renewal processing. * Profiles may be modified over time, the current and past status of a profile being recorded in an append only log. Profiles provide the axioms of trust for the Mesh PKI. Unlike in the PKIX model in which all trust flows from axioms of trust held by a small number of Certificate Authorities, every part in the Mesh contributes their own axiom of trust. It should be noted however that the role of Certificate Authorities is redefined rather than eliminated. Rather than making assertions whose subject is represented by identities which are inherently mutable and subjective, Certificate Authorities can now make assertions about immutable cryptographic keys. Every Profile MUST contain a "SignatureKey" field and MUST be signed by the key specified in that field. A Profile is valid if and only if: * There is a "SignatureKey" field. * The profile is signed under the key specified in the "SignatureKey" field. A profile has the status "current" if and only if: * The Profile is valid * Every Conditions clause in the profile is understood by the relying party and evaluates to "true". 7.3. Mesh Connections A Mesh connection is an assertion describing the connection of a device or a member to an account. Hallam-Baker Expires 6 May 2021 [Page 30] Internet-Draft Mesh Schema Reference November 2020 Mesh connections provide similar functionality to 'end-entity' certificates in PKIX but with the important proviso that they are only used to provide trust between a device connected to an account and the service to which that account is bound and between the devices connected to an account. A connection is valid with respect to an account with profile _P_ if and only if: * The profile _P_ is valid * The "AuthorityUdf" field of the connection is consistent with the UDF of _P_ * The profile is signed under the key specified in the "AdministrationKey" field of _P_. * Any conditions specified in the profile are met A connection has the status current with respect to an account with profile if and only if: * The connection is valid with respect to the account with profile _P_. * The profile "P" is current. A device is authenticated with respect to an account with profile P if and only if: * The connection is valid with respect to the account with profile _P_. * The device has presented an appropriate proof of knowledge of the "DeviceAuthentication" key specified in the connection. 8. Architecture $$$$$$$$$$$ This has plenty or areas that need to be upgraded to the single master/account approach. The Mesh architecture has four principal components: Mesh Device Management Binds a collection of devices that the owner of the Mesh uses together to function as a single personal Mesh. Mesh Account Contains all the information (contacts, calendar Hallam-Baker Expires 6 May 2021 [Page 31] Internet-Draft Mesh Schema Reference November 2020 entries, inbound and outbound messages, etc.) related to a particular persona used by the owner. Mesh Service Provides a service identifier (e.g. "alice@example.com") through which devices and other Mesh users may interact with a Mesh Account. Mesh Messaging Allows short messages (less than 32KB) to be exchanged between Mesh devices connected to an account and between Mesh Accounts. Device management and Accounts components are defined by a data schema alone. The Service and Messaging components are defined by a data schema and a service protocol. The separation of accounts and services as separate components is a key distinction between the Mesh and earlier Internet applications. A Mesh account belongs to the owner of the Mesh and not the Mesh Service Provider which the user may change at any time of their choosing. A Mesh Account May be active or inactive. By definition, an active Mesh account is serviced by exactly one Mesh Service, an inactive Mesh account is not serviced by a Mesh Service. A Mesh Service Provider MAY offer a backup service for accounts hosted by other providers. In this case the backup provider is connected to the account as a Mesh device, thus allowing the backup provider to maintain a copy of the stores contained in the account and facilitating a rapid transfer of responsibility for servicing the account should that be desired. The use of backup providers is described further in [draft-hallambaker-mesh-discovery]. 8.1. Device Management Device Management provides the foundation for all Mesh functions allowing a collection of devices belonging to a user to function as a single personal Mesh. The device management layer of a personal Mesh consists of exactly one Master Profile and a catalog containing the entries describing the connected devices. 8.1.1. Master Profile A Mesh master profile provides the axiom of trust for a mesh user. It contains a Master Signature Key and one or more Administration Signature Keys. The unique identifier of the master profile is the UDF of the Master Signature Key. Hallam-Baker Expires 6 May 2021 [Page 32] Internet-Draft Mesh Schema Reference November 2020 A Master Profile MUST specify an "EscrowEncryption" key. This key MAY be used to escrow private keys used for encryption of stored data. They SHOULD NOT be used to escrow authentication keys and MUST NOT be used to escrow signature keys. A user should not need to replace their account profile unless they intend to establish a separate identity. To minimize the risk of disclosure, the Profile Signature Key is only ever used to sign updates to the account profile itself. This allows the user to secure their Profile Signature Key by either keeping it on hardware token or device dedicated to that purpose or by using the escrow mechanism and paper recovery keys as described in this document. 8.1.1.1. Creating a ProfileMaster Creating a "ProfileMaster" comprises the steps of: 0. Creating a Master Signature key. 1. Creating an Online Signing Key 2. Signing the "ProfileMaster" using the Master Signature Key 3. Persisting the "ProfileMaster" on the administration device to the "CatalogHost". 4. (Optional) Connecting at least one Administration Device and granting it the "ActivationAdministration" activation. 8.1.1.2. Updating a ProfileMaster Updating a "ProfileMaster" comprises the steps of: 0. Making the necessary changes. 1. Signing the ProfileMaster using the Master Signature Key 2. Persisting the ProfileMaster on the administration device to the CatalogHost. 8.1.1.3. The Device Catalog Each personal Mesh has a Device Catalog "CatalogDevice" associated with it. The Device Catalog is used to manage the connection of devices to the Personal Mesh and has a "CatalogEntryDevice" for each device currently connected to the catalog. Hallam-Baker Expires 6 May 2021 [Page 33] Internet-Draft Mesh Schema Reference November 2020 Each Administration Device MUST have access to an up to date copy of the Device Catalog in order to manage the devices connected to the Mesh. The Mesh Service protocol MAY be used to synchronize the Device Catalog between administration devices in the case that there is more than one administration device. The "CatalogEntryDevice" contains fields for the device profile, device private and device connection. 8.1.2. Mesh Devices The principle of radical distrust requires us to consider the possibility that a device might be compromised during manufacture. Once consequence of this possibility is that when an administration device connects a new device to a user's personal Mesh, we cannot put our full trust in either the device being connected or the administration device connecting it. This concern is resolved by (at minimum) combining keying material generated from both sources to create the keys to be used in the context of the user's personal Mesh with the process being fully verified by both parties. Additional keying material sources could be added if protection against the possibility of compromise at both devices was required but this is not supported by the current specifications. A device profile provides the axiom of trust and the key contributions of the device. When bound to an account, the base keys specified in the Device Profile are combined with the key data provided in the Activation device to construct the keys the device will use in the context of the account. (Artwork only available as svg: No external link available, see draft-hallambaker-mesh-schema-06.html for artwork.) Figure 2 Unless exceptional circumstances require, a device should not require more than one Device profile even if the device supports use by multiple users under different accounts. But a device MAY have multiple profiles if this approach is more convenient for implementation. The derivation of the Connection encryption and signature keys from the Profile and Private contributions in this example is shown in [draft-hallambaker-mesh-cryptography]. Hallam-Baker Expires 6 May 2021 [Page 34] Internet-Draft Mesh Schema Reference November 2020 8.1.2.1. Creating a ProfileDevice Creating a "ProfileDevice" comprises the steps of: 0. Creating the necessary key 1. Signing the "ProfileDevice" using the Master Signature Key 2. Once created, a "ProfileDevice" is never changed. In the unlikely event that any modification is required, a completely new "ProfileDevice" MUST be created. 8.1.2.2. Connection to a Personal Mesh Devices are only connected to a personal Mesh by administration device. This comprises the steps of: 0. Generating the PrivateDevice keys. 1. Creating the ConnectionDevice data from the public components of the ProfileDevice and PrivateDevice keys and signing it using the administration key. 2. Creating the Activations for the device and signing them using the administration key. 3. Creating the "CatalogEntryDevice" for the device and adding it to the "CatalogDevice" of the Personal Mesh. 4. If the Personal Mesh has accounts that are connected to a Mesh Service, synchronizing the "CatalogEntryDevice" to those services. 8.2. Mesh Accounts Mesh Accounts contains all the stateful information (contacts, calendar entries, inbound and outbound messages, etc.) related to a particular persona used by the owner. A Mesh Profile MAY be connected to multiple accounts at the same time allowing the user to maintain separate personas for separate purposes. Unlike traditional Internet application accounts, Mesh accounts are created by and belong to the user, not the Mesh Service provider. A user MAY change their Mesh Service provider at any time and disconnect the profile from all Mesh Services (e.g. to archive the account). Hallam-Baker Expires 6 May 2021 [Page 35] Internet-Draft Mesh Schema Reference November 2020 Alice's personal account is connected to two Mesh services: The account profile specifies the online and offline signature keys used to maintain the profile and the encryption key to be used by the account. Each device connected to the account requires an activation record. This specifies the key contribtions added to the manufacturer device profile keys: The resulting key set is specified in the device connection: All the above plus the ProfileDevice are combined to form the CatalogedDevice entry: 8.2.1. Creating a ProfileAccount Creating a "ProfileAccount" comprises the steps of: 0. [TBS] 1. . 2. Signing the ProfileMaster using the Master Signature Key 8.2.2. Connecting a Device to an Account Adding a device to an account comprises the steps of: 0. Creating a PrivateAccount instance for the device. 1. Creating a ConnectionAccountDevice for the device using the public keys from the PrivateAccount instance and the ProfileDevice. 2. Creating an ActivationAccount for the device containing the PrivateAccount and ConnectionAccountDevice instances. 3. Adding the ActivationAccount to the "CatalogEntryDevice" of the device. 4. If the Personal Mesh has accounts that are connected to a Mesh Service, synchronizing the "CatalogEntryDevice" to those services. Hallam-Baker Expires 6 May 2021 [Page 36] Internet-Draft Mesh Schema Reference November 2020 8.2.3. Binding and Account to a Service Binding a "ProfileAccount" to a Mesh Service the steps of: 0. [TBS] 1. . 2. Signing the ProfileMaster using the Master Signature Key 8.3. Mesh Services A service profile provides the axiom of trust and cryptographic keys for a Mesh Service. A Mesh Service Host SHOULD return a copy of its ProfileHost and the parent ProfileService in response to a Hello transaction request. (Artwork only available as svg: No external link available, see draft-hallambaker-mesh-schema-06.html for artwork.) Figure 3 The credentials provided by the ProfileService and ProfileHost are distinct from those provided by the WebPKI that typically services TLS requests. WebPKI credentials provide service introduction and authentication while a Mesh ProfileHost only provides authentication. Unless exceptional circumstances require, a service should not need to revise its Service Profile unless it is intended to change its identity. Service Profiles MAY be countersigned by Trusted Third Parties to establish accountability. The service profile The host also has a profile And there should be a connection of the host to the service but this isn't implemented yet: 8.3.1. Creating a ProfileService [TBS] Creating a "ProfileService" comprises the steps of: 0. [TBS] 1. . Hallam-Baker Expires 6 May 2021 [Page 37] Internet-Draft Mesh Schema Reference November 2020 2. [TBS] 4. Signing the ProfileMaster using the Master Signature Key 8.3.2. Creating a ProfileHost Creating a "ProfileHost" comprises the steps of: 0. [TBS] 1. . 2. [TBS] 4. Signing the "ConnectionHost" using the Master Signature Key of the "ProfileService". 8.3.3. Creating a ConnectionHost Creating a "ConnectionHost" comprises the steps of: 0. [TBS] 1. . 2. Signing the "ConnectionHost" using the Master Signature Key of the "ProfileService". 8.4. Mesh Messaging Mesh Messaging is an end-to-end secure messaging system used to exchange short (32KB) messages between Mesh devices and services. In cases where exchange of longer messages is required, Mesh Messaging MAY be used to provide a control plane to advise the intended message recipient(s) of the type of data being offered and the means of retrieval (e.g an EARL). A four-corner messaging model is enforced. Mesh Services only accept outbound messages from devices connected to accounts that it services. Inbound messages are only accepted from other Mesh Services. This model enables access control at both the outbound and inbound services (Artwork only available as svg: No external link available, see draft-hallambaker-mesh-schema-06.html for artwork.) Hallam-Baker Expires 6 May 2021 [Page 38] Internet-Draft Mesh Schema Reference November 2020 Figure 4 The outbound Mesh Service checks to see that the request to send a message does not violate its acceptable use policy. Accounts that make a large number of message requests that result in complaints SHOULD be subject to consequences ranging from restriction of the number and type of messages sent to suspending or terminating messaging privileges. Services that fail to implement appropriate controls are likely to be subject to sanctions from either their users or from other services. (Artwork only available as svg: No external link available, see draft-hallambaker-mesh-schema-06.html for artwork.) Figure 5 The inbound Mesh Service also checks to see that messages received are consistent with the service Acceptable Use Policy and the user's personal access control settings. Mesh Services that fail to police abuse by their account holders SHOULD be subject to consequences in the same fashion as account holders. (Artwork only available as svg: No external link available, see draft-hallambaker-mesh-schema-06.html for artwork.) Figure 6 8.4.1. Traffic Analysis The Mesh Messaging protocol as currently specified provides only limited protection against traffic analysis attacks. The use of TLS to encrypt communication between Mesh Services limits the effectiveness of na?ve traffic analysis mechanisms but does not prevent timing attacks unless dummy traffic is introduced to obfuscate traffic flows. The limitation of the message size is in part intended to facilitate use of mechanisms capable of providing high levels of traffic analysis such as mixmaster and onion routing but the current Mesh Service Protocol does not provide support for such approaches and there are no immediate plans to do so. Hallam-Baker Expires 6 May 2021 [Page 39] Internet-Draft Mesh Schema Reference November 2020 9. Mesh Messages All communications between Mesh accounts takes the form of a Mesh Message carried in a Dare Envelope. Mesh Messages are stored in two spools associated with the account, the "SpoolOutbound" and the "SpoolInbound" containing the messages sent and received respectively. This document only describes the representation of the messages within the message spool. The Mesh Service protocol by which the messages are exchanged between devices and services and between services is described in [draft-hallambaker-mesh-protocol]. 9.1. PIN One-time use 'PIN' codes are used to provide a means of out of band authentication in many Mesh Message applications. In particular the device connection and contact exchange message flows. For example, when Alice reads the connection request from the device in the architecture examples, a completion message is added to Alice's inbound spool so that the device is not activated a second time by mistake: { "MessagePin":{ "MessageId":"ADWE-3XBF-GGLA-AMCX-XVDM-KMXB-BQRN", "Account":"alice@example.com", "Expires":"2020-11-03T17:25:57Z", "Automatic":true, "SaltedPin":"ADPA-GPKO-V6TG-BPWJ-42YS-V5K7-NCZD", "Action":"Device"}} The details of the presentation and verification of the PIN code are further described in the section below. 9.2. Completion Completion messages are dummy messages that are added to a Mesh Spool to change the status of messages previously posted. Any message that is in the inbound spool and has not been erased or redacted MAY be marked as "read", "unread" or "deleted". Any message in the outbound spool MAY be marked as "sent", "received" or "deleted". Hallam-Baker Expires 6 May 2021 [Page 40] Internet-Draft Mesh Schema Reference November 2020 Services MAY erase or redact messages in accordance with local site policy. Since messages are not removed from the spool on being marked deleted, they may be undeleted by marking them as read or unread. Marking a message deleted MAY make it more likely that the Service will purge the message however. Having processed a message, a completion message is added to the spool so that other devices can see that it has been read. For example, when Alice's administration device uses the PIN registered above to authenticate a device connection request, a completion message is added to Alice's inbound spool so that the PIN cannot be reused to authenticate a second device: Missing example 25 9.3. Connection Connection requests are sent by a device requesting connection to a Mesh Service Account. The "MessageConnectionRequest" is originally sent by the device requesting connection to the Mesh Service associated with the account. If the connection request is accepted by the Mesh Service, it creates a "MessageConnectionResponse" containing the ServerNonce and Witness values used in the authentication of the response together with a verbatim copy of the original request. The "MessageConnectionResponse" is then returned to the device that made the original request and placed on the SpoolInbound of the account to which the request was directed. Further details of this mechanism are described in [draft-hallambaker-mesh-protocol]. Alice connects a watch to her account. Since the watch has a camera (to allow for video calls) she can use the dynamic QR code connection mechanism. The watch reads the QR code generated on Alice's watch. This contains the device connection URI. QR = {Connect.ConnectQRURI} Hallam-Baker Expires 6 May 2021 [Page 41] Internet-Draft Mesh Schema Reference November 2020 The URI tells the device the Mesh account to connect to and the PIN Code to be used to authenticate the request. The device requesting the connection adds its Profile device to create a RequestConnection message that will be presented to the service as a Connect transaction request. { "RequestConnection":{ "MessageId":"NB2K-E33D-IXPK-LR7X-DL5R-7GJW-FLEP", "AuthenticatedData":[{ "EnvelopeID":"MDJD-7EJB-LBMZ-MAO5-CGIE-DDEB-LQVH", "dig":"S512", "ContentMetaData":"ewogICJVbmlxdWVJRCI6ICJNREpELTdFSkItTEJN Wi1NQU81LUNHSUUtRERFQi1MUVZIIiwKICAiTWVzc2FnZVR5cGUiOiAiUHJvZmlsZ URldmljZSIsCiAgImN0eSI6ICJhcHBsaWNhdGlvbi9tbW0vb2JqZWN0IiwKICAiQ3 JlYXRlZCI6ICIyMDIwLTExLTAyVDE3OjI1OjU3WiJ9"}, "ewogICJQcm9maWxlRGV2aWNlIjogewogICAgIlByb2ZpbGVTaWduYXR1cmUi OiB7CiAgICAgICJVZGYiOiAiTURKRC03RUpCLUxCTVotTUFPNS1DR0lFLURERUItT FFWSCIsCiAgICAgICJQdWJsaWNQYXJhbWV0ZXJzIjogewogICAgICAgICJQdWJsaW NLZXlFQ0RIIjogewogICAgICAgICAgImNydiI6ICJFZDQ0OCIsCiAgICAgICAgICA iUHVibGljIjogImlZajZfbEU2enUta2xxZ0doMGtnMlZBT2o1cENYcEtWMDk0OFJT ZWJqUkpfdmphS0dKRXoKICBDQll0ZkZzb2tMUUg5aUduWnRfTEd3d0EifX19LAogI CAgIkJhc2VFbmNyeXB0aW9uIjogewogICAgICAiVWRmIjogIk1DUFgtWkhQNC01Nl NPLVpMT0ktN1FITS1IMkE0LUdYUE0iLAogICAgICAiUHVibGljUGFyYW1ldGVycyI 6IHsKICAgICAgICAiUHVibGljS2V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAi WDQ0OCIsCiAgICAgICAgICAiUHVibGljIjogInBnei1ZS3hjdzFrUHJJRzd4ejNlb 0tZZGlsQzZUa3NUTE0tcjhINUNuNFdUY3gtbGtDZUgKICBONmtzcTVPelc1N3laX1 9LZkZlelBhNEEifX19LAogICAgIkJhc2VBdXRoZW50aWNhdGlvbiI6IHsKICAgICA gIlVkZiI6ICJNQ1RVLUVCR1QtQjVDRS1EUlpBLUhOSFEtQ05UVS1ITVBFIiwKICAg ICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tleUVDREgiO iB7CiAgICAgICAgICAiY3J2IjogIlg0NDgiLAogICAgICAgICAgIlB1YmxpYyI6IC JaY05LdGhmdUk4QTNibUt1c284dWJzSDkwcG1VUXdBV1FNTGpwcFh1dHh0anVsR2l pYjZkCiAgU0p3R18tYmh6ZlBUQ0RpY05oSFVXa2NBIn19fSwKICAgICJCYXNlU2ln bmF0dXJlIjogewogICAgICAiVWRmIjogIk1DNzYtR1VGNy1MRUhYLTNWR0ctS1ZHU C03TjJLLUNFUVUiLAogICAgICAiUHVibGljUGFyYW1ldGVycyI6IHsKICAgICAgIC AiUHVibGljS2V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAiRWQ0NDgiLAogICA gICAgICAgIlB1YmxpYyI6ICJqZG1ibnZKNkM5ajhzbF9pRUlmcDkxMlItQ3lKX1E1 MXdsc1d4X1ZxYWIwd0cwc0JNd21mCiAgbkx2ZFMydWFTTVpBN1RuYTNvWUItdENBI n19fX19", { "signatures":[{ "alg":"S512", "kid":"MDJD-7EJB-LBMZ-MAO5-CGIE-DDEB-LQVH", "signature":"ZXggJgXzooa2Ui5zxNXrY6UCNXFFUBgGgpPl5Qe_OC 1o_oJKHJkwEIDBEj45OHQZPGhn1TEl5UwAJxemsop7Rnr5U3DdNc2ERYL4hYHGVVx 5W2PzeQk4U1mviwYdfqp_5V80vRL4RcZiTozviK6sWwwA"} ], "PayloadDigest":"JRadknNMvezXjCMPoluxtnw8sUX4QXZ1oSG6HANsJn Hallam-Baker Expires 6 May 2021 [Page 42] Internet-Draft Mesh Schema Reference November 2020 IAZwXEzvTjbZwrngywjG82UJ8p6DXBMfcYTR0AhJIBBg"} ], "ClientNonce":"-suxzsj-OEQhgNZeuQFfiQ", "PinId":"ADWE-3XBF-GGLA-AMCX-XVDM-KMXB-BQRN", "PinWitness":"cRP1Zv5O5NH-GRJi1qv0rZNPJEsix0RyXMxgPLz5XzXsMQOzd OOgSVDeFrZWoyY2DitMfZdjIharXUL_cWovJA", "AccountAddress":"alice@example.com"}} The service generates an AcknowledgeConnection message which is returned to the device requesting the connection (via the Connect transaction response) and adds it to the inbound spool of the account for Alice's approval (or not). { "AcknowledgeConnection":{ "MessageId":"T365-C62P-LUPX-76V5-CUND-IB5M-OE7P", "EnvelopedRequestConnection":[{ "EnvelopeID":"MCPK-XGW3-624O-UVCF-G33S-I6VX-U2P7", "ContentMetaData":"ewogICJVbmlxdWVJRCI6ICJOQjJLLUUzM0QtSVhQ Sy1MUjdYLURMNVItN0dKVy1GTEVQIiwKICAiTWVzc2FnZVR5cGUiOiAiUmVxdWVzd ENvbm5lY3Rpb24iLAogICJjdHkiOiAiYXBwbGljYXRpb24vbW1tL29iamVjdCIsCi AgIkNyZWF0ZWQiOiAiMjAyMC0xMS0wMlQxNzoyNTo1N1oifQ"}, "ewogICJSZXF1ZXN0Q29ubmVjdGlvbiI6IHsKICAgICJNZXNzYWdlSWQiOiAi TkIySy1FMzNELUlYUEstTFI3WC1ETDVSLTdHSlctRkxFUCIsCiAgICAiQXV0aGVud GljYXRlZERhdGEiOiBbewogICAgICAgICJFbnZlbG9wZUlEIjogIk1ESkQtN0VKQi 1MQk1aLU1BTzUtQ0dJRS1EREVCLUxRVkgiLAogICAgICAgICJkaWciOiAiUzUxMiI sCiAgICAgICAgIkNvbnRlbnRNZXRhRGF0YSI6ICJld29nSUNKVmJtbHhkV1ZKUkNJ NklDSk5SRXBFTFRkRlNrSXRURUpOV2kxCiAgTlFVODFMVU5IU1VVdFJFUkZRaTFNV VZaSUlpd0tJQ0FpVFdWemMyRm5aVlI1Y0dVaU9pQWlVSEp2Wm1sc1oKICBVUmxkbW xqWlNJc0NpQWdJbU4wZVNJNklDSmhjSEJzYVdOaGRHbHZiaTl0YlcwdmIySnFaV04 wSWl3S0lDQQogIGlRM0psWVhSbFpDSTZJQ0l5TURJd0xURXhMVEF5VkRFM09qSTFP alUzV2lKOSJ9LAogICAgICAiZXdvZ0lDSlFjbTltYVd4bFJHVjJhV05sSWpvZ2V3b 2dJQ0FnSWxCeWIyWgogIHBiR1ZUYVdkdVlYUjFjbVVpT2lCN0NpQWdJQ0FnSUNKVl pHWWlPaUFpVFVSS1JDMDNSVXBDTFV4Q1RWb3RUCiAgVUZQTlMxRFIwbEZMVVJFUlV JdFRGRldTQ0lzQ2lBZ0lDQWdJQ0pRZFdKc2FXTlFZWEpoYldWMFpYSnpJam8KICBn ZXdvZ0lDQWdJQ0FnSUNKUWRXSnNhV05MWlhsRlEwUklJam9nZXdvZ0lDQWdJQ0FnS UNBZ0ltTnlkaUk2SQogIENKRlpEUTBPQ0lzQ2lBZ0lDQWdJQ0FnSUNBaVVIVmliR2 xqSWpvZ0ltbFphalpmYkVVMmVuVXRhMnh4WjBkCiAgb01HdG5NbFpCVDJvMWNFTll jRXRXTURrME9GSlRaV0pxVWtwZmRtcGhTMGRLUlhvS0lDQkRRbGwwWmtaemIKICAy dE1VVWc1YVVkdVduUmZURWQzZDBFaWZYMTlMQW9nSUNBZ0lrSmhjMlZGYm1OeWVYQ jBhVzl1SWpvZ2V3bwogIGdJQ0FnSUNBaVZXUm1Jam9nSWsxRFVGZ3RXa2hRTkMwMU 5sTlBMVnBNVDBrdE4xRklUUzFJTWtFMExVZFlVCiAgRTBpTEFvZ0lDQWdJQ0FpVUh WaWJHbGpVR0Z5WVcxbGRHVnljeUk2SUhzS0lDQWdJQ0FnSUNBaVVIVmliR2wKICBq UzJWNVJVTkVTQ0k2SUhzS0lDQWdJQ0FnSUNBZ0lDSmpjbllpT2lBaVdEUTBPQ0lzQ 2lBZ0lDQWdJQ0FnSQogIENBaVVIVmliR2xqSWpvZ0luQm5laTFaUzNoamR6RnJVSE pKUnpkNGVqTmxiMHRaWkdsc1F6WlVhM05VVEUwCiAgdGNqaElOVU51TkZkVVkzZ3R iR3REWlVnS0lDQk9ObXR6Y1RWUGVsYzFOM2xhWDE5TFprWmxlbEJoTkVFaWYKICBY MTlMQW9nSUNBZ0lrSmhjMlZCZFhSb1pXNTBhV05oZEdsdmJpSTZJSHNLSUNBZ0lDQ Hallam-Baker Expires 6 May 2021 [Page 43] Internet-Draft Mesh Schema Reference November 2020 WdJbFZrWmlJNklDSgogIE5RMVJWTFVWQ1IxUXRRalZEUlMxRVVscEJMVWhPU0ZFdF EwNVVWUzFJVFZCRklpd0tJQ0FnSUNBZ0lsQjFZCiAgbXhwWTFCaGNtRnRaWFJsY25 NaU9pQjdDaUFnSUNBZ0lDQWdJbEIxWW14cFkwdGxlVVZEUkVnaU9pQjdDaUEKICBn SUNBZ0lDQWdJQ0FpWTNKMklqb2dJbGcwTkRnaUxBb2dJQ0FnSUNBZ0lDQWdJbEIxW W14cFl5STZJQ0phWQogIDA1TGRHaG1kVWs0UVROaWJVdDFjMjg0ZFdKelNEa3djRz FWVVhkQlYxRk5UR3B3Y0ZoMWRIaDBhblZzUjJsCiAgcFlqWmtDaUFnVTBwM1IxOHR ZbWg2WmxCVVEwUnBZMDVvU0ZWWGEyTkJJbjE5ZlN3S0lDQWdJQ0pDWVhObFUKICAy bG5ibUYwZFhKbElqb2dld29nSUNBZ0lDQWlWV1JtSWpvZ0lrMUROell0UjFWR055M U1SVWhZTFROV1IwYwogIHRTMVpIVUMwM1RqSkxMVU5GVVZVaUxBb2dJQ0FnSUNBaV VIVmliR2xqVUdGeVlXMWxkR1Z5Y3lJNklIc0tJCiAgQ0FnSUNBZ0lDQWlVSFZpYkd salMyVjVSVU5FU0NJNklIc0tJQ0FnSUNBZ0lDQWdJQ0pqY25ZaU9pQWlSV1EKICAw TkRnaUxBb2dJQ0FnSUNBZ0lDQWdJbEIxWW14cFl5STZJQ0pxWkcxaWJuWktOa001Y WpoemJGOXBSVWxtYwogIERreE1sSXRRM2xLWDFFMU1YZHNjMWQ0WDFaeFlXSXdkMG N3YzBKTmQyMW1DaUFnYmt4MlpGTXlkV0ZUVFZwCiAgQk4xUnVZVE52V1VJdGRFTkJ JbjE5ZlgxOSIsCiAgICAgIHsKICAgICAgICAic2lnbmF0dXJlcyI6IFt7CiAgICAg ICAgICAgICJhbGciOiAiUzUxMiIsCiAgICAgICAgICAgICJraWQiOiAiTURKRC03R UpCLUxCTVotTUFPNS1DR0lFLURERUItTFFWSCIsCiAgICAgICAgICAgICJzaWduYX R1cmUiOiAiWlhnZ0pnWHpvb2EyVWk1enhOWHJZNlVDTlhGRlVCZ0dncFBsNVFlX09 DMW9fb0pLSAogIEprd0VJREJFajQ1T0hRWlBHaG4xVEVsNVV3QUp4ZW1zb3A3Um5y NVUzRGROYzJFUllMNGhZSEdWVng1VzJQCiAgemVRazRVMW12aXdZZGZxcF81Vjgwd lJMNFJjWmlUb3p2aUs2c1d3d0EifV0sCiAgICAgICAgIlBheWxvYWREaWdlc3QiOi AiSlJhZGtuTk12ZXpYakNNUG9sdXh0bnc4c1VYNFFYWjFvU0c2SEFOc0puSUFaCiA gd1hFenZUamJad3JuZ3l3akc4MlVKOHA2RFhCTWZjWVRSMEFoSklCQmcifV0sCiAg ICAiQ2xpZW50Tm9uY2UiOiAiLXN1eHpzai1PRVFoZ05aZXVRRmZpUSIsCiAgICAiU GluSWQiOiAiQURXRS0zWEJGLUdHTEEtQU1DWC1YVkRNLUtNWEItQlFSTiIsCiAgIC AiUGluV2l0bmVzcyI6ICJjUlAxWnY1TzVOSC1HUkppMXF2MHJaTlBKRXNpeDBSeVh NeGdQTHo1WHpYc01RT3oKICBkT09nU1ZEZUZyWldveVkyRGl0TWZaZGpJaGFyWFVM X2NXb3ZKQSIsCiAgICAiQWNjb3VudEFkZHJlc3MiOiAiYWxpY2VAZXhhbXBsZS5jb 20ifX0" ], "ServerNonce":"1yJIRnfjOC0JFCCQZAFznw", "Witness":"T365-C62P-LUPX-76V5-CUND-IB5M-OE7P"}} Alice's administration device synchronizes to the service and receives the connection request acknowledgement from the service. Since the request is authenticated by a PIN code that has been marked for automatic execution, the service can generate the assertions the device to participate in the account and appends the corresponding RespondConnection message to the local delivery spool. { "RespondConnection":{ "MessageId":"MAE6-HCD5-CTU3-T4LW-HW7N-C3SQ-F2OI", "Result":"Accept", "CatalogedDevice":{ "Udf":"MCCR-2BLZ-ME27-SWM4-I73R-A7IA-MTYN", "DeviceUdf":"MDJD-7EJB-LBMZ-MAO5-CGIE-DDEB-LQVH", "EnvelopedProfileUser":[{ Hallam-Baker Expires 6 May 2021 [Page 44] Internet-Draft Mesh Schema Reference November 2020 "EnvelopeID":"MAIH-QF2M-PVD3-NQJO-CWGX-G67S-JYEQ", "dig":"S512", "ContentMetaData":"ewogICJVbmlxdWVJRCI6ICJNQUlILVFGMk0tUF ZEMy1OUUpPLUNXR1gtRzY3Uy1KWUVRIiwKICAiTWVzc2FnZVR5cGUiOiAiUHJvZml sZVVzZXIiLAogICJjdHkiOiAiYXBwbGljYXRpb24vbW1tL29iamVjdCIsCiAgIkNy ZWF0ZWQiOiAiMjAyMC0xMS0wMlQxNzoyNTo1MVoifQ"}, "ewogICJQcm9maWxlVXNlciI6IHsKICAgICJQcm9maWxlU2lnbmF0dXJlIj ogewogICAgICAiVWRmIjogIk1BSUgtUUYyTS1QVkQzLU5RSk8tQ1dHWC1HNjdTLUp ZRVEiLAogICAgICAiUHVibGljUGFyYW1ldGVycyI6IHsKICAgICAgICAiUHVibGlj S2V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAiRWQ0NDgiLAogICAgICAgICAgI lB1YmxpYyI6ICJMUDZmNEEwV1RHeEJHd1ZReEhFZG0wblpFV2szX09sc0RzY1dzOV FqR01UODJrYTdfVERKCiAgRXFRX3BHdG84MjYwUEQ3QVhFZHN4VVVBIn19fSwKICA gICJBY2NvdW50QWRkcmVzcyI6ICJhbGljZUBleGFtcGxlLmNvbSIsCiAgICAiU2Vy dmljZVVkZiI6ICJNQlNMLUg0NVAtUE0zVy1OVFlJLU5NS0ctTDQ2VC01SFdNIiwKI CAgICJBY2NvdW50RW5jcnlwdGlvbiI6IHsKICAgICAgIlVkZiI6ICJNQzJELVdYMj UtSks1Uy02UjdSLU5QSzUtWE5RNy1PMzM0IiwKICAgICAgIlB1YmxpY1BhcmFtZXR lcnMiOiB7CiAgICAgICAgIlB1YmxpY0tleUVDREgiOiB7CiAgICAgICAgICAiY3J2 IjogIlg0NDgiLAogICAgICAgICAgIlB1YmxpYyI6ICJhQmJZaGlrLVZEVVBtWjNYa DdONUxwcGtuX2Y1MDRNTjYtWVdtTW5RQXlpSUpuS2FXdlBUCiAgVEE4ODlJZ0QzZH gzR2ZCSG1MajFpWE1BIn19fSwKICAgICJBZG1pbmlzdHJhdG9yU2lnbmF0dXJlIjo gewogICAgICAiVWRmIjogIk1BSUgtUUYyTS1QVkQzLU5RSk8tQ1dHWC1HNjdTLUpZ RVEiLAogICAgICAiUHVibGljUGFyYW1ldGVycyI6IHsKICAgICAgICAiUHVibGljS 2V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAiRWQ0NDgiLAogICAgICAgICAgIl B1YmxpYyI6ICJMUDZmNEEwV1RHeEJHd1ZReEhFZG0wblpFV2szX09sc0RzY1dzOVF qR01UODJrYTdfVERKCiAgRXFRX3BHdG84MjYwUEQ3QVhFZHN4VVVBIn19fSwKICAg ICJBY2NvdW50QXV0aGVudGljYXRpb24iOiB7CiAgICAgICJVZGYiOiAiTUFHVS1XT EdILVFYN0wtUlFLUy1LSFA0LUM1TFItNVJHMiIsCiAgICAgICJQdWJsaWNQYXJhbW V0ZXJzIjogewogICAgICAgICJQdWJsaWNLZXlFQ0RIIjogewogICAgICAgICAgImN ydiI6ICJYNDQ4IiwKICAgICAgICAgICJQdWJsaWMiOiAieW9JaTBkdlFCTkk0VXRp VUNBNUx2WUJpckRIamxFUVhIT2d6VjRrdHNxUUtQd2gtbE40YwogIEVqQ0lpbnlpO Eo1R1VfUjk0Q0Y1aGUwQSJ9fX0sCiAgICAiQWNjb3VudFNpZ25hdHVyZSI6IHsKIC AgICAgIlVkZiI6ICJNQlZOLVVDMkgtRUtDMi1HTFpBLUNMU0MtNlhRMi1RWklBIiw KICAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tleUVD REgiOiB7CiAgICAgICAgICAiY3J2IjogIkVkNDQ4IiwKICAgICAgICAgICJQdWJsa WMiOiAiRXZQWUhHUkNKc1owa21iQk11X3N4Y0d1VUlPSEZYYzRpejBvQ3lZMTlmcF lVRzVxSnluNAogIDY3V3E4NXp1Vld2aUJsOHpkMy05WF93QSJ9fX19fQ", { "signatures":[{ "alg":"S512", "kid":"MAIH-QF2M-PVD3-NQJO-CWGX-G67S-JYEQ", "signature":"PuG3M10QcqNXxUtJzk83C2LkExhO1jYqfBx_pcgl -_MH9lBPdT5JMiNSyVLsHRM9ZMUO-GVcDMiAITPUt5jG6t-GP3-6bdyEd6hDKavFU JYr4tWjKvro-3Uh7KP5BvFCz1VNoccCaiNhsrCf6uie4wkA"} ], "PayloadDigest":"OmGeYT1GZa5-mNx5fYmK0Jk2AzqPxuEJ-dRnTuoP LSgOSjHMzLnu8y1q6NTYxZomMK0ZfkuPtfD9Uyemy-npHQ"} ], "EnvelopedProfileDevice":[{ Hallam-Baker Expires 6 May 2021 [Page 45] Internet-Draft Mesh Schema Reference November 2020 "EnvelopeID":"MDJD-7EJB-LBMZ-MAO5-CGIE-DDEB-LQVH", "dig":"S512", "ContentMetaData":"ewogICJVbmlxdWVJRCI6ICJNREpELTdFSkItTE JNWi1NQU81LUNHSUUtRERFQi1MUVZIIiwKICAiTWVzc2FnZVR5cGUiOiAiUHJvZml sZURldmljZSIsCiAgImN0eSI6ICJhcHBsaWNhdGlvbi9tbW0vb2JqZWN0IiwKICAi Q3JlYXRlZCI6ICIyMDIwLTExLTAyVDE3OjI1OjU3WiJ9"}, "ewogICJQcm9maWxlRGV2aWNlIjogewogICAgIlByb2ZpbGVTaWduYXR1cm UiOiB7CiAgICAgICJVZGYiOiAiTURKRC03RUpCLUxCTVotTUFPNS1DR0lFLURERUI tTFFWSCIsCiAgICAgICJQdWJsaWNQYXJhbWV0ZXJzIjogewogICAgICAgICJQdWJs aWNLZXlFQ0RIIjogewogICAgICAgICAgImNydiI6ICJFZDQ0OCIsCiAgICAgICAgI CAiUHVibGljIjogImlZajZfbEU2enUta2xxZ0doMGtnMlZBT2o1cENYcEtWMDk0OF JTZWJqUkpfdmphS0dKRXoKICBDQll0ZkZzb2tMUUg5aUduWnRfTEd3d0EifX19LAo gICAgIkJhc2VFbmNyeXB0aW9uIjogewogICAgICAiVWRmIjogIk1DUFgtWkhQNC01 NlNPLVpMT0ktN1FITS1IMkE0LUdYUE0iLAogICAgICAiUHVibGljUGFyYW1ldGVyc yI6IHsKICAgICAgICAiUHVibGljS2V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOi AiWDQ0OCIsCiAgICAgICAgICAiUHVibGljIjogInBnei1ZS3hjdzFrUHJJRzd4ejN lb0tZZGlsQzZUa3NUTE0tcjhINUNuNFdUY3gtbGtDZUgKICBONmtzcTVPelc1N3la X19LZkZlelBhNEEifX19LAogICAgIkJhc2VBdXRoZW50aWNhdGlvbiI6IHsKICAgI CAgIlVkZiI6ICJNQ1RVLUVCR1QtQjVDRS1EUlpBLUhOSFEtQ05UVS1ITVBFIiwKIC AgICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tleUVDREg iOiB7CiAgICAgICAgICAiY3J2IjogIlg0NDgiLAogICAgICAgICAgIlB1YmxpYyI6 ICJaY05LdGhmdUk4QTNibUt1c284dWJzSDkwcG1VUXdBV1FNTGpwcFh1dHh0anVsR 2lpYjZkCiAgU0p3R18tYmh6ZlBUQ0RpY05oSFVXa2NBIn19fSwKICAgICJCYXNlU2 lnbmF0dXJlIjogewogICAgICAiVWRmIjogIk1DNzYtR1VGNy1MRUhYLTNWR0ctS1Z HUC03TjJLLUNFUVUiLAogICAgICAiUHVibGljUGFyYW1ldGVycyI6IHsKICAgICAg ICAiUHVibGljS2V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAiRWQ0NDgiLAogI CAgICAgICAgIlB1YmxpYyI6ICJqZG1ibnZKNkM5ajhzbF9pRUlmcDkxMlItQ3lKX1 E1MXdsc1d4X1ZxYWIwd0cwc0JNd21mCiAgbkx2ZFMydWFTTVpBN1RuYTNvWUItdEN BIn19fX19", { "signatures":[{ "alg":"S512", "kid":"MDJD-7EJB-LBMZ-MAO5-CGIE-DDEB-LQVH", "signature":"ZXggJgXzooa2Ui5zxNXrY6UCNXFFUBgGgpPl5Qe_ OC1o_oJKHJkwEIDBEj45OHQZPGhn1TEl5UwAJxemsop7Rnr5U3DdNc2ERYL4hYHGV Vx5W2PzeQk4U1mviwYdfqp_5V80vRL4RcZiTozviK6sWwwA"} ], "PayloadDigest":"JRadknNMvezXjCMPoluxtnw8sUX4QXZ1oSG6HANs JnIAZwXEzvTjbZwrngywjG82UJ8p6DXBMfcYTR0AhJIBBg"} ], "EnvelopedConnectionUser":[{ "dig":"S512", "ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJDb25uZWN0aW 9uRGV2aWNlIiwKICAiY3R5IjogImFwcGxpY2F0aW9uL21tbS9vYmplY3QiLAogICJ DcmVhdGVkIjogIjIwMjAtMTEtMDJUMTc6MjU6NThaIn0"}, "ewogICJDb25uZWN0aW9uRGV2aWNlIjogewogICAgIkRldmljZVNpZ25hdH VyZSI6IHsKICAgICAgIlVkZiI6ICJNQlFFLU1CTzUtVlNBRy02UVVXLUdBSlUtNEV HTi1FN1ZYIiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1 Hallam-Baker Expires 6 May 2021 [Page 46] Internet-Draft Mesh Schema Reference November 2020 YmxpY0tleUVDREgiOiB7CiAgICAgICAgICAiY3J2IjogIkVkNDQ4IiwKICAgICAgI CAgICJQdWJsaWMiOiAieWVVaUgyZ3EydTc4YUQzbER4WXRQUmhZQTM1ZW5vTjBIME 81Z3FLMlhySVhSVzdOVGsxUAogIFpZbFp0a3h4WjZFUlQxcEpQVXdKVlFzQSJ9fX0 sCiAgICAiRGV2aWNlRW5jcnlwdGlvbiI6IHsKICAgICAgIlVkZiI6ICJNQ080LTRN NDUtT1dPRS1VVVBNLVdJUEstQVNCRS00SjJOIiwKICAgICAgIlB1YmxpY1BhcmFtZ XRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tleUVDREgiOiB7CiAgICAgICAgICAiY3 J2IjogIlg0NDgiLAogICAgICAgICAgIlB1YmxpYyI6ICJCVzBBWGZpWE1iVnZrUlp uTnp5anJucTdSU2FiVjJBSnBsQzJTSzBPUnB6UEpxbmhaeEVxCiAgVHRFZjJ0TzVJ TlRwcUJPd21MU0ZvLS1BIn19fSwKICAgICJEZXZpY2VBdXRoZW50aWNhdGlvbiI6I HsKICAgICAgIlVkZiI6ICJNQjZKLTRWWFYtRFhRUS1HVVFWLVkzSlQtWVRUQS1KRU 41IiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0t leUVDREgiOiB7CiAgICAgICAgICAiY3J2IjogIlg0NDgiLAogICAgICAgICAgIlB1 YmxpYyI6ICJhYjVUSGQybmVFOHFjM0hEeW5YRzZMWThiVmp3Z0dpYnUwRGhOS0I5M XhQOWF4bFpybHA4CiAgYUw2WHA3TVJ3QU9TQU02TjJZY1dKdXFBIn19fX19", { "signatures":[{ "alg":"S512", "kid":"MBXO-5JKI-OWJH-UH5T-C4SU-YKEE-D3FP", "signature":"kLHglBYqL6rZPz6Fo7Jz2-pGZMlt6DG1zQVWu-nJ F0eEmkb2QnGc5GEhiwfiVIBw171_sunZBvqAzQh_hdwrHebrP8Q46kp8emfCksm9b -BrsjG3YsjuBg7_N98uJOyWoIdQ6j0upKZX6XV2re7JpzwA"} ], "PayloadDigest":"5gZs1tch-I8eCUcLBhNLGwv_YFl11hKt-I6rstjF Xe90lfi4z2KsLmKKcAGY7KpTejpYmGXUVHC1H7ns4YGDkw"} ], "EnvelopedActivationDevice":[{ "enc":"A256CBC", "dig":"S512", "kid":"EBQO-I6OP-D6SH-Q2MD-QBBQ-PUKG-BBCE", "Salt":"Vc0qvABdCE6vS8G3orAiNA", "recipients":[{ "kid":"MCPX-ZHP4-56SO-ZLOI-7QHM-H2A4-GXPM", "epk":{ "PublicKeyECDH":{ "crv":"X448", "Public":"rdeKkVGxewmd5848kt6ysRkl8Fbnjez7Va-TcRb -acX83owoCknyb9joo38vs_vzBkgEW5yPxXwA"}}, "wmk":"DnzzAha8AY_-kkv6Qq3M6rvM3LXTH9yQLSujqOkDEyBXnr ajY4BoUA"} ], "ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJBY3RpdmF0aW 9uRGV2aWNlIiwKICAiY3R5IjogImFwcGxpY2F0aW9uL21tbS9vYmplY3QiLAogICJ DcmVhdGVkIjogIjIwMjAtMTEtMDJUMTc6MjU6NThaIn0"}, "9YI2S_zl1lfnuTYHlFvbZpNonWv-cx75v2P5YXQLl5mKbRQtc6mf6Ub3f3 WFokrzaz1AoOCNk9amIe-OH1Nv1upgxEd9s3X1Q_UUHOzb84HslsjjtCxqYSuaKFj QoP2oBzXWGCaoh8t4jIPAaMzdW4gZOQ0NNxb0t47pLHEiUe1Jy1ez5m-PK9faJtH2 wXhtogeWlppdJ2IvxkK4ofCpgY-clsl8yT8qdNFLG4GdEr-SFCn8cmDhYKAT9n5i- THP", Hallam-Baker Expires 6 May 2021 [Page 47] Internet-Draft Mesh Schema Reference November 2020 { "signatures":[{ "alg":"S512", "kid":"MBXO-5JKI-OWJH-UH5T-C4SU-YKEE-D3FP", "signature":"BZMkm5R4Emy2M5Xljebbvwlu94FWRIvV23zi5Yzt 8dobj_JIfrYP9YHfovGVGtNBeuuA3C0VsJ0AWYECXEng9-ysYke93Er_gfNPx-scx 31nhcNozE4uDSL63UrNZ-J0RzFfo1x8ZoNUTNizr79I5j4A", "witness":"H8uCeAQI1Nffql1X4qGqK_i9-sgQaDshpTebNsBQr_ w"} ], "PayloadDigest":"u8hmjJAqV014X0KwhOvZpcSxbRevKMuBWJgBA1qy Q7VyF78Iux68V447pfrUa8iLjD2T32LHJv0u9zCzaJQkhQ"} ], "EnvelopedActivationAccount":[{ "dig":"S512", "ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJBY3RpdmF0aW 9uQWNjb3VudCIsCiAgImN0eSI6ICJhcHBsaWNhdGlvbi9tbW0vb2JqZWN0IiwKICA iQ3JlYXRlZCI6ICIyMDIwLTExLTAyVDE3OjI1OjU4WiJ9"}, "ewogICJBY3RpdmF0aW9uQWNjb3VudCI6IHt9fQ", { "signatures":[{ "alg":"S512", "kid":"MBXO-5JKI-OWJH-UH5T-C4SU-YKEE-D3FP", "signature":"b5skN0iKRohn0JGfQO9YzVWvPiB9uW4Df-co8k_m J8HxFGZUnPEJUKhcLcj0YRQIv1mS9VGFptQAR8UCxqNlxDsKPyzgYZSZ8Wfyoa5ZV voW15G2zBUAx3VjE9neXXVc0HvqD-TWchto0uTFcdK2njYA"} ], "PayloadDigest":"xgR5j7NiUbDvKWjP7IjI4HuMAPLD8-ru3cMITmgI iPuX9gh1llky1cgZPc1zU0wwYGKucV6mGegsV5wg7ZGYoA"} ]}}} 9.4. Contact A contact request presents a proposed contact entry and requests that it be added to the Contacts catalog of the specified Mesh Service Account. A contact request is usually sent by the party requesting that their contact be added but this is not necessarily the case. The MessageContact contains a DARE Envelope containing the Contact information of the requester. If the request is accepted, this information will be added to the contact catalog of the relevant account. If the Reply field has the value 'true', this indicates that the sender is asking for the recipient to return their own credentials in reply. Hallam-Baker Expires 6 May 2021 [Page 48] Internet-Draft Mesh Schema Reference November 2020 Since the sender requires the user's contact information before the request can be made, the MessageContact message MAY be encrypted under either the user's account encryption key (if known) or the Mesh Service encryption key (which may be obtained from the service on request. Bob asks Alice to send her contact details and sends his. { "MessageContact":{ "MessageId":"ND5Y-QMOY-42ZW-TE2Z-HJL2-7G3L-EQQB", "Sender":"bob@example.com", "Recipient":"alice@example.com", "AuthenticatedData":[{ "dig":"S512", "ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJDb250YWN0UGVy c29uIiwKICAiY3R5IjogImFwcGxpY2F0aW9uL21tbS9vYmplY3QiLAogICJDcmVhd GVkIjogIjIwMjAtMTEtMDJUMTc6MjU6NTRaIn0"}, "ewogICJDb250YWN0UGVyc29uIjogewogICAgIkFuY2hvcnMiOiBbewogICAg ICAgICJVZGYiOiAiTURNWi01UFdXLVUyN1MtSlNNNC1aTU9CLUJQWDMtSFZJTiIsC iAgICAgICAgIlZhbGlkYXRpb24iOiAiU2VsZiJ9XSwKICAgICJOZXR3b3JrQWRkcm Vzc2VzIjogW3sKICAgICAgICAiQWRkcmVzcyI6ICJib2JAZXhhbXBsZS5jb20iLAo gICAgICAgICJFbnZlbG9wZWRQcm9maWxlQWNjb3VudCI6IFt7CiAgICAgICAgICAg ICJFbnZlbG9wZUlEIjogIk1ETVotNVBXVy1VMjdTLUpTTTQtWk1PQi1CUFgzLUhWS U4iLAogICAgICAgICAgICAiZGlnIjogIlM1MTIiLAogICAgICAgICAgICAiQ29udG VudE1ldGFEYXRhIjogImV3b2dJQ0pWYm1seGRXVkpSQ0k2SUNKTlJFMWFMVFZRVjF jdFZUSTNVeTEKICBLVTAwMExWcE5UMEl0UWxCWU15MUlWa2xPSWl3S0lDQWlUV1Z6 YzJGblpWUjVjR1VpT2lBaVVISnZabWxzWgogIFZWelpYSWlMQW9nSUNKamRIa2lPa UFpWVhCd2JHbGpZWFJwYjI0dmJXMXRMMjlpYW1WamRDSXNDaUFnSWtOCiAgeVpXRj BaV1FpT2lBaU1qQXlNQzB4TVMwd01sUXhOem95TlRvMU5Gb2lmUSJ9LAogICAgICA gICAgImV3b2dJQ0pRY205bWFXeGxWWE5sY2lJNklIc0tJQ0FnSUNKUWNtOW1hV3gK ICBsVTJsbmJtRjBkWEpsSWpvZ2V3b2dJQ0FnSUNBaVZXUm1Jam9nSWsxRVRWb3ROV kJYVnkxVk1qZFRMVXBUVAogIFRRdFdrMVBRaTFDVUZnekxVaFdTVTRpTEFvZ0lDQW dJQ0FpVUhWaWJHbGpVR0Z5WVcxbGRHVnljeUk2SUhzCiAgS0lDQWdJQ0FnSUNBaVV IVmliR2xqUzJWNVJVTkVTQ0k2SUhzS0lDQWdJQ0FnSUNBZ0lDSmpjbllpT2lBaVIK ICBXUTBORGdpTEFvZ0lDQWdJQ0FnSUNBZ0lsQjFZbXhwWXlJNklDSnZjbUZ2UlVGV VYwdFFNMnRyTFVOMlF6QgogIElkRkI2YjFSeWFXMXVVbFpYYUVaT1ZGVldjR1JpUk dORVdqSjRPVWxaYVVScENpQWdhR3BYWjBoQk1UWnZTCiAgVGRIWWxOSlpVZHVSV0V 3WDBGQkluMTlmU3dLSUNBZ0lDSkJZMk52ZFc1MFFXUmtjbVZ6Y3lJNklDSmliMkoK ICBBWlhoaGJYQnNaUzVqYjIwaUxBb2dJQ0FnSWxObGNuWnBZMlZWWkdZaU9pQWlUV UpUVEMxSU5EVlFMVkJOTQogIDFjdFRsUlpTUzFPVFV0SExVdzBObFF0TlVoWFRTSX NDaUFnSUNBaVFXTmpiM1Z1ZEVWdVkzSjVjSFJwYjI0CiAgaU9pQjdDaUFnSUNBZ0l DSlZaR1lpT2lBaVRVTkNWQzFGU1VKU0xWRk9TVU10VGtSRlFTMVpORU5NTFUwMVYK ICBsWXRUMVpWV0NJc0NpQWdJQ0FnSUNKUWRXSnNhV05RWVhKaGJXVjBaWEp6SWpvZ 2V3b2dJQ0FnSUNBZ0lDSgogIFFkV0pzYVdOTFpYbEZRMFJJSWpvZ2V3b2dJQ0FnSU NBZ0lDQWdJbU55ZGlJNklDSllORFE0SWl3S0lDQWdJCiAgQ0FnSUNBZ0lDSlFkV0p zYVdNaU9pQWlZV28zY1hvMU9IZFVTVGhEYzB3M1pHcDNRbWhRUmkwMVJXOVZhbVIK ICBHVnpScldreHBZbVZOVW5WdFZqVkhlbkJoV2xGd01Bb2dJRlZVVFVsT04zUjJXR Hallam-Baker Expires 6 May 2021 [Page 49] Internet-Draft Mesh Schema Reference November 2020 XBJV1ZGSlQzSTNZVk5wTgogIEVNMlFTSjlmWDBzQ2lBZ0lDQWlRV1J0YVc1cGMzUn lZWFJ2Y2xOcFoyNWhkSFZ5WlNJNklIc0tJQ0FnSUNBCiAgZ0lsVmtaaUk2SUNKTlJ FMWFMVFZRVjFjdFZUSTNVeTFLVTAwMExWcE5UMEl0UWxCWU15MUlWa2xPSWl3S0kK ICBDQWdJQ0FnSWxCMVlteHBZMUJoY21GdFpYUmxjbk1pT2lCN0NpQWdJQ0FnSUNBZ 0lsQjFZbXhwWTB0bGVVVgogIERSRWdpT2lCN0NpQWdJQ0FnSUNBZ0lDQWlZM0oySW pvZ0lrVmtORFE0SWl3S0lDQWdJQ0FnSUNBZ0lDSlFkCiAgV0pzYVdNaU9pQWliM0p oYjBWQlZGZExVRE5yYXkxRGRrTXdTSFJRZW05VWNtbHRibEpXVjJoR1RsUlZWbkIK ICBrWWtSalJGb3llRGxKV1dsRWFRb2dJR2hxVjJkSVFURTJiMGszUjJKVFNXVkhia 1ZoTUY5QlFTSjlmWDBzQwogIGlBZ0lDQWlRV05qYjNWdWRFRjFkR2hsYm5ScFkyRj BhVzl1SWpvZ2V3b2dJQ0FnSUNBaVZXUm1Jam9nSWsxCiAgQlRra3RSakpCVUMxTFZ sbE5MVnBYVDFBdFRFYzNVUzFZVUZKTkxVeFNSMU1pTEFvZ0lDQWdJQ0FpVUhWaWIK ICBHbGpVR0Z5WVcxbGRHVnljeUk2SUhzS0lDQWdJQ0FnSUNBaVVIVmliR2xqUzJWN VJVTkVTQ0k2SUhzS0lDQQogIGdJQ0FnSUNBZ0lDSmpjbllpT2lBaVdEUTBPQ0lzQ2 lBZ0lDQWdJQ0FnSUNBaVVIVmliR2xqSWpvZ0luVnVWCiAgbmhmU1haeWVWbGZlamh EYzJkV2MzaHBSWGR4YlU1VUxWVkdNakEwVEdSbGVVNUZSMlJPUWxGa1drWk1kM3AK ICBSV1RRS0lDQm1Oa0p4YWtGclltVlhURlF0WkhGV2FXcHJSMFJyVFVFaWZYMTlMQ W9nSUNBZ0lrRmpZMjkxYgogIG5SVGFXZHVZWFIxY21VaU9pQjdDaUFnSUNBZ0lDSl ZaR1lpT2lBaVRVSlhXaTFITWpKQ0xVSkdRVlF0UmxkCiAgQlJ5MU9NMFZYTFZwVFV WY3RNelpQU0NJc0NpQWdJQ0FnSUNKUWRXSnNhV05RWVhKaGJXVjBaWEp6SWpvZ2UK ICB3b2dJQ0FnSUNBZ0lDSlFkV0pzYVdOTFpYbEZRMFJJSWpvZ2V3b2dJQ0FnSUNBZ 0lDQWdJbU55ZGlJNklDSgogIEZaRFEwT0NJc0NpQWdJQ0FnSUNBZ0lDQWlVSFZpYk dsaklqb2dJbXRhVldSSVMzVm5XbkZ1T0ZWb2VHcG1UCiAgMlZuZFhNeFRDMDNUelZ wZDJWelIzazNORTlLZW5sd1RFNDBORlJTVVU5SmVHUUtJQ0J3TTJObU4ybFdiMkYK ICBHVkRkRGFUZE9SRlJ2UWtsNlZVRWlmWDE5ZlgwIiwKICAgICAgICAgIHsKICAgI CAgICAgICAgInNpZ25hdHVyZXMiOiBbewogICAgICAgICAgICAgICAgImFsZyI6IC JTNTEyIiwKICAgICAgICAgICAgICAgICJraWQiOiAiTURNWi01UFdXLVUyN1MtSlN NNC1aTU9CLUJQWDMtSFZJTiIsCiAgICAgICAgICAgICAgICAic2lnbmF0dXJlIjog IlQtQUJzanZicGxXMlN3LUFLX0d6eFJ4OXBJb3BjNnZ0UF9FMDVlVmhaZWlpOEtkZ k4KICBmcGYxMGZTNWFtUkNYLUlCaGJIeXA4aHpONEFyc25aUFNZa25kQnBsTnJ0am U3NklhYjNpVFp5QUJoeFBVTAogIHpMMThnN1kxSGgyRVB2Rm9GeHFHazM5dWN6WkF UQlNMc3RUeXhIUjhBIn1dLAogICAgICAgICAgICAiUGF5bG9hZERpZ2VzdCI6ICI4 WHZWaUxjZExra0NfaW5uSlZRelM3Uk5XSGxCVVZmSDREd0Rqc1kweHNlQVkKICB6U nd4WDJRN2VyR01JLTFOT0NNV3MxSldWN2tabFlPNDBXYnJNMmJ5USJ9XSwKICAgIC AgICAiUHJvdG9jb2xzIjogW3sKICAgICAgICAgICAgIlByb3RvY29sIjogIm1tbSJ 9XX1dfX0", { "signatures":[{ "alg":"S512", "kid":"MBWZ-G22B-BFAT-FWAG-N3EW-ZSQW-36OH", "signature":"wN4bBu-tL_qZ1v74Teo2ZRQnwlxciiQOMRCf_Dgewq kuqGoWW22CLeDc7HJoYg22pTxKC7gCWFsAJm_kgR64jxSwZCb3JBAoDzuLQ-Qnb9B c4r4r4ZEDIQgvH45TFdhb5yRP7yqurQds2UMgVOemMS0A"} ], "PayloadDigest":"ofJhr9i1k27VRu81sCKWy7qEahxpuw0rtvwrQaYkag PBvVLkoNY2F6jLGCQ5Y42_9jMYVglcMVXhkB_AvYG52Q"} ], "Reply":true, "Subject":"alice@example.com", Hallam-Baker Expires 6 May 2021 [Page 50] Internet-Draft Mesh Schema Reference November 2020 "PIN":"AA3V-CH7O-FGHI-W2DP-VCCY-IRXB-IO2A"}} Alice responds with her own contact information. Since she already has Bob's contact information, there is no need to request a response or provide a PIN code. The current protocol assumes that all contact management will be performed end-to-end through the Mesh Services themselves. If the number of Mesh users were to become exceptionally large, additional infrastructure to facilitate contact management will be required. These topics are discussed at a high level in [draft-hallambaker-mesh-trust]. In situations where a user is well known and has a very large number of contacts, they are likely to make use of a tiered approach to contact management in which they keep separate accounts for their 'public' and 'restricted' personas and delegate management of their public account to a subordinate or to their Mesh Service provider. 9.5. Confirmation Confirmation messages are used to provide an improved form of second factor authentication capability. Two confirmation messages are specified, a request and response. A confirmation request is initiated by sending a "MessageConfirmationRequest" to the Mesh Service hosting the recipient Mesh Service Account. The request specifies the question that is to be put to the user. To respond to a confirmation request, a user generates a "MessageConfirmationResponse". This MUST be signed by a device authorized to respond to confirmation requests by a Device Connection Assertion with the "Confirmation" privilege. The console generates a confirmation request message: { "RequestConfirmation":{ "MessageId":"NC2K-XDLE-KNN2-GSLN-AEUX-WJXF-RA5B", "Sender":"console@example.com", "Recipient":"alice@example.com", "Text":"start"}} Alice accepts the request and returns a ResponseConfirmation confirmation containing both the request and the response: Hallam-Baker Expires 6 May 2021 [Page 51] Internet-Draft Mesh Schema Reference November 2020 Missing example 26 10. Publications Static QR codes MAY be used to allow contact exchange or device connection. In either case, the QR code contains an EARL providing the means of locating, decrypting and authenticating the published data. 10.1. Contact Exchange When used for contact exchange, the envelope payload is a CatalogedContact record. Besides allowing for exchange of contact information on a business card, a user might have their contact information printed on personal property to facilitate return of lost property. 10.2. Device Preconfiguration The static QR code device connection interaction allows a device with no keyboard, display or other user affordances to be connected to a Mesh account. The information necessary to establish communication with the device and to complete a device connection workflow is provided by means of a DevicePreconfiguration record accessed by means of an EARL. For example, Alice's coffee pot was preconfigured for connection to a Mesh account at the factory and the following DevicePreconfiguration record created: { "DevicePreconfiguration":{ "EnvelopedProfileDevice":[{ "EnvelopeID":"MCQ7-FFN4-3WCY-NDYU-CPFQ-XFH4-EHNV", "dig":"S512", "ContentMetaData":"ewogICJVbmlxdWVJRCI6ICJNQ1E3LUZGTjQtM1dD WS1ORFlVLUNQRlEtWEZINC1FSE5WIiwKICAiTWVzc2FnZVR5cGUiOiAiUHJvZmlsZ URldmljZSIsCiAgImN0eSI6ICJhcHBsaWNhdGlvbi9tbW0vb2JqZWN0IiwKICAiQ3 JlYXRlZCI6ICIyMDIwLTExLTAyVDE3OjI2OjAwWiJ9"}, "ewogICJQcm9maWxlRGV2aWNlIjogewogICAgIlByb2ZpbGVTaWduYXR1cmUi OiB7CiAgICAgICJVZGYiOiAiTUNRNy1GRk40LTNXQ1ktTkRZVS1DUEZRLVhGSDQtR UhOViIsCiAgICAgICJQdWJsaWNQYXJhbWV0ZXJzIjogewogICAgICAgICJQdWJsaW NLZXlFQ0RIIjogewogICAgICAgICAgImNydiI6ICJFZDQ0OCIsCiAgICAgICAgICA iUHVibGljIjogImR5UWdEZVpYMFk3dTVGRWxlckxiekZoYkdVVGozanJrTzViaXV0 bmQ5Q3VodFVQbnBOTTcKICBVRFRrNW90bWxvcmVpSjlPQmxuNzBMMEEifX19LAogI CAgIkJhc2VFbmNyeXB0aW9uIjogewogICAgICAiVWRmIjogIk1BRkYtNFA1NC1PUl Hallam-Baker Expires 6 May 2021 [Page 52] Internet-Draft Mesh Schema Reference November 2020 lGLVNCQU4tNlhRNy1DTzZTLU9YV1EiLAogICAgICAiUHVibGljUGFyYW1ldGVycyI 6IHsKICAgICAgICAiUHVibGljS2V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAi WDQ0OCIsCiAgICAgICAgICAiUHVibGljIjogIjdyRWpsVGNsRVBBb3l0WkxHSmJmN S1lTzhtQldMbE5hZXZKM1lBdF9hUmhKQWhlLVJPWUwKICBfQVNmQnVLRUw5ZDBPOH BDRGxXendBMkEifX19LAogICAgIkJhc2VBdXRoZW50aWNhdGlvbiI6IHsKICAgICA gIlVkZiI6ICJNQU5CLURZWEUtN0NOQy1XNkxXLTNSNkktQkxBQi0yVEtDIiwKICAg ICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tleUVDREgiO iB7CiAgICAgICAgICAiY3J2IjogIlg0NDgiLAogICAgICAgICAgIlB1YmxpYyI6IC JCb1lfd3hMdHhLMU1zRk9oT0VzOExrWTZIWTZONng0NmkwTF9NSkxNQU1rcXdzQXl peW1SCiAgazZwVjR2dnRDYzZEekJPOExGX01XWWdBIn19fSwKICAgICJCYXNlU2ln bmF0dXJlIjogewogICAgICAiVWRmIjogIk1BVzctWUlPMy01QTdNLTU1WVUtT1o3V y1CSkZULVFUSFciLAogICAgICAiUHVibGljUGFyYW1ldGVycyI6IHsKICAgICAgIC AiUHVibGljS2V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAiRWQ0NDgiLAogICA gICAgICAgIlB1YmxpYyI6ICJQc2Y4dG9qRTZPNFE3SllCWGU0ci1iZExRZHk0RTh0 ek1URTNBRENzNE93WEt5bldydmxxCiAgTzdjeUdjWDFXbjZiZDJWNWhMRjQ4UjhBI n19fX19", { "signatures":[{ "alg":"S512", "kid":"MCQ7-FFN4-3WCY-NDYU-CPFQ-XFH4-EHNV", "signature":"lVcSWqEEVvr-AsnhUeUQ4OwnIa-enZ3ZXre4sc3M3b JY_tre8U0e_AfM-VFERgN7OQ67OBatfj8AqZLU6SxhaJHira3uZbw1Ha8yQXMXSed pPm9hefDHb0-zwT80Pr0530SByJmW2uU5sQUh1rxmhiAA"} ], "PayloadDigest":"KflhE7fsBB_6jk4XP2sFRVtoqIj5zZ2j3QISDfuLTw se9bZBKTY8IPcGTlXtnaBTEH4P9smbO6AB6EDy8Nnegw"} ], "EnvelopedConnectionDevice":[{ "dig":"S512", "ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJDb25uZWN0aW9u RGV2aWNlIiwKICAiY3R5IjogImFwcGxpY2F0aW9uL21tbS9vYmplY3QiLAogICJDc mVhdGVkIjogIjIwMjAtMTEtMDJUMTc6MjY6MDBaIn0"}, "ewogICJDb25uZWN0aW9uRGV2aWNlIjogewogICAgIkRldmljZVNpZ25hdHVy ZSI6IHsKICAgICAgIlVkZiI6ICJNQVc3LVlJTzMtNUE3TS01NVlVLU9aN1ctQkpGV C1RVEhXIiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1Ym xpY0tleUVDREgiOiB7CiAgICAgICAgICAiY3J2IjogIkVkNDQ4IiwKICAgICAgICA gICJQdWJsaWMiOiAiUHNmOHRvakU2TzRRN0pZQlhlNHItYmRMUWR5NEU4dHpNVEUz QURDczRPd1hLeW5XcnZscQogIE83Y3lHY1gxV242YmQyVjVoTEY0OFI4QSJ9fX0sC iAgICAiRGV2aWNlRW5jcnlwdGlvbiI6IHsKICAgICAgIlVkZiI6ICJNQUZGLTRQNT QtT1JZRi1TQkFOLTZYUTctQ082Uy1PWFdRIiwKICAgICAgIlB1YmxpY1BhcmFtZXR lcnMiOiB7CiAgICAgICAgIlB1YmxpY0tleUVDREgiOiB7CiAgICAgICAgICAiY3J2 IjogIlg0NDgiLAogICAgICAgICAgIlB1YmxpYyI6ICI3ckVqbFRjbEVQQW95dFpMR 0piZjUtZU84bUJXTGxOYWV2SjNZQXRfYVJoSkFoZS1ST1lMCiAgX0FTZkJ1S0VMOW QwTzhwQ0RsV3p3QTJBIn19fSwKICAgICJEZXZpY2VBdXRoZW50aWNhdGlvbiI6IHs KICAgICAgIlVkZiI6ICJNQUZGLTRQNTQtT1JZRi1TQkFOLTZYUTctQ082Uy1PWFdR IiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tle UVDREgiOiB7CiAgICAgICAgICAiY3J2IjogIlg0NDgiLAogICAgICAgICAgIlB1Ym xpYyI6ICI3ckVqbFRjbEVQQW95dFpMR0piZjUtZU84bUJXTGxOYWV2SjNZQXRfYVJ Hallam-Baker Expires 6 May 2021 [Page 53] Internet-Draft Mesh Schema Reference November 2020 oSkFoZS1ST1lMCiAgX0FTZkJ1S0VMOWQwTzhwQ0RsV3p3QTJBIn19fX19", { "signatures":[{ "alg":"S512", "kid":"MDJN-Y22I-NBWS-TF2I-7HJV-N4JS-T5GU", "signature":"3dKPeRJ1OFB-h3Mt99GDJf4slU8XjkmkrmucvEbdlm dbxl7pf_7Wi8PxjtH2xwCDD8IqamVPGaiAmK6slj2-dHfQfpOAl7hMkyKFE3W5sR2 t9DGrYCqZU9J-rUd1eLc8wUh3kSZ08MDVGEcCcLEZuD4A"} ], "PayloadDigest":"rIuHcY2LV8tgbaFHN88oYDGytN5Giv1KTyQGDifkwX -HBK1IsApCD_pJ4h5jpG9fx9TSIqEiuMIb7iHqheByWg"} ], "PrivateKey":{ "PrivateKeyUDF":{ "PrivateValue":"ZAAQ-AAQT-ZDDI-IU7M-ORQA-YRRR-MMEH-D4PN-3YP W-HGJH-FXSR-BZXH-PYMG-KZBC", "KeyType":"MeshProfileDevice"}}, "ConnectUri":"mcu://maker@example.com/ECO6-IN3T-HZYJ-S7W4-T4XZ- JX6R-Y5SO-ATKN-TU2E-MDAF-VJEA-JV6Z-BOXE-G"}} To connect to the coffee pot, Alice first scans the QR code with her administrative device which uses the PIN code and service to retrieve, decrypt and authenticate the DevicePreconfiguration record. Future versions of the specification will allow this record to specify means by which the administration device can establish direct peer-to-peer communication to complete the connection process by any communication modality supported by both devices (e.g. IR, Bluetooth, WiFi-Direct, etc.) 11. Schema 11.1. Shared Classes The following classes are used as common elements in Mesh profile specifications. 11.1.1. Classes describing keys 11.1.2. Structure: KeyData The KeyData class is used to describe public key pairs and trust assertions associated with a public key. Udf: String (Optional) UDF fingerprint of the public key parameters X509Certificate: Binary (Optional) List of X.509 Certificates X509Chain: Binary [0..Many] X.509 Certificate chain. Hallam-Baker Expires 6 May 2021 [Page 54] Internet-Draft Mesh Schema Reference November 2020 X509CSR: Binary (Optional) X.509 Certificate Signing Request. NotBefore: DateTime (Optional) If present specifies a time instant that use of the private key is not valid before. NotOnOrAfter: DateTime (Optional) If present specifies a time instant that use of the private key is not valid on or after. 11.1.3. Structure: CompositePrivate Inherits: Key DeviceKeyUdf: String (Optional) UDF fingerprint of the bound device key (if used). 11.2. Assertion classes Classes that are derived from an assertion. 11.2.1. Structure: Assertion Parent class from which all assertion classes are derived Names: String [0..Many] Fingerprints of index terms for profile retrieval. The use of the fingerprint of the name rather than the name itself is a precaution against enumeration attacks and other forms of abuse. Updated: DateTime (Optional) The time instant the profile was last modified. NotaryToken: String (Optional) A Uniform Notary Token providing evidence that a signature was performed after the notary token was created. 11.2.2. Structure: Condition Parent class from which all condition classes are derived. [No fields] 11.2.3. Base Classes Abstract classes from which the Profile, Activation and Connection classes are derrived. Hallam-Baker Expires 6 May 2021 [Page 55] Internet-Draft Mesh Schema Reference November 2020 11.2.4. Structure: Connection Inherits: Assertion SubjectUdf: String (Optional) UDF of the connection target. AuthorityUdf: String (Optional) UDF of the connection source. 11.2.5. Structure: Activation Inherits: Assertion Contains the private activation information for a Mesh application running on a specific device ActivationKey: String (Optional) Secret seed used to derive keys that are not explicitly specified. Entries: ActivationEntry [0..Many] Activation of named resources. 11.2.6. Structure: ActivationEntry Resource: String (Optional) Name of the activated resource Key: KeyData (Optional) The activation key or key share 11.2.7. Mesh Profile Classes Classes describing Mesh Profiles. All Profiles are Assertions derrived from Assertion. 11.2.8. Structure: Profile Inherits: Assertion Parent class from which all profile classes are derived ProfileSignature: KeyData (Optional) The permanent signature key used to sign the profile itself. The UDF of the key is used as the permanent object identifier of the profile. Thus, by definition, the KeySignature value of a Profile does not change under any circumstance. 11.2.9. Structure: ProfileDevice Inherits: Profile Describes a mesh device. Hallam-Baker Expires 6 May 2021 [Page 56] Internet-Draft Mesh Schema Reference November 2020 Description: String (Optional) Description of the device BaseEncryption: KeyData (Optional) Base key contribution for encryption keys. Also used to decrypt activation data sent to the device during connection to an account. BaseAuthentication: KeyData (Optional) Base key contribution for authentication keys. Also used to authenticate the device during connection to an account. BaseSignature: KeyData (Optional) Base key contribution for signature keys. 11.2.10. Structure: ProfileAccount Base class for the account profiles ProfileUser and ProfileGroup. These subclasses may be merged at some future date. Inherits: Profile AccountAddress: String (Optional) The account address. This is either a DNS service address (e.g. alice@example.com) or a Mesh Name (@alice). ServiceUdf: String (Optional) The fingerprint of the service profile to which the account is currently bound. EscrowEncryption: KeyData (Optional) Escrow key associated with the account. AccountEncryption: KeyData (Optional) Key currently used to encrypt data under this profile AdministratorSignature: KeyData (Optional) Key used to sign connection assertions to the account. 11.2.11. Structure: ProfileUser Inherits: ProfileAccount Account assertion. This is signed by the service hosting the account. AccountAuthentication: KeyData (Optional) Key used to authenticate requests made under this user account. AccountSignature: KeyData (Optional) Key used to sign data under the account. Hallam-Baker Expires 6 May 2021 [Page 57] Internet-Draft Mesh Schema Reference November 2020 11.2.12. Structure: ProfileGroup Inherits: ProfileAccount Describes a group. Note that while a group is created by one person who becomes its first administrator, control of the group may pass to other administrators over time. [No fields] 11.2.13. Structure: ProfileService Inherits: Profile Profile of a Mesh Service ServiceAuthentication: KeyData (Optional) Key used to authenticate service connections. ServiceEncryption: KeyData (Optional) Key used to encrypt data under this profile ServiceSignature: KeyData (Optional) Key used to sign data under the account. 11.2.14. Structure: ProfileHost Inherits: Profile KeyAuthentication: KeyData (Optional) Key used to authenticate service connections. KeyEncryption: KeyData (Optional) Key used to pass encrypted data to the device such as a 11.2.15. Connection Assertions Connection assertions are used to authenticate and authorize interactions between devices and the service currently servicing the account. They SHOULD NOT be visible to external parties. 11.2.16. Structure: ConnectionDevice Inherits: Connection Connection assertion used to authenticate service requests made by a device. Hallam-Baker Expires 6 May 2021 [Page 58] Internet-Draft Mesh Schema Reference November 2020 AccountAddress: String (Optional) The account address DeviceSignature: KeyData (Optional) The signature key for use of the device under the profile DeviceEncryption: KeyData (Optional) The encryption key for use of the device under the profile DeviceAuthentication: KeyData (Optional) The authentication key for use of the device under the profile 11.2.17. Structure: ConnectionApplication Inherits: Connection Connection assertion stating that a particular device is [No fields] 11.2.18. Structure: ConnectionGroup Describes the connection of a member to a group. Inherits: Connection [No fields] 11.2.19. Structure: ConnectionService Inherits: Connection [No fields] 11.2.20. Structure: ConnectionHost Inherits: Connection [No fields] 11.2.21. Activation Assertions 11.2.22. Structure: ActivationDevice Contains activation data for device specific keys used in the context of a Mesh account. Inherits: Activation Hallam-Baker Expires 6 May 2021 [Page 59] Internet-Draft Mesh Schema Reference November 2020 AccountUdf: String (Optional) The UDF of the account 11.2.23. Structure: ActivationAccount Inherits: Activation ProfileSignature: KeyData (Optional) Grant access to profile online signing key used to sign updates to the profile. AdministratorSignature: KeyData (Optional) Grant access to Profile administration key used to make changes to administrator catalogs. AccountEncryption: KeyData (Optional) Grant access to ProfileUser account encryption key AccountAuthentication: KeyData (Optional) Grant access to ProfileUser account authentication key AccountSignature: KeyData (Optional) Grant access to ProfileUser account signature key 11.2.24. Structure: ActivationApplication Inherits: Activation [No fields] 11.3. Data Structures Classes describing data used in cataloged data. 11.3.1. Structure: Contact Inherits: Assertion Base class for contact entries. Id: String (Optional) The globally unique contact identifier. Anchors: Anchor [0..Many] Mesh fingerprints associated with the contact. NetworkAddresses: NetworkAddress [0..Many] Network address entries Locations: Location [0..Many] The physical locations the contact is associated with. Roles: Role [0..Many] The roles of the contact Hallam-Baker Expires 6 May 2021 [Page 60] Internet-Draft Mesh Schema Reference November 2020 Bookmark: Bookmark [0..Many] The Web sites and other online presences of the contact Sources: TaggedSource [0..Many] Source(s) from which this contact was constructed. 11.3.2. Structure: Anchor Trust anchor Udf: String (Optional) The trust anchor. Validation: String (Optional) The means of validation. 11.3.3. Structure: TaggedSource Source from which contact information was obtained. LocalName: String (Optional) Short name for the contact information. Validation: String (Optional) The means of validation. BinarySource: Binary (Optional) The contact data in binary form. EnvelopedSource: Enveloped (Optional) The contact data in enveloped form. If present, the BinarySource property is ignored. 11.3.4. Structure: ContactGroup Inherits: Contact Contact for a group, including encryption groups. [No fields] 11.3.5. Structure: ContactPerson Inherits: Contact CommonNames: PersonName [0..Many] List of person names in order of preference 11.3.6. Structure: ContactOrganization Inherits: Contact CommonNames: OrganizationName [0..Many] List of person names in order of preference Hallam-Baker Expires 6 May 2021 [Page 61] Internet-Draft Mesh Schema Reference November 2020 11.3.7. Structure: OrganizationName The name of an organization Inactive: Boolean (Optional) If true, the name is not in current use. RegisteredName: String (Optional) The registered name. DBA: String (Optional) Names that the organization uses including trading names and doing business as names. 11.3.8. Structure: PersonName The name of a natural person Inactive: Boolean (Optional) If true, the name is not in current use. FullName: String (Optional) The preferred presentation of the full name. Prefix: String (Optional) Honorific or title, E.g. Sir, Lord, Dr., Mr. First: String (Optional) First name. Middle: String [0..Many] Middle names or initials. Last: String (Optional) Last name. Suffix: String (Optional) Nominal suffix, e.g. Jr., III, etc. PostNominal: String (Optional) Post nominal letters (if used). 11.3.9. Structure: NetworkAddress Provides all means of contacting the individual according to a particular network address Inactive: Boolean (Optional) If true, the name is not in current use. Address: String (Optional) The network address, e.g. alice@example.com NetworkCapability: String [0..Many] The capabilities bound to this address. Hallam-Baker Expires 6 May 2021 [Page 62] Internet-Draft Mesh Schema Reference November 2020 EnvelopedProfileAccount: Enveloped (Optional) The account profile Protocols: NetworkProtocol [0..Many] Public keys associated with the network address 11.3.10. Structure: NetworkProtocol Protocol: String (Optional) The IANA protocol|identifier of the network protocols by which the contact may be reached using the specified Address. 11.3.11. Structure: Role OrganizationName: String (Optional) The organization at which the role is held Titles: String [0..Many] The titles held with respect to that organization. Locations: Location [0..Many] Postal or physical addresses associated with the role. 11.3.12. Structure: Location Appartment: String (Optional) Street: String (Optional) District: String (Optional) Locality: String (Optional) County: String (Optional) Postcode: String (Optional) Country: String (Optional) 11.3.13. Structure: Bookmark Uri: String (Optional) Title: String (Optional) Role: String [0..Many] Hallam-Baker Expires 6 May 2021 [Page 63] Internet-Draft Mesh Schema Reference November 2020 11.3.14. Structure: Reference MessageId: String (Optional) The received message to which this is a response ResponseId: String (Optional) Message that was generated in response to the original (optional). Relationship: String (Optional) The relationship type. This can be Read, Unread, Accept, Reject. 11.3.15. Structure: Task Key: String (Optional) Unique key. Start: DateTime (Optional) Finish: DateTime (Optional) StartTravel: String (Optional) FinishTravel: String (Optional) TimeZone: String (Optional) Title: String (Optional) Description: String (Optional) Location: String (Optional) Trigger: String [0..Many] Conference: String [0..Many] Repeat: String (Optional) Busy: Boolean (Optional) 11.4. Catalog Entries 11.4.1. Structure: CatalogedEntry Base class for cataloged Mesh data. Labels: String [0..Many] The set of labels describing the entry Hallam-Baker Expires 6 May 2021 [Page 64] Internet-Draft Mesh Schema Reference November 2020 11.4.2. Structure: CatalogedDevice Inherits: CatalogedEntry Public device entry, indexed under the device ID Hello Udf: String (Optional) UDF of the signature key of the device in the Mesh DeviceUdf: String (Optional) UDF of the offline signature key of the device SignatureUdf: String (Optional) UDF of the account online signature key EnvelopedProfileUser: Enveloped (Optional) The Mesh profile EnvelopedProfileDevice: Enveloped (Optional) The device profile EnvelopedConnectionUser: Enveloped (Optional) The public assertion demonstrating connection of the Device to the Mesh EnvelopedActivationDevice: Enveloped (Optional) The activation of the device within the Mesh account EnvelopedActivationAccount: Enveloped (Optional) The activation of the device within the Mesh account EnvelopedActivationApplication: Enveloped [0..Many] Application activations granted to the device. 11.4.3. Structure: CatalogedPublication Inherits: CatalogedEntry A publication. Id: String (Optional) Unique identifier code Authenticator: String (Optional) The witness key value to use to request access to the record. EnvelopedData: DareEnvelope (Optional) Dare Envelope containing the entry data. The data type is specified by the envelope metadata. NotOnOrAfter: DateTime (Optional) Epiration time (inclusive) Hallam-Baker Expires 6 May 2021 [Page 65] Internet-Draft Mesh Schema Reference November 2020 11.4.4. Structure: CatalogedCredential Inherits: CatalogedEntry Protocol: String (Optional) Service: String (Optional) Username: String (Optional) Password: String (Optional) 11.4.5. Structure: CatalogedNetwork Inherits: CatalogedEntry Protocol: String (Optional) Service: String (Optional) Username: String (Optional) Password: String (Optional) 11.4.6. Structure: CatalogedContact Inherits: CatalogedEntry Key: String (Optional) Unique key. Self: Boolean (Optional) If true, this catalog entry is for the user who created the catalog. 11.4.7. Structure: CatalogedAccess Inherits: CatalogedEntry [No fields] 11.4.8. Structure: CryptographicCapability Id: String (Optional) The identifier of the capability. If this is a user capability, MUST match the KeyData identifier. If this is a serviced capability, MUST match the value of ServiceId on the corresponding service capability. KeyData: KeyData (Optional) The key that enables the capability Hallam-Baker Expires 6 May 2021 [Page 66] Internet-Draft Mesh Schema Reference November 2020 EnvelopedKeyShares: Enveloped [0..Many] One or more enveloped key shares. SubjectId: String (Optional) The identifier of the resource that is controlled using the key. SubjectAddress: String (Optional) The address of the resource that is controlled using the key. 11.4.9. Structure: CapabilityDecrypt Inherits: CryptographicCapability The corresponding key is a decryption key [No fields] 11.4.10. Structure: CapabilityDecryptPartial Inherits: CapabilityDecrypt The corresponding key is an encryption key ServiceId: String (Optional) The identifier used to claim the capability from the service.[Only present for a partial capability.] ServiceAddress: String (Optional) The service account that supports a serviced capability. [Only present for a partial capability.] 11.4.11. Structure: CapabilityDecryptServiced Inherits: CapabilityDecrypt The corresponding key is an encryption key AuthenticationId: String (Optional) UDF of trust root under which request to use a serviced capability must be authorized. [Only present for a serviced capability] 11.4.12. Structure: CapabilitySign Inherits: CryptographicCapability The corresponding key is an administration key [No fields] Hallam-Baker Expires 6 May 2021 [Page 67] Internet-Draft Mesh Schema Reference November 2020 11.4.13. Structure: CapabilityKeyGenerate Inherits: CryptographicCapability The corresponding key is a key that may be used to generate key shares. [No fields] 11.4.14. Structure: CapabilityFairExchange Inherits: CryptographicCapability The corresponding key is a decryption key to be used in accordance with the Micali Fair Electronic Exchange with Invisible Trusted Parties protocol. [No fields] 11.4.15. Structure: CatalogedBookmark Inherits: CatalogedEntry Uri: String (Optional) Title: String (Optional) Path: String (Optional) 11.4.16. Structure: CatalogedTask Inherits: CatalogedEntry EnvelopedTask: Enveloped (Optional) Title: String (Optional) Key: String (Optional) Unique key. 11.4.17. Structure: CatalogedApplication Inherits: CatalogedEntry Key: String (Optional) EnvelopedCapabilities: DareEnvelope [0..Many] Enveloped keys for use with Application Hallam-Baker Expires 6 May 2021 [Page 68] Internet-Draft Mesh Schema Reference November 2020 11.4.18. Structure: CatalogedMember ContactAddress: String (Optional) MemberCapabilityId: String (Optional) ServiceCapabilityId: String (Optional) Inherits: CatalogedEntry 11.4.19. Structure: CatalogedGroup Inherits: CatalogedApplication EnvelopedProfileGroup: Enveloped (Optional) The Mesh profile EnvelopedActivationAccount: Enveloped (Optional) The activation of the device within the Mesh account 11.4.20. Structure: CatalogedApplicationSSH Inherits: CatalogedApplication [No fields] 11.4.21. Structure: CatalogedApplicationMail Inherits: CatalogedApplication [No fields] 11.4.22. Structure: CatalogedApplicationNetwork Inherits: CatalogedApplication [No fields] 11.5. Publications 11.5.1. Structure: DevicePreconfiguration A data structure that is passed EnvelopedProfileDevice: Enveloped (Optional) The device profile EnvelopedConnectionDevice: Enveloped (Optional) The device connection Hallam-Baker Expires 6 May 2021 [Page 69] Internet-Draft Mesh Schema Reference November 2020 ConnectUri: String (Optional) The connection URI. This would normally be printed on the device as a QR code. 11.6. Messages 11.6.1. Structure: Message MessageId: String (Optional) Unique per-message ID. When encapsulating a Mesh Message in a DARE envelope, the envelope EnvelopeID field MUST be a UDF fingerprint of the MessageId value. Sender: String (Optional) Recipient: String (Optional) 11.6.2. Structure: MessageError Inherits: Message ErrorCode: String (Optional) 11.6.3. Structure: MessageComplete Inherits: Message References: Reference [0..Many] 11.6.4. Structure: MessagePinValidated Inherits: Message AuthenticatedData: DareEnvelope (Optional) Enveloped data that is authenticated by means of the PIN ClientNonce: Binary (Optional) Nonce provided by the client to validate the PIN PinId: String (Optional) Pin identifier value calculated from the PIN code, action and account address. PinWitness: Binary (Optional) Witness value calculated as KDF (Device.Udf + AccountAddress, ClientNonce) 11.6.5. Structure: MessagePin Account: String (Optional) Inherits: Message Hallam-Baker Expires 6 May 2021 [Page 70] Internet-Draft Mesh Schema Reference November 2020 Expires: DateTime (Optional) Automatic: Boolean (Optional) If true, authentication against the PIN code is sufficient to complete the associated action without further authorization. SaltedPin: String (Optional) PIN code bound to the specified action. Action: String (Optional) The action to which this PIN code is bound. 11.6.6. Structure: RequestConnection Connection request message. This message contains the information Inherits: MessagePinValidated AccountAddress: String (Optional) 11.6.7. Structure: AcknowledgeConnection Connection request message generated by a service on receipt of a valid MessageConnectionRequestClient Inherits: Message EnvelopedRequestConnection: Enveloped (Optional) The client connection request. ServerNonce: Binary (Optional) Witness: String (Optional) 11.6.8. Structure: RespondConnection Respond to RequestConnection message to grant or refuse the connection request. Inherits: Message Result: String (Optional) The response to the request. One of "Accept", "Reject" or "Pending". CatalogedDevice: CatalogedDevice (Optional) The device information. MUST be present if the value of Result is "Accept". MUST be absent or null otherwise. Hallam-Baker Expires 6 May 2021 [Page 71] Internet-Draft Mesh Schema Reference November 2020 11.6.9. Structure: MessageContact Inherits: MessagePinValidated Reply: Boolean (Optional) If true, requests that the recipient return their own contact information in reply. Subject: String (Optional) Optional explanation of the reason for the request. PIN: String (Optional) One time authentication code supplied to a recipient to allow authentication of the response. 11.6.10. Structure: GroupInvitation Inherits: Message Text: String (Optional) 11.6.11. Structure: RequestConfirmation Inherits: Message Text: String (Optional) 11.6.12. Structure: ResponseConfirmation Inherits: Message Request: Enveloped (Optional) Accept: Boolean (Optional) 11.6.13. Structure: RequestTask Inherits: Message [No fields] 11.6.14. Structure: MessageClaim Inherits: Message PublicationId: String (Optional) ServiceAuthenticate: String (Optional) DeviceAuthenticate: String (Optional) Hallam-Baker Expires 6 May 2021 [Page 72] Internet-Draft Mesh Schema Reference November 2020 Expires: DateTime (Optional) 11.6.15. Structure: ProcessResult For future use, allows logging of operations and results Inherits: Message Success: Boolean (Optional) ErrorReport: String (Optional) The error report code. 12. Security Considerations The security considerations for use and implementation of Mesh services and applications are described in the Mesh Security Considerations guide [draft-hallambaker-mesh-security]. 13. IANA Considerations All the IANA considerations for the Mesh documents are specified in this document 14. Acknowledgements A list of people who have contributed to the design of the Mesh is presented in [draft-hallambaker-mesh-architecture]. 15. Appendix A: Example Container Organization (not normative) The means by which profiles are stored on devices is outside the scope of the specification. Only catalogs that are required to be shared between machines by means of accounts need to be standardized. 15.1. Device Host Catalog: Host.dare Catalog of all the Mesh Profiles that the user has registered with the device and the latest version of the device profile for this device. MeshCatalog: [UDF-Mesh].dcat Catalog containing the Account Entries for the Mesh [UDF-Mesh]. Account Catalogs: [UDF-Account]/mmm_Device.dcat The device catalog associated with the specified account Account Catalogs: [UDF-Account]/[Catalog name].dcat The set of Hallam-Baker Expires 6 May 2021 [Page 73] Internet-Draft Mesh Schema Reference November 2020 account catalogs that are shared verbatim between the devices connected to the account. 15.1.1. Creating a new Mesh Create new Mesh Profile, Device Profile, Add to Host Catalog Create MeshCatalog 15.1.2. Adding an Account Create new Account Profile, Add to MeshCatalog Create new Account Device Catalog For each device to be added to the account: Create Account Connection Assertion, add to Account Device Catalog. 15.1.3. Adding a Device Create a Device Connection Assertion. For each account the device is to be added to: Create Account Connection Assertion, add to Account Device Catalog. 15.2. Service Master Catalog Catalog of all services on machine Service Catalog Catalog of accounts in the service. 15.2.1. Creating a Service Create a Service Description, add to Master Catalog 15.2.2. Adding an Account Create the account entry, add to Service Catalog Create the Account Directory 16. Appendix B: Collected Authentication and Encryption Requirements Hallam-Baker Expires 6 May 2021 [Page 74] Internet-Draft Mesh Schema Reference November 2020 16.1. Mesh Messaging +=======================+=========+==================+ | Message | Signer | Recipients | +=======================+=========+==================+ | RequestConnection | Device | Service | +-----------------------+---------+------------------+ | AcknowledgeConnection | Service | Device, Receiver | +-----------------------+---------+------------------+ | OfferGroup | Sender | Receiver | +-----------------------+---------+------------------+ | RequestContact | Sender | Receiver | +-----------------------+---------+------------------+ | ReplyContact | Sender | Receiver | +-----------------------+---------+------------------+ | RequestConfirmation | Sender | Receiver | +-----------------------+---------+------------------+ | ResponseConfirmation | Sender | Receiver | +-----------------------+---------+------------------+ | RequestTask | Sender | Receiver | +-----------------------+---------+------------------+ | ResponseTask | Sender | Receiver | +-----------------------+---------+------------------+ Table 2 17. Normative References [draft-hallambaker-mesh-architecture] Hallam-Baker, P., "Mathematical Mesh 3.0 Part I: Architecture Guide", Work in Progress, Internet-Draft, draft-hallambaker-mesh-architecture-14, 27 July 2020, . [draft-hallambaker-mesh-cryptography] Hallam-Baker, P., "Mathematical Mesh 3.0 Part VIII: Cryptographic Algorithms", Work in Progress, Internet- Draft, draft-hallambaker-mesh-cryptography-06, 27 July 2020, . [draft-hallambaker-mesh-discovery] "[Reference Not Found!]". Hallam-Baker Expires 6 May 2021 [Page 75] Internet-Draft Mesh Schema Reference November 2020 [draft-hallambaker-mesh-notary] "[Reference Not Found!]". [draft-hallambaker-mesh-protocol] Hallam-Baker, P., "Mathematical Mesh 3.0 Part V: Protocol Reference", Work in Progress, Internet-Draft, draft- hallambaker-mesh-protocol-06, 27 July 2020, . [draft-hallambaker-mesh-security] Hallam-Baker, P., "Mathematical Mesh 3.0 Part VII: Security Considerations", Work in Progress, Internet- Draft, draft-hallambaker-mesh-security-05, 27 July 2020, . [draft-hallambaker-mesh-udf] Hallam-Baker, P., "Mathematical Mesh 3.0 Part II: Uniform Data Fingerprint.", Work in Progress, Internet-Draft, draft-hallambaker-mesh-udf-10, 27 July 2020, . [draft-hallambaker-threshold] Hallam-Baker, P., "Threshold Modes in Elliptic Curves", Work in Progress, Internet-Draft, draft-hallambaker- threshold-03, 3 September 2020, . [draft-hallambaker-threshold-sigs] Hallam-Baker, P., "Threshold Signatures in Elliptic Curves", Work in Progress, Internet-Draft, draft- hallambaker-threshold-sigs-04, 3 September 2020, . [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, . 18. Informative References [draft-hallambaker-mesh-developer] Hallam-Baker, P., "Mathematical Mesh: Reference Implementation", Work in Progress, Internet-Draft, draft- Hallam-Baker Expires 6 May 2021 [Page 76] Internet-Draft Mesh Schema Reference November 2020 hallambaker-mesh-developer-10, 27 July 2020, . [draft-hallambaker-mesh-trust] Hallam-Baker, P., "Mathematical Mesh 3.0 Part VI: The Trust Mesh", Work in Progress, Internet-Draft, draft- hallambaker-mesh-trust-06, 27 July 2020, . [RFC2426] Dawson, F. and T. Howes, "vCard MIME Directory Profile", RFC 2426, DOI 10.17487/RFC2426, September 1998, . [RFC5545] Desruisseaux, B., "Internet Calendaring and Scheduling Core Object Specification (iCalendar)", RFC 5545, DOI 10.17487/RFC5545, September 2009, . Hallam-Baker Expires 6 May 2021 [Page 77]