Identity Platform Core

How to Test a Website with Unify IdP on a Local Workstation


This guide outlines the steps required to run Unify Identity Provider (IdP) locally on your workstation. This example assumes that the user already has credentials on the local development environment and wishes to run the setup on their personal machine.


  • Existing credentials on the local development environment
  • Administrative access to the corresponding tenant and specific environment (prod/qa/sandbox)


1. Modify the Host File

Determine how to spoof your host file on your machine, whether it's macOS, Windows, or Linux.

2. Install a Local SSL Certificate

Ensure that a local SSL certificate is installed on your site.

3. Choose an Appropriate Local Name for Spoofing

Select a suitable local name for spoofing. Avoid using generic names like site.test. We recommend using names that are relevant to the project. For example:

  • gws-project-fr.test
  • gws-someproductname-ca.test
  • gws-countrysite-nl.test

4. Log in to the Admin Panel

Log in to the admin panel corresponding to the tenant and specific environment (prod/qa/sandbox).

5. Navigate to Integrations

Search for the "Clients" section under "Integrations."

6. Locate the Relevant Site/Client

Find the site or client that corresponds to your project.

7. Create a Callback URL

Transform the local URL into a callback URL by appending the correct URI.

8. Add the New Callback URL

Add the new callback URL without any spaces. Separate multiple URLs with commas, and do not include a trailing comma.

URL Callback

Example Before:

Example After:,https://gws-project-fr.test/unify/callback

Important Note

Never perform these steps on a production environment; only use staging.

By following this guide, you should be able to successfully run Unify IdP locally on your workstation.


Unify Europe

Pieter Smit Sales

Ankerweg 2

1041 AT


+31 88 44 70 000

Mon-Fri 9am-6pm CET


Unify LLC

Tara Tromp Sales

14425 Falcon Head Blvd.

Building E - Suite 100

Austin, TX 78738


Mon-Fri 9am-6pm CET


Unify LTD

Joris ter Wolbeek Sales

1-2-20 Kaigan

3/F Shiodome Building

Tokyo, 105-0022

Mon-Fri 9am-6pm CET

Unify is not affiliated with IQVIA or IQVIA's team, nor is it endorsed by or related to IQVIA. Unify is not affiliated with Veeva Systems or Veeva Systems's team, nor is it endorsed by or related to Veeva Systems. Unify is a division of SMIT. Digitaal vakmanschap BV. Crafted in Amsterdam.

© Unify LLC. All rights reserved.