@azure/msal-react package

Schnittstellen

IMsalContext

Functions

AuthenticatedTemplate(PropsWithChildren<Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>>)

Rendert untergeordnete Komponenten, wenn der Benutzer authentifiziert ist

MsalAuthenticationTemplate(PropsWithChildren<Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">> & { authenticationRequest?: PopupRequest | RedirectRequest | Partial<Omit<CommonAuthorizationUrlRequest, "responseMode" | "earJwk" | "codeChallenge" | "codeChallengeMethod" | "requestedClaimsHash" | "platformBroker">>, errorComponent?: any, interactionType: InteractionType, loadingComponent?: any }>)

Versucht, den Benutzer zu authentifizieren, wenn er noch nicht authentifiziert ist, und rendert dann untergeordnete Komponenten.

MsalProvider(PropsWithChildren<{ instance: IPublicClientApplication }>)

MSAL-Kontextanbieterkomponente. Dies muss über allen anderen Komponenten gerendert werden, die MSAL verwenden.

UnauthenticatedTemplate(PropsWithChildren<Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>>)

Rendert untergeordnete Komponenten, wenn der Benutzer nicht authentifiziert ist

useAccount(Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>)

Bei 1 oder mehr accountIdentifiers wird das Account-Objekt zurückgegeben, wenn der Benutzer angemeldet ist.

useIsAuthenticated(Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>)

Gibt zurück, ob ein Benutzer aktuell angemeldet ist. Stellen Sie optional 1 oder mehr accountIdentifier bereit, um festzustellen, ob ein bestimmter Benutzer angemeldet ist.

useMsal()

Gibt Msal Context-Werte zurück.

useMsalAuthentication(InteractionType, PopupRequest | RedirectRequest | Partial<Omit<CommonAuthorizationUrlRequest, "responseMode" | "earJwk" | "codeChallenge" | "codeChallengeMethod" | "requestedClaimsHash" | "platformBroker">>, Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>)

Wenn ein Benutzer derzeit nicht bei diesem Hook angemeldet ist, wird eine Anmeldung aufgerufen. Fehlgeschlagene Anmeldungen können mithilfe des zurückgegebenen Anmelderückrufs erneut ausgeführt werden. Wenn ein Benutzer derzeit bei diesem Hook angemeldet ist, versucht, ein Token zu erwerben. Nachfolgende Tokenanforderungen können den zurückgegebenen AcquireToken-Rückruf verwenden. Geben Sie optional ein Anforderungsobjekt an, das im Login/AcquireToken-Aufruf verwendet werden soll. Geben Sie optional einen bestimmten Benutzer an, der angemeldet werden soll.

withMsal<P>(ComponentType<P>)

Komponente mit höherer Reihenfolge umschließt die bereitgestellte Komponente mit Msal, indem Sie msal-Kontextwerte in die Eigenschaften der Komponente einfügen

Details zur Funktion

AuthenticatedTemplate(PropsWithChildren<Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>>)

Rendert untergeordnete Komponenten, wenn der Benutzer authentifiziert ist

function AuthenticatedTemplate(props: PropsWithChildren<Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>>): React.ReactElement | null

Parameter

props

PropsWithChildren<Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>>

Gibt zurück

React.ReactElement | null

MsalAuthenticationTemplate(PropsWithChildren<Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">> & { authenticationRequest?: PopupRequest | RedirectRequest | Partial<Omit<CommonAuthorizationUrlRequest, "responseMode" | "earJwk" | "codeChallenge" | "codeChallengeMethod" | "requestedClaimsHash" | "platformBroker">>, errorComponent?: any, interactionType: InteractionType, loadingComponent?: any }>)

Versucht, den Benutzer zu authentifizieren, wenn er noch nicht authentifiziert ist, und rendert dann untergeordnete Komponenten.

function MsalAuthenticationTemplate(props: PropsWithChildren<Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">> & { authenticationRequest?: PopupRequest | RedirectRequest | Partial<Omit<CommonAuthorizationUrlRequest, "responseMode" | "earJwk" | "codeChallenge" | "codeChallengeMethod" | "requestedClaimsHash" | "platformBroker">>, errorComponent?: any, interactionType: InteractionType, loadingComponent?: any }>): React.ReactElement | null

Parameter

props

PropsWithChildren<Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">> & { authenticationRequest?: PopupRequest | RedirectRequest | Partial<Omit<CommonAuthorizationUrlRequest, "responseMode" | "earJwk" | "codeChallenge" | "codeChallengeMethod" | "requestedClaimsHash" | "platformBroker">>, errorComponent?: any, interactionType: InteractionType, loadingComponent?: any }>

Gibt zurück

React.ReactElement | null

MsalProvider(PropsWithChildren<{ instance: IPublicClientApplication }>)

MSAL-Kontextanbieterkomponente. Dies muss über allen anderen Komponenten gerendert werden, die MSAL verwenden.

function MsalProvider(__namedParameters: PropsWithChildren<{ instance: IPublicClientApplication }>): React.ReactElement

Parameter

__namedParameters

PropsWithChildren<{ instance: IPublicClientApplication }>

Gibt zurück

React.ReactElement

UnauthenticatedTemplate(PropsWithChildren<Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>>)

Rendert untergeordnete Komponenten, wenn der Benutzer nicht authentifiziert ist

function UnauthenticatedTemplate(props: PropsWithChildren<Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>>): React.ReactElement | null

Parameter

props

PropsWithChildren<Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>>

Gibt zurück

React.ReactElement | null

useAccount(Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>)

Bei 1 oder mehr accountIdentifiers wird das Account-Objekt zurückgegeben, wenn der Benutzer angemeldet ist.

function useAccount(accountIdentifiers?: Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>): AccountInfo | null

Parameter

accountIdentifiers

Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>

Gibt zurück

AccountInfo | null

useIsAuthenticated(Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>)

Gibt zurück, ob ein Benutzer aktuell angemeldet ist. Stellen Sie optional 1 oder mehr accountIdentifier bereit, um festzustellen, ob ein bestimmter Benutzer angemeldet ist.

function useIsAuthenticated(matchAccount?: Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>): boolean

Parameter

matchAccount

Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>

Gibt zurück

boolean

useMsal()

Gibt Msal Context-Werte zurück.

function useMsal(): IMsalContext

Gibt zurück

useMsalAuthentication(InteractionType, PopupRequest | RedirectRequest | Partial<Omit<CommonAuthorizationUrlRequest, "responseMode" | "earJwk" | "codeChallenge" | "codeChallengeMethod" | "requestedClaimsHash" | "platformBroker">>, Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>)

Wenn ein Benutzer derzeit nicht bei diesem Hook angemeldet ist, wird eine Anmeldung aufgerufen. Fehlgeschlagene Anmeldungen können mithilfe des zurückgegebenen Anmelderückrufs erneut ausgeführt werden. Wenn ein Benutzer derzeit bei diesem Hook angemeldet ist, versucht, ein Token zu erwerben. Nachfolgende Tokenanforderungen können den zurückgegebenen AcquireToken-Rückruf verwenden. Geben Sie optional ein Anforderungsobjekt an, das im Login/AcquireToken-Aufruf verwendet werden soll. Geben Sie optional einen bestimmten Benutzer an, der angemeldet werden soll.

function useMsalAuthentication(interactionType: InteractionType, authenticationRequest?: PopupRequest | RedirectRequest | Partial<Omit<CommonAuthorizationUrlRequest, "responseMode" | "earJwk" | "codeChallenge" | "codeChallengeMethod" | "requestedClaimsHash" | "platformBroker">>, accountIdentifiers?: Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>): MsalAuthenticationResult

Parameter

interactionType
InteractionType
authenticationRequest

PopupRequest | RedirectRequest | Partial<Omit<CommonAuthorizationUrlRequest, "responseMode" | "earJwk" | "codeChallenge" | "codeChallengeMethod" | "requestedClaimsHash" | "platformBroker">>

accountIdentifiers

Partial<Pick<AccountInfo, "homeAccountId" | "localAccountId" | "username">>

Gibt zurück

withMsal<P>(ComponentType<P>)

Komponente mit höherer Reihenfolge umschließt die bereitgestellte Komponente mit Msal, indem Sie msal-Kontextwerte in die Eigenschaften der Komponente einfügen

function withMsal<P>(Component: ComponentType<P>): FunctionComponent<Subtract<P, WithMsalProps>>

Parameter

Component

ComponentType<P>

Gibt zurück

FunctionComponent<Subtract<P, WithMsalProps>>

Details zu Variablen

MsalConsumer

MsalConsumer: React.Consumer<IMsalContext>

Typ

React.Consumer<IMsalContext>

MsalContext

MsalContext: React.Context<IMsalContext>

Typ

React.Context<IMsalContext>

version

version: "3.0.29"

Typ

"3.0.29"