How to authenticate Hāpara with OAuth 2.0 Follow

In this Article

Why is this important?

OAuth 2.0 is the industry-standard protocol for authorization.

Google requires that all third-party applications (like Hāpara) receive permission from a domain Super Administrator to allow functionality within a G Suite domain.

To grant these permissions, a Super Admin must add the Hāpara Dashboard app to the school's domain from the Google Apps Marketplace.

This article describes how super administrators can grant the required permission.

Note for multi-domain setups: For setups with teachers and students in completely different domains, you must perform these steps for each domain.

For setups with teachers or students in subdomains, you only need to perform these steps for your root domain.

Step-by-Step Instructions (5 minutes)

  1. Log into Google Suite as a domain super-administrator.
  2. Browse to the Google Suite Domain Admin Console (
  3. Click the Apps button.Screen_Shot_2020-04-27_at_2.19.07_PM.png
  4. Click Manage on the G Suite Marketplace apps tile.


  5. Click the Add app to Domain Install button to open the G Suite Marketplace in a new tab.


  6. Type “Hapara” into the pop up window's Search Apps field, and hit enter.


  7. Click on Hapara Teacher Dashboard.


  8. Click the Domain Install button Screen_Shot_2020-04-27_at_2.08.57_PM.png
  9. A “Domain wide install” window will appear. Click “Continue”.Screen_Shot_2020-04-27_at_2.10.03_PM.png
  10. You will be asked to give Hapara Teacher Dashboard access to your domain’s data. After reading our terms of service, click the checkbox and click Allow.Screen_Shot_2020-04-27_at_2.12.11_PM.pngScreen_Shot_2020-04-27_at_2.11.52_PM.png
  11. When you see the confirmation screen, click Done.Screen_Shot_2020-04-27_at_2.16.00_PM.png

Remember: If teacher and student accounts are in different Google Suite domains, then you must do the steps listed above for each teacher and student domain.

That’s it! If you have any questions or concerns, please feel free to reach out via, or send us a request.

Have more questions? Submit a request