How to update account credentials in Cayosoft Administrator

Overview

Cayosoft Administrator uses two different types of accounts to operate in any environment and collect corresponding data:

• A service account used to run the Cayosoft Administrator Service.

• An extension-specific connection account used to collect extension-specific data in your environment.

Depending on the scenario, a need to update the credentials might arise. This article covers the steps to update the account data for both types of accounts in your Cayosoft Administrator deployment.

IMPORTANT: Depending on the extension, the connection account must have appropriate permissions to connect to the target system and collect data. For information on the permissions, refer to the following articles: Required permissions for connection accounts in Cayosoft Administrator .

Updating the Cayosoft Administrator Service account

NOTE: The default Cayosoft Administrator Service account is a local system account.

Follow the steps below to alter the Cayosoft Administrator Service account:

1. On the Cayosoft Administrator server, navigate to the Services snap-in. You can search for the snap-in in the Search bar; alternatively, you can press Win-R, type services.msc, and click OK to open the snap-in.

2. Locate the Cayosoft Administrator Service, right-click it and select Properties.

3. Click the Log on tab.

4. Select the This account radio button. Specify the username manually or browse for the new service account and enter and confirm the password.

5. Click OK to save the changes.

6. Right-click the service and select Restart the service.

7. Wait for the service to restart. Once the service is running, start the Cayosoft Administrator console.

Updating the extension connection accounts

The steps below reference the Active Directory extension as an example.

1. In the Cayosoft Administrator Console, navigate to Home > Configuration > Connected Systems Extensions.

2. Select the extension you want to modify a service account for. For the purposes of this example, the Active Directory extension is selected.

3. On the extension page, click the ... button to the right of the credential section.

4. Specify the username and password.

5. Click OK.

6. Click Save Changes.

7. In the Action pane on the right, click Check Settings to verify the account credentials are correct.

Update credentials for Active Directory extension

1. Log in to the Cayosoft Administrator console with an account that has administrator privileges.

2. Go to Configuration > Connected System Extensions > Active Directory.

3. Locate the relevant Active Directory connection and click the selector button next to Active Directory default credentials.

   • Update the connection account and password:

   • Enter the new service account username (if changing) and the updated password.

   • Ensure that the account has sufficient permissions to perform the required tasks within your on-premises AD environment.

4. Save changes:

   • Click Save to apply the updates.

   • Test the connection to verify that the new credentials work as expected: click Check Settings under Actions.

Update credentials for Microsoft 365 extension

IMPORTANT: For security purposes, Cayosoft Administrator requests to reconnect to the Microsoft 365 tenant to find the Cayosoft Administrator Entra app registered previously.

1. Log in to the Cayosoft Administrator console with an account that has administrator privileges.

2. Go to Configuration > Connected System Extensions > Microsoft 365.

3. Click the ... selector button next to Microsoft 365 default credentials and update the connection account and password.

   NOTE: Make sure the account has the necessary permissions in Entra ID to manage objects, such as User Administrator or other roles that your setup requires. Learn more in: Entra ID application permissions required by Cayosoft Administrator Service.

After you update the credentials, Cayosoft Administrator requests you to reconnect to the managed Microsoft 365 tenant to find a previously registered Entra app or create a new one. Refer to the following article for additional information on required steps: Register application and grant consent to access managed tenant.

Update credentials in the replication node

In the Replication settings of Cayosoft Administrator, you can set up a custom, non-default account to connect from your Subscriber server to the Publisher server.

Validate changes

After updating credentials for both connections, perform a few test operations to ensure Cayosoft Administrator can:

• Modify on-premises AD objects (e.g., user creation, password resets).

• Execute Entra ID changes (e.g., user provisioning, attribute updates).

If any operation fails, double-check the permissions assigned to the updated accounts to ensure Cayosoft Administrator has the necessary access.

Notes

• When you investigate expired accounts in the Active Directory extension, review and verify credentials of the following accounts:

  • Default connection account

  • Default forest account

  • Default domain account

  The Unable to contact the Global Catalog Server error is one of the possible symptoms of the expired credentials in the extension. Refer to the following screenshot for places to check for expired credentials in the AD extension.