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

Introduction

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.

Prerequisites

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

Steps

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:

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

4. Log in to the Admin Panel

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:

https://website.com/unify/callback

Example After:

https://website.com/unify/callback,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.