SharedDeviceMode.Android.MSAL.Binding 1.0.1-net8.0

SharedDeviceMode.Android.MSAL.Binding

Binding library for MSAL (Microsoft Authentication Library) Android Shared Device Mode (SDM) targeting .NET 8.0.

Description

This NuGet package provides a .NET binding for the MSAL Android SDK with Shared Device Mode support. It enables .NET MAUI and Xamarin.Android applications to use MSAL authentication features on Android devices configured for shared device scenarios.

Installation

Install the package via NuGet Package Manager:

dotnet add package SharedDeviceMode.Android.MSAL.Binding --version 1.0.0-net8.0

Or via Package Manager Console:

Install-Package SharedDeviceMode.Android.MSAL.Binding -Version 1.0.0-net8.0

Requirements

• .NET 8.0 or later
• Android API Level 24 (Android 7.0) or higher
• Target Framework: net8.0-android34.0 or compatible

Features

• ✅ Shared Device Mode detection
• ✅ Silent and Interactive Sign In
• ✅ Get current user
• ✅ Check user activity status
• ✅ Get access token
• ✅ Sign Out
• ✅ Async/await pattern support

Usage

Basic Setup

using MSAL.SDM.Android.Binding;
using Android.Content;

// Initialize the wrapper
var context = Android.App.Application.Context;
var msalWrapper = new MSALSDMWrapperAsync(context);

// Configure MSAL parameters
msalWrapper.Configure(
    clientId: "your-client-id",
    tenantId: "your-tenant-id",
    scope: "user.read",
    returnUri: "msauth://your.package.name/your-signature-hash"
);

Check Shared Device Mode

bool isSDM = msalWrapper.IsSharedDeviceMode();
if (isSDM)
{
    // Device is in Shared Device Mode
    // Use SDM-specific features
}

Get Current User

string? currentUser = msalWrapper.GetCurrentUser();

Silent Sign In

try
{
    var result = await msalWrapper.SignInSilentAsync();
    string accessToken = result.AccessToken;
    string username = result.Username;
}
catch (Exception ex)
{
    // Handle error or fall back to interactive sign in
}

Interactive Sign In

try
{
    var result = await msalWrapper.SignInInteractiveAsync();
    string accessToken = result.AccessToken;
    string username = result.Username;
}
catch (OperationCanceledException)
{
    // User cancelled the sign in
}
catch (Exception ex)
{
    // Handle error
}

Get Access Token

try
{
    string accessToken = await msalWrapper.GetAccessTokenAsync();
}
catch (Exception ex)
{
    // Handle error
}

Sign Out

try
{
    await msalWrapper.SignOutAsync();
}
catch (Exception ex)
{
    // Handle error
}

Dependencies

This package includes the following dependencies:

• MSAL Android SDK 8.1.0
• Microsoft Identity Common 23.1.0
• Various AndroidX libraries
• Kotlin libraries

.NET Version

This package targets .NET 8.0. The version suffix -net8.0 indicates the target framework.

When upgrading to .NET 9, look for packages with version suffix -net9.0.

Notes

• This binding library is specifically designed for Android platforms
• Shared Device Mode is only supported on Android devices
• All async methods use Task-based async pattern
• The library automatically handles callback-to-async conversion

License

This project is licensed under the MIT License - see the LICENSE file for details.