Språk

MicrosoftIdentityApplicationOptions Klass

Definition

Alternativ för att konfigurera autentisering för en webbapp, webb-API eller daemonprogram med hjälp av Azure Active Directory. Den har både AAD- och B2C-konfigurationsattribut.

public class MicrosoftIdentityApplicationOptions : Microsoft.Identity.Abstractions.MicrosoftEntraApplicationOptions
type MicrosoftIdentityApplicationOptions = class
    inherit MicrosoftEntraApplicationOptions
Public Class MicrosoftIdentityApplicationOptions
Inherits MicrosoftEntraApplicationOptions
Arv

Konstruktorer

Name Description
MicrosoftIdentityApplicationOptions()

Alternativ för att konfigurera autentisering för en webbapp, webb-API eller daemonprogram med hjälp av Azure Active Directory. Den har både AAD- och B2C-konfigurationsattribut.

Egenskaper

Name Description
AllowWebApiToBeAuthorizedByACL

Webb-API:er som anropas för en användares räkning kan verifiera en token baserat på omfång (som representerar delegerade behörigheter). Webb-API:er som anropas av daemonprogram kan verifiera en token baserat på roller (som representerar appbehörigheter). Webb-API:et verifierar som standard förekomsten av roller och omfång. Du kan ange att den här egenskapen false ska använda det ACL-baserade auktoriseringsmönstret för klienten (daemon) till webb-API:et. Om du använder ACL-baserad auktorisering utlöser implementeringen inte om roller eller omfång inte finns i anspråken. Mer information finns i https://aka.ms/ms-identity-web/daemon-ACL.

(Ärvd från IdentityApplicationOptions)
AppHomeTenantId

Hemklientorganisation för appen där appen kan hämta en token för att anropa ett underordnat API för sig själv.

(Ärvd från MicrosoftEntraApplicationOptions)
Audience

I ett webb-API visas målgruppen för de token som kommer att accepteras av webb-API:et.

Om webb-API:et accepterar flera målgrupper kan du läsa Audiences.

(Ärvd från IdentityApplicationOptions)
Audiences

I ett webb-API accepterade målgrupper för de token som tas emot av webb-API:et.

Se även Audience.

Målgruppen är den avsedda mottagaren av token. Du kan vanligtvis anta att ApplicationID för ditt webb-API är en giltig målgrupp. Det kan i allmänhet vara någon av de app-ID-URI:er (eller resursidentitetsfier) som du definierade för ditt program under registreringen i Azure portalen. (Ärvd från IdentityApplicationOptions)
Authority

Hämtar eller anger vilken utfärdare som ska användas när openidConnect-anrop ska göras. Som standard beräknas utfärdaren från Instance egenskaperna och TenantId genom att sammanfoga dem och lägga till "v2.0". Om din utfärdare inte är en Azure AD-utfärdare kan du ange den direkt här.

(Ärvd från MicrosoftEntraApplicationOptions)
AzureRegion

Anger den Azure regionen. Se även https://aka.ms/azure-region. Om du vill att appen ska försöka identifiera Azure-regionen automatiskt använder du "TryAutoDetect".

(Ärvd från MicrosoftEntraApplicationOptions)
ClientCapabilities

Anger funktionerna i klienten (till exempel {"cp1", "cp2"}). Detta är användbart för att uttrycka att klienten kan hantera anspråksutmaningen. Om ditt program är CAE-kompatibelt måste det uttrycka "cp1".

(Ärvd från MicrosoftEntraApplicationOptions)
ClientCredentials

Beskrivning av de klientautentiseringsuppgifter som appen tillhandahåller för att bevisa sin identitet för IdP: Se CredentialSource för listan över typer av autentiseringsuppgifter som stöds.

(Ärvd från IdentityApplicationOptions)
ClientId

Hämtar eller anger "client_id" (program-ID) som det visas i programregistreringen. Det här är strängrepresentationen av ett GUID.

(Ärvd från IdentityApplicationOptions)
DefaultUserFlow

Hämtar standardanvändarflödet (som är signUpsignIn).

Domain

Hämtar eller anger domänen för den Azure Active Directory klientorganisationen, t.ex. contoso.onmicrosoft.com.

