Bootstrapping Remote Secure Key Infrastructure (BRSKI) Cloud Registrar

Introduction Bootstrapping Remote Secure Key Infrastructures (BRSKI) specifies automated and secure provisioning of nodes (which are called Pledges) with cryptographic keying material (trust anchors and certificates) to enable authenticated and confidential communication with other similarly enrolled nodes. This bootstrapping process is also called enrollment. In BRSKI, the Pledge performs enrollment by communicating with a BRSKI Registrar belonging to the owner of the Pledge. The Pledge does not know who its owner will be when manufactured. Instead, in BRSKI it is assumed that the network to which the Pledge connects belongs to the owner of the Pledge and therefore network-supported discovery mechanisms can resolve generic, non-owner specific names to the owner's Registrar. To support enrollment of Pledges without such an owner based access network, the mechanisms of BRSKI Cloud are required, which assume that Pledge and Registrar simply connect to the Internet. This entire work is an update to . Specifically, it extends to describe describes how a Pledge may contact a well-known URI of a Cloud Registrar if a local Registrar cannot be discovered or if the Pledge is deployed in a network that does not include a local Registrar. This kind of non-network onboarding is sometimes called "Application Onboarding", as the purpose is typically to deploy a credential that will be used by the device in its intended use. For instance, a SIP phone might have a client certificate to be used with a SIP proxy. This document updates by clarifying operations that are left out of scope in . Two modes of operation are specified in this document. The Cloud Registrar can choose between redirecting the Pledge to the owner's Registrar, or it may issue a voucher to the Pledge that includes the domain of the owner's Enrollment over Secure Transport (EST) server.

Terminology The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 when, and only when, they appear in all capitals, as shown here. This document uses the terms Domain, Pledge, Registrar, MASA, and Voucher from and .

Cloud Registrar:: The default Registrar that is deployed at a URI that is well known to the Pledge.
Cloud VAR Registrar:: The non-default Registrar that is operated by a value added reseller (VAR).
CSR:: Certificate Signing Request
DHCP: refers to DHCPv4 or DHCPv6 .
EST:: Enrollment over Secure Transport .
IDevID:: An initial device identity certificate as described in
LDevID:: A local device identity certificate as described in
Local Domain:: The domain where the Pledge is physically located and bootstrapping from. This may be different from the Pledge owner's domain.
Manufacturer:: The term manufacturer is used throughout this document as the entity that created the Pledge. This is typically the original equipment manufacturer (OEM), but in more complex situations, it could be a value added retailer (VAR), or possibly even a systems integrator. Refer to for more detailed descriptions of manufacturer, VAR and OEM.
OEM:: Original Equipment Manufacturer. The company that manufactured the device.
Owner:: The owner is the organization that has purchased the new device (the pledge). The device might be deployed in a network that the owner does not control.
Owner Delegate:: The owner delegate is an entity distinct from the Owner that has been contracted to operate/manage the devices in question. For instance, an IT maintenance and support-desk company.
Owner Domain:: The domain that the Pledge needs to discover and bootstrap with.
Owner Registrar:: The Registrar that is operated by the Owner, or the Owner's delegate. There may not be an Owner Registrar in all deployment scenarios.
Pledge operator:: The person or organization that removes the device from the shipping box and connects power and network to it.
Provisional TLS:: A mechanism defined in whereby a Pledge establishes a provisional TLS connection with a Registrar before the Pledge is provisioned with a trust anchor that can be used for verifying the Registrar identity.
SIP:: Session Initiation Protocol defined in
VAR:: Value Added Reseller. A VAR will often collect products from many OEMs, creating a complete solution, and then sells that composite solution to end customers. A VAR will often need to provision products to operate in a specific manner. For instance, a VoIP phone might have SIP functionality as well as MGCP functionality, but in a particular deployment, only one will be used.

Use Cases This document specifies procedures for two high-level use cases.

Bootstrap via Cloud Registrar and Owner Registrar: The operator-maintained infrastructure supports BRSKI and has a BRSKI Registrar deployed. More details are provided in .
Bootstrap via Cloud Registrar and Owner EST Service: The operator-maintained infrastructure does not support BRSKI, does not have a BRSKI Registrar deployed, but does have an Enrollment over Secure Transport (EST) service deployed. More detailed are provided in .

