Skip to main content
Version: 10.3

Configuring Okta HR Roster Data Collector

Open iT collects Okta HR roster data and sends it over to the server. This allows cloud-based server installation to integrate the Active Directory to its reports.

Requirements​

Configuring Okta HR Roster Data Collection​

Step 1: Open Command Prompt​

  1. Open a command prompt with Administrator level privileges.

Step 2: Navigate to the bin Directory​

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

Step 3: Activate Okta HR Roster Data Collection​

  1. Run the following command to enable Okta HR roster data collection:

    Command Syntax
    openit_oconfinit -u "collect_oktaad.root.scheduler.jobs.collect_oktaad.general.active=true"

Step 4: (Optional) Activate Collection for a Specific Okta ID Account​

If you configured multiple Okta ID accounts and want to collect HR roster data from a specific account, include the --name argument followed by the configured account name.

Run the following command:

Command Syntax
openit_oconfinit -u "collect_oktaad.root.scheduler.jobs.collect_oktaad.operations.arguments=okta collect hrroster --output \"${OpeniT.directories.temp}/IdpConnector/Okta/HRRoster/oktaad.tsv\" --fields email displayName login department division usertype city title --name <name>"

where <name> is the name of the account you want to use for data collection.

Example
openit_oconfinit -u "collect_oktaad.root.scheduler.jobs.collect_oktaad.operations.arguments=okta collect hrroster --output \"${OpeniT.directories.temp}/IdpConnector/okta/HRRoster/oktaad.tsv\" --fields email displayName login department division usertype city title --name okta1"

Verifying Data Collection​

After configuration, you can verify that the Okta HR roster data is collected by following these steps:

Step 1: Open Command Prompt​

  1. Open a command prompt with Administrator level privileges.

Step 2: Navigate to the bin Directory​

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

Step 3: Run the HR Roster Collection Command​

  1. Execute the following command:

    Command Syntax
    openit_idpconnectorconsole okta collect hrroster --output "C:\ProgramData\OpeniT\data\temp\IdpConnector\Okta\HRRoster\oktaad.tsv" --fields email displayName login department division usertype city title

Step 4: Verify the Output File​

  1. Navigate to C:\ProgramData\OpeniT\data\temp\IdpConnector\Okta\HRRoster.

  2. Verify that the file oktaad.tsv is created.

    Sample File Content
    email displayName login department division usertype city title
    john_doe@example.com	John Doe	john_doe@example.com	Department01	Division01	Employee	Manila	Role01
    jane_doe@example.com	Jane Doe	jane_doe@example.com	Department01	Division01	Employee	Manila	Role02
    juan_delacruz@example.com	Juan Dela Cruz	juan_delacruz@example.com	Department02	Division01	Employee	Manila	Role03
    maria_delacruz@example.com	Maria Dela Cruz	maria_delacruz@example.com	Department02	Division01	Employee	Manila	Role04