/// <summary> /// Removes one of the attestation policy management certificates. /// </summary> /// <param name="certificateToRemove">The certificate to remove.</param> /// <param name="existingSigningKey">An existing key corresponding to the existing certificate.</param> /// <param name="cancellationToken">Cancellation token used to cancel this operation.</param> /// <returns>An <see cref="AttestationResponse{PolicyCertificatesModificationResult}"/> with the policy for the specified attestation type.</returns> public virtual async Task <AttestationResponse <PolicyCertificatesModificationResult> > RemovePolicyManagementCertificateAsync( X509Certificate2 certificateToRemove, TokenSigningKey existingSigningKey, CancellationToken cancellationToken = default) { using DiagnosticScope scope = _clientDiagnostics.CreateScope($"{nameof(AttestationAdministrationClient)}.{nameof(RemovePolicyManagementCertificate)}"); scope.Start(); try { var tokenToRemove = new AttestationToken( new PolicyCertificateModification(certificateToRemove), existingSigningKey); var result = await _policyManagementClient.RemoveAsync(tokenToRemove.ToString(), cancellationToken).ConfigureAwait(false); var token = new AttestationToken(result.Value.Token); if (_options.TokenOptions.ValidateToken) { await token.ValidateTokenAsync(_options.TokenOptions, await GetSignersAsync(cancellationToken).ConfigureAwait(false), cancellationToken).ConfigureAwait(false); } return(new AttestationResponse <PolicyCertificatesModificationResult>(result.GetRawResponse(), token)); } catch (Exception ex) { scope.Failed(ex); throw; } }
/// <summary> /// Adds the specified new signing certificate to the set of policy management certificates. /// </summary> /// <param name="newSigningCertificate">The new certificate to add.</param> /// <param name="existingSigningKey">An existing key corresponding to the existing certificate.</param> /// <param name="cancellationToken">Cancellation token used to cancel this operation.</param> /// <returns>An <see cref="AttestationResponse{PolicyCertificatesModificationResult}"/> with the policy for the specified attestation type.</returns> /// <remarks> /// </remarks> public virtual AttestationResponse <PolicyCertificatesModificationResult> AddPolicyManagementCertificate( X509Certificate2 newSigningCertificate, TokenSigningKey existingSigningKey, CancellationToken cancellationToken = default) { Argument.AssertNotNull(existingSigningKey, nameof(existingSigningKey)); Argument.AssertNotNull(newSigningCertificate, nameof(newSigningCertificate)); using DiagnosticScope scope = _clientDiagnostics.CreateScope($"{nameof(AttestationAdministrationClient)}.{nameof(AddPolicyManagementCertificate)}"); scope.Start(); try { var tokenToAdd = new AttestationToken( new PolicyCertificateModification(newSigningCertificate), existingSigningKey); var result = _policyManagementClient.Add(tokenToAdd.ToString(), cancellationToken); var token = new AttestationToken(result.Value.Token); if (_options.TokenOptions.ValidateToken) { token.ValidateToken(_options.TokenOptions, GetSigners(cancellationToken), cancellationToken); } return(new AttestationResponse <PolicyCertificatesModificationResult>(result.GetRawResponse(), token)); } catch (Exception ex) { scope.Failed(ex); throw; } }
/// <summary> /// Resets the policy for the specified <see cref="AttestationType"/> to the default value. /// </summary> /// <param name="attestationType"><see cref="AttestationType"/> whose policy should be reset.</param> /// <param name="signingKey">If provided, specifies the signing key used to sign the request to the attestation service.</param> /// <param name="cancellationToken">Cancellation token used to cancel this operation.</param> /// <returns>An <see cref="AttestationResponse{PolicyResult}"/> with the policy for the specified attestation type.</returns> /// <remarks> /// If the <paramref name="signingKey"/> parameter is not provided, then the policy document sent to the /// attestation service will be unsigned. Unsigned attestation policies are only allowed when the attestation instance is running in AAD mode - if the /// attestation instance is running in Isolated mode, then a signing key and signing certificate MUST be provided to ensure that the caller of the API is authorized to change policy. /// The <see cref="TokenSigningKey.Certificate"/> parameter MUST be one of the certificates returned by the <see cref="GetPolicyManagementCertificates(CancellationToken)"/> API. /// <para/> /// </remarks> public virtual async Task <AttestationResponse <PolicyResult> > ResetPolicyAsync( AttestationType attestationType, TokenSigningKey signingKey = default, CancellationToken cancellationToken = default) { using DiagnosticScope scope = _clientDiagnostics.CreateScope($"{nameof(AttestationAdministrationClient)}.{nameof(ResetPolicy)}"); scope.Start(); try { AttestationToken tokenToSet = new AttestationToken(null, signingKey); var result = await _policyClient.ResetAsync(attestationType, tokenToSet.ToString(), cancellationToken).ConfigureAwait(false); var token = new AttestationToken(result.Value.Token); if (_options.TokenOptions.ValidateToken) { await token.ValidateTokenAsync(_options.TokenOptions, await GetSignersAsync(cancellationToken).ConfigureAwait(false), cancellationToken).ConfigureAwait(false); } return(new AttestationResponse <PolicyResult>(result.GetRawResponse(), token)); } catch (Exception ex) { scope.Failed(ex); throw; } }
/// <summary> /// Sets the attesttion policy for the specified <see cref="AttestationType"/>. /// </summary> /// <param name="attestationType"><see cref="AttestationType"/> whose policy should be set.</param> /// <param name="policyToSet">Specifies the attestation policy to set.</param> /// <param name="signingKey">If provided, specifies the signing key used to sign the request to the attestation service.</param> /// <param name="cancellationToken">Cancellation token used to cancel this operation.</param> /// <returns>An <see cref="AttestationResponse{PolicyResult}"/> with the policy for the specified attestation type.</returns> /// <remarks> /// If the <paramref name="signingKey"/> parameter is not provided, then the policy document sent to the /// attestation service will be unsigned. Unsigned attestation policies are only allowed when the attestation instance is running in AAD mode - if the /// attestation instance is running in Isolated mode, then a signing key and signing certificate MUST be provided to ensure that the caller of the API is authorized to change policy. /// The <see cref="TokenSigningKey.Certificate"/> field MUST be one of the certificates returned by the <see cref="GetPolicyManagementCertificates(CancellationToken)"/> API. /// <para/> /// Clients need to be able to verify that the attestation policy document was not modified before the policy document was received by the attestation service's enclave. /// There are two properties provided in the [PolicyResult][attestation_policy_result] that can be used to verify that the service received the policy document: /// <list type="bullet"> /// <item> /// <description><see cref="PolicyResult.PolicySigner"/> - if the <see cref="SetPolicy(AttestationType, string, TokenSigningKey, CancellationToken)"/> call included a signing certificate, this will be the certificate provided at the time of the `SetPolicy` call. If no policy signer was set, this will be null. </description> /// </item> /// <item> /// <description><see cref="PolicyResult.PolicyTokenHash"/> - this is the hash of the [JSON Web Token][json_web_token] sent to the service</description> /// </item> /// </list> /// To verify the hash, clients can generate an attestation token and verify the hash generated from that token: /// <code snippet="Snippet:VerifySigningHash"> /// // The SetPolicyAsync API will create an AttestationToken signed with the TokenSigningKey to transmit the policy. /// // To verify that the policy specified by the caller was received by the service inside the enclave, we /// // verify that the hash of the policy document returned from the Attestation Service matches the hash /// // of an attestation token created locally. /// TokenSigningKey signingKey = new TokenSigningKey(<Customer provided signing key>, <Customer provided certificate>) /// var policySetToken = new AttestationToken( /// new StoredAttestationPolicy { AttestationPolicy = attestationPolicy }, /// signingKey); /// /// using var shaHasher = SHA256Managed.Create(); /// var attestationPolicyHash = shaHasher.ComputeHash(Encoding.UTF8.GetBytes(policySetToken.ToString())); /// /// Debug.Assert(attestationPolicyHash.SequenceEqual(setResult.Value.PolicyTokenHash)); /// </code> /// /// If the signing key and certificate are not provided, then the SetPolicyAsync API will create an unsecured attestation token /// wrapping the attestation policy. To validate the <see cref="PolicyResult.PolicyTokenHash"/> return value, a developer /// can create their own <see cref="AttestationToken"/> and create the hash of that. /// <code> /// using var shaHasher = SHA256Managed.Create(); /// var policySetToken = new AttestationToken(new StoredAttestationPolicy { AttestationPolicy = disallowDebugging }); /// disallowDebuggingHash = shaHasher.ComputeHash(Encoding.UTF8.GetBytes(policySetToken.ToString())); /// </code> /// </remarks> public virtual async Task <AttestationResponse <PolicyResult> > SetPolicyAsync( AttestationType attestationType, string policyToSet, TokenSigningKey signingKey = default, CancellationToken cancellationToken = default) { if (string.IsNullOrEmpty(policyToSet)) { throw new ArgumentException($"'{nameof(policyToSet)}' cannot be null or empty.", nameof(policyToSet)); } using DiagnosticScope scope = _clientDiagnostics.CreateScope($"{nameof(AttestationAdministrationClient)}.{nameof(SetPolicy)}"); scope.Start(); try { AttestationToken tokenToSet = new AttestationToken(new StoredAttestationPolicy { AttestationPolicy = policyToSet, }, signingKey); var result = await _policyClient.SetAsync(attestationType, tokenToSet.ToString(), cancellationToken).ConfigureAwait(false); var token = new AttestationToken(result.Value.Token); if (_options.TokenOptions.ValidateToken) { await token.ValidateTokenAsync(_options.TokenOptions, await GetSignersAsync(cancellationToken).ConfigureAwait(false), cancellationToken).ConfigureAwait(false); } return(new AttestationResponse <PolicyResult>(result.GetRawResponse(), token)); } catch (Exception ex) { scope.Failed(ex); throw; } }
/// <summary> /// Sets the attesttion policy for the specified <see cref="AttestationType"/>. /// </summary> /// <param name="attestationType"><see cref="AttestationType"/> whose policy should be set.</param> /// <param name="policyToSet">Specifies the attestation policy to set.</param> /// <param name="signingKey">If provided, specifies the signing key used to sign the request to the attestation service.</param> /// <param name="cancellationToken">Cancellation token used to cancel this operation.</param> /// <returns>An <see cref="AttestationResponse{PolicyResult}"/> with the policy for the specified attestation type.</returns> /// <remarks> /// If the <paramref name="signingKey"/> parameter is not provided, then the policy document sent to the /// attestation service will be unsigned. Unsigned attestation policies are only allowed when the attestation instance is running in AAD mode - if the /// attestation instance is running in Isolated mode, then a signing key and signing certificate MUST be provided to ensure that the caller of the API is authorized to change policy. /// The <see cref="TokenSigningKey.Certificate"/> field MUST be one of the certificates returned by the <see cref="GetPolicyManagementCertificates(CancellationToken)"/> API. /// <para/> /// Clients need to be able to verify that the attestation policy document was not modified before the policy document was received by the attestation service's enclave. /// There are two properties provided in the [PolicyResult][attestation_policy_result] that can be used to verify that the service received the policy document: /// <list type="bullet"> /// <item> /// <description><see cref="PolicyResult.PolicySigner"/> - if the <see cref="SetPolicy(AttestationType, string, TokenSigningKey, CancellationToken)"/> call included a signing certificate, this will be the certificate provided at the time of the `SetPolicy` call. If no policy signer was set, this will be null. </description> /// </item> /// <item> /// <description><see cref="PolicyResult.PolicyTokenHash"/> - this is the hash of the [JSON Web Token][json_web_token] sent to the service</description> /// </item> /// </list> /// To verify the hash, clients can generate an attestation token and verify the hash generated from that token: /// <code snippet="Snippet:VerifySigningHash"> /// // The SetPolicyAsync API will create an AttestationToken signed with the TokenSigningKey to transmit the policy. /// // To verify that the policy specified by the caller was received by the service inside the enclave, we /// // verify that the hash of the policy document returned from the Attestation Service matches the hash /// // of an attestation token created locally. /// TokenSigningKey signingKey = new TokenSigningKey(<Customer provided signing key>, <Customer provided certificate>) /// var policySetToken = new AttestationToken( /// new StoredAttestationPolicy { AttestationPolicy = attestationPolicy }, /// signingKey); /// /// using var shaHasher = SHA256Managed.Create(); /// var attestationPolicyHash = shaHasher.ComputeHash(Encoding.UTF8.GetBytes(policySetToken.ToString())); /// /// Debug.Assert(attestationPolicyHash.SequenceEqual(setResult.Value.PolicyTokenHash)); /// </code> /// /// If the signing key and certificate are not provided, then the SetPolicyAsync API will create an unsecured attestation token /// wrapping the attestation policy. To validate the <see cref="PolicyResult.PolicyTokenHash"/> return value, a developer /// can create their own <see cref="AttestationToken"/> and create the hash of that. /// <code> /// using var shaHasher = SHA256Managed.Create(); /// var policySetToken = new UnsecuredAttestationToken(new StoredAttestationPolicy { AttestationPolicy = disallowDebugging }); /// disallowDebuggingHash = shaHasher.ComputeHash(Encoding.UTF8.GetBytes(policySetToken.ToString())); /// </code> /// </remarks> public virtual AttestationResponse <PolicyResult> SetPolicy( AttestationType attestationType, string policyToSet, TokenSigningKey signingKey = default, CancellationToken cancellationToken = default) { Argument.AssertNotNullOrWhiteSpace(policyToSet, nameof(policyToSet)); using DiagnosticScope scope = _clientDiagnostics.CreateScope($"{nameof(AttestationAdministrationClient)}.{nameof(SetPolicy)}"); scope.Start(); try { AttestationToken tokenToSet = new AttestationToken( new StoredAttestationPolicy { AttestationPolicy = policyToSet, }, signingKey); var result = _policyClient.Set(attestationType, tokenToSet.ToString(), cancellationToken); var token = new AttestationToken(result.Value.Token); if (_options.TokenOptions.ValidateToken) { token.ValidateToken(_options.TokenOptions, GetSigners(cancellationToken), cancellationToken); } return(new AttestationResponse <PolicyResult>(result.GetRawResponse(), token)); } catch (Exception ex) { scope.Failed(ex); throw; } }
/// <summary> /// Resets the policy for the specified <see cref="AttestationType"/> to the default value. /// </summary> /// <param name="attestationType"><see cref="AttestationType"/> whose policy should be reset.</param> /// <param name="authorizationToken">Signed JSON Web Token signed by one of the policy management certificates used to verify the caller is authorized to reset policy to the default value..</param> /// <param name="cancellationToken"></param> /// <returns>An <see cref="AttestationResponse{PolicyResult}"/> with the policy for the specified attestation type.</returns> public virtual AttestationResponse <PolicyResult> ResetPolicy(AttestationType attestationType, AttestationToken authorizationToken = default, CancellationToken cancellationToken = default) { using DiagnosticScope scope = _clientDiagnostics.CreateScope($"{nameof(AttestationAdministrationClient)}.{nameof(ResetPolicy)}"); scope.Start(); try { var result = _policyClient.Reset(attestationType, authorizationToken.ToString(), cancellationToken); var token = new AttestationToken(result.Value.Token); if (_options.ValidateAttestationTokens) { token.ValidateToken(GetSigners(), _options.ValidationCallback); } return(new AttestationResponse <PolicyResult>(result.GetRawResponse(), token)); } catch (Exception ex) { scope.Failed(ex); throw; } }
/// <summary> /// Sets the attesttion policy for the specified <see cref="AttestationType"/>. /// </summary> /// <param name="attestationType"><see cref="AttestationType"/> whose policy should be set.</param> /// <param name="policyToSet"><see cref="AttestationToken"/> specifying the new stored attestation policy.</param> /// <param name="cancellationToken"></param> /// <returns>An <see cref="AttestationResponse{PolicyResult}"/> with the policy for the specified attestation type.</returns> public virtual async Task <AttestationResponse <PolicyResult> > SetPolicyAsync(AttestationType attestationType, AttestationToken policyToSet, CancellationToken cancellationToken = default) { using DiagnosticScope scope = _clientDiagnostics.CreateScope($"{nameof(AttestationAdministrationClient)}.{nameof(SetPolicy)}"); scope.Start(); try { var result = await _policyClient.SetAsync(attestationType, policyToSet.ToString(), cancellationToken).ConfigureAwait(false); var token = new AttestationToken(result.Value.Token); if (_options.ValidateAttestationTokens) { token.ValidateToken(GetSigners(), _options.ValidationCallback); } return(new AttestationResponse <PolicyResult>(result.GetRawResponse(), token)); } catch (Exception ex) { scope.Failed(ex); throw; } }