Home

The Objective-C Microsoft Authentication Library (MSAL) is an Auth SDK that can be used to seamlessly integrate authentication into your app and give access to the entire Microsoft ecosystem.

This platform allows you to easily target several identities including Azure AD (Work and School accounts), Microsoft account (Outlook.com, hotmail.com, and several others), or Azure AD B2C (Social and Local accounts). Your app will then have access to the entire set of Microsoft cloud APIs including the Microsoft Graph, Office 365, Azure, and any API you want to protect.

The wiki is intended to document common patterns, error handling & debugging best practices, extra library functionality (e.g. logging, telemetry), and any active bugs or common issues with known mitigations. If you're looking for more help getting started with Azure AD, Microsoft Accounts, or Azure AD B2C, check out the full Microsoft identity platform docs. If you're looking for more info about the Microsoft Graph API, check out the Microsoft Graph docs.

This wiki will be evolving over time. If you have a question about MSAL SDK, found an error in the documentation or need a recommendation on, please create a Github issue with the details!

Getting started with MSAL SDK

• Home
• Register your app
• Getting Started
• MSAL Code Sample
• Single Sign-on (SSO)
• Error Handling

Configure, Build, Test, Deploy

• Installation
• Configuring your app
• Targeting different identity types

Advanced Topics

• Customizing Browsers and WebViews
• Logging
• Sovereign clouds
• B2C

Getting Help, Common Issues, and FAQ

• Redirect URIs
• Requesting individual claims
• Keychain cache
• SSL issues
• iOS 13 and macOS 10.15 support

Migrating

• ADAL to MSAL

News

• Releases