Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.


NuGet Status Build status

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 :

Step 2 - Retrieve token

.NET Framework

For example, using a C# console application :

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

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.");

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) :


Gitter# Auth provide you a way to authenticate user on Gitter API





No releases published


No packages published