| Internet-Draft | Mesh Protocol Reference | October 2022 |
| Hallam-Baker | Expires 26 April 2023 | [Page] |
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-protocol.html.¶
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 26 April 2023.¶
Copyright (c) 2022 IETF Trust and the persons identified as the document authors. All rights reserved.¶
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document.¶
This document describes the Mesh Service protocol supported by Mesh Services, an account-based protocol that facilitates exchange of data between devices connected to a Mesh profile and between Mesh accounts.¶
Mesh Service Accounts support the following services:¶
A Mesh Profile MAY be bound to multiple Mesh Service Accounts at the same time but only one Mesh Service Account is considered to be authoritative at a time. Users may add or remove Mesh Service Accounts and change the account designated as authoritative at any time.¶
The Mesh Services are build from a very small set of primitives which provide a surprisingly extensive set of capabilities. These primitives are:¶
HelloDescribes the features and options provided by the service and provides a 'null' transaction which MAY be used to establish an authentication ticket without performing any action,¶
Manage the creation and deletion of accounts at the service.¶
Upload
Support synchronization of Mesh containers between the service (Master) and the connected devices (Replicas).¶
Initiate the process of connecting a device to a Mesh profile from the device itself.¶
Request that a Mesh Message be transferred to one or more Mesh Accounts.¶
Although these functions could in principle be used to replace many if not most existing Internet application protocols, the principal value of any communication protocol lies in the size of 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.¶
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.¶
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].¶
The terms of art used in this document are described in the Mesh Architecture Guide [draft-hallambaker-mesh-architecture].¶
The implementation status of the reference code base is described in the companion document [draft-hallambaker-mesh-developer].¶
The Mesh specifies two separate types of protocol interactions:¶
A synchronous protocol supporting interactions between devices and a Mesh Service Host and between Mesh Service hosts.¶
An asynchronous protocol that supports interactions between devices connected to the same account and between accounts.¶
The Mesh Messaging Protocol uses the Mesh Service Protocol as transport. The Mesh Service Protocol in turn makes use of Reliable UDP Datagram (RUD) [draft-hallambaker-mesh-rud] for framing and authentication of individual requests and responses. These RUS packets are in turn exchanged over either HTTPS (i.e. a Web Service) or directly over UDP.¶
Mesh Services MUST support the HTTPS binding and MAY support the UDP binding.¶
A Mesh Service is a minimally trusted service. In particular a user does not need to trust a Mesh service to protect the confidentiality or integrity of most data stored in the account catalogs and spools.¶
Unless the use of the Mesh Service is highly restricted, a user does need to trust the Mesh Service in certain respects:¶
A service could refuse to respond to requests to download data.¶
The use of Merkle Trees limits but does not eliminate the ability of a Mesh Service to respond to requests with stale data.¶
A service could reject requests to post messages to or accept messages from other mesh users.¶
This risk is a necessary consequence of the fact that the Mesh Service Provider is accountable to other Mesh Service Providers for abuse originating from their service.¶
A Mesh Service has knowledge of the number of Mesh Messages being sent and received by its users and the addresses to which they are being sent to or received from.¶
The need to trust the Mesh Service in these respects is mitigated by accountability and the user's ability to change Mesh Service providers at any time they choose with minimal inconvenience.¶
It is possible that some of these risks will be reduced in future versions of the Mesh Service Protocol but it is highly unlikely that these can be eliminated entirely without compromising practicality or efficiency.¶
The design of the Mesh Service model followed a quasi-formal approach in which the system was reduced to schemas which could in principle be rendered in a formal development method but without construction of proofs.¶
Like the contents of Mesh Accounts, a Mesh Service may be represented by a collection of catalogs and spools, for example:¶
Backup of the service MAY be implemented using the same container synchronization mechanism used to synchronize account catalogs and spools.¶
Mesh Services supporting a large number of accounts or large activity volume MAY partition the account catalog between one or more hosts using the usual tiered service model in which a front-end server receives traffic for any account hosted at the server and routes the request to the back-end service that provides the persistence store for that account.¶
In addition, the Mesh Service Protocol supports a 'direct connection' partitioning model in which devices are given a DNS name which MAY allow for direct connection to the persistence host or to a front-end service offering service that is in some way specific to that account.¶
The protocol binding maps the abstract protocol definition specified in this document to the network protocol format.¶
Currently only one protocol binding is specified: JSON-BCD Application Binding [draft-hallambaker-jsonbcd] over Reliable User Datagram (RUD) [draft-hallambaker-mesh-rud].¶
JSON-BCD Application Binding specifies the means by which data types such as 'integer' and 'datetime' etc. given in this document are serialized using JSON/JSON-B encoding.¶
Reliable User Datagram offers a presentation layer over a choice of HTTP or UDP transport.¶
The Mesh Service operations are divided into the following functional groups:¶
Describes the service.¶
Operations used to create, reclaim, and delete accounts.¶
Operations used to synchronize persistence store data across connected devices. [May be replaced in a future revision]¶
Operations used by devices requesting connection to the account.¶
Operations allowing a watched document to be posted to the service and claims made on the document returned to a device.¶
Cryptographic operations, including threshold operations performed by the service.¶
Exchange of messages between Mesh Services.¶
The Hello transaction is used to determine the features supported by the service and obtain the service profile.¶
The request payload only specifies that is is a request for the service description:¶
{
"HelloRequest":{}}¶
The response payload describes the service and the host providing that service:¶
{
"MeshHelloResponse":{
"EnvelopedProfileService":[{
"EnvelopeId":"MBYH-BJ3I-EUWL-7QAI-NGIE-TPC6-X4KU",
"dig":"S512",
"ContentMetaData":"ewogICJVbmlxdWVJZCI6ICJNQllILUJKM0ktRV
VXTC03UUFJLU5HSUUtVFBDNi1YNEtVIiwKICAiTWVzc2FnZVR5cGUiOiAiUHJvZml
sZVNlcnZpY2UiLAogICJjdHkiOiAiYXBwbGljYXRpb24vbW1tL29iamVjdCIsCiAg
IkNyZWF0ZWQiOiAiMjAyMi0xMC0xOFQxMjo0MzoyNloifQ"},
"ewogICJQcm9maWxlU2VydmljZSI6IHsKICAgICJTZXJ2aWNlQXV0aGVudG
ljYXRpb24iOiB7CiAgICAgICJVZGYiOiAiTUI2Sy1EV05YLURZSTctU04yRy1IRVM
yLUhWQ1MtTE9INCIsCiAgICAgICJQdWJsaWNQYXJhbWV0ZXJzIjogewogICAgICAg
ICJQdWJsaWNLZXlFQ0RIIjogewogICAgICAgICAgImNydiI6ICJYNDQ4IiwKICAgI
CAgICAgICJQdWJsaWMiOiAiZnNNZDlJRnNXcm5MUHJqVzQ3UlZoelJ6cXRzcFNCT3
IxS2J6eXNrUkZodXVJd1hnSl94TAogIDlDb2c5b0RTOXBQem45a3o4cTRSc1FNQSJ
9fX0sCiAgICAiU2VydmljZUVuY3J5cHRpb24iOiB7CiAgICAgICJVZGYiOiAiTUJR
QS1MSktBLVk3QVgtNVVaTC1IR1ZMLUNKRUEtNEVJNiIsCiAgICAgICJQdWJsaWNQY
XJhbWV0ZXJzIjogewogICAgICAgICJQdWJsaWNLZXlFQ0RIIjogewogICAgICAgIC
AgImNydiI6ICJYNDQ4IiwKICAgICAgICAgICJQdWJsaWMiOiAiNnFtS3VOZjVPa1V
LR2ZzdFpLczJIUmItT0U4SGg4RFFfNzR5SW9ZTTVNdGhaeVhrZno3dQogIC1TTTFx
cHBOWHhDb3dRSXVZZ0dKX0hrQSJ9fX0sCiAgICAiU2VydmljZVNpZ25hdHVyZSI6I
HsKICAgICAgIlVkZiI6ICJNQ0RWLVZOREgtR1VRVi03RkVaLUdHWEotWkw3WS1UTj
JMIiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0t
leUVDREgiOiB7CiAgICAgICAgICAiY3J2IjogIkVkNDQ4IiwKICAgICAgICAgICJQ
dWJsaWMiOiAiaFVoUnJHSDN1Zjc5UzZta3BqTERHbVU1ZEJGbGthZU0taE9fOVRnR
zFyNDdmYUtUOG5nVQogIFJMOGRKYVo0QWMwTmZmbksxenJlYklhQSJ9fX0sCiAgIC
AiUHJvZmlsZVNpZ25hdHVyZSI6IHsKICAgICAgIlVkZiI6ICJNQllILUJKM0ktRVV
XTC03UUFJLU5HSUUtVFBDNi1YNEtVIiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMi
OiB7CiAgICAgICAgIlB1YmxpY0tleUVDREgiOiB7CiAgICAgICAgICAiY3J2IjogI
kVkNDQ4IiwKICAgICAgICAgICJQdWJsaWMiOiAiR1gwUlJvQkNNY3A0NEYwWTlXen
VZdHY3VWpMRm5ReU41NE9QZk96dURhTU00Y3dQS0x5QQogIDBCYnBHcVM4MXhHcFZ
CTzg4bkZDck15QSJ9fX19fQ",
{
"signatures":[{
"alg":"S512",
"kid":"MBYH-BJ3I-EUWL-7QAI-NGIE-TPC6-X4KU",
"signature":"v68tamuXYkB5EQarVw791WZmN8IbeEt-GQq58TqX
tMUlT7ETcYTQ-CmY4-ecysTLSKFxGRunevaA7rCej9jY-M0XkTz-xob9i_YMbIb-f
CwdNYxmTPhun7IgvRxu0vyHXnE2HuLixlJNtoFXz-CbMyAA"}
],
"PayloadDigest":"qmQy7M6DuCzRmEz2eeWpW0EuJTxd-qdX7ixMBwcC
dpKlIPNN-fehLh5pLZKDAMueeRv1DQgoLeg7xyb-RSTetQ"}
],
"Version":{
"Major":3,
"Minor":0,
"Encodings":[{
"ID":["application/json"
]}
]},
"Status":201}}¶
The current revision of the specification is designed for small scale deployments in which the service is provided by a single host. The approach will require revision in future versions to fully support a service being provided by multiple hosts with accounts being transferred between the hosts to allow balancing of load.¶
There are three account management operations:¶
Create an account bound to a service address.¶
Delete an account bound to a service address¶
[TBS] Reclaim an account using a recovered primary secret.¶
The BindAccount operation is used to create User and Group accounts. Currently, these account types are distinct. This may change in future releases.¶
A User Account is bound to a Mesh Service by completing a BindAccount operation with the service.¶
The BindAccount transaction is unique in that it can fail to complete for reasons that are outside the scope of the Mesh specifications. Creation of an account might require payment to be made or authentication of the user's credentials. It is thus quite normal for the result of a CreateRequest to be the account being created in an 'on hold' state which can only be changed out of band.¶
If the request is at least partially successful, a BindResponse message is returned. In the case of partial success, a description of the request status and link to a Web page providing further details MAY be returned.¶
The request payload contains all the information needed to create the account:¶
Since there is no Access Catalog until the account is created, the Bind Account request and subsequent requests used to initialize the access catalog for the account MUST be authenticated by the Account Authentication key.¶
Alice requests creation of the account alice@example.com. The request payload is:¶
{
"BindRequest":{
"AccountAddress":"alice@example.com",
"EnvelopedProfileAccount":[{
"EnvelopeId":"MDRR-5W72-3RJO-VZB3-VUVQ-IOEC-6UNA",
"dig":"S512",
"ContentMetaData":"ewogICJVbmlxdWVJZCI6ICJNRFJSLTVXNzItM1
JKTy1WWkIzLVZVVlEtSU9FQy02VU5BIiwKICAiTWVzc2FnZVR5cGUiOiAiUHJvZml
sZVVzZXIiLAogICJjdHkiOiAiYXBwbGljYXRpb24vbW1tL29iamVjdCIsCiAgIkNy
ZWF0ZWQiOiAiMjAyMi0xMC0xOFQxMjo0MzoyOFoifQ"},
"ewogICJQcm9maWxlVXNlciI6IHsKICAgICJDb21tb25TaWduYXR1cmUiOi
B7CiAgICAgICJVZGYiOiAiTUNERy1UUzdULVVQREQtVjY2Ny1PWFNYLVFKNUctRlF
SWiIsCiAgICAgICJQdWJsaWNQYXJhbWV0ZXJzIjogewogICAgICAgICJQdWJsaWNL
ZXlFQ0RIIjogewogICAgICAgICAgImNydiI6ICJFZDQ0OCIsCiAgICAgICAgICAiU
HVibGljIjogImhBZTdpaUNZbm51MGpyVFNhdTVXdWNPNzRNajBaQTlEY1N6VFd5ck
5RVXg3dDVuSnNsZkIKICB6VjBqYnpaWWprb29HalFsYnZJclVUR0EifX19LAogICA
gIkFjY291bnRBZGRyZXNzIjogImFsaWNlQGV4YW1wbGUuY29tIiwKICAgICJTZXJ2
aWNlVWRmIjogIk1CWUgtQkozSS1FVVdMLTdRQUktTkdJRS1UUEM2LVg0S1UiLAogI
CAgIkVzY3Jvd0VuY3J5cHRpb24iOiB7CiAgICAgICJVZGYiOiAiTUJNVC1LSkpXLU
ZVN1UtSFJNUi1LNE9JLU9LTVktWENZTyIsCiAgICAgICJQdWJsaWNQYXJhbWV0ZXJ
zIjogewogICAgICAgICJQdWJsaWNLZXlFQ0RIIjogewogICAgICAgICAgImNydiI6
ICJYNDQ4IiwKICAgICAgICAgICJQdWJsaWMiOiAiak1XbTJvRGpvQWdJZ053SkV3e
Gk2MkZvRnhrN002R0VMX1FUcGZySmhvd2k2eUFJOTFHVAogIDh4X3pFVG9NYnVheD
A5VkpDRU9QWnphQSJ9fX0sCiAgICAiQWRtaW5pc3RyYXRvclNpZ25hdHVyZSI6IHs
KICAgICAgIlVkZiI6ICJNQkZNLVhXMkgtQ0JMVC1BTU5RLVpXVlotVVNHSS1LT0dJ
IiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tle
UVDREgiOiB7CiAgICAgICAgICAiY3J2IjogIkVkNDQ4IiwKICAgICAgICAgICJQdW
JsaWMiOiAid0loNFhfcnpEMzQ2OFRFWnhLdGZWd0xSdHRlRFBZUEpqeWFUUUMwckl
5bzFOazZQTnNkUQogIHZNa0FPNzZBejlCR19aTGxVNE50T2tnQSJ9fX0sCiAgICAi
Q29tbW9uRW5jcnlwdGlvbiI6IHsKICAgICAgIlVkZiI6ICJNQzdWLVhWTUotNzNPT
C1ZV0dMLTVNSUstUk9YUS1HTDNZIiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOi
B7CiAgICAgICAgIlB1YmxpY0tleUVDREgiOiB7CiAgICAgICAgICAiY3J2IjogIlg
0NDgiLAogICAgICAgICAgIlB1YmxpYyI6ICJjbERrUVQ0bDBxV3E4eFJ4SlNsNmp0
eV9NdXFsWTM5ZE1jOUhheFEwSWk5Nk00aThFVWVRCiAgeW9VT1pRM2IxYjQwVFc3e
UtBb3U5SHlBIn19fSwKICAgICJDb21tb25BdXRoZW50aWNhdGlvbiI6IHsKICAgIC
AgIlVkZiI6ICJNQVgzLUU2V1AtQk1JUy1JWFBJLU1ZUFItTTU2Qy1PSVUzIiwKICA
gICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tleUVDREgi
OiB7CiAgICAgICAgICAiY3J2IjogIlg0NDgiLAogICAgICAgICAgIlB1YmxpYyI6I
CJwamdjdmlIRU9yYW4yWmFMa2E5ZmVnbmFqN3V0OU5Sd2NTNUZHWmlGODBvSmUzRn
pVeHZzCiAgeE1xdXRJNFpxNW5zbVAwbDhEa1FPUUlBIn19fSwKICAgICJQcm9maWx
lU2lnbmF0dXJlIjogewogICAgICAiVWRmIjogIk1EUlItNVc3Mi0zUkpPLVZaQjMt
VlVWUS1JT0VDLTZVTkEiLAogICAgICAiUHVibGljUGFyYW1ldGVycyI6IHsKICAgI
CAgICAiUHVibGljS2V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAiRWQ0NDgiLA
ogICAgICAgICAgIlB1YmxpYyI6ICI4MXN3cG0wNVQ5b2x5cWJNSE8wZGFEVFdSMmk
tUEtGaEhtQnRHdjVwTkowNmg2a0tFNk5VCiAgMGJDTHY2U3k3cGJuc3dXbUZzekt0
U3FBIn19fX19",
{
"signatures":[{
"alg":"S512",
"kid":"MDRR-5W72-3RJO-VZB3-VUVQ-IOEC-6UNA",
"signature":"UNtyhJFuwLPmj8uuSw6Ts61ACoOkEoLF63rSbHT3
5bDRuS8VFhnkyNX2mQ4SIGHuBPPSURZB84kAGRhq0MRAR32jbTJr4We3LSy_PdeGh
5hVaGbRMUhX2V40SVzy7SxLcGYW8iXqXq9PVYL3S315fBIA"}
],
"PayloadDigest":"6P0GfqW3b_kYhYrWG0e0oXy0uENOr_YxxcU3CgLa
NO3tLeTmWkUCGtlZUMvEptTtN-Ysu4KqmXr7OmphX03qow"}
],
"EnvelopedCallsignBinding":[[{
"dig":"S512",
"ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJDYWxsc2ln
bkJpbmRpbmciLAogICJjdHkiOiAiYXBwbGljYXRpb24vbW1tL29iamVjdCIsCiAgI
kNyZWF0ZWQiOiAiMjAyMi0xMC0xOFQxMjo0MzoyOFoifQ"},
"ewogICJDYWxsc2lnbkJpbmRpbmciOiB7CiAgICAiQ2Fub25pY2FsIjog
ImFsaWNlQGV4YW1wbGUuY29tIiwKICAgICJEaXNwbGF5IjogImFsaWNlQGV4YW1wb
GUuY29tIiwKICAgICJQcm9maWxlVWRmIjogIk1EUlItNVc3Mi0zUkpPLVZaQjMtVl
VWUS1JT0VDLTZVTkEiLAogICAgIlNlcnZpY2VzIjogW3sKICAgICAgICAiUHJlZml
4IjogIm1tbSJ9XX19",
{
"signatures":[{
"alg":"S512",
"kid":"MBFM-XW2H-CBLT-AMNQ-ZWVZ-USGI-KOGI",
"signature":"1nhNTeeHxyCIaTmJEuEfJXFwolbrrPsWw5Nj2P
GB142vjiY7_hllV0vCHyX8zC__gW8cVpZO5RaABaGMXFs_AHCON8PgmlStX2IPYr_
XoPMuFRRd_kXUCKC9bC7YDJO-QZvIzZycDwK-VPONN1sQYy4A"}
],
"PayloadDigest":"BkoFDvWIFUl4wcJ2KsrqOOatQ_5RT0YeSdPclh
UfDrc7asCIbUlJatERjnTvknrO8ZB-URjyRDPJHaZED96DGQ"}
]
]}}¶
The response payload currently reports the success or failure of the bind operation:¶
{
"BindResponse":{
"EnvelopedAccountHostAssignment":[{
"ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJBY2NvdW50SG
9zdEFzc2lnbm1lbnQiLAogICJjdHkiOiAiYXBwbGljYXRpb24vbW1tL29iamVjdCI
sCiAgIkNyZWF0ZWQiOiAiMjAyMi0xMC0xOFQxMjo0MzoyOFoifQ"},
"ewogICJBY2NvdW50SG9zdEFzc2lnbm1lbnQiOiB7CiAgICAiQWNjb3VudE
FkZGVzcyI6ICJhbGljZUBleGFtcGxlLmNvbSIsCiAgICAiQWNjZXNzRW5jcnlwdCI
6IHsKICAgICAgIlVkZiI6ICJNQTZRLTRLTEctWVQ3TC1ZVjJOLURTNFQtSFAyRy1a
M0g2IiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY
0tleUVDREgiOiB7CiAgICAgICAgICAiY3J2IjogIlg0NDgiLAogICAgICAgICAgIl
B1YmxpYyI6ICIwa0dIeVRGYkVtdzRvMFN6QndsbEtDZDlNOHBNV2o5LXBRV1h4Z09
IaUppTUtVOXlqMVhNCiAgekZLQ2lRVUtqUi1FZC1MX25XUXVaZGNBIn19fX19"
],
"Status":201,
"StatusDescription":"Operation completed successfully"}}¶
It is likely that a future revisions of the specification will specify the host(s) to which future account service operations are to be directed. This would allow the account management operations to be separated from the account maintenance operations without requiring the traditional tiered architecture in which every interaction with a service is first routed to a host that cannot perform the required action so that it can be directed to the host that can.¶
Mesh Group Accounts are created in the same manner as user accounts except that the ProfileGroup is specified.¶
Should all the administration devices be lost, an account MAY be recovered by the process of recovering the profile master secret and using it to access the account through the account authentication key.¶
An account registration is deleted using the UnbindAccount transaction.¶
>>>> Unfinished ProtocolAccountDelete¶
The request payload:¶
{
"UnbindRequest":{
"Account":"alice@example.com"}}¶
The response payload:¶
{
"UnbindResponse":{
"Status":201,
"StatusDescription":"Operation completed successfully"}}¶
Should a user wish to transfer their account to a new service provider, they first use the Bind Account operation to bind the account to the new service provider, then populate the account entry at the new account using the account authentication key.¶
Only after the new account binding has been completed and is ready for use, is the unbind operation used to delete the account entry at the old service provider.¶
Future versions of the protocol will elaborate on this mechanism so that the change of address can be signaled to connected devices and parties sending messages to the account.¶
Account recovery is necessary in the case that user has lost control of every administration device connected to the account and must re-create the account profile and bind a new set of administrative devices. Account transfer is the process of unbinding an account from one service and rebinding it to a new one.¶
These capabilities are both critical to the long term success of the Mesh but have been deleted from the current revision of the specification as their implementation is interdependent on the architecture of the callsign registry.¶
>>>> Unfinished ProtocolAccountRecover¶
[TBS]¶
All the state associated with a Mesh profile is stored as a sequence of DARE Messages in a Dare Container. The Mesh Service holding the master copy of the persistence stores and the devices connected to the profile containing complete copies (replicas) or partial copies (redactions).¶
Thus, the only primitive needed to achieve synchronization of the profile state are those required for synchronization of a DARE Container. These steps are:¶
To ensure a satisfactory user experience, Mesh Messages are intentionally limited in size to 32 KB or less, thus ensuring that an application can retrieve the most recent 100 messages almost instantaneously on a high bandwidth connection and without undue delay on a slower one.¶
The status transaction returns the status of the containers the device is authorized to access for the specified account together with the updated Device Connection Entry if this has been modified since the entry presented to authenticate the request was issued.¶
Alice adds an entry to her bookmark catalog. Before the bookmark can be added, the device synchronizes to the service. The synchronization process begins with a request for the status of all the stores associated with the account that it has access rights for:¶
{
"StatusRequest":{
"CatalogedDeviceDigest":"MAC5-ZJWC-FFYC-2KIO-YYOE-OO43-OZ"}}¶
If the account has a very large number of stores, the device might only ask for the status of specific stores of interest.¶
The response specifies the status of each store specifying the index and Merkle tree apex digest values for each:¶
{
"StatusResponse":{
"ContainerStatus":[{
"Container":"MMM_Inbound",
"Index":3},
{
"Container":"MMM_Outbound",
"Index":1,
"Digest":"FEHy24Y6cLModDXWH31kVc2a3TdhjXPooKHpLAb2JbsO1YQ
nJolmowXAYHhkOGY0kg3jrKNTjds0myf4Dw1sdg"},
{
"Container":"MMM_Local",
"Index":2},
{
"Container":"MMM_Access",
"Index":3,
"Digest":"r5IajJWI1RhTXt1j2_O75SUzphUMofZvSyfO5kLWLh20OGp
kLPsCcCEXprd0_QVPMr4PxBO6Mg7cS-WsOlumJw"},
{
"Container":"MMM_Credential",
"Index":4,
"Digest":"aNMogtuGtBohOUNSCfPXDNONUz5BQ86TNDOfE_HZ5zi2Bw_
FWQik3E1qWyXFi-GuWipin-bJuFPJ2JPu-mIj4w"},
{
"Container":"MMM_Device",
"Index":3,
"Digest":"qg4Zf_QebDEnR4kPOfPnQQiNmEhW0G01F8aJR83z5ibKUvK
cImrRFGTTRDIN2sRNKJZ6HSoAL0Wr1wzEj9NtVQ"},
{
"Container":"MMM_Contact",
"Index":2,
"Digest":"urm7SZRuU2rWHYs-eoxZLg_WI4Hs4ICidDe_RM-GC__aANA
P8OKAEx5Bu_SN-P77U1h63JkQpDDeUtOrvn_qLw"},
{
"Container":"MMM_Application",
"Index":1,
"Digest":"nljVIfu_F6lHDSSYn8dYdpE_QMBgs2KBSP4sI6E8vTA0E5X
4fJZHS8TVzCVIEL7urcVdLxcB0eeoPO82fYhyuQ"},
{
"Container":"MMM_Publication",
"Index":1,
"Digest":"XhOEeG1waPc8GRUl1BI_dDoKQnXkaS9Jz16V1Ow5caT9WUL
1W2YU-z6_CxDafc7JfSwXfdYDv62sVyYwFq5Ieg"},
{
"Container":"MMM_Bookmark",
"Index":1,
"Digest":"VuysvMaN2_bZXrJuQ-gYpfCHKN-gM7XlRBIkNLY_fB25hu7
hzdCWMWxgwHK-3KVNMWFC-I8jYYgZxmIOgfVWyQ"},
{
"Container":"MMM_Task",
"Index":1,
"Digest":"pbjJC7NvIJQF5ke1bpO65uvTe1zvFpur_XK4ddy61dInDLh
ulURJU9cEsScpMrdkxU7rNxN0i-RGRq5RL3ALFA"}
],
"Status":201,
"StatusDescription":"Operation completed successfully"}}¶
Bug: The current version of the reference code is only returning the digest values for the outbound store.¶
The download transaction returns a collection of entries from one or more containers associated with the profile.¶
The service MAY limit the number of entries returned in an individual response for performance reasons.¶
The previous status operation has reported that a new envelope has been added to the credential store. The device requests this data from the service:¶
{
"DownloadRequest":{
"Select":[{
"Container":"MMM_Credential",
"IndexMin":3,
"IndexMax":4}
]}}¶
The response contains the requested envelope:¶
{
"DownloadResponse":{
"Updates":[{
"Envelopes":[[{
"enc":"A256CBC",
"dig":"S512",
"Salt":"9G8s-0EiAgsU9KfVUcNhmg",
"recipients":[{
"kid":"MD3C-QNUT-ZU52-7ZYI-KKLE-634C-FX46",
"epk":{
"PublicKeyECDH":{
"crv":"X448",
"Public":"hnlO_tCx1jlYE7whov_zahfrvFiVv9FxS
lBtr3ujmPBYkc6h8qfMDV1oRWOGbt8giT03J0g37S-A"}},
"wmk":"zBUGL2OKIECJ120IqN1kQicryZXen5qsZWA7yLZK
tzQfLyimnOkVjw"}
],
"ContentMetaData":"ewogICJVbmlxdWVJZCI6ICI6ZnRwLmV4
YW1wbGUuY29tIiwKICAiRXZlbnQiOiAiVXBkYXRlIiwKICAiRmlyc3QiOiAxLAogI
CJQcmV2aW91cyI6IDF9",
"SequenceInfo":{
"Index":3,
"TreePosition":825},
"Received":"2022-10-18T12:43:49Z",
"PayloadDigest":"isMr-j-qxmeh4Jl4M4fFHLMcHNGC0rhRMf
C_fBgP9KLiY7eIwtZmJ9zRDT-LsqD6qTuWgKDDOr5EIdr3F4dYBg",
"TreeDigest":"aNMogtuGtBohOUNSCfPXDNONUz5BQ86TNDOfE
_HZ5zi2Bw_FWQik3E1qWyXFi-GuWipin-bJuFPJ2JPu-mIj4w"},
"i5YiMuM69xy42g6FbOBjc3P-lfIRpsR4FBXKhvu6_OsZxZHSqHTY
GUYuommb9YdpCvZbxrm1W7_mNiBQPMdFWP69r6J3WCT1qYRboEvVSTI3nz8G-RO4G
UlxuYzMZUtMZ4x4EZxpLmbGseS4U7VYe-aqJg6RA-Qjgnijp50y0wQ",
{}
]
],
"Container":"MMM_Credential"}
],
"Status":201,
"StatusDescription":"Operation completed successfully"}}¶
Future: The current implementation of the download operation is limited by the capabilities of the HTTP binding of the RUD transport. A future binding allowing operations that consist of a single request followed by a sequence of responses will allow much greater flexibility.¶
Future versions of the protocol may support optional filtering criteria so that the service only returns objects matching specific criteria and/or only return certain parts of the selected messages.¶
The transact transaction appends envelopes to one or more stores. The operation is atomic, that is either all the changes specified will be made to the stores or none will. This ensures that simultaneous attempts to update a store do not result in race conditions allows Mesh stores to provide ACID (Atomicity, Consistency, Isolation, Durability) properties to the applications they serve.¶
Clients SHOULD check to determine if updates to a container conflict with pending updates on the device waiting to be uploaded. For example, if a contact that the user modified on the device attempting to synchronize was subsequently deleted. The means of resolving such conflicts is not in the scope of this specification.¶
Each update to a catalog or container specifies the expected container index and apex digest. This provides a strong guarantee of consistency. The service MUST verify each update to check that the Merkle Tree values specified are consistent with the store entries and that the signature on the apex value (if specified) is valid and correct.¶
Services MAY impose limits on the size and number of additions performed in response to a TransactRequest message to ensure that processing time does not degrade performance for other users.¶
The request payload specifies the data to be appended to the stores.¶
{
"TransactRequest":{
"Updates":[{
"Envelopes":[[{
"dig":"S512",
"ContentMetaData":"ewogICJVbmlxdWVJZCI6ICJOQkNFLU9M
TFMtRkZVRC01S0FXLUxYU08tNlNPVC1NV0tOIiwKICAiRXZlbnQiOiAiTmV3In0",
"SequenceInfo":{
"Index":1,
"TreePosition":0},
"PayloadDigest":"AUNDpV9PHUjG6OU9x1ZWfdBCHdy1y8XyVz
WoW62krM3aNP2uujQdnpmIIozfhK5x70-coCWoAwoRc9K08cKs0w",
"TreeDigest":"a7XTK7vdmA45v9PQf0fEbW7Mx-E7cQPAX2JX0
Bwp_OkzUubItYdTFRY_pkydvEwtdZRUz8K8_EpCSCkLZWj8Bg"},
"ewogICJDYXRhbG9nZWRCb29rbWFyayI6IHsKICAgICJVcmkiOiAi
U2l0ZXMuMiIsCiAgICAiVGl0bGUiOiAiaHR0cDovL3d3dy5leGFtcGxlLm5ldCIsC
iAgICAiVWlkIjogIk5CQ0UtT0xMUy1GRlVELTVLQVctTFhTTy02U09ULU1XS04ifX
0"
]
],
"Container":"MMM_Bookmark"}
]}}¶
The response reports successful completion:¶
{
"TransactResponse":{
"Status":201,
"StatusDescription":"Operation completed successfully"}}¶
In order to support the wide range of affordances supported by devices, four device connection interactions are currently specified. The use of these mechanisms is described in [draft-hallambaker-mesh-architecture] and the interactions themselves are described in section ??? following.¶
Device connection operations are always issued by a device requesting connection to a Mesh account and must therefore be authenticated under the device profile rather than the account profile. Two device connection operations are currently defined:¶
Requests connection to the account.¶
Polls for completion of a connection request.¶
Since the second operation is merely polling for completion of the transaction requested by the first, it is likely that these will be combined in a future revision of the specification.¶
If the connection request is initiated by the device being connected, the device constructs a RequestConnection message which is posted to the Mesh Service using the Connect operation.¶
If the Connect operation is accepted (i.e. the service determines it is not abuse), the service constructs an AcknowledgeConnection message which is forwarded to the inbound spool of the account to which connection is requested. The requesting device receives a copy of the AcknowledgeConnection message and the profile of the account it is requesting connection to.¶
As described in the following section, the AcknowledgeConnection message contains the request details presented by the device and a nonce value generated by the service. This nonce value is used to compute the witness value that will be used for mutual authentication of the device and account.¶
The connect request is made to the service, not the account. The payload contains the enveloped connection request:¶
{
"ConnectRequest":{
"EnvelopedRequestConnection":[{
"EnvelopeId":"MCRT-4U7E-2EFA-6GT6-ATYZ-NKLT-DNU6",
"ContentMetaData":"ewogICJVbmlxdWVJZCI6ICJOQktWLVRETkktS1
Y2Ui1PNlU2LUI0VUktM0lOSy1BQUZHIiwKICAiTWVzc2FnZVR5cGUiOiAiUmVxdWV
zdENvbm5lY3Rpb24iLAogICJjdHkiOiAiYXBwbGljYXRpb24vbW1tL29iamVjdCIs
CiAgIkNyZWF0ZWQiOiAiMjAyMi0xMC0xOFQxMjo0ODoxMVoifQ"},
"ewogICJSZXF1ZXN0Q29ubmVjdGlvbiI6IHsKICAgICJBY2NvdW50QWRkcm
VzcyI6ICJhbGljZUBleGFtcGxlLmNvbSIsCiAgICAiQXV0aGVudGljYXRlZERhdGE
iOiBbewogICAgICAgICJFbnZlbG9wZUlkIjogIk1EVlUtQU9TVC1URElILUFYR0Ut
V1VKUy1JNTZWLVdKUDMiLAogICAgICAgICJkaWciOiAiUzUxMiIsCiAgICAgICAgI
kNvbnRlbnRNZXRhRGF0YSI6ICJld29nSUNKVmJtbHhkV1ZKWkNJNklDSk5SRlpWTF
VGUFUxUXRWRVJKU0MxCiAgQldFZEZMVmRWU2xNdFNUVTJWaTFYU2xBeklpd0tJQ0F
pVFdWemMyRm5aVlI1Y0dVaU9pQWlVSEp2Wm1sc1oKICBVUmxkbWxqWlNJc0NpQWdJ
bU4wZVNJNklDSmhjSEJzYVdOaGRHbHZiaTl0YlcwdmIySnFaV04wSWl3S0lDQQogI
GlRM0psWVhSbFpDSTZJQ0l5TURJeUxURXdMVEU0VkRFeU9qUTRPakV4V2lKOSJ9LA
ogICAgICAiZXdvZ0lDSlFjbTltYVd4bFJHVjJhV05sSWpvZ2V3b2dJQ0FnSWtWdVk
zSgogIDVjSFJwYjI0aU9pQjdDaUFnSUNBZ0lDSlZaR1lpT2lBaVRVTmFXQzFWTWpK
R0xUSlRTVTh0VlVSVk5DMHpNCiAgbEJVTFVKWE56WXRTRmxJVUNJc0NpQWdJQ0FnS
UNKUWRXSnNhV05RWVhKaGJXVjBaWEp6SWpvZ2V3b2dJQ0EKICBnSUNBZ0lDSlFkV0
pzYVdOTFpYbEZRMFJJSWpvZ2V3b2dJQ0FnSUNBZ0lDQWdJbU55ZGlJNklDSllORFE
0SQogIGl3S0lDQWdJQ0FnSUNBZ0lDSlFkV0pzYVdNaU9pQWlXa0ZoYUdwUFVsRlli
R1l4TmpCbU16Wk9PVWM1YUdVCiAgM1dDMVdjMWwzVlc5VlNtTkdiWFpMWTBaSE9Ve
FJSak01U1doVE9Rb2dJR05vTTJkd1gxUXlkQzF3Um0xaVcKICBqZHpjMnRtVjI1Ql
FTSjlmWDBzQ2lBZ0lDQWlVMmxuYm1GMGRYSmxJam9nZXdvZ0lDQWdJQ0FpVldSbUl
qbwogIGdJazFDUkU4dE0wczNRUzFMVWxSSkxVMUNWRkV0VFZkWk5pMVZSRkJHTFZR
elNWa2lMQW9nSUNBZ0lDQWlVCiAgSFZpYkdsalVHRnlZVzFsZEdWeWN5STZJSHNLS
UNBZ0lDQWdJQ0FpVUhWaWJHbGpTMlY1UlVORVNDSTZJSHMKICBLSUNBZ0lDQWdJQ0
FnSUNKamNuWWlPaUFpUldRME5EZ2lMQW9nSUNBZ0lDQWdJQ0FnSWxCMVlteHBZeUk
2SQogIENKRmJuUmlRWGRwZVZaQk1sOXpkMmxHUVdKTVNVRkpNelZqWjNJelR6QnVT
bkl3UVU5a1V6UmpWWEY2YVMwCiAgemMyMHdNMVIzQ2lBZ1ZFVkdUbEZvVERaa05XS
TFabkZRVFUxMFZHbzNWR2xCSW4xOWZTd0tJQ0FnSUNKQmQKICBYUm9aVzUwYVdOaG
RHbHZiaUk2SUhzS0lDQWdJQ0FnSWxWa1ppSTZJQ0pOUXpOU0xUSlZTa3N0UzBOT05
TMQogIFpRa00zTFVkR1ExVXRTa1phUlMxU1IwZEdJaXdLSUNBZ0lDQWdJbEIxWW14
cFkxQmhjbUZ0WlhSbGNuTWlPCiAgaUI3Q2lBZ0lDQWdJQ0FnSWxCMVlteHBZMHRsZ
VVWRFJFZ2lPaUI3Q2lBZ0lDQWdJQ0FnSUNBaVkzSjJJam8KICBnSWxnME5EZ2lMQW
9nSUNBZ0lDQWdJQ0FnSWxCMVlteHBZeUk2SUNKQldHdHFiVUpSWTBWcWQyeGpUR2x
YZQogIGtWNFRsTmlhWFF3ZWxSQlpGZzJkbmhSVWxGemRFWlpibkZsY1hjM0xWaHRZ
M0pSQ2lBZ00zcE1NRnBOVVVkCiAgUlVXaFlPRFpKU21wVVNEWldaVmRCSW4xOWZTd
0tJQ0FnSUNKUWNtOW1hV3hsVTJsbmJtRjBkWEpsSWpvZ2UKICB3b2dJQ0FnSUNBaV
ZXUm1Jam9nSWsxRVZsVXRRVTlUVkMxVVJFbElMVUZZUjBVdFYxVktVeTFKTlRaV0x
WZAogIEtVRE1pTEFvZ0lDQWdJQ0FpVUhWaWJHbGpVR0Z5WVcxbGRHVnljeUk2SUhz
S0lDQWdJQ0FnSUNBaVVIVmliCiAgR2xqUzJWNVJVTkVTQ0k2SUhzS0lDQWdJQ0FnS
UNBZ0lDSmpjbllpT2lBaVJXUTBORGdpTEFvZ0lDQWdJQ0EKICBnSUNBZ0lsQjFZbX
hwWXlJNklDSTJXbEZhTm5GemFrVldjVVZMYVhSelJqQTJaVEozTTFaVGQwRnZPR3B
EUgogIG10blZXcHBTWEl0WTJka1VIZHFVakJLVEhKc0NpQWdZbEJvTW1WTFpuTnhV
MVp2TlRob1JIQkhVR055WjI5CiAgQkluMTlmWDE5IiwKICAgICAgewogICAgICAgI
CJzaWduYXR1cmVzIjogW3sKICAgICAgICAgICAgImFsZyI6ICJTNTEyIiwKICAgIC
AgICAgICAgImtpZCI6ICJNRFZVLUFPU1QtVERJSC1BWEdFLVdVSlMtSTU2Vi1XSlA
zIiwKICAgICAgICAgICAgInNpZ25hdHVyZSI6ICIzLU5oVGkwMlJDNnVieXFPZWtN
eGNnUVBjU2xyY0ZRQkN0cjBVSkZlV0hYd0MtXzBDCiAgSXFhWGl5elJmUjJ3MWtFU
jhSZndzUk53R1lBTmY0aWJFSFkySU5yVkNwVko4cm9Hd0YydGRoY2dTQXdlTy0KIC
BVLXE1Wk42R2ZsZEZFbjBUaS1iZHVLOEdPMzUxZHctUUxyaHpOWFJNQSJ9XSwKICA
gICAgICAiUGF5bG9hZERpZ2VzdCI6ICJyWHdfQ29LUGNIRG5Oa2E1dklXVjd4UTc3
cGYtMmZ5VW4zaDNmeUtLUDUtYjAKICBDWkZ1dzEwQWt2OFRWajc0OHZ1MGFfRlZPZ
UYtRG9KMnp3U3QtekpIUSJ9XSwKICAgICJDbGllbnROb25jZSI6ICJzWDNPNTVGYz
BfUWlmN3NzLW9ZUWxRIiwKICAgICJQaW5JZCI6ICJBQkZJLVlFWkItSEFFTy03TFZ
NLUU3VkItSVdVQy1ZRDNGIiwKICAgICJQaW5XaXRuZXNzIjogIldaaEpuN2JUR3Fs
dFNsOG5jVi1DRGR4ZUhzaW1zZmV5em55cGoyNjZfRm4tYWtRRQogIHFXZlBDRzExc
jUxaVZHWks1aVNGWllJSU1Kam1XaFBUZkpEcWZ3IiwKICAgICJNZXNzYWdlSWQiOi
AiTkJLVi1URE5JLUtWNlItTzZVNi1CNFVJLTNJTkstQUFGRyJ9fQ"
],
"Rights":[
]}}¶
The response payload contains the information the device requires to compute the witness value and to poll for completion. This is a copy of the request acknowledgement and a copy of the profile of the account the device has requested connection to:¶
{
"ConnectResponse":{
"EnvelopedAcknowledgeConnection":[{
"EnvelopeId":"MB6L-ABHL-UQ3N-SPDG-GURC-4K6A-OLGG",
"ContentMetaData":"ewogICJVbmlxdWVJZCI6ICJBSTdXLVlLUEstTV
IzVS1DWlc3LUdBVlEtMjRMWi1NU0ZBIiwKICAiTWVzc2FnZVR5cGUiOiAiQWNrbm9
3bGVkZ2VDb25uZWN0aW9uIiwKICAiY3R5IjogImFwcGxpY2F0aW9uL21tbS9vYmpl
Y3QiLAogICJDcmVhdGVkIjogIjIwMjItMTAtMThUMTI6NDg6MTFaIn0"},
"ewogICJBY2tub3dsZWRnZUNvbm5lY3Rpb24iOiB7CiAgICAiRW52ZWxvcG
VkUmVxdWVzdENvbm5lY3Rpb24iOiBbewogICAgICAgICJFbnZlbG9wZUlkIjogIk1
DUlQtNFU3RS0yRUZBLTZHVDYtQVRZWi1OS0xULUROVTYiLAogICAgICAgICJDb250
ZW50TWV0YURhdGEiOiAiZXdvZ0lDSlZibWx4ZFdWSlpDSTZJQ0pPUWt0V0xWUkVUa
2t0UzFZMlVpMQogIFBObFUyTFVJMFZVa3RNMGxPU3kxQlFVWkhJaXdLSUNBaVRXVn
pjMkZuWlZSNWNHVWlPaUFpVW1WeGRXVnpkCiAgRU52Ym01bFkzUnBiMjRpTEFvZ0l
DSmpkSGtpT2lBaVlYQndiR2xqWVhScGIyNHZiVzF0TDI5aWFtVmpkQ0kKICBzQ2lB
Z0lrTnlaV0YwWldRaU9pQWlNakF5TWkweE1DMHhPRlF4TWpvME9Eb3hNVm9pZlEif
SwKICAgICAgImV3b2dJQ0pTWlhGMVpYTjBRMjl1Ym1WamRHbHZiaUk2SUhzS0lDQW
dJQ0oKICBCWTJOdmRXNTBRV1JrY21WemN5STZJQ0poYkdsalpVQmxlR0Z0Y0d4bEx
tTnZiU0lzQ2lBZ0lDQWlRWFYwYQogIEdWdWRHbGpZWFJsWkVSaGRHRWlPaUJiZXdv
Z0lDQWdJQ0FnSUNKRmJuWmxiRzl3WlVsa0lqb2dJazFFVmxVCiAgdFFVOVRWQzFVU
kVsSUxVRllSMFV0VjFWS1V5MUpOVFpXTFZkS1VETWlMQW9nSUNBZ0lDQWdJQ0prYV
djaU8KICBpQWlVelV4TWlJc0NpQWdJQ0FnSUNBZ0lrTnZiblJsYm5STlpYUmhSR0Y
wWVNJNklDSmxkMjluU1VOS1ZtSgogIHRiSGhrVjFaS1drTkpOa2xEU2s1U1JscFdU
RlZHVUZVeFVYUldSVkpLVTBNeENpQWdRbGRGWkVaTVZtUldVCiAgMnhOZEZOVVZUS
ldhVEZZVTJ4QmVrbHBkMHRKUTBGcFZGZFdlbU15Um01YVZsSTFZMGRWYVU5cFFXbF
ZTRXAKICAyV20xc2Mxb0tJQ0JWVW14a2JXeHFXbE5KYzBOcFFXZEpiVTR3WlZOSk5
rbERTbWhqU0VKellWZE9hR1JIYgogIEhaaWFUbDBZbGN3ZG1JeVNuRmFWMDR3U1ds
M1MwbERRUW9nSUdsUk0wcHNXVmhTYkZwRFNUWkpRMGw1VFVSCiAgSmVVeFVSWGRNV
kVVMFZrUkZlVTlxVVRSUGFrVjRWMmxLT1NKOUxBb2dJQ0FnSUNBaVpYZHZaMGxEU2
xGamIKICBUbHRZVmQ0YkZKSFZqSmhWMDVzU1dwdloyVjNiMmRKUTBGblNXdFdkVmt
6U2dvZ0lEVmpTRkp3WWpJMGFVOQogIHBRamREYVVGblNVTkJaMGxEU2xaYVIxbHBU
MmxCYVZSVlRtRlhRekZXVFdwS1IweFVTbFJUVlRoMFZsVlNWCiAgazVETUhwTkNpQ
WdiRUpWVEZWS1dFNTZXWFJUUm14SlZVTkpjME5wUVdkSlEwRm5TVU5LVVdSWFNuTm
hWMDUKICBSV1ZoS2FHSlhWakJhV0VwNlNXcHZaMlYzYjJkSlEwRUtJQ0JuU1VOQlo
wbERTbEZrVjBwellWZE9URnBZYgogIEVaUk1GSkpTV3B2WjJWM2IyZEpRMEZuU1VO
QlowbERRV2RKYlU1NVpHbEpOa2xEU2xsT1JGRTBTUW9nSUdsCiAgM1MwbERRV2RKU
TBGblNVTkJaMGxEU2xGa1YwcHpZVmROYVU5cFFXbFhhMFpvWVVkd1VGVnNSbGxpUj
FsNFQKICBtcENiVTE2V2s5UFZXTTFZVWRWQ2lBZ00xZERNVmRqTVd3elZsYzVWbE5
0VGtkaVdGcE1XVEJhU0U5VmVGSgogIFNhazAxVTFkb1ZFOVJiMmRKUjA1dlRUSmtk
MWd4VVhsa1F6RjNVbTB4YVZjS0lDQnFaSHBqTW5SdFZqSTFRCiAgbEZUU2psbVdEQ
npRMmxCWjBsRFFXbFZNbXh1WW0xR01HUllTbXhKYW05blpYZHZaMGxEUVdkSlEwRn
BWbGQKICBTYlVscWJ3b2dJR2RKYXpGRFVrVTRkRTB3Y3pOUlV6Rk1WV3hTU2t4Vk1
VTldSa1YwVkZaa1drNXBNVlpTUgogIGtKSFRGWlJlbE5XYTJsTVFXOW5TVU5CWjBs
RFFXbFZDaUFnU0ZacFlrZHNhbFZIUm5sWlZ6RnNaRWRXZVdOCiAgNVNUWkpTSE5MU
1VOQlowbERRV2RKUTBGcFZVaFdhV0pIYkdwVE1sWTFVbFZPUlZORFNUWkpTSE1LSU
NCTFMKICBVTkJaMGxEUVdkSlEwRm5TVU5LYW1OdVdXbFBhVUZwVWxkUk1FNUVaMmx
NUVc5blNVTkJaMGxEUVdkSlEwRgogIG5TV3hDTVZsdGVIQlplVWsyU1FvZ0lFTktS
bUp1VW1sUldHUndaVlphUWsxc09YcGtNbXhIVVZkS1RWTlZSCiAga3BOZWxacVdqT
kplbFI2UW5WVGJrbDNVVlU1YTFWNlVtcFdXRVkyWVZNd0NpQWdlbU15TUhkTk1WSX
pRMmwKICBCWjFaRlZrZFViRVp2VkVSYWEwNVhTVEZhYmtaUlZGVXhNRlpIYnpOV1I
yeENTVzR4T1daVGQwdEpRMEZuUwogIFVOS1FtUUtJQ0JZVW05YVZ6VXdZVmRPYUdS
SGJIWmlhVWsyU1VoelMwbERRV2RKUTBGblNXeFdhMXBwU1RaCiAgSlEwcE9VWHBPV
TB4VVNsWlRhM04wVXpCT1QwNVRNUW9nSUZwUmEwMHpURlZrUjFFeFZYUlRhMXBoVW
xNeFUKICAxSXdaRWRKYVhkTFNVTkJaMGxEUVdkSmJFSXhXVzE0Y0ZreFFtaGpiVVo
wV2xoU2JHTnVUV2xQQ2lBZ2FVSQogIDNRMmxCWjBsRFFXZEpRMEZuU1d4Q01WbHRl
SEJaTUhSc1pWVldSRkpGWjJsUGFVSTNRMmxCWjBsRFFXZEpRCiAgMEZuU1VOQmFWa
3pTakpKYW04S0lDQm5TV3huTUU1RVoybE1RVzluU1VOQlowbERRV2RKUTBGblNXeE
NNVmwKICB0ZUhCWmVVazJTVU5LUWxkSGRIRmlWVXBTV1RCV2NXUXllR3BVUjJ4WVp
Rb2dJR3RXTkZSc1RtbGhXRkYzWgogIFd4U1FscEdaekprYm1oU1ZXeEdlbVJGV2xw
aWJrWnNZMWhqTTB4V2FIUlpNMHBTUTJsQlowMHpjRTFOUm5CCiAgT1ZWVmtDaUFnV
WxWWGFGbFBSRnBLVTIxd1ZWTkVXbGRhVm1SQ1NXNHhPV1pUZDB0SlEwRm5TVU5LVV
dOdE8KICBXMWhWM2hzVlRKc2JtSnRSakJrV0Vwc1NXcHZaMlVLSUNCM2IyZEpRMEZ
uU1VOQmFWWlhVbTFKYW05blNXcwogIHhSVlpzVlhSUlZUbFVWa014VlZKRmJFbE1W
VVpaVWpCVmRGWXhWa3RWZVRGS1RsUmFWMHhXWkFvZ0lFdFZSCiAgRTFwVEVGdlowb
ERRV2RKUTBGcFZVaFdhV0pIYkdwVlIwWjVXVmN4YkdSSFZubGplVWsyU1VoelMwbE
RRV2QKICBKUTBGblNVTkJhVlZJVm1saUNpQWdSMnhxVXpKV05WSlZUa1ZUUTBrMlN
VaHpTMGxEUVdkSlEwRm5TVU5CWgogIDBsRFNtcGpibGxwVDJsQmFWSlhVVEJPUkdk
cFRFRnZaMGxEUVdkSlEwRUtJQ0JuU1VOQlowbHNRakZaYlhoCiAgd1dYbEpOa2xEU
1RKWGJFWmhUbTVHZW1GclZsZGpWVlpNWVZoU2VsSnFRVEphVkVvelRURmFWR1F3Um
5aUFIKICAzQkVVZ29nSUcxMGJsWlhjSEJUV0VsMFdUSmthMVZJWkhGVmFrSkxWRWh
LYzBOcFFXZFpiRUp2VFcxV1RGcAogIHVUbmhWTVZwMlRsUm9iMUpJUWtoVlIwNTVX
akk1Q2lBZ1FrbHVNVGxtV0RFNUlpd0tJQ0FnSUNBZ2V3b2dJCiAgQ0FnSUNBZ0lDS
nphV2R1WVhSMWNtVnpJam9nVzNzS0lDQWdJQ0FnSUNBZ0lDQWdJbUZzWnlJNklDSl
ROVEUKICB5SWl3S0lDQWdJQ0FnSUNBZ0lDQWdJbXRwWkNJNklDSk5SRlpWTFVGUFU
xUXRWRVJKU0MxQldFZEZMVmRWUwogIGxNdFNUVTJWaTFYU2xBeklpd0tJQ0FnSUNB
Z0lDQWdJQ0FnSW5OcFoyNWhkSFZ5WlNJNklDSXpMVTVvVkdrCiAgd01sSkROblZpZ
VhGUFpXdE5lR05uVVZCalUyeHlZMFpSUWtOMGNqQlZTa1psVjBoWWQwTXRYekJEQ2
lBZ1MKICBYRmhXR2w1ZWxKbVVqSjNNV3RGVWpoU1puZHpVazUzUjFsQlRtWTBhV0p
GU0ZreVNVNXlWa053VmtvNGNtOQogIEhkMFl5ZEdSb1kyZFRRWGRsVHkwS0lDQlZM
WEUxV2s0MlIyWnNaRVpGYmpCVWFTMWlaSFZMT0VkUE16VXhaCiAgSGN0VVV4eWFIc
E9XRkpOUVNKOVhTd0tJQ0FnSUNBZ0lDQWlVR0Y1Ykc5aFpFUnBaMlZ6ZENJNklDSn
lXSGQKICBmUTI5TFVHTklSRzVPYTJFMWRrbFhWamQ0VVRjM2NHWXRNbVo1Vlc0emF
ETm1lVXRMVURVdFlqQUtJQ0JEVwogIGtaMWR6RXdRV3QyT0ZSV2FqYzBPSFoxTUdG
ZlJsWlBaVVl0Ukc5S01ucDNVM1F0ZWtwSVVTSjlYU3dLSUNBCiAgZ0lDSkRiR2xsY
m5ST2IyNWpaU0k2SUNKeldETlBOVFZHWXpCZlVXbG1OM056TFc5WlVXeFJJaXdLSU
NBZ0kKICBDSlFhVzVKWkNJNklDSkJRa1pKTFZsRldrSXRTRUZGVHkwM1RGWk5MVVU
zVmtJdFNWZFZReTFaUkROR0lpdwogIEtJQ0FnSUNKUWFXNVhhWFJ1WlhOeklqb2dJ
bGRhYUVwdU4ySlVSM0ZzZEZOc09HNWpWaTFEUkdSNFpVaHphCiAgVzF6Wm1WNWVtN
TVjR295TmpaZlJtNHRZV3RSUlFvZ0lIRlhabEJEUnpFeGNqVXhhVlpIV2tzMWFWTk
dXbGwKICBKU1UxS2FtMVhhRkJVWmtwRWNXWjNJaXdLSUNBZ0lDSk5aWE56WVdkbFN
XUWlPaUFpVGtKTFZpMVVSRTVKTAogIFV0V05sSXRUelpWTmkxQ05GVkpMVE5KVGtz
dFFVRkdSeUo5ZlEiXSwKICAgICJTZXJ2ZXJOb25jZSI6ICJRQnloNmlsa0g4VFdDe
TkyY1cySVpRIiwKICAgICJXaXRuZXNzIjogIkFJN1ctWUtQSy1NUjNVLUNaVzctR0
FWUS0yNExaLU1TRkEiLAogICAgIk1lc3NhZ2VJZCI6ICJBSTdXLVlLUEstTVIzVS1
DWlc3LUdBVlEtMjRMWi1NU0ZBIn19"
],
"EnvelopedProfileAccount":[{
"EnvelopeId":"MDRR-5W72-3RJO-VZB3-VUVQ-IOEC-6UNA",
"dig":"S512",
"ContentMetaData":"ewogICJVbmlxdWVJZCI6ICJNRFJSLTVXNzItM1
JKTy1WWkIzLVZVVlEtSU9FQy02VU5BIiwKICAiTWVzc2FnZVR5cGUiOiAiUHJvZml
sZVVzZXIiLAogICJjdHkiOiAiYXBwbGljYXRpb24vbW1tL29iamVjdCIsCiAgIkNy
ZWF0ZWQiOiAiMjAyMi0xMC0xOFQxMjo0MzoyOFoifQ"},
"ewogICJQcm9maWxlVXNlciI6IHsKICAgICJDb21tb25TaWduYXR1cmUiOi
B7CiAgICAgICJVZGYiOiAiTUNERy1UUzdULVVQREQtVjY2Ny1PWFNYLVFKNUctRlF
SWiIsCiAgICAgICJQdWJsaWNQYXJhbWV0ZXJzIjogewogICAgICAgICJQdWJsaWNL
ZXlFQ0RIIjogewogICAgICAgICAgImNydiI6ICJFZDQ0OCIsCiAgICAgICAgICAiU
HVibGljIjogImhBZTdpaUNZbm51MGpyVFNhdTVXdWNPNzRNajBaQTlEY1N6VFd5ck
5RVXg3dDVuSnNsZkIKICB6VjBqYnpaWWprb29HalFsYnZJclVUR0EifX19LAogICA
gIkFjY291bnRBZGRyZXNzIjogImFsaWNlQGV4YW1wbGUuY29tIiwKICAgICJTZXJ2
aWNlVWRmIjogIk1CWUgtQkozSS1FVVdMLTdRQUktTkdJRS1UUEM2LVg0S1UiLAogI
CAgIkVzY3Jvd0VuY3J5cHRpb24iOiB7CiAgICAgICJVZGYiOiAiTUJNVC1LSkpXLU
ZVN1UtSFJNUi1LNE9JLU9LTVktWENZTyIsCiAgICAgICJQdWJsaWNQYXJhbWV0ZXJ
zIjogewogICAgICAgICJQdWJsaWNLZXlFQ0RIIjogewogICAgICAgICAgImNydiI6
ICJYNDQ4IiwKICAgICAgICAgICJQdWJsaWMiOiAiak1XbTJvRGpvQWdJZ053SkV3e
Gk2MkZvRnhrN002R0VMX1FUcGZySmhvd2k2eUFJOTFHVAogIDh4X3pFVG9NYnVheD
A5VkpDRU9QWnphQSJ9fX0sCiAgICAiQWRtaW5pc3RyYXRvclNpZ25hdHVyZSI6IHs
KICAgICAgIlVkZiI6ICJNQkZNLVhXMkgtQ0JMVC1BTU5RLVpXVlotVVNHSS1LT0dJ
IiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tle
UVDREgiOiB7CiAgICAgICAgICAiY3J2IjogIkVkNDQ4IiwKICAgICAgICAgICJQdW
JsaWMiOiAid0loNFhfcnpEMzQ2OFRFWnhLdGZWd0xSdHRlRFBZUEpqeWFUUUMwckl
5bzFOazZQTnNkUQogIHZNa0FPNzZBejlCR19aTGxVNE50T2tnQSJ9fX0sCiAgICAi
Q29tbW9uRW5jcnlwdGlvbiI6IHsKICAgICAgIlVkZiI6ICJNQzdWLVhWTUotNzNPT
C1ZV0dMLTVNSUstUk9YUS1HTDNZIiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOi
B7CiAgICAgICAgIlB1YmxpY0tleUVDREgiOiB7CiAgICAgICAgICAiY3J2IjogIlg
0NDgiLAogICAgICAgICAgIlB1YmxpYyI6ICJjbERrUVQ0bDBxV3E4eFJ4SlNsNmp0
eV9NdXFsWTM5ZE1jOUhheFEwSWk5Nk00aThFVWVRCiAgeW9VT1pRM2IxYjQwVFc3e
UtBb3U5SHlBIn19fSwKICAgICJDb21tb25BdXRoZW50aWNhdGlvbiI6IHsKICAgIC
AgIlVkZiI6ICJNQVgzLUU2V1AtQk1JUy1JWFBJLU1ZUFItTTU2Qy1PSVUzIiwKICA
gICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tleUVDREgi
OiB7CiAgICAgICAgICAiY3J2IjogIlg0NDgiLAogICAgICAgICAgIlB1YmxpYyI6I
CJwamdjdmlIRU9yYW4yWmFMa2E5ZmVnbmFqN3V0OU5Sd2NTNUZHWmlGODBvSmUzRn
pVeHZzCiAgeE1xdXRJNFpxNW5zbVAwbDhEa1FPUUlBIn19fSwKICAgICJQcm9maWx
lU2lnbmF0dXJlIjogewogICAgICAiVWRmIjogIk1EUlItNVc3Mi0zUkpPLVZaQjMt
VlVWUS1JT0VDLTZVTkEiLAogICAgICAiUHVibGljUGFyYW1ldGVycyI6IHsKICAgI
CAgICAiUHVibGljS2V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAiRWQ0NDgiLA
ogICAgICAgICAgIlB1YmxpYyI6ICI4MXN3cG0wNVQ5b2x5cWJNSE8wZGFEVFdSMmk
tUEtGaEhtQnRHdjVwTkowNmg2a0tFNk5VCiAgMGJDTHY2U3k3cGJuc3dXbUZzekt0
U3FBIn19fX19",
{
"signatures":[{
"alg":"S512",
"kid":"MDRR-5W72-3RJO-VZB3-VUVQ-IOEC-6UNA",
"signature":"UNtyhJFuwLPmj8uuSw6Ts61ACoOkEoLF63rSbHT3
5bDRuS8VFhnkyNX2mQ4SIGHuBPPSURZB84kAGRhq0MRAR32jbTJr4We3LSy_PdeGh
5hVaGbRMUhX2V40SVzy7SxLcGYW8iXqXq9PVYL3S315fBIA"}
],
"PayloadDigest":"6P0GfqW3b_kYhYrWG0e0oXy0uENOr_YxxcU3CgLa
NO3tLeTmWkUCGtlZUMvEptTtN-Ysu4KqmXr7OmphX03qow"}
],
"Status":201,
"StatusDescription":"Operation completed successfully"}}¶
The complete operation is used to complete the binding of a device to the account regardless of whether the operation is initiated by the administration device or the connecting device.¶
The complete request is made to the service, not the account. The payload specifies the account the device is requesting completion for and the identifier of the completion message.¶
{
"CompleteRequest":{
"AccountAddress":"alice@example.com",
"ResponseID":"MBI3-QJW4-3BIO-7SBZ-PEJP-E7NX-3W7E"}}¶
The response payload:¶
{
"CompleteResponse":{
"EnvelopedRespondConnection":[{
"EnvelopeId":"MAO3-KP7L-PES4-4SNT-JDPD-ZXLR-6WOI",
"enc":"A256CBC",
"Salt":"eRugzocT4XiifhaDCB1yWw",
"recipients":[{
"kid":"MCZX-U22F-2SIO-UDU4-32PT-BW76-HYHP",
"epk":{
"PublicKeyECDH":{
"crv":"X448",
"Public":"8LznRcRSACR-WfvIeNkjQSi24HBzJHfa9MqPTP_
-IyGrXhjuVfceOCF93412kSqQQLT2zus8RS4A"}},
"wmk":"NJmrLBqP5xUnXPesS8J09CXhdvMhxi9dCmj_9DUN0E9rXd
xFbiuVGA"}
],
"ContentMetaData":"ewogICJVbmlxdWVJZCI6ICJNQkkzLVFKVzQtM0
JJTy03U0JaLVBFSlAtRTdOWC0zVzdFIiwKICAiTWVzc2FnZVR5cGUiOiAiUmVzcG9
uZENvbm5lY3Rpb24iLAogICJjdHkiOiAiYXBwbGljYXRpb24vbW1tL29iamVjdCIs
CiAgIkNyZWF0ZWQiOiAiMjAyMi0xMC0xOFQxMjo0ODoxM1oifQ",
"SequenceInfo":{
"Index":3,
"TreePosition":426},
"Received":"2022-10-18T12:48:13Z"},
"z_KxxJI3qrVxUaauNLzqcqwTk8tFFKVgwpSJkyVWRxGhuHZvg0LBIz4Jm3
0uktjBG-gnuKf-qo8vhqWmXLpeJu0caqFNH0hRan7qE5VxJ9srJU1IhYcRTxpR6YU
MTyLRfpxNqFILJFCOAdt6pIGWaCcYrhCG8MLis2BsajsKEPtKzh-zaqZ2SDfgOvp1
N2JfoP1JBG8AuBEXq-m2UMtVP3ddhbodbzIdAXTSoaEerz8XGbAJGMyqVGXeDfMGl
wCXIr-vvedrLGPzWbYfT3dO4sF8JrYN8_zaOHVn4MXMOkOl3ArevmphdAx_a-BZhu
9VjSyvFZs9DGBSeZIjjup9yOVONqa-FwEu-oFzRDgaNdmkCbJvmJop5SDvdZnxIjX
h9wxd3yjg0ov6c5KDhbCLp9eNv4kGMlvfrvU5wfdfowsrGepTHqc5Dc7R3FZCAKW_
fQM8X7NDGX58BH_8R18hZv8Ej77YFG28EN4d7fG4zNjHKHWpuMkDuDjjz6jFyhH7V
xW6K5uNX_09DL2N-wk5ovDQwTu0LKUAFLbJkgNA3mJmMRFhdfBnO9ZOnQR45EfpWc
nW6FeBGSlCnLQ3atkaKvKOvJQXG4RrQt5wApILbtaZdQibrQb0IEua7LclrY7G-M_
xyGr6RXMGymigKts4UwzBzioos0z5GA_FfllKqrYgRMiYStuXqUpmVgkiErEM4Uts
5RNXw_e2QDXRONr6P2yN2ivt7l5n6OJPkm-HAZAmqAdNkCrP-8xT2ZEVUgtfg7DA5
hyWFAydjS_Czt8whzEjsr0qTf4FMN8D-ZpvVkrDLubxND4hJXHULI3z3SMEY8XIzS
_DOHjPobazniNakK3nhRwZ5SuYz9HtyaeUrpFQf-IJwOC9-km4KQ0br9p95pdmM0e
GMdKdhr7Tzq4s7AnnHC-DYLfk8R7azoc0KvGAEKWZJ20UKObRhLUAlqCr3FvkKYNU
o43C118c6z1ibjA_eK57lF5o2rMVfINs5f8H2_lKpmvm2lgOe4_eigQmkDdfCg-Da
BJroLCCJ9y1WpacHB7rM784e8Q74B2-KAOtSWqP6DxS292D_JCB3c3q_AHQ0XvMY4
U0uM9aa6QGmIQJtJZgXjJ65iAGhHdyfGFlW1AUW4V0oifSXTbZzF2bs7pmL81ZSRB
58O_Hi0dYzBFrmZbDPlVKqncHOWXRX4tA9IkavP2PPV-fu6dW0kD29xrpKWl-1QbY
3CEdH8rrYz2ckbKgSFjMxVVh5unVFK3ctB_BpowInQuCEE5zQXDZJKMk2TQbK8hmC
HEeax2F1jh7I0wn2C0mKmHUbvIX0wQ0W38J_HArNpFFr087TEHhRSYVoldTEPJLDJ
0E3Z87o8KWd2mGo05he4KC5eZgA5osk5tugiOop5K_peMGppBsb3qQx13_PiCR2MX
W4n6aHmlEjh-Q2oWktOEo_SDk7lQDy52YaXeS1RGvy-N2FCHfABrmnAXwUqEaaN1m
SsOrOTO7mvEuWOTWVMHQFVTmfndlV-V6iNS5nOY87LlDXqcCc6HWVMz5yoGKrHI6n
b1rosJQjxOBp6XHanaPhFY0bglqdeOQ4pgwR_MnS6hLcu91cwNxfkbMHgL3c0D8Xv
hfQ-u9odnXWo-36MzIbdwviqZcMb6Jur4WOd5wsnLff65VYm-pLxmI6GOqvk2uh38
NZS6K99UuX3KAX4p2UgQPQ_XO47Aosi_1SYxKv1wYurrFr4nVZibdCngfz67YJ-0k
n6vMCJq3NAsXaRtibZ-Wult_oc9EDEAOxsZwp4ephsyUh4XGCrER0KtCZncdnMami
IykdBs6FVVAoaKAg4IyZ7vzj7G56oo1QitSTtB59-kJQ6DXESnQzaIS-EbBdQNX7Q
lFU3cEfVTwlArkyNu9mOQyFVpo-Hr0pIlFOGaxQc05LfcjJUkPzZ_9p8RuwzIfQ2s
7towpR782EIgSuwmJEAMBgygNL36fiIedFXtsoaWtwpiH5fGBk5JU_0Y_pXmUNhsq
P_oRIF-rb8j0sr-Nc81UnD2SHuGhn9lGR4sy1Cp3kJgXac9YmwfopJC741DHF0HsA
rfq_pTpxpL90MrM-OBmMP8DtxGtf9OPa_v31YhHyMRn_FqIHRxpeJhrNOv5qbQUIM
hyrCIkUDNxgsgFlVUtksIGc2L_96GGo8vk6yF5wRwr9k3XVn8WTtyRW7UYTYtYK1X
QV43J1r5ac40K6aaqgSB973fNxrZf3pT_-NAYOFsZA2iEhF8y0y_Z-Un6DMrFLg60
f7jC225oRAPtUg4TBaKyojVmEAfOTMsQSUIuHec6EJAcl0Sf6EgS5QFoHh5hvVq6f
ZgXqOQ8Igq1cfBcELIUAYZMRPLyc_sdgBnyFpDJtGQyBzy3JhaP8gW3F9_aBJLQFT
xCm05JMv_yzs7tofOpprknlK7nC_mWgioadjQ1AL9g430cZ0WEjJgr-5yC7JESjpD
nLHIOsEgegGpggK1uTo4fWYd6CUPmxgIDXVX9xr8VbCeouUIjoQLH6WNZ6vDmGaza
BQ9pCGXM1q99qoi3ukcYR402bJSgpIjehQC86zHFN0Ggqt9dJc5Yd5euHU9O6W_NZ
SIu_bAUv689wx_75HhBwCwIOnscvGDp6a0NTgNShF8lEnbRbH5OHhXLrbgjiBGb6W
CFPSTY29czL2AZkzd60nTuA-gZY-zTuaMPO-xr4q4XBi65aiLqdwdxCOiMgyrZw1f
7gZROCRVmoQOkz3q_HwwTjNb6C42mwEmKgBMTNNCrbh37lcD83A8wknIYIii9dbN6
kq2qW9w2F2JSXjTVIYBwi58w_PfeYkWOBkSsYVVNO5KrHYICzGJgbXSNt-_hRJvK3
_9lINBUyOne7vMCy4lL5RajOMs14SpO-POzo9OlI5l2M8v090Tuo_Tde7Wkn0gFNG
Ip5FWmUEu0VUsZtA1IM85Xe5pgGi3HJTHb0gFki2s_rp358lUoRn6qCHQZ-7CotCA
wxBIvYZG3Vm3PvINiUbtVYiEPNdzvzx5TDJivxshuobQ-hxUPKyx-zGkbx3i4WvXF
g5YLHAppPVBopEbCa6hBjntxxofvO0OQwwa5AO6IadeVmgkmQLO4huIRAbpTUll5A
bvtTRWke8NEgw893ymC_iS2VvsaPygX7ftNnJ_OeD068Ni91Us_tGjLP6AcLMO5cu
LgheiupgqUCOyGjbnW8K2cnHIJ3q2H0IAUj8JGfkJrkCqSH_vGDyYU9M3DZZeTUZU
nt4R97a6r2pANT8_bhf1Zv5EYCrRWrnUP9HiKteeLnQTEoYwXScjNyqeFfMn-WUHq
mk4MH7Mur9qUPkvD0oG1cLioWDXrd1DuXXaeGTcDxi1So8uEayWPFHShp1fstxSxx
W_boTEmW8bYbQWC-NO2uvSu9iwPHeI_gTAHrFun2jBlnPBpkNRO1RnaV7ww-Go236
i6HhVxDrtORdhg2Sfh8nKP_Q3abWZueayFM6a-oDMtwXcOPMJ0aysryyB738Uzw2B
Edsy5f9eTnXhUPUSb1INv-iUreYYibXpz3XdMb4lGNApXyzdu8YMbNW4kIc9eyOWA
oAZIGV9lJr6SS9dF5VQPfmkGfTQnY79V-112IBtnlso5O6yN-tR8s8PH-06Uyed8e
JNh_6LCi9ib5OqL1Oh_d4f1GEbFraWUkX_McudKDpchbO_phnxkxMDl-GVVqbrT7s
kbY7pzx00ZOjlfbCeMacZrmFtOtY1RmtEOF86r_HGZ867VORZAowVKn9aGj6ND3L-
9Cb9I_C3s9Q74qoyL8jE6jeVi1J1HkUwFCh_J5BHr-sTzccyVBqilnnlqV5dgQU2u
uQNrPzrwZEotv-PndcPee-14C44kUkZM1IoJYx_L83zGM9GcorxGzYmyQRwdSIRkW
FsSIB7wfjk3fZWulpsDwdQvgK_aUqOKnGu2IWLE7jQtCT78jhsobyi92tpKDHNAwk
yVPv-GlCMecAucSYqwPp-CMPKlFP6HhY0BvQYymOfNCnBpblF0xk9CzBCyym8w9HK
Q7qvCxLxR7ENgSCW2KmGAw-3x60qCcetvobMpmCbbuXb6E68kPFzK9Tb_rg97n5bw
ZljPQsKNNqeVq4DL4odCwbCDQfM-1Xnb1wv8QtCxiPU9QWPRl9VPBGiBOt1blzF4m
7wffAkLfiKrb-lh31IbYb8BSIkOMjO1EEbGNUq6iMxmaX4ZKEHBXlPS_hdQHSUhAf
ng-Ig1UjLKWRm7JxUta-A-CauH1glM3way0Jcb7FNucBionrZzTNxZ-C-nDJrCo7_
-LFEszjNZ0s15KLyko0YMKjQ6T8WvyAapcNY4kibLHTW_17HotgSiGvkZZ31tS-v2
QqL-Yx6X3rtzTvvYaAOJbFEvhq_vVCDqy1UMgn1TTrkofMvA-ncf5mWsh9g3q6QuQ
Y7Ri76SN4g4UcqDwUHXlMO7vzIdwrby8i2MGma2ulMXyiS9-xJa7rXRWHZBbc6RsG
7u7WN1tLkofmcNM_m9oijze-_Vz07TeixmgUreBUj5_PP4pyJOTE6KSvIy0yote6S
yzLcxroB_i4hzrNmFHIu15t4tNPOTzD3OL5H00gpQTBNtvhDAbIoDH5CTg83a-ztl
O6jPG1ndGEvnSVZkghRfHOgxo1G8_e8h_qoUImbwvjKGTnMcQs-cHELh_OqmmtZKr
LCwUDXfplNHyDYlGyTIkSURB_BYXMdyAPDCIHC8-7acTyC1aH02lFHmo4peH3VeyP
-J1Tv0pUc-BkjnLY6dGnzWdeMm-ipLEqxFPWs0lKcuCGFoB3O-sVeyyo7yZnGBia3
HJptbx-NsOH8g6U-8cwBGFDgnB9T_HX-TQHdlTctxlWYqMUI9IlKi_QJxDof0M67k
plXUhVvRmf7t27pEFb_nuFKRi7FPWwSE_LvwOFRwpSPFK3X-t7O7szdAyiSEoigfH
WX8SUpioGMeiH5wjTi9_0IuXLiK9lZPCRMJnGYRPbBQOoj2v9rF847InXwWuMp_jk
SUENWaAoNxi_f2mBr29Q2-gV_0Iqjuok9jD2_HxrvO2YfZm46fDV_t_JX5giZ-oh8
_lqCIbNIsQ8iK-QPVYdEwtTs_kbREFKqFRPJPrHq635R9iFjxYXZDY3_6SXziQ9wd
_BxHs0ta9eeTVGX229veJ79L2Mf6CqoASqjBBmUMrJTqgzjVIesAFzfOKGpape1_L
clFCVQf6SNlJfGr5VK8ZGfhFKjIxD8i69WSLuN4_KlRhGBKr5qVGFWO-5gyKHLtub
7wff3AxhyDZtR7zntE6Dbbe2bnDGlvCRX-bP9XWmLhjjQykO4LRQWGtTtAlPM9XvE
ZggSXgJ6ACyL0AcFw3TC6HbIpPRwok22uaLJGHTzbap3jPktkn9K37oTE_RQ0l45f
Qn4xT_fcY48J-au_ViZmlbRh0gstyU2yusxuYGvBH9mR4Gcu8vhMR-iLPJARxjI4v
CepPEgydwZtqXy-eUfKa3si88qLs3UQtVgeDGhyrbaLnUGEBZ0M-09cvhlvuMmBu_
BvYKky34uxMXKUx4Gk9jJLdFQ81bYA6zp1XdIdAKTXEMvFYSSd60VPKNN7Xoay3wD
xHWdlAS5jffJEkPaPeioADSm7tTjZItJw8IrBuMHsnqY4wrOTBHE2o1-VpJ2Y8BjK
XpRyqql9p10L0a9riM8-4eNIJMFtBTBKjRMeRNFekNQl-ip5DIl85y779R-Pol_IO
WbYYYAjSDPHRVwra-l8iYhLecK9vIkMoRC6FDGFTl0hC3kCDxc-2QEgAZOYXAGchX
3ZiOMyB7QTp1tb8B1XRt6EEUi2mCcwiXS9gdauniK-CQkg7F4U3nQhHOK7x1vDEE8
BsXPwnRw3llML_e_x3JUopBDQAH0kliZueQDe9xLh4PLQ1c6YK5MD0qbevxn3zmN3
7Gh_TIXi3ttVOWK3eRxW38NtRwZF2S9p-US5olSMLqA0bkPjTgt81GZIDR0bs4h1J
AIvoFjUgmxzI8QxaVXuoMgOeBqrLehCMXIL2Wi851HklYkpkP3c6gWvASMsHAU0Zb
xay-8K7baqysBzoOBeLJqCmIVdZTyb9vrn7R-F3PsMS9ahO28aOqZ5G1EAl0ATY6k
H-kiFlJZo5IvSb0xtRwt_De0qGzoA8VYwLyQa2jbmOqHe6c1eZWk_HCIit-uQ34vN
HbPIQMyUXNaKWQ8WP97eghXxKfX6LgyN4BwCL_uHuIEqOh-6PlR1VLYFbHeREgOGe
IIAgXhQ-_sTiY3ZduwND4ovN-3TiVnmFfM-krOZ_BUvpBoxJ7cE9VoiOkKD48Rhq2
D3mxnAvtGuANF7C8kTVlISH7u2TKUyrL8aP8krjKpORPG1JsRb6aQzOD49G2EkmqO
zCgWUpLkVLxrhHw4ccHHR7XA-gOu_3qkVUmQK9N2WwFh0isgBMuErzr2IuiJIeLbS
J2bf-NKhtkMdjucz3nehEz6eKh4EZf-dsgrpjaOxQPcIl0Ha8qBD7dSqkPUqsKiJB
v4daukX7Yce1-GBIchdtsgf53Yb12s6aEWClDvqu5WimDf0zFSGcCj8D5UyLYA8Bh
9mJf-NixTaAjdlPUopYzZctNLAq8r-Jj1IQryvm8ftxBgm1ybMZ7HK1llgt9e7iQ3
r9ay3ZPlNrYlrM6zbWkyTGJ_56x7pV-P2JJC4aTkKypCD54qO8Yfrvn8WxpQcfUag
_zyLZB_7NPokNvkaJXP6_0ggbxmYNPHkRxs-iBZwOq_0tLvGAmhz2tmrlCMls7IHH
WvV3Ksw3t2fUkHNSvjKs1PwdN1U3a2KGg92bsdhS_Vx1fCZy3fVan5UqEPi3uZpxX
rpi-8_kRQrBrhVF8OUuQqUbhqL-SLPRaVuW0mtddgwgLcyugHZwwr2ETorvXsD6-z
XjLTqF00NAg-fGanNRJkmtIWfCr38Cf6-5kq3kquTPbiVD1qSzsAgOcg4OYGVOXvQ
GZsbl6A60NisM2E9G2DHpyM0Cl8Z42N50TMtDBzDW64CgNWoJiurdNDQj_fCF9A1-
Gl-l6YJ7SlsQ5dhYjZlznCDM_Va001j6IQUNvrJmfyLqcxHlKxCSUz6XOJKywXHDx
bWZRQCv5UYhIOQxBNgmz15RbjBhm4qDk0pmR7pRCXrKOba8b2eNDaJSRNhTZycjc0
WCbxOehXsckEb0zILET9fVqcAm7gOod2GndQ9r7PVM31cJIjh3rwlBhJzP8QYR5CR
tdYu1C-PBuQe8IuRfgV5Jf9mwbrZDvOpiiuFoo_VFW7Lb_x2WK7eIncSlg-0zfI8k
PNYjWxI1TTJ_J31N7XpTCXga-tOAUxrWrekUbFYs_jKPaB2wugb1QbzepqRq4chwd
fdx-NHJc1DBEb3KOsbp4W1clWsL8Ub9o7gwEko899xg81Ll4odnLBl5PCYdJCims8
Az0WsR3vB-9O4WmKkiF3_1d8pjFLrsiSLqk9jZVqOZ7sKEas2K8UvEVNriVEPlRwn
5X7CgL1MqJi2639C3i2AOB0rDBpLtRamV_p1jYHEh_qGdiDxEBYLUKeNOn9RMce3Q
_mtW-P7n4gN4FFMKClyKb_FvcfnkxedA_QppWx23P_uXBQTmz2gjppLYp2H031iJX
OKb2-utpk4iJM4N4XhyoL8IcaAq7b2EyeQME7-KAohe777sLaGToZooGjtzdBo_uV
2ZpByydiqRoyqqnf21zmnlDUZH15Qv3WvUvSkRboFXgt1hWMN0zmkE3cW7uJyXjX5
zxLU61WM7d8cMEXSblQwOMJMrCOaZdZB4njbcoxeRLrDPG98LpfePsUPBvj9x8H3O
7pv32fvmwImUvncZOTObsWa6jzGkalnR6QNTYtfsW8wC9JUk7KpTnCJcGlIPjDqln
H57tVKAPGpkR4UDM2YXMVeFgQEhky4450vEiNTmm-Oh_QTpo1PfJOHRvsteIxx2JX
0NEA215bxAcG7wb6JMRmOIDEyI1v39lXfDLhsJLYIuIdkA0E4XKQXJd9ijxHNL9k1
kJ1S6pfvX0mfbuhLeaaaw3Ie93UChcVTf4vEisXenAhzqmXqpItEOZwg8LH-xRNMo
GeV73KrYK97GdlSTZ4oXcbWdjMdw_4uxdqfOh_f8OJRHanDk8H6z6AyDalzutu4f-
qMqGAjjjO8x41PX9Nox5gjvWs5cAI8j2tK8rBGAuyYPVdFbRZR9yFTl176kJcKFNA
92uCx5X0AF86OPmSavnt0j5IZVaottGz-6ct3MZHZ28aU9aZYjR0WBpmi_QRqoauf
N7k_XYU3777aL3mtq6wOGo1BmSp6N0erDJqyuYCTAJTHNcGR4CxB6h3BAioY6fsbX
IV2yEZWeYcqZIT9Ieys-KW0QBDer6rmI6w-V24cjgVxrD8r0qCu5DQADNOeSXoVkU
Y9G9DTUn2rfWLym9xU8iM0yxNOmQp2lhzUYd0rdPs89J90yRXbm-1aTrTfuw6wLym
NAjgCQ39ensIyIkMH-crUU2_tEw63JP4Np8LOQEaIvj1azF6n114NtrJlqrv1g-f8
e_slwyeYoTRndj6PC8NW9KoAos10YdNlD_Cr-acplCvOhsCiHDe7-uzs8JM7SuBcT
ni7E9SdR23HuMKOf2rEJRPDsUr4p1MbY6LM34lbtjHkkiKB3-bkaOn_ej5X5JHvCa
a_ktdOa4nE4dat0T3JbzSpRGNYcSxYTmZddvbSIsD_-nu78be4egqxMRMQUtOFd72
l9fLade3A5WbcwlpU5Gn5MgVACE4_D_qBGsgy9D-d93fK7uLtnIal4g4YeYWYgSI4
hvECx507m-7se4JUX7RBMPGrLeLj12zxQTrXQmW3JkQJTL2M4JVhScA64KRvjqKz0
G3guq6yDHox_gFj0vscUslAA_jvFicV1jVDSZbXy8T4eG2sg53Dag3-AtZoqxzWwX
d1Hg52HfKXSiwi3I-tcUgAj894aRToqyPIbOH7R3vxT_GKV7XlYN_OP6MG76z198x
Em9BDZQJhFKbG2q6vi-4HMjNHPxImrxeimD-RNvVDEKn6zg8NEutwByM82Noc0rD8
f5g7MIzbDM8q2jvoC9MX7QtT9Ky6ch6vztXkV5UMciwhZZ-P_ssmmncF-m5e-Tfx3
6nrSGkUVc1Ds-00Ph65g5NYNDjWGbAo3uIRbQTdRhsF8IyhibsNpTNYo8YKHEFHuy
Va9ChPGM03iIJYjIqtiMykYcXqmrF5GIvjE6DMGLX7_5zTAZ3pOK8GtivHtdgI5sM
ZHw6SX5kbDZlHPdmuLpnMG2LbmuQmuLz9hCxe2IX7fopSDLO3w4LWHdvsRPACEE6j
zNc0TrZ3CA5bYkAaFtKhPAi2lQHrjzdDfPyXW_SzH_jmNM9frsLdBV-U1E1BuFzM4
21uvfiMw6QLYIfuJs-f_BN6mM_UrqSXVrViZYwI_l0p6tLssL_DRrHLxrKqFmi5Tt
LKppCl1nTnZbeRo-3nRaXu5CQ_fGroP8HKVjQtAGq8-wNDxc1_Cf4T9TpIcUmX6SC
rvEDFS89lV8VoMuvZjPBSPbeBsDeoZkoX909ibHCMjJTcfTkHRvL0xHEYiL6zZHzL
AH2H85huF76wf3EdR_iO5bdmVeZwlkmAfJ7jhAglPAX3bteMguAmhAXFCMGh1JQBE
YDtBoDPl1FbyiZhDEEh1xbnj1Jfk1_bsvlUXQDKzBUlSJzPlZBA0gNZrQHwvnl5oz
HM4GwzNdeBoigbSXJDyDtybS8ZMizTNfAq6b4viEWNSypUv2zd2i4Nxw9eCkaiE0B
-8ALXlRKI1kqlVt5jkBPtt8_ek0tDhzJPEDAh9vUrXmMfk3tEBrCOiWKIYPqlJb4E
8sED76CGSEpxpV5r33UTU1wVAYLU0rcUmR61RNIyZnbiM8yUl3qBfI2I_sOEf07gV
xfo-lio08PFEwMUXbTvFUyCjEoyfzZdpdHTlZAUnhH4Fa4vvt5ie5YJ2TAI-KmruF
ivf1ngiaUeiMzObFPUsINLuZ4P-18cSQ-1BNBj2oAmowIBaIuzB8XGYLGoEEDtzBH
2YuO-oRdj844SV5dLHCX7GEMmHZyfKFUWJwUsDGTGjM1vJLNEyndDnrb5RWew8wmD
8uQ1kidzylF4-Bs7Gmyn1QVBWWLOv4ApEAtuEnJtWGMyMbPKgkscgFIgxR52Wuo0V
xqnqccoSdCd_U4xJebHF5NLuIuU-KtPZFc9JLeTwg-2RNttdLc0oJ1RkeQVr1imdi
8IP_OWk0OdNLhKVcXdfeVWE_O7-JnaUnoz1oI2I9gQAldnRFuJSnCnvWINou5FVNp
h45_1QLznpzFqCDmJiXjPn-NYWTH1WZy0JqAkpT1_1wVFiU7eKgLi0WKLL0ybm8vk
0c-0TjwtE_Ey3se_sRrZEbiYEqIdiC0MUk3e_WI8OL6gUzzKaIRfu5gbTUgYgdXEX
WDO8vGP8bXI6-CW_08OcdSzWKBq2aLh70idzU4RuEnxIOLSKegNSt7cFGhUOQK9Pe
mZGlpUKVtOXB7Atlq4jKakf6IdYFkb7ThKx4f8v80Mb8WX8zC9veL-3sraygK3Uqn
DsAiAwUm9xpmZrJuoQgwN8f9D5ni0jtxOCX-halsUTSzTTu1UqcPE58vT2Eg0Xc4x
mEm80v5ShhevNGT4fGoDlwRmTIT4BL59fUOIe37jFQUhh2VDGa6vaylXvkujLRiD3
KU-sMroCSROS3cGVgcv5LurTxsV1kafzWhtpfvf6S-tmrpBx7B1AOliXy2dPGpx6y
ofnr3QqRHdqCRKdND2JoL7iyrmdkWztBkl0MVNenHIO_imsGnrlfNe3Ap25Yx34Ty
f5ATdmiumPBsHuXYMZAEe-IrvM4KV40hkFCafwn3JCXo_JJBt0D-rbz9hd-rFq2RP
pzFeXvqPsWHfgA3z_r4KdFpY8JLbphTueZrxP960DcQW4MOc5B7pkhP7VM1B00ARw
p4wmQ313EILP3diapsCkcqbg5xhtwxoFjAUAj-8I1S-dhiiFw9FZZZTUsjJFWGWqr
UgiYDZNmn211FC4riHbT0rl9BG40mIv6BVDsxR4YdHX-CJYwPwoeRBpdG_Pe-giMD
2BEOlrUgXGSaY-WB2EZNS1_UFTCyI4JvTbjWmlduGVEDh6YOjDY7h70fLQtXu2DJK
CPRcXC1w3r4QWtQTazzhgrfTyTimbtwkNtKm9N0CI2vaFrKDmv50r2DMwY_W9O3RB
iWu5quAVUgW9gqn7jBHDR43UBsghku-PgnB96uUuXebovuevCP8g4_T0n_gYX_Aqd
5YXKu_EF0y6NZtjv0S389C_HUjsNugRM-vlr-OQVR1sSAjAhPvPCRxJYInupbO1nZ
6OTLEQ2dLifCO2Jz8CNj1TuQ6cHX_7Hau_dz_A1FFogswHyUHyTndWZIet5z-UlQy
RdyT6fxSqlw4AfjUii_5Urrc0-WJ570EKnV68372MV_b7uOO8CxkzCpw-eAyr9pZq
jBPX-hrG_YzIXQr88Yn4PxZ4v_AsyKd24Wd-vzsrEV3Hy9FLdckVq_ZP57mZMklkD
1yLb_g3-JLR5OsyMNAqzvU-qsmq2M8Z0zLzkqoHIRHklEUy1fxikti5_u0jiJfEwk
9BhtIFRNB-2_ePk9uFnyY3kqo3iI2AqN0A8m7y3YAyke3rTmk4AgyXo3gWTKQwzPb
kIUHB4dfke2CIASvyW5MafgZ7aSfaXJqGrjH_5eK0cqtPhRkat4F9TbTWyOwHmnr9
0WXHbVSWYiZXxvRf4v0ArFdKSC50OxjSFDLcn5YKqkEGN-T7c-BtyXuScPkoNbZBu
J_EroWaacEp_rk4LyMoF1vI2jQXWY2rJdq3jAOX6h8ArrzTQOH_s5yfzkAM_LkBF9
qV_ru8Rb6_0BaUtMRqF2xb7NzPDbkhBAyeI2oDYBuTm-uibzsXfn4BSnekg0rSNbS
4ZWhipYpD3qIKxiklE3t5KUlEiYHmGEX_DZKBBbRmw6w1Fd5sOGtBCMv5t1z3UNgf
lIUDUxRFemCcbeir_sUuvLTrImoUMyr_Pf9JjTVX3f_-ukQBZchCMxiQK0woZNeG9
2ivmLg3PcFn9rGsg9dnWItJ0dRw4yH_RnRV6TA6CYdg62wDfpKxaU_qAPWvEo9XH4
x-jHN-ogoBiYGuP4G7KR9nRRpzECj07U59cM_LinOl-3FuSEYRJmyDzJRJPr6gSys
cWzuepUHhh-gbaWCY0r6pDzbdaASaCbjWCCQSZZwfcMaUUUm-_BQumP6_1i2bzAPi
FLyaSd5nSOIChUxcs4s-f51WPmBKm2vn_-y9DokqIwn1omk9tpwPt9gzUjI_JjicD
qmmTCG8uPVgmA2TIzdnXxDFy_A6Dmw5eW0kuB6VfvF7UBnCy9fP7poPMwUrZa-l-b
TdLHtr4mBWNFipMM24PAPzdFrAyiAXGNjXTQ8ikebziX1QcVurOE1TNjU0A6-n2Yz
pm00Yy-KcJa0TeQt4wpJY0pdGWXYJ3LiskLdfeqqNtTlv3KYpZLAU8Dd9Zc9js0m6
o3LMFchPVV0HXm87NUeyc3UTHAHhVxpXPB4GMFSXRgVlztcDHTWFA3H_j7wpjGosM
bNt4FPs1jywM7A5epTaKLJ-8AJ95X8fRs49a1K1QoC9MuWps10uunOrWwZ-UJVwy_
lpnHVJjS11HxmMbAZ09zuZmI3yBQ8V17XUHAx8KU1ajENhuoiRf-HHzqETh_sVOcA
VqPK0mrn6YKURU8BjOOzJnUetV3R9pz0ldfObGtOTKvHXi2ybLy_ghXBfFCU4JrtC
7Sbak7FPxelMiB8xYdeKNYXur9T3vHx4wB32OgGUEiHC4GH_AO1ifqNr7OSgch715
QUbf428ogqA_MYjlInZcQaddIGeCxMvLd9BIKQ8ekRd5aRT0qL8oQfrh-81V3Z6zu
gRvpNa2DI9qQ6ABNLajQqmP0HUr3brZ3iGUWHqugmjRGkl1JpNcDQm0lpE7rfXfY0
YzzVoyZJIor0OuAi7gdVH1Ifc8QfwYm44edtCC2pB9wsHkZ0yGDIIdp2-ZG7sI51F
BeaTI2OBiCEDSw9AXsheQT1H9L1AUEqiNtrYMBlEoylrLDR1FYi29DbgWGe4VLYbV
n8kNgrFSkgG7K5_kJd2-Fj4AFKhgFqDkizs1OnIP3m3O_CuPf4XMCu8HFWLAR6ihl
IwMjgusRQC8v3crF92rrW00BxcXcDn17Au3RSl_1hClilJCrMsENfGM0ei_QJFQPw
NZ1QVnByZCySd-O06vfuUgj3WkwmG5JMnUFDwb29crgNK9ydoTf2TiUZ_wGeJXooO
5ns8QMBzvUJGVSAfe8bBAKWmiaT2FSfnhGse9Pfkr-lOsFRZ1fp1g58QRO-KRx2UH
I34q5OlL_gAQKax3g5j_eTHTdQE_4bPAGFMPzVv7hiwzLtX1V_UYVp-C36KssDKwV
NO3stPWuxmFRjElgN6ozWBlFy1LObOOL6H4IGD_Rgw4BUtGAtr0QVgbol8rNgljDq
BXQNzft9vvOcQ6vzJ_tihLUOQwMpr5Paq8w6NM5C_-yHX5wtruBT6VxFX1kQqBHja
fPQHAXuITKRp6qUFjRpXPUUzVDJ3NB1sxDYTh539HfEqCp0ttwXXDQun6KDcABkp_
WNCK8jNa4VVE7SvRnvI0fGH76-1eGYU1vThhX3JQVFzu7-VZ-AL1N4vAAPWBMbVVR
9Lj9-JRFboQn88rGJMk39akZ1Wmj7eEA635lY5J2uqSzo4e8grYRCH5ljM-UgDbXd
jn-bQo5d6hZEC2awPk5LAHpmGGw6VxrQ0d84gmSBms2iv5l08Eib-oX-8LtPx0S_O
3w-vAob1TNFX7TYXJ8EbhKH4XEMCwGOq792nCcLZf7YTey76SOhraBA0ybkC5kI9j
wUubOrilLM9FKbP6P1bjgWPgoaYm0DwkH0wlQCt7JuQx9c2nRLRm5DVIGR_qyPTqQ
lKV6gXn0-6kLU5379AHx4AiqDuWBDhAOTQNclWaeutjC7Jagr1K__Y-8h9qs6I23_
2AuofdxjOX38jUF7UKrSM_CX_bq1Azzc_CLj-bjYUpOiNCPDiDSQ-xv8FCGLY85ec
u6kASk03sjnG-77D3pnOrehn-y3ZOB-CrwtrAD-SDCHJmbCmW8emQ0bvkKwdS-hVQ
InmXiKnxGP4Cs-uZZVzjrbqDxRPJGq0ttBbPRiUzw5QbY7C_bezBLKjnZ--NN1kHP
8V_b2U7fVfIdY27rSFvs8eVSwxwgvHpkZ9vZsCNwte7Z444MQkbzegYSc1W3pwtFe
0AnzxOR4-77wqmfIH96KDfUvSw4b0_QFSU4x5LpcQZJPnV2OQVbj41dmvIatMfX-3
rwIa7u9xP6ed5Gm3ADH9L3pyLGRcD1sJ7L_g8uFuZkN7pvrOKRq8vuDfeHey_-BQk
dx741Br_ceDEsgVCvROZ2gT0CC1hpyYo8cyZvsRVfIblvBv30_NetQwQNJnvJvv6W
uV0izSc91KEmwa4LsmwH-54ZUy7PQpNdHPok0PleI8kd4d1_wRJjMIwdOhCEeH7yK
5hi-suVI-aCUiQvJxyxwCqnJmcVff3p0av-2GhpYY5YcmWFTySPjbFvHk9CZ2g0l4
IfuCBD4d4GreCHBLxhD-6Y1bK0lKKHzqZwnTPn5_BfxPd3pX7LAwLdWBc4yIRbDzQ
p1KLfGhANO-Yj9Kyu_wTedi3CMDz23KeUeVEtsFtjz1WbLvcnionOfP17uRdOFc2g
1I8Izp3-lu_jc44orXTX0XXgwKUBRsc33NOd2OuZpTp189rJm7v4DM-RZykm4KmFP
P3l4V5wZu2kNK5dWcqwh02zSMSYjRfY1_uj__5Fta3Gy65H7dDDAPUyaqAU6nHkOw
S8_n_41APcjCs3EQqmVXZvwAi1yIQ9fKZN_OWz2t32lziCTzc2QB_Qi61LDjxlzn4
tI28gBWwl2HNZTCijh2C4JXfrXzFpktECGqb3bnsZ-Yn8V0MAGC2L4D87iMi_Fop6
CiQXkG-mMpAZuN2PWZoq1iTPWleVF21ywLuMq2PNGuD4du_YCCf-2R-iyjMF-3wA1
46UDx3Xr7kwaqdxxqmpfsSS3HIaz06SUxxFhMojfDk2brqAP7KeSpwvCUmTPRtyXu
3so9AFPqOpWUIjNPOgCpBwxE1FPC-E0vgtg3Z2E8G6TFeOS4zewGvECMKwIoVi3gN
wwU6cCGzZw14HLLXxIcUnBIdQMvQB1DiZYhnOLog_xpfkWSkbRrPMgm5q_Ywk9Rl7
D9Yyd8M5UTlCGvNoJswyMRE7IWlbNbTc69NV-YDWm6mxd0vpU2E0TUCnfDnFY4fh8
zQTyCELKZy3n-IdinbJrDVeuFJLH544qygyu0A1b3vZEb3Kp6x-r3web2cTumdu7y
F5XXScw2CgNrVp4Ehop5fGeT7kBmLYex3TiaN-SUbg_8Ro2zfBC7os0_mkR-Zt--5
NbwjoRXAdNUsC2PFrXKbd-EaicQ_m5ryW1ZQQJU6OWKjaNSwkdKiBE0mzK-XeyVLS
r_cSbGmK6zM-jaJIb-ErEH2CyuIbzVzjSV2LQsHoGQqNloC21TD716PV-GFTqyITQ
QtLYMmAS_Qc2egRnDoBQyh0u3jwittZtpoJ7zp4_zR1e7EoVLNXWafyRE80M9lg3-
8dZjgNoUFvDumeEx9g08ZB92QBSsDdgCeLFNDgalIF_5OQLJjPiB2YQim-C7OsyNI
idnQJ7u232p4A11kRF8SGWPcbuKEnZ3BZWUmcjt7gnjFPb6ZMFHBEaeAuvmg1yEAT
bDymu92C1cACFk-Wi8atDsWtG1MnKKEUfK6G6L3V_Vm6h2ehBKUzPFhm6sTTfT1KV
o9DqNj4ZjCzxPvf0II5BLpMGFinaRgJRcK78T9wnQEjAIytXg4M0PzE96gp_qMaYp
Mz1lUlM7dea72D7LPmEI5GF0x2GQGdi_coxZmFhqzz355TNQMQE3dsSQPZAzh0ELv
5_iyKnwKv8NBey8hNAaezPZilHz9WqEMVn85UyEIqP9GNUJhk2-5aPk-Y7WxwcGhI
HeGs5SASmgrE7NWCe7Ze4IzHRm1JH5ULFls38SW_oosxRTNhVQEm_YrOOBeNbfTYU
x0mvuSrM_PyUg_huQMxmnrfPgOG_s7BYY-YUqdcjZ1ZbKM2n1kzvOxcE_Lq9wQhqI
CLKB-IO6NEpyMnc3_fb0KZHs1xXqaJ50vD00Do1yRNwW6ECJ0NULxuJEcWKuQyCu9
sS3dwJ6MyTnafAThkCOYIdhcmJLH1w9FUPGZU9OmlSSLw74_DboHv5EiGIpZNTC5n
57-cCoANCrgpFqOBtpWZf4-AL-ab4wiKJyhRp6t4xzf4LtE2nue49sDjpAiZ8CINr
Mt40p5YXKa1dkcp1eVC2r1kUj3I6Da0kLNBagOgNTfPR1gTvWNWfgJSZ6vfNJUQ1i
xnKdPdqlG1Z9CmVvRGUV0rQQpZnMKWJJP_YEQoitw2d-kvUsYaFhspqmOF-YhXek-
fHqtffma3qBulrK39TMBpd9fgSgoT-fUjG6IqtdQh3pj7OFD-6J0OOBGt8habvc2U
Pw6B98l2K82r1zOT33W6BN_0f2FhJEiXfud4VjzF9tl6mfljDbBsPp6aUdvB_Jfia
0XFPdMc2LVctJkJUkrvwBMI2UeMl9-D4ZxhYXBEUqr1rO4qSVRR-RISenbJR8vHR6
H1hLadefPbKOXOUpxzut2ooQyYYqSMh4gO6GmOcmPv0mSKVE0vFQvklppZPgEm8zH
NKHSbMEZKtL9Zaa4wFJF9w0XqaqM66joP8ZRYK7xSwORTI_78aPOaVi9Fmv0Taqw5
dmC_Dm6vr5o2cyDUYCnrf0IxZG-4TaBGUSWWPRJ6BFwUrRp0b15CRMGpZWTk6fBuv
H4xiYyInHEbctJ1sS8aqNVdL6MJUcSjXZGvFFzBKafqml7Az9KJymkzwutrp6cqhO
EjtCPpS82pC5XlG8YTl6Z8LkbWxcd2fRFqkNJQhqCA11xcUvvS8pVw9b1nXYCmS-N
OuxuzGY9ZnL6ZAiRciUJBkT7zPYLxM6tLLMxYlvmWPhDhi9hZhuceJ1ALjXr-CLeL
GioFV88EmmF35PxFTVV3tptgxjgwZkJOT6N0GWMfr0E5wXbwTQ5NeY-FPde3TLI30
fDH4q_7HoX9TkEkcxAKTu70WmfP4UJmhMPkVGXZepIa6HrW1M6MaDJ4ctZgPpOP0s
cP-RL0g34DZ7YIoNZJQ115wHHDO41UsiSydUxVax8Eal1RWK_taBsFB_vtsl7G8YS
BbHnUQZRRgkUCJNC-mRt27UTS20nC4GMl2oXfF56mCmso49y1bldDKkU_BFh4XwFB
khaDjCcYaDMIG6EPj4Kt8khQBrVHSLh8rCanH3abmSK4Hsg7NMfxCv-47-b6hsKmE
gvQ6iDu28t8L_ApgDQAGN-L8bxSVTsV7qqQF1nEjTcMfFd1ffeuF9UsRyaSCwBPY4
94o5V6aTYwUAgS_hLTMMWpWweGwYCySzHhZX07yvYS0NuMrXYnSh37o1zaCCBY64u
97C5Ifpe86_6QOqlU13R1d030J-OZPs3KetxFxLc8LPZcCj3NN0I4awGTuHUeXGsb
LfVq_WhxVm78s2egLzn_gHgT8U6B58FZt1-VvC4Eo8WxDM0t-vsWjHkY_-BiJuKMo
AuR6HrQmmTBrnJPtRHBSAf4IXahfbAmXWA0iTmVVju2cYLGq-uFJqTQK2qm7yVxjM
OSEAks0tSl-jqNzXvU-pm-xkhdK00K20dLwja15GiwwZ73VZxP7zkbMGl9YF-nxtx
lLijrSps_qV63Bw1myzCFh7v_TaybFVrVQhlhpM1UTfrdXupwOJiMzAFzJuXWv-Jx
ezKloCfbCBELiwfaW6qxS7-TUcn6HRBwRWQ4NBxIk4nlPzxLgiOp5zoMpE-rS3snS
7YmoIlOXSEU8HitwAMneDrLiJrVFVQKhLZzQJLe9lvQbO2AYiCMmFvSxf6P1e2iKE
_HZ7jc1yJDFsYQXma14eSoF7xQHtpO0Qf1zqHz2ngHk8f1Wc7pNdrWh0F0ywLjxb7
ITQNC-8isURhOV4EKUsDLTA7K9vid-TfRqpqARwhQk3t9Wjs9Q1kIBAVd4ruXQ-n9
NkP__u6SVBrWelHOfzdJ1vL_mR-1bb9_LMOE2d0COBkenZcV0qYZ1w7UeD6xJqYd0
67KgSa76HiBLgvQxaF8aWv_4sNbSZnwOmRcXidRp_LJ7TmRjocWgy9JqlXv865ZZ9
eSnhHjDsW3o8A1bfxuO5f9C-aJgI3JAwB6ek_9VKICj-nYAcPR_GNkGQ7IWFB1A1p
n934IwkmYzkuO_oV-9ttkMIjNphw47QOUemtDfn7sPKvyykrqjwqX9FdwELaTJhKG
NqGrm8WtMGzwN3Csv7gmqcgSnxeBIHezBymJHZoTSbGqjyedd2_WyEDNFmIIc9fzu
m0yVxmf5A1Zt7WNKOXoGBDsBw-oH75HiJwv85pzTaORsptwOYsNnqju60-K4QGleV
9vpfMJZ27gWQuOFLKiRwzzxyfUjuN6H6pvQUUqOzvkmD_VkUPpK1OAxen3KDTQS-e
3TNKVF2y-F1bmcu1DVVz_zAdjR55SA1QabEkTme_XxdG-1bRrXU4WzqP9r5BiBBCG
qfc-VmbZqsXSgQH1m9eluI63t0emvKq5Ba6k8S-BrzJpxMEKfQFi5XO3zz7G1bYFa
fkLvjDxuw0wV0zPHiZpFHm5QR0gsqrB50pBWIhRIyEjoIuDyibObHxPOizHwS74H-
IKwytCOsQfOagAUwVXo2yppX-b_4DhgH4PQlcba5rX9yYOQj-A2WayB70U0R43Jrg
xUQoT-MoX0BMIY4p2cYUtO24_9M-exMNyRztht7b3-1dP22WGCTic20iuwSRXZ-Jz
EO8xB09YSXCOjIUUUGuLb6ZRztWi1bNGXY2wbPFFVzwQQ7VlUZBEXnmTcq5iyz6yk
cYG8qz7orRuwcNprf9aAtPpuS6xsajWOu13V3Iu-DSrlnw1Wxxw8WgAz1DLglPZyg
LmX6pOLNO38b6ewzo5P7lHNOdyIl4j5vpRIhPVeHlrxG5uYHiUbxbEwGzbi0GNVqb
mh5xcfd4q8X6Q-NuMh2MfEMaHMvDCuJEiG-lmudldVzLK7zpSp_SnKwMDqvTkY3wo
irDBcU9gIvbpU1TvIfyJSer4BKwV5eYXixQVXEddOo-rx-K1yV_xLdEcdX4pa_-oW
6PbRx7_qhk_DYNDrojNuNvEswDQiiw6xNy7IaYsxcTEbg72rqZmXp4YchhycGNcVt
re59gB0LR3uTEePYPuP8JgPgjMTjFEs4XnzPCxRT9WvG0IJyU81S4yQWl6DT6vg8x
LuS-kAsYbWcdjHWqZw7vekGHy_NnhdgBLODG7lflcNtuCN7y8BubV61rBY2rHRiph
d2mWnZYzyf7frQkT2EUGY02RdycG31wDNw5lJApsIa7MUARKe3-_OC94wrmfBL1Zt
vetgwe8HOv5gwglFPDkwOiJVWmzGeLv4ouZ_ThXmCnJeitGg52cwK1xWi6W-0CIjK
fGxR3Ap91-ai0NOkHekBNd8rkRa1Y0XiY_lRV-nEuLroDIKXqN9j4riUE5mpMaY5D
h1ShY0ISbSRoE9BVrm3T3vj0w8260-Jcw2_U6SIyfaV8Rgubw8xhgPhMxmQiD9d5a
_14UVFlgszWDkWeVMHNtk6sEt-S8dEZpD5OUJKQHEgV9IJQY61CLdax07HBNZpt4_
F4vdgqLxjCqbp8epddHfC95-_v2OwrBxBd3fx0sOqKSDmQX-AEpc-HZjH3c2hIL2l
QoWu8q1cfOUfrEQf28m5Y_ZdwRSfg9_1haWGdg2GFRz2CfgyUNmLyXhH3ciVDMUwm
9PMI-4H6fGU-0IJueTi7f5ZHyl423PJmqTDIRAfMCev95tpe2gVJYTJsS3HeVHewt
tQBbUp9x8sYYdizTUd3U7v6jtJZZpLCuJgJ8zBDn9fwOjOpc1Ufs6EikPyc1qHTFr
xQsPTif1ts9I-kGnMZsoPIi1qir98iT2BJThV1cSCiZ6vNMvrY_yXgzS4BIODzLCo
oaPlDCQSXoCso-Hhqr5UmykgbbuNxstajBZpmb8cqMWQE0YXNN6LLcjV8acegz_it
fZ5ZRUDRB8ZKv4yFC2Y15QXrTpDR75OABgX_m3_RaMfl8WVRALx_ImG6OuhGGO6O7
YMgWGitrERiK9Y1Vo4OvVc3aMXkcA7daZcaDDjxevJ7R3g2D8JJdGn9HG7p5LsNFe
rD3AGfjciriH3vlrwDB3RLRB-OpTxsG1ZZhOBmkOdvvbqdpEaLZkMai9Y30OYn949
eG6K27brJhgiUdyLJ89Vlk5BsccfXy2qkPmCPwtbau8k5qEp_LVFdeNglXle2KEiu
JzbJlvKbwJYSgeAmp0aKKK2DM-j85V76kRUIz37C437yn67TMYAjBafRrOSgoq_GZ
OGFeeu1lC-6VumcNetC34Cp6XUO93PZ1rP_QFbra4_KK-keGv92lwk8sD5VMDHcU2
n_r8GM1XoJ7lau0oY_yQJzF_xghGmPwqYUbDtUyyIfQ2qPKV51RiTdvBF0gAuIrCJ
68GC6FK3cSGHtRYUCF381IHcqRR3QQvzICsQvA8bleTSC7PjEA8gN5auOWEu0zIRE
zSW0-Fz430Zi0HoxUMsj2VGXYLew8CmjNODhajT51V1JwA0o_8CqQG8maZxOhUGJB
ntJahhMhTBsdoojwaDrn2kkjC2qTqcYH700vOFxU30qEiqMWh1tULoJhqbDG3ijti
vhRxS5CBZ6Qmi1tfRaV_fw2PuuSUnSTZkiS-umxmXJeufrdgDdEijn4oCtxIZiUF8
a7EsjtgaWxvAFl7pzPgh-FHJyF8g8D_nh2yNOptWqHDVsO4hFSiPRN5_CJcNUr7tf
eUVxvMVyewQkqnqBbV1KQoyrAozntCdPj4UlLAnZgjudcA8eAe2S71U_RVu3Dgemy
s-eiGtKxm8QxenVE9pT_T5vItcqYhmYuHLoongy5s2F0eXgGTLmWxskuvXOy4S93h
zaWPBUU16ngcoW0MmFDdwJNu5GDHfSUUp0BlTfDSth7ktdkudelfFtyW2vABmDnp1
PC7usosk-qtI3mf9uHF-Jxf7dm5htmxWX2IrGHYuY4vjoE0o0CSRZ_A3Gu09SUEiS
JrQ1GnslCDgWLHJPiqADtqwy5op9PUY6elRiKa5uV-dc7x63kqXalt9v-Wgk4nGo_
iiebqsGS-IZQn7ss4ZCWNCALMwzARJnjGStRBJtW1Ag71BJe6WH4_eUTeYGYm7SpZ
WIv9tKZ6QBnsD4MogPC6cHKh0SN_WrfEixnI2zMLu1sru05twAFZOFbtODnjSJ3Gn
Oi-NkXoX1ZA0nN70kiX5sMhnj976haNa-ypyVA9KrWMqSYR7NTlN42jR8Z8hLb0Q8
oMjfDEG1eFxdxi3KuR9vyE93qrCmas0RdsUiAcnBAVKFAR7oxp8frkzLnoQPxIji0
TD3IYc0ABL3FKj7aghUhrwNmFHCd5SL1hqbfL-wVKmpIiVDdH4kPXdHZF_KZppbg-
0przG_GF0Cyx---BGTcMv1q-nTDJDXYRdHUJTZFnge1TrALl6haVOBxnfPlm6BfE6
y4QsrRNI5xa9eUzKp-1Lw5UPEte7Qyi16km-tEmR44Gc3S7_lClC-a5zkJNgq2ASA
MnhT_6YLruGCMnmMth2t-08QKVtp76Hbu48_9etAZSFWJJWzEYE-QnAOD7t4fKCzy
Xe05RfWNbrPdmoc_-nN7DATiLOlQ8OVkjDdLH25GlgbQtBdAaGtMsiyU1nAbK1ORM
ILtjV4a2qLQ2mo5zKwvDQT00YScpplAhlJdblsyvuJrDG5t-bvomWdUJJ1d9N81fr
B4L0eNBsp1YRmQ_RtpV3ixzb1G8rAIi4HotWi3OhSAAToI9qfg0ibAfisTC5ykUlM
oaD_kpVV_hialJ1UxYM3a8s3FqT1aX-vlcPuETgHNqRJid96aFJaffTDhjgJ9H_9V
tW6IBQ6Nxo0ex2BpnbkBcNWbrHSzoHP-KopI6a_bbRbD6vGeqz1o-zOwqCXfQhy9R
ZeGOQbtIbyumfwHy49cSOG0GJVgE3c3IROjnLkcvLCWMOUBftiHrgxUpHxQtTyKAh
FIpkyrcx4ANMqpJjTh4mx091M3jYUndCbdANBFo2z6GdvpENXnKYwUBi4pp88c4R6
eTGQncG4E-0ZuA_tdFt_539z7e4jhQAylT4bdovBD771Zcx703qYYvUPGmuNWTfR8
3rUGAlT0I1rUO_Aj0jFOIM74avllrdkJIH8DqKiSi5LS1k5duzfXL56BAciRjDmAE
7UTlxbdz7jLOIa5T4vi-AeycB9BzY5MDXafXgYaimUw6aY9QxwpFgksYm8wOs5Ynj
c6AdVlhmctMIQtk6lKNVNoTPRMtH8HUu-BVyvzGWy9Aa1FJTqFLJwuxCI6SsWMUX1
RA6vo8DS6mlYkKbYDKCkAdm6XbcU3nJRvigkziTFHL-UI6AirdFoC8FlVyRwU4JsE
in84VD3_7d5e-y2A1V3mfhm_xZ7oa5NOOnbIb8ZkncNtmCeqXfxF7-oRxfFB3lYJf
PkHdid35pR7GXa8TGZKyBfRhIFMtEYbCgh7UKjbX5rdcZVsf0dp-PTLL63plQuDmE
yArJNNSoszxDKjtnT3oXUoac-H3pfiBkzcgKXvMx_qYU3tT0GsneEPOh_pi8_4QQi
aZGRdUFY6_tU_ljndDzHFR-AjnlkXbmPYbWcCw0ZZLjeRj0YOoqZpBdsvnsVrVPYz
QkHedq01fOrSHWd5tD_8J1OiCgA5BcqeXVihDvlyYf3nrg1Ep6v6uNSrr9X4e1_5i
Po-XkLBGkBCP8Z8bwEhVHMz8ePNpLdoCOiH_1I3CrLUG2MOx7OJWlHi5p9_7YmbZs
lh4JeTMnboacUyje4x_zBcsxpwW6wqMGjm_g2JjEwiuXyViqZH2tWxf2wCNtl-rM4
-0B_ftmS_2BCzBeWju25SmkvrCBF1w8fCATCqsypVDr4fZxaZ0cyGkVE54VE6r1kj
fm6NzVPOvwe2EhnFgu_AZVq2qlhCEsrvg_0E_80vY7wMqYHImHZsqJgof6uDESIWA
9I21rNyJroBsvWeGLRjeZY647D8z5941EYhUXePn-TGDDRMrJv_TaVEyEk3o-Hts0
P0-ioN_8m-TuuaxIsmldM8dLQQoGZ9qfRJ2FyK_FUQsBGYUHRR9IH8tlsjeg0o78Z
uFtUgtSWwxfL9oa5Zhwmq8c_buomaPBp3dXMg3SLe-8g8U3YdHLG3Mr1qnibG0BBC
COGcSUaqRIyRp-RxV-ZkS4GORHASxMnogtmsS-rwPwiVF3wiwIPFlAW2jr7JsKmXy
gHab9yBnGpEFtinWSHRO74gDVpJx6vSZosPSW_DY3F6mIrqTx7TOvRZpFWYIxjIOu
jLWqKmEphcjSvcufswpEiqMJYZH8YtrOu3H_NSj9ySWHynbiOtup-gD5yeXy337TJ
3vrOs6Mjb0xcjGfvrAHFN9ybyHPKWwcBvGuDU3WEU034T7Ot1FUD4sOjWdfRRfATu
GiNtbNIUFz_QPLEULHeRznLmqoobLx4S_JlxbhleSRT5900lZSroQ2zE_BFEgV4X3
tVu9fmavfQD5KqSLldWcgpoZd5ywFDkDprufxzBUECkSCYHyVQH3cfpaesC-Jq_Vx
30zCSKvHfPRIBGCIlavwR2hGH8_7M546lCEi-nBrVIE0vnQJ_Dn-MFzhjMO2NxYVy
-gohhhh-NRuZs5dbknYRKJ2RKDG8T8TW1IayuFu-5hdl1eTqUvbeSayjE02F_iQv4
Y1e4uUXK_J5Rs-3U7V_4PD0APJjvLfyQIhqjA50ib2F9f4_do7di7JGbUFHmGDdy3
XWFZDdVm-dIZT5_QfPVPkX2sBkIrGiGniXOvqM08qm4IfFM7gIZeeJ3e5w4PGrMCR
sj-GkTPVMry1AQ_fWW_i7X5bbwIVnUSRdaaUe-AlPlpLJy5YeEDKfFeTuZ0qv0pfc
07MJVMYmdguImlQ4rF7molP9Otrhhf6AuRM-b_FV_tvuPnwKgNkWaIDVw9OtaQMIG
xM8TXxTK9C7kk5sNNgowm0j14H65meD1qCDZzUHFJN2TJPMfi1FzOJ4si9eja5z2d
J5o4Z_5vqf1447jd5Fj6WQEICWI_xLpNgZup2VOUpIDECyFSNORDhJBT3uz-0RnJ5
BvLX1KrVgl560oKWEVwT8SK7aqXBXUaEEVHhAyFG9m-0081IeIIMYQFSgSSc73kjc
DIoaffLhfi801CIeidBYkDK3sf095VwqOshzzAPTqcUpgGkHeji4Fkp8KOJD2WRRE
H60Lpc0ZEq3Xxs_FCeXcb-Cw7nwwNFhqqLtHymdBKmRv8mvXeToXt0zAT_DmZOaiD
356yJFM-1wRT6ZIwjAVsY3kxF_WZlGhx2nhbazOa9uIdOEn91-zOJFEzSPC6YuZiH
wzNaOsg6DpmcOyFPpAwrguHgiPbsgaI5UVz01FekZ_eXPNMm4D-ZP5PR9o-zPyagJ
ql9UUf8IFexg5JJGMc8SHfoAWbIcI96q6uoBv6Qs7zKW4H-afEwCAzLWyzqD_cHPd
fCNXGnvcNQDSIxWY7gMVoRHY5K8ZoQ5PaiGIMx6xtxGHnscDMfmIfiOrsA0WmxbcT
aexYlQ7MdFXN6rHr9JdCrYhpwNQOhQcu0CZv6DVuARw_uBOyg5MJf8Dz_iaqUFk7s
IBpo1xtWrKE4TxdVuzEmuhub33cyeiDlHQm9XJeyHDY5H8yH8O9V7vLpY7dKJlP7t
CmtgT02nzJqj6nrB93vDxcBx2zZHQpXSZeoB6NxOeo4N_em_X7pSpl3U4Flv0iTwe
2iEfKx_OuoGwxiWz1iTxsN_CrYq4a1ddvhM0UnsLuAROhA86sZWy5XEyEi1Jwgji7
KADNBnfwkCavh16FvHTEE7wM1txjNNHv5d1hfDwxZ0IdV2AQzDMTQuH5hKI1VB28a
dgdNEM3WriIrpDqK_aY134jwiRp38uN9tOTI1URGwGIZjFcx7Rx5ujdccGbMLn5v4
gHMynTWjvd4UC6AkqBLMAqzJZxlk5kANyDjHm2GmSceCEktOnFiRMZHgtpNGPI9fK
cUqiz48e42uOozJtIrQa2JFBSTz1FnyUVEQfYhUXOsQrGaxw-xrJUurC8WZmdtTEr
E_f2xBrXwaOJ4tO2NVZVq78h7oMMyonX3XglptkuQjZtHJ3ihGZGnUXr_128bdF-W
IyxN6pgWrlE9hVXhIXzjeZyVyTOwex0CMd_8eaxblIGr_upxB_KufqaR1XHkc1hVd
L7nmI7_dujHI-A35weeUKJT-jCphwdeOA-R-owKqMaVqD9ja9l9soLnPUl4UYnmDW
b796B-jWtxJDqeaKJ5NIWUHlOKtYRlc_RKrr2BfAh2jvym4Brxewkl6LSv95v_BmF
okNcWvGGDSMckb4jMJemWFqpiryqySjlA2k5ShK_SLKcORCQB10Hv74PXyevmuFkr
lbvzVY5mV0q3fGyYtZJdMu9L3cBD5o0YT1aTk5cJKXKOOQ_XgX-Rb8UvNMxQ07HJa
RVFKgSOXY598VxuQgHfXVBG3DifGHCGFTVMTt_h3Hwlz94I5Hf4bITUbkTwKO04ju
7Txdr7AG0YaZMEHXaKoWDbbzvEpl2IHZGpdhg5Wo_5xjtGhQGK4o2cFdvB7Adgr2S
EdkOIVWfrCugacXytbrIDMRfYM0QlKtjanq6JZOlfXS9Nvh24Up7jUkCZgmna9cso
VO5zKK3SnVYTbHl7_kgLdvH4oBycjGxdxusy7bfClfF8fKm77Bv6Xxh9K2254EQd5
TGQjNZb96sW9JriU4xUKRIEB8c8ILiwXvAKFUA-QRPEwUTd75dRHDVXA-TIxMMHO1
JRwXda5nxDq6aTwrLQPLvr3eUPuW2v-4mLJebCc3VdQXWB1YuXMRd3HG9gXQvxID5
CzXJvC_BOEPdhfze7hFZRy68brTRwRYDTyAw1cf6A_1S2ZyqOTASwvLg69Orj8eGR
RxoS4yZw7A5OWr9yHO2zOJCuSm6GYmCGLslmD-onxRJJUJGgOk0nh_6pvdaNu7o8b
Vmlo4t6IPkxDRNWB9wwjk-OvZbiF1v2x7hMrL1QhqmIgbLp_eUQdpSL9JZwB4FRhh
8Jwlfkvz3-f2EY9l2DrG2dj_e4rr0pGkL_RGak4QZlcQOpDVWOgRzbgIfU1yfvr18
7SlWdkIFhg-Xl_jJMhcp_UZ1Z4CZZqqqfBugpMCtPVIiDM3TCp_-IuP4n7HmzU1-3
lOLIU0zkPPp98aC-VLO8CklTmxoiWp9C76S2CCdAhCLAtMiGXyWGSaiDwfhtOHbpn
DKIccd743jAvRwYdsE9F5eGPx7o85i3SuQhoUgBrZS9sc8P_uoWIjDjj0QLbFnomv
TJWPIIc8JTjrfAhDX7gVZLnUgNa4jdTusp-rtceyHf7cFD6kqsDqF-BHmk5jETiZI
Zy2tM4WJjNJ3K6sfBGIAzJ_lr_Y8etIjpb7uv8pf2iFxZhwFf5NIA02aIstVGD73P
ktHEnMtKaqZAnWYHGqbAucRrr0ZQC_02xc2LFoO8D8gwHjVL3wys2AUwRcYp4l9Et
ZLe5vkFRB4gY5yIIPHUIejHWZsya9CAQBM67rP7PS94M_J_Fglu0Hzk6yXpYTsCG4
I79h1on29yEr9qER6Sq2Xq2ZnApwr7mbIvE-PmmEW5kdU9sJHh0j1anZlwtDc95Vh
_aKx6g9IwiGwFwU3-HsHnmbJOsRVeZg6uQCXiKk1DpX2CHJZ18S7zqFn9BpNNbu63
_bUXt55AV7F-rEhvCyiEmTNrnMjGO2yjI1JUefa85HbxYxAGNhjRzul21BUKr2piE
hrO8TxDw4-nutiQt6g3NGdp1YJieFtjhjKzYMDQn7OVJ2pnUqUsHbmO9GwiNl9nHR
McjqHHKRu1I2Z7AtKMc-tvuLrAwmgsVoyx_xDA7oLJ7pvq9LB3IA6bivZ9gLyLjrR
G6Esnc05BzSYqPo3hlufEt-0effdxjD1eROpBQqEjCBhxyKnNOI0sx8X5lYB6cKFp
cSiZ6vOnjSvnROms391tDpQPn0n55t5PyfFd1k8Ggl4GLniwHxqGnHrOYhvPs3Kog
pIAljc_8Szk2Nw9TSNhivMW6ddxqZFhUR2Snp_07tsuGSuJmP3M5SOzxe2AwJTR0s
ZXf7Botfo_TvhyckN7WT6swQMY1nd5pvqgVrAi1IqH5DzNZ16_tcbFhZL3KR10mK1
YsyN6qoKaFLsx6jZ2Irb5yroF9cPqaE6wKP-oOQD6P-zZ9IF_fM6i1k5EiBg9VcFY
CuwRFzOmsovNXHKARnfu2aLVMKsd7WO1cn5uonDwv_amA3-1I2W4jta5sLL2jGXId
9C8XpymJfHwv9WMHu0Xf3jRFLpZpunTT9jtOfIMU_zR-QsrwzuNadyiwOC5-t0dXi
wWJ6dn1uoRzF1bngsrgiWHm0V-uhJa8QpST6ckPyQ7rgJ2_w70R-3F5yqTCaOGNtg
FFhOmq1-fxP2je-LVkmqbwK04KNV7B6riLsDBwL74DzSkMSr58XbgUjrOkH06F1D2
WQbVIVeNQzFlcMfjfL5L-dpSaATyrNQDej_CQsooKWCPxwVC2VffAke8vZoiEY1Ky
L0Mhf-0yexJfREdiJgxCI5Gm5vsM4F22JxU_e2S-EnfM6mC0sd_cdSntWrXXLk3TD
bhdgVx8SsxWsVLGCnLlyOUkv-ukghOIzJ09eL0ujJS_wxOWvbryan7Q9GYWHyEjTv
O47r2TnW1NDyUMLy-zSDzGesXKWljP4MI0d2CD3Z625rBvALEzc20qRgm48A5HoUc
7_lBvmVXlJw5oMl7JleOU20Rcaq8f54-Sn2JAknRALY4l3mLlmKsOWRX2SeffVP2p
O6qtym98ayT1OMAWgkeDuCwGxfzdJBH0bEFeaSJinb1Mer7T3yTQG7OoSnVBU0Z1m
U0GeMFIb_JSEaEkpwzx7zmTi82kU58XEPsUBjrPbAeXITQfXlKEPeyL3dBhle7HZj
_Qtgxclv8ZbXCTkLFwvOldHzk2v7GlqZqtZxR_odWc4iYjWj7OGYsTp3tJ4io1bPk
iBAcjKA7byOoilMS4Qlb3o-hJm6IdZOG-CH2e1PzRZr-gEgyjq89ZHNh4taeyYIPk
FyaNPmYUpWS8H5bzDRE2H2ThCQzZy6lnYYDOyhf6zSxJNfvxIdLs95dljd7JhGb_y
UCVnFpwBIxEn6Rvtc-fBBYEkdFPuLzwcIgAPUc3Zmib7_6pcAWQM-37W42EIZtNjb
jMJH8W5Hw5bTbq4n8N2KlNOKdOi-Opk7iO3qsig4BCSiRGQx4tfkhZ4QXeRsX84eO
KwQG28VBjzaMfUjta2gCzKyjPG9toa4sJxDMP7LNczlJR9YJCyk_nUCeTOuXUsOBe
3N7gsk3rZH1NWX73wRfZZ87yldMvE8u-yLOD7JKyRbuObsxlq3PYPJwOATSdJCX_f
RfEqtwjShPNYKB-ftj9XDtisy5AFYYOlLu2sjL-_pq0uhPOFEQ8M75SfmNMCB8bND
r5I0cTNIUDAfCgd2z_lQwUtyqbUXkTvqHhDxA6GS2jjtBZiawwxoE_9CKkxbJxCLv
CWPlESQpaGGGj6WW0GgsS8b4sqUjHx-UtsucKgPDuD0fl4hIC7-fk2SnpKTkd4ztU
37ZEfahONKSUeTsNnmYxqTlhsL_r5tBkang7RBM8LJ-88sqSgp5-G90ywOa0i5bZx
1cGU4KAcNDbFn9e1hIf3SAj73MlPkzaQpvJspZoaILBv7yvFAtRSaEbL3Dol3frqH
4B-5xtn3gkl8VBF3-x09RQwcDybDYJ8yUg8LGaDsijPRBT5x8TmAUkjxPm4mqjww4
AIFgymvkNfGFvyilKvWFugj0FGaFPcaT5VbyAXgo7pNblCeouLVhThf2ARQcfg2yv
PuFJGsM3gbOJl8lFn-mjZ0kL8VUiO2CPwTuAfxM9Y8N1flOR_xJN3l0fiFjIH2HWa
HOIxLHbNopV2gOrp3BDHVi-fXZoDuiG694EwJJurMhDNGtS6JU0ypel_rGQH4JKHh
tCfSiDjuJQEwHMjXH2NrH8xDTDl1r0t9170s7PT3cUwrghDJKGUem8G7DDCjgQ1Pl
StBeQg46Wo3WyfXRaMR_rM6FPYOW2-H8NcTMIe9P3ywV04ATIO2n3Y34VSyeduatY
NmgvoQbCN6KaoUBbuZ7dEJHDDesiz0OWOfAjpZGSMdU17s-wO9k6alxWa3bQ6gk3j
25v7crlBlRcpCJjA7xm1ZPO_qcdeCxhj657KSCEu3Wt783I6UOnAhuPzsTGNroMWf
TXMIr_UNf27I32UemfyHqb2kshNVen-AmiJCv1HN5s2bPDzju_eIQxxwcORxG_fju
ftjgzBgNPNJ8G_wgh_ICf3vl7kDjlpYXaJHxG3kEhGv8lTkigRLvMZEwn5NUCQha9
p7gpigfdrgfLu5Fs5aii4v6tTeeAxQLOIgfpIiNtpjauiO8KTxzUTlGzlqJr52YsP
-JNqKRw0FEj8j1wAsuI_X_CGgQmLdoZIYlbEJHdC1AiN6LtUZsZ_2FxyEpm2tSVNR
-7F13ydDMSQBf42Bn5tuKNL712rZ86i0BptZEZjxdFN8YeZ60G4jiNVoH6z9D5VRw
XggwUkIkjf8ttz5k2gzxeod2i-1Pg6-hylNCvC3h7PucUtOMYC0vlPH4dDaTcDWb8
5hLXj9FkicrGR1gMEZbbBX1jEMRUzJRdntCoGSFWSMM03Zq4AbTA7l8Au9ZyVpbx6
sFrEjFg0ZLpEZB0Jy-u4hcOlo3G1XJg1aHjzEgWV7OSjd8KI9oOjxsdLWlmle9GYF
btW3cpSCZnS-d-l9qdDtmD_f5r0ugf277giaFLCHLprSyeWpAwSJ0g1cLtrDaucHk
qhdSgO9pYPRvYzG9LXQXr-chqwc16jvlqy3x25ASLBJMYMWtD0M4P6kKBWXUKgABr
-dBIpibcucquDXBrhwzssy5XeI2bwQ_lD3sjwcYJzw6OXlairH8Ygl9QczCj3HApO
z8BtrWllHy3QNh2Tukr3QhXEWebnBv44HXxvqRuT2xbdJ3T5h0iHES-wApOq2RU2V
EIF06I0dKP2Jb2AwfjW70bbZoQNWpWLF-vn1hjkDRxgstjLu0ChOWhJ__zz8JGZx0
DTX1DDHiZuj6PFW4jN8v1E1-K8Sqya93iTR__0K8LSSMFe9pOA8cQcKtuMDeUD_6j
wQBurbjuob1YTPfGvTwzUApfIPTi6ysKmRdjfSOhcea8-WMbBZsPOgkCg2GliOcqg
bf0fAyIh20I2iuQuS7wyUXqNlvrZLKueSpT_yIfdbBBlcEIVF-L7qqfQniv2XL3i-
OFARCsCnKIuVVmcMRbRV-TwlrRIFiT49kjMczKcQk08hEA34eK3LwPU-zTewDseVs
WDdJmq2bkiha0E4jCZnudIkoFtqcIIlBhWkSUa4sMToeisvxyQddisC26T-2RwaO1
9OG8f0LPtb7cr4wW7MgaxrzhnpFTCwbaEjVZd5NszDZaRaL-fSv9oQcGXU9tzpLsb
lT7nAoDFx-XoZLNwbHx-Rr5_yQSHXoL-CMv8ZuGejYW37Klyn3LqPIBKwR69Gtmh9
J3k8l5N9O-hVe2BNYyCzBg93b_TEBc8P5hFN8o22XuW1gjV6qf9ZGZ3oBXCyuSJPZ
87khUCGf4DX_dEEcI1d6fStAZ9N8_8dlnqNr397VcAlIHk6l8CKaQuARhm02zX2Z9
Fm12Ey-Lc5Gdw4G3PybCebxV12m5S-NOR1744fhJ7j4It_U9jfOJlHOC03Vwr_t9_
IxzqrKxalB13fA8-esd_Q1TEdlkCyKKKwKGzFKjnrV2QXnAFdRsPlVN5AnNMygJUd
7-tjw8bluMAwDpe6_P4wXHV0UPrLXEc1vXAwT-q3VqyLzZ5-48EQuJ_jXBTnohJ2r
ud6wd_UpM_hmLAQftUOvR_7x155jSp7s9Xv9dJNpMOU4UK0Hbho6kUtH0D2_-EnY5
_ykaEsJFs68pSJACOXdxJvzgJPlqTVcxcU-rbecDNwkqgnuwn3_pxkf87zfYNI8Ns
x9QXRNiG-d-_OXXJPOGBN2TnqpAvxye2zR8mYiD8IcBYzADcNcci8diPeZ7PNGDP8
tntkxMZoLNJ_BMIZIoOUpDE6C6E7KRC2knGPYnRsj0kYORlcrStc1DpquQnjGUCC7
S7jQ4SjR-aRqjXqTVciiuTc5QJkSI1U41Ge6NZ3UaI_uEfPjAfT64zFdi0QCFytN-
kX9rfXPM4CbnUoIzoqJmR7g47u4ATOpeh3yiCGZLkm85WHcfYNW1ZRiG3kT6LAO2C
-QvFcHx0ssZ40U91CKCB3bc7y8PoWqlCyeE5cz2r100ZqOC-mB2dNJZIPqyRrBXib
2h_ml5Svobblh6Bd4lhc1pe7_Lo1wX-Hi2ogDBkeK7tL7oU0oZe_whIb-RvPni_HI
HdEaFJBZPa-L_OPzIdrEy_vXbFsFDPms25ZuaAcITse_snP7FZ4p3mgHd2atiJxbH
KZWVxtHn2zoBVKIUt98_KPJ0ehyFtg41kay75PT0vYPF3wYPrNgRJG4pnxZOg4rFh
pCBviOPj_vMOPCMLhtdGX0figHE1Q68ORV3XBer1jKfwHnzYb-n5R-vILa8WT7tRj
ZKwwxfOPEA5ByW_Ze6tKXYowUnwsCF_GVyLlp6RuLP8PMvKHSDOrvQuxDr3LBr6V2
q0oFa5EEqsCN6DSOpTFcf9rfGAW09xBYlDPOIgtMGvjiFWAi93LB_9lTDTzgBo1vw
mnWw8QE08wvyUYR8hAodmsksXVMxmIIdqE4E6jQ-I91p5-70boidkv9T5JY9OoKD_
GjuwTahlI48k3aaCddL9JllBbAaJW4G3iHfDNWjCKlInyfXke8D1E1qPSB7ksvNzq
YdPrnYSeT0GOB3YuBGJfpKNFJQvHcmutdpODnWtaS6OQBGEf6SETfC_Zp8Gbvu_P2
NEG6AcWqAowLbDfS4vUBjYMpdwqqh0lTF04PDjsDSalNuO-6oEJnEO4vAUC2TjB1T
O4cxx0Sk7N2-Z84O_meG10rqSFpcm5JJIIEJZjZZLu-HLGsJmpSMsL6rw1oJApQ8e
4PTJSL0EZMaG76_xcG9EMaOYJ1byJQwNL-cGy-AyydrwVQ2BEamqhIJAe8flxUgcp
dEra1dOfcT9WuFs5DK8YL1Be4oxBXARGNQYhLUbbHjXRoPZYUz2k2hv73vKHqH6pA
LPX1aV99sfZE6KeCLrlPtmbQtqb434yD1_NQjtmixWrjD_L6P-X6ZBvIsMIuXWezu
9vyMrBVbpLox5pRVBmpEXrrjQsqXprjfYgIBiILayOi6U7YiTF_EvFtHJSo8F5XcL
goOdcJBhmGN-BfETp9XrL0ktyWJlMEcvBVYouzmmklfRceo7TPKuNaXJeFBwZb-kd
wxzq4_eaQiSowddgqc-BuUwO_FzRQEH9RgrgLwR8_xLjVkXqjM6HkkM8CWMF26ko1
Mkp5LF7ena1c-0RPrTOqbN4eP-r1L9YIVBx-ndxvgd0RCaK--1PieTyeNIIFin6bW
jpHAA9jxPsQDWfnUYUQZXJ8rdhUA79YJSJr88iUHwVGfyhsZF_MCUgm5SsjOCNB8H
h09E3S16dilnqMtHfOn4PwFm_ba7udopyFhIT10lrLUQLXOLuXTxR04LQXaGxW8y8
gc443ntCD8WpofT9Cs2I1cFBzovyi8Qo-i5q-D1OStpROihfRgRdU3rbNCTkz7Kmk
iYJJEjDIzdnnnX2",
{}
],
"Status":201,
"StatusDescription":"Operation completed successfully"}}¶
[Future: Consider eliminating this mechanism entirely and instead using messaging flows. The means of achieving this should become better apparent when the problem of publishing large messages via a pull mechanism is considered.]¶
The Publication mechanism allows content to be published through a Mesh Account and retrieved by means of the EARL mechanism described in Uniform Data Fingerprint [draft-hallambaker-mesh-udf]. This mechanism is used in certain flows supported by the Mesh Device Connection and Contact Exchange functions. There are two operations:¶
Content is published by appending an entry to an account's Publication catalog by means of a Transact operation. The content may then be retrieved by issuing a claim to the account specifying the publication identifier that is authenticated under the value specified in the EARL.¶
Use of the Publication catalog to post content necessarily requires that the content be smaller than the maximum message size imposed by the Mesh Service so that it can be uploaded to the service by means of a Transact transaction.¶
Publication of large data items will require modification of the protocol to support use of a detached message body. Transfer of a detached message body is outside the scope of this document.¶
The claim transaction is used to post a claim to a document published by means of an EARL. The claim interaction is used in the Static QR Code connection interaction but MAY be used for other purposes as required by Mesh applications.¶
A claim is made by sending a ClaimRequest message to the service to which the publication is posted. The service responds with a ClaimRespose message specifying the success or failure of the claim.¶
A device is preconfigured during manufacture and a Device Description published to the EARL:¶
The client claiming the publication creates a claim message specifying the resource being claimed and the address of the Mesh account making the claim.¶
{
"MessageClaim":{
"PublicationId":"EBQM-KNOL-3JSA-7ODT-IDYR-4MIF-T372",
"ServiceAuthenticate":"ADB6-LL6S-CFGJ-WEGN-ATQH-BIWP-C275",
"DeviceAuthenticate":"AD5I-TWGR-5JLW-PYMH-6PQC-LVMO-MMBV",
"MessageId":"NDMW-S56B-O3D3-NAK6-SKHF-3KHR-UCD7",
"Sender":"alice@example.com",
"Recipient":"maker@example.com"}}¶
The message is signed by the claimant to make a RequestClaim to the service:¶
{
"ClaimRequest":{
"EnvelopedMessageClaim":[{
"EnvelopeId":"MAF6-JDZZ-VLXA-HV3Z-333W-OUS6-MKRG",
"dig":"S512",
"ContentMetaData":"ewogICJVbmlxdWVJZCI6ICJORE1XLVM1NkItTz
NEMy1OQUs2LVNLSEYtM0tIUi1VQ0Q3IiwKICAiTWVzc2FnZVR5cGUiOiAiTWVzc2F
nZUNsYWltIiwKICAiY3R5IjogImFwcGxpY2F0aW9uL21tbS9vYmplY3QiLAogICJD
cmVhdGVkIjogIjIwMjItMTAtMThUMTI6NDg6MThaIn0"},
"ewogICJNZXNzYWdlQ2xhaW0iOiB7CiAgICAiUHVibGljYXRpb25JZCI6IC
JFQlFNLUtOT0wtM0pTQS03T0RULUlEWVItNE1JRi1UMzcyIiwKICAgICJTZXJ2aWN
lQXV0aGVudGljYXRlIjogIkFEQjYtTEw2Uy1DRkdKLVdFR04tQVRRSC1CSVdQLUMy
NzUiLAogICAgIkRldmljZUF1dGhlbnRpY2F0ZSI6ICJBRDVJLVRXR1ItNUpMVy1QW
U1ILTZQUUMtTFZNTy1NTUJWIiwKICAgICJNZXNzYWdlSWQiOiAiTkRNVy1TNTZCLU
8zRDMtTkFLNi1TS0hGLTNLSFItVUNENyIsCiAgICAiU2VuZGVyIjogImFsaWNlQGV
4YW1wbGUuY29tIiwKICAgICJSZWNpcGllbnQiOiAibWFrZXJAZXhhbXBsZS5jb20i
fX0",
{
"signatures":[{
"alg":"S512",
"kid":"MCDG-TS7T-UPDD-V667-OXSX-QJ5G-FQRZ",
"signature":"AZPN7yQXHU7HGacLw1ggJW_huQ2Kx6JDuBhnraAA
U7b-PFHBMqcLEExjp7uvP_wJRdOHx9vVZJuAvu9qpnOoH2uJpE7i-LHsonlgTSZH9
_RqqOKXNzQvHhj81K3LecFAFige_yHZXP4aFpLDMVldLh8A"}
],
"PayloadDigest":"UzMKbHTyfoSBf2pi03m-mgLhgFwb6e0qyYFYdV--
MO5icQ_AxmcJCvoHT698416SI4qvEz749uiE1ZnNf8-AZQ"}
]}}¶
The publication is found and the claim is accepted, the publication is returned in the response.¶
{
"ClaimResponse":{
"CatalogedPublication":{
"Id":"EBQM-KNOL-3JSA-7ODT-IDYR-4MIF-T372",
"Authenticator":"EDXZ-IUXU-GCCB-5UD6-CVI6-P2VM-DJJ2-KFOR-2MZF
-KBFT-KJ2T-VLSZ-5UAC-O",
"EnvelopedData":[{
"enc":"A256CBC",
"kid":"EBQO-CDBL-LUJ2-Z6BX-KZPG-MUHN-Y33K",
"Salt":"kHA8EsOojCTci4giaqmN1Q",
"recipients":[{
"kid":"EBQM-KNOL-3JSA-7ODT-IDYR-4MIF-T372",
"wmk":"ILbNKbCEfU5mY7AAOVa5YnsDmsDqwt1B8XcvuNJk9eNE
4883axJMqg"}
]},
"qUY6yGZc7Oka15XfdCEdUhms-ldQJV5j6lIIX5NDNV_JPSWhMYwfwtVR
MRl3tO89xo6-8Fi5YjMlv9IkTWckXnCojOTa7CsL_bR_mgTcV0n2HTWFTFqmavqrn
mb9eP_EbPXMva1r1oGay9dpC2QGWNKqCeiiA6dNA8JE4NqLwfU85VdmD-E8dDB3a-
1BRFgvQ9TMO2SxwYnhcQSv3o-JvhePufvHpG6Mdlhrarx7I-XprBnmtVtYGe85pQa
4mSVGj4Ziqq-c-okgM2imjgJBnDyMQwhNY3D_40FAtBR8cPDDBLG5BmLXO0clrLxJ
_CNr1efRVu0Qh8J9s3PNx89FUeWcMvj-XyVYcjBxcnaFHfUYJlmSGzGy7WDQ7gAxz
TE5SUrc88D2mtVEcLDUg296Mn2GlzeXgEsWWl18p_Zbk71Bd6So3qfBnGMYbOtMiS
4V9bibdrWqwaYOUWW3Vqkt6zS2_6dFTaffb-8rZLz-AuHw3cTdIYkoqPm7iOXvvf7
haAj9Y57mRx8H-rNoORn8L5dxqy8CE_22ZKHXWqMTGJr6KQpZRXRlBpXkUg-ctcHO
NgjtkEQMDHvrRQScP5NCiRhjfNt2d1TWwYzeasTc1-EyFHPc_ieCiI7hpAxLToER0
B8Q47aj2jRaea01V9mRQiolZXgYWijWHmotU5RPPAbfvrkbp_GiYpFV6Azi409TUB
QgqCjCXjYP3VmJp1_2oxQB5C5Scz_LSeL8z9dgPFbE8l1ZSTEb_fh7KRjpqtTT-UI
49OXxg2nvSedeBAluTKXZJS-9YodmjQWy9jtqUcFy_cMy9h7SxUx5SHVkM4b0-6GX
8f-O5H4TmFu_QLLclti8kHpy-hcaaX3E9mJQdApfqVzHvbQnxWCaj3xRLqjo15ZqW
m8qV0UVSYs0iue_zAjB88NS4nmnqswMjz6UVqVVCvg3Y2q6ZKejY-qxEwvMq9DZtk
JXp-x8sP1fa7XdsCuHMuUEGRKj03pzw8fbFiinFp4T31G8V4N8CoTpMepUBok3M3l
UJs27N6IqiJ023IPdz0NNf64BRXC4s3X3vIe2Tk6pT98Cu04G1oIgkftq3rSEnDgy
STPitQm66PGyD-dtfkjB9fvVe9fuSMSjn9db8WuidkfZFlxRZLlat_0cdAdy0c7my
4-Hn_wMIAvK8m_WQ9DLbwNhupkJWAtYiKLXiFzCAQX-35xr6VaUNDi3pRUBC8wcaU
Xx8OohhftOZC0eMIRLGLiymvdBggClCz0an5a-OQezNBWLTNwGhC0IkgQHfBO5CII
QBMQiHSiXeslVyoiERBJY8MvRGAg28lmj0FOzfyE8SeDNI9wKwREgRWH5oS4qeoCt
Ls_fY8XMPQpjJyvpF5Ki2meoIfPAseAzimuomyFksbC00ZAxfUInjrk_12ejTW2Vq
-mE-MrCE4ND1HifcODNTAKUHWQY-zO0tt4iXfI7oLcfJHA0WPocZ14i-2VZfyD_O1
79kbAic2S5JNhmReSsHI_EzYYz3TwrQfbMsEDtu90KF8BlMa0QOJvY1hnvCnmNWnJ
oPp5ZX8jJx-EYBxdhpQM2K5LmT7P-7VjQGY-1OmJ0NORnjqXtzJljgrX0B2HgzZqH
Z0lU4vuqcO0okE2-PlyjZJvsbzOvbs6WnL5XLFpMKooJkIk-TlSh51SNkDEft5WpK
kN-ToGyPOdDWRbaclHtks7HejZTUab6axL27Rqq8X2k1DJrKYz68JS18WOSujKtZ8
culepBu-MR9tLi4nu1x9WE1vScAkzJTdh4r7lYt4QW7I9tSVEqGBiRs5xAhWcwA9T
-PPq_9KhV6XMHoWiO3PWPO7-_P36qlskDiGgPRQiydUPiumxcJkY8SMnOKZhM-nSX
ccZzNmD8QzQiZYHKYUl1zVYYDa0fl8U_9RIKyf8SSF12JjElr_CGrHVfsMSbh6LYF
fY5DkeWq-Y57fkuNY9nIznzChShMzACZ0Sl79nCMLpnyJFzs28CGncmZBM56E2UNT
nfBBk1dOo0-a_LvOPIh8GaHe29thDDO1lB23afKTbHvpI9Av5fk_t3vzEYq-PNbaI
lE9-ANHZcDMhr24yX3QkwpQdMR5L1onozE8z9R25AvxRxiabXzK8qXNtTKcQLl3UG
oD4lElYBsY31uj_V2ILJNcOZkexZW3V8qGdJoRM4yt4x9C4QA0BUPMhB_I5BJl3Mc
8GKrJe-ucmsFlVQMTkFg_up7WmcDwS1PwBAu5DBTpsX9mzsKUYAKP2FCG25DDvN6l
QPmcb5o-xEgSMku38JEXm_aSWpUlEad2dnFfHmKB1epJGYerhWCxJci8DC2kLbkIX
ZYOqWltHnGupUYhHAP9J6jKTbxpG0u_eU7qF_rHZeiq5bR01F8ajLBkQQjwYj91ql
Ua6oIeWzOoHZXraQnVMJ53f-xhR0HSdvNkNYFjaTkanshD0bIC01vNVOcDD_M8BZJ
Jw4I7nZR49DouwytKs80Wdi55Vn1s7fAqodpIRNsjpzQQnONGUA9FV2Zhd6hMaoVU
rjneak4ps1Rk_WgTbfHYpcDPK4StI3PQ67doNAbAkFH6KMvhZX386MtngfoPOaYM5
EytpXC1Z9OT_Y3eE0fgTdbDbQZGQUHd7Sy9VmBqsyPwi2qM2UrZsT50_eO6KcZDIY
N51jP7zXbF7t3y9-tnwIfF9lhDBRHonPyt4bZSiYI4TUNnES5MbBgJna7Lc7UPFye
jGi8hbcaxwGN1D2wZ_k7CImFbtHraYRwuX37PRaAWYqHGte7R5wNUXoDPE_4BuCNx
9S4obV5pwsPwEZU8tqHyPJsFVXw_M23yRzRsuRZ3zNKyT91AnjApgYOnm5drQdPdX
cgkhl2oueebm3JEvP1W7v6C2JoxzjCwUr6XmVHqgYMVuPV1Jnw8X1B3f-ZGAQNAwe
fGY1Os-LxDkw7kS596yvbIuZLIg56iFZqv0AKhIf1TUJ0npuxALK1YvhpOeVToCan
XLTFV3lArI85NFuzQUCwwBe3LyD6q2SvTsX89TV6S3Qc_Hy8A"
]},
"Status":201,
"StatusDescription":"Operation completed successfully"}}¶
The device waiting to be connected uses the PollClaim transaction to receive notification of a claim having been posted.¶
The PollClaim transaction is used to discover if a claim has been posted to a published document.¶
When an authenticated, authorized request is made, the service responds with the latest claim posted to the publication.¶
The device in the example above periodically polls the service to which the device description is published to find if a claim has been registered.¶
The PollClaimRequest contains the account to which the document is published and the publication ID:¶
{
"PollClaimRequest":{
"PublicationId":"EBQM-KNOL-3JSA-7ODT-IDYR-4MIF-T372",
"TargetAccountAddress":"maker@example.com"}}¶
The response returns the latest claim made as signed message:¶
{
"PollClaimResponse":{
"EnvelopedMessage":[{
"EnvelopeId":"MBRA-UGUV-W5GN-5VFJ-MVZH-MMG3-VSIE",
"dig":"S512",
"ContentMetaData":"ewogICJVbmlxdWVJZCI6ICJORE1XLVM1NkItTz
NEMy1OQUs2LVNLSEYtM0tIUi1VQ0Q3IiwKICAiTWVzc2FnZVR5cGUiOiAiTWVzc2F
nZUNsYWltIiwKICAiY3R5IjogImFwcGxpY2F0aW9uL21tbS9vYmplY3QiLAogICJD
cmVhdGVkIjogIjIwMjItMTAtMThUMTI6NDg6MThaIn0",
"SequenceInfo":{
"Index":1,
"TreePosition":0},
"Received":"2022-10-18T12:48:18Z",
"signatures":[{
"alg":"S512",
"kid":"MCDG-TS7T-UPDD-V667-OXSX-QJ5G-FQRZ",
"signature":"AZPN7yQXHU7HGacLw1ggJW_huQ2Kx6JDuBhnraAA
U7b-PFHBMqcLEExjp7uvP_wJRdOHx9vVZJuAvu9qpnOoH2uJpE7i-LHsonlgTSZH9
_RqqOKXNzQvHhj81K3LecFAFige_yHZXP4aFpLDMVldLh8A"}
],
"PayloadDigest":"UzMKbHTyfoSBf2pi03m-mgLhgFwb6e0qyYFYdV--
MO5icQ_AxmcJCvoHT698416SI4qvEz749uiE1ZnNf8-AZQ"},
"ewogICJNZXNzYWdlQ2xhaW0iOiB7CiAgICAiUHVibGljYXRpb25JZCI6IC
JFQlFNLUtOT0wtM0pTQS03T0RULUlEWVItNE1JRi1UMzcyIiwKICAgICJTZXJ2aWN
lQXV0aGVudGljYXRlIjogIkFEQjYtTEw2Uy1DRkdKLVdFR04tQVRRSC1CSVdQLUMy
NzUiLAogICAgIkRldmljZUF1dGhlbnRpY2F0ZSI6ICJBRDVJLVRXR1ItNUpMVy1QW
U1ILTZQUUMtTFZNTy1NTUJWIiwKICAgICJNZXNzYWdlSWQiOiAiTkRNVy1TNTZCLU
8zRDMtTkFLNi1TS0hGLTNLSFItVUNENyIsCiAgICAiU2VuZGVyIjogImFsaWNlQGV
4YW1wbGUuY29tIiwKICAgICJSZWNpcGllbnQiOiAibWFrZXJAZXhhbXBsZS5jb20i
fX0",
{}
],
"Status":201,
"StatusDescription":"Operation completed successfully"}}¶
The Operate transaction is used to perform one or more cryptographic operations using private key material recorded in the Threshold Catalog. Such operations typically represent one part of a threshold key operation divided between the service and a device connected to an account.¶
As with all operations involving the Access catalog, the request MUST meet the authentication criteria specified by the catalog entry. These typically include the request being authenticated by a specific key.Key Agreement¶
CryptographicOperationKeyAgreement is used to request a threshold key agreement operation on a specified public key.¶
Alice added Bob to groupw@example.com as a member. This resulted in Bob receiving the invitation described in section ??? and the following access entry being added to the Access catalog of the group account:¶
{
"CatalogedAccess":{
"Capability":{
"CapabilityDecryptServiced":{
"GranteeUdf":"bob@example.com",
"EnvelopedKeyShare":[{
"enc":"A256CBC",
"kid":"EBQP-6DRQ-2TLC-BCIO-IEN4-XYON-7TOK",
"Salt":"cLEpWYfA_14wpQzGEwwMZA",
"recipients":[{
"kid":"MA6Q-4KLG-YT7L-YV2N-DS4T-HP2G-Z3H6",
"epk":{
"PublicKeyECDH":{
"crv":"X448",
"Public":"xJQBqymZRqaMGdbcqipO728xaVACSIm7-o4
GQx7uFL2CR8ogbRsh1XLOPU9gwaSP0nO9X6yzx0QA"}},
"wmk":"RxqG7EcQH1eQXzCvug-DnqTxz4V6-7P0HeHZx6PMxN
jzarvLHmT5Ng"}
],
"ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJLZXlEYX
RhIiwKICAiY3R5IjogImFwcGxpY2F0aW9uL21tbS9vYmplY3QiLAogICJDcmVhdGV
kIjogIjIwMjItMTAtMThUMTI6NDQ6MzRaIn0"},
"m8W7c9a-Bw8Dcrh5P15KNYNw5SgeIaeYYYnih1aBwhc3mfZsWGcvdp
I_BPCxHWJ_-3wsDc00htKUDDFUnQb9jppJuG5VBehH80iJX1vPqoQ2tK7xuIYvJEH
u0sVlAxAjmTqSewnGFa8h9ndO7uR_MkuoUCRo0_WplxE2x7LqwwqJR0auZfdxrj9c
-0yTmjmD7UoVVQfqw8Fmie64gNDqsknZcxGBeZvaqOCMw9boyojzq0P62nFUhRVl4
OSyzXiUQd69vuz1Z4eOXqZXCZTcHDxBCd9uh-lDJqh68MwHb8ONuWNjysIvWylC7r
fFICGzkO99QRGfErXtlwPG6Ir5aSK13Wlen7h9wRlE_kkh_hVlvBUw63WOQs9XQ1Z
k_8_IuRQ3zn82d8_8nLGU8_OTVF1FrTdIy1zlKjkbUm6mm7WKu-zIvt4vS-lX7NE0
olGotZU7IcXOCdlMy8DvRpcGcKXnj6yLqgQnW7eAW6AsnXi_vpLkXMaHi3eVhliWk
dkGF3n60yQNHlDrFTUSP1S-fSGPHB4ot3muzVOKT5lx3ZjIMzm4ibS4WVtbuKlxxt
jtlRj09nqw1uC6EBo03G2Bt8FxXUk7eD7rOLOoufUDLHMFHHdAhLe4Ea541bP6p_L
JvDvUbTPg5Iq960uPCqJO3uSv8X5Urwi05H07D4zMQ9nnrJZWX0XTjyEURvsJtDt8
l2EPY332_0X211mQWynugw"
],
"Id":"MBVT-4N6Y-ARXQ-F3ZO-NEOS-EYNS-AG5N",
"Active":true}}}}¶
The private key (in this case a key share) is encrypted under the service key.¶
To make use of the access entry, a request is made that specifies the key share to be operated on and the public key parameters to perform the agreement with.¶
The request payload:¶
{
"OperateRequest":{
"AccountAddress":"groupw@example.com",
"Operations":[{
"CryptographicOperationKeyAgreement":{
"PublicKey":{
"PublicKeyECDH":{
"crv":"X448",
"Public":"z5zGNSPu0Rb5k9cYKwjBrJTZwBBnZACAKEeZqeH2u
YXB4kggHSUjEmhIDeztsvsJ8F2b2HsMSMeA"}},
"KeyId":"MBVT-4N6Y-ARXQ-F3ZO-NEOS-EYNS-AG5N"}}
]}}¶
The service checks to see if the request is authorized and if so, performs the operation and returns the result:¶
{
"OperateResponse":{
"Results":[{
"CryptographicResultKeyAgreement":{
"KeyAgreement":{
"KeyAgreementECDH":{
"Curve":"X448",
"Result":"YqgJtmNNDS0becbHYSKYxcLvwpIXkPitWyHyPERQM
9aV_8zoWAjE7Evqv6isn_hfAoKswajzTJoA"}}}}
],
"Status":201,
"StatusDescription":"Operation completed successfully"}}¶
Future: Currently, the access catalog is encrypted under the service encryption key. It would be better to encrypt the catalog under an encryption key specified by the service during the process of account binding. This would allow a service to assign a unique encryption key to each account and limit access to that key to the hosts servicing that specific account.¶
Threshold signature is planned but not currently supported.¶
Mesh Messaging is an asynchronous messaging service that allows exchange of information between devices connected to a Mesh account and between Mesh users.¶
To enable effective abuse mitigation, Mesh Messaging enforces a four-corner communication model in which all outbound and inbound messages pass through a Mesh Service which accredits and authorizes the messages on the user's behalf.¶
The Post transaction is only used to exchange messages between services. The client sends and receives messages through interactions with the outbound and inbound spools of the account.¶
To send a message, the client creates the Mesh Message structure, encapsulates it in a DARE Message and appends the message to the Outbound spool of the account using the Transact operation..¶
The DARE Message MUST be signed under the account signature key.¶
The Mesh Service receiving the message from the user's device MAY attempt immediate retransmission or queue it to be sent at a future time. Mesh Services SHOULD forward messages without undue delay.¶
The Post transaction forwarding the message to the destination service carries the same payload as the original request but is authenticated by the service forwarding it. This authentication MAY be my means of either profile or ticket authentication.¶
>>>> Unfinished ProtocolPostServiceService¶
[Not Yet Implemented]¶
After the message has been sent, the service updates the message status on the outbound spool.¶
Services SHOULD implement Denial of Service mitigation strategies including limiting the maximum time taken to complete a transaction and refusing connections from clients that engage in patterns of behavior consistent with abuse.¶
The limitation in message size allows Mesh Services to aggressively time out connections that take too long to complete a transaction. A Mesh Service that hosted on a 10Mb/s link should be able to transfer 20 messages a second. If the service is taking more than 5 seconds to complete a transaction, either the source or the destination service is overloaded or the message itself is an attack.¶
Imposing hard constraints on Mesh Service performance requires deployments to scale and apply resources appropriately. If a service is attempting to transfer 100 messages simultaneously and 40% are taking 4 seconds or more, this indicates that the number of simultaneous transfers being attempted should be reduced. Contrawise, if 90% are completed in less than a second, the number of threads allocated to sending outbound messages might be increased.¶
The inbound service MUST subject inbound messages to Access Control according to the credentials presented in the DARE Message payload.¶
After verifying the signature and checking that the key is properly accredited in accordance with site policy, the service applies authorization controls taking account of:¶
[This section to be expanded in future drafts]¶
Access control is effected through the usual division of authentication and authorization.¶
Authentication of operation requests is performed by the RUD layer [draft-hallambaker-mesh-rud] .¶
If the authentication key presented has a matching Access Catalog entry, the device is authorized to perform operations as specified in that entry.¶
Message interactions are asynchronous interactions that occur between devices connected to the same account or between accounts.¶
All messages are signed by the sender and encrypted under the encryption key of the recipient if this is known to the sender.¶
The Message PIN Interaction is used to register and validate PIN codes used to authenticate certain transactions. This interaction allows a PIN code issued by one device to be consumed by another allowing for greater convenience in managing devices or contact exchange.¶
For example, Alice might delegate the PIN code issue privilege to her mobile device without delegating the administration privilege to that device. This would allow Alice to use her mobile device to initiate the connection of a large number of devices to her Mesh as her house is being built and approve them later using her administrative device.¶
Use of the Message PIN interaction is optional. An application that issues a PIN code to authenticate a message MAY store the PIN value within the application without persisting it to external storage.¶
Derivation of the SaltedPin, MessageId and Witness values from their respective inputs is described in the Schema Reference [draft-hallambaker-mesh-schema].¶
To register a PIN code to an Account, a device:¶
PIN code value¶
SaltedPin value for the specified Action¶
PinId binding the specified SaltedPin to the Account.¶
MessagePin containing the SaltedPin , Action and Account values with the MessageId value PinId.¶
MessagePin value to the Administration Spool of the Account.¶
Note that this construction provides limited protection against forgery attacks by a party with access to the MessagePin. A party with such access can use it to construct the witness value required to authenticate a request.¶
PIN Code values consist of an opaque sequence of octets represented as a UDF nonce value. Codes are presented in canonical UDF form, i.e. Base32 encoding separated into groups of 4 characters. The PIN value is converted to binary form for calculation of the SaltedPin, thus ensuring that the canonical form of the PIN value is used.¶
The PIN Code value is passed out of band to a user who will enter it into a device to authenticate a request made to the issuer.¶
A request that MAY be validated by means of a PIN is a subclass of MessagePinValidated and contains the following fields:¶
A DARE Envelope containing the data that is authenticated.¶
A nonce value used to prevent certain replay attacks.¶
Digest value binding the SaltedPin to the Account.¶
Witness value calculated as KDF (Device.UDF + AccountAddress, ClientNonce)¶
The device uses the PIN code and Action identifier corresponding to the desired request to calculate the SaltedPin value in the same manner as during registration. This value is then used to calculate the PinId and PinWitness values.¶
The PIN code is validated by performing the steps of:¶
SaltedPin value from the PIN code and Action¶
PinId from SaltedPin and Account¶
MessagePin from the Administration spool with the MessageId PinId.¶
PinWitness value from SaltedPin, ClientNonce and AuthenticatedData and checking this matches the value specified in the message.¶
Complete message to the Administration Spool of the Account marking the PIN code as used.¶
This process can fail at multiple points resulting in different error results:¶
PinInvalidNo PIN code is specified, the Pin code indicates an unsupported algorithm or the calculated PinWitness does not match the one specified by the request.¶
PinUsedThe PIN code has been used previously.¶
PinExpiredThe PIN code is no longer valid.¶
Note that in the case that an attempt is made to reuse a PIN, it is not automatically the case that the first use of the PIN was the one that was valid and only the second attempt was invalid. Implementations SHOULD alert the user to the attempted re-use so that this possibility can be considered and appropriate action taken.¶
Alice connects a device using a QR code presented by her administrative device.¶
The administration device creates a PIN code and records it to the Local spool. The message specifies the salted pin value used to verify attempts to use the PIN, the action for which it is authorized. Since this PIN has been issued to authorize a device connection, the roles for which the device are authorized as well. This allows the connection request to be accepted without asking for further input from the user.¶
{
"MessagePin":{
"Account":"alice@example.com",
"Expires":"2022-10-19T12:48:11Z",
"Automatic":true,
"SaltedPin":"ADGS-TMEV-G2MR-2NPD-ZJO3-NH2F-363W",
"Action":"Device",
"Roles":["threshold"
],
"MessageId":"ABFI-YEZB-HAEO-7LVM-E7VB-IWUC-YD3F"}}¶
Completion messages are dummy messages that are added to a Mesh Spool to mark a 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.¶
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 message will be removed if the sequence is subsequently purged.¶
After using the PIN code to authenticate connection of a device in the previous example, the corresponding MessagePin is marked as having been used by appending a completion message to the Local spool.¶
{
"MessageComplete":{
"References":[{
"MessageId":"ABFI-YEZB-HAEO-7LVM-E7VB-IWUC-YD3F",
"ResponseId":"MBI3-QJW4-3BIO-7SBZ-PEJP-E7NX-3W7E",
"Relationship":"Closed"}
],
"MessageId":"NCSO-MZMD-G2WJ-Z7NP-6ESO-X2GL-EXPP"}}¶
The completion message is added to the spool in the same upload transaction that adds the device to the device catalog. This ensures that both operations occur or neither occurs.¶
The contact exchange interaction is used to support unilateral or mutual exchange of contact information. Contact exchange has three functions in the Mesh:¶
Registration of the subject's contact information in a registry service eliminates the need for the first of these functions but not the other two. To prevent abuse, every Mesh Message is subject to access control and a Mesh service will only accept a message from a sender if there is an entry in the Threshold Catalog of the account that expressly permits delivery of messages of the specified type that are authenticated by an authorized signature key.¶
The communication of unsolicited information afforded by the contact exchange interaction is deliberately limited so that a majority of users can accept contact exchange requests without prior authorization. It is however likely that some users will receive a considerable volume of requests forcing them to require contact requests be authorized through some form of third party accreditation.¶
The Remote Contact Exchange transaction consists of a sequence of MessageContact messages sent from the initiator to the responder, responder to the initiator, etc. While there is in principle no limit on the number of messages exchanged, most exchanges will be completed in three exchanges or less:¶
Contains Initiator contact data without authentication context from the exchange.¶
Contains Responder contact data authenticated under a PIN challenge presented in the previous message.¶
Contains Initiator contact data authenticated under a PIN challenge presented in the previous message.¶
Each message provides the recipient with additional information which MAY motivate the recipient to provide additional contact information to the sender.¶
{
"MessageContact":{
"Reply":true,
"Subject":"alice@example.com",
"PIN":"ABMH-MBQP-GX34-A7AG-ZEOL-R4XO-VGYQ",
"AuthenticatedData":[{
"dig":"S512",
"ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJDb250YWN0UG
Vyc29uIiwKICAiY3R5IjogImFwcGxpY2F0aW9uL21tbS9vYmplY3QiLAogICJDcmV
hdGVkIjogIjIwMjItMTAtMThUMTI6NDM6NTdaIn0"},
"ewogICJDb250YWN0UGVyc29uIjogewogICAgIkFuY2hvcnMiOiBbewogIC
AgICAgICJVZGYiOiAiTURMUC1SUlpKLVpBU0ctR1VCWi1QUDJLLTVZREgtRU1HRSI
sCiAgICAgICAgIlZhbGlkYXRpb24iOiAiU2VsZiJ9XSwKICAgICJOZXR3b3JrQWRk
cmVzc2VzIjogW3sKICAgICAgICAiQWRkcmVzcyI6ICJib2JAZXhhbXBsZS5jb20iL
AogICAgICAgICJFbnZlbG9wZWRQcm9maWxlQWNjb3VudCI6IFt7CiAgICAgICAgIC
AgICJFbnZlbG9wZUlkIjogIk1ETFAtUlJaSi1aQVNHLUdVQlotUFAySy01WURILUV
NR0UiLAogICAgICAgICAgICAiZGlnIjogIlM1MTIiLAogICAgICAgICAgICAiQ29u
dGVudE1ldGFEYXRhIjogImV3b2dJQ0pWYm1seGRXVkpaQ0k2SUNKTlJFeFFMVkpTV
2tvdFdrRlRSeTEKICBIVlVKYUxWQlFNa3N0TlZsRVNDMUZUVWRGSWl3S0lDQWlUV1
Z6YzJGblpWUjVjR1VpT2lBaVVISnZabWxzWgogIFZWelpYSWlMQW9nSUNKamRIa2l
PaUFpWVhCd2JHbGpZWFJwYjI0dmJXMXRMMjlpYW1WamRDSXNDaUFnSWtOCiAgeVpX
RjBaV1FpT2lBaU1qQXlNaTB4TUMweE9GUXhNam8wTXpvMU4xb2lmUSJ9LAogICAgI
CAgICAgImV3b2dJQ0pRY205bWFXeGxWWE5sY2lJNklIc0tJQ0FnSUNKRGIyMXRiMj
UKICBUYVdkdVlYUjFjbVVpT2lCN0NpQWdJQ0FnSUNKVlpHWWlPaUFpVFVGSlZpMVl
RVXRDTFROSlJVd3RWMDlMUwogIHkxUFZ6ZENMVFJSVmtjdFJreElVQ0lzQ2lBZ0lD
QWdJQ0pRZFdKc2FXTlFZWEpoYldWMFpYSnpJam9nZXdvCiAgZ0lDQWdJQ0FnSUNKU
WRXSnNhV05MWlhsRlEwUklJam9nZXdvZ0lDQWdJQ0FnSUNBZ0ltTnlkaUk2SUNKRl
oKICBEUTBPQ0lzQ2lBZ0lDQWdJQ0FnSUNBaVVIVmliR2xqSWpvZ0lscHlTbFptUlU
xWGFIcGxOSFYwUlVkcFVrMQogIHRTM1p6VlZocGNHOU5ibmhFU0RaMlVHbERSVXBY
Y21vdGJWQlNOV1JZZDBjS0lDQnRWRzFrUWtnM1JDMTJPCiAgWGhLV0VScE5EbGZab
FZVY1VFaWZYMTlMQW9nSUNBZ0lrRmpZMjkxYm5SQlpHUnlaWE56SWpvZ0ltSnZZa0
IKICBsZUdGdGNHeGxMbU52YlNJc0NpQWdJQ0FpVTJWeWRtbGpaVlZrWmlJNklDSk5
RbGxJTFVKS00wa3RSVlZYVAogIEMwM1VVRkpMVTVIU1VVdFZGQkROaTFZTkV0Vklp
d0tJQ0FnSUNKRmMyTnliM2RGYm1OeWVYQjBhVzl1SWpvCiAgZ2V3b2dJQ0FnSUNBa
VZXUm1Jam9nSWsxRVZUWXRSRnBXVmkxRVFVazFMVlJaVlRRdFJGaENOQzAxTlV0TE
wKICBWbE1XbElpTEFvZ0lDQWdJQ0FpVUhWaWJHbGpVR0Z5WVcxbGRHVnljeUk2SUh
zS0lDQWdJQ0FnSUNBaVVIVgogIGliR2xqUzJWNVJVTkVTQ0k2SUhzS0lDQWdJQ0Fn
SUNBZ0lDSmpjbllpT2lBaVdEUTBPQ0lzQ2lBZ0lDQWdJCiAgQ0FnSUNBaVVIVmliR
2xqSWpvZ0lrbDZha3QwYVY5aWRXdDZhbkY0Y1VkcVNXWmtSM1JCVERCbVVYVlNibE
IKICBhVEV0UU1XMU9NRGRhUzBod2MwUlNUWFpxTVRZS0lDQTFlVlpLYVRaUE5HMXN
kVlZSYm1sWUxVRjViM1Z3WgogIFVFaWZYMTlMQW9nSUNBZ0lrRmtiV2x1YVhOMGNt
RjBiM0pUYVdkdVlYUjFjbVVpT2lCN0NpQWdJQ0FnSUNKCiAgVlpHWWlPaUFpVFVGT
1J5MVhXVEpFTFZZM1RGY3RUbEJFVFMxS1ZFMU5MVUpNVTFZdFUwdEdWU0lzQ2lBZ0
kKICBDQWdJQ0pRZFdKc2FXTlFZWEpoYldWMFpYSnpJam9nZXdvZ0lDQWdJQ0FnSUN
KUWRXSnNhV05MWlhsRlEwUgogIElJam9nZXdvZ0lDQWdJQ0FnSUNBZ0ltTnlkaUk2
SUNKRlpEUTBPQ0lzQ2lBZ0lDQWdJQ0FnSUNBaVVIVmliCiAgR2xqSWpvZ0ltVk1Nb
FpVY1V4dFVrOXpUR2RSUVRSUE5qSjZaVFp2VWtab1ZEZDRRVTVOWldsNGMzUkZkMH
gKICBoVUZBMFVETnRMV2xCTFVrS0lDQmZiM0pNUjNGaFprTjRVVWR0VERkWk1GWmt
WV3BKTWtFaWZYMTlMQW9nSQogIENBZ0lrTnZiVzF2YmtWdVkzSjVjSFJwYjI0aU9p
QjdDaUFnSUNBZ0lDSlZaR1lpT2lBaVRVSkZSUzFJVUZoCiAgTkxVVTNTek10VVROR
k55MVlXazFhTFZaUlFWRXROa1ZKU2lJc0NpQWdJQ0FnSUNKUWRXSnNhV05RWVhKaG
IKICBXVjBaWEp6SWpvZ2V3b2dJQ0FnSUNBZ0lDSlFkV0pzYVdOTFpYbEZRMFJJSWp
vZ2V3b2dJQ0FnSUNBZ0lDQQogIGdJbU55ZGlJNklDSllORFE0SWl3S0lDQWdJQ0Fn
SUNBZ0lDSlFkV0pzYVdNaU9pQWlSMUExTWpKMFdYZE5aCiAgMVpCYWtOQlEydEZkV
UpWVFRsNGQySkRZalpOTTBsb1JEZHdaRE5MVERaNWIyWnphelpaUmxSbE13b2dJSG
QKICBuZWs1WllucHRWWEpwUldsMVJXOXhNRlpsT0hScFFTSjlmWDBzQ2lBZ0lDQWl
RMjl0Ylc5dVFYVjBhR1Z1ZAogIEdsallYUnBiMjRpT2lCN0NpQWdJQ0FnSUNKVlpH
WWlPaUFpVFVGS015MHlWRXRITFZCYVEwSXRVVWxIVEMwCiAgelFVbElMVmxTTWxZd
FdqWkdUeUlzQ2lBZ0lDQWdJQ0pRZFdKc2FXTlFZWEpoYldWMFpYSnpJam9nZXdvZ0
kKICBDQWdJQ0FnSUNKUWRXSnNhV05MWlhsRlEwUklJam9nZXdvZ0lDQWdJQ0FnSUN
BZ0ltTnlkaUk2SUNKWU5EUQogIDRJaXdLSUNBZ0lDQWdJQ0FnSUNKUWRXSnNhV01p
T2lBaWVsRTVNVk4wYTB0RldtRjBSeTE2YlRCck5GZGZZCiAgV2MyVWpSUFlUWnFWR
Wh3UzFGcFFtWkxaVWRRWTFWTlNtMWZOMlZyYlFvZ0lFbFlNalZLZDJsYVpEUnNMVV
UKICB6TXpoWVIwNVFNbkJWUVNKOWZYMHNDaUFnSUNBaVVISnZabWxzWlZOcFoyNWh
kSFZ5WlNJNklIc0tJQ0FnSQogIENBZ0lsVmtaaUk2SUNKTlJFeFFMVkpTV2tvdFdr
RlRSeTFIVlVKYUxWQlFNa3N0TlZsRVNDMUZUVWRGSWl3CiAgS0lDQWdJQ0FnSWxCM
VlteHBZMUJoY21GdFpYUmxjbk1pT2lCN0NpQWdJQ0FnSUNBZ0lsQjFZbXhwWTB0bG
UKICBVVkRSRWdpT2lCN0NpQWdJQ0FnSUNBZ0lDQWlZM0oySWpvZ0lrVmtORFE0SWl
3S0lDQWdJQ0FnSUNBZ0lDSgogIFFkV0pzYVdNaU9pQWlhVUUyVmpkME9TMXVhR1JS
WVZCUE5WSmZkVXh4V0Zwa2RYUmhkRk5VVFRGbFQxVnhWCiAgR2d0TW1aSWMzRklkM
UkyYms5VWJRb2dJR2RqV2xkSFFWTnROMTlQZDNWS1RETXpkek5UZEdKaFFTSjlmWD
EKICA5ZlEiLAogICAgICAgICAgewogICAgICAgICAgICAic2lnbmF0dXJlcyI6IFt
7CiAgICAgICAgICAgICAgICAiYWxnIjogIlM1MTIiLAogICAgICAgICAgICAgICAg
ImtpZCI6ICJNRExQLVJSWkotWkFTRy1HVUJaLVBQMkstNVlESC1FTUdFIiwKICAgI
CAgICAgICAgICAgICJzaWduYXR1cmUiOiAiVVUxekE2aE1uamlRSEs0d3kzN2tGSF
g1UnBkS3JGZGxfb25yVC13V1hBWmdITkRaVQogIGMtQkRQS21fcDdrbEtQR0ZhQ1A
tamE1Z3ZDQUEwekpoNjhNZnR6ejBiOUM5anlvNlhydnFfWnphUlV2a3pWCiAgVkxI
TUxFOHFIa09ld1k1TzVYR2RyWlZqX2JDSjJHVGpOdUd2NWFCVUEifV0sCiAgICAgI
CAgICAgICJQYXlsb2FkRGlnZXN0IjogIll5MEFsVC1YTTVpbnJCcXJuWE5NcHFSOX
B5ZXEwYXpnenRPRTFkZW45U1RmRQogIERWa3htd01aNlJNZHd4Mlh6Q2gxQ2F3Y1B
GaU9pQ2kyc1pVb0JVdENnIn1dLAogICAgICAgICJQcm90b2NvbHMiOiBbewogICAg
ICAgICAgICAiUHJvdG9jb2wiOiAibW1tIn1dfV19fQ",
{
"signatures":[{
"alg":"S512",
"kid":"MAIV-XAKB-3IEL-WOKK-OW7B-4QVG-FLHP",
"signature":"EbV232z0tS5gXUEJ3bUICLNZAUmFgPZHkNGB13ND
gGnOfbAbPdo0vcb5icOVXIK8bLAxOGH33XwAw90EdkjMJ7cXGkoQcbzRMIE7cRlSw
x9zBBKYzjRsJC0Q3IXwnot7Gwse50WQMj4AS681S7cnBzcA"}
],
"PayloadDigest":"FZCKtoB_XLOW7JasPTVunMYRb4zZd-CjGX1mCNOA
GO4ViLbLfS_QMn6mh4GJazcDYd7Z0dX5de6QuhVzM5m0Ig"}
],
"MessageId":"NDRX-MOGE-HQ5D-FZHD-R42W-2U6V-OTKD",
"Sender":"bob@example.com",
"Recipient":"alice@example.com"}}¶
The Mesh Contact Exchange transaction does not provide for validation of the contact information beyond the binding to the Mesh Account Address used to perform the exchange.¶
Contact exchange requests MAY be authenticated by a PIN code. Initial contact exchange requests SHOULD include a PIN code value that can be used to authenticate a response (if given). PIN codes MAY also be exchanged out of band.¶
A MessageContact authenticated by means of a PIN code is authenticated as described in the PIN Interaction section above.¶
The GroupInvitation interaction is used to invite a recipient to join a Mesh Group. The interaction is essentially a form of contact exchange except that a sender SHOULD NOT send group invitations unless there is an existing relationship. Thus the 'first trust' issues intrinsic to the contact exchange interaction do not apply.¶
The message specifies the group name and the contact entry for the group. The contact entry includes the CapabilityDecryptServiced used to decrypt messages sent to the group when combined with information provided by the threshold service for the group.¶
Receipt of a GroupInvitation message does not require a response.¶
>>>> Unfinished ProtocolGroupInvite¶
Missing example 12¶
The confirmation interaction consists of a RequestConfirmation message from the initiator followed by a ResponseConfirmation from the responder.¶
The RequestConfirmation message specifies the action that is requested.¶
The ResponseConfirmation message contains the enveloped RequestConfirmation message signed by the initiator and the disposition of the responder, Accept = true if the request is accepted and Accept = false otherwise.¶
The service sends out the following request:¶
{
"RequestConfirmation":{
"Text":"start",
"MessageId":"NBGK-6BGU-5C5H-4WUR-OGDF-NZTH-ZLCW",
"Sender":"console@example.com",
"Recipient":"alice@example.com"}}¶
Alice accepts the request and returns the following response:¶
{
"ResponseConfirmation":{
"Request":[{
"EnvelopeId":"MBFM-RPD5-MYYX-UK3M-2SCV-GUYR-J446",
"ContentMetaData":"ewogICJVbmlxdWVJZCI6ICJOQkdLLTZCR1UtNU
M1SC00V1VSLU9HREYtTlpUSC1aTENXIiwKICAiTWVzc2FnZVR5cGUiOiAiUmVxdWV
zdENvbmZpcm1hdGlvbiIsCiAgImN0eSI6ICJhcHBsaWNhdGlvbi9tbW0vb2JqZWN0
IiwKICAiQ3JlYXRlZCI6ICIyMDIyLTEwLTE4VDEyOjQ0OjA1WiJ9",
"SequenceInfo":{
"Index":7,
"TreePosition":6201},
"Received":"2022-10-18T12:44:05Z"},
"ewogICJSZXF1ZXN0Q29uZmlybWF0aW9uIjogewogICAgIlRleHQiOiAic3
RhcnQiLAogICAgIk1lc3NhZ2VJZCI6ICJOQkdLLTZCR1UtNUM1SC00V1VSLU9HREY
tTlpUSC1aTENXIiwKICAgICJTZW5kZXIiOiAiY29uc29sZUBleGFtcGxlLmNvbSIs
CiAgICAiUmVjaXBpZW50IjogImFsaWNlQGV4YW1wbGUuY29tIn19",
{}
],
"Accept":true,
"MessageId":"MA6X-RZBB-RBT7-EWC2-ZPDV-ZUJI-3BRE",
"Sender":"alice@example.com",
"Recipient":"console@example.com"}}¶
Connection of a device to a Mesh Account combines synchronous and asynchronous elements and therefore uses a combination of Mesh Service Protocol and Mesh Messaging interactions.¶
Four connection interactions are currently defined support connection of devices with different affordances:¶
For connecting devices that provide data entry and display affordances and are connected to a network. The account the device is to be connected to is entered into the device which displays a witness code. This code is then compared with a code displayed on the administration device to authenticate the request, after which both devices can complete the interaction.¶
A variation of the Witness Authenticated interaction in which the connection process is initiated by creating a PIN value which is communicated to the device by some out of band means and used to authenticate the connection request.¶
For connecting devices that provide a camera affordance. The user sets the administration device into 'add device' mode, causing a QR code to be displayed. The QR code is scanned by the device being connected after which both devices can complete the interaction. Implementation of this mechanism is identical to the PIN authenticated scheme except that the PIN code is presented to the connecting device by means of a QR code.¶
For connecting devices that have been preconfigured with a device profile identified by means of a QR Code containing an EARL. The QR code is scanned by the administration device after which both devices can complete the interaction.¶
Each of these interactions provide strong mutual authentication with minimal user effort.¶
The witness authenticated connection interaction is intended for use in cases in which the device is already connected to a network. The QR code interactions are intended to provide support for acquisition of networking capabilities as part of the connection process. These functions are not currently specified. The Static QR Code Authenticated interaction is intended to support Internet of Things (IoT) devices which provide minimal interaction affordances.¶
In each case, the objectives of the device connection interaction are the same:¶
The connection of the device to the Mesh Account is achieved through the creation of the ActivationDevice, ConnectionDevice and CataloguedDevice records described in [draft-hallambaker-mesh-schema]. These are created by the administration device in the third phase of each of the connection interactions described below and acquired by the onboarding device in the fourth phase.¶
The witness authenticated, PIN authenticated, and Dynamic QR code interactions all follow a common interaction pattern.¶
The Dynamic QR Code (PIN) Authenticated interaction comprises four phases as follows:¶
A PIN code is created and registered with the PIN Registration interaction described earlier and transmitted to the user by an out of band communication. In the case of the Dynamic QR code interaction, this is a QR code that is scanned by the connecting device.¶
The onboarding device creates a RequestConnect message. In the PIN authenticated and Dynamic QR Code interactions, the RequestConnect is authenticated by the Device Authentication key and the PIN issued earlier. In the Witness Authenticated interaction, it is authenticated by the Device Authentication key alone.¶
The onboarding device presents the RequestConnect message to the service by means of a Connect operation to the service servicing the account. This results in the exchange of the account and device profiles and the computation of a witness value from the two profile fingerprints and two nonce values specified by the onboarding device and the service. An AcknowledgeConnection message is posted to the Inbound spool of the account and returned to the connecting device.¶
The account holder authenticates RequestConnect message and uses an administrative device to accept or reject the connection request.¶
If the RequestConnect message has been authenticated by a PIN code, the connection request can be accepted automatically without additional user interaction.¶
The onboarding device periodically polls the service for acceptance of the request by the administration device using the Complete transaction.¶
The use of the PIN code to authenticate the request message is shown in $$$$.¶
The PIN code MAY be presented to the onboarding device in any format accepted by the device. Administration MAY support presentation of the account address PIN code as a URI code. Administration devices SHOULD support presentation of the account address PIN code as a QR code containing the corresponding URI.¶
Alice> meshman account pin /threshold PIN=AAIT-WXRD-BVB7-3BBT-D6JS-44GE-B4 (Expires=2022-10-19T12:48:11Z)¶
The registration of this PIN value was shown earlier in section $$$¶
The URI containing the account address and PIN is:¶
mcu://alice@example.com/AAIT-WXRD-BVB7-3BBT-D6JS-44GE-B4¶
The onboarding device scans the QR code to obtain the account address and PIN code. The PIN code is used to authenticate a connection request:¶
Alice3> meshman device request alice@example.com /pin ^
AAIT-WXRD-BVB7-3BBT-D6JS-44GE-B4
Device UDF = MDVU-AOST-TDIH-AXGE-WUJS-I56V-WJP3
Witness value = AI7W-YKPK-MR3U-CZW7-GAVQ-24LZ-MSFA
¶
The device generates a RequestConnect message as follows:¶
{
"RequestConnection":{
"AccountAddress":"alice@example.com",
"AuthenticatedData":[{
"EnvelopeId":"MDVU-AOST-TDIH-AXGE-WUJS-I56V-WJP3",
"dig":"S512",
"ContentMetaData":"ewogICJVbmlxdWVJZCI6ICJNRFZVLUFPU1QtVE
RJSC1BWEdFLVdVSlMtSTU2Vi1XSlAzIiwKICAiTWVzc2FnZVR5cGUiOiAiUHJvZml
sZURldmljZSIsCiAgImN0eSI6ICJhcHBsaWNhdGlvbi9tbW0vb2JqZWN0IiwKICAi
Q3JlYXRlZCI6ICIyMDIyLTEwLTE4VDEyOjQ4OjExWiJ9"},
"ewogICJQcm9maWxlRGV2aWNlIjogewogICAgIkVuY3J5cHRpb24iOiB7Ci
AgICAgICJVZGYiOiAiTUNaWC1VMjJGLTJTSU8tVURVNC0zMlBULUJXNzYtSFlIUCI
sCiAgICAgICJQdWJsaWNQYXJhbWV0ZXJzIjogewogICAgICAgICJQdWJsaWNLZXlF
Q0RIIjogewogICAgICAgICAgImNydiI6ICJYNDQ4IiwKICAgICAgICAgICJQdWJsa
WMiOiAiWkFhaGpPUlFYbGYxNjBmMzZOOUc5aGU3WC1Wc1l3VW9VSmNGbXZLY0ZHOU
xRRjM5SWhTOQogIGNoM2dwX1QydC1wRm1iWjdzc2tmV25BQSJ9fX0sCiAgICAiU2l
nbmF0dXJlIjogewogICAgICAiVWRmIjogIk1CRE8tM0s3QS1LUlRJLU1CVFEtTVdZ
Ni1VRFBGLVQzSVkiLAogICAgICAiUHVibGljUGFyYW1ldGVycyI6IHsKICAgICAgI
CAiUHVibGljS2V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAiRWQ0NDgiLAogIC
AgICAgICAgIlB1YmxpYyI6ICJFbnRiQXdpeVZBMl9zd2lGQWJMSUFJMzVjZ3IzTzB
uSnIwQU9kUzRjVXF6aS0zc20wM1R3CiAgVEVGTlFoTDZkNWI1ZnFQTU10VGo3VGlB
In19fSwKICAgICJBdXRoZW50aWNhdGlvbiI6IHsKICAgICAgIlVkZiI6ICJNQzNSL
TJVSkstS0NONS1ZQkM3LUdGQ1UtSkZaRS1SR0dGIiwKICAgICAgIlB1YmxpY1Bhcm
FtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tleUVDREgiOiB7CiAgICAgICAgICA
iY3J2IjogIlg0NDgiLAogICAgICAgICAgIlB1YmxpYyI6ICJBWGtqbUJRY0Vqd2xj
TGlXekV4TlNiaXQwelRBZFg2dnhRUlFzdEZZbnFlcXc3LVhtY3JRCiAgM3pMMFpNU
UdRUWhYODZJSmpUSDZWZVdBIn19fSwKICAgICJQcm9maWxlU2lnbmF0dXJlIjogew
ogICAgICAiVWRmIjogIk1EVlUtQU9TVC1URElILUFYR0UtV1VKUy1JNTZWLVdKUDM
iLAogICAgICAiUHVibGljUGFyYW1ldGVycyI6IHsKICAgICAgICAiUHVibGljS2V5
RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAiRWQ0NDgiLAogICAgICAgICAgIlB1Y
mxpYyI6ICI2WlFaNnFzakVWcUVLaXRzRjA2ZTJ3M1ZTd0FvOGpDRmtnVWppSXItY2
dkUHdqUjBKTHJsCiAgYlBoMmVLZnNxU1ZvNThoRHBHUGNyZ29BIn19fX19",
{
"signatures":[{
"alg":"S512",
"kid":"MDVU-AOST-TDIH-AXGE-WUJS-I56V-WJP3",
"signature":"3-NhTi02RC6ubyqOekMxcgQPcSlrcFQBCtr0UJFe
WHXwC-_0CIqaXiyzRfR2w1kER8RfwsRNwGYANf4ibEHY2INrVCpVJ8roGwF2tdhcg
SAweO-U-q5ZN6GfldFEn0Ti-bduK8GO351dw-QLrhzNXRMA"}
],
"PayloadDigest":"rXw_CoKPcHDnNka5vIWV7xQ77pf-2fyUn3h3fyKK
P5-b0CZFuw10Akv8TVj748vu0a_FVOeF-DoJ2zwSt-zJHQ"}
],
"ClientNonce":"sX3O55Fc0_Qif7ss-oYQlQ",
"PinId":"ABFI-YEZB-HAEO-7LVM-E7VB-IWUC-YD3F",
"PinWitness":"WZhJn7bTGqltSl8ncV-CDdxeHsimsfeyznypj266_Fn-akQ
EqWfPCG11r51iVGZK5iSFZYIIMJjmWhPTfJDqfw",
"MessageId":"NBKV-TDNI-KV6R-O6U6-B4UI-3INK-AAFG"}}¶
The service receives the conenct request and authenticates the message under the device key. The service cannot authenticate the message under the PIN code because that is not know to the service as the service cannot decrypt the local spool.¶
Having authenticated the connect request, the service generates a random nonce value. The random nonce together with the device and account profiles are used to calculate the witness value.¶
The AcknowledgeConnection message is created by the service:¶
{
"AcknowledgeConnection":{
"EnvelopedRequestConnection":[{
"EnvelopeId":"MCRT-4U7E-2EFA-6GT6-ATYZ-NKLT-DNU6",
"ContentMetaData":"ewogICJVbmlxdWVJZCI6ICJOQktWLVRETkktS1
Y2Ui1PNlU2LUI0VUktM0lOSy1BQUZHIiwKICAiTWVzc2FnZVR5cGUiOiAiUmVxdWV
zdENvbm5lY3Rpb24iLAogICJjdHkiOiAiYXBwbGljYXRpb24vbW1tL29iamVjdCIs
CiAgIkNyZWF0ZWQiOiAiMjAyMi0xMC0xOFQxMjo0ODoxMVoifQ"},
"ewogICJSZXF1ZXN0Q29ubmVjdGlvbiI6IHsKICAgICJBY2NvdW50QWRkcm
VzcyI6ICJhbGljZUBleGFtcGxlLmNvbSIsCiAgICAiQXV0aGVudGljYXRlZERhdGE
iOiBbewogICAgICAgICJFbnZlbG9wZUlkIjogIk1EVlUtQU9TVC1URElILUFYR0Ut
V1VKUy1JNTZWLVdKUDMiLAogICAgICAgICJkaWciOiAiUzUxMiIsCiAgICAgICAgI
kNvbnRlbnRNZXRhRGF0YSI6ICJld29nSUNKVmJtbHhkV1ZKWkNJNklDSk5SRlpWTF
VGUFUxUXRWRVJKU0MxCiAgQldFZEZMVmRWU2xNdFNUVTJWaTFYU2xBeklpd0tJQ0F
pVFdWemMyRm5aVlI1Y0dVaU9pQWlVSEp2Wm1sc1oKICBVUmxkbWxqWlNJc0NpQWdJ
bU4wZVNJNklDSmhjSEJzYVdOaGRHbHZiaTl0YlcwdmIySnFaV04wSWl3S0lDQQogI
GlRM0psWVhSbFpDSTZJQ0l5TURJeUxURXdMVEU0VkRFeU9qUTRPakV4V2lKOSJ9LA
ogICAgICAiZXdvZ0lDSlFjbTltYVd4bFJHVjJhV05sSWpvZ2V3b2dJQ0FnSWtWdVk
zSgogIDVjSFJwYjI0aU9pQjdDaUFnSUNBZ0lDSlZaR1lpT2lBaVRVTmFXQzFWTWpK
R0xUSlRTVTh0VlVSVk5DMHpNCiAgbEJVTFVKWE56WXRTRmxJVUNJc0NpQWdJQ0FnS
UNKUWRXSnNhV05RWVhKaGJXVjBaWEp6SWpvZ2V3b2dJQ0EKICBnSUNBZ0lDSlFkV0
pzYVdOTFpYbEZRMFJJSWpvZ2V3b2dJQ0FnSUNBZ0lDQWdJbU55ZGlJNklDSllORFE
0SQogIGl3S0lDQWdJQ0FnSUNBZ0lDSlFkV0pzYVdNaU9pQWlXa0ZoYUdwUFVsRlli
R1l4TmpCbU16Wk9PVWM1YUdVCiAgM1dDMVdjMWwzVlc5VlNtTkdiWFpMWTBaSE9Ve
FJSak01U1doVE9Rb2dJR05vTTJkd1gxUXlkQzF3Um0xaVcKICBqZHpjMnRtVjI1Ql
FTSjlmWDBzQ2lBZ0lDQWlVMmxuYm1GMGRYSmxJam9nZXdvZ0lDQWdJQ0FpVldSbUl
qbwogIGdJazFDUkU4dE0wczNRUzFMVWxSSkxVMUNWRkV0VFZkWk5pMVZSRkJHTFZR
elNWa2lMQW9nSUNBZ0lDQWlVCiAgSFZpYkdsalVHRnlZVzFsZEdWeWN5STZJSHNLS
UNBZ0lDQWdJQ0FpVUhWaWJHbGpTMlY1UlVORVNDSTZJSHMKICBLSUNBZ0lDQWdJQ0
FnSUNKamNuWWlPaUFpUldRME5EZ2lMQW9nSUNBZ0lDQWdJQ0FnSWxCMVlteHBZeUk
2SQogIENKRmJuUmlRWGRwZVZaQk1sOXpkMmxHUVdKTVNVRkpNelZqWjNJelR6QnVT
bkl3UVU5a1V6UmpWWEY2YVMwCiAgemMyMHdNMVIzQ2lBZ1ZFVkdUbEZvVERaa05XS
TFabkZRVFUxMFZHbzNWR2xCSW4xOWZTd0tJQ0FnSUNKQmQKICBYUm9aVzUwYVdOaG
RHbHZiaUk2SUhzS0lDQWdJQ0FnSWxWa1ppSTZJQ0pOUXpOU0xUSlZTa3N0UzBOT05
TMQogIFpRa00zTFVkR1ExVXRTa1phUlMxU1IwZEdJaXdLSUNBZ0lDQWdJbEIxWW14
cFkxQmhjbUZ0WlhSbGNuTWlPCiAgaUI3Q2lBZ0lDQWdJQ0FnSWxCMVlteHBZMHRsZ
VVWRFJFZ2lPaUI3Q2lBZ0lDQWdJQ0FnSUNBaVkzSjJJam8KICBnSWxnME5EZ2lMQW
9nSUNBZ0lDQWdJQ0FnSWxCMVlteHBZeUk2SUNKQldHdHFiVUpSWTBWcWQyeGpUR2x
YZQogIGtWNFRsTmlhWFF3ZWxSQlpGZzJkbmhSVWxGemRFWlpibkZsY1hjM0xWaHRZ
M0pSQ2lBZ00zcE1NRnBOVVVkCiAgUlVXaFlPRFpKU21wVVNEWldaVmRCSW4xOWZTd
0tJQ0FnSUNKUWNtOW1hV3hsVTJsbmJtRjBkWEpsSWpvZ2UKICB3b2dJQ0FnSUNBaV
ZXUm1Jam9nSWsxRVZsVXRRVTlUVkMxVVJFbElMVUZZUjBVdFYxVktVeTFKTlRaV0x
WZAogIEtVRE1pTEFvZ0lDQWdJQ0FpVUhWaWJHbGpVR0Z5WVcxbGRHVnljeUk2SUhz
S0lDQWdJQ0FnSUNBaVVIVmliCiAgR2xqUzJWNVJVTkVTQ0k2SUhzS0lDQWdJQ0FnS
UNBZ0lDSmpjbllpT2lBaVJXUTBORGdpTEFvZ0lDQWdJQ0EKICBnSUNBZ0lsQjFZbX
hwWXlJNklDSTJXbEZhTm5GemFrVldjVVZMYVhSelJqQTJaVEozTTFaVGQwRnZPR3B
EUgogIG10blZXcHBTWEl0WTJka1VIZHFVakJLVEhKc0NpQWdZbEJvTW1WTFpuTnhV
MVp2TlRob1JIQkhVR055WjI5CiAgQkluMTlmWDE5IiwKICAgICAgewogICAgICAgI
CJzaWduYXR1cmVzIjogW3sKICAgICAgICAgICAgImFsZyI6ICJTNTEyIiwKICAgIC
AgICAgICAgImtpZCI6ICJNRFZVLUFPU1QtVERJSC1BWEdFLVdVSlMtSTU2Vi1XSlA
zIiwKICAgICAgICAgICAgInNpZ25hdHVyZSI6ICIzLU5oVGkwMlJDNnVieXFPZWtN
eGNnUVBjU2xyY0ZRQkN0cjBVSkZlV0hYd0MtXzBDCiAgSXFhWGl5elJmUjJ3MWtFU
jhSZndzUk53R1lBTmY0aWJFSFkySU5yVkNwVko4cm9Hd0YydGRoY2dTQXdlTy0KIC
BVLXE1Wk42R2ZsZEZFbjBUaS1iZHVLOEdPMzUxZHctUUxyaHpOWFJNQSJ9XSwKICA
gICAgICAiUGF5bG9hZERpZ2VzdCI6ICJyWHdfQ29LUGNIRG5Oa2E1dklXVjd4UTc3
cGYtMmZ5VW4zaDNmeUtLUDUtYjAKICBDWkZ1dzEwQWt2OFRWajc0OHZ1MGFfRlZPZ
UYtRG9KMnp3U3QtekpIUSJ9XSwKICAgICJDbGllbnROb25jZSI6ICJzWDNPNTVGYz
BfUWlmN3NzLW9ZUWxRIiwKICAgICJQaW5JZCI6ICJBQkZJLVlFWkItSEFFTy03TFZ
NLUU3VkItSVdVQy1ZRDNGIiwKICAgICJQaW5XaXRuZXNzIjogIldaaEpuN2JUR3Fs
dFNsOG5jVi1DRGR4ZUhzaW1zZmV5em55cGoyNjZfRm4tYWtRRQogIHFXZlBDRzExc
jUxaVZHWks1aVNGWllJSU1Kam1XaFBUZkpEcWZ3IiwKICAgICJNZXNzYWdlSWQiOi
AiTkJLVi1URE5JLUtWNlItTzZVNi1CNFVJLTNJTkstQUFGRyJ9fQ"
],
"ServerNonce":"QByh6ilkH8TWCy92cW2IZQ",
"Witness":"AI7W-YKPK-MR3U-CZW7-GAVQ-24LZ-MSFA",
"MessageId":"AI7W-YKPK-MR3U-CZW7-GAVQ-24LZ-MSFA"}}¶
The AcknowledgeConnection message is appended to the Inbound spool of the account to which connection was requested so that the user can approve the request. The ConnectResponse message is returned to the device containing the AcknowledgeConnection message and the profile of the account.¶
The device generates the witness value, verifies it against the value provided by the server and presents it to the user as seen in the console example above.¶
The user synchronizes their pending messages:¶
Alice> meshman message pending
MessageID: AI7W-YKPK-MR3U-CZW7-GAVQ-24LZ-MSFA
Connection Request::
MessageID: AI7W-YKPK-MR3U-CZW7-GAVQ-24LZ-MSFA
To: From:
Device: MDVU-AOST-TDIH-AXGE-WUJS-I56V-WJP3
Witness: AI7W-YKPK-MR3U-CZW7-GAVQ-24LZ-MSFA
MessageID: NBGK-6BGU-5C5H-4WUR-OGDF-NZTH-ZLCW
Confirmation Request::
MessageID: NBGK-6BGU-5C5H-4WUR-OGDF-NZTH-ZLCW
To: alice@example.com From: console@example.com
Text: start
Alice> meshman account sync /auto
¶
The administration device determines that the device connection request is authenticated by a PIN code. The PIN code is retrieved and the message authenticated. This is shown in the PIN registration interation example in section $$$ above.¶
Bug: This command is currently showing superflous pending messages due to the failure to clear messages processed in earlier examples.¶
The Cataloged device record is created from the public key values corresponding to the combination of the public keys in the device profile and those defined by the activation.¶
This is returned to the onboarding device by wrapping it in a RespondConnection message posted to the local spool of the account.¶
{
"RespondConnection":{
"Result":"Accept",
"CatalogedDevice":{
"DeviceUdf":"MDVU-AOST-TDIH-AXGE-WUJS-I56V-WJP3",
"EnvelopedProfileUser":[{
"EnvelopeId":"MDRR-5W72-3RJO-VZB3-VUVQ-IOEC-6UNA",
"dig":"S512",
"ContentMetaData":"ewogICJVbmlxdWVJZCI6ICJNRFJSLTVXNzIt
M1JKTy1WWkIzLVZVVlEtSU9FQy02VU5BIiwKICAiTWVzc2FnZVR5cGUiOiAiUHJvZ
mlsZVVzZXIiLAogICJjdHkiOiAiYXBwbGljYXRpb24vbW1tL29iamVjdCIsCiAgIk
NyZWF0ZWQiOiAiMjAyMi0xMC0xOFQxMjo0MzoyOFoifQ"},
"ewogICJQcm9maWxlVXNlciI6IHsKICAgICJDb21tb25TaWduYXR1cmUi
OiB7CiAgICAgICJVZGYiOiAiTUNERy1UUzdULVVQREQtVjY2Ny1PWFNYLVFKNUctR
lFSWiIsCiAgICAgICJQdWJsaWNQYXJhbWV0ZXJzIjogewogICAgICAgICJQdWJsaW
NLZXlFQ0RIIjogewogICAgICAgICAgImNydiI6ICJFZDQ0OCIsCiAgICAgICAgICA
iUHVibGljIjogImhBZTdpaUNZbm51MGpyVFNhdTVXdWNPNzRNajBaQTlEY1N6VFd5
ck5RVXg3dDVuSnNsZkIKICB6VjBqYnpaWWprb29HalFsYnZJclVUR0EifX19LAogI
CAgIkFjY291bnRBZGRyZXNzIjogImFsaWNlQGV4YW1wbGUuY29tIiwKICAgICJTZX
J2aWNlVWRmIjogIk1CWUgtQkozSS1FVVdMLTdRQUktTkdJRS1UUEM2LVg0S1UiLAo
gICAgIkVzY3Jvd0VuY3J5cHRpb24iOiB7CiAgICAgICJVZGYiOiAiTUJNVC1LSkpX
LUZVN1UtSFJNUi1LNE9JLU9LTVktWENZTyIsCiAgICAgICJQdWJsaWNQYXJhbWV0Z
XJzIjogewogICAgICAgICJQdWJsaWNLZXlFQ0RIIjogewogICAgICAgICAgImNydi
I6ICJYNDQ4IiwKICAgICAgICAgICJQdWJsaWMiOiAiak1XbTJvRGpvQWdJZ053SkV
3eGk2MkZvRnhrN002R0VMX1FUcGZySmhvd2k2eUFJOTFHVAogIDh4X3pFVG9NYnVh
eDA5VkpDRU9QWnphQSJ9fX0sCiAgICAiQWRtaW5pc3RyYXRvclNpZ25hdHVyZSI6I
HsKICAgICAgIlVkZiI6ICJNQkZNLVhXMkgtQ0JMVC1BTU5RLVpXVlotVVNHSS1LT0
dJIiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0t
leUVDREgiOiB7CiAgICAgICAgICAiY3J2IjogIkVkNDQ4IiwKICAgICAgICAgICJQ
dWJsaWMiOiAid0loNFhfcnpEMzQ2OFRFWnhLdGZWd0xSdHRlRFBZUEpqeWFUUUMwc
kl5bzFOazZQTnNkUQogIHZNa0FPNzZBejlCR19aTGxVNE50T2tnQSJ9fX0sCiAgIC
AiQ29tbW9uRW5jcnlwdGlvbiI6IHsKICAgICAgIlVkZiI6ICJNQzdWLVhWTUotNzN
PTC1ZV0dMLTVNSUstUk9YUS1HTDNZIiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMi
OiB7CiAgICAgICAgIlB1YmxpY0tleUVDREgiOiB7CiAgICAgICAgICAiY3J2IjogI
lg0NDgiLAogICAgICAgICAgIlB1YmxpYyI6ICJjbERrUVQ0bDBxV3E4eFJ4SlNsNm
p0eV9NdXFsWTM5ZE1jOUhheFEwSWk5Nk00aThFVWVRCiAgeW9VT1pRM2IxYjQwVFc
3eUtBb3U5SHlBIn19fSwKICAgICJDb21tb25BdXRoZW50aWNhdGlvbiI6IHsKICAg
ICAgIlVkZiI6ICJNQVgzLUU2V1AtQk1JUy1JWFBJLU1ZUFItTTU2Qy1PSVUzIiwKI
CAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tleUVDRE
giOiB7CiAgICAgICAgICAiY3J2IjogIlg0NDgiLAogICAgICAgICAgIlB1YmxpYyI
6ICJwamdjdmlIRU9yYW4yWmFMa2E5ZmVnbmFqN3V0OU5Sd2NTNUZHWmlGODBvSmUz
RnpVeHZzCiAgeE1xdXRJNFpxNW5zbVAwbDhEa1FPUUlBIn19fSwKICAgICJQcm9ma
WxlU2lnbmF0dXJlIjogewogICAgICAiVWRmIjogIk1EUlItNVc3Mi0zUkpPLVZaQj
MtVlVWUS1JT0VDLTZVTkEiLAogICAgICAiUHVibGljUGFyYW1ldGVycyI6IHsKICA
gICAgICAiUHVibGljS2V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAiRWQ0NDgi
LAogICAgICAgICAgIlB1YmxpYyI6ICI4MXN3cG0wNVQ5b2x5cWJNSE8wZGFEVFdSM
mktUEtGaEhtQnRHdjVwTkowNmg2a0tFNk5VCiAgMGJDTHY2U3k3cGJuc3dXbUZzek
t0U3FBIn19fX19",
{
"signatures":[{
"alg":"S512",
"kid":"MDRR-5W72-3RJO-VZB3-VUVQ-IOEC-6UNA",
"signature":"UNtyhJFuwLPmj8uuSw6Ts61ACoOkEoLF63rSbH
T35bDRuS8VFhnkyNX2mQ4SIGHuBPPSURZB84kAGRhq0MRAR32jbTJr4We3LSy_Pde
Gh5hVaGbRMUhX2V40SVzy7SxLcGYW8iXqXq9PVYL3S315fBIA"}
],
"PayloadDigest":"6P0GfqW3b_kYhYrWG0e0oXy0uENOr_YxxcU3Cg
LaNO3tLeTmWkUCGtlZUMvEptTtN-Ysu4KqmXr7OmphX03qow"}
],
"EnvelopedProfileDevice":[{
"EnvelopeId":"MDVU-AOST-TDIH-AXGE-WUJS-I56V-WJP3",
"dig":"S512",
"ContentMetaData":"ewogICJVbmlxdWVJZCI6ICJNRFZVLUFPU1Qt
VERJSC1BWEdFLVdVSlMtSTU2Vi1XSlAzIiwKICAiTWVzc2FnZVR5cGUiOiAiUHJvZ
mlsZURldmljZSIsCiAgImN0eSI6ICJhcHBsaWNhdGlvbi9tbW0vb2JqZWN0IiwKIC
AiQ3JlYXRlZCI6ICIyMDIyLTEwLTE4VDEyOjQ4OjExWiJ9"},
"ewogICJQcm9maWxlRGV2aWNlIjogewogICAgIkVuY3J5cHRpb24iOiB7
CiAgICAgICJVZGYiOiAiTUNaWC1VMjJGLTJTSU8tVURVNC0zMlBULUJXNzYtSFlIU
CIsCiAgICAgICJQdWJsaWNQYXJhbWV0ZXJzIjogewogICAgICAgICJQdWJsaWNLZX
lFQ0RIIjogewogICAgICAgICAgImNydiI6ICJYNDQ4IiwKICAgICAgICAgICJQdWJ
saWMiOiAiWkFhaGpPUlFYbGYxNjBmMzZOOUc5aGU3WC1Wc1l3VW9VSmNGbXZLY0ZH
OUxRRjM5SWhTOQogIGNoM2dwX1QydC1wRm1iWjdzc2tmV25BQSJ9fX0sCiAgICAiU
2lnbmF0dXJlIjogewogICAgICAiVWRmIjogIk1CRE8tM0s3QS1LUlRJLU1CVFEtTV
dZNi1VRFBGLVQzSVkiLAogICAgICAiUHVibGljUGFyYW1ldGVycyI6IHsKICAgICA
gICAiUHVibGljS2V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAiRWQ0NDgiLAog
ICAgICAgICAgIlB1YmxpYyI6ICJFbnRiQXdpeVZBMl9zd2lGQWJMSUFJMzVjZ3IzT
zBuSnIwQU9kUzRjVXF6aS0zc20wM1R3CiAgVEVGTlFoTDZkNWI1ZnFQTU10VGo3VG
lBIn19fSwKICAgICJBdXRoZW50aWNhdGlvbiI6IHsKICAgICAgIlVkZiI6ICJNQzN
SLTJVSkstS0NONS1ZQkM3LUdGQ1UtSkZaRS1SR0dGIiwKICAgICAgIlB1YmxpY1Bh
cmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tleUVDREgiOiB7CiAgICAgICAgI
CAiY3J2IjogIlg0NDgiLAogICAgICAgICAgIlB1YmxpYyI6ICJBWGtqbUJRY0Vqd2
xjTGlXekV4TlNiaXQwelRBZFg2dnhRUlFzdEZZbnFlcXc3LVhtY3JRCiAgM3pMMFp
NUUdRUWhYODZJSmpUSDZWZVdBIn19fSwKICAgICJQcm9maWxlU2lnbmF0dXJlIjog
ewogICAgICAiVWRmIjogIk1EVlUtQU9TVC1URElILUFYR0UtV1VKUy1JNTZWLVdKU
DMiLAogICAgICAiUHVibGljUGFyYW1ldGVycyI6IHsKICAgICAgICAiUHVibGljS2
V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAiRWQ0NDgiLAogICAgICAgICAgIlB
1YmxpYyI6ICI2WlFaNnFzakVWcUVLaXRzRjA2ZTJ3M1ZTd0FvOGpDRmtnVWppSXIt
Y2dkUHdqUjBKTHJsCiAgYlBoMmVLZnNxU1ZvNThoRHBHUGNyZ29BIn19fX19",
{
"signatures":[{
"alg":"S512",
"kid":"MDVU-AOST-TDIH-AXGE-WUJS-I56V-WJP3",
"signature":"3-NhTi02RC6ubyqOekMxcgQPcSlrcFQBCtr0UJ
FeWHXwC-_0CIqaXiyzRfR2w1kER8RfwsRNwGYANf4ibEHY2INrVCpVJ8roGwF2tdh
cgSAweO-U-q5ZN6GfldFEn0Ti-bduK8GO351dw-QLrhzNXRMA"}
],
"PayloadDigest":"rXw_CoKPcHDnNka5vIWV7xQ77pf-2fyUn3h3fy
KKP5-b0CZFuw10Akv8TVj748vu0a_FVOeF-DoJ2zwSt-zJHQ"}
],
"EnvelopedConnectionService":[{
"dig":"S512",
"ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJDb25uZWN0
aW9uU2VydmljZSIsCiAgImN0eSI6ICJhcHBsaWNhdGlvbi9tbW0vb2JqZWN0IiwKI
CAiQ3JlYXRlZCI6ICIyMDIyLTEwLTE4VDEyOjQ4OjEzWiJ9"},
"e7QRQ29ubmVjdGlvblNlcnZpY2V7tApQcm9maWxlVWRmgCJNRFJSLTVX
NzItM1JKTy1WWkIzLVZVVlEtSU9FQy02VU5BtA5BdXRoZW50aWNhdGlvbnu0A1VkZ
oAiTUQyTC1NUFJFLVFXV1MtWFRKRC0zVVBNLVhMQkktTDdZNrQQUHVibGljUGFyYW
1ldGVyc3u0DVB1YmxpY0tleUVDREh7tANjcnaABFg0NDi0BlB1YmxpY4g5k90GmOG
e9O5lzmhecs6x7bMgC-TLtWwRxRhD22Jsp7cWUfzdYclPicMd75dLrMhGvPDqGoGK
kFeAfX19fX0",
{
"signatures":[{
"alg":"S512",
"kid":"MBFM-XW2H-CBLT-AMNQ-ZWVZ-USGI-KOGI",
"signature":"2ULSXsloj7o6CA45OK9oS76Lxvx_scD5v0Jyg3
Orw3y5u6jxTfBDQ0achKfG7ukTYUYk-F_9bZQAUeDiu_UNQ-F11KU93eLfKNdoyMG
PuqueZM3cI_3MZpg_Y8USSTBC8-3ZQ2jm7eTQvf1TJ4hcfSgA"}
],
"PayloadDigest":"ilTsyFjZfzvueN8dMs0oIjWRMnlX8738V2SxXQ
WMtTl30QadDspUKT0y9htgRd3B3K3BXXYuifsVYkemJ93r8Q"}
],
"EnvelopedConnectionDevice":[{
"dig":"S512",
"ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJDb25uZWN0
aW9uRGV2aWNlIiwKICAiY3R5IjogImFwcGxpY2F0aW9uL21tbS9vYmplY3QiLAogI
CJDcmVhdGVkIjogIjIwMjItMTAtMThUMTI6NDg6MTNaIn0"},
"e7QQQ29ubmVjdGlvbkRldmljZXu0BVJvbGVzW4AJdGhyZXNob2xkXbQJ
U2lnbmF0dXJle7QDVWRmgCJNQ04zLTJCWlotMk01RC1JS0pDLUsyNDUtUFMyQi1WV
FRHtBBQdWJsaWNQYXJhbWV0ZXJze7QNUHVibGljS2V5RUNESHu0A2NydoAFRWQ0ND
i0BlB1YmxpY4g5fZZGkmvt9nJ_UbyYl38byPIhQiUf5jAY4RmX1NWznq1itr_e80-
tKNvJtkDX5f56cXXI1bY7pxmAfX19tApFbmNyeXB0aW9ue7QDVWRmgCJNQlZSLUtD
TUYtVTNDNS00M1NILVZFUjQtU0RDSi1SU0JDtBBQdWJsaWNQYXJhbWV0ZXJze7QNU
HVibGljS2V5RUNESHu0A2NydoAEWDQ0OLQGUHVibGljiDnF6uTxweBXs82Hcn7xeh
B6sIKxIqEIscG6ii7JNtw8_IQ60_4u2-pl0hGMUoapHD3rDNFnnSqx1YB9fX20ClB
yb2ZpbGVVZGaAIk1EUlItNVc3Mi0zUkpPLVZaQjMtVlVWUS1JT0VDLTZVTkG0DkF1
dGhlbnRpY2F0aW9ue7QDVWRmgCJNRDJMLU1QUkUtUVdXUy1YVEpELTNVUE0tWExCS
S1MN1k2tBBQdWJsaWNQYXJhbWV0ZXJze7QNUHVibGljS2V5RUNESHu0A2NydoAEWD
Q0OLQGUHVibGljiDmT3QaY4Z707mXOaF5yzrHtsyAL5Mu1bBHFGEPbYmyntxZR_N1
hyU-Jwx3vl0usyEa88OoagYqQV4B9fX19fQ",
{
"signatures":[{
"alg":"S512",
"kid":"MBFM-XW2H-CBLT-AMNQ-ZWVZ-USGI-KOGI",
"signature":"C0kZpxdTGCpsjM4K0GYANmI7MJt7IWg1uWubP6
ReBoSJDIOhgjxEFkyLkLru6M_DC9wQseJJRUyAXdFnMWsryyYwlGe7Mt7gLqiy2jZ
LChMed6CWRFihSKyy3m2xk5MpgVWKE0OPTSd5ogggywNcPCEA"}
],
"PayloadDigest":"T8rztdxwV4vdVcuzkbHCN9IdLOQgktu8bVdOPZ
1oe9OHzpQF9iXp-TKA-pe_t7fI7TBIIy4_fgyceguzfLm8QQ"}
],
"EnvelopedActivationAccount":[{
"enc":"A256CBC",
"dig":"S512",
"kid":"EBQC-UWVB-WCCL-OC7B-DAPJ-HH56-FTPU",
"Salt":"6cMFPhSyk3N-N8BpC6wfvw",
"recipients":[{
"kid":"MCZX-U22F-2SIO-UDU4-32PT-BW76-HYHP",
"epk":{
"PublicKeyECDH":{
"crv":"X448",
"Public":"pfz6Z5pf01FpCm-sqly6c5yn3gkTDvXsoq3DN
kgL2ct4Xi-ZchVk4S371FmXTRDDksZkNcr6_uyA"}},
"wmk":"UIdLeJGqH_HnNrTQkHqkwf5Moc9qv_DGHx6hK8HPd_Ga
4HFdKM-P5Q"}
],
"ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJBY3RpdmF0
aW9uQWNjb3VudCIsCiAgImN0eSI6ICJhcHBsaWNhdGlvbi9tbW0vb2JqZWN0IiwKI
CAiQ3JlYXRlZCI6ICIyMDIyLTEwLTE4VDEyOjQ4OjEyWiJ9"},
"DIILdK1ep36rm_QwOAirsby0NrS7VdPW4dWllC6JNaiYm8tVemYvpSw9
T6JAMzeF1NbQV-qICMqS0S03wFQBHrh5AGk1cvi8gXYoB3KibVGlbfe63RJ7rW3uH
lROB8JIruTeIUI2B6Tenq_Hr1pS_hsPwQhcnmfZbifzzF_IQCBXIrVTxloHcvuvFD
eQ-in5akhvKd8AhjeX4CqJXiYl66r5UST7jpVb0KhhI-7CB_JqiwkQ9-EneFtYAFP
4rMgE",
{
"signatures":[{
"alg":"S512",
"kid":"MBFM-XW2H-CBLT-AMNQ-ZWVZ-USGI-KOGI",
"signature":"Hnhrbwt-FrfgcWsuL8x_8M5XV1Arw89jnX83t2
qNydJGKr1edgE9GJyFuiuWKua2-qxRuY_eGEOApCbI0DQTXGaev8r02It0NiSPhey
OK7QedmR63RBdYyjz6RPKAK_rDLRsqK8aSIECeHvvZOkHVRMA",
"witness":"XtNpxWPYliMptDDZHLJzbPBSCyVqe8lP93CmTqvL
Ik4"}
],
"PayloadDigest":"2RS8lD25HernJ5djhkJwxX5mn1ad1d5mcJhppb
rD7KYyFSgfs2_mKuB0PQLQhQszM4DsaHCOBd9Dy3LTXsy0Dg"}
],
"EnvelopedActivationCommon":[{
"enc":"A256CBC",
"dig":"S512",
"kid":"EBQH-EUWK-3FJW-YFOP-MQ75-HZZH-2RVK",
"Salt":"z6lXFvESehf7hmdqgvq6hg",
"recipients":[{
"kid":"MBVR-KCMF-U3C5-43SH-VER4-SDCJ-RSBC",
"epk":{
"PublicKeyECDH":{
"crv":"X448",
"Public":"-yyvcy-Dq4Xhu7CuAScV2cJ-IRGq8uZNY8XMP
kZLr_MK3xCrXmQueChVthD4Q8WYYthuHjj0Xt2A"}},
"wmk":"tpvjbLkGEgDIBIqLb576LYgoRNdUGBtVL_mUXIu4xVPE
nZHssOXrTw"}
],
"ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJBY3RpdmF0
aW9uQ29tbW9uIiwKICAiY3R5IjogImFwcGxpY2F0aW9uL21tbS9vYmplY3QiLAogI
CJDcmVhdGVkIjogIjIwMjItMTAtMThUMTI6NDg6MTJaIn0"},
"4cr4Tfdt6bmIeyMlXDHuwY3vnfc938xH2aISXnh7L_HrElngjJ87lcdV
WIBekCVdYRVISDvOCWs9FraK6TYgsIU7FhLHSFjXQFyI1YReGmfVTt07qc0LTgOHa
6Vtbnem_83kVTUvO6Mx6vJf0cHPfYTxUkbvyXFA1X_r0nUTnltvSkyuJW0UvhTZrH
Oe8SS8qkZ05gLiacjfnnXnButKip7UZvUFCntOpvHwMrUOQB1i5MnRIi9lalfmjY5
UexyFDPppwu_DieKAzBVTNP_PF_axtvY9siLYyGM6doOPDtiWHoaeg44G10R7codn
pgZIUiHjU912rIXhKJsX2AZNQhbXuyXX3Pzru16nCD31awOqh4ByJLCu77lhgEbDW
Jq6vXaaBmVuBKNTsWZJv85ae2Fw0MtFu17NqCGzcV4YWtz1Mp_5PkG6nuuVL-SSWs
Xyu-1zzWld4tOZO-VCRF6a5jHfeDu4OZTfOU2gNqR5g3uB2xr8Hnku_M8J11OtbGR
TO8rLDB-eh5N9e1rj3AEosqTBxt6h2GIyV6rnwpa30bGcyqUm_zbJB6NzIetwDypK
6e3fd8OQtddvpoBSUc0MlQKXU1sacQdz8Bwim-0k7MJ0uo9UOonrlXm-F3O93krXr
lcm_KAJ4C6yHjOzco8FeoHIzPGoNUP5vR4NbyzFpXxe3YLAXbKNmV3mXF90cVatzO
rlSt0xCqs6fmV1ZzhZca-1giPryqPrJfAQeMnm19aAqObY9mJq72-B-qc9L6fEq1c
S4svatmp0bZd2CNf07yKEWALstitJsLZFuAYh7dwqtE-9AuTukZrs8AM6uLxlpDVh
Y8VHFnYRPbqo_xe1q9H7rapq_taPO536CLzb7qkdN7jR0fJqfnVYt8FtST3eG0KrN
iA3qAOWBqSenklpdyGnIsjumLGWrD0kra6uJlu-D8RdZ96dzDpioyncPi4AP3Yc9-
4jsVBVrpNKhCd0ULXKXx_2TfYsPG-oyNrj8d1tPXptqzVZ4RubB3vcMNb7SuEk2DU
ykflvwOgYbyamN_Bv2MQZPcjT0PMGfdg1OKJVrBZW5TeECH_bH6BY8iZhnrq4sj8K
t0GosuvhNBhOaQr348MQrzSagCJzWqwl8-JRjxn0-2hWb-wYYKaV2fqSicMUWxzaZ
TQH08RC6UpZXJ4przc3370HyggyJoPOAsWiqEI-BCnDzL_G1_Jrv1Dl5awozDD3JR
g3aOabvSOsCQm3vfrDPQ6f7q5S0bHLUC7WuMhgafDQUPCzgiuehbti4ZP09C38yZ0
wBynOUk6Z4le9kkwHQiWMiwVMMt4c9MfbZl3uOhW0DqI86Vz99Gj3l1QBbh3kXPQ-
0RgcCqM8-0RSYriPjYEOyTgQ0X5dqHqhHcg94mMV0D29gEQnX8m7rIc0m0Pzbr0Fm
dgI9Omm_PNCm9liTNS7nK2dh_AogEZ2SyiCK9p7Ytxn6-ZP4USeG5Svc1jrWqw0pd
wcUhETxud6-SKmcdbf_0ywautJ8s99iJd9m7MABvmOK3WzTRlkfKlPAn_8w8YJ6XN
qEaOxScYYgZUw72QHfyX-kwvc-R86v-5aDO6oS3Pn-iK4MUlWdmeryXaTeGVneUf5
v_kFwMT2P5e2U3ucnxBDTRvjkhlmz_zgMM4exZzY_5M0QONHAtBx3k_fKd26hTT9t
Nd11PqWZdSR8j0gzYhU9xX4G4PGgJ8djNsAiC9U1DnKHiSMOfLfgjnM7C_Gvt6CpS
Q8GWIF2e_qA5bCAE5ffi-VQ4IJZzYKNTql0UQcS053av0VeqYQ6IixrRzxLPfZtk2
iPVuFzvmxgj9TKHA2i0kjI6KEjQ9O-bcpldSeokQ3zyzjNarmeT1pkRVd3O0GnMFJ
2yQAD3ci-dl10HYQ2hqs5ibZNdtvLKAq1Oqr6yz9w2T3EXpdUCHPQsiJJzpxbq8BU
F8zaaSEkYFc1fFYn7M81LqXEX8WCgAtGclsN6nTUkMdrSfbsllYsIzPohhVCbPelw
7zcIb-WBM9ToK58IX2hLMbyVCw6BabJhWNW_9kbhXwowduqzY2UuaTFND1iD_ZJDT
m5HyZTS3OWM2S6TfbobLKePYWdTgBgnScrl87gaA-rXBH7O_oj3rhFP2YgxUObDln
ZtP1YAqumSyM9F1RGh1b-ypoL0OSYbADZkAhVjRLfJQFK1VWZuyRVWxEoQMnS2EYh
Yxjqm-9LS7IMQQbXwSvDKb14eiWMVOCunckRIHVEETbuCog6741tsHfe91Rj4wlCd
V1rXfdaMAWj5M0YYlmhStPfLnPSOC7Qh0KlAMi2907XOpCS21qAeKJJsQVkWxyl0D
psNu0btd-kUKZhYvSXzlv0JeP6jEFj0mkm4ga8BnTtug_qzJWON-dbHQzKrEYX0SK
CQOxclCAtYXRzmzHHYcKkz4AG0jN8ENGtSGR9pwUcvNOBbBQtUF5UaFwJrJKjhRYJ
MbrYttQI-KeSy5nJpYqe2G485j9pO_NgasWxhmmdSoKFoamPUOC-SNxwLz4t_vKFq
ginV1JW5Vstr4CY4MtaFtVGfLHfGU9BEm6eBoxeRJFZGuuA6ImPRK1vGDXokMXSBf
s0FMUSbAUOinegK64Kai-htnlaAFa3zlBI08ha3oz5aSlCP952w_xHKL7l2bvxlyH
y4Kz7aP1L5R7iUWp2_e5XJHTmXduZOM-FnDq2SwVMVjzlawXU2BKCfxMaxy0TBpyv
h6x23WrIEHUy6l52lD6tz2Kv8ZEM7NapZIaELmDT9dva1gv7VEjNI1rMyVhqb2LJp
0KIK_d0wXAKrhziRBLpAWsUNRb6sXEioroPJO1AhgKVu4LB61_s1FUxPESHtHoFtZ
ZppzhTZsit5AgaDUW8gtRF6oSa4MqQ1Ag3EF9Ft3OP7MDZoENIlp8_wOsmF_mLdjH
gh4KDQOeLCIdMJUOh_fzHVRWQw0llQGL7KLuXSZNyahkWzINY6ezEMlZ_qyH3Uf0o
Blxu5K4RYiNVWzd2-IH7zcb80DtLwzEcnHaWRaePs_p112UrSZjiH2jVr5UkF3wyG
AD6q4X3HTDRt0YQ9F3bJn-ZoPQG-RrJGDYAkKOtDwc_ZIZwQhFAN05_CnLErIV_Vx
n8l1sFRPISaq3kb7YJCrKo8r5UbYyJpvtxKy8ONiaSjaXtCfXzDrBqTz7iK-aa-PC
P3SL6wFVCtS_MokaR-V2HLiq7sbql3BAdFXCoVuYVjhuplUoDXlZQVLiFme4r9Iqv
vXSn-Oq8gY0pugF9p5_BvIB14bBTyG1AV2R-G6iRpi1OtlKL_hupGS3apTOaLrixz
UXAaaVr4MDTx20qXT7TU0n25UJUKljhjfMi6h2skESHk38N5UbsXPrItwbXSLI_xo
DzJBvv4pF0d15WEzYkTq3fFLvAlIwQytEPkdedQQ6nlpbKpPwuaA6c4w9K5FZXiI6
C8E5TH4WOCtJbXnIic0AZzZs-2FczysmPkgUNnpvRH6rxCYyTNsrs4CjTtRknUYw7
vG0TeZY4z16V_g0O0fuMH-zt1Imi9Ai3yReOkHjwKhM8picScVlGQIzhjSGrWvPhw
TMySwkKNaYXGh_Q-JwUvXRei-fxsIVBrX_hGy6qC9z5hXVRVOjcsISXIg2cWkkbG7
uy8Ec9fRpvD78w8Xlh6HavVUDA4sF0iQ5bMb8HqkWOeXI9-0fRSCW3OUgsJZRNttx
jAWsZEyTJhXZbFC1O3Yq0_8jor8HgMxQhxjoMnou9K5yhGqhtOP17ehp2IP2vZMoh
HNhYyLOpsczPOwPc0mCN72k0l-O9ULp-rcyuDEtzjL5Q_ww9iOCOf2Etj0uLfi9-M
LbXBcPxd3Qa4YgG9_d3UWlumbnwYyi-mMRVj3If0O0xCYCLuZJyPwTyww4n3SqV65
2CqcW6wmzuERHqh5QgHx1uTOMXAhif6nVSEI-yavYp9V6-gvs1Ko3h6Afvig_Po7o
nnfw5GaR0SBqxVKPpfBemBhj08wxIhXKG-lzH1SDs-kxlTp5fEUfxlG-Jje92vKT-
9qfZnsbgqzt8RZgGMWfT4niXWkRaEr3UCFhZKUag8LGMkAKlZUwPpLV3OhAP2JInm
dbVPM45Ik-YKHTxOFTw1Y81RqrwY68srtpLAyJUMapcEW9hhNeVohIiWpER9Ph-tS
vusuW5MuoQx_PT7UdksDZNB3lS-5BamgJJ8_NFlWnmHzmHgz2DKaJ7hhk5M9zDp7r
yHXPfZfIsqz4t-NJ3ksH9-1KdZaD4JSzPmTLpLKBwzZNuazwgnRrGeCjlzFP4Puil
uALZzizswiGz_HCRFQuNeuphoR1uxqvW8il8DFwsx8JLbkV95knOIOLHhh7Ngbjtg
XZrMnFKydMqtayhuZdsGtNrOJdwWXkcGKJ1sSxnuWfcETksxGi_JWKKdLLUhjM20a
3n4Zc7PRILlIWLkN-3aKNJSCmgW35wnf6Ud4_jd9uzMxOfGKdYkNXejXQC-BQ8PfX
DyrMO6ewBqk1zTGtax8Z-PHIKeGs7-9HQdOT2Qmb7xZ2yuPftSMbcgcqBBJ7bvdVy
mYOjU0vKgviZ58uWoxIEBly1084O1YqUW-vxFaMgKjQUSa6tTknGDV3vePo4oPl8d
4deApD0VOmdId1qv1Vmn7LBeqi8yi1SGByXmqxJGsdXQK0vyTxN6LDYygKSlIih00
l7W7WaSzYVurDamjPqah9tuPcVapx95SmM3H3MgZQvvs_XXAILTEsD-XaJhyCnwPc
evaYDRpbiE4bAQf0XzmoVmltJCKzxSPJQ7GQ2SUsf6tgRKVDW7e75Aiw4F6JZq41q
WujNjje_O-n_xs1YgP6ehVbbFoUkBVKAZGhVhk0TAU3xs_YNArqMG64XS4N-NPCEL
uB2oIzQormfJ2wQVMlnbRilD6eFlffs6hAhlcrj_22phrChU8puFA2X4P9TncV_7B
rqOW-4xji5Lm9POzZ7fCtS0lNR0E5hPGgCM3Ynp_mq_IdMgiLM9Q_vU_aucvxpE5T
vs-hewsKtoC04EYwocaMEqN7hx-Z2Wl_bLHqXtLmoTUjiiucijYdj8k8yJN9hrJeF
Ek_98Sw5zgbn17yNGuLDFxdc0Nmvg-RenFy8_Mhd8kAWqSu5zxR_XLtPBQUe5yWzD
h_THfxdYMQI1OxcB1noMNrpXn8EatP_jRS49zBAeiI4WkUh0z0vqyTJorCymglpBr
lCcSv6c_o5l-sN75VXzsE-o2xntI-aQdcbj_IdaqKPoS06ETgH9wUOTRYr19JTm-G
kqMR3nsPnsSfN9yJqAatoYuI9GAKYLyZ1JLnshVbzuEWYNFoYEfqYJvuSs1ENLKKv
TiFB4fzVIfEiUqxcKJv7Grff8veOUAnG_HHheuSkHybDTKvuBbETaXyJ9zbuXB-8p
lmgusNtjzYVCaXJ66SSYHhaiRDsNd90aC2wD7APaNNSGOJC_lbQIOiUlk1En149t4
NI4yAKXyVIoheueT3lZHrDll-6cW0Gj41HiRucAiIx1AWDbTIvUvgM-_R_ctyXqkm
-WrH6lHiOSjE-KVqn8ccsjieI2PzSI4TV4RVUBca3VGXG1_7Sm-IqU-EBYUzghSnt
-tgg4fkMvjfuHwWY8UVcvmchQva6Jju0ol2hickgzJ1E_-rmKoRcRROn5tC6Bw9p2
iQ7PycDrQlq-S4uyZZoP_u1uBRG4IoYvDaw5w4MOB8GSvTGXqmn2nqNeSwlUBQZQO
qJi6IQ8lh0TkpERM-sh6qn9Xg37_4l2qONMeHD0dKuqzb907dFddTCdONi6NUUJV9
DkI6mTdHqNUtPbc3F6foHiVY4aoZhkyErQmFqLJdkBYb0o1tfuS_6AlZksQMS3yQG
CODRGJJpjvePdbaz_95muJFIt_28zUA9XmHE6o8uQuWI2pRdC6RJHsOTfb6jpAUe9
i25xO0DAaeI2tzoaOe6-IOLxzrIwAPSOSCfKepDQIZLn8enEpZ7no1an4JyDvzdH7
91dfV6j6sv6TcmWdykRXutWa9m2vh-ZZMM5p2CIlaOeIlzqXwYPIp53B9UkD-SrzE
oTdVQZ7Ay6xz7lw8kV5tlgqYSA9di8c5piEW0l6QYWIqS6I6XP886EFwmdzoUdu2u
qh905LDXsKk7Q9CJXligCKdWQY3QXwNlX0lEPbNf2pRpqwh_tPD017Tt2BQT5oeJU
kugXUqNXlbpvM1VG2AsaortWvErVc5IFnjQMbzfm6nww0nY-6RyXL5zWHYRs-CbQq
-eeIpSINpUS3cVDwcodsxIGHsRg82ZSqtTrOd5fmISk1Y7syiq51QgknY2eHyGpLy
zX7ZMbPM2ahjpEgtXr66FeKaKRN6xH33Xe087cWyy1Y8JjLywHPble8_Hdikm95C8
tBuMcHWjVYz-6lTCNFMc7R6NscrFmtcIf6woxrQoXLaSaucToKwD9ErMhGNWMInnV
oM_amSyg_s6JOiQ6iIzEPucidDkmyYgBokfkjubWxagepeaZzsmzccVjfNdziWQ0B
EYituLNnjmvMZncqaVJwUz39Ajf3gUzGnkBSAn6RsppytcDr41miK8TH_BU_1xRJh
u1TesiSKVmKxJiQ8ajIbjcvCCzogeJdVnoxTNMvaHMCjcoYWBZDYa1VvhRNfRL3Wm
elzFAlyc_F2KOP_cAmuK2Hb1o2t1QYXFLmk93P2P-5YssVrx_Hu16Vg4tG9O2fHcb
fJS4TbBCOO8fEtXmMKwTGYXsIPo5V6UIe9UyO5Gt4W5TSpU7eAQwE7Q3D_n1tiKet
uH2r-1v1zvv5aASPJaxCtkGz3rvrGvRbmVab3oFQoJHHC1w3UEXZQcGDSttEtyQiM
J9WyFG16F2YR_3DQPAAzSoq5p2n-d8SoJ6hj9NX-Hl7AoAfbr94FdR7yJsMbCGxoc
9R5-LWrpbf9xLQXO3gF2rR7rkrfl2JseCxDEtXcg5VvqwReyFRsRPCKdFepJZShBz
qOl1WIN4peOGLBioLb6kKVai1UMjcYADWslwpDMMlppJK5kO0OfigpuA2QnYu02Gz
9DlGr4o4IF7Mdfhfgq1GlJm1Y6RR8bOWrYJgGzEl4SZWOfZa9il0ixwrNSSWmDsah
1_pKBtdK0vs1jZFBHo70NQ35fwEMTE6kMLWNg33aQWG-qP-np3isvimb4s1q2NkX7
lVwa3Ffe0M7pNnPuNg-XoQTXiN0LwIkxi2qLXSCJ8NUTXja5FGllwTlXC0o6TGoXJ
3w_9zu8QrjQGUJIz2eyAsAK9LcjJ19IxPFLRJnJZMgivI6v5ik1EuM5KhrRbS7RuF
EYixvf_W_DNEstVi900y7N5xJXm2qKowv3bdyRFpZ9tAWiz2JAp-83Z-vyqjmkV_F
5ypR4S47PpXLtVn4pWDsEezPAN2W0rfv1zOtKItFS0vEKw5tKFPZ0TH3PPrBbeNKM
Ss3a-KPWpo9RuZWZ2riAngaNOsiEy_M-kZeoSIvFP3iQR-wytDzb__ucOJljM4wTF
aqdHTyWxNJuSVYwJX-R2MJfzmQrZWV3WJejjdGYrE4CfBsNbKnMNKFKEXX7m2jfmc
kIu6xvGDbdTffIHK8gX5AihicrWduDx6CaBnQn8Pal-7OfCP6BC331dAM4Nhl6Jct
JlHms6x94-VN8k5J3OaxzPoTQvxtDArW5b6PYoObd06FRAtGlyXY33kOIfAjYgetc
haR-Eax5GpyqjlE20KjmWcxxrrAeAdQtKG-iFtCzZnRyauiPQyBdyzfSNZX3AbY5S
gx1NZaaE803uVcHiHZR9rpFTLEBOLNhoc9aKv1_S1QUGpGLvqVTIyqJe-McNyRuFi
GRR7Q0VW4rPkLTiI3ItB4ToDXBgA9ZmjQI80JYmb9n5SfNb4d0m42ba6ioNEseSR1
USlnrCKFzngTzQ9W3rEgx9TobckBxInlSw_KfWEPNj3gyu4tWDCpvJAlp8ylVgirX
QMFAdwiY_6ZSFst1N6C-CUy6iL4zT5NUCyUBd-cp-JxFkFji3HmGIm7dSMls08RbP
kLimCmCi-ajI2QAFiPncL0DOV8k1bJBIsGxXAX8gLxFk-VBJ0GWQWyAvuP7razfJy
9cUzKGejg1LOBHYR11kbWIHTkv-vZFLlLd9wpCJvaLQ1e8E-GdqEuXmkdaRVUESZ0
2y7eYyCkHLztg1dh2POGb58107lf6tw4Xxc6BH4ag85kMPy5m5_8w9PHctC2DKNs3
8x5Uw3peH_dGv0dE-q5BnLeyqxx2omc8f-GUAmHGMIoEkZ8_rmtI8e_T1TergTHg7
e70Q5U8n-TRR7H5stHvbtb0MDrjCDMrXKvpTcwNgP6qu_TQd1ecJI9bz4II5rxLUR
koWajOu7IZlpnwJiQ_MZEepFiXfs7fVBA1-VHKohWa-lh-l8ZMCKXVpXGiHtfZOU3
q-kvuoUNC3hBP8glDEjhvRBiReld3YIhohIJ12vuM-5PSqbNK8oUzAdPvAsTs5Q0W
TiVVW4f4LFeuCkrjcpaQqCSqcBEeFCoYHRULpKrfmxVhL9dn9Gy0geF6wU7WP5kFi
LkkEv_tbzFWJzjy5nBuSuPbZ8IEwFSjnACAxTlGYo7j-dzPiaPmXluNrFaFQb7RVH
nbL3bSeKamz5b2NdWIRUAWpso-g",
{
"signatures":[{
"alg":"S512",
"kid":"MBFM-XW2H-CBLT-AMNQ-ZWVZ-USGI-KOGI",
"signature":"vN5BI47huQJGHzBkY5q_YRlNcJv5FmRXmtoXf7
cE0bWEcG-AZV_8k4JjahnS3SjMLXabTykfx6mASSfJlDS1S18dJUawx43EIGNwrK3
tUV6Ru-_mFdWi7TFVugiFyssWFbyQEziHFEiwFtm7DV2hYC4A",
"witness":"ZTO-tTTEJ4IaIAZ6OtN1btJ3QGkc-IodiU_hpG4k
wqc"}
],
"PayloadDigest":"jr16SNuo6R7iqlW4U2mSpk_cSYI_MiA3gifwcA
0guHxMVwitUD5hJc85vtDtlHIjyoAdy3asUAH-8LAsJqhq3A"}
],
"ApplicationEntries":[{
"ApplicationEntrySsh":{
"EnvelopedActivation":[{
"enc":"A256CBC",
"kid":"EBQE-HQVJ-QA7H-YAGO-BYU4-IH6Z-Z2SL",
"Salt":"MiurURI50odmcsi7P3DXNg",
"recipients":[{
"kid":"MBVR-KCMF-U3C5-43SH-VER4-SDCJ-RSBC",
"epk":{
"PublicKeyECDH":{
"crv":"X448",
"Public":"e5XJxceDPi9gehCuXBP78pMjEdIzn3h
oBKjY_CFLaRkDkubOnlaMJEgIHJdoehqahSwBAePycqMA"}},
"wmk":"IF3NM39bgLesLGkme8oZvno1CLSv8QoIKwCneV
_opNIRtJEj7qlS6g"}
],
"ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJBY3
RpdmF0aW9uQXBwbGljYXRpb25Tc2giLAogICJjdHkiOiAiYXBwbGljYXRpb24vbW1
tL29iamVjdCIsCiAgIkNyZWF0ZWQiOiAiMjAyMi0xMC0xOFQxMjo0ODoxM1oifQ"},
"HtAMxJPSGlfWHo-mCyOQpqlOnoxkIAekUwi3OVuNWH4Ov04H9d
-6G_4igTDlXoLNBE_LjYLII63111ZztfqWFby4TsGsrIuKBI4_Q2XRSyKW7C9XiXx
PA5ekcXkkPRoejcd7QBay30HeQ_FuvmDvxMg4Z_94CTOUn2B3eCOCqiFOyugAks5E
FB87h5lDghu1QWLCdUq6RVGdvx9TIFqtM3EizOElzDyjGHSbMFcXQPozC7cIUXBPV
TZWEW-IuhAmABlArk788ksniY1-8Bta1mxeavOoZOYF09LSJCYXVZK-6yBODFTPIb
NE4gjS15OB6lcNP_06zrb9b3jD3Ossb3PQUyyi1AMV1s98YhkcLeQVdA3fFIZQzLm
6TMc0ns22e1KmAjO8yFY-PlkWA5WtyhIcvfO4AH6bDJTIhnq8IGbhDd3JZx2DRqpc
vJVxayf8uYkzFs6AkGiy0f3mdcG8eI_Gr__4jgEMQrjK53UZrWkMnSDggZSA7LUxK
IuMNcz68UBQ5WZSv1wNv6WprTUljLdTQZru34wC2pdhZ3cSNyAzojBlOBSviWeJPv
56Olftb7yLfcLmMPOtX3OUbMTrFYaL4ElTzJRm6QBOj-GxF8K9Omhzo8RCNrwydh6
US4H130GtSA3Eop76vVRNRYbVDX7hWdZVWB-un0bd0UFWh8nBj_KtEsrkr_ezS02x
5o7hhPUT9mEAgZc2fYDBeaY3pCcOzMR7Mivo3TrKcU2YmbrU4wVR2skzvp75aR13h
wD3u_de5Vy75WHFTPF0mAkaoZJU8SQDVOwHfIiTh88_DRWmXDu8p_acNH2aTfiWeP
ZV5cPcDLj-Y3tpXphG0OohJgyRKcLpMCLyvo35nzp60E7CcPE_EnHtO-K_HzoOGi4
i1wY5_eVetceYuDVvbc8gl1iAIslipSAsHtCGzJH51ClLfP-xwKWp8iYkqt6E4Skx
OO7uVB8BgtP-H-ShtTNziQ-vjJIv-Y-_xC1Da4ycXHd-0-eMeKpxenl5BMecm_IOA
EnRnxhDGEGUs4Ahqe-KkdGVTPT3Epvt2lLYBAiRBiyyBsMgThMp_2wjdWMfU7v5FI
We_HU-kK3lnU-U8ZooBzkz0wIZll0RE2ExxIfUzHczJ2Myy3JbwrCqmGPB42F4Kel
yJfNP4BjY5_tsmd5Qozboedqg-Fi4zcxe4Va5hraW3NVH1aGC1GwTXBDWyCIXUkop
m-FCJsCAUmer2HbzLMYDUWUshIKs0uPyTaJLl5LitxKVoEwYhyvyf6gVvcT_gimV0
_BmBvxKL2egKYAhiur07p3ZgxDC_V39Q2iC0AwnWuz3PveXYBEBfHNpaeVZ0b3OU7
hqVQPKj1T92y5GcPzPMFwIvA9xQuAefBaEtauBOg8toQSZ0-IwztfWqlagJ3z-4BK
EdIVE5-vISJNLRxbMEy9NgsiPH9dIPQDXBU2JuRsTdbOeMlBhagkm2-s__ceNaLyZ
qRAuAgWEFvQBTIphxq3BElqlWPF-_FO2irodSr2aMBMyTJ6qNnLEbpEcXrrry0aUh
7_ahyF1kGJGHfEcz0uVmNoB_Rn9nbme7Xdk4Xt3GhSyjZ6qVFoagG6Zk9HYElUUsm
YLcLStX803M-YpwaNIcvmQPGDglYuX4M4rDJHrWaTxNbCJ5V2YAz2BsggzFE39zTC
6TfU3E5o8eqU1V9zuX9gwfibFDsYmi9QcIgBzhFC8-8bJ6U-5qqMn_8r9HCYkIN1C
me6ToSrRrKt5bnaDEkjdDq-5CtOD-TOlV1M3lApq4fbbETj8DL_RN3hBFJgimMfqO
yiMP0aSit2g6Xa3vbT5jrjWGHUK5dNMNTDJL37sKV7hvx7S9uPe8msUKo_foBSG9k
u9kSHQpz_vz_M1HZvaic7AORi_4DxVXwCIuvP2rQO1HvoSORdZz_ccI3dux2qBZUr
kppLHDzVwSOl82rWdkwqzZh8cZCLXsEryWw5bj-tlZG45ja3quZxpPgvsTPtZQaPY
LXxQBNRPM-vTUKRrwRyhu_E65mIO9QUKfDJzESCdfAFCyt-xbxajOS7IdQUw2MpWV
PnCq-GjrGaTV1roiJHBE0uKiH89FaWcbVYzqk5jTVQZxZWLrWbFXShR-hohJtumD6
rqqmiJWucDuAJSy-4oRJk2A6YRZII5YtIrm0u4cY-g5TFbZWOhrAOHrAv7MAn37bm
31L8nXxCivFzOLpfPF0tL1HzfMO8WBq7ppXymXTHeISqjn2brLCA_5qS2GxaqqIly
r7jg4-aNQk9SiT-G1tP8yjd9NBKGDji2Fd8Til6Khrlx1OhZubpaInDFrlt7mRTuG
zYkoZm4TCUCBqg-kekRGbdfsKNBTNDVMuUKxZNzuQsP42F2xReOcumzXZIyAk0g8Z
cD21dCxwBLa8o21bdYHZVOajcT3wM-mTL3eLoKHz9FgNCQwlWoh8XGuJhFr86zZxP
dZoD8GwkkaVwwx7rcgQVPmYZdIKuXtCqe4264yu7QfiB31WswRrd2nPz76hqKhfSc
cLHHt-HAkqTSp862OxaQVDnj9YNEpqhY5CO8vNKwzOPJVj6u3WbivCWf_bmgE3oqO
Oeyhzt9RkXmrq5yIyAgoVv7LSOqoW1j2butgtPUqw7RPB-WKoI9V0zXnUUsANmBlJ
015hLEzWhA8bWvWdN1QSURIe02cXEHUGli-_s5Ke-p05ynuTh5yPeQ7g5-KLJbZ2u
qVCYdGR7zo5bF1aZDb5S_NMh2wph22V75xFV1Vzh0Z8inKKnvjLEzDESWskzCH0kA
Y2S-qHq4kvMBD_XxTjbVa0a3tkChvoDjDa9kzzbdc9tfIbw9cHNZ4Dbz85KCLvv6J
rbFfnpL1htS7cd_cFNVlsqkt1GQD33XPL5UwGnp7G2JKqtnnnH4NyhuVIw18IufG1
1rNh1MxoWAJ9wvAE0U9s0vHZaBcwUF4fuW3H3uu-_8k1RrwKau-bnMUwT1ReYcuEU
pW4-q8n3PCwfJETrUNzZEaW8990rwuE7iu4xz0N1ZStDMwI2bEyK1fGT_EY1szHLh
AV-NZt0RvQfMtEgItLISaEnDRFSCePMP3ywokIAF4lfwO8MfTGkTop6HVGTJ79AxX
o7qPMpcV_lnGPB_NqmxZ_jWwXmqzx2D-YQ0xAokurDGod-Kev1zjJqEf1YhBlqDQT
Lfo_y1ClnZljTl7NmCmVc_fY6LOOgTfSU70IQRP6VOIYOAGBq594Ef0PEcjn23Ovx
tZqHXVGpRXPLp8XS-fyrnxVS6QjTAkzO3G19UoSl24gT5ODyJXqVfkG6UksJC2R-G
fqePYy7gMSqFyotbRuYBC4q60YOf"
],
"Identifier":"MDCT-IRNQ-JDWH-IRIP-FZK2-YP4G-5MGS"}}
]},
"MessageId":"MBI3-QJW4-3BIO-7SBZ-PEJP-E7NX-3W7E"}}¶
The device periodically polls for completion of the connection request using the Complete transaction.¶
To provide a final check on the process, the command line tool presents the UDF of the account profile to which the device has connected if successful:¶
Alice3> meshman device complete Device UDF = MDVU-AOST-TDIH-AXGE-WUJS-I56V-WJP3 Account = alice@example.com Account UDF = MDRR-5W72-3RJO-VZB3-VUVQ-IOEC-6UNA Alice3> meshman account sync¶
The completion request specifies the witness value for the transaction whose completion is being queried:¶
{
"CompleteRequest":{
"AccountAddress":"alice@example.com",
"ResponseID":"MBI3-QJW4-3BIO-7SBZ-PEJP-E7NX-3W7E"}}¶
The Service responds to the complete request by checking to see if an entry has been added to the local spool. If so, this contains the RespondConnection message created by the administration device.¶
The preconfigured device connection interaction is used to connect devices that lack affordances such as a display or a keyboard. It is also known as the static QR code interaction because a static QR code printed on the device itself is used to connect it to a user's account.¶
Future: Note that this interaction is likely to be changed substantially in future revisions of the specification and the Claim/PollClaim mechanism removed and replaced with a messaging based approach.¶
The interaction has five phases:¶
The device to be onboarded is preconfigured with a ProfileDevice and private key information and a DeviceDescription posted to a publication service. This process is typically performed during manufacture. An EARL providing the ability to locate and decrypt the description is printed on the device itself as a QR code.¶
The administration device acquiring the onboarding device scans the QR code on the device and uses this information to obtain the device description by means of a Claim operation described above as described in the Device Description.¶
This phase is performed in the same manner as the Dynamic QR Code (PIN) Authenticated interaction except that the administration device MAY advise the device that a connection request is being made by additional means described in the device description (e.g. WiFi, Bluetooth).¶
When connected to a network, the preconfigured device periodically attempts to poll the connection sources specified to find out if there is a pending request. If a connection request is posted, the device decrypts it to allow it to complete the connection process.¶
This phase is performed in the same manner as the Dynamic QR Code (PIN) Authenticated interaction except that the administration device requires notice that of the pending connection request.¶
The main differences between this connection interaction and the witness/PIN connection interactions are that the device is preconfigured with the device profile at the time of manufacture and the onboarding device MAY be acquiring network configuration information during the connection process.¶
The manufacturer preconfigures the device¶
Maker> meshman device preconfig Device UDF: MALQ-6D3Y-ERRF-TIFW-36LR-6GJK-4OZI File: ED6B-KIW3-TSCC-P4LM-4D3I-IAPD-LE.medk¶
This results in the creation of a primary secret which is used to compute a ProfileDevice and corresponding connection records signed by the manufacturer's administrator key.¶
The data is combined to create a DevicePreconfiguration record that is provisioned to the firmware of the device being preconfigured.¶
{
"DevicePreconfigurationPrivate":{
"EnvelopedConnectionDevice":[{
"dig":"S512",
"ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJDb25uZWN0aW
9uRGV2aWNlIiwKICAiY3R5IjogImFwcGxpY2F0aW9uL21tbS9vYmplY3QiLAogICJ
DcmVhdGVkIjogIjIwMjItMTAtMThUMTI6NDg6MTdaIn0"},
"ewogICJDb25uZWN0aW9uRGV2aWNlIjogewogICAgIlNpZ25hdHVyZSI6IH
sKICAgICAgIlVkZiI6ICJNQkZPLVdNN0stSTdDNy1ZUVNVLUNJVVotSlFFUC1USDR
RIiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tl
eUVDREgiOiB7CiAgICAgICAgICAiY3J2IjogIkVkNDQ4IiwKICAgICAgICAgICJQd
WJsaWMiOiAiWXcwcnhJMWZZTlpnRFA1ZGwtTkRPZ05GVF9TLVVaUGpLYTBvWWJvRE
xUakpRTXFWVWFJOQogIGYzMFRDS29FX2NEcUd4ck11VUlYUTRvQSJ9fX0sCiAgICA
iRW5jcnlwdGlvbiI6IHsKICAgICAgIlVkZiI6ICJNQjYzLU1BR04tRVNOVy1OR0tI
LUZQWFotSVNHTC1PTE9XIiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgI
CAgICAgIlB1YmxpY0tleUVDREgiOiB7CiAgICAgICAgICAiY3J2IjogIlg0NDgiLA
ogICAgICAgICAgIlB1YmxpYyI6ICJfNjZDY1VSdThYTlFXT3hXZm5fTVdkRVVXMmx
paVRXVUtNeHVla3R1ZWoxOEltbnlXb1NJCiAgNkp6UGMwVWpYZWRKZUhnNm5IazhO
bUtBIn19fSwKICAgICJBdXRoZW50aWNhdGlvbiI6IHsKICAgICAgIlVkZiI6ICJNQ
jYzLU1BR04tRVNOVy1OR0tILUZQWFotSVNHTC1PTE9XIiwKICAgICAgIlB1YmxpY1
BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tleUVDREgiOiB7CiAgICAgICA
gICAiY3J2IjogIlg0NDgiLAogICAgICAgICAgIlB1YmxpYyI6ICJfNjZDY1VSdThY
TlFXT3hXZm5fTVdkRVVXMmxpaVRXVUtNeHVla3R1ZWoxOEltbnlXb1NJCiAgNkp6U
GMwVWpYZWRKZUhnNm5IazhObUtBIn19fX19",
{
"signatures":[{
"alg":"S512",
"kid":"MCBJ-UITH-2BQD-PX3A-SR3Z-S4UV-BNWK",
"signature":"TpL0FOcO64HC2B13c-uQrBqlZtXFzPxvsznY9sb_
sKosFnrjmlhBQNR55A58DgxRiinXtHTnOqqAZAHcnDVcdgnAQV9qY9znPNzsDVmjN
3EmXr9R1fNtJU_vhLzJKk6jQc1Wp5GCygtwSQNRsaTjFjQA"}
],
"PayloadDigest":"eajU4hdXOEvO8gdTYhwG33txVBGqZFp2PyD4WtE5
mCRi2ZZ5w0K5r6HciY6zlqas4-6-dxb5XMAQ3S3gcYJtNg"}
],
"EnvelopedConnectionService":[{
"dig":"S512",
"ContentMetaData":"ewogICJNZXNzYWdlVHlwZSI6ICJDb25uZWN0aW
9uU2VydmljZSIsCiAgImN0eSI6ICJhcHBsaWNhdGlvbi9tbW0vb2JqZWN0IiwKICA
iQ3JlYXRlZCI6ICIyMDIyLTEwLTE4VDEyOjQ4OjE3WiJ9"},
"ewogICJDb25uZWN0aW9uU2VydmljZSI6IHsKICAgICJBdXRoZW50aWNhdG
lvbiI6IHsKICAgICAgIlVkZiI6ICJNQjYzLU1BR04tRVNOVy1OR0tILUZQWFotSVN
HTC1PTE9XIiwKICAgICAgIlB1YmxpY1BhcmFtZXRlcnMiOiB7CiAgICAgICAgIlB1
YmxpY0tleUVDREgiOiB7CiAgICAgICAgICAiY3J2IjogIlg0NDgiLAogICAgICAgI
CAgIlB1YmxpYyI6ICJfNjZDY1VSdThYTlFXT3hXZm5fTVdkRVVXMmxpaVRXVUtNeH
Vla3R1ZWoxOEltbnlXb1NJCiAgNkp6UGMwVWpYZWRKZUhnNm5IazhObUtBIn19fX1
9",
{
"signatures":[{
"alg":"S512",
"kid":"MCBJ-UITH-2BQD-PX3A-SR3Z-S4UV-BNWK",
"signature":"nsQ8vwj0eO4OgnmHKe1IDjmB_yW9vJFl7eXWVVcI
Q5aHBGEUiVtqHbcnED3VNWZDwUYb3KavpuSAcdy8rgGRQVXtrDbT59EQupuwx2sKA
Nx4ifkwM4z1_FmJdv4QJxGM0Zoh0Qcx5omEGnLxJCyjPAEA"}
],
"PayloadDigest":"v7-o_VKzsUxg2rb3_mg9MTRA8-_9C-0ZJLv2SzZn
0j2FIGl28RV4TXpDPieXTXBnHAtjrJePIxWM_tQKEHmz9g"}
],
"PrivateKey":{
"PrivateKeyUDF":{
"PrivateValue":"ZAAQ-BVPA-BOCZ-6SIX-ZZP3-GP3R-ETLG-BBKB-2YD
M-WPNI-5RXJ-CVG2-4G5Z-GUCM",
"KeyType":"MeshProfileDevice"}},
"ConnectUri":"mcu://maker@example.com/ED6B-KIW3-TSCC-P4LM-4D3I-
IAPD-LE",
"EnvelopedProfileDevice":[{
"EnvelopeId":"MALQ-6D3Y-ERRF-TIFW-36LR-6GJK-4OZI",
"dig":"S512",
"ContentMetaData":"ewogICJVbmlxdWVJZCI6ICJNQUxRLTZEM1ktRV
JSRi1USUZXLTM2TFItNkdKSy00T1pJIiwKICAiTWVzc2FnZVR5cGUiOiAiUHJvZml
sZURldmljZSIsCiAgImN0eSI6ICJhcHBsaWNhdGlvbi9tbW0vb2JqZWN0IiwKICAi
Q3JlYXRlZCI6ICIyMDIyLTEwLTE4VDEyOjQ4OjE3WiJ9"},
"ewogICJQcm9maWxlRGV2aWNlIjogewogICAgIkVuY3J5cHRpb24iOiB7Ci
AgICAgICJVZGYiOiAiTUI2My1NQUdOLUVTTlctTkdLSC1GUFhaLUlTR0wtT0xPVyI
sCiAgICAgICJQdWJsaWNQYXJhbWV0ZXJzIjogewogICAgICAgICJQdWJsaWNLZXlF
Q0RIIjogewogICAgICAgICAgImNydiI6ICJYNDQ4IiwKICAgICAgICAgICJQdWJsa
WMiOiAiXzY2Q2NVUnU4WE5RV094V2ZuX01XZEVVVzJsaWlUV1VLTXh1ZWt0dWVqMT
hJbW55V29TSQogIDZKelBjMFVqWGVkSmVIZzZuSGs4Tm1LQSJ9fX0sCiAgICAiU2l
nbmF0dXJlIjogewogICAgICAiVWRmIjogIk1CRk8tV003Sy1JN0M3LVlRU1UtQ0lV
Wi1KUUVQLVRINFEiLAogICAgICAiUHVibGljUGFyYW1ldGVycyI6IHsKICAgICAgI
CAiUHVibGljS2V5RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAiRWQ0NDgiLAogIC
AgICAgICAgIlB1YmxpYyI6ICJZdzByeEkxZllOWmdEUDVkbC1ORE9nTkZUX1MtVVp
QakthMG9ZYm9ETFRqSlFNcVZVYUk5CiAgZjMwVENLb0VfY0RxR3hyTXVVSVhRNG9B
In19fSwKICAgICJBdXRoZW50aWNhdGlvbiI6IHsKICAgICAgIlVkZiI6ICJNQUNEL
TNSSUItRjJMTy1HTFhKLVJJT1MtNzJaVC1FVVA0IiwKICAgICAgIlB1YmxpY1Bhcm
FtZXRlcnMiOiB7CiAgICAgICAgIlB1YmxpY0tleUVDREgiOiB7CiAgICAgICAgICA
iY3J2IjogIlg0NDgiLAogICAgICAgICAgIlB1YmxpYyI6ICJHNXQ0OEVHYnJTbWU5
YWMxSGhseHFzaUYyemVRN2pmcV8tZkI1a0wxam1ac0NxN1ZmS2VKCiAgNjM3eHVwb
ENjOFlFMEp2V2R6RFlCR0tBIn19fSwKICAgICJQcm9maWxlU2lnbmF0dXJlIjogew
ogICAgICAiVWRmIjogIk1BTFEtNkQzWS1FUlJGLVRJRlctMzZMUi02R0pLLTRPWkk
iLAogICAgICAiUHVibGljUGFyYW1ldGVycyI6IHsKICAgICAgICAiUHVibGljS2V5
RUNESCI6IHsKICAgICAgICAgICJjcnYiOiAiRWQ0NDgiLAogICAgICAgICAgIlB1Y
mxpYyI6ICIxVUp6VzBBc1hMbkd4UjhqVGozUzM3VUtIQVRSdmlLWnpvUXJwWEZ6eS
0tdUctaGwyUUlvCiAgaWRZck1kYm1zZ1MzWlNCSkRpSXRsQTRBIn19fX19",
{
"signatures":[{
"alg":"S512",
"kid":"MALQ-6D3Y-ERRF-TIFW-36LR-6GJK-4OZI",
"signature":"nM9Y8MDljAp7Bms8jCNdgpZqpC-Q7uVBH6EfiNf7
dH4zAJ8g3ee24DDpWGGkaIUYTjixCqyH_8uAxNLMwWhRGzmipnwEUy20UmrjMBjqI
hu2TshN1yrC5VtftF-AK5JEg0dnJsZuIuT4bro50ON7OAMA"}
],
"PayloadDigest":"jLTOUGaU-Y26uQ6Xczvc-ycCrD-4vfT3Ud0RLH35
b2hm1dvcF2Iy-F4A9Jx8u3OPSjkQ1WePfCDfw4hUzQUcHQ"}
]}}¶
An EARL is created specifying the means by which an administration device can acquire the information required to complete a connection to the device:¶
QR = {Connect.ConnectEARL}¶
The preconfigured ProfileDevice is encrypted under the encryption key and published to the location key derived from the EARL.¶
The administration device scans the QR code and obtains the Device Description using the Claim operation as shown in section $$$$. The administration device creates the ActivationDevice and CatalogedDevice records and populates the service as before.¶
Alice> meshman account connect ^
mcu://maker@example.com/ED6B-KIW3-TSCC-P4LM-4D3I-IAPD-LE /web
¶
Every Mesh Portal Service transaction consists of exactly one request followed by exactly one response. Mesh Service transactions MAY cause modification of the data stored in the Mesh Service or the Mesh itself but do not cause changes to the connection state. The protocol itself is thus idempotent. There is no set sequence in which operations are required to be performed. It is not necessary to perform a Hello transaction prior to any other transaction.¶
A Mesh Portal Service request consists of a payload object that inherits from the MeshRequest class. When using the HTTP binding, the request MUST specify the portal DNS address in the HTTP Host field.¶
Base class for all request messages.¶
[No fields]¶
Base class for all request messages made by a user.¶
The fully qualified account name (including DNS address) to which the request is directed.¶
The identifier of the capability under which access is claimed.¶
Device profile of the device making the request.¶
A Mesh Portal Service response consists of a payload object that inherits from the MeshResponse class. When using the HTTP binding, the response SHOULD report the Status response code in the HTTP response message. However the response code returned in the payload object MUST always be considered authoritative.¶
Base class for all response messages. Contains only the status code and status description fields.¶
[No fields]¶
The Mesh Service protocol makes use of JSON objects defined in the JOSE Signatgure and Encryption specifications and in the DARE Data At Rest Encryption extensions to JOSE.¶
The following common structures are used in the protocol messages:¶
Describes a Key/Value structure used to make queries for records matching one or more selection criteria.¶
Specifies constraints to be applied to a search result. These allow a client to limit the number of records returned, the quantity of data returned, the earliest and latest data returned, etc.¶
The container to be searched.¶
Only return objects with an index value that is equal to or higher than the value specified.¶
Only return objects with an index value that is equal to or lower than the value specified.¶
Only data published on or after the specified time instant is requested.¶
Only data published before the specified time instant is requested. This excludes data published at the specified time instant.¶
Specifies a page key returned in a previous search operation in which the number of responses exceeded the specified bounds.¶
When a page key is specified, all the other search parameters except for MaxEntries and MaxBytes are ignored and the service returns the next set of data responding to the earlier query.¶
Specifies constraints on the data to be sent.¶
Maximum number of entries to send.¶
Specifies an offset to be applied to the payload data before it is sent. This allows large payloads to be transferred incrementally.¶
Maximum number of payload bytes to send.¶
Return the entry header¶
Return the entry payload¶
Return the entry trailer¶
Describes the account creation policy including constraints on account names, whether there is an open account creation policy, etc.¶
Specifies the minimum length of an account name.¶
Specifies the maximum length of an account name.¶
A list of characters that the service does not accept in account names. The list of characters MAY not be exhaustive but SHOULD include any illegal characters in the proposed account name.¶
The entries to be uploaded.¶
Report service and version information.¶
The Hello transaction provides a means of determining which protocol versions, message encodings and transport protocols are supported by the service.¶
The PostConstraints field MAY be used to advise senders of a maximum size of payload that MAY be sent in an initial Post request.¶
Contains a proposed callsign binding to the account.¶
Specifies the default data constraints for updates.¶
Specifies the default data constraints for message senders.¶
Specifies the account creation policy¶
The enveloped master profile of the service.¶
If the request specifies a callsign binding, returns a proposed binding for the requested callsign.¶
Request binding of an account to the service. This method is called during account creation and binding.¶
The operation is called Bind rather than Create because the account is created by the user, not the service.¶
Request binding of an account to a service address.¶
Reports the success or failure of a Create transaction.¶
Text explaining the status of the creation request.¶
A URL to which the user is directed to complete the account creation request.¶
The enveloped assignment describing how the client should discover the host and encrypt data to it.¶
Request deletion of a service account.¶
Request creation of a new portal account. The request specifies the requested account identifier and the Mesh profile to be associated with the account.¶
[No fields]¶
Reports the success or failure of a Delete transaction.¶
[No fields]¶
Request information necessary to begin making a connection request.¶
The account profile providing the root of trust for this account.¶
The catalog device entry¶
The enveloped assignment describing how the client should discover the host and encrypt data to it.¶
Request objects from the specified container with the specified search criteria.¶
Request objects from the specified container(s).¶
A client MAY request only objects matching specified search criteria be returned and MAY request that only specific fields or parts of the payload be returned.¶
Specifies constraints to be applied to a search result. These allow a client to limit the number of records returned, the quantity of data returned, the earliest and latest data returned, etc.¶
Specifies the data constraints to be applied to the responses.¶
Return the set of objects requested.¶
Services SHOULD NOT return a response that is disproportionately large relative to the speed of the network connection without a clear indication from the client that it is relevant. A service MAY limit the number of objects returned. A service MAY limit the scope of each response.¶
The updated data¶
Attempt an atomic transaction on the containers and spools associated with an account.¶
Upload entries to a container. This request is only valid if it is issued by the owner of the account¶
The data to be updated¶
The account(s) to which the request is directed.¶
The messages to be sent to other accounts¶
Messages to be appended to the user's inbound spool. this is typically used to post notifications to the user to mark messages as having been read or responded to.¶
Messages to be appended to the user's local spool. This is used to allow connecting devices to collect activation messages before they have connected to the mesh.¶
Response to an upload request.¶
The responses to the entries.¶
If the upload request contains redacted entries, specifies constraints that apply to the redacted entries as a group. Thus the total payloads of all the messages must not exceed the specified value.¶
The index value of the entry in the request.¶
The index value assigned to the entry in the container.¶
Specifies the result of attempting to add the entry to a catalog or spool. Valid values for a message are 'Accept', 'Reject'. Valid values for an entry are 'Accept', 'Reject' and 'Conflict'.¶
If the entry was redacted, specifies constraints that apply to the redacted entries as a group. Thus the total payloads of all the messages must not exceed the specified value.¶
Request to post to a spool from an external party. The request and response messages are extensions of the corresponding messages for the Upload transaction. It is expected that additional fields will be added as the need arises.¶
[No fields]¶
Claim a publication¶
The claim message¶
The encrypted device profile¶
Check party making claim¶
The claim message¶
[No fields]¶
[No fields]¶
[No fields]¶
Perform a set of cryptographic operations¶
The service account the capability is bound to¶
[No fields]¶
The security considerations for use and implementation of Mesh services and applications are described in the Mesh Security Considerations guide [draft-hallambaker-mesh-security].¶
All the IANA considerations for the Mesh documents are specified in this document¶
A list of people who have contributed to the design of the Mesh is presented in [draft-hallambaker-mesh-architecture].¶