2023-11-28 11:30:11 -05:00
---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "constellation_attestation Data Source - constellation"
subcategory: ""
description: |-
2023-12-18 04:15:54 -05:00
Data source to fetch an attestation configuration for a given cloud service provider, attestation variant, and OS image.
2023-11-28 11:30:11 -05:00
---
# constellation_attestation (Data Source)
2023-12-18 04:15:54 -05:00
Data source to fetch an attestation configuration for a given cloud service provider, attestation variant, and OS image.
2023-11-28 11:30:11 -05:00
## Example Usage
```terraform
2023-12-18 07:55:44 -05:00
data "constellation_image" "example" {} # Fill accordingly for the CSP
2023-11-28 11:30:11 -05:00
data "constellation_attestation" "test" {
csp = "aws"
attestation_variant = "aws-sev-snp"
2023-12-18 07:55:44 -05:00
image = data.constellation_image.example.image
2023-11-28 11:30:11 -05:00
}
```
<!-- schema generated by tfplugindocs -->
## Schema
### Required
- `attestation_variant` (String) Attestation variant the image should work with. Can be one of:
* `aws-sev-snp`
* `aws-nitro-tpm`
* `azure-sev-snp`
* `gcp-sev-es`
- `csp` (String) CSP (Cloud Service Provider) to use. (e.g. `azure` )
See the [full list of CSPs ](https://docs.edgeless.systems/constellation/overview/clouds ) that Constellation supports.
2023-12-18 04:15:54 -05:00
- `image` (Attributes) Constellation OS Image to use on the nodes. (see [below for nested schema ](#nestedatt--image ))
2023-11-28 11:30:11 -05:00
### Optional
2023-12-15 04:37:29 -05:00
- `insecure` (Boolean) DON'T USE IN PRODUCTION Skip the signature verification when fetching measurements for the image.
2023-11-28 11:30:11 -05:00
- `maa_url` (String) For Azure only, the URL of the Microsoft Azure Attestation service
### Read-Only
2023-12-05 10:16:50 -05:00
- `attestation` (Attributes) Attestation comprises the measurements and SEV-SNP specific parameters. (see [below for nested schema ](#nestedatt--attestation ))
2023-11-28 11:30:11 -05:00
2023-12-18 04:15:54 -05:00
< a id = "nestedatt--image" > < / a >
### Nested Schema for `image`
Required:
- `reference` (String) CSP-specific unique reference to the image. The format differs per CSP.
- `short_path` (String) CSP-agnostic short path to the image. The format is `vX.Y.Z` for release images and `ref/$GIT_REF/stream/$STREAM/$SEMANTIC_VERSION` for pre-release images.
- `$GIT_REF` is the git reference (i.e. branch name) the image was built on, e.g. `main` .
- `$STREAM` is the stream the image was built on, e.g. `nightly` .
- `$SEMANTIC_VERSION` is the semantic version of the image, e.g. `vX.Y.Z` or `vX.Y.Z-pre...` .
- `version` (String) Semantic version of the image.
2023-11-28 11:30:11 -05:00
< a id = "nestedatt--attestation" > < / a >
### Nested Schema for `attestation`
Read-Only:
- `amd_root_key` (String)
- `azure_firmware_signer_config` (Attributes) (see [below for nested schema ](#nestedatt--attestation--azure_firmware_signer_config ))
- `bootloader_version` (Number)
2023-12-05 10:16:50 -05:00
- `measurements` (Attributes Map) (see [below for nested schema ](#nestedatt--attestation--measurements ))
2023-11-28 11:30:11 -05:00
- `microcode_version` (Number)
- `snp_version` (Number)
- `tee_version` (Number)
2023-12-05 10:16:50 -05:00
- `variant` (String) Attestation variant the image should work with. Can be one of:
* `aws-sev-snp`
* `aws-nitro-tpm`
* `azure-sev-snp`
* `gcp-sev-es`
2023-11-28 11:30:11 -05:00
< a id = "nestedatt--attestation--azure_firmware_signer_config" > < / a >
### Nested Schema for `attestation.azure_firmware_signer_config`
Read-Only:
- `accepted_key_digests` (List of String)
- `enforcement_policy` (String)
- `maa_url` (String)
2023-12-05 10:16:50 -05:00
< a id = "nestedatt--attestation--measurements" > < / a >
### Nested Schema for `attestation.measurements`
2023-11-28 11:30:11 -05:00
Read-Only:
- `expected` (String)
- `warn_only` (Boolean)