ActionScript OAuth 2.0 Library

An ActionScript 3 library for interfacing with OAuth 2.0 services, implemented according to the OAuth 2.0 v2.15 specification.

Overview

This library is built for use with Flash/Flex/AIR projects to facilitate communication with OAuth 2.0 services. It provides mechanisms to authenticate against OAuth 2.0 servers using all standard authentication and authorization workflows.

This project was first mentioned in my blog post at http://blogs.adobe.com/charles/2012/05/oauth-2-0-library-for-actionscript.html.

Features

The ActionScript OAuth 2.0 Library supports the following features...

• Ability to fetch an access token via the OAuth 2.0 supported workflows...
  • Authorization Code Grant workflow
  • Implicit Grant workflow
  • Resource Owner Password Credentials workflow
• Ability to refresh an access token
• Robust and adjustable logging
• Ability to log in, view, and interact with the user consent page within a given StageWebView object

Dependencies

• as3corelib
• as3commons-logging

Reference

Usage

To use the library, simply drop in the SWC (or the source) into your project, along with the appropriate dependencies, and follow the usage below...

// set up our StageWebView object to use our visible stage
stageWebView.stage = stage;
 
// set up the call
var oauth2:OAuth2 = new OAuth2("https://accounts.google.com/o/oauth2/auth", "https://accounts.google.com/o/oauth2/token", LogSetupLevel.ALL);
var grant:IGrantType = new AuthorizationCodeGrant(stageWebView,						// the StageWebView object for which to display the user consent screen
												  "INSERT_CLIENT_ID_HERE",			// your client ID
												  "INSERT_CLIENT_SECRET_HERE",		// your client secret
												  "INSERT_REDIRECT_URI_HERE",		// your redirect URI
												  "INSERT_SCOPE_HERE",				// (optional) your scope
												  "INSERT_STATE_HERE");				// (optional) your state
 
// make the call
oauth2.addEventListener(GetAccessTokenEvent.TYPE, onGetAccessToken);
oauth2.getAccessToken(grant);
 
function onGetAccessToken(getAccessTokenEvent:GetAccessTokenEvent):void
{
	if (getAccessTokenEvent.errorCode == null && getAccessTokenEvent.errorMessage == null)
	{
		// success!
		trace("Your access token value is: " + getAccessTokenEvent.accessToken);
	}
	else
	{
		// fail :(
	}
}  // onGetAccessToken

Demo

• Demo description: http://blogs.adobe.com/charles/2012/05/oauth-2-0-library-for-actionscript.html
• Demo source: https://github.com/charlesbihis/sandbox/tree/master/actionscript/actionscript-oauth2-mobile-demo

Documentation

You can find the full ASDocs for the project here.

Author

• Created by Charles Bihis
• Website: www.whoischarles.com
• E-mail: [email protected]
• Twitter: @charlesbihis

License

The ActionScript OAuth 2.0 Library is licensed under the Apache License, Version 2.0.