Using client_credentials with Microsoft Graph in Hybrid Exchange setup

If you or your customers are running hybrid Microsoft Exchange deployment and you are using Microsoft Graph, you might have noticed that using the client_credentials grant flow doesn’t really work and ends with errors. Last week, we have had a customer who we have been integrating few systems for, and hit the exactly same issue.

So far, Microsoft has been only demonstrating hybrid Graph with regular authorization_code grant flow. If you wanted to run your application as a deamon, you had to rely on not-so-secure resource_owner grant which is way less secure than client_credentials flow which we will focus on.

Initially, when you try to call Microsoft Graph via client_credentials with user which has their mailbox on-prem, you will end up with UnknownError. What you can find on the internet is to add V1S2SAppOnly to your web.config‘s (…\FrontEnd\HttpProxy\rest\web.config) line <add key=”OAuthHttpModule.Profiles”. That’s a good way to start, so make sure you have done it. And that’s about all that the internet says about the issue, however if you try calling Graph again, you will end up with an error again.

So what to do next? Well I will describe a way how I figured it out, so if you want to find the fix, head to the end of this article.

Disclaimer: Please note that the steps described below are unsupported by Microsoft and while unlikely, it may corrupt your hybrid setup.

Initially, I thought that Exchange just didn’t support the flow. But after doing some reading, I ended up with a conclusion that it had to be supported. I decided to try to enable IIS logging to capture the WWW-Authenticate header, which Exchange Server sends along with responses. Thanks to that, I managed to get an error message:

This error message suggested that there is something wrong with the configuration. The key word here is partner application. If you do some search, you can find out that Partner Applications are used to allow access to the Exchange’s REST API.

If you call Get-PartnerApplication commandlet via PowerShell, you will end up with a list of two apps by default in hybrid setup – Exchange Online and Microsoft Graph. If you list the properties of Microsoft Graph, you end up with following:

In the configuration above,the two most important line of all for us is AppOnlyPermissions which has no configuration. Now this is where it gets confusing, Set-PartnerApplication can set the property, however according to the docs, it is reserved to Microsoft’s internal use. However, that doesn’t mean that it won’t work!

Simply running the PowerShell above is going to take the ActAsPermissions and set it to AppOnlyPermissions. All you have to do then is to restart IIS and you should be good to go with using client_credentials flow!

Honestly, I don’t understand why this is not set by default – maybe there are some security reasons behind this, but all in all, you can use client_credentials with hybrid deployments now!

Author: Jan Hajek

I am Honza, hi. @hajekj |

One thought on “Using client_credentials with Microsoft Graph in Hybrid Exchange setup”

  1. Last time i was trying to make this work i was stuck at Set-PartnerApplication for Graph. When i try to do that i used to get error like below.

    A parameter cannot be found that matches parameter name ‘AppOnlyPermissions’.
    + CategoryInfo : InvalidArgument: (:) [Set-PartnerApplication], ParameterBindingException
    + FullyQualifiedErrorId : NamedParameterNotFound,Set-PartnerApplication
    + PSComputerName :

    [PS] C:\Windows\system32>

    Exchange server version

    Get-ExchangeServer | Format-List Name,Edition,AdminDisplayVersion

    Name : EC2AMAZ-OIDU4KE
    Edition : Standard
    AdminDisplayVersion : Version 15.1 (Build 1591.10)

    Am i missing anything ??

    May i know in which exchange management shell you tried this ? And where did you connect (O365 or Local exchange) to execute this command ?

Leave a Reply