Skip to content

OAuth - Outlook Integration in LibCal and LibStaffer#

ITS created an Azure app in 2023 to allow us to connect Outlook calendars with LibApps appointments and schedules.

Creating the Azure App (Do One Time)#

For historical purposes, ITS originally created an Azure app, following these instructions from Springshare:

  • Register a new Azure App:
  • Go to https://nashvillepl.libcal.com/admin/oauth/azure/callback.
  • Or you can also log here (and search for App Registraions): https://portal.azure.com.
  • Locate and select your client ID. It's the one ending in 13d6.
  • Select the Certificates and Secrets option from the panel menu on the left.
  • Delete your existing client secret by selecting the trash can icon on the far right.
  • Select New Client Secret >> Add a description >> Set the expiration date (there are a few default options there but you can use the Custom option if you want to set it far into the future) >> Add.
  • Save Settings and you're done.

Update the Azure App Client Secret (Do Every 24 Months)#

The Client Secret Value”** expires after 24 months. When it expires, LibCal and LibStaffer syncing will break.

  • Email ITS and tell them we have an Azure App that lets Outlook sync with 2 library products: LibCal and LibStaffer. Tell them the old “Client Secret Value” is expired and ask them to generate a new value for each service. We have to have a new one for LibCal AND a new one for LibStaffer -- they’re two separate secrets.
  • In 2023 and 2025, Phillip Walling was the person at ITS who helped with this.

Add New Client Secret to LibCal / LibStaffer (Do Every 24 Months)#

After ITS creates the Azure app (or updates it, when it expires), they send us two client secrets (a string of letters and numbers). NPL LibApps admin need to do the following to update LibCal and LibStaffer:

  1. Update the Azure app secret in LibCal.
  2. Log in to LibCal.
  3. Go to Admin > Integrations.
  4. Click the edit button next to the “Client Secret: Value” field.
  5. Update with the new secret sent from ITS.
  6. Save Settings.

  7. Verify that it is working by going to your own LibCal account and authorizing Microsoft to sync.
    Log in to LibCal.

    1. Click on Appointments in the main menu.
    2. Click the "Integrations" tab.
    3. Under "Outlook/Exchange Settings" click the blue "Authorize with Microsoft Account" button.
    4. Select which of your Outlook calendars to sync with. Make other selections.
    5. Save.

  8. Update the Azure app secret in LibStaffer.

  9. Log in to LibStaffer.
  10. Go to Admin > Integrations.
  11. Click the edit button next to the “Client Secret: Value” field.
  12. Update with the new secret sent from ITS.
  13. Save Settings.
  14. Verify that it is working by going to your own LibCal account and authorizing Microsoft to sync.
    1. Log in to LibStaffer.
    2. Click on your email address in the upper right hand of the screen.
    3. Click the "Calendar Sync" tab.
    4. Scroll to "OAuth2 Authorization" and set up your calendars. Make selections and save. If you see a blue "Authorize with Microsoft Account" button, click that first.