Skip to main content

Quick Start Guide

This guide leads the reader through the steps to quickly install Usercube's bootstrap version.

Prerequisites​

The installation of Usercube requires:

Install the Bootstrap Version​

Step 1 – Go on the Netwrix portal and download the artifacts of the expected version.

Extranet Artifacts

Step 2 – Extract from SDK the folder UsercubeBootstrap anywhere on the computer.

Step 3 – Extract the content of Runtime to UsercubeBootstrap.

When extracting UsercubeBootstrap to the root of the computer, it looks like:

Project Directory

Step 4 – Move or copy your certificate inside the Runtime folder.

Step 5 – Create a Sources folder in UsercubeBootstrap.

Remember, if you don't have the UsercubeBootstrap folder or if you don't create the Sources folder, the Path in the Directory connection in the Runtime/appsettings.agent.json must be adapted. Note that you don't need to have a Directory.xlsx file at the location described by this Path for now.

Step 6 – Create a database named Usercube, using the default options.

NOTE: When using a database server other than Microsoft SQL Server or a different database name, remember to change the connection string accordingly, in the Runtime/appsettings.json file and in the future command lines.

Step 7 – Execute the Runtime/identitymanager.sql file in the database.

Step 8 – Open a command prompt and deploy the configuration. See the Usercube-Deploy-Configuration topic for additional information.

In our example, the command would be, in the Runtime folder:

Code attributes enclosed with <> need to be replaced with a custom value before entering the script in the command line.

./identitymanager-Deploy-Configuration.exe -s "<data source=.;Database=Usercube;Integrated Security=SSPI;Min Pool Size=10;encrypt=false;>" -d "<C:/identitymanagerBootstrap/Conf>"

Step 9 – Launch the server. See the Usercube-Server topic for additional information.

In our example, the command would be, still in the Runtime folder:

./identitymanager-Server.exe

Step 10 – Open a browser and navigate to http://localhost:5000. Authenticate with administrator as a username and the password specified in the Runtime/appsettings.json file, in the Authentication section.

Authentication Dialog

Now you can start using the application.

Next Steps​

From there, you can start setting up Usercube via the Settings page which is accessible from the Configuration section of the home page.

Home Page - Settings

Then, Netwrix recommends following the user guide to start the configuration of your IGA project from scratch. See the User Guide topic for additional information.