There are existing DHCP options that network operators use to configure devices such as a VoIP phone. This includes DHCP options 66 , 150 (TFTP/HTTP server names) , and 120 (SIP Server) , which inform a VoIP phone about how to do application onboarding. A network with an operator that is able to provision these options would also be able to use BRSKI without changes. Such a network has no need for the mechanisms described in this document! Where the need for the mechanism is needed is to allow the use of BRSKI in many small sites, such as teleworkers working from home, with minimum expectations against their network infrastructure. In particular, the home office user is not qualified or authorized to change DHCP options for the local network. The procedures defined in this document support situations where a Manufacturer sells a number of devices (in bulk) to a Value Added Reseller (VAR). The Manufacturer knows which devices have been sold to which VAR, but not who the ultimate owner will be. The VAR then sells devices to other entities, such as enterprises, and records this in the VARs Cloud Registrar. Specifically, the VAR will record that a specific device has been sold to an enterprise, and will know that when this device bootstraps, it should be redirected to the enterprise's Owner Registrar or Owner EST Service. One example is a VoIP phone Manufacturer provides telephones to a local system integration company (a VAR). The VAR records this sale in its Cloud VAR Registrar system. The VAR has sold a VoIP system to an enterprise (e.g., a SIP PBX). When a new employee needs a phone at their home office, the VAR ships that unit across town to the employee. When the employee plugs in the device and turns it on, the device will be provisioned with a LDevID and configuration that connections the phone with the Enterprises' VoIP PBX. The home employee's network has no special provisions. The procedures defined in this document also support a chain of VARs through chained HTTP redirects. This also supports a situation where in effect, a large enterprise might also stock devices in a central location. The Pledge is not expected to know whether the operator-maintained infrastructure has a BRSKI Registrar deployed or not. The Pledge determines this based upon the response to its Voucher Request message that it receives from the Cloud Registrar. The Cloud Registrar is expected to determine whether the operator-maintained infrastructure has a BRSKI Registrar deployed based upon the identity presented by the Pledge. A Cloud Registrar will receive BRSKI communications from all devices configured with its URI. This could be, for example, all devices of a particular product line from a particular Manufacturer. When this is a significantly large number, a Cloud Registrar may need to be scaled with the usual web-service scaling mechanisms.

Bootstrap via Cloud Registrar and Owner Registrar A Pledge is bootstrapping from a location with no Local Domain Registrar (for example, the small site or teleworker use case with no local infrastructure to provide for automated discovery), and needs to discover its Owner Registrar. The Cloud Registrar is used by the Pledge to discover the Owner Registrar. The Cloud Registrar redirects the Pledge to the Owner Registrar, and the Pledge completes bootstrap against the Owner Registrar. This mechanism is useful to help an employee who is deploying a Pledge in a home or small branch office, where the Pledge belongs to the employer. As there is no Local Domain Registrar in the employee's local network, the Pledge needs to discover and bootstrap with the employer's Registrar which is deployed within the employer's network, and the Pledge needs the keying material to trust the Registrar. As a very specific example, an employee is deploying an IP phone in a home office and the phone needs to register to an IP PBX deployed in their employer's office. Protocol details for this use case are provided in .

Bootstrap via Cloud Registrar and Owner EST Service A Pledge is bootstrapping where the owner organization does not yet have an Owner Registrar deployed, but does have an EST service deployed. The Cloud Registrar issues a voucher, and the Pledge completes trust bootstrap using the Cloud Registrar. The voucher issued by the Cloud Registrar includes domain information for the owner's EST service that the Pledge should use for certificate enrollment. For example, an organization has an EST service deployed, but does not yet have a BRSKI-capable Registrar service deployed. The Pledge is deployed in the organization's domain, but does not discover a Local Domain Registrar or Owner Registrar. The Pledge uses the Cloud Registrar to bootstrap, and the Cloud Registrar provides a voucher that includes instructions on finding the organization's EST service. This option can be used to introduce the benefits of BRSKI for an initial period when BRSKI is not available in existing EST Servers. Additionally, it can also be used long-term as a security-equivalent solution in which BRSKI and EST Server are set up in a modular fashion. The use of an EST Server instead of a BRSKI Registrar may mean that not all the EST options required by may be available and hence this option may not support all BRSKI deployment cases. For example, certificates to enroll into an ACP needs to include an AcpNodeName. See , which non-BRSKI-capable EST Servers may not support. Protocol details for this use case are provided in .

Architecture The high-level architectures for the two high-level use cases are illustrated in and . In both use cases, the Pledge connects to the Cloud Registrar during bootstrap. For the first use case, as described in , the Cloud Registrar redirects the Pledge to an Owner Registrar in order to complete bootstrap with the Owner Registrar. When bootstrapping against an Owner Registrar, the Owner Registrar will interact with a CA to assist in issuing certificates to the Pledge. This is illustrated in .

Architecture: Bootstrap via Cloud Registrar and Owner Registrar | MANUFACTURER On-site Cloud +--------+ +-----------+ | Pledge |------------------------------------------| Cloud | +--------+ 307 redirect | Registrar | | +-----------+ | | +-----------+ +-----------+ +---------------->| Owner |-----------------| MASA | VR-sign(N) | Registrar |sign(VR-sign(N)) +-----------+ +-----------+ | +-----------+ +----| CA | +-----------+ ]]> As depicted in and , there are a number of parties involved in the process. The Manufacturer, or Original Equipment Manufacturer (OEM) builds the device, but also is expected to run the Manufacturer Authorized Signing Authority (MASA), or arrange for it to exist. The interaction between the Cloud Registrar and the MASA is described by . In the two signatures that the Pledge and the Owner Registrar place on the Voucher Request (VR) are shown as VR-sign(N) and sign(VR-sign(N)) This is as described in . There are also signatures from Pledge to Cloud Registrar and to MASA in , but they are omitted as they would make the diagram too busy. For the second use case, as described , the Cloud Registrar issues a voucher itself without redirecting the Pledge to an Owner Registrar. The Cloud Registrar will inform the Pledge what domain to use for accessing EST services in the voucher response. In this model, the Pledge interacts directly with the EST service to enroll. The EST service will interact with a CA to assist in issuing a certificate to the Pledge. This is illustrated in .

