How-to - Update an expired client secret for Azure source connection

Task 1: Create new client secret for Azure source connection

Context Notes

The App Registration referred to in this document relates to the Azure Source Connection created within the CI Sync Agent. 

This Azure specific App Registration is different (and unrelated) to the App Registration for the CI Sync Agent itself.

  1. In the Azure Portal, navigate to Azure Active Directory -> App Registrations

  2. Select the CI Sync (EE) Agent Connector for Azure

  3. Using the left-hand menu, navigate and select Certificates & secrets.  Select “Client secrets (1)” in the middle of the form and then click the “New client secret” button. n.b. the existing expired client secret should be visible.

image-20250403-031432.png
  1. Enter a unique Description for the secret associated with this CI Sync Agent Connector for Azure App Registration (e.g. “CI Sync Agent Connector for Azure Client Secret”).

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

image-20250403-031506.png

Guidance Note

It is recommended you set a reminder prior to the expiry date of the Secret (i.e. a reminder to regenerate and update the Secret in the CI Sync Agent configuration.


  1. The form now displays the newly generated secret value (shown in the Value field). Use the copy option to make a copy of the value in the Value field.

CleanShot 2025-07-02 at 09.40.49@2x-20250701-234208.png

Data Capture Note

  1. The Value is only available while you remain on this screen. You must make a copy of the Value before leaving this form.

  2. Make sure you copy the “Value” and NOT the “Secret ID”.

Task 2: Update the client secret for Azure source connection in the CI Sync Agent Config Utility

  1. On the server where the CI Sync Agent is installed (referred to as the “CI Sync Agent Server”).

  2. Locate and run the “CISynchronizerAgent Config Utility” program.

  3. Click the Source Systems tab

  4. Double click the Azure connection.

Update azure client secret 2.jpg
  1. Replace the client secret with the one you previously generated and copied above.

Update azure client secret.jpg


  1. Click the Setup & Test button.

  2. Click Yes.

image-20260402-031341.png
  1. Then click Save.