AttestationClient class

Paket:
@azure/attestation

Kanıtlama İstemci sınıfı.

AttestationClient sınıfı, Kanıtlama ile ilgili API'lere erişim sağlar:

  • getOpenIdMetadata
  • getAttestationSigners
  • attestSgxEnclave
  • attestOpenEnclave
  • attestTpm

Oluşturucular

AttestationClient(string, AttestationClientOptions)

AttestationClient örneği oluşturur.

Örnek kullanım:

import { AttestationClient } from "@azure/attestation";

const client = new AttestationClient(
   "<service endpoint>"
);
AttestationClient(string, TokenCredential, AttestationClientOptions)

Seçenekler ve kimlik bilgileriyle Bir AttestationClient örneği oluşturur.

Örnek kullanım:

import { AttestationClient } from "@azure/attestation";

const client = new AttestationClient(
   "<service endpoint>",
   new TokenCredential("<>"),
   { tokenValidationOptions: { validateToken: false } }
);

attestTpm API'sini çağırmak için kimlik bilgilerinin gerekli olduğunu unutmayın.

Yöntemler

attestOpenEnclave(Uint8Array | Buffer | Blob, AttestOpenEnclaveOptions)

OpenEnclave SDK'sı kullanılarak SGX Enclave'den oluşturulan bir OpenEnclave raporunu doğrular.
attestSgxEnclave(Uint8Array | Buffer | Blob, AttestSgxEnclaveOptions)

Intel SDK kullanılarak SGX Kapanım'dan oluşturulan bir alıntıyı doğrular.
attestTpm(string, AttestTpmOptions)

TPM tabanlı bir kapanım olduğunu onaylar.

Daha fazla bilgi için TPM Kanıtlama Protokolü Başvurusu bakın.

Örnek

Örneğin, BIR TPM kanıtlama işlemi için ilk çağrı şöyledir:

const encodedPayload = JSON.stringify({ payload: { type: "aikcert" } });
const result = await client.attestTpm(encodedPayload);

burada stringToBytes dizeyi UTF8'e dönüştürür.

attestTpm'nin kimlik doğrulaması kimlik bilgileriyle yapılandırılmış bir kanıtlama istemcisi gerektirdiğini unutmayın.
getAttestationSigners(AttestationClientOperationOptions)

Kanıtlama hizmeti belirteçlerini imzalamak için kullanılabilecek kanıtlama imzalayanların listesini döndürür.
getOpenIdMetadata(AttestationClientOperationOptions)

Kanıtlama hizmeti örneği için OpenID Meta Veri bulma belgesini döndürür.

Oluşturucu Ayrıntıları

AttestationClient(string, AttestationClientOptions)

AttestationClient örneği oluşturur.

Örnek kullanım:

import { AttestationClient } from "@azure/attestation";

const client = new AttestationClient(
   "<service endpoint>"
);

new AttestationClient(endpoint: string, options?: AttestationClientOptions)

Parametreler

endpoint

string

Kanıtlama örneği temel URI'si, örneğin https://mytenant.attest.azure.net.

options
AttestationClientOptions

Kanıtlama İstemcisi'ni yapılandırmak için kullanılan seçenekler.

AttestationClient(string, TokenCredential, AttestationClientOptions)

Seçenekler ve kimlik bilgileriyle Bir AttestationClient örneği oluşturur.

Örnek kullanım:

import { AttestationClient } from "@azure/attestation";

const client = new AttestationClient(
   "<service endpoint>",
   new TokenCredential("<>"),
   { tokenValidationOptions: { validateToken: false } }
);

attestTpm API'sini çağırmak için kimlik bilgilerinin gerekli olduğunu unutmayın.

new AttestationClient(endpoint: string, credentials: TokenCredential, options?: AttestationClientOptions)

Parametreler

endpoint

string

Kanıtlama örneği temel URI'si, örneğin https://mytenant.attest.azure.net.

credentials
TokenCredential

Kanıtlama istemcisini yapılandırmak için kullanılan kimlik bilgileri.