Architecture: Bootstrap via Cloud Registrar and Owner EST Service | MANUFACTURER On-site Cloud +--------+ +-----------+ | Pledge |------------------------------------------| Cloud | +--------+ referral via est-domain | Registrar | | +--+--------+ | | BRSKI-MASA | +--+--------+ | | MASA | | +-----------+ | +-----------+ +-----------------| EST | | Server | +-----------+ | +-----------+ +--->| CA | +-----------+ ]]> It is also possible for the Cloud Registrar to redirect the Pledge to another Cloud Registrar operated by a VAR, with that VAR's Cloud Registrar then redirecting the Pledge to the Owner Registrar. This scenario is discussed further in and . The mechanisms and protocols by which the Registrar or EST service interacts with the CA are transparent to the Pledge and are outside the scope of this document. The architectures show the Cloud Registrar and MASA as being logically separate entities. The two functions could of course be integrated into a single entity. In the two use cases, there are different mechanisms for a Cloud Registrar to handle voucher requests. It can redirect the request to the Owner Registrar for handling, or it can return a voucher that includes an "est-domain" attribute that points to the Owner EST Service. When returning a voucher, additional bootstrapping information can be embedded in the voucher using the additional-configuration-url attribute. The contents of this additional configuration are device and Manufacturer specific. Both mechanisms are described in detail later in this document. The network operator or enterprise is the intended owner of the new device: the Pledge. This could be the enterprise itself, or in many cases there is some outsourced IT department that might be involved. They are the operator of the Registrar or EST Server. They may also operate the CA, or they may contract those services from another entity. There is a potential additional party involved who may operate the Cloud Registrar: the value added reseller (VAR). The VAR works with the OEM to ship products with the right configuration to the owner. For example, SIP telephones or other conferencing systems may be installed by this VAR, often shipped directly from a warehouse to the customer's remote office location. The VAR and manufacturer are aware of which devices have been shipped to the VAR through sales channel integrations, and so the manufacturer's Cloud Registrar is able to redirect the Pledge through a chain of Cloud Registrars, as explained in .

Network Connectivity The assumption is that the Pledge already has network connectivity prior to connecting to the Cloud Registrar. The Pledge must have an IP address that is able to reach a recursive DNS server, and be able to send requests to the Cloud Registrar. There are many ways to accomplish this, from using routable IPv4 or IPv6 addresses, to use of NAT44, to using HTTP or SOCKS proxies. The Pledge operator has already connected the Pledge to the network, and the mechanism by which this has happened is out of scope of this document. For many telephony applications, this is typically going to be a wired connection. For wireless use cases, existing Wi-Fi onboarding mechanisms such as can be used. Similarly, what address space the IP address belongs to, whether it is an IPv4 or IPv6 address, or if there are firewalls or proxies deployed between the Pledge and the cloud registrar are all out of scope of this document.

Pledge Certificate Identity Considerations specifies that the Pledge MUST send an EST Certificate Signing Request (CSR) Attributes request to the EST server before it requests a client certificate. For the use case described in , the Owner Registrar operates as the EST server as described in , and the Pledge sends the CSR Attributes request to the Owner Registrar. For the use case described in , the EST server operates as described in , and the Pledge sends the CSR Attributes request to the EST server. Note that the Pledge only sends the CSR Attributes request to the entity acting as the EST server as per , and MUST NOT send the CSR Attributes request to the Cloud Registrar, because the Cloud Registrar does not have authority to issue a certificate for the customer domain. (The Cloud Registrar is not a full EST server) If a Pledge erroneously sends a CSR Attributes request to the Cloud Registrar, then the Cloud Registrar MUST reply with 404 response code. The EST server MAY use this mechanism to instruct the Pledge about the identities it should include in the CSR request it sends as part of enrollment. The EST server MAY use this mechanism to tell the Pledge what Subject or Subject Alternative Name identity information to include in its CSR request. This can be useful if the Subject or Subject Alternative Name identity must have a specific value in order to complete enrollment with the CA. EST is not clear on how the CSR Attributes response should be structured, and in particular is not clear on how a server can instruct a client to include specific attribute values in its CSR. clarifies how a server can use CSR Attributes response to specify specific values for attributes that the client should include in its CSR. For example, the Pledge may only be aware of its IDevID Subject which includes a Manufacturer serial number, but must include a specific fully qualified domain name in the CSR in order to complete domain ownership proofs required by the CA. As another example, the Registrar may deem the Manufacturer serial number in an IDevID as personally identifiable information, and may want to specify a new random opaque identifier that the Pledge should use in its CSR.

YANG extension for Voucher based redirect contains the two needed voucher attributes: est-domain and additional-configuration-url which are needed when a client is redirected to a local EST server.

Protocol Operation This section outlines the high-level protocol requirements and operations that take place. outlines the exact sequence of message interactions between the Pledge, the Cloud Registrar, the Owner Registrar and the Owner EST server.

Pledge Sends Voucher Request to Cloud Registrar

Cloud Registrar Discovery BRSKI defines how a Pledge contacts a well-known URI of a Cloud Registrar if a Local Domain Registrar cannot be discovered. Additionally, certain Pledge types might never attempt to discover a Local Domain Registrar and might automatically bootstrap against a Cloud Registrar. The details of the URI are Manufacturer specific. If the Pledge fails to connect to the Cloud Registrar for any reason, it should consider that this is a bootstrapping failure, and indicate this.

Pledge - Cloud Registrar TLS Establishment Details According to , the Pledge MUST use an Implicit Trust Anchor database (see EST ) to authenticate the Cloud Registrar service. The Pledge MUST establish a mutually authenticated TLS connection with the Cloud Registrar. Unlike the Provisional TLS procedures documented in , the Pledge MUST NOT establish a Provisional TLS connection with the Cloud Registrar. Pledges MUST and Cloud/Owner Registrars SHOULD support the use of the "server_name" TLS extension (SNI, ) when using TLS 1.2. Support for SNI is mandatory with TLS 1.3. Pledges SHOULD send a valid "server_name" extension (SNI) whenever they know the domain name of the registrar they connect to. A Pledge creating a Provisional TLS connection according to will often only know the link-local IPv6 address of a Join Proxy that connects it to the Registrar. Registrars are accordingly expected to ignore SNI information, as in most cases, the Pledge will not know how to set the SNI correctly. The Pledge MUST be manufactured with preloaded trust anchors that are used to verify the identity of the Cloud Registrar when establishing the TLS connection. The TLS connection can be verified using a public Web PKI trust anchor using DNS-ID mechanisms or a pinned certification authority. This is a local implementation decision. Refer to for trust anchor security considerations. The Cloud Registrar MUST verify the identity of the Pledge by sending a TLS CertificateRequest message to the Pledge during TLS session establishment. The Cloud Registrar MAY include a certificate_authorities field in the message to specify the set of allowed IDevID issuing CAs that Pledges MAY use when establishing connections with the Cloud Registrar. In addition to other protections against DoS attacks, the Cloud Registrar is able to reject TLS connections when it can determine during TLS authentication that it cannot support the Pledge. For example, the Pledge cannot provide an IDevID signed by a CA recognized/supported by the Cloud Registrar.

Pledge Sends Voucher Request Message After the Pledge has established a mutually authenticated TLS connection with the Cloud Registrar, the Pledge generates a voucher request message as outlined in , and sends the voucher request message to the Cloud Registrar.

Cloud Registrar Processes Voucher Request Message The Cloud Registrar MUST determine Pledge ownership. Prior to ownership determination, the Registrar checks the request for correctness and if it is unwilling or unable to handle the request, it MUST return a suitable 4xx or 5xx error response to the Pledge as defined by and HTTP . The Registrar returns the following errors:

in the case of an unknown Pledge, a 404 is returned.
for a malformed request, 400 is returned.
in case of server overload, 503 is returned.

If the request is correct and the Registrar is able to handle it, but unable to determine ownership at that time, then it MUST return a 401 Unauthorized response to the Pledge. This signals to the Pledge that there is currently no known owner domain for it, but that retrying later might resolve this situation. In this scenario, the Registrar SHOULD include a Retry-After header that includes a time to defer. The absence of a Retry-After header indicates to the Pledge not to attempt again. The Pledge MUST restart the bootstrapping process from the beginning. A Pledge with some kind of indicator (such as a screen or LED) SHOULD consider all 4xx and 5xx errors to be a bootstrapping failure, and indicate this. If the Cloud Registrar successfully determines ownership, then it MUST take one of the following actions:

error: return a suitable 4xx or 5xx error response (as defined by and HTTP) to the Pledge if the request processing failed for any reason.
redirect to Owner Registrar: redirect the Pledge to an Owner Registrar via 307 response code.
redirect to Owner EST server: issue a voucher (containing an "est-domain" attribute) and return a 200 response code.

Pledge Ownership Look Up The Cloud Registrar needs some suitable mechanism for knowing the correct owner of a connecting Pledge based on the presented identity certificate. For example, if the Pledge establishes TLS using an IDevID that is signed by a known manufacturing CA, the Registrar could extract the serial number from the IDevID and use this to look up a database of Pledge IDevID serial numbers to owners. The mechanism by which the Cloud Registrar determines Pledge ownership is, however, outside the scope of this document. The Cloud Registrar is strongly tied to the Manufacturers' processes for device identity.

Bootstrap via Cloud Registrar and Owner Registrar Once the Cloud Registrar has determined Pledge ownership, the Cloud Registrar MAY redirect the Pledge to the Owner Registrar in order to complete bootstrap. If the owner wants the Cloud Registrar to redirect Pledges to their Owner Registrar, the owner must register their Owner Registrar URI with cloud Registrar. The mechanism by which Pledge owners register their Owner Registrar URI with the Cloud Registrar is outside the scope of this document. In case of redirection, the Cloud Registrar replies to the voucher request with an HTTP 307 Temporary Redirect response code, including the owner's Local Domain in the HTTP Location header.