EditProfilePolicyId

Hämtar eller anger användarflödesnamnet för redigeringsprofilen för B2C, t.ex. b2c_1_edit_profile.

EnablePiiLogging

Flagga som används för att aktivera/inaktivera loggning av personligt identifierbar information (PII). PII-loggar skrivs aldrig till standardutdata. Standardvärdet är inställt på false, vilket säkerställer att ditt program är kompatibelt med GDPR. Du kan ange det till true för avancerad felsökning som kräver PII.

(Ärvd från IdentityApplicationOptions)
ErrorPath

Anger sökvägen Felväg. Standardvärdet /MicrosoftIdentity/Account/Error är det värde som används av Microsoft. Identity.Web.UI.

ExtraQueryParameters

Anger frågeparametrar för frågesträngen i HTTP-begäran till IdP:t. Den här parametern är användbar om du vill skicka begäran till en specifik testsektor eller en viss domänkontrollant.

(Ärvd från IdentityApplicationOptions)
Instance

Hämtar eller anger den Azure Active Directory instansen, t.ex. "https://login.microsoftonline.com/".

(Ärvd från MicrosoftEntraApplicationOptions)
Name

Hämtar eller anger namnet på alternativen. Detta kan användas för att associera alternativen med ett namngivet alternativ i .NET IOptionsMonitor eller IOptionsSnapshot (eller ASP.NET Core autentiseringsscheman)

(Ärvd från MicrosoftEntraApplicationOptions)
ResetPasswordPath

Anger vägsökvägen ResetPassword (från webbplatsens rot). Standardvärdet är /MicrosoftIdentity/Account/ResetPassword, vilket är det värde som används av Microsoft. Identity.Web.UI. Om du åsidosätter den måste du ange en egen kontrollant/dina egna åtgärder.

ResetPasswordPolicyId

Hämtar eller anger namnet på återställningslösenordets användarflöde för B2C, t.ex. B2C_1_password_reset.

SendX5C

Anger om x5c-anspråket (certifikatets offentliga nyckel) ska skickas till STS. Genom att skicka x5c kan programutvecklare enkelt återställa certifikat i Azure AD: Den här metoden skickar det offentliga certifikatet till Azure AD tillsammans med tokenbegäran, så att Azure AD kan använda det för att verifiera ämnesnamnet baserat på en betrodd utfärdarprincip. Detta sparar programadministratören från behovet av att uttryckligen hantera certifikatet (antingen via appregistreringsportalen eller med Hjälp av PowerShell/CLI). Mer information finns i https://aka.ms/msal-net-sni. Standardvärdet är false.

(Ärvd från MicrosoftEntraApplicationOptions)
SignUpSignInPolicyId

Hämtar eller anger registrerings- eller inloggningsnamnet för användarflöde för B2C, t.ex. b2c_1_susi.

TenantId

Hämtar eller anger klientorganisations-ID. Om ditt program är flera klientorganisationer kan du också använda "common" om det stöder både arbets- och skolkonton eller personliga konton eller "organisationer" om ditt program endast stöder arbets- och skolkonton. Om ditt program är en enskild klientorganisation anger du den här egenskapen till klientorganisations-ID:t eller domännamnet. Om ditt program endast fungerar för Microsoft personliga konton använder du "konsumenter".

(Ärvd från MicrosoftEntraApplicationOptions)
TokenDecryptionCredentials

Beskrivning av de autentiseringsuppgifter (vanligtvis certifikat) som används för att dekryptera en krypterad token i ett webb-API.

(Ärvd från IdentityApplicationOptions)
WithSpaAuthCode

Om värdet är trueinställt på , när användaren loggar in i en webbapp, begär programmet en autentiseringskod för klientdelen (ensidesprogram som använder MSAL.js till exempel). Detta gör det möjligt för JavaScript-koden i klientdelen att kringgå att gå till auktorisera slutpunkten (som kräver att sidan läses in igen) genom att direkt lösa in autentiseringskoden för att få åtkomsttoken för att anropa API:er. Se https://aka.ms/msal-net/hybrid-spa-sample för mer information. Fungerar bara för AAD, inte B2C.

Gäller för