VatsimSSO 1.0.0

VATSIM SSO

An OAuth 1.0 wrapper designed to easily implement the VATSIM SSO system in C# web applications.

Installation

PM> Install-Package VatsimSSO

Dependencies will be pulled at the same time.

Implementation

Initial login token

The code below will return the login token used to authenticate the user when redirecting to the SSO server (either the demo or the production servers).

// Client object
VatsimSSO r = new VatsimSSO("CONSUMER_KEY", "CONSUMER_SECRET", "https://cert.vatsim.net/sso/api/", "CALLBACK_URI");

// Get the request token
var RequestToken = r.GetRequestToken();

The token returned is a dynamic object with three properties: oauth_token, oauth_token_secret and oauth_callback_confirmed. A redirect example in ASP.NET would look like this:

return Redirect("https://cert.vatsim.net/sso/auth/pre_login/?oauth_token=" + RequestToken.oauth_token);

Returned user data

The below code will return a JSON string of the information for the user that has just logged in, using the access token, secret and verifier.

// Client object
VatsimSSO r = new VatsimSSO("CONSUMER_KEY", "CONSUMER_SECRET", "https://cert.vatsim.net/sso/api/", Token: oauth_token, Verifier: oauth_verifier, TokenSecret: oauth_token_secret);

// Json string
string Results = r.ReturnData();

An example of such JSON response would be:

{"request":{"result":"success","message":""},"user":{"id":"1300007","name_first":"7th","name_last":"Test","rating":{"id":"7","short":"C3","long":"Senior Controller","GRP":"Senior Controller"},"pilot_rating":{"rating":"0"},"email":"noreply@vatsim.net","experience":"N","reg_date":"2014-05-14 17:17:26","country":{"code":"GB","name":"United Kingdom"},"region":{"code":"USA-S","name":"South America"},"division":{"code":"CAM","name":"Central America"},"subdivision":{"code":null,"name":null}}}

Please open up an issue if there are any problems or feel free to post on the forum thread.