Configuring Access to the Open iT Shared Software Assets Directory (SSAD)

This guide provides step-by-step instructions for configuring access credentials to the Open iT Shared Software Assets Directory (SSAD). These credentials are required to securely connect to the SSAD API, encrypt sensitive information, and enable data synchronization and map fetching. Follow the instructions for your platform to ensure the credentials are properly set and encrypted.

Activating the Shared Software Assets Directory (SSAD) Feature

Windows

1. Open a command prompt with Administrator level privileges.

2. Go to the contrib\bin directory, which is by default in C:\Program Files\OpeniT\Core\contrib\bin, run the command:

   Command Syntax

   cd $ROOT_DIR\contrib\bin
   Example

   cd C:\Program Files\OpeniT\Core\contrib\bin

3. Once in the directory, run the command:

   Command Syntax

   activate_ssad.bat true

   The following arguments are available when running the activate_ssad script.

   Parameter	Description
   true	Use this to activate the SSAD jobs and configurations.
   false	Use this to deactivate the SSAD jobs and configurations.

   Available Parameters for activate_ssad
   
   

   You may also use the following options for activate_ssad.

   Option	Description
   --loglevel	Use this to print out usable logs for debugging the program.
   --help or -?	Use this to print out the notes and list of options to activate/deactivate the SSAD feature.

   Available Options for activate_ssad
   
   

Unix

1. Go to the contrib\bin directory, which is by default in /opt/openit/contrib/bin, run the command:

   Command Syntax

   cd $ROOT_DIR/contrib/bin
   Example

   cd /opt/openit/contrib/bin

2. Once in the directory, run the command:

   Command Syntax

   ./activate_ssad.pl true

   The following arguments are available when running the activate_ssad script.

   Parameter	Description
   true	Use this to activate the SSAD jobs and configurations.
   false	Use this to deactivate the SSAD jobs and configurations.

   Available Parameters for activate_ssad
   
   

   You may also use the following options for activate_ssad.

   Option	Description
   --loglevel	Use this to print out usable logs for debugging the program.
   --help or -?	Use this to print out the notes and list of options to activate/deactivate the SSAD feature.

   Available Options for activate_ssad
   
   

3. Change the file ownership by running the command:

   Command Syntax

   chown -R <openit_user>:<openit_group> /var/opt/openit/etc

   where:

   Parameter	Description
   <openit_user>	Use this to indicate the user name.
   <openit_group>	Use this to indicate the group name.

   Arguments to Change File Ownership
   
   
   Example

   chown -R openit:openit /var/opt/openit/etc

4. Verify that the file ownership of data_generation_config is changed. Run the command:

   Command Syntax

   ls -l /var/opt/openit/etc | grep data_generation_config

   This displays detailed information about the data_generation_config file.

   Example Output

   -rw-r--r-- 1 openit openit 8954 Apr 29 11:25 data_generation_config

5. Verify that the file ownership of core_mapping_ssad.oconf is changed. Run the command:

   Command Syntax

   ls -l /var/opt/openit/etc/scheduler | grep ssad

   This should display detailed information about the core_mapping_ssad.oconf file.

   Example Output

   -rw-r--r-- 1 openit openit 1425 Apr 29 11:25 core_mapping_ssad.oconf

Configuring the Shared Software Assets Directory (SSAD) Access Credentials

Windows

1. Coordinate with the Open iT Account Manager or Delivery/Support Team to get your SSAD access credentials.

2. Open a command prompt with Administrator level privileges.

3. Go to the bin directory, which is by default in C:\Program Files\OpeniT\Core\bin, run the command:

   Command Syntax

   cd $BIN_DIR
   Example

   cd C:\Program Files\OpeniT\Core\bin

4. Once in the directory, run one of following the commands:

   To encrypt and save the SSAD credentials, use this command:

   Command Syntax

   openit_ssad_connector --config --client_id <client_id> --client_secret <client_secret>

   To encrypt, save the SSAD credentials, and perform normal processes such as sending data to the SSAD API and fetching maps, use this command:

   Command Syntax

   openit_ssad_connector --client_id <client_id> --client_secret <client_secret>

5. After completing the steps, verify that the SSAD credentials are configured successfully. Go to the Configuration folder, which is by default in C:\Program Files\OpeniT\Core\Configuration, and check the credentials.json file to ensure the credentials have been updated.

   note

   The client secret value is already encrypted.

Unix

1. Coordinate with the Open iT Account Manager or Delivery/Support Team to get your SSAD access credentials.

2. Go to the bin directory, which is by default in /opt/openit/bin, run the command:

   Command Syntax

   cd $BIN_DIR
   Example

   cd /opt/openit/bin

3. Once in the directory, run one of following the commands:

   To encrypt and save the SSAD credentials, use this command:

   Command Syntax

   ./openit_ssad_connector --config --client_id <client_id> --client_secret <client_secret>

   To encrypt, save the SSAD credentials, and perform normal processes such as sending data to the SSAD API and fetching maps, use this command:

   Command Syntax

   ./openit_ssad_connector --client_id <client_id> --client_secret <client_secret>

4. After completing the steps, verify that the SSAD credentials are configured successfully. Go to the Configuration folder, which is by default in C:\Program Files\OpeniT\Core\Configuration, and check the credentials.json file to ensure the credentials have been updated.

   note

   The client secret value is already encrypted.