Skip to main content

User Authentication

BotBuilder uses its dialogs for authentication via the OAuthPrompt. Teams SDK doesn't have any equivalent feature for dialogs, but we do support auth flows in our own way via our SignIn and SignOut methods.

using Microsoft.Bot.Builder;
using Microsoft.Bot.Builder.Dialogs;
using Microsoft.Bot.Schema;

public class MyActivityHandler : TeamsActivityHandler
{
    private readonly ConversationState _conversationState;
    private readonly UserState _userState;
    private readonly Dialog _dialog;

    public MyActivityHandler(string connectionName, ConversationState conversationState, UserState userState)
    {
        _conversationState = conversationState;
        _userState = userState;
        _dialog = new SignInDialog("signin", connectionName);
    }

    protected override async Task OnMessageActivityAsync(
        ITurnContext<IMessageActivity> turnContext,
        CancellationToken cancellationToken)
    {
        await _dialog.RunAsync(turnContext, _conversationState.CreateProperty<DialogState>("DialogState"), cancellationToken);
    }

    public override async Task OnTurnAsync(ITurnContext turnContext, CancellationToken cancellationToken = default)
    {
        await base.OnTurnAsync(turnContext, cancellationToken);
        await _conversationState.SaveChangesAsync(turnContext, false, cancellationToken);
        await _userState.SaveChangesAsync(turnContext, false, cancellationToken);
    }
}

public class SignInDialog : ComponentDialog
{
    private readonly string _connectionName;

    public SignInDialog(string id, string connectionName) : base(id)
    {
        _connectionName = connectionName;

        AddDialog(new OAuthPrompt("OAuthPrompt", new OAuthPromptSettings
        {
            ConnectionName = connectionName,
            Text = "Please Sign In",
            Title = "Sign In",
            Timeout = 300000
        }));

        AddDialog(new WaterfallDialog("Main", new WaterfallStep[]
        {
            PromptStepAsync,
            LoginStepAsync
        }));

        InitialDialogId = "Main";
    }

    private async Task<DialogTurnResult> PromptStepAsync(WaterfallStepContext stepContext, CancellationToken cancellationToken)
    {
        return await stepContext.BeginDialogAsync("OAuthPrompt", null, cancellationToken);
    }

    private async Task<DialogTurnResult> LoginStepAsync(WaterfallStepContext stepContext, CancellationToken cancellationToken)
    {
        await stepContext.Context.SendActivityAsync("You have been signed in.", cancellationToken: cancellationToken);
        return await stepContext.EndDialogAsync(null, cancellationToken);
    }
}

var storage = new MemoryStorage();
var conversationState = new ConversationState(storage);
var userState = new UserState(storage);
var handler = new MyActivityHandler(
    builder.Configuration["ConnectionName"],
    conversationState,
    userState
);