Bootstrap via Cloud Registrar and Owner EST Service If the Cloud Registrar issues a voucher, it returns the voucher in an HTTP response with a 200 response code. The Cloud Registrar MAY issue a 202 response code if it is willing to issue a voucher, but will take some time to prepare the voucher. The voucher MUST include the new "est-domain" field as defined in . This tells the Pledge where the domain of the EST service to use for completing certificate enrollment. The voucher MAY include the new additional-configuration-url field. This field points the Pledge to a URI where Pledge specific additional configuration information SHOULD be retrieved. For example, a SIP user agent (a UA, such as a desk phone) might retrieve a Manufacturer specific configuration file that contains information about how to do SIP Registration. One advantage of this mechanism over current mechanisms like DHCP options 120 defined in or option 125 defined in is that the voucher is returned in a confidential (TLS-protected) transport, and so can include device-specific credentials for retrieval of the configuration. The exact Pledge and Registrar behavior for handling and specifying the additional-configuration-url field is outside the scope of this document.

Pledge Handles Cloud Registrar Response

Bootstrap via Cloud Registrar and Owner Registrar The Cloud Registrar has returned a 307 response to a voucher request. The Cloud Registrar MAY be redirecting the Pledge to the Owner Registrar, or to a different Cloud Registrar operated by a VAR. The Pledge MUST restart its bootstrapping process by sending a new voucher request message (with a fresh nonce) using the location provided in the HTTP redirect. The Pledge MUST attempt to validate the identity of the Cloud VAR Registrar specified in the 307 response using its Implicit Trust Anchor Database. If validation of this identity succeeds using the Implicit Trust Anchor Database, then the Pledge MAY accept a subsequent 307 response from this Cloud VAR Registrar. The Pledge MAY continue to follow a number of 307 redirects provided that each 307 redirect target Registrar identity is validated using the Implicit Trust Anchor Database. The Manufacturer MAY enforce a Manufacturer-specific limit on the number of 307 redirects that the Pledge will follow. The Pledge MAY be redirected to an Owner Register that then redirects the Pledge via a 3xx response. The Pledge MUST follow the rules outlined in for any redirections other than 307 and MUST NOT follow more than one non-307 redirection (3xx code other than 307) to another web origin. However, if validation of a 307 redirect target Registrar identity using the Implicit Trust Anchor Database fails, then the Pledge MUST NOT accept the 307 responses from the Registrar. At this point, the TLS connection that has been established is considered a Provisional TLS, as per . The Pledge then (re)sends a voucher-request on this connection. As explained by , the connection is validated using the pinned credential from the voucher. The Pledge MUST process any error messages as defined in , and in case of error MUST restart the process from its provisioned Cloud Registrar. The exception is that a 401 Unauthorized code SHOULD cause the Pledge to retry a number of times over a period of a few hours. In order to avoid permanent bootstrap cycles, the Pledge MUST NOT revisit a prior location on the same attempt. If a loop is detected, then the Pledge MUST abort the current attempt, returning to the initial state where it looks for local Registrars (as per ), starting again with the initial Cloud Registrar if none are found. further outlines risks associated with redirects. However, in some scenarios, Pledges MAY visit the current location multiple times, for example when handling a 401 Unauthorized response, or when handling a 503 Service Unavailable that includes a Retry-After HTTP header. If it happens that a location is repeated, then the Pledge MUST fail the bootstrapping attempt and go back to the beginning, which includes listening to other sources of bootstrapping information as specified in section 4.1 and 5.0. The Pledge MUST also have a limit on the total number of redirects it will follow, as the cycle detection requires that it keep track of the places it has been. That limit MUST be in the dozens or more redirects such that no reasonable delegation path would be affected. When the Pledge cannot validate the connection, then it MUST establish a Provisional TLS connection with the specified Local Domain Registrar at the location specified. The Pledge then sends a voucher request message via the Local Domain Registrar. After the Pledge receives the voucher, it verifies the TLS connection to the Local Domain Registrar and continues with enrollment and bootstrap as per standard BRSKI operation. The Pledge MUST process any error messages as defined in , and in case of error MUST restart the process from its provisioned Cloud Registrar. The exception is that a 401 Unauthorized code SHOULD cause the Pledge to retry a number of times over a period of a few hours.

Bootstrap via Cloud Registrar and Owner EST Service The Cloud Registrar returned a voucher to the Pledge. The Pledge MUST perform voucher verification as per . The Pledge SHOULD extract the "est-domain" field from the voucher, and SHOULD continue with EST enrollment as per standard EST operation. Note that the Pledge has been instructed to connect to the EST server specified in the "est-domain" field, and therefore SHOULD use EST mechanisms, and not BRSKI mechanisms, when connecting to the EST server.

Protocol Details

