Reading Time: 7 minutes

It sounds like the title for a fantasy movie, but Google, OAuth and the “confused deputy” is a very common issue. Wikipedia defines a confused deputy as “a computer program that is innocently fooled by some other party into misusing its authority. It is a specific type of privilege escalation” (complete article here).

The Wikipedia article shares an example of a compiler exposed as a paid service. This compiler receives an input source code file and the path where the compiled binary is to be stored. This compiler also keeps a file called BILLING where billing information is updated each time a compilation is requested. If a user were to request a compilation setting the output path to “BILLING”, then the file would be overwritten and the billing information lost. In this case, the compiler is a “confused deputy” because although the client doesn't have access to the file, it's tricked the compiler (who does have access) into altering the file.

Applying the Concept to Google Authorization

latest report
Learn why we are the Leaders in API management and iPaaS

In which situation could Google's OAuth provider become a confused deputy? OAuth is an impersonation protocol. It allows an application to perform actions on behalf of a user who has authorized the application to do so, by consenting the application's scopes and entering their credentials into a browser displaying a login hosted by the provider. In the case of Google, that login page supports having multiple users logged in at the same time, as shown in the screenshot below:

Here we see two of my accounts. So, imagine you're doing a multi-tenant application that synchronizes your Salesforce contacts with your Google Contacts, moving valuable marketing information from one system to the other. Let's call this application “The Contacts Avenger”. There're two ways in which the above screen can lead you to a confused deputy:

  • You accidentally click on the wrong account. This has no major consequence other than the effort of cleaning up the information that ended up in the wrong account.
  • Someone physically or by other means takes control of your computer or your “Contacts Avenger” account, and by presses the “Add Account” button, thereby authenticated a third one which they use to steal your information. This just got serious! There's somebody stealing the leads that took you so long to collect.

Mitigating the problem

Google is well aware of the problem. They say that you must validate the access token before using it to prevent the confused deputy from happening. What's validating the token? Google's OAuth provider has an endpoint that provides information about a given access token such as user id, email address, expiration time, etc.

So, if you're making a multi-tenant application such as the “Contacts Avenger”, that means that the user probably has a registered account with you. Verifying that the access token you just obtained actually matches that account is a simple step you can take.

How Does Help Solve the Problem

Our Google connector suite not only helps by making it easy to perform the whole OAuth authentication dance, it also helps you validate the access token. While authenticating, the connectors will validate the access token by requesting the user id and email associated with the obtained token. Those values are exposed through two flow variables called GOOGLE_USER_ID and GOOGLE_USER_EMAIL. You could then make sure that the obtained email matches the one you were expecting with a flow similar to this:

The above snippet shows a standard OAuth authorization flow which begins with a reference to a flow that loads tenant information (the example shows a mock implementation, in real life you'd have to take this from a persistent store). After performing the authorization, there's a choice router which verifies that the authenticated account is the one actually expected. If that's not the case, another flow with rejection and reporting logic is invoked.

Long Story Short

Remember that when authenticating through OAuth, it's not you receiving and validating the user's credentials. So no matter which API you're using or if the API support multiple logins like Google does, you should always take measures against a confused deputy attack.

Do you know other API's particularly vulnerable to this problem? If so, please do share!