Scenario: Daemon application that calls web APIs

Learn all you need to build a daemon application that calls web APIs.

Prerequisites

Before reading this article, you should be familiar with the following concepts:

Overview

Your application can acquire a token to call a web API on behalf of itself (not on behalf of a user). This scenario is useful for daemon applications. It's using the standard OAuth 2.0 client credentials grant.

Daemon apps

Here are some examples of use cases for daemon apps:

  • Web applications that are used to provision or administer users, or do batch processes in a directory
  • Desktop applications (such as windows services on Windows, or daemons processes on Linux) that perform batch jobs, or an operating system service running in the background
  • Web APIs that need to manipulate directories, not specific users

There's another common case where non-daemon applications use client credentials: even when they act on behalf of users, they need to access a web API or a resource with their identity for technical reasons. An example is access to secrets in KeyVault or an Azure SQL database for a cache.

Applications that acquire a token for their own identities:

  • Are confidential client applications. These apps, given that they access resources independently of a user, need to prove their identity. They're also rather sensitive apps, which they need to be approved by the Azure Active Directory (Azure AD) tenant admins.
  • Have registered a secret (application password or certificate) with Azure AD. This secret is passed-in during the call to Azure AD to get a token.

Specifics

Important

  • User interaction isn't possible with a daemon application. A daemon application requires its own identity. This type of application requests an access token by using its application identity and presenting its application ID, credential (password or certificate), and application ID URI to Azure AD. After successful authentication, the daemon receives an access token (and a refresh token) from the Microsoft identity platform endpoint, which is then used to call the web API (and is refreshed as needed).
  • Because user interaction is not possible, incremental consent won't be possible. All the required API permissions need to be configured at application registration, and the code of the application just requests statically defined permissions. This also means that daemon applications won't support incremental consent.

For developers, the end-to-end experience for this scenario has the following aspects:

  • Daemon applications can only work in Azure AD tenants. It wouldn't make sense to build a daemon application that attempts to manipulate Microsoft personal accounts. If you're a line-of-business (LOB) app developer, you'll create your daemon app in your tenant. If you're an ISV, you might want to create a multi-tenant daemon application. It will need to be consented by each tenant admin.
  • During the Application registration, the Reply URI isn't needed. You need to share secrets or certificates or signed assertions with Azure AD, and you need to request applications permissions and grant admin consent to use those app permissions.
  • The Application configuration needs to provide client credentials as shared with Azure AD during the application registration.
  • The scope used to acquire a token with the client credentials flow needs to be a static scope.

Next steps