Install the Okta Provisioning Agent
Before configuring on-premises provisioning for an app, install the Linux or Windows Okta Provisioning Agent. You can connect your Okta Provisioning Agent to multiple on-premises apps, but you must provide a unique SCIM server URL for each app.
Linux
- In the Admin Console, go to . Click Download Latest for Okta Provisioning Agent (x64 RPM).
- Optional. Verify the integrity of the file that you downloaded. Compare its file hash and file size to those listed on the Downloads page.
The following commands use OktaProvisioningAgent.rpm as a placeholder. Replace it with the name of the file that you downloaded (for example, OktaProvisioningAgent-02.00.15-5abcd5e.x86_64.rpm).
- Generate the SHA-512 file hash for the Okta Provisioning Agent by running the following command:sha512sum OktaProvisioningAgent.rpm
- List the size of the Okta Provisioning Agent file:ls -l OktaProvisioningAgent.rpm
- Return to the Downloads page. Confirm that the file hash and file size information for your downloaded file match the information that's displayed for Okta Provisioning Agent (x64 RPM).
- Copy the Okta Provisioning Agent file to a scratch directory, and then cd to that directory.
- Install the agent by entering the following, replacing OktaProvisioningAgent.rpm with the name of your downloaded file: sudo yum localinstall OktaProvisioningAgent.rpm
- When you're prompted to continue, enter y.
- Enable TLS 1.2.
- Run the following script:sudo /opt/OktaProvisioningAgent/configure_agent.sh
- Enter the URL of your org at the prompt (for example: https://mycompany.okta.com).
- In your browser, go to the URL that the configuration script output and sign in.
- To enable the Okta Provisioning Agent to access the Okta API, click Allow Access.
- Return to the command line. After you receive a successful configuration message, enter the command:service OktaProvisioningAgent start
- To confirm that the Okta Provisioning Agent is running, enter the following:service OktaProvisioningAgent status
You can find the Okta Provisioning Agent's process identification number in /var/run/OktaProvisioningAgent.pid.
Windows
- In the Admin Console, go to . Click Download Latest for Okta Provisioning Agent (Windows x64 EXE).
- Optional. Verify the integrity of the file that you downloaded. Compare its file hash and file size to those listed on the Downloads page.
The following commands use OktaProvisioningAgent.exe as a placeholder. Replace it with the name of the file that you downloaded (for example, OktaProvisioningAgent-02.00.15-5abcd5e.x86_64.exe)
- Generate the SHA-512 file hash for the Okta Provisioning Agent by running the following from a command prompt: CertUtil -hashfile OktaProvisioningAgent.exe SHA512
- Browse to the location where you downloaded the Okta Provisioning Agent, right-click the file, select Properties, record the value displayed in the Size field, and click OK.
- Return to the Downloads page. Confirm that the file hash and file size information for your downloaded file match the information that's displayed for Okta Provisioning Agent (Windows x64 EXE).
- Launch the installer, and then click Next.
- In the License Agreement dialog box, click Next.
- Optional. Change the installation folder, and then click Install.
- Enter your Okta Customer Domain URL, and then click Next.
- In your browser, sign in to your org.
- Grant permission to access the Okta API by clicking Allow Access.
- Return to the installer, and then click Finish.
- Sign in to Okta.
- Enable TLS 1.2.
- In Admin Console, select Agents. Verify that the configured Okta Provisioning Agent is in the list.