Azure AD OAuth Client credentials flow access control

Question

I am using Azure AD OAuth2 authorization, to secure my Web API. Now i need to support two OAuth2 scenarios(flows) -

Web application accessing the Web API, and the API based on the user's role will serve a resource. This is the achieved using authorize oauth flow, and access control is done using Authorize[Role="Read"] attributes
A daemon(console) application accessing the same Web API. Though i am able to get a token by using the client credentials oauth flow, but i am not able to figure how to manage access to the daemon process

Once the token is issues the console can literally access any of the API methods.

Scope - when grant_type is "client_credentials" scope is not a parameter to /token endpoint Role - Cant use it as this is associated with user

Can somebody please suggest, how we can do access control in client credentials flow ? And how i can cater both requirement 1 and 2 at the same time

juunas juunas · Accepted Answer · 2017-08-30T11:18:50

You can define "roles" for both the users and the applications in your API's manifest in Azure AD.

Application roles are actually application permissions if you are wondering.

So you can have something like this in your API manifest (other properties removed for clarity):

{
  "appRoles": [
    {
      "allowedMemberTypes": [
        "Application"
      ],
      "displayName": "Read all things",
      "id": "32028ccd-3212-4f39-3212-beabd6787d81",
      "isEnabled": true,
      "description": "Allow the application to read all things as itself.",
      "value": "Things.Read.All"
    },
    {
      "allowedMemberTypes": [
        "User"
      ],
      "displayName": "Read things",
      "id": "ef8d02ff-eee1-6745-9387-96587c358783",
      "isEnabled": true,
      "description": "Allow the user to read things.",
      "value": "Things.Read"
    }
  ]
}

So we are defining a role that allows only applications as its members. It's an application permission. The other is a role that can be given to users and groups.

You can then give users the Read things role, and the daemon console app the Read all things application permission. And you achieve both scenarios :)

You add the role to users/groups by going to Enterprise applications->Your API->Users and groups->Add user. Select the users/groups you want and then select a role for them (if you have only one it will be pre-selected).

You add the application permission by finding the other application's App Registration->Required permissions->Add->Find your API->Select->Check the application permission you defined earlier from the list. Then you can press the Grant Permissions button to grant the app role.

You then get the value in the roles claim for either scenario.

So the roles claim will look like this in the first scenario:

"roles": [
    "Things.Read"
  ],

and like this in the second scenario:

"roles": [
    "Things.Read.All"
  ],

Azure AD OAuth Client credentials flow access control

2 Answers