Microsoft 365 Admin - How to Update OAuth2 Client Secrets in Azure (Portal)

Tags azure secret

Overview

This article explains how to renew application client secrets in Microsoft Entra ID, save the new credentials in 1Password, update the connected application, and verify that authentication and application functions work correctly. Application-specific instructions, including Clockwork by TechnoPro, appear below.

Target Audience

Solutions Specialists, Infrastructure

How to Update OAuth2 Client Secrets in Azure (Portal)

1. Sign In and Activate the Required Role

  1. Go to Azure Portal and sign in with your administrative account.
  2. Activate Cloud Application Administrator in PIM if required to manage the app registration.

2. Open the App Registration

  1. Go to Microsoft Entra ID → App registrations → All applications.
  2. Search for and select the application.

3. Review Existing Client Secrets

  1. Select Certificates & secrets → Client secrets.
  2. Review the descriptions and expiration dates.
  3. Identify the secret that needs renewal.

Note: Renew secrets before they expire whenever possible. Keep the existing valid secret in place until the replacement has been applied and tested.

Uploaded image

older screenshot with more detail...Uploaded Image (Thumbnail)

4. Create a New Client Secret

  1. Click New client secret.
  2. Enter a meaningful description identifying its purpose.
  3. Select an expiration period consistent with institutional requirements.
  4. Click Add.

5. Copy and Securely Store the Value Immediately

  1. Copy the complete entry from the Value column.
  2. Save it in the appropriate 1Password entry and provide to the Application Administrator as to add to the application admin portal.
  3. Record the application name, secret description, and expiration date alongside it.

Important: Copy the Value—not the Secret ID. The complete Value is only displayed when the secret is created. Once you leave the page, it cannot be retrieved from Entra. If you did not copy and save it, create another secret.

Uploaded image

6. Update the Connected Application

  1. Open the application’s configuration or authentication settings.
  2. Replace the existing client secret with the new Value saved in 1Password.
  3. Ensure no leading or trailing spaces were included.
  4. Save the change.

When renewing a secret under the same app registration, the Application ID and Tenant ID remain unchanged.

Reminder: The application requires the secret’s Value. The Secret ID cannot be used in its place.

Refer to Applying Secrets to Supported Apps – Specific Instructions below for the application’s exact settings and update procedure.

7. Apply Any Required Restart or Refresh

  • Follow the application-specific instructions to determine whether a restart, redeployment, or scheduled refresh is required.
  • Coordinate any required vendor assistance.
  • Perform verification after the application has reloaded the updated credentials.

8. Verify Authentication and Application Functions

  1. Test authentication using the application-specific instructions below.
  2. Review relevant logs for authentication failures.
  3. Perform a functional test, such as confirming that a calendar appointment synchronizes.
  4. Record the results in the renewal ticket.

A successful authentication confirms that the credentials were accepted. A functional test confirms that the integration works as expected.

9. Remove the Previous Secret

  1. After all applications or processes using the previous secret have been updated and verified, return to Certificates & secrets → Client secrets.
  2. Identify the previous secret by its description, expiry date, and Secret ID.
  3. Delete the previous secret, taking care to retain the new one.

10. Record the Renewal

  • Update the expiry information in 1Password and the applicable renewal tracking record.
  • Record the completion date, verification results, and any vendor ticket reference.
  • Arrange the next renewal before the new secret expires.
 
 

Applying/Modifying OAuth 2 Secrets to Supported Apps - Specific Instructions

Clockwork by TechnoPro

Vendor documentation - Hosted_Office365_Sync-OAuth2.pdf
Direct link to the Microsoft Entra app registration for ClockWork Calendar Sync

1. Contact the ITS Clockwork Administrator

  • Contact the ITS Clockwork Administrator, currently the Solutions Specialists, to update the client secret in Clockwork.
  • If the Solutions Specialists are unavailable and another authorized ITS staff member needs to complete the update, follow Clockwork Cloud – How to Install.
  • Complete the access and registration requirements described in that article. Administrative access is required to change the authentication settings.

2. Copy and Securely Save the New Secret Value

  1. In Microsoft Entra, go to App registrations → ClockWork Calendar Sync → Certificates & secrets → Client secrets.
  2. Create the new client secret using the renewal instructions earlier in this article.
  3. Immediately copy the complete entry from the Value column or receive a copy from the Infrastructure Team
  4. Save the Value and its expiry date in the appropriate 1Password entry before leaving the page.

Important: Copy the Value, not the Secret ID. The complete Value is only displayed when the secret is created. After you leave the page, it cannot be retrieved from Entra. If you did not copy and save it, create a new secret.

