PublicClientApplication class

Yapılandırma nesnesinde kimlik doğrulaması için önemli öznitelikler şunlardır:

• clientID: Uygulamanızın uygulama kimliği. Uygulamanızı Uygulama kayıt portalımıza kaydederek bir tane edinebilirsiniz.
• authority: uygulamanızın yetkili URL'si.

AAD yetkilileri biçimindedir https://login.microsoftonline.com/{Enter_the_Tenant_Info_Here}.

• Uygulamanız tek bir kuruluş dizinindeki Hesapları destekliyorsa, "Enter_the_Tenant_Info_Here" değerini Kiracı Kimliği veya Kiracı adı (örneğin, contoso.microsoft.com) ile değiştirin.
• Uygulamanız herhangi bir kuruluş dizinindeki Hesapları destekliyorsa , "Enter_the_Tenant_Info_Here" değerini kuruluşlarla değiştirin.
• Uygulamanız herhangi bir kuruluş dizinindeki Hesaplar'ı ve kişisel Microsoft hesaplarını destekliyorsa, "Enter_the_Tenant_Info_Here" değerini ortak değerle değiştirin.
• Desteği yalnızca Kişisel Microsoft hesaplarıyla kısıtlamak için "Enter_the_Tenant_Info_Here" değerini tüketicilerle değiştirin.

Azure B2C yetkilileri{instance}/{tenant}/{policy} https:// biçimindedir. Her ilke kendi yetkisi olarak kabul edilir. İstemci uygulaması oluşturma sırasında tüm bilinenAuthorities değerini ayarlamanız gerekir.

ADFS yetkilileri https://{instance}/adfs biçimindedir.

new PublicClientApplication(configuration: Configuration)

Parametreler

OAuth2.0 cihaz kodu akışını kullanarak yetkiliden bir belirteç alır. Bu akış, tarayıcı erişimi olmayan veya giriş kısıtlamaları olan cihazlar için tasarlanmıştır. Yetkilendirme sunucusu doğrulama kodu, son kullanıcı kodu ve son kullanıcı doğrulama URI'siyle bir DeviceCode nesnesi gönderir. DeviceCode nesnesi bir geri çağırma yoluyla sağlanır ve son kullanıcıya kimlik bilgilerini giriş için doğrulama URI'sine gitmek için başka bir cihaz kullanması talimatı verilmelidir. İstemci gelen istekleri alamadığından, son kullanıcı kimlik bilgilerinin girişini tamamlayana kadar yetkilendirme sunucusunu tekrar tekrar yoklar.

function acquireTokenByDeviceCode(request: DeviceCodeRequest): Promise<null | AuthenticationResult>

Parametreler

Döndürülenler

Bir yetkilendirme kodu isteyerek ve ardından belirteç için değiştirerek tarayıcı aracılığıyla etkileşimli olarak belirteç alır.

function acquireTokenInteractive(request: InteractiveRequest): Promise<AuthenticationResult>

Parametreler

Döndürülenler

Önbellekten veya yeni erişim belirteci için yenileme belirtecini değiştirerek alınan bir belirteci döndürür. Aracı etkinleştirildiyse belirteç isteğine aracı tarafından hizmet verilecektir.

function acquireTokenSilent(request: SilentFlowRequest): Promise<AuthenticationResult>

Parametreler

Döndürülenler

Bu uygulama için önbelleğe alınmış tüm hesapları döndürür. Aracı etkinleştirildiyse bu istek aracı tarafından karşılanır.

function getAllAccounts(): Promise<AccountInfo[]>

Döndürülenler

Verilen hesapla ilişkili önbellek yapıtlarını kaldırır

function signOut(request: SignOutRequest): Promise<void>

Parametreler

Döndürülenler

OAuth2.0 Yetkilendirme Kodu akışının ilk adımından alınan Yetkilendirme Kodunu değiştirerek bir belirteç alır.

getAuthCodeUrl(AuthorizationCodeUrlRequest) OAuth2.0 Yetkilendirme Kodu akışının ilk adımının URL'sini oluşturmak için kullanılabilir. AuthorizationCodeUrlRequest ve AuthorizationCodeRequest içindeki redirectUri ve kapsam değerlerinin aynı olduğundan emin olun.

function acquireTokenByCode(request: AuthorizationCodeRequest, authCodePayLoad?: AuthorizationCodePayload): Promise<AuthenticationResult>

Parametreler

Döndürülenler

ClientApplication.acquireTokenByCode'danDevralındı

Yeni bir belirteç kümesi için sağlanan yenileme belirtecini değiştirerek bir belirteç alır.

Bu API yalnızca ADAL'dan MSAL'ye geçiş yapmak istediğiniz senaryolar için sağlanır. Aksi takdirde, sessiz senaryolar için kullanmanız acquireTokenSilent() önerilir. kullanırken acquireTokenSilent()MSAL, belirteçlerin önbelleğe alınmasını ve yenilenmesini otomatik olarak işler.

function acquireTokenByRefreshToken(request: RefreshTokenRequest): Promise<null | AuthenticationResult>

Parametreler

Döndürülenler

ClientApplication.acquireTokenByRefreshToken'danDevralındı

Kimlik bilgileri için istemci uygulamalarının kullanıcı adını ve parolasını değiştirerek parola verme ile belirteçleri alır

En son OAuth 2.0 Güvenlik En İyi Güncel Uygulaması, parolanın verilmesine tamamen izin vermez. Microsoft belgelerinde ve önerilerinde bu öneriyle https://tools.ietf.org/html/draft-ietf-oauth-security-topics-13#section-3.4 ilgili diğer ayrıntılar şunlardır:https://docs.microsoft.com/en-us/azure/active-directory/develop/msal-authentication-flows#usernamepassword

function acquireTokenByUsernamePassword(request: UsernamePasswordRequest): Promise<null | AuthenticationResult>

Parametreler

Döndürülenler

ClientApplication.acquireTokenByUsernamePassword'danDevralındı

Önbelleği temizleme

function clearCache()

ClientApplication.clearCache'tenDevralındı

Kullanıcının uygulamaya kimlik bilgileri girip onay vermesine izin vererek yetkilendirme isteğinin URL'sini oluşturur. URL, uygulama nesnesinde yapılandırılan yetkilinin /authorize uç noktasını hedefler.

Kullanıcı kimlik bilgilerini ve onaylarını girdikten sonra, yetkili istekte gönderilen yeniden yönlendirme URI'sine bir yanıt gönderir ve daha sonra aracılığıyla acquireTokenByCode(AuthorizationCodeRequest)belirteç almak için kullanılabilecek bir yetkilendirme kodu içermelidir.

function getAuthCodeUrl(request: AuthorizationUrlRequest): Promise<string>

Parametreler

Döndürülenler

ClientApplication.getAuthCodeUrl'danDevralındı

Günlükçü örneğini verir

function getLogger(): Logger

Döndürülenler

ClientApplication.getLogger'danDevralındı

Uygulama için belirteç önbelleğini alır.

function getTokenCache(): TokenCache

Döndürülenler

ClientApplication.getTokenCache ÖğesindenDevralındı

Yapılandırmalardaki varsayılan günlükçü kümesini yeni Günlükçü ile yeni yapılandırmalarla değiştirir

function setLogger(logger: Logger)

Parametreler

ClientApplication.setLogger'danDevralındı