Hikka Docs Hikka Docs

Local testing

How to test OAuth integration locally

Getting started

Once you’ve set up the OAuth pipeline for your application, it’s time to test it.

For testing I'd recommend ngrok. It's free service that gives you temporary domain and creates tunnel between your local environment and that domain.

Preparation

Download and install ngrok, after installation you can run it.

Configure it:

ngrok config add-authtoken your_ngrok_token

The ngrok token can be obtained in your personal dashboard after logging in.

Then you can run ngrok:

ngrok http PORT_OF_YOUR_APPLICATION

After that, copy the ngrok URL that was printed in the console.

Setup hikka

If ngrok already running, go to hikka application settings, select desired application and update Redirect URL to the new one obtained in first step.

Before:

https://your-domain.com/api/hikka/callback

After:

https://heterostyled-flex-runerify.ngrok-free.dev/api/hikka/callback

Congratulations

Now hikka will redirect authorization code directly to your local application.

After testing, don’t forget to update the redirect URL to the production one.

On this page