Click here to Skip to main content
15,867,686 members
Articles / Programming Languages / C#

Twitter OAuth authentication using .NET

Rate me:
Please Sign up or sign in to vote.
4.79/5 (31 votes)
26 Aug 2014CPOL3 min read 281.4K   7.5K   52   87
A example showing how to authenticate a Twitter application using oAuth and the application access token.

Introduction

In this article, I want to demonstrate how to implement OAuth authentication in .NET. I've previously written about my dislike of third party SDKs for social media integration and how we should leverage technology based solutions instead. One of the sticking points in doing this tends to be that implementing OAuth based authentication is relatively difficult compared with actually making the requests themselves. There is documentation available, but there seems to be a lack of .NET example code to go with it.

In keeping with my thoughts in previous articles, I would recommend using open source OAuth based libraries to solve this problem, and again avoid resorting to third party Twitter/Facebook implementations which more strongly couple code to specific APIs. This keeps the solution more reusable and builds on specific technologies to better future proof your application.

I've also previously shown how client-side plug-ins can be used in combination with server-side code to speed development in this area. However, sometimes authentication does need to be implemented purely on the server-side.

So how difficult is this?

It turns out implementing OAuth on the server-side in .NET isn't too difficult, the battle is getting the encoding and authentication signature right. With so few examples, it can be a little daunting, so here's an example written in pure .NET using the official Twitter OAuth documentation and a bit of trial and error.

Background

The following example shows how to authenticate against the Twitter APIs using a registered Twitter application. Any interaction with the APIs when authenticated in this manner will behave as if coming from the Twitter account under which the application has been registered. It's therefore useful for sending out status updates or sending out notifications from a specific account.

Usually OAuth requires redirecting the user to a login screen to obtain an oAuth token which requires a bit more work. However, when authenticating via a Twitter application, this step is skipped as your application already has an oAuth token provided (access token). Whether you are using the application oAuth token or a user oAuth token, the following code can be used to authenticate against the Twitter APIs.

The Code

The first step is to visit the Twitter developer section and register a new application. On completion, you will be provided with a set of public/private keys which you will need the replace in the example below in order to run. The values I have used directly correspond with the documented example here. Make sure you replace them with your own.

C#
var oauth_token           = "819797-Jxq8aYUDRmykzVKrgoLhXSq67TEa5ruc4GJC2rWimw";
var oauth_token_secret    = "J6zix3FfA9LofH0awS24M3HcBYXO5nI1iYe8EfBA";
var oauth_consumer_key    = "GDdmIQH6jhtmLUypg82g";
var oauth_consumer_secret = "MCD8BKwGdgPHvAuvgvz4EQpqDAtx89grbuNMRd7Eh98";

We also need to define some details about the request. This includes a unique oauth_nonce parameter which must be generated per request, and a timestamp.

C#
var oauth_version          = "1.0";
var oauth_signature_method = "HMAC-SHA1";
var oauth_nonce            = Convert.ToBase64String(
                                  new ASCIIEncoding().GetBytes(
                                       DateTime.Now.Ticks.ToString()));
var timeSpan               = DateTime.UtcNow
                                  - new DateTime(1970, 1, 1, 0, 0, 0, 0,
                                       DateTimeKind.Utc);
var oauth_timestamp        = Convert.ToInt64(timeSpan.TotalSeconds).ToString();
var resource_url           = "https://api.twitter.com/1.1/statuses/update.json";
var status                 = "Updating status via REST API if this works";

The next step is to generate an encrypted oAuth signature which Twitter will use to validate the request. To do this, all of the request data is concatenated into a particular format as follows.

C#
var baseFormat = "oauth_consumer_key={0}&oauth_nonce={1}&oauth_signature_method={2}" +
                "&oauth_timestamp={3}&oauth_token={4}&oauth_version={5}&status={6}";

var baseString = string.Format(baseFormat,
                            oauth_consumer_key,
                            oauth_nonce,
                            oauth_signature_method,
                            oauth_timestamp,
                            oauth_token,
                            oauth_version,
                            Uri.EscapeDataString(status)
                            );

baseString = string.Concat("POST&", Uri.EscapeDataString(resource_url), 
             "&", Uri.EscapeDataString(baseString));

Using this base string, we then encrypt the data using a composite of the secret keys and the HMAC-SHA1 algorithm.

C#
var compositeKey = string.Concat(Uri.EscapeDataString(oauth_consumer_secret),
                        "&",  Uri.EscapeDataString(oauth_token_secret));

string oauth_signature;
using (HMACSHA1 hasher = new HMACSHA1(ASCIIEncoding.ASCII.GetBytes(compositeKey)))
{
    oauth_signature = Convert.ToBase64String(
        hasher.ComputeHash(ASCIIEncoding.ASCII.GetBytes(baseString)));
}

The oAuth signature is then used to generate the Authentication header. This requires concatenating the public keys and the token generated above into the following format.

C#
var headerFormat = "OAuth oauth_nonce=\"{0}\", oauth_signature_method=\"{1}\", " +
                   "oauth_timestamp=\"{2}\", oauth_consumer_key=\"{3}\", " +
                   "oauth_token=\"{4}\", oauth_signature=\"{5}\", " +
                   "oauth_version=\"{6}\"";

var authHeader = string.Format(headerFormat,
                        Uri.EscapeDataString(oauth_nonce),
                        Uri.EscapeDataString(oauth_signature_method),
                        Uri.EscapeDataString(oauth_timestamp),
                        Uri.EscapeDataString(oauth_consumer_key),
                        Uri.EscapeDataString(oauth_token),
                        Uri.EscapeDataString(oauth_signature),
                        Uri.EscapeDataString(oauth_version)
                );