options
AttestationClientOptions

Yöntem Ayrıntıları

attestOpenEnclave(Uint8Array | Buffer | Blob, AttestOpenEnclaveOptions)

OpenEnclave SDK'sı kullanılarak SGX Enclave'den oluşturulan bir OpenEnclave raporunu doğrular.

function attestOpenEnclave(report: Uint8Array | Buffer | Blob, options?: AttestOpenEnclaveOptions): Promise<AttestationResponse<AttestationResult>>

Parametreler

report

Uint8Array | Buffer | Blob

SGX kapanım tarafından oluşturulan openEnclave raporu.

options
AttestOpenEnclaveOptions

attestOpenEnclave API çağrısı için işlem seçenekleri.

Döndürülenler

Promise<AttestationResponse<AttestationResult>>

Gövdesi kanıtlama hizmeti tarafından döndürülen talepleri açıklayan bir AttestationResponse döndürür.

attestSgxEnclave(Uint8Array | Buffer | Blob, AttestSgxEnclaveOptions)

Intel SDK kullanılarak SGX Kapanım'dan oluşturulan bir alıntıyı doğrular.

function attestSgxEnclave(quote: Uint8Array | Buffer | Blob, options?: AttestSgxEnclaveOptions): Promise<AttestationResponse<AttestationResult>>

Parametreler

quote

Uint8Array | Buffer | Blob

SGX kapanım tarafından oluşturulan bir SGX teklifi.

options
AttestSgxEnclaveOptions

attestOpenEnclave API çağrısı için işlem seçenekleri.

Döndürülenler

Promise<AttestationResponse<AttestationResult>>

Gövdesi kanıtlama hizmeti tarafından döndürülen talepleri açıklayan bir AttestationResponse döndürür.

attestTpm(string, AttestTpmOptions)

TPM tabanlı bir kapanım olduğunu onaylar.

Daha fazla bilgi için TPM Kanıtlama Protokolü Başvurusu bakın.

Örnek

Örneğin, BIR TPM kanıtlama işlemi için ilk çağrı şöyledir:

const encodedPayload = JSON.stringify({ payload: { type: "aikcert" } });
const result = await client.attestTpm(encodedPayload);

burada stringToBytes dizeyi UTF8'e dönüştürür.

attestTpm'nin kimlik doğrulaması kimlik bilgileriyle yapılandırılmış bir kanıtlama istemcisi gerektirdiğini unutmayın.

function attestTpm(request: string, options?: AttestTpmOptions): Promise<string>

Parametreler

request

string

UTf8 kodlanmış TPM kanıtlama hizmetine göndermek için gelen istek.

options
AttestTpmOptions

TPM kanıtlama isteği için işlem hattı seçenekleri.

Döndürülenler

Promise<string>

Utf8 kodlanmış TPM kanıtlamasından gelen yanıtı içeren bir yapı.

Açıklamalar

TPM kanıtlama API'sine gelen istekler dizeli JSON nesneleridir.

getAttestationSigners(AttestationClientOperationOptions)

Kanıtlama hizmeti belirteçlerini imzalamak için kullanılabilecek kanıtlama imzalayanların listesini döndürür.

function getAttestationSigners(options?: AttestationClientOperationOptions): Promise<AttestationSigner[]>

Parametreler

options
AttestationClientOperationOptions

İstemci işlemi seçenekleri.

Döndürülenler

Promise<AttestationSigner[]>

kanıtlama belirteçlerini imzalamak için kullanılabilecek AttestationSigners kümesi.

getOpenIdMetadata(AttestationClientOperationOptions)

Kanıtlama hizmeti örneği için OpenID Meta Veri bulma belgesini döndürür.

function getOpenIdMetadata(options?: AttestationClientOperationOptions): Promise<Record<string, unknown>>

Parametreler

options
AttestationClientOperationOptions

İstemci işlemi seçenekleri.

Döndürülenler

Promise<Record<string, unknown>>

Kanıtlama hizmeti için OpenID meta veri bulma belgesi.