JavaScript için Azure Etki Alanı istemci kitaplığı - sürüm 4.1.0
Bu paket, Azure Domain istemcisi için bir isomorphic SDK (hem Node.js hem de tarayıcılarda çalışır) içerir.
AAD Etki Alanı Hizmetleri API'sini seçin.
Kaynak kodu | Paket (NPM) | API başvuru belgeleri | Örnekleri
Başlarken
Şu anda desteklenen ortamlar
- Node.jsLTS sürümleri
- Safari, Chrome, Edge ve Firefox'un en son sürümleri.
Daha fazla ayrıntı için destek ilkemize bakın.
Önkoşullar
- Bir Azure aboneliği.
@azure/arm-domainservices
paketini yükleyin
ile npm
JavaScript için Azure Etki Alanı istemci kitaplığını yükleyin:
npm install @azure/arm-domainservices
Oluşturma ve kimlik doğrulaması DomainServicesResourceProvider
Azure Etki Alanı API'sine erişmek üzere bir istemci nesnesi oluşturmak için Azure Etki Alanı kaynağınızın ve değerinin credential
olması gerekirendpoint
. Azure Domain istemcisi kimlik doğrulaması için Azure Active Directory kimlik bilgilerini kullanabilir.
Azure Etki Alanı kaynağınızın uç noktasını Azure Portal'da bulabilirsiniz.
@azure/kimlik kitaplığından veya mevcut bir AAD Belirtecinden kimlik bilgilerini kullanarak Azure Active Directory ile kimlik doğrulaması yapabilirsiniz.
Aşağıda gösterilen DefaultAzureCredential sağlayıcısını veya Azure SDK ile sağlanan diğer kimlik bilgileri sağlayıcılarını kullanmak için lütfen paketi yükleyin @azure/identity
:
npm install @azure/identity
Ayrıca yeni bir AAD uygulaması kaydetmeniz ve hizmet sorumlunuza uygun rolü atayarak Azure Etki Alanına erişim vermeniz gerekir (not: gibi "Owner"
roller gerekli izinleri vermez).
AAD uygulamasının istemci kimliği, kiracı kimliği ve istemci gizli dizisi değerlerini ortam değişkenleri olarak ayarlayın: AZURE_CLIENT_ID
, AZURE_TENANT_ID
, AZURE_CLIENT_SECRET
.
Azure AD Uygulaması oluşturma hakkında daha fazla bilgi için bu kılavuzu gözden geçirin.
const { DomainServicesResourceProvider } = require("@azure/arm-domainservices");
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 DomainServicesResourceProvider(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 DomainServicesResourceProvider(credential, subscriptionId);
JavaScript Paketi
Bu istemci kitaplığını tarayıcıda kullanmak için önce bir paketleyici kullanmanız gerekir. Bunun nasıl yapılacağının ayrıntıları için lütfen paketleme belgelerimize bakın.
Önemli kavramlar
DomainServicesResourceProvider
DomainServicesResourceProvider
, Azure Etki Alanı istemci kitaplığını kullanan geliştiriciler için birincil arabirimdir. Erişebileceğiniz Azure Etki Alanı hizmetinin farklı özelliklerini anlamak için bu istemci nesnesinde yöntemleri keşfedin.
Sorun giderme
Günlüğe Kaydetme
Günlüğün etkinleştirilmesi hatalarla ilgili yararlı bilgilerin ortaya çıkarılmasına yardımcı olabilir. HTTP isteklerinin ve yanıtlarının günlüğünü görmek için ortam değişkenini AZURE_LOG_LEVEL
olarak info
ayarlayın. Alternatif olarak, günlüğü çalışma zamanında içinde çağrılarak setLogLevel
@azure/logger
etkinleştirilebilir:
const { setLogLevel } = require("@azure/logger");
setLogLevel("info");
Günlükleri etkinleştirme hakkında daha ayrıntılı yönergeler için @azure/günlükçü paketi belgelerine bakabilirsiniz.
Sonraki adımlar
Bu kitaplığın nasıl kullanılacağına ilişkin ayrıntılı örnekler için lütfen samples dizinine göz atın.
Katkıda bulunma
Bu kitaplığa katkıda bulunmak isterseniz, kodu derleme ve test etme hakkında daha fazla bilgi edinmek için lütfen katkıda bulunma kılavuzunu okuyun.
İlgili projeler
Azure SDK for JavaScript
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin