Breadcrumbs

How-to - Update an Expired Client Secret for the App Registration that represents the CI Sync Agent

Aim

Update an expired Client Secret (by regenerating the Client Secret) for the AAD/Entra ID App Registration that represents the CI Sync Agent itself (as distinct from any client secrets/app registrations for individual source connections such as InTune or Azure).

Once the Client Secret has been regenerated (via the Azure Portal), the instructions explain how to update the secret using the CI Sync Agent Config Utility User Interface.

This KB applies to:

Applies to Versions

All

Applies to Source Connectors

All

Applies to Destination Connectors

All

Process

Step 1 - Regenerate a new Client Secret using the Azure Portal

  1. In the Azure Portal, navigate to Azure Active Directory -> App Registrations and click All Applications

  2. Locate the App Registration that you originally created for the CI Sync Agent (e.g. “Syncfish – CI Sync – Agent”).

  3. Select the App Registration under the Display Name column.

image-20250328-051316.png

  1. Select Certificates & Secrets and use the Trash icon to delete the existing/expired Secret.

image-20250328-051337.png

  1. Click the “New client secret” button.

image-20250328-051357.png

  1. Enter a unique Description for the secret associated with the CI Sync Agent App Registration.

  2. Then, select a suitable Expires duration based on your organisational policy.  Finally click the Add button.

CleanShot 2025-07-02 at 09.24.31@2x-20250701-232515.png

  1. The form now displays the generated secret value (shown in the Value field).  Of Note:

    1. The Value is only available while you remain on this screen (i.e. you must make a copy of the Value field before leaving this form).

    2. Using the form, make a copy of the value in the Value field

CleanShot 2025-07-02 at 09.32.32@2x-20250701-233358.png

Data Capture Note

You will need the “Value” when performing Step 2 below (i.e. when you use the CI Sync Agent Configuration Utility to store the updated Client Secret).


Step 2 - Use the CI Sync Agent Config Utility to store the updated Client Secret

  1. Perform the following steps on the server where the CI Sync Agent is installed (referred to as the “CI Sync Agent Server”).

  2. Locate and run the “CI SynchronizerAgent Config Utility” program from the Windows Start Menu.

image-20260107-000115.png

  1. Click the Configure tab and paste the new Client Secret (generated in Step 1) into the “App Registration Client Secret” field on the form.

image-20250328-051902.png

  1. In the Test Connection section, click “Connect”.

  1. Follow any remaining prompts to save and exit.

  1. As a further verification you should do do the following:

    1. Login to your CI Sync SaaS UI (at https://YourCompany.syncfish.app/)

    2. Navigate the Settings Page and under Connections

    3. Confirm you have a green light against the CI Sync Agent connection.

image-20250328-051923.png

There are currently no related articles.

Control Information

Created

Reviewed

Data Classification

PUBLIC
Classified in accordance with the Syncfish Data Classification Framework