BotAuth

botauth is still pre-release and under active development. Please evaluate and provide feedback.

botauth is authentication middleware for bots built using the botframework and nodejs. botauth is leverages passportjs authentication strategies to help bot developers connect to 3rd party oauth providers. You can use botauth to connect your bot's users to their Facebook, Dropbox, or any other API protected by OAuth 2.0.

Setup

botauth is available as an npm package

npm install --save botauth

Getting Started

Create a BotAuthenticator object to configure authentication for your bot.

const botauth = require("botauth");
const DropboxOAuth2Strategy = require("passport-dropbox-oauth2").Strategy;

...

// Initialize with the strategies we want to use
var auth = new botauth.BotAuthenticator(server, bot, {
	secret : "something secret",
	baseUrl : "https://" + WEBSITE_HOSTNAME }
);

// Configure the Dropbox authentication provider using the passport-dropbox strategy
auth.provider("dropbox",
	function(options) {
		return new DropboxOAuth2Strategy(
			{
    				clientID : DROPBOX_APP_ID,
    				clientSecret : DROPBOX_APP_SECRET,
					callbackURL : options.callbackURL
			},
			function(accessToken, refreshToken, profile, done) {
				profile.accessToken = accessToken;
				profile.refreshToken = refreshToken;
				done(null, profile);
			}
		);
	}
);

Authenticated Dialog

Use the authenticate method to make sure that the user has authenticated with a OAuth provider before continuing the dialog waterfall steps. botauth puts the user profile from the passport strategy in session.userData.botauth. authenticate returns an array of dialog steps which can be combined with your own dialog steps. Anything after authenticate will only be reached if the user successfully authenticates.

bot.dialog('/dropbox', [].concat(
	auth.authenticate("dropbox"), //use authenticate as a waterfall step
	function(session, results) {
		// this waterfall step will only be reached if authentication succeeded

		var user = auth.profile(session, "dropbox");
		session.endDialog("Welcome " + user.displayName);
	}
));

Examples

• Facebook
• Pinterest
• Dropbox
• Rakuten
• Evernote
• Azure AD v1 (coming soon)
• Azure AD v2
• Visual Studio Online (coming soon)

More sample code is available at https://github.com/mattdot/botauth/tree/master/examples/

#About this project This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.