We are now ready to send the request, which is the easy part. Note, we must also disable the Expect: 100-Continue header using the ServicePointManager. Without this code, .NET sends the header by default, which is not supported by Twitter.

C#
var postBody = "status=" + Uri.EscapeDataString(status);

ServicePointManager.Expect100Continue = false;

HttpWebRequest request = (HttpWebRequest)WebRequest.Create(resource_url);
request.Headers.Add("Authorization", authHeader);
request.Method = "POST";
request.ContentType = "application/x-www-form-urlencoded";
using (Stream stream = request.GetRequestStream())
{
    byte[] content = ASCIIEncoding.ASCII.GetBytes(postBody);
    stream.Write(content, 0, content.Length);
}
WebResponse response = request.GetResponse();

Summary

This example hopefully shows how OAuth can be implemented with fairly little effort. In the example provided, I've kept everything inline for clarity; however, in the real world, you would obviously refactor the code into more sensible layers.

In this way, it's possible to build some highly testable lightweight classes in order to generate the required message signature, make the requests, and handle the response.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Architect
United Kingdom United Kingdom
Mike Carlisle - Technical Architect with over 20 years experience in a wide range of technologies.

@TheCodeKing

Comments and Discussions

 
GeneralRe: Using Get method Pin
Roger Hamilton21-Mar-13 15:34
Roger Hamilton21-Mar-13 15:34 
GeneralRe: Using Get method Pin
saravanan R16-Oct-13 0:20
saravanan R16-Oct-13 0:20 
AnswerRe: Using Get method Pin
Treckstar14-Jun-13 5:51
Treckstar14-Jun-13 5:51 
GeneralGreat Article! Pin
girishraja11-Mar-13 13:10
girishraja11-Mar-13 13:10 
QuestionWorks perfectly with "POST" but when I try "GET" it keeps telling me 'UnAuthorized' "Twitter api 1.1" Pin
starrysky886-Nov-12 19:53
starrysky886-Nov-12 19:53 
AnswerRe: Works perfectly with "POST" but when I try "GET" it keeps telling me 'UnAuthorized' "Twitter api 1.1" Pin
Travelthrprog4-Jan-13 9:56
Travelthrprog4-Jan-13 9:56 
AnswerRe: Works perfectly with "POST" but when I try "GET" it keeps telling me 'UnAuthorized' "Twitter api 1.1" Pin
bobbykc13-Mar-13 6:46
bobbykc13-Mar-13 6:46 
Questionerror : remote server returned an error: (401) Unauthorized. Pin
codeproject_dev5-Nov-12 14:39
professionalcodeproject_dev5-Nov-12 14:39 
The remote server returned an error: (401) Unauthorized.

I supplied my app values , but still getting above error.
AnswerRe: error : remote server returned an error: (401) Unauthorized. Pin
TheCodeKing5-Nov-12 20:09
TheCodeKing5-Nov-12 20:09 
QuestionWork only for status updates???? Pin
Adrien Cdp Martin30-Oct-12 3:48
Adrien Cdp Martin30-Oct-12 3:48 
QuestionWorks perfectly Pin
WhiteSites28-Oct-12 14:28
WhiteSites28-Oct-12 14:28 
QuestionAPI 1.1 authentication with a GET request Pin
gwilhelmunc18-Oct-12 10:37
gwilhelmunc18-Oct-12 10:37 
QuestionGraceful 401 (Unauthorized) response handling Pin
rhamstak6-Oct-12 13:35
rhamstak6-Oct-12 13:35 
Question401 Unathorized Pin
BigBlownDog5-Oct-12 10:47
BigBlownDog5-Oct-12 10:47 
AnswerRe: 401 Unathorized Pin
BigBlownDog6-Oct-12 11:17
BigBlownDog6-Oct-12 11:17 
AnswerRe: 401 Unathorized Pin
pstarkov7-Oct-12 22:16
pstarkov7-Oct-12 22:16 
Questionproblem with Twitter OAuth authentication using .NET Pin
gauravkmspn20-Sep-12 3:21
gauravkmspn20-Sep-12 3:21 
AnswerRe: problem with Twitter OAuth authentication using .NET Pin
TheCodeKing20-Sep-12 9:49
TheCodeKing20-Sep-12 9:49 
QuestionHow to generate OAuth signature with c# for Twitter API 1.1? Pin
smraj150319-Sep-12 18:05
smraj150319-Sep-12 18:05 
AnswerRe: How to generate OAuth signature with c# for Twitter API 1.1? Pin
TheCodeKing4-Oct-12 12:29
TheCodeKing4-Oct-12 12:29 
QuestionThank you Pin
Ankur Dalal12-Jul-12 22:03
Ankur Dalal12-Jul-12 22:03 
QuestionCoding Pin
LamboLambo28-May-12 23:17
LamboLambo28-May-12 23:17 
GeneralUsing this program from Localhost!! Pin
simplybj25-Apr-12 19:47
professionalsimplybj25-Apr-12 19:47 
GeneralRe: Using this program from Localhost!! Pin
QodeMaster30-Apr-12 22:00
QodeMaster30-Apr-12 22:00 
GeneralRe: Using this program from Localhost!! Pin
WillShakespeare16-May-12 0:53
WillShakespeare16-May-12 0:53 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.