Udostępnij za pomocą


Azure KeyVaultManagement client library for JavaScript - wersja 4.0.0

Ten pakiet zawiera izomorficzne SDK (działające zarówno w Node.js, jak i w przeglądarkach) dla klienta Azure KeyVaultManagement.

API zarządzania Azure oferuje zestaw usług RESTful współpracujących z Azure Key Vault.

Dokumentacja referencyjna interfejsu APIkodu źródłowego (NPM)Przykłady

Wprowadzenie

Obecnie obsługiwane środowiska

  • Wersje LTS systemu Node.js
  • Najnowsze wersje przeglądarek Safari, Chrome, Edge i Firefox.

Aby uzyskać więcej informacji, zobacz nasze zasad pomocy technicznej.

Wymagania wstępne

Instalowanie pakietu @azure/arm-keyvault

Zainstaluj bibliotekę klienta Azure KeyVaultManagement dla JavaScript za pomocą npm:

npm install @azure/arm-keyvault

Twórz i uwierzytelnij KeyVaultManagementClient

Aby utworzyć obiekt klienta do dostępu do API Azure KeyVaultManagement, będziesz potrzebować swojego endpoint zasobu Azure KeyVaultManagement oraz .credential Klient Azure KeyVaultManagement może używać poświadczeń uwierzytelniających Azure Active Directory. Punkt końcowy dla swojego zasobu Azure KeyVaultManagement znajdziesz w Azure Portal.

Możesz uwierzytelnić się w usłudze Azure Active Directory przy użyciu poświadczeń z biblioteki @azure/tożsamości lub istniejącego tokenu usługi AAD.

Aby użyć dostawcy DefaultAzureCredential pokazanego poniżej lub innych dostawców poświadczeń dostarczonych z zestawem Azure SDK, zainstaluj pakiet @azure/identity:

npm install @azure/identity

Będziesz także musiał zarejestrować nową aplikację AAD i przyznać dostęp do Azure KeyVaultManagement , przypisując odpowiednią rolę swojemu podmiotowi usługowemu (uwaga: role takie jak np. "Owner" nie przyznają niezbędnych uprawnień).

Aby uzyskać więcej informacji na temat tworzenia aplikacji usługi Azure AD, zobacz tym przewodniku.

Korzystając ze środowisk Node.js i środowisk podobnych do węzłów, możesz użyć klasy DefaultAzureCredential do uwierzytelniania klienta.

import { KeyVaultManagementClient } from "@azure/arm-keyvault";
import { DefaultAzureCredential } from "@azure/identity";

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

W przypadku środowisk przeglądarki użyj InteractiveBrowserCredential z pakietu @azure/identity do uwierzytelniania.

import { InteractiveBrowserCredential } from "@azure/identity";
import { KeyVaultManagementClient } from "@azure/arm-keyvault";

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

Pakiet JavaScript

Aby użyć tej biblioteki klienta w przeglądarce, najpierw należy użyć pakietu. Aby uzyskać szczegółowe informacje o tym, jak to zrobić, zapoznaj się z naszą dokumentacją dotyczącą tworzenia pakietów .

Najważniejsze pojęcia

KeyVaultManagementClient

KeyVaultManagementClient jest głównym interfejsem dla deweloperów korzystających z biblioteki klienta Azure KeyVaultManagement. Poznaj metody tego obiektu klienta, aby zrozumieć różne funkcje usługi Azure KeyVaultManagement, do których masz dostęp.

Rozwiązywanie problemów

Przemysł drzewny

Włączenie rejestrowania może pomóc odkryć przydatne informacje o błędach. Aby wyświetlić dziennik żądań i odpowiedzi HTTP, ustaw zmienną środowiskową AZURE_LOG_LEVEL na info. Alternatywnie rejestrowanie można włączyć w czasie wykonywania, wywołując setLogLevel w @azure/logger:

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

setLogLevel("info");

Aby uzyskać bardziej szczegółowe instrukcje dotyczące włączania dzienników, zapoznaj się z dokumentami dotyczącymi pakietów @azure/rejestratora.

Dalsze kroki

Zapoznaj się z przykładami katalogu, aby zapoznać się ze szczegółowymi przykładami dotyczącymi korzystania z tej biblioteki.

Contributing

Jeśli chcesz współtworzyć tę bibliotekę, przeczytaj przewodnik dotyczący współtworzenia , aby dowiedzieć się więcej na temat tworzenia i testowania kodu.