Renewing a Client Secret

Microsoft provides documentation for replacing an expiring or expired client secret in a SharePoint Add-ins, and it should always be the primary source of instructions for updating a client secret. This help page will serve as a guide to updating the client secret which is a Microsoft process.

See the following sections to renew the client secret for on-premises and Gimmal Cloud versions of the SharePoint Online Connector (SPOC).

On-Premises

To renew a client secret for SharePoint Online Connector on-premises, you must execute the following PowerShell Command on the SharePoint Online Connector Server, as shown below:

Note: Use your own Client ID to replace the tokens for {Your Client ID} in the script sample below.

$secret = New-SPOClientSecret
Set-ServicePrincipalClientSecret –ClientId {Your Client Id} –ClientSecret $secret
Set-SPOConnectorService –ClientId {Your Client Id} –ClientSecret $secret
Set-SPOConnectorWeb -SiteName “SPOnline Connector Web” –ClientId {Your Client Id} –ClientSecret $secret

Gimmal Cloud

To renew a client secret for SharePoint Online Connector in the Gimmal Cloud, there are some steps you must perform in addition to the steps listed in Microsoft's documentation.

1. Perform the steps in Microsoft's client secret documentation to renew the client secret. Note the important sections on how to find out a client secret's expiration date, and how to create a client secret that is valid for three years.

2. Make note of your Client Secret value.

3. Gimmal must perform additional steps to complete the renewal of your client secret in the Cloud. Submit a Gimmal Support ticket, providing the Client Secret value that you generated in step 1.