Updating the Graph secret involves two steps: 1) generating the new secret in the Entra Admin Center, and then 2) entering the secret in PoliteMail. To do the first, you will need to have Administrator rights for EntraID. To do the second, you will either need to be a SysAdmin in PoliteMail or you will need to send the new Graph secret to PoliteMail.
Creating a New Secret
To update the secret in Graph, you will need to go to the Microsoft Entra Admin Center. If logged into your network, you can access the Admin Center (if you have Admin rights) at https://entra.microsoft.com.
-
Browse to Identity > Applications > App Registrations on the left. A list of your App registrations will appear on the right.
-
Select the Graph App Registration for PoliteMail.
-
On the right side of the screen, go to Certificates & Secrets.
-
Navigate to the Client Secret tab and click on 'New client secret'. Follow the prompts.
-
We recommend an expiration of 365 days (12 months).
-
Once the certificate or secret is successfully added, copy the Secret Value. Please note that once you leave this page, you will not be able to view the secret value again.
Entering the Secret in PoliteMail
- Once the value is copied, it needs to be entered in PoliteMail.
System Administrators can update the Graph Secret in PoliteMail by going to Settings > Server > Authentication, and scrolling to the Graph section. There are several fields where you can update the Secret.
If you are not a System Administrator, send the Graph Secret to PoliteMail and we will apply the new secret and verify list expansion is functional.
Once the new secret is verified, navigate back to App registrations > Certificates and Secrets for the app and remove the old one.
