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:
- 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
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.
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.