Skip to content

Commit

Permalink
Add sections for how to get certs onto device
Browse files Browse the repository at this point in the history
  • Loading branch information
marcushines committed Feb 7, 2024
1 parent 5330e6e commit f8475b3
Show file tree
Hide file tree
Showing 4 changed files with 22 additions and 3 deletions.
25 changes: 22 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -261,6 +261,7 @@ can install production configuration and certificates into the device.

### Boot Procedure


#### **API flow**

1. DHCP Discovery of Bootstrap Server
Expand Down Expand Up @@ -423,10 +424,28 @@ configuration.
11. Active control card now verifies the card and brings the card into
production state and sync's configuration and other files.

### Open Questions
### Certificate deployment options

#### Bootz only

![Alt text](design_images/bootz.png "Certs delivered as part of Bootz")

In the Bootz only workflow certificates are delivered by the bootz server in
the initial bootz data payload. After reboot the device will use the provided
security profile and certificates provided in the bootz message.

#### Bootz with Certz rotation

![Alt text](design_images/bootz_certz.png "Certs delivered via Certz")

In this workflow the device will boot from bootz but will use it's iDevID cert
for initial services. Once rebooted, the device can be reached via Certz using the iDevID cert.

#### Bootz with Enrollz and Attestz

![Alt text](design_images/bootz_enrollz.png "Certs delivered via Certz after Enrollz")

1. Should TpmEnrollment and Attest methods be signed with owner's certificate?
2. Do we intend to use TpmEnrollment to rotate oIAK (and oDevID) also?
This is the preferred workflow for security considerations. This workflow utilizes Enrollz and Attestz to provide enrollment then measured boot to validate the state of device before providing any "production" certificates.

### Protobuf Payload for Bootstrap

Expand Down
Binary file added design_images/bootz.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added design_images/bootz_certz.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added design_images/bootz_enrollz.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit f8475b3

Please sign in to comment.