Skip to content

Commit 65253e6

Browse files
authored
Added Acrolinix fixes
1 parent f8633af commit 65253e6

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

articles/security/fundamentals/trusted-hardware-identity-management.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ THIM defines the Azure security baseline for Azure Confidential computing (ACC)
2323

2424
### The "next update" date of the Azure-internal caching service API, used by Microsoft Azure Attestation, seems to be out of date. Is it still in operation and can it be used?
2525

26-
The "tcbinfo" field contains the TCB information. The THIM service by default provides an older tcbinfo -- updating to the latest tcbinfo from Intel would cause attestation failures for those customers who haven't migrated to the latest Intel SDK, and could results in outages.
26+
The "tcbinfo" field contains the TCB information. The THIM service by default provides an older tcbinfo--updating to the latest tcbinfo from Intel would cause attestation failures for those customers who haven't migrated to the latest Intel SDK, and could results in outages.
2727

2828
Open Enclave SDK and Microsoft Azure Attestation don't look at nextUpdate date, however, and will pass attestation.
2929

@@ -39,15 +39,15 @@ Azure Data Center Attestation Primitives (DCAP), a replacement for Intel Quote P
3939

4040
### Why are there different baselines between THIM and Intel?
4141

42-
THIM and Intel provide different baseline levels of the trusted computing base. While Intel can be viewed as having the latest and greatest, this imposes requirements upon the consumer to ensure that all the requirements are satisfied, thus leading to a potential breakage of customers if they haven't updated to the specified requirements. THIM takes a slower approach to updating the TCB baseline to allow customers to make the necessary changes at their own pace. This approach, while does provide an older TCB baseline, ensures that customers will not break if they haven't been able to meet the requirements of the new TCB baseline. This reason is why THIM's TCB baseline is of a different version from Intel's. We're customer-focused and want to empower the customer to meet the requirements imposed by the new TCB baseline on their pace, instead of forcing them to update and causing them a disruption that would require reprioritization of their workstreams.
42+
THIM and Intel provide different baseline levels of the trusted computing base. While Intel can be viewed as having the latest and greatest, this imposes requirements upon the consumer to ensure that all the requirements are satisfied, thus leading to a potential breakage of customers if they haven't updated to the specified requirements. THIM takes a slower approach to updating the TCB baseline to allow customers to make the necessary changes at their own pace. This approach, while does provide an older TCB baseline, ensures that customers won't break if they haven't been able to meet the requirements of the new TCB baseline. This reason is why THIM's TCB baseline is of a different version from Intel's. We're customer-focused and want to empower the customer to meet the requirements imposed by the new TCB baseline on their pace, instead of forcing them to update and causing them a disruption that would require reprioritization of their workstreams.
4343

4444
THIM is also introducing a new feature that will enable customers to select their own custom baseline. This feature will allow customers to decide between the newest TCB or using an older TCB than provided by Intel, enabling customers to ensure that the TCB version to enforce is compliant with their specific configuration. This new feature will be reflected in a future iteration of the THIM documentation.
4545

4646
### With Coffeelake I could get my certificates directly from Intel PCK. Why, with Icelake, do I need to get the certificates from THIM, and what do I need to do to fetch those certificates?
4747

4848
The certificates are fetched and cached in THIM service using platform manifest and indirect registration. As a result, Key Caching Policy will be set to never store platform root keys for a given platform. Direct calls to the Intel service from inside the VM are expected to fail.
4949

50-
To retrieve the certificate, you must install the [Azure DCAP library](#what-is-the-azure-dcap-library) which replaces Intel QPL. This library directs the fetch requests to THIM service running in Azure cloud. For the downloading the latest DCAP packages, please see: [Where can I download the latest DCAP packages?](#where-can-i-download-the-latest-dcap-packages)
50+
To retrieve the certificate, you must install the [Azure DCAP library](#what-is-the-azure-dcap-library) that replaces Intel QPL. This library directs the fetch requests to THIM service running in Azure cloud. For the downloading the latest DCAP packages, see: [Where can I download the latest DCAP packages?](#where-can-i-download-the-latest-dcap-packages)
5151

5252
### How do I request collateral in a Confidential Virtual Machine (CVM)?
5353

@@ -75,7 +75,7 @@ curl GET "http://169.254.169.254/metadata/THIM/amd/certification" -H "Metadata:
7575
7676
| Name | Description |
7777
|--|--|
78-
| 200 OK | Lists available collateral in http body within JSON format. For details on the keys in the JSON, please see Definitions |
78+
| 200 OK | Lists available collateral in http body within JSON format. For details on the keys in the JSON, see Definitions |
7979
| Other Status Codes | Error response describing why the operation failed |
8080
8181
#### Definitions
@@ -86,9 +86,9 @@ curl GET "http://169.254.169.254/metadata/THIM/amd/certification" -H "Metadata:
8686
| tcbm | Trusted Computing Base |
8787
| certificateChain | Includes the AMD SEV Key (ASK) and AMD Root Key (ARK) certificates |
8888
89-
### How do I request AMD collateral in an Azure Kuberenetes Service (AKS) Container on a Confidential Virtual Machine (CVM) node?
89+
### How do I request AMD collateral in an Azure Kubernetes Service (AKS) Container on a Confidential Virtual Machine (CVM) node?
9090
91-
Follow the steps below for requesting AMD collateral in a confidential container.
91+
Follow the steps for requesting AMD collateral in a confidential container.
9292
1. Start by creating an AKS cluster on CVM mode or adding a CVM node pool to the existing cluster.
9393
1. Create an AKS Cluster on CVM node.
9494
1. Create a resource group in one of the CVM supported regions.
@@ -116,7 +116,7 @@ Follow the steps below for requesting AMD collateral in a confidential container
116116
| -- | -- | -- | -- | -- |
117117
| aks-nodepool1-31718369-0 | Ready | agent | 6m44s | v1.12.8 |
118118
119-
2. Once the AKS cluster is created, create a curl.yaml file with the following content. It defines a job that runs a curl container to fetch AMD collateral from the THIM endpoint. For more information about Kubernetes Jobs, please see [Kuberenetes documentation](https://kubernetes.io/docs/concepts/workloads/controllers/job/).
119+
2. Once the AKS cluster is created, create a curl.yaml file with the following content. It defines a job that runs a curl container to fetch AMD collateral from the THIM endpoint. For more information about Kubernetes Jobs, please see [Kubernetes documentation](https://kubernetes.io/docs/concepts/workloads/controllers/job/).
120120
121121
**curl.yaml**
122122
```bash
@@ -156,7 +156,7 @@ Follow the steps below for requesting AMD collateral in a confidential container
156156
**Example Response**
157157
| Name | Ready | Status | Restarts | Age |
158158
| -- | -- | -- | -- | -- |
159-
| Curl-w7nt8 | 0/1 | Completed | 0 | 72s |
159+
| Curl-w7nt8 | 0/1 | Completed | 0 | 72 s |
160160
5. Run the following command to get the job logs and validate if it is working. A successful output should include vcekCert, tcbm and certificateChain.
161161
```bash
162162
kubectl logs job/curl

0 commit comments

Comments
 (0)