Okta Integration

Integrating with Okta allows you to manage secure access to your Planergy account across various computer networks and cloud computing environments.  This is achieved through the comprehensive Identity & Access Management and Privileged Identity Management features provided by Okta.

Okta – Planergy integration ensures identities associated with users, computers, applications, and resources are safeguarded within a defined security boundary, providing strong protection in diverse networks and cloud environments.


How To Configure Planergy with Okta

You can establish strong protection of identities by configuring Planergy with Okta, using the single sign-on.

For successful Planergy-Okta integration, Planergy has to be set up as an attribute for the users in Okta to access Planergy.  

Note

This integration covers only SSO. 

For more information, refer to the following sections:

Creating Planergy Attribute for Users

To access Planergy, users must create the Planergy attribute.

  1. Navigate to your Okta account > Users > Profile Editor. The Profile Editor page is displayed.
  2. Press Profile in the Actions column associated with Okta profile. The Profile Settings page is displayed.
  3. Press Add Attribute. The Add Attribute dialog is displayed.
  4. Enter the new profile attribute named Planergy with its corresponding values as shown in the image below.

    Note

      By default, the Planergy attribute is set as Read Only.  This value can only be edited by the admins, who can permit users to update it by setting it to Read-Write.
  5. Click Save Attribute. The Planergy attribute is added.The Planergy attribute must be set for each user for proper functioning.
  6. On each user that is going to access Planergy, set a value for the Planergy parameter with the URL of your Planergy account. 
  7. Click Save. The parameter value for the Planergy attribute for the user is saved.

Configuring Planergy Application in Okta

To add the PurchaseControl (Planergy) application from Okta Marketplace, follow the steps below:

  1. Navigate to Applications in your Okta account. The Applications page is displayed.
  2. In the Quick Search field, enter PurchaseControl (Planergy). The PurchaseControl (Planergy) application is displayed as a dropdown.
  3. Click Add associated with the Planergy app. The PurchaseControl (Planergy) application is successfully added.
  4. Navigate back to Admin Console and switch to Classic UI.
  5. Navigate to Applications and search for the PurchaseControl application. Then, click the associated Settings icon.The Settings dialog is displayed.
  6. Click Sign On. The Sign On Methods section is displayed.
  7. Click View Setup Instructions.
  8. Follow the instructions on the page and send the following details in separate files to the Planergy Support team:
    • Generated Metadata
    • Generated certificate
    • Entity Id
    • Login URL-Sign on

The Planergy Support team will process your request.  

After receiving a confirmation email, you can assign people to the application.


How to Enable SSO Integration – Okta in Planergy

To enable the Okta in Planergy, an account owner user has to follow the steps below.

  1. Press the Control Panel on the Home page. The Control Panel page is displayed.
  2. Press Integrations under Advanced Controls. The Control Panel > Integrations page is displayed.
  3. Press Setup corresponding to Okta. The Control Panel > SSO Settings page is displayed.

How to Set Up SSO Integration – Okta in Planergy

Before connecting Planergy with Okta, it is important to ensure SAML fields are added.

  1. Navigate to the SSO Settings page > Okta section.
  2. Check the box Available.
  3. Press SAML.
  4. Fill in the fields with all the required details you received upon completing the Planergy configuration with Okta.
  5. Scroll down the SSO Settings page and press Save. A success notification about the setup is displayed.

How to Enable Okta on Users 

After setting up Okta with Planergy, ensure to enable it for all users you wish to allow access to in Planergy.

  1. Navigate to the Control Panel page > Organization and press Users. The Control Panel > Users page is displayed.
  2. Press anywhere in the user row you wish to activate Okta. The Edit User page is displayed.
  3. Enable the Use SSO toggle button.
  4. Select Okta from the SSO Provider dropdown list.
  5. Press Save. A success notification is displayed.

 

Updated on October 10, 2024
Was this article helpful?

Related Articles