IUserTokenProvider interface

Warning

This API is now deprecated.

Use UserTokenClient instead.

Interface for User Token OAuth APIs for BotAdapters

Methods

getAadTokens(TurnContext, string, string[])

Signs the user out with the token server.

getSignInLink(TurnContext, string)

Gets a signin link from the token server that can be sent as part of a SigninCard.

getTokenStatus(TurnContext, string, string, any)

Retrieves the token status for each configured connection for the given user, using the bot's AppCredentials.

getUserToken(TurnContext, string, string)

Retrieves the OAuth token for a user that is in a sign-in flow.

signOutUser(TurnContext, string, string)

Signs the user out with the token server.

Method Details

getAadTokens(TurnContext, string, string[])

Signs the user out with the token server.

function getAadTokens(context: TurnContext, connectionName: string, resourceUrls: string[]): Promise<[key: string]: TokenResponse>

Parameters

context
TurnContext

Context for the current turn of conversation with the user.

connectionName

string

Name of the auth connection to use.

resourceUrls

string[]

Returns

Promise<[key: string]: TokenResponse>

Gets a signin link from the token server that can be sent as part of a SigninCard.

function getSignInLink(context: TurnContext, connectionName: string): Promise<string>

Parameters

context
TurnContext

Context for the current turn of conversation with the user.

connectionName

string

Name of the auth connection to use.

Returns

Promise<string>

getTokenStatus(TurnContext, string, string, any)

Retrieves the token status for each configured connection for the given user, using the bot's AppCredentials.

function getTokenStatus(context: TurnContext, userId: string, includeFilter?: string, oAuthAppCredentials?: any): Promise<any[]>

Parameters

context
TurnContext

Context for the current turn of conversation with the user.

userId

string

The user Id for which token status is retrieved.

includeFilter

string

Comma separated list of connection's to include. Blank will return token status for all configured connections.

oAuthAppCredentials

any

The app credentials for OAuth.

Returns

Promise<any[]>

getUserToken(TurnContext, string, string)

Retrieves the OAuth token for a user that is in a sign-in flow.

function getUserToken(context: TurnContext, connectionName: string, magicCode?: string): Promise<TokenResponse>

Parameters

context
TurnContext

Context for the current turn of conversation with the user.

connectionName

string

Name of the auth connection to use.

magicCode

string

(Optional) Optional user entered code to validate.

Returns

Promise<TokenResponse>

signOutUser(TurnContext, string, string)

Signs the user out with the token server.

function signOutUser(context: TurnContext, connectionName: string, userId?: string): Promise<void>

Parameters

context
TurnContext

Context for the current turn of conversation with the user.

connectionName

string

Name of the auth connection to use.

userId

string

User id of user to sign out.

Returns

Promise<void>