Sdílet prostřednictvím

Klientská knihovna Azure ExternalIdentitiesConfiguration pro JavaScript – verze 1.0.3

  • Článek

Tento balíček obsahuje izomorfní sadu SDK (spouští se v Node.js i v prohlížečích) pro klienta Azure ExternalIdentitiesConfiguration.

Klient konfigurace externích identit

Zdrojový kód | Balíček (NPM) | Referenční dokumentace k | rozhraní API Vzorky

Začínáme

Aktuálně podporovaná prostředí

  • LtS verze Node.js
  • Nejnovější verze prohlížečů Safari, Chrome, Edge a Firefox.

Další podrobnosti najdete v našich zásadách podpory .

Požadavky

Nainstalujte balíček @azure/arm-azureadexternalidentities.

Nainstalujte klientskou knihovnu Azure ExternalIdentitiesConfiguration pro JavaScript pomocí npmpříkazu :

npm install @azure/arm-azureadexternalidentities

Vytvoření a ověření ExternalIdentitiesConfigurationClient

Pokud chcete vytvořit objekt klienta pro přístup k rozhraní API Azure ExternalIdentitiesConfiguration, budete potřebovat endpoint prostředek Azure ExternalIdentitiesConfiguration a credential. Klient Azure ExternalIdentitiesConfiguration může k ověření použít přihlašovací údaje Azure Active Directory. Koncový bod pro prostředek Azure ExternalIdentitiesConfiguration najdete na webu Azure Portal.

K ověření můžete použít Azure Active Directory přihlašovací údaje z knihovny @azure/identity nebo existujícího tokenu AAD.

Pokud chcete použít zprostředkovatele DefaultAzureCredential uvedeného níže nebo jiné zprostředkovatele přihlašovacích údajů poskytnuté se sadou Azure SDK, nainstalujte @azure/identity balíček :

npm install @azure/identity

Budete také muset zaregistrovat novou aplikaci AAD a udělit přístup k Azure ExternalIdentitiesConfiguration přiřazením vhodné role k instančnímu objektu (poznámka: Role, jako "Owner" jsou, neudělují potřebná oprávnění). Nastavte hodnoty ID klienta, ID tenanta a tajného klíče klienta aplikace AAD jako proměnné prostředí: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

Další informace o tom, jak vytvořit aplikaci Azure AD, najdete v tomto průvodci.

const { ExternalIdentitiesConfigurationClient } = require("@azure/arm-azureadexternalidentities");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.

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

// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
//   tenantId: "<YOUR_TENANT_ID>",
//   clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new ExternalIdentitiesConfigurationClient(credential, subscriptionId);

JavaScript Bundle

Pokud chcete tuto klientskou knihovnu používat v prohlížeči, musíte nejprve použít nástroj bundler. Podrobnosti o tom, jak to udělat, najdete v naší dokumentaci k sdružování.

Klíčové koncepty

ExternalIdentitiesConfigurationClient

ExternalIdentitiesConfigurationClient je primární rozhraní pro vývojáře, kteří používají klientskou knihovnu Azure ExternalIdentitiesConfiguration. Prozkoumejte metody tohoto objektu klienta, abyste porozuměli různým funkcím služby Azure ExternalIdentitiesConfiguration, ke které máte přístup.

Řešení potíží

protokolování

Povolení protokolování může pomoct odhalit užitečné informace o selháních. Pokud chcete zobrazit protokol požadavků a odpovědí HTTP, nastavte proměnnou AZURE_LOG_LEVEL prostředí na info. Případně je možné protokolování povolit za běhu voláním setLogLevel v :@azure/logger

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

Podrobnější pokyny k povolení protokolů najdete v dokumentaci k balíčkům @azure/protokolovacího nástroje.

Další kroky

Podrobné příklady použití této knihovny najdete v adresáři ukázek .

Přispívání

Pokud chcete přispívat do této knihovny, přečtěte si příručku pro přispívání , kde najdete další informace o tom, jak sestavit a otestovat kód.

Imprese