Skip to content

Latest commit

 

History

History
54 lines (37 loc) · 4.12 KB

msal-client-applications.md

File metadata and controls

54 lines (37 loc) · 4.12 KB
title titleSuffix description services author manager ms.service ms.subservice ms.topic ms.workload ms.date ms.author ms.reviewer ms.custom
Public and confidential client apps (MSAL) | Azure
Microsoft identity platform
Learn about public client and confidential client applications in the Microsoft Authentication Library (MSAL).
active-directory
mmacy
CelesteDG
active-directory
develop
conceptual
identity
10/26/2021
marsma
saeeda
aaddev, has-adal-ref

Public client and confidential client applications

The Microsoft Authentication Library (MSAL) defines two types of clients: public clients and confidential clients. The two client types are distinguished by their ability to authenticate securely with the authorization server and maintain the confidentiality of their client credentials.

  • Confidential client applications are apps that run on servers (web apps, web API apps, or even service/daemon apps). They're considered difficult to access, and for that reason can keep an application secret. Confidential clients can hold configuration-time secrets. Each instance of the client has a distinct configuration (including client ID and client secret). These values are difficult for end users to extract. A web app is the most common confidential client. The client ID is exposed through the web browser, but the secret is passed only in the back channel and never directly exposed.

    Confidential client apps:

    Web app Web API Daemon/service

  • Public client applications are apps that run on devices or desktop computers or in a web browser. They're not trusted to safely keep application secrets, so they only access web APIs on behalf of the user. (They support only public client flows.) Public clients can't hold configuration-time secrets, so they don't have client secrets.

    Public client apps:

    Desktop app Browserless API Mobile app

In MSAL.js, there's no separation of public and confidential client apps. MSAL.js represents client apps as user agent-based apps, public clients in which the client code is executed in a user agent like a web browser. These clients don't store secrets because the browser context is openly accessible.

Comparing the client types

Here are some similarities and differences between public and confidential client apps:

  • Both kinds of app maintain a user token cache and can acquire a token silently (when the token is already in the token cache). Confidential client apps also have an app token cache for tokens that are for the app itself.
  • Both types of app manage user accounts and can get an account from the user token cache, get an account from its identifier, or remove an account.
  • Public client apps have four ways to acquire a token (four authentication flows). Confidential client apps have three ways to acquire a token (and one way to compute the URL of the identity provider authorize endpoint). For more information, see Acquiring tokens.

In MSAL, the client ID (also called the application ID or app ID) is passed once at the construction of the application. It doesn't need to be passed again when the app acquires a token. This is true for both public and confidential client apps. Constructors of confidential client apps are also passed client credentials: the secret they share with the identity provider.

Next steps

For more information about application configuration and instantiating, see: