How to Renew a Client Secret

When you generate a client secret as a part of an app registration for Office 365 or Microsoft Entra ID, at some point that secret will expire and need to be renewed.

Generating a New Client Secret

1. Navigate to portal.azure.com.
2. In the search bar, type "app registrations".
3. Click on "App Registrations".
4. Change view to "All applications".
5. Find the app registration for your Issuetrak site. (You or another administrator would have set this name during the initial app registration.)
6. On the left menu, click on Manage to see more options, then choose "Certificates & Secrets".
7. Click New Client Secret.
8. A lightbox will appear and ask you to set a description. We recommend that you use your Issuetrak site's name, or the name of the mailbox it uses, or something else that will make you think of the site this is for.
9. Set the expiration date for the new client secret. You can set the app registration for as long as 2 years.
10. Click Add.
11. Take note of the client secret value, as this is the only time you'll be able to see it. You're going to need it for the steps further below. If you close out of this screen and then lose the secret, you'll have to go through these steps again to generate a new one.

Updating the Office 365 Client Secret in Issuetrak

1. Log into your Issuetrak site.
2. Click the gear icon in the top right > choose Office 365 Applications beneath Integrations.
3. Click Edit next to the application that you need to update with the new client secret.
4. Enter the new client secret.
5. Click Update.
6. Confirm that your Issuetrak site continues to successfully communicate with O365.

Updating the Entra ID Client Secret in Issuetrak

1. Log into your Issuetrak site.
2. Click the gear icon in the top right > choose Microsoft Entra ID under Identity Management.
3. Edit the provider that needs the updated client secret.
4. Paste the new client secret into the Client Secret field.
5. Click Save.
6. Click Test Connection.