Request new tokens for Microsoft Bookings

Microsoft Bookings uses Access and Refresh Tokens to grant access to ASSURE users. The Refresh Token lasts for about 90 days and must be manually renewed from time to time.

Starting 30 days before the Refresh Token is due to expire, ASSURE gives system administrators a daily reminder with a pop-up notification similar to the following:

Renewing the Refresh Token

1. On the System Administration screen:

   • For ASSURE Public Protection, click Appointments Configuration in the General section.

   • For ASSURE Building Control, click Appointments Configuration for Building Control in the Building Control section.

2. Click Test Connection.

   • If the Refresh Token has already expired, or will expire within the next 10 days, you are forced to log in to MS Bookings where the tokens are automatically renewed.

     The correct URLs needed to log in to MS Bookings (TOKEN_URL) and return to ASSURE (SYSTEM_REDIRECT_URL) should already be defined by the AppointmentConfiguration parameter group in Configuration Settings. If these parameters are missing, ASSURE prompts you to provide them.

   • If the Refresh Token is due to expire within the next 30 days, but before the final 10 days, ASSURE gives you the option of renewing the tokens, but you can choose not to.

3. Click Save.

If the Refresh Token does expire, or if MS Bookings is not available for any other reason, authority users and public users are informed by a message that is displayed when they click the Book button on the Appointments tab. The content of this message is defined by the StatusMessage parameter in the Appointments parameter group in Configuration Settings.

Forcibly expiring the Refresh Token

If you need to suspend MS Bookings temporarily, you can click Clear Token to forcibly expire the Refresh Token. When you are ready to restart, click Test Connection to renew the tokens.