DEPRECATION NOTE: ADAL v3 has been released and offers a better experience using Xamarin with Android than this walkthrough. The sample for this is located here. We recommend you use the new ADAL v3 walkthrough unless you have a specific reason for requiring the binding of the native Android library in your Xamarin application.
This sample shows how to build a Xamarin binding to our native ADAL for Android library. This is a sample and is not to be used in production. We plan on adding a true cross platform mapping layer in the future. For those interested in binding to our Android library in .Net using Xamarin, this code is a good guide.
We provide the ADAL for Android jar along with resources in this repo. It is named AdalwithResources.zip and is located under /jars. You will need to use this .zip file instead of the standalone .jar file for the Xamarin bnding to work.
In the future we will update this sample to include other ADAL libraries as create a more robust mapping layer. At the moment, we are using the binding file directly to allow Xamarin developers on Android to use our library.
Step 0: Learn about binding java libraries with Xamarin
You'll get up to speed faster if you do some reading of the Xamarin documentation for Android Binding to native libraries located here: Binding Android Libraries/)
Finally, you may want to read through how Xamarin works with Java here: Xamarin for Java Developers
Using Xamarin Studio
Step 1: Download Xamarin Studio
You can get Xamarin Studio from the Xamarin website.
Step 2: Create a "Android Java Binding Library" Project in Xamarin Studio
Select File -> New -> Solution and select "Android Java Binding Library"
Step 3: Clone this code in to your Project directory
Go to the directory where you created your new project and clone the files in this repostiory. You will then need to add these files in to Xamarin Studio by clicking on your project tree and selecting "Add Files.." in the pulldown.
The names of the files in this repository should match closely the default files that are included in the Java Binding project for Xamarin. This will aid you in replacing the files or code with the correct files from our repository.
Step 3: Add the latest version of ADAL for Java library to the Project
You will need to bind to AdalWithResources.zip in your Xamarin Studio Java Binding project as discissed in Binding Java Libraries/). The easiest way to do this is to use the included AdalWithResources.zip file in this repo. If you need to update the AdalWithResources.zip to use the latest ADAL for Android see the instructions below.
Step 4: Run and use!
Run the project and then pull the .dll files out of the /bin directory Xamarin Studio will create.
Step 5: Broker usage
Microsoft Intune's Company portal app installs the Authencator plugin that does the token broker using AccountManager. Adal will use the broker account by default, if there is one user account at this authenticator and Developer choose not to skip it. Developer can skip the broker user with:
Developer needs to register special redirectUri for broker usage. RedirectUri is in the format of msauth://packagename/Base64UrlencodedSignature. You can get your redirecturi for your app using the script "brokerRedirectPrint.ps1" or use API call mContext.getBrokerRedirectUri. Signature is related to your signing certificate
Your app manifest should have permissions to use AccountManager accounts: http://developer.android.com/reference/android/accounts/AccountManager.html#getAccountsByType(java.lang.String) * GET_ACCOUNTS * USE_CREDENTIALS * MANAGE_ACCOUNTS
RedirectUri is used to verify the calling app from AAD app registration. Broker will not give token if redirecturi does not match.
To update the AdalWithResources.zip file from the command line
(if you wish to update a later version of the classes.jar library)
android update project -p .
zip -r AdalWithResources.zip bin/classes.jar bin/AndroidManifest.xml res
You will need to bind to classes.jar from the ADAL for Android library. The easiest way to do this is to grab the latest ADAL for Java and compile the source.
You can get the latest ADAL for Java library here:
Add the dependency jar files to binding project as well if it has changed and keep them as an embebded referenced jar.
Zip file should have bin and res folders:
AdalWithResources.zip -> (bin,res)