OAuth e OpenID com ASP.NET MVC 4

O principal objetivo do OAuth � permitir que uma aplicaç�o se autentique em outra "em nome de um usu�rio", sem precisar ter acesso a senha dele.�

Basicamente, a aplicaç�o pede permiss�o de acesso para aquele usu�rio e o usu�rio concede ou n�o a permiss�o, sem que para isso tenha que informar a senha. Essa permiss�o independe da senha. Mesmo que a senha seja alterada a permiss�o continuar� v�lida. Al�m disso, a permiss�o dada � aplicaç�o cliente pode ser revogada a qualquer momento. Muitas redes sociais utilizam esse protocolo em suas APIs.

O MVC4 usa a biblioteca DotNetOpenAuth para autenticaç�o OAuth e OpenID, nesse artigo veremos como podemos configurar nossa aplicaç�o MVC4 para usar o facebook e o twitter, al�m de configuramos a aplicaç�o veremos como obter o appId/consumerKey do facebook e twitter.

Configuraç�o do facebook para autenticaç�o numa aplicaç�o MVC4

Acesse o site de desenvolvedor do facebook: https://developers.facebook.com/.

Figura 1: Pagina de aplicativos do facebook

Clique em criar novo aplicativo, vai abrir um popup onde voc� pode especificar o nome do aplicativo e outros detalhes. Clique no bot�o continuar depois de fornecer nome do aplicativo.

Na pr�xima p�gina voc� pode configurar o aplicativo do facebook, a integraç�o/comunicaç�o do aplicativo MVC4 ser� feita com esse aplicativo.

Figura 2: Configuraç�o da aplicaç�o do facebook

Clique em �Website with Facebook Login� e forneça dom�nio aqui. Se voc� estiver usando sua m�quina local para fins de teste, ent�o voc� pode usar http://localhost:2345. N�o se esqueça de mudar o n�mero da porta para o n�mero da porta local. Aqui voc� tamb�m pode ativar o modo seguro (sandbox mode) para que apenas o administrador possa usar o aplicativo do facebook. Clique em Salvar alteraç�es.

Figura 3: Aplicaç�o criada e configurada

Agora temos o AppId e AppSecret, salve essas informaç�es que ser�o necess�rias na aplicaç�o MVC4.

Configuraç�o do Twitter para autenticaç�o numa aplicaç�o MVC4

Acesse o site de desenvolvedor do Twitter:�https://dev.twitter.com/

Figura 4: P�gina de aplicativos do twitter

Clique em �Create an app� vai pedir detalhes da aplicaç�o, fornecer detalhes necess�rios.

Figura 5: Criaç�o da aplicaç�o no Twitter

Para testar na m�quina local voc� precisa digitar o IP local (192.168.0.1) porque o Twitter pode n�o aceitar localhost como nome do site. Aqui voc� tamb�m pode especificar a URL de retorno de chamada em que o Twitter vai redirecionar uma vez que a autenticaç�o seja conclu�da com �xito. Depois de preencher todos os detalhes e aceitar os termos clique em �Create your Twitter Application�

Figura 6: Aplicaç�o criada e configurada

Salve a key e Secret, essas informaç�es ser�o necess�rias na aplicaç�o MVC4.

Criando a aplicaç�o MVC4

Dentro do Visual Studio, crie um novo projeto ASP.NET MVC 4 Web Application(Figura 7), preenchendo o campo Name com o nome da aplicaç�o a ser gerado e clique em ok.

Figura 7: Criando um projeto ASP.NET MVC4

Na pr�xima tela selecione �Internet Application�, esse template vai criar um projeto MVC4 com todas as referencias necess�rias para a utilizaç�o do DotNetOpenAuth.

Figura 8: Criando um projeto ASP.NET MVC4

Ap�s a criaç�o do projeto abra o arquivo App_Start/AuthConfig.cs. Nesta classe voc� pode especificar as chaves de acesso das aplicaç�es criadas anteriormente no facebook e twitter.

Listagem 1: Registro dos clientes para o facebook e twitter


public static void RegisterAuth()
{
        OAuthWebSecurity.RegisterTwitterClient(
                consumerKey: "CHAVE DA SUA APLICAÇ�O DO TWITTER",
                consumerSecret: "SEGREDO DA SUA APLICAÇ�O TWITTER");

        OAuthWebSecurity.RegisterFacebookClient(
                appId: "AppId DA SUA APLICAÇ�O DO FACEBOOK",
                appSecret: "SEGREDO DA SUA APLICAÇ�O DO FACEBOOK");
}

Observaç�o: Os valores utilizados nesse artigo para as duas chaves s�o meramente ilustrativos, portanto, ser� necess�rio obter suas pr�prias chaves para que o exemplo funcione corretamente.

Feita essas configuraç�es estamos pronto para testar nossa aplicaç�o logando com o Facebook ou Twitter. Todos os clientes registrados podem ser recuperados atrav�s da propriedade OAuthWebSecurity.RegisteredClientData.

Que tipo de informaç�o voc� pode recuperar desses provedores

Google	Facebook	Twitter
email	id	name
firstname	name	location
lastname	link	description
country	gender	url
	accesstoken	accesstoken

Como recuperar esta informaç�o

Usando os provedores padr�es essas informaç�es v�o estar dispon�veis ap�s a autenticaç�o como um Dictionary na classe AuthenticationResult. � poss�vel estender ou ate mesmo criar o seu pr�prio provedor para recuperar outras informaç�es. Segue link com informaç�es dosprincipais sites que utilizam OAuth e OpenId:

O template que utilizamos na criaç�o do projeto j� cria o controlador(controller) Account com toda as regras necess�rias para utilizaç�o do OAuth e OpenId. Os detalhes desse controlador n�o � o foco desse artigo.

Ent�o finalizamos aqui este breve artigo, cujo objetivo � facilitar a autenticaç�o da sua aplicaç�o ASP.NET MVC4 usando informaç�es de outros sites. Espero ter ajudado a todos, abraços e at� a pr�xima oportunidade.