Bootstrap via Cloud Registrar and Owner Registrar This flow illustrates the "Bootstrap via Cloud Registrar and Owner Registrar" use case. A Pledge is bootstrapping in a remote location with no Local Domain Registrar. The assumption is that the Owner Registrar domain is accessible, and the Pledge can establish a network connection with the Owner Registrar. This may require that the owner network firewall exposes the Owner Registrar on the public internet. | | | | 2. Voucher Request | |------------------------------------------------>| | | | 3. 307 Location: owner-ra.example.com | |<------------------------------------------------| | | | | +-----------+ +---------+ | | Owner | | MASA | | | Registrar | | | | +-----------+ +---------+ | 4. Provisional TLS | | |<-------------------->| | | | | | 5. Voucher Request | | |--------------------->| 6. Voucher Request | | |------------------------->| | | | | | 7. Voucher Response | | |<-------------------------| | 8. Voucher Response | | |<---------------------| | | | | | 9. Verify TLS | | |<-------------------->| | | | | | 10. EST enroll | |--------------------->| |<---------------------| ]]> The process starts, in step 1, when the Pledge establishes a Mutual TLS channel with the Cloud Registrar using the IDevID certificate and the trust anchors created during the manufacturing process of the Pledge. In step 2, the Pledge sends a voucher request to the Cloud Registrar. The Cloud Registrar determines Pledge ownership look up as outlined in , and determines the Owner Registrar domain. In step 3, the Cloud Registrar redirects the Pledge to the Owner Registrar domain. Steps 4 and onwards follow the standard BRSKI flow, which includes doing EST enroll operations. The Pledge establishes a Provisional TLS connection with the Owner Registrar, and sends a voucher request to the Owner Registrar. The Registrar forwards the voucher request to the MASA. Assuming the MASA issues a voucher, then the Pledge verifies the TLS connection with the Registrar using the pinned-domain-cert from the voucher and completes the BRSKI flow.

Bootstrap via Cloud Registrar and Owner EST Service This flow illustrates the "Bootstrap via Cloud Registrar and Owner EST Service" use case. A Pledge is bootstrapping in a location with no Local Domain Registrar. The Cloud Registrar is instructing the Pledge to connect directly to an EST server for enrollment using EST mechanisms. The assumption is that the EST domain is accessible, and the Pledge can establish a network connection with the EST server. | | | | 2. Voucher Request | |------------------------------------------------>| | | | 3. Voucher Response {est-domain:fqdn} | |<------------------------------------------------| | | | +----------+ | | | RFC7030 | | | | EST | | | | Server | | | +----------+ | | | | | 4. Authenticate TLS | | |<-------------------->| | | | | 5a. On success: POST /voucher_status success | | 5b. On failure: POST /voucher_status failure | |------------------------------------------------>| | | | 6. CSR Attributes | | | Request | | |--------------------->| | | 7. CSR Attributes | | | Response | | |<---------------------| | | | | | 8. EST Enroll | | |--------------------->| | | | | | 9. Certificate | | |<---------------------| | | | | | 10. /enrollstatus | | |--------------------->| | ]]> The process starts, in step 1, when the Pledge establishes a Mutual TLS channel with the Cloud Registrar/MASA using artifacts created during the manufacturing process of the Pledge. In step 2, the Pledge sends a voucher request to the Cloud Registrar/MASA. In step 3, the Cloud Registrar/MASA replies to the Pledge with an format voucher that includes its assigned EST domain in the "est-domain" attribute. In step 4, the Pledge establishes a TLS connection with the EST RA that was specified in the voucher "est-domain" attribute. The connection may involve crossing the Internet requiring a DNS look up on the provided name. The resulting IP address can be of any scope: a globally unique IP address, or a local IP address. An IP address literal MAY be used in the est-domain attributes, including a local address that includes an IP address literal including both IPv4 and IPv6 Unique Local Addresses . The Pledge attempts to authenticate the TLS connection and verify the EST server identity. The artifact provided in the pinned-domain-cert is trusted as a trust anchor, and is used to verify the EST server identity. The EST server identity MUST be verified using the pinned-domain-cert value provided in the voucher as described in section 3.3.1. There is a case where the pinned-domain-cert is the identical End-Entity (EE) Certificate as the EST server. It also explicitly includes the case where the EST server has a self-signed EE Certificate, but it MAY also be an EE certificate that is part of a larger PKI. If the certificate is not a self-signed or EE certificate, then the Pledge SHOULD apply DNS-ID verification on the certificate against the domain provided in the "est-domain" attribute. If the "est-domain" was provided with an IP address literal, then it is unlikely that it can be verified, and in that case, it is expected that either a self-signed certificate or an EE certificate will be pinned by the voucher. In steps 5.a and 5.b, the Pledge MAY optionally notify the Cloud Registrar/MASA of the success or failure of its attempt to establish a secure TLS channel with the EST server. This is described in This telemetry returns allow for the Registrar to better provide diagnostics in the event of failure to onboard. if the Pledge fails to verify the identity of the EST server, it MUST drop the connection and MUST NOT continue with a CSR Attributes request or an EST Enroll request. In step 6, the Pledge follows the procedures outlined in and sends a CSR Attributes request to the EST server before sending the EST Enroll request. In step 7, the EST server returns the CSR Attributes response. In step 8, the Pledge sends an EST Enroll request with the CSR. In step 9, the EST server returns the requested certificate. Step 10 is described in as the Enrollment Status Telemetry. This telemetry return also allows for better diagnostics in the event of a failure.

