modulexcite / Contacts-API-Win10-UWP

This repository contains a Universal Windows Platform (UWP) application for Windows 10 that connects to the Office 365 APIs for Contacts using the new WebAccountProvider framework.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Contacts-API-Win10-UWP

This repository contains a Universal Windows Platform (UWP) application for Windows 10 that connects to the Office 365 APIs for Contacts using the new WebAccountManager framework.

Environment Setup

The solution was built in Visual Studio 2015 with the Windows Software Development Kit (SDK) for Windows 10.

Office 365 applications are secured by Azure Active Directory, which comes as part of an Office 365 subscription. If you do not have an Office 365 Subscription or associated it with Azure AD, then you should follow the steps to Set up your Office 365 development environment from MSDN.

Registering the App

When you open the solution in Visual Studio 2015, the application will need to be registered for your tenant. Simply right-click the project and select Add > Connected Service. Use the connected service wizard to register the application with Azure AD with permissions to read/write contacts.

Using Windows 10's new WebAccountProvider

This sample uses Windows 10's new WebAccountProvider instead of a traditional WebAuthenticationBroker that the Azure AD Authentication Libraries (ADAL) have used in the past. The sample below shows how to get access tokens with this new framework. Notice we try to get the token silently at first and then with a forced prompt if it needs user intervention:

private static async Task<string> GetAccessToken()
{
	string token = null;

	//first try to get the token silently
	WebAccountProvider aadAccountProvider = await WebAuthenticationCoreManager.FindAccountProviderAsync("https://login.windows.net");
	WebTokenRequest webTokenRequest = new WebTokenRequest(aadAccountProvider, String.Empty, App.Current.Resources["ida:ClientID"].ToString(), WebTokenRequestPromptType.Default);
	webTokenRequest.Properties.Add("authority", "https://login.windows.net");
	webTokenRequest.Properties.Add("resource", "https://outlook.office365.com/");
	WebTokenRequestResult webTokenRequestResult = await WebAuthenticationCoreManager.GetTokenSilentlyAsync(webTokenRequest);
	if (webTokenRequestResult.ResponseStatus == WebTokenRequestStatus.Success)
	{
    	WebTokenResponse webTokenResponse = webTokenRequestResult.ResponseData[0];
    	token = webTokenResponse.Token;
	}
	else if (webTokenRequestResult.ResponseStatus == WebTokenRequestStatus.UserInteractionRequired)
	{
    	//get token through prompt
    	webTokenRequest = new WebTokenRequest(aadAccountProvider, String.Empty, App.Current.Resources["ida:ClientID"].ToString(), WebTokenRequestPromptType.ForceAuthentication);
    	webTokenRequest.Properties.Add("authority", "https://login.windows.net");
    	webTokenRequest.Properties.Add("resource", "https://outlook.office365.com/");
    	webTokenRequestResult = await WebAuthenticationCoreManager.RequestTokenAsync(webTokenRequest);
    	if (webTokenRequestResult.ResponseStatus == WebTokenRequestStatus.Success)
    	{
        	WebTokenResponse webTokenResponse = webTokenRequestResult.ResponseData[0];
        	token = webTokenResponse.Token;
    	}
	}

	return token;
}

Running the Application

The application is built as a Windows 10 UWP application, meaning it can run on both Windows 10 Desktop and Mobile. To debug on a specific device or emulator, simply select the desired option from the debug targets dropdown:

Windows 10 UWP Debug Targets

Windows 10 Desktop:

Win10 Desktop

Windows 10 Mobile:

Win10 Mobile

About

This repository contains a Universal Windows Platform (UWP) application for Windows 10 that connects to the Office 365 APIs for Contacts using the new WebAccountProvider framework.


Languages

Language:C# 100.0%