This sample shows how you can use the WebAuthenticationBroker class to connect to OAuth providers such as Facebook, Flickr, Google, and Twitter.

Note  This sample was created using one of the universal app templates available in Visual Studio. It shows how its solution is structured so it can run on both Windows 8.1 and Windows Phone 8.1. For more info about how to build apps that target Windows and Windows Phone with Visual Studio, see Build apps that target Windows and Windows Phone 8.1 by using Visual Studio.

This sample shows you how to:

• Connect to Facebook using the OAuth 2.0 protocol for authentication and authorization.
• Connect to Twitter using the OAuth protocol for authentication and authorization.
• Connect to Flickr using the OAuth protocol for authentication and authorization.
• Use Account Controls to manage account settings.
• Use Windows.Web.Http.HttpClient and classes in the Windows.Web.Http.Filters namespace to use filters to connect with OAuth providers to make development easier.

Network capabilities

This sample requires that network capabilities be set in the Package.appxmanifest file to allow the app to access the network at runtime. These capabilities can be set in the app manifest using Microsoft Visual Studio.

To build the Windows version of the sample:

• Internet (Client): The sample can use the Internet for client operations (outbound-initiated access). This allows the app to authenticate with servers on the Internet. This is represented by the Capability name = "internetClient" tag in the app manifest.

• If the sample is used to connect and authenticate to a server located on a home or work network (a local intranet), the Private Networks (Client & Server) capability must be set. This is represented by the Capability name = "privateNetworkClientServer" tag in the app manifest.

To build the Windows Phone version of the sample:

• Internet (Client & Server): This sample has complete access to the network for both client operations (outbound-initiated access) and server operations (inbound-initiated access). This allows the app to connect and authenticate to a server on the Internet or on a local intranet. This is represented by the Capability name = "internetClientServer" tag in the app manifest.

  Note  On Windows Phone, there is only one network capability which enables all network access for the app.

To obtain an evaluation copy of Windows 8.1, go to Windows 8.1.

To obtain an evaluation copy of Microsoft Visual Studio 2013 Update 2, go to Microsoft Visual Studio 2013.

Note  For Windows 8 app samples, download the Windows 8 app samples pack. The samples in the Windows 8 app samples pack will build and run only on Microsoft Visual Studio 2012.

Related topics

Other resources

Web Authentication Broker

Quickstart: Connecting using XML HTTP Request (IXHR2)

Setting up single sign-on using the web authentication broker (C#/C++/VB)

Setting up single sign-on using the web authentication broker (JavaScript)

Reference

WebAccount

WebAccountCommand

WebAccountProvider

WebAuthenticationBroker

Windows.Security.Authentication.Web

Windows.Web.Http

Windows.Web.Http.Filters

Windows.Web.Http.HttpClient

Samples

Windows 8 Windows Store app samples

Operating system requirements

Client	Windows 8.1
Server	Windows Server 2012 R2
Phone	Windows Phone 8.1

Build the sample

1. Start Visual Studio 2013 Update 2 and select File > Open > Project/Solution.
2. Go to the directory to which you unzipped the sample. Then go to the subdirectory named for the sample and double-click the Visual Studio 2013 Update 2 Solution (.sln) file.
3. Follow the steps for the version of the sample you want:

   • To build the Windows version of the sample:

     1. Select WebAuthentication.Windows in Solution Explorer.
     2. Press Ctrl+Shift+B, or use Build > Build Solution, or use Build > Build WebAuthentication.Windows.

   • To build the Windows Phone version of the sample:

     1. Select WebAuthentication.WindowsPhone in Solution Explorer.
     2. Press Ctrl+Shift+B or use Build > Build Solution or use Build > Build WebAuthentication.WindowsPhone.

Run the sample

The next steps depend on whether you just want to deploy the sample or you want to both deploy and run it.

Deploying the sample

• To deploy the built Windows version of the sample:

  1. Select WebAuthentication.Windows in Solution Explorer.
  2. Use Build > Deploy Solution or Build > Deploy WebAuthentication.Windows.

• To deploy the built Windows Phone version of the sample:

  1. Select WebAuthentication.WindowsPhone in Solution Explorer.
  2. Use Build > Deploy Solution or Build > Deploy WebAuthentication.WindowsPhone.

Deploying and running the sample

• To deploy and run the Windows version of the sample:

  1. Right-click WebAuthentication.Windows in Solution Explorer and select Set as StartUp Project.
  2. To debug the sample and then run it, press F5 or use Debug > Start Debugging. To run the sample without debugging, press Ctrl+F5 or use Debug > Start Without Debugging.

• To deploy and run the Windows Phone version of the sample:

  1. Right-click WebAuthentication.WindowsPhone in Solution Explorer and select Set as StartUp Project.
  2. To debug the sample and then run it, press F5 or use Debug > Start Debugging. To run the sample without debugging, press Ctrl+F5 or use Debug > Start Without Debugging.