Adding a new Modern Authentication Application certificate when the existing one is due to expire

Adding a new Modern Authentication Application certificate when the existing one is due to expire

During the configuration of Modern Authentication, a required step is to create an Application Certificate within the credential manager in MailStore, and upload it to the Azure Portal. This certificate typically only lasts for 15 Months and therefore before it expires you will need to create a new one and replace it.

If you see errors warning that 'The certificate with identifier used to sign the client assertion is expired:' in a error response this is a clear indication that this certificate has expired and a new one needs to be created.

The following guide will take you through these steps.

Creating a new Certificate within MailStore Server

  1. Log on to MailStore Client as a MailStore Server administrator.
  2. Click on Administrative Tools > Users and Archives > Directory Services.
  3. In the Connection section, click on the button (…) next to the Credentials drop-down list.
  4. In the Credential Manager that appears, select the current  credentials configured ( most likely called ‘MailStore Server’ and click on edit
  5. In the Microsoft Entra ID App Credentials dialog, click on the small down arrow on the Certificate line and choose ‘Create certificate

  6. Once created again click on the same down arrow and select Download Certificate. Save the certificate on your hard drive.
  7. Confirm your entries by clicking OK.

Publishing Credentials in Microsoft Entra ID

  1. Sign in to the Microsoft Entra ID Portal as a Global Administrator for your Microsoft 365 tenant.
  2. In the navigation menu (☰), select the option  Microsoft Entra ID
  3. On the next page, select App registrations in the Manage section of the left navigation menu.
  4. Select All Applications. And select the ‘MailStore’ Application you previously configured.
  5. Select Certificates & secrets in the Manage section of the left navigation menu.
  6. You should see your previous expired certificate here. which you can delete once you have uploaded the new certificate.
  7. Click on Upload certificate in the Certificates section. Select the certificate file that you have saved previously and upload it to Microsoft Entra ID by clicking Add.
  8. If uploading has been successful, the certificate's thumbprint as well as its start and expiry dates appear in the certificates list. You can compare the thumbprint and expiry date with those listed in the MailStore Credential Manager to check that you've uploaded the correct certificate.