Azure ConfidentialLedger client library for JavaScript - version 2.0.0

Questo pacchetto contiene un SDK isomorfico (eseguito sia in Node.js che nei browser) per il client Azure ConfidentialLedger.

Microsoft Azure Confidential Compute Ledger Managed CCF Control Plane REST API.

Collegamenti chiave:

Come iniziare

Ambienti attualmente supportati

Per altri dettagli, vedere i criteri di supporto .

Prerequisiti

Installare il pacchetto @azure/arm-confidentialledger

Installare la libreria client Azure ConfidentialLedger per JavaScript con npm:

npm install @azure/arm-confidentialledger

Creare ed autenticare un ConfidentialLedgerClient

Per creare un oggetto client per accedere all'API Azure ConfidentialLedger, è necessario disporre endpoint della risorsa Azure ConfidentialLedger e di un credentialfile . Il client Azure ConfidentialLedger può usare le credenziali di Azure Active Directory per l'autenticazione. È possibile trovare l'endpoint per la risorsa Azure ConfidentialLedger nel portale di Azure.

Puoi autenticarti con Azure Active Directory usando una credenziale della libreria @azure/identity oppure un token AAD esistente.

Per utilizzare il provider DefaultAzureCredential mostrato qui sotto, o altri fornitori di credenziali forniti con il Azure SDK, si prega di installare il pacchetto @azure/identity:

npm install @azure/identity

Sarà anche necessario registrare una nuova applicazione AAD e concedere l'accesso ad Azure ConfidentialLedger assegnando il ruolo appropriato all'entità servizio (nota: ruoli come quelli che "Owner" non concederanno le autorizzazioni necessarie).

Per maggiori informazioni su come creare una Azure applicazione AD, consulta questa guida.

Usando Node.js e ambienti simili a Node, è possibile usare la classe DefaultAzureCredential per autenticare il client.

import { ConfidentialLedgerClient } from "@azure/arm-confidentialledger";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new ConfidentialLedgerClient(new DefaultAzureCredential(), subscriptionId);

Per gli ambienti del browser, usare il InteractiveBrowserCredential dal pacchetto di @azure/identity per l'autenticazione.

import { InteractiveBrowserCredential } from "@azure/identity";
import { ConfidentialLedgerClient } from "@azure/arm-confidentialledger";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new ConfidentialLedgerClient(credential, subscriptionId);

Pacchetto JavaScript

Per usare questa libreria client nel browser, è prima necessario usare un bundler. Per informazioni dettagliate su come eseguire questa operazione, vedere la documentazione di creazione di bundle .

Concetti chiave

ConfidentialLedgerClient

ConfidentialLedgerClient è l'interfaccia principale per gli sviluppatori che usano la libreria client Azure ConfidentialLedger. Esplorare i metodi in questo oggetto client per comprendere le diverse funzionalità del servizio Azure ConfidentialLedger a cui è possibile accedere.

Risoluzione dei problemi

Logging

L'abilitazione della registrazione può aiutare a individuare informazioni utili sugli errori. Per visualizzare un log di richieste e risposte HTTP, impostare la variabile di ambiente AZURE_LOG_LEVEL su info. In alternativa, la registrazione può essere abilitata in fase di esecuzione chiamando setLogLevel nel @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Per istruzioni più dettagliate su come abilitare i log, è possibile esaminare la documentazione del pacchetto @azure/logger.

Passaggi successivi

Per esempi dettagliati su come usare questa libreria, vedere gli esempi di directory.

Contributing

Per contribuire a questa libreria, leggere la guida contribuire per altre informazioni su come compilare e testare il codice.