3. Access the Clockwork Admin Application

  1. Open Clockwork Admin.
  2. Sign in using:
  • Username: ADMIN
  • Password: Stored in 1Password vault that Solutions Specialists have access to.

Uploaded image

4. Locate the Client Secret Setting

Path: Clockwork Admin → Settings → Web module settings → ClockWork Appointment Sync → Office 365 Authentication Client Secret

  1. Select Settings in the left-hand Categories list.
  2. Click Web module settings.Uploaded image
  3. In the ClockWork Settings window, select ClockWork Appointment Sync from the left-hand list.
  4. Scroll down the settings pane to Office365 Authentication settings.
  5. Locate Office 365 Authentication Client Secret.

Uploaded image

5. Replace and Save the Client Secret

  1. Retrieve the new secret’s complete Value from 1Password or the member of the Infrastructure team to renew the secret.
  2. Open Office 365 Authentication Client Secret for editing.
  3. Replace the previous secret with the complete new Value
    • Ensure no leading or trailing spaces were included.
  4. Save the change.

Reminder: Enter the secret’s Value—not its Secret ID, Application ID, or Tenant ID. If the Value was not copied and saved when the secret was created, it cannot be recovered from Entra. Create a new secret and copy its Value instead.

When renewing a secret under the same app registration, leave the Application Id and Tenant Id unchanged. If verification is needed, compare them with Application (client) ID and Directory (tenant) ID on the Entra app registration’s Overview page.

Uploaded image

6. Allow Clockwork to Refresh or Request a Restart

Clockwork Support advises that the previous secret may remain cached until the application refreshes overnight.

  • If updating earlier in the day and synchronization needs to resume that day: Submit a ticket to Clockwork Support requesting an application restart. Ask Support to review the logs afterward, then complete the verification steps below.

  • If updating at the end of the day: Allow Clockwork to refresh overnight. Complete the authentication and calendar synchronization checks below on the next business day.

  • If either check fails after the overnight refresh: Submit a ticket to Clockwork Support, including the test time, error details, and relevant screenshots. Do not include the secret value.

Known behaviour: During the November 2026 renewal, authentication continued to fail after the new secret was entered. Clockwork Support advised that the previous secret was likely cached and would normally clear overnight. After Support restarted the application, they reported normal log activity, and subsequent Entra sign-ins succeeded.

7. Verify Authentication in Microsoft Entra

Microsoft Entra sign-in logs show whether Clockwork can authenticate to Microsoft 365 using the updated client secret. Check for a successful sign-in after the application restart or overnight refresh.

  1. Activate Cloud Application Administrator in PIM if required. Reports Reader also provides access to view sign-in logs.
  2. Go to Microsoft Entra ID → Monitoring & health → Sign-in logs.
  3. Select Service principal sign-ins.
  4. Select Add filter.
  5. Choose Application, enter ClockWork Calendar Sync, and click Apply.
  6. Select a date range covering the restart and click Refresh.
  7. Expand the grouped results using the arrow beside the row.
  8. Open an individual event after the restart and confirm its status is Success.

Uploaded image

If authentication fails:

  • Open the failed event and review the Sign-in error code and Failure reason.
  • Error 7000215 means Entra rejected the client secret submitted by Clockwork.
  • Confirm the correct secret Value was saved and that Clockwork reloaded its settings after the restart.
  • Provide the event time, error code, and failure reason to Clockwork Support. Do not include the secret value.

Uploaded image

8. Verify Calendar Synchronization

  1. Coordinate with a Clockwork user to create or update a test appointment that should synchronize.
  2. Allow the configured synchronization interval to pass.
  3. Verify that the appointment appears or updates correctly in the connected Microsoft 365 calendar.
  4. Record the authentication and appointment test results in the renewal ticket.
  5. If the appointment does not synchronize, contact Clockwork Support with the test details and time.

A successful Entra sign-in confirms authentication. The appointment test confirms calendar synchronization.

AppsAnywhere

  • Navigate to https://appsanywhere.saultcollege.ca
  • Login with an Admin account
  • Navigate to AdminUploaded Image (Thumbnail)
  • In the left navigation pane, click on Settings, Single Sign-OnUploaded Image (Thumbnail)
  • Open the OAuth 2.0 section
  • Paste the Secret you just created, into the Client Secret fieldUploaded Image (Thumbnail)
  • Click Save
Still have questions? Request more information.
Print Article

Related Articles (1)

For Outlook sync users calendars to be synced, ClockWork needs users email address and their ClockWork username to be mapped.