Add Shared Credentials
    • Dark
      Light
    • PDF

    Add Shared Credentials

    • Dark
      Light
    • PDF

    Article Summary

    The ControlUp Monitor Service uses two types of synchronized user credentials:

    • Monitor credentials. Synchronized between monitors only. Required to deploy agents to managed hosts and authenticate towards the managed machines. You can use monitor credentials for AD connections (On-prem + Hybrid Cloud pre 9.0), proxy, and SMTP settings.
    • Shared credentials. Same properties as monitor credentials, but also synchronized with Real-Time Console user passwords. You can use shared credentials to connect to data sources and in Script-based actions (SBAs).

    You can use the Real-Time Console to set shared credentials to use with your configured Hypervisor, XenDesktop, and Netscaler connections. This enables streamlined management of credentials and a quicker onboarding process for new ControlUp users which doesn't require them to know the service usernames and passwords.

    To manage credentials with PowerShell commmands, see Manage CUCredentials.

    Create Shared Credentials

    1. Click the Settings tab in the Home ribbon and select Monitors.
      image.png

    2. In the Manage ControlUp Monitors window, click Monitors Settings.
      image.png

    3. Click Add Credentials Set.
      image.png

    4. In the Add New Credentials popup, enter the User, Password, select the Domain and Friendly Name of the new service account. If you want to configure this user as a shared user, check the Share credentials with authorized users checkbox.
      image.png

    The user is now added to the credentials list and the Shared checkbox indicates that the user is shared user.
    image.png

    1. You can validate the user credentials to check if the entered credentials are valid. Mark the user that you created and click Validate. If your user credentials are validated successfully, you should see this popup message:
      image.png

    If the credentials are not successfully validated, this popup appears:
    image.png

    If the credentials you want to share are already configured, check the box under the Shared column to share it with your users.
    image.png

    Grant Permission for Organizational Users to use Shared Credentials

    Organizational Users can't use shared credentials. You must create a Security Role to grant permission to use shared credentials. Once you've saved your credentials as shared credentials, on the bottom of your console click the Security Policy Pane and open the permissions tree for Perform organization-wide actions.
    image.png

    Scroll down to the bottom of the organization-wide permissions tree to Shared Credentials, choose the Security Role you want to grant permissions to, and set that permission to Allow.
    image.png

    Once you have created the shared credential, and granted permissions to users to make use of it, it will become available to set in the Connection Settings of your Hypervisors, XenDesktop Sites, Cloud, and Netscaler Connections.
    image.png

    Notes on Shared Credentials:

    • The shared credentials metadata (including the friendly name, username, and domain name) is stored in your organization's public configuration store.
    • The shared password is stored in the private configuration store (located in the %AppData% folder of the monitor network service or the console user profile) encrypted with DPAPI encryption, and never leaves the customer's premises.

    Was this article helpful?