Lifecycle Considerations BRSKI and the Cloud Registrar support provided in this document are dependent upon the Manufacturer maintaining the required infrastructure. outlines additional considerations about Manufacturer life span. Sections 11.5 and 11.6 of outline additional considerations about device trust anchors and how devices establish trust. The well-known URL that is used is specified by the Manufacturer when designing its firmware, and is therefore completely under the Manufacturer's control. If the Manufacturer wishes to change the URL, or discontinue the service, then the Manufacturer will need to arrange for a firmware update where appropriate changes are made. Often the firmware can not be updated because there is significant inventory in a warehouse. If the Pledge were powered on and connected, then it would get firmware updates. Since it is not, any URLs built-in to the old firmware need to be maintained until all copies of that firmware have been replaced. This could be a challenge if a company is going out of business, and in which case the considerations from apply. If a merger between two companies happens, then it is possible to consolidate the MASA of each company into a single system. The consolidated MASA will need access to a MASA signing key for both companies to operate correctly. One way is for both MASA names (such as masa.company1.example, and masa.company2.example) to be added as SubjectAltNames for the HTTPS certificates used by the MASA. The Cloud Registrar will need a similar treatment. As an alternative to operating a Registrar under two names, all access to one Cloud Registrar could be replaced with a 307 redirect as described in . Additionally, in the hosted Registrar use case, with an Owner EST Server use case, the Cloud Registrar MUST know the certificate for the EST Server in order to pin it properly. In that case, when the owner of the EST Server wishes to change their certificate, then they MUST coordinate this with the upstream Cloud Registrar operator.

IANA Considerations This document makes no IANA requests.

Privacy Considerations All privacy considerations outlined in are applicable. There are additional privacy considerations as the Pledge connects to a default Cloud Registrar during bootstrap. In particular, documents the information that is revealed to the MASA. When Pledges use the mechansisms described in this document, a subset of this information is revealed to the Cloud Registrar, namely:

the identity of the device being enrolled
the time the device is activated
the IP address of the device, or if the Pledge is behind a NAT, the public IP of the NAT

Refer to for more comprehensive information.

Implementation Considerations

Captive Portals A Pledge might find itself deployed in a network where a captive portal or an intelligent home gateway that provides access control on all connections are also deployed. Captive portals that do not follow the requirements of Section 1 of might forcibly redirect HTTPS connections. While this is a deprecated practice as it breaks TLS in a way that most users can not deal with, it is still common in many networks. When the Pledge attempts to connect to any Cloud Registrar, an incorrect connection will be detected because the Pledge will be unable to verify the TLS connection to its Cloud Registrar via DNS-ID check . That is, the certificate returned from the captive portal will not match. At this point a network operator who controls the captive portal, noticing the connection to what seems a legitimate destination (the Cloud Registrar), MAY then permit that connection. This enables the first connection to go through. The connection is then redirected to the Registrar via 307, or to an EST server via "est-domain" in a voucher. If it is a 307 redirect, then a Provisional TLS connection will be initiated, and it will succeed. The Provisional TLS connection does not do DNS-ID verification (), so the forced redirection to a captive portal system will not be detected. However, the subsequent BRSKI POST of a voucher request will most likely be met by a 404 or 500 HTTP code. Even if somehow it did work (because the captive portal was in fact an attacker), any returned voucher would not be signed by a trusted MASA. It is RECOMMENDED therefore that the Pledge look for Captive-Portal Identification attributes in DHCP, and if present, use the Captive-Portal API to learn if it is captive. The scenarios outlined here when a Pledge is deployed behind a captive portal may result in failure scenarios, but do not constitute a security risk, so long as the Pledge is correctly verifying all TLS connections as per .

Multiple HTTP Redirects If the Redirect to Registrar method is used, as described in , there MAY be a series of 307 redirects. An example of why this might occur is that the Manufacturer only knows that it resold the device to a particular value added reseller (VAR), and there MAY be a chain of such VARs. It is important the Pledge avoid being drawn into a loop of redirects. This could happen if a VAR does not think they are authoritative for a particular device. A "helpful" programmer might instead decide to redirect back to the Manufacturer in an attempt to restart at the top: perhaps there is another process that updates the Manufacturer's database and this process is underway. Instead, the VAR MUST return a 404 error if it cannot process the device. This will force the device to stop, timeout, and then try all mechanisms again. There are additional considerations regarding TLS certificate validation as outlined in . If the Registrar returns a 307 response, the Pledge MUST NOT follow this redirect if the Registrar identity was not validated using its Implicit Trust Anchor Database. If the Registrar identity was validated using the Implicit Trust Anchor Database, then the Pledge MAY follow the redirect.

Security Considerations The Cloud Registrar described in this document inherits all the strong security properties that are described in , and none of the security mechanisms that are defined in are bypassed or weakened by this document. The Cloud Registrar also inherits all the potential issues that are described in . This includes dependency upon continued operation of the Manufacturer provided MASA, as well as potential complications where a Manufacturer might interfere with resale of a device. In addition to the dependency upon the MASA, the successful enrollment of a device using a Cloud Registrar depends upon the correct and continued operation of this new service. This internet accessible service might be operated by the Manufacturer and/or by one or more value-added-resellers. All the considerations for operation of the MASA also apply to the operation of the Cloud Registrar.

Security Updates for the Pledge Unlike many other uses of BRSKI, in the Cloud Registrar case it is assumed that the Pledge has connected to a network, such as the public Internet, on which some amount of connectivity is possible, but there is no other local configuration available. (Note: there are many possible configurations in which the device might not have unlimited connectivity to the public Internet, but for which there might be some connectivity possible) The Pledge SHOULD NOT assume that the network is protecting the device. In a majority of cases, the Pledge will be connected to a network behind an enterprise firewall, or a home router, with typical restrictions on incoming TCP connections due to NAT44 and , and . In such situations, the Pledge might think it can be assured that it can not be attacked, but this is not the case! Pledges could be deployed on networks

with unfiltered connectivity, including public IPv4 and IPv6
where incoming connections are enabled via explicit rules
where there could be malicious devices within this network

The Pledge SHOULD contact the Manufacturer before bootstrapping in order to apply any available firmware patches. Firmware patches need to validated before being applied. This is best done via signatures on the firmware updates, such as described in or an equivalent mechanism. Origin authentication of updates is also sometimes enough. In order to best protect the Pledge from attacks of all kinds, Manufacturers are encouraged to make MUD files available. Care needs to be taken in those definitions to allow for retrieval of firmware updates. This may also include updates to the Implicit list of Trust Anchors. In this way, a Pledge that may have been in a dusty box in a warehouse for a long time can be updated to the latest (exploit-free) firmware before attempting bootstrapping.

Trust Anchors for Cloud Registrar The HTTPS connections that the Pledge makes to the Cloud Registrar, and any subsequent Registrars that it may be redirected to, MUST be validated using the Implicit Trust Anchor database as described in . Manufacturers MUST include all necessary trust anchors in a Pledge's Implicit Trust Anchor database so that all expected Registrars can be validated. Registars may use public (WebPKI) or private PKI Trust Anchors. While there is no requirement that Registrar's certificates are part of any public (WebPKI) Trust Anchor lists, it may be simpler and cheaper for Registrars to use these easily obtained certificates, rather than use a private PKI. It is recommended for Manufacturers to work with their VARs to determine the subset of publicly trusted (Web) PKI Trust Anchors and / or private PKI Trust Anchors that would satisfy all their VARs, and to ship only that minimal set in the Implicit Trust Anchor database.

Considerations for HTTP Redirect When the default Cloud Registrar redirects a Pledge using HTTP 307 to an Owner Registrar, or another Cloud Registrar operated by a VAR, the Pledge MUST have validated the TLS connection using an Implicit Trust Anchor. However, when connecting to the target Owner Registrar, a provisional TLS connection is required as explained in . Provisional TLS connections are not immediately validated. A provisional TLS connection can be intercepted by an attacker, as unlike in , this connection crosses the Internet. There can be IP address hijacks, possibly DNS attacks that could send the Pledge to the wrong place. Such a diversion would be detected when the resulting Voucher can not be validated. There is a conflict between these requirements: one says to validate, and the other one says not to. This is resolved by having the Pledge attempt validation, and if it succeeds, then and only then, an HTTP 307 redirect will be accepted. If validation fails, then an HTTP 307 redirect MUST be rejected as an error. If that occurs, then the onboarding process SHOULD restart after a delay. This failure should be reported to the initial Cloud Registrar via the mechanism described in . If the Pledge were to accept a 307 Redirect from a malicious entity, then it could be directed to connect to some other Registrar-like entity. This could be used to turn the Pledge into part of a distributed denial of service (DDoS) attack. As the Pledge will send it's details in the Voucher Request that it does send, there is also a possible disclosure of the Pledge's identifiable private information. Note that for use case two, in which redirection to an EST Server occurs, then there is no provisional TLS connection at all. The connection to the last Cloud Registrar is validated using the Implicit Trust Database, while the EST Server connection is validated by the certificate pinned by the Voucher artifact.

Considerations for Voucher est-domain A Cloud Registrar supporting the same set of Pledges as a MASA MAY be integrated with the MASA to avoid the need for a network based API between them, and without changing their external behavior as specified here. When a Cloud Registrar handles the scenario described in by the returning "est-domain" attribute in the voucher, the Cloud Registrar MUST do all the voucher processing as specified in . This is an example deployment scenario where the Cloud Registrar MAY be operated by the same entity as the MASA, and it MAY even be integrated with the MASA. When a voucher is issued by the Cloud Registrar and that voucher contains an "est-domain" attribute, the Pledge MUST verify the TLS connection with this EST server using the "pinned-domain-cert" attribute in the voucher. The reduced operational security mechanisms outlined in Sections 7.3 and 11 of MAY be supported when the Pledge connects with the EST server. These mechanisms reduce the security checks that take place when the Pledge enrolls with the EST server. Refer to sections 7.3 and 11 for further details.

Acknowledgements The authors would like to thank for following for their detailed reviews: (ordered by last name): Esko Dijk, Toerless Eckert, Sheng Jiang.