{"id":31918,"date":"2017-06-07T08:53:01","date_gmt":"2017-06-07T15:53:01","guid":{"rendered":"https:\/\/blog.xamarin.com\/?p=31918"},"modified":"2017-06-07T08:53:01","modified_gmt":"2017-06-07T15:53:01","slug":"enterprise-apps-made-easy-updated-libraries-apis","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/xamarin\/enterprise-apps-made-easy-updated-libraries-apis\/","title":{"rendered":"Enterprise Apps Made Easy with New Authentication & Microsoft Graph Libraries"},"content":{"rendered":"

\t\t\t\tMany enterprise organizations are making the move to the cloud and building mobile apps for internal use. It’s increasingly common to see enterprises with entire suites of internal apps to help make employees more productive, from expense reporting to leave management, even carpooling. Rather than rolling a brand new infrastructure for these apps, organizations can take advantage of Active Directory (AD) and consume existing APIs that provide data such as contacts, email, calendar, org trees, and more. Thanks to brand new and improved libraries for authenticating users and consuming the Microsoft Graph, building such applications has become much easier.<\/p>\n

In this blog post, we’ll be building a sample application for managing leave (sick time, parental leave, etc.) using the Microsoft Authentication Library (MSAL) and Microsoft Graph APIs.<\/p>\n

Step 1: Register the Application<\/h2>\n

You can register the application by visiting https:\/\/apps.dev.microsoft.com<\/a> and clicking on the Add an app<\/strong> button. Once you enter the app details, be sure to note the Application Id<\/strong> generated. Under the Add Platforms<\/strong> section, you can now register an application to multiple platforms. This makes life simpler by having one application ID for various implementations of the same app across mobile and web.<\/p>\n

\"\"<\/p>\n

Click Native Application<\/strong>. This will allow mobile applications to access the organization’s AD and Graph API.<\/p>\n

Once supported platforms are added, we can add permissions on the same screen. In this case, I’ve given the permissions\u00a0\"User.Read\"<\/code>, \"User.ReadBasic.All\"<\/code>, and\"Mail.Send\"<\/code>. These are required to get a user’s information and send an email to his or her manager to let them know the user will be out for the day.<\/p>\n

\"\"<\/p>\n

Save the changes, and your app is now registered with the organization’s Active Directory!<\/p>\n

Step 2: Building the Mobile Apps<\/h2>\n

Create a blank Xamarin.Forms app with the Portable Class Library (PCL) option to share code across platforms. For this library, ensure the profile is set to Profile7<\/code><\/a>. Add the Microsoft.Client.Identity<\/strong> and Microsoft.Graph<\/strong> NuGet packages to all projects. If you don’t see them in the NuGet Package Manager, check Include Prerelease<\/strong>.<\/p>\n

First, we need to authenticate the user. This is done with the Microsoft Authentication Library (MSAL) PublicClientApplication<\/code> class. Inside of App.xaml.cs<\/code>, add the following code:<\/p>\n

public static PublicClientApplication IdentityClientApp = null;\npublic static UIParent UiParent = null;\n\n\/\/ AD application identifier and requested permissions, or scopes.\npublic static string ClientID = \"7214e6cd-85ad-4433-9d13-f2631e1d4142\"; \/\/ TODO: Replace this with the Application ID from Step #1.\npublic static string[] Scopes = { \"User.Read\", \"User.ReadBasic.All \", \"Mail.Send\" };\n\npublic App()\n{\n   InitializeComponent();\n   IdentityClientApp = new PublicClientApplication(ClientID);\n   MainPage = new Leaver.MainPage();\n}\n<\/pre>\n
Next, we need to build out a login page. Create a GraphServiceClient<\/code> in MainPage.xaml.cs<\/code>, which will be responsible for calling all future Graph APIs. You can see a sample implementation in the code below:<\/p>\n
\nprivate async Task CreateGraphClientAsync()\n{\n   try {\n     Client = new GraphServiceClient(\"https:\/\/graph.microsoft.com\/v1.0\",\n           new DelegateAuthenticationProvider(async (requestMessage) =>\n           {\n              var tokenRequest = await App.IdentityClientApp.AcquireTokenAsync(App.Scopes, App.UiParent).ConfigureAwait(false);\n              requestMessage.Headers.Authorization = new AuthenticationHeaderValue(\"bearer\", tokenRequest.AccessToken);\n           }));\n           Me = await Client.Me.Request().GetAsync();\n           Username.Text = $\"Welcome {((User)Me).DisplayName}\";\n           return true;\n        }\n        catch (MsalException ex)\n        {\n           await DisplayAlert(\"Error\", ex.Message, \"OK\", \"Cancel\");\n           return false;\n        }\n}\n<\/pre>\n
Now that we’ve initialized our GraphServiceClient<\/code>, we can use the Graph API to send an email:<\/p>\n
private async void SendEmail(Message message)\n{\n   if (!UserExists)\n      await CreateGraphClientAsync();\n   var req = Client.Me.SendMail(message);\n   await req.Request().PostAsync();\n   Status.Text = $\"Email sent to your manager { ((User)Manager).DisplayName }, CC: you\";\n}\n<\/pre>\n
Step 3: Platform-Specific Modifications<\/h2>\n
Login functionality with MSAL was previously implemented in Xamarin.Forms by using custom renderers<\/a>. With this new, production-ready preview of MSAL, this functionality is implemented using a URL scheme to make our lives easier. This automatically initiates the authentication flow and completes the login flow.<\/p>\n
iOS<\/h3>\n
In Visual Studio 2017 Preview 3, we’ve added a UI editor for Info.plist<\/code> where you can register your custom URL scheme:<\/p>\n
\"\"<\/p>\n
The completed authentication process can be handled in AppDelegate<\/code>:<\/p>\n
public override bool FinishedLaunching(UIApplication app, NSDictionary options)\n{\n   global::Xamarin.Forms.Forms.Init();\n   LoadApplication(new App());\n   App.IdentityClientApp.RedirectUri = \"msal7214e6cd-85ad-4433-9d13-f2631e1d4142:\/\/auth\";\n   return base.FinishedLaunching(app, options);\n}\n\npublic override bool OpenUrl(UIApplication app, NSUrl url, NSDictionary options)\n{\n   AuthenticationContinuationHelper.SetAuthenticationContinuationEventArgs(url);\n   return true;\n}\n<\/pre>\n
Android<\/h3>\n
Open AndroidManifest.xml<\/code> and add the BrowserTabActivity<\/code> with intent-filter<\/code> to register the URL scheme:<\/p>\n
\n\n    \n      \n        \n        \n        \n        \n      \n    \n  \n<\/pre>\n
The completed authentication process can be handled in our app’s MainActivity<\/code>:<\/p>\n
protected override void OnCreate(Bundle bundle)\n{\n   TabLayoutResource = Resource.Layout.Tabbar;\n   ToolbarResource = Resource.Layout.Toolbar;\n   base.OnCreate(bundle);\n   global::Xamarin.Forms.Forms.Init(this, bundle);\n   LoadApplication(new App());\n   App.IdentityClientApp.RedirectUri = \"msal7214e6cd-85ad-4433-9d13-f2631e1d4142:\/\/auth\";\n   App.UiParent = new UIParent(Xamarin.Forms.Forms.Context as Activity);\n}\nprotected override void OnActivityResult(int requestCode, Result resultCode, Intent data)\n{\n   base.OnActivityResult(requestCode, resultCode, data);\n   AuthenticationContinuationHelper.SetAuthenticationContinuationEventArgs(requestCode, resultCode, data);\n}\n<\/pre>\n
Windows<\/h3>\n
The Microsoft Authentication Library doesn’t require any specific platform modifications to handle the login process for Universal Windows Platform (UWP) apps.<\/p>\n
Step 4: Run the App<\/h2>\n
Once the steps are complete, run the app to see our completed leave scheduling application for iOS, Android, and Windows using Xamarin.Forms, the Microsoft Authentication Library, and the Microsoft Graph APIs.<\/p>\n
\"\"<\/p>\n
\"\"<\/p>\n
Conclusion<\/h3>\n
Microsoft Authentication Library<\/a> (MSAL) makes it easy to integrate apps with existing Active Directories (AD) and add authentication in just a few lines of code. The Microsoft Graph API<\/a> enables access various services available to our users, such as mail, calendar, people, and SharePoint, all from a single API. To try out the mobile app built in this blog post, download the sample from my GitHub<\/a>.\t\t<\/p>\n","protected":false},"excerpt":{"rendered":"
Many enterprise organizations are making the move to the cloud and building mobile apps for internal use. It’s increasingly common to see enterprises with entire suites of internal apps to help make employees more productive, from expense reporting to leave management, even carpooling. Rather than rolling a brand new infrastructure for these apps, organizations can […]<\/p>\n","protected":false},"author":549,"featured_media":31929,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[2],"tags":[4],"class_list":["post-31918","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-developers","tag-xamarin-platform"],"acf":[],"blog_post_summary":"
Many enterprise organizations are making the move to the cloud and building mobile apps for internal use. It’s increasingly common to see enterprises with entire suites of internal apps to help make employees more productive, from expense reporting to leave management, even carpooling. Rather than rolling a brand new infrastructure for these apps, organizations can […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts\/31918","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/users\/549"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/comments?post=31918"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts\/31918\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/media?parent=31918"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/categories?post=31918"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/tags?post=31918"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}