C# Other
Clone or download
jennyf19 catch MsalClientException when user cancels auth instead of serviceEx… (
#587)

* catch MsalClientException when user cancels auth instead of serviceException

* Add unit test coverage for user cancelling authentication and access denied

* address empty queue error and add assert.fail for when exception is not thrown.

* add return statement...working w/other branch and forgot to add it here. test class needs to be cleaned and rebuilt often -> multitargeting issues?

* fix spelling
Latest commit f4a3e1f Jul 5, 2018
Permalink
Failed to load latest commit information.
.nuget fully building source and tests Feb 4, 2016
build Henrikm/remove app veyor (#560) May 23, 2018
samples/desktop/SampleApp Trwalke/treat all warnings as errors (#537) Mar 30, 2018
src catch MsalClientException when user cancels auth instead of serviceEx… ( Jul 5, 2018
tests catch MsalClientException when user cancels auth instead of serviceEx… ( Jul 5, 2018
.gitignore minor fixes to ui thread sync for the desktop app and few other minor… ( Mar 14, 2018
ConfigureAwait.ruleset Trwalke/configure await code analysis (#536) Mar 9, 2018
Directory.Build.props Add support for client_info for session continuation and caching (#282) Apr 3, 2017
GitVersion.yml Remove logging from iOS TokenCacheAccesssor as requestContext is null ( Jun 5, 2018
GlobalSuppressions.cs Trwalke/treat all warnings as errors (#537) Mar 30, 2018
LICENSE OM update for Token Cache (#138) Dec 23, 2016
MSAL.sln Trwalke/treat all warnings as errors (#537) Mar 30, 2018
MSAL.sln.DotSettings Http Component gutting. Aug 1, 2016
NuGet.Config clean up sample app projects (#230) Mar 16, 2017
README.md Update Xamarin.Android.Support.CustomTabs and v7.AppCompat to version… ( May 23, 2018
build-local.cmd Add support for client_info for session continuation and caching (#282) Apr 3, 2017
build.cmd Configure appeyor to build library and tests Mar 18, 2017
changelog.txt Remove logging from iOS TokenCacheAccesssor as requestContext is null ( Jun 5, 2018
contributing.md ported code from v3 and fixed build issues Dec 22, 2015

README.md

Microsoft Authentication Library (MSAL) Preview for .NET, Windows Store, UWP, NetCore, Xamarin Android and iOS

Conceptual documentation Getting Started Sample Code Library Reference Support

The MSAL library for .NET gives your app the ability to begin using the Microsoft Cloud by supporting Microsoft Azure Active Directory and Microsoft Accounts in a converged experience using industry standard OAuth2 and OpenID Connect. The library also supports Azure AD B2C.

Stable (master branch) Nightly (dev branch)
NuGet MyGet
Branch Status Notes
dev (VSTS) Builds the entire MSAL solution

Important Note about the MSAL Preview

This library is suitable for use in a production environment. We provide the same production level support for this library as we do our current production libraries. During the preview we may make changes to the API, internal cache format, and other mechanisms of this library, which you will be required to take along with bug fixes or feature improvements. This may impact your application. For instance, a change to the cache format may impact your users, such as requiring them to sign in again. An API change may require you to update your code. When we provide the General Availability release we will require you to update to the General Availability version within six months, as applications written using a preview version of library may no longer work.

Requirements

  • Windows 7 or greater
  • .NET 4.5 or greater

Community Help and Support

We use Stack Overflow with the community to provide support. We highly recommend you ask your questions on Stack Overflow first and browse existing issues to see if someone has asked your question before.

If you find and bug or have a feature request, please raise the issue on GitHub Issues.

To provide a recommendation, visit our User Voice page.

Contribute

We enthusiastically welcome contributions and feedback. You can clone the repo and start contributing now. Read our Contribution Guide for more information.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Security Library

This library controls how users sign-in and access services. We recommend you always take the latest version of our library in your app when possible. We use semantic versioning so you can control the risk associated with updating your app. As an example, always downloading the latest minor version number (e.g. x.y.x) ensures you get the latest security and feature enhancements but our API surface remains the same. You can always see the latest version and release notes under the Releases tab of GitHub.

Security Reporting

If you find a security issue with our libraries or services please report it to secure@microsoft.com with as much detail as possible. Your submission may be eligible for a bounty through the Microsoft Bounty program. Please do not post security issues to GitHub Issues or any other public site. We will contact you shortly upon receiving the information. We encourage you to get notifications of when security incidents occur by visiting this page and subscribing to Security Advisory Alerts.

Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT License (the "License");

Using MSAL

Step 1: Add MSAL to your Solution/Project

  1. Right click on your project > Manage packages.
  2. Select include prerelease > search msal.
  3. Select the Microsoft.Identity.Client package > install.

Step 2: Instantiate MSAL and Acquire a Token

  1. Create a new PublicClientApplication instance. Make sure to fill in your app/client id
    PublicClientApplication myApp = new PublicClientApplication(CLIENT_ID);
  1. Acquire a token
    AuthenticationResult authenticationResult = await myApp.AcquireTokenAsync(SCOPES).ConfigureAwait(false);

Step 3: Use the token!

The access token can now be used in an HTTP Bearer request.