Dev attestation microsoft.attestation 2018 09 01 preview (#10978)

* Added MAA GA API Surface

* GA Swagger files

* Updated readme.md to reflect source reorganization

* Renamed preview to stable

* Updated readme.md to reflect rename of preview

* Added 2020-10-01 GA API version; minot tweaks to existing attestation JSON files

* Revert "Added 2020-10-01 GA API version; minot tweaks to existing attestation JSON files"

This reverts commit 1ebd816.

* Revert "Updated readme.md to reflect rename of preview"

This reverts commit 13a3e5a.

* Revert "Renamed preview to stable"

This reverts commit 2fdfe2e.

* Linter fixes

* Removed VBS ClientRequestIDParameter

* Missed a spot reflecting rename from preview to stable

* Fixed JSON for GetCerts and GetMetadataConfiguration APIs

* Oops - corrected swaggers

* Corrected casing on attestationPolicy - somehow this was missed in my earlier merges

* Updated and added examples

* Hooked up 4 new examples

* Fixed a couple of other validation errors

* Fixed a couple of other validation errors

* Fixed still more validation errors

* FIxed mistake in Policy_Get that was introduced by imperfect understanding of validation errors

* Removed AttestationPolicyRequest object because it does not meet REST API guidelines

* Prettier run

* Integrated code review feedback from master copy

* Significant updates to swagger, including feedback from swagger review and partner review

* Missed examples when renaming tee to attestationType

* Spelling check updates; removed unmentioned errors

* Forgot to run prettier, a couple more spelling and model checks

* Fixed remaining inittime value

* REST API Review feedback, round 1

* REST API Review changes

* Fixed several examples and spelling errors

* Added Result type for Attestation API; fixed swagger definitions for policy APIs.

* Forgot to delete this file

* Partner team asked for a rename of 'tee' to 'attestationtype' in claims

* Renamed preview API to stable version

* Missed md files in file rename

* More md files that referenced -preview

* Added systemData to result schema

* Dummy change to trigger validation

* Another attempt at fixing the go specification

* Added systemData to more locations

* Stable version of 2018-09-01-preview API version

* Updated go readme to rename the directory to stable

* Found a bunch of incorrect API versions in the swagger examples

* Fixed some typos in attestation.json

* tee -> attestationtype

* AttestationType->VerifierType

* Added spelling exceptions

* Added suppression on camel case errors

* Updated with better syntax

* Corrected JSON path for Attestation error in exceptions.

* Put suppression in a code block

* Moved the Suppression section to the end of the file instead of the middle

* Suppressions need the full path to the offending property

custom-words.txt

@@ -122,6 +122,7 @@ aspnet
 asyncinfo
 asyncoperation
 atascada
+attestationcollateral
 Auditd
 australiaeast
 australiasoutheast
@@ -760,6 +761,7 @@ Informations
 Informix
 Ingestor
 ingressed
+inittime
 inkrecognizer
 inlinecount
 inlines
@@ -999,6 +1001,8 @@ Monospace
 mountainview
 MPNS
 MRAN
+mrenclave
+mrsigner
 MSAZR
 MSAZRDE
 MSCONCAT
@@ -1194,6 +1198,7 @@ Plex
 Pohlmann
 pois
 policyassignments
+policycertificates
 policydefinitions
 policyinsights
 policykey

specification/attestation/data-plane/Microsoft.Attestation/preview/2018-09-01-preview/attestation.json → specification/attestation/data-plane/Microsoft.Attestation/stable/2018-09-01/attestation.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "AttestationClient",
     "description": "Describes the interface for the per-tenant enclave service.",
-    "version": "2018-09-01-preview"
+    "version": "2018-09-01"
   },
   "x-ms-parameterized-host": {
     "hostTemplate": "{tenantBaseUrl}",
@@ -323,7 +323,7 @@
           {
             "name": "policyCertificateToAdd",
             "in": "body",
-            "description": "An RFC7519 JSON Web Token containing a claim named \"aas-policyCertificate\" whose value is an RFC7517 JSON Web Key which specifies a new key to add. The RFC7519 JWT must be signed with one of the existing signing certificates",
+            "description": "An RFC7519 JSON Web Token containing a claim named \"maa-policyCertificate\" whose value is an RFC7517 JSON Web Key which specifies a new key to add. The RFC7519 JWT must be signed with one of the existing signing certificates",
             "required": true,
             "schema": {
               "type": "string"
@@ -375,7 +375,7 @@
           {
             "name": "policyCertificateToRemove",
             "in": "body",
-            "description": "An RFC7519 JSON Web Token containing a claim named \"aas-policyCertificate\" whose value is an RFC7517 JSON Web Key which specifies a new key to update. The RFC7519 JWT must be signed with one of the existing signing certificates",
+            "description": "An RFC7519 JSON Web Token containing a claim named \"maa-policyCertificate\" whose value is an RFC7517 JSON Web Key which specifies a new key to update. The RFC7519 JWT must be signed with one of the existing signing certificates",
             "required": true,
             "schema": {
               "type": "string"
@@ -420,8 +420,8 @@
         "tags": [
           "Attestation Provider"
         ],
-        "summary": "Retrieves the OpenID Configuration data for the Azure Attestation Service",
-        "description": "Retrieves attestation signing keys in use by the attestation service",
+        "summary": "Retrieves the attestation signing keys in use by the attestation service",
+        "description": "Retrieves metadata signing certificates in use by the attestation service",
         "operationId": "SigningCertificates_Get",
         "responses": {
           "200": {
@@ -456,7 +456,7 @@
           "Attestation Provider"
         ],
         "summary": "Retrieves the OpenID Configuration data for the Azure Attestation Service",
-        "description": "Retrieves metadata about the attestation signing keys in use by the  attestation service",
+        "description": "Retrieves metadata about the attestation signing keys in use by the attestation service",
         "operationId": "MetadataConfiguration_Get",
         "responses": {
           "200": {
@@ -514,7 +514,7 @@
       "type": "object",
       "properties": {
         "policy": {
-          "description": "String-encoded attestation policy document.",
+          "description": "JSON Web Token whose body is an AttestationPolicyRequest definition.",
           "type": "string"
         }
       }

specification/attestation/data-plane/Microsoft.Attestation/stable/2018-09-01/examples/Get_Policy.json

@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "tenantBaseUrl": "'https://mytest.attest.azure.net'",
+    "api-version": "2018-09-01-preview",
+    "tee": "SgxEnclave"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "policy": "eyJhbGciOiJub25lIn0.eyJBdHRlc3RhdGlvblBvbGljeSI6ICJkbVZ5YzJsdmJqMGdNUzR3TzJGMWRHaHZjbWw2WVhScGIyNXlkV3hsYzN0ak9sdDBlWEJsUFQwaUpHbHpMV1JsWW5WbloyRmliR1VpWFNBOVBpQndaWEp0YVhRb0tUdDlPMmx6YzNWaGJtTmxjblZzWlhON1l6cGJkSGx3WlQwOUlpUnBjeTFrWldKMVoyZGhZbXhsSWwwZ1BUNGdhWE56ZFdVb2RIbHdaVDBpYVhNdFpHVmlkV2RuWVdKc1pTSXNJSFpoYkhWbFBXTXVkbUZzZFdVcE8yTTZXM1I1Y0dVOVBTSWtjMmQ0TFcxeWMybG5ibVZ5SWwwZ1BUNGdhWE56ZFdVb2RIbHdaVDBpYzJkNExXMXljMmxuYm1WeUlpd2dkbUZzZFdVOVl5NTJZV3gxWlNrN1l6cGJkSGx3WlQwOUlpUnpaM2d0YlhKbGJtTnNZWFpsSWwwZ1BUNGdhWE56ZFdVb2RIbHdaVDBpYzJkNExXMXlaVzVqYkdGMlpTSXNJSFpoYkhWbFBXTXVkbUZzZFdVcE8yTTZXM1I1Y0dVOVBTSWtjSEp2WkhWamRDMXBaQ0pkSUQwLUlHbHpjM1ZsS0hSNWNHVTlJbkJ5YjJSMVkzUXRhV1FpTENCMllXeDFaVDFqTG5aaGJIVmxLVHRqT2x0MGVYQmxQVDBpSkhOMmJpSmRJRDAtSUdsemMzVmxLSFI1Y0dVOUluTjJiaUlzSUhaaGJIVmxQV011ZG1Gc2RXVXBPMk02VzNSNWNHVTlQU0lrZEdWbElsMGdQVDRnYVhOemRXVW9kSGx3WlQwaWRHVmxJaXdnZG1Gc2RXVTlZeTUyWVd4MVpTazdmVHMifQ."
+      }
+    },
+    "400": {
+      "body": {
+        "error": {
+          "code": "400",
+          "message": "error message"
+        }
+      }
+    },
+    "401": {
+      "description": "Request is unauthorized",
+      "body": ""
+    }
+  }
+}