gitter-api-auth

Gitter# Auth provide you a way to authenticate user on Gitter API. You can use Gitter# Auth on these platforms :

• Windows 8.1 (Store Apps)
• Windows Phone 8.1
• Windows 10
• .NET Framework 4.5
• Xamarin.Android [planned]
• Xamarin.iOS [planned]

Authentication process

The authentication is divided in 2 steps that allow you to retrieve a Gitter token. These 2 steps can be found in a single service :

public class AuthenticationService
{
    public async Task<bool?> LoginAsync(string oauthKey, string oauthSecret)
    {
        ...
    }

    public async Task<string> RetrieveTokenAsync(...)
    {
        ...
    }
}

Step 1 - Execute login

.NET Framework

string Login(string oauthKey, string oauthSecret);

Using .NET Framework, we load a browser window and once we get a result we automatically call to generate a token.

Windows 8.1 / Windows 10

Task<bool?> LoginAsync(string oauthKey, string oauthSecret);

On Windows 8.1 / 10 and Windows Phone 8.1, the login process use a service called WebAuthenticationBroker through OAuth2. This method requires your OauthKey and your OauthSecret. You can retrieve these parameters from the developer website : https://developer.gitter.im/docs/authentication.

Step 2 - Retrieve token

.NET Framework

For example, using a C# console application :

private static string _oauthKey = "<key>";
private static string _oauthSecret = "<secret>";

[STAThread]
static void Main(string[] args)
{
    var authenticationService = new AuthenticationService();
    string token = authenticationService.Login(_oauthKey, _oauthSecret);

    // Now you can use the token with the Gitter Api

    Console.WriteLine("Press any key to exit.");
    Console.ReadKey();
}

Windows 8.1 / Windows 10

Task<string> RetrieveTokenAsync();

On Windows 8.1 / 10, once you're authenticated (cf. step 1), you only have to retrieve the provided token as it is.

Windows Phone 8.1

Task<string> RetrieveTokenAsync(WebAuthenticationBrokerContinuationEventArgs args);

On Windows Phone 8.1, it is a little different, you have to pass a parameter : WebAuthenticationBrokerContinuationEventArgs. This event result comes from the continuation service of the WebAuthenticationBroker.

Here is an example of how to implement OAuth2 authentication using WebAuthenticationBroker on Universal Apps (W8.1 / WP8.1) : https://code.msdn.microsoft.com/windowsapps/Authentication-using-bb28840e#content.