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.
-
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.
-
Make note of your Client Secret value.
-
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.