ms_authenticate 0.0.2

A premium, native Flutter plugin for seamless Microsoft Azure Active Directory authentication. Built with performance, security, and user experience in mind.

MS Authenticate 🔐

A premium, native Flutter plugin for seamless Microsoft Azure Active Directory authentication. Built with performance, security, and user experience in mind.

---

✨ Features

• 🚀 Truly Native: Pure Kotlin and Swift implementation for maximum stability and performance.
• 🎨 Premium UX: Uses Chrome Custom Tabs (Android) and ASWebAuthenticationSession (iOS) for a modern, integrated login experience that automatically closes after success.
• ⚡ Integrated Token Exchange: Handles the entire OAuth 2.0 Authorization Code flow natively. No need for manual HTTP requests in your Flutter code.
• 🧵 Background Processing: Token exchange is performed on background threads, ensuring a buttery-smooth UI.
• 🔒 Secure: Built following modern security best practices for OAuth 2.0.

---

📸 Integrated Experience

The plugin uses high-end native components to provide an "in-app" browser feel, ensuring users never feel like they've left your application.

---

🛠 Getting Started

1. Installation

Add ms_authenticate to your pubspec.yaml:

dependencies:
  ms_authenticate: ^0.0.1

2. Native Configuration

Android Setup

Add the intent filter to your AndroidManifest.xml to handle the redirect:

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="your.custom.scheme" android:host="auth" android:path="{/your-default-path}" />
</intent-filter>
</application>
<queries>
        <intent>
            <action android:name="android.intent.action.PROCESS_TEXT"/>
            <data android:mimeType="text/plain"/>
        </intent>
</queries>

iOS Setup

(Implementation for iOS follows similar patterns using ASWebAuthenticationSession)

Add this to your Info.plist:

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>your-auth-schema</string>
        </array>
    </dict>
</array>

---

🚀 Usage

Authenticating with Microsoft is now just a single function call away:

import 'package:ms_authenticate/ms_authenticate.dart';

final _msAuth = MsAuthenticate();

Future<void> login() async {
  try {
    final tokenData = await _msAuth.loginWithMicrosoft(
      tenantId: 'your-tenant-id',
      clientId: 'your-client-id',
      redirectUrl: 'your.custom.scheme://auth/login',
      scope: 'openid profile email offline_access',
    );

    if (tokenData != null) {
      final accessToken = tokenData['access_token'];
      print('Welcome! Access Token: $accessToken');
    }
  } catch (e) {
    print('Authentication failed: $e');
  }
}

---

📝 API Reference

Method	Description
loginWithMicrosoft(...)	Initiates the login flow and returns the full token map (access_token, id_token, etc).
getPlatformVersion()	Utility to check the native platform version.

---

🤝 Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

---

📄 License

Distributed under the MIT License. See LICENSE for more information.

---

📧 Support

For support or custom development, please reach out to the project maintainers.

---

Built with ❤️ for the Flutter Community.