Determine if you have System Administrator privilegesIn order to configure an Outlook Calendar, you must be a System Administrator. Access the Brikit Calendar Integrations Configuration Page in Confluence and you must have access to the Microsoft Azure environment for the user/organization account associated with the calendar. Create a new Enterprise Application using the Azure Active Directory PortalFollow Microsoft's documentation called Use the portal to create an Azure AD application and service principal that can access resources. For the name of your enterprise application, use "Brikit Calendar Integrations" with the homepage URL set to "https://www.brikit.com/calendar-integrations". When selecting the right Authentication method, choose Option 2, "Create a new Application Secret". Note the Application configuration dataTemporarily copy and save the following Azure application information: - User ID (aka "userPrincipalName")
- Application (client) ID
- Client Secret
- Tenant ID
Grant the application Microsoft Graph permissionsAdd the following permissions to your application: - Calendars.Read - read calendars in all mailboxes
- User.Read.All - read all users' full profiles
Be sure to "grant admin consent" for the organization. For more information about these permissions, please see Microsoft Graph Calendar Permissions. Navigate to the Brikit Calendar Integrations configuration page.In your Confluence environment, a A site administrator can configure the app by navigating as follows: - Clicking on the Confluence Administration cog/gear icon icon Image Added
- Selecting General Configuration
- In the sidebar menu, under the heading Brikit Calendar Configurations, click Outlook
Add a CredentialBefore you can add a specific Calendar, you must first connect to your Microsoft Outlook Exchange Server. This requires establishing and authenticating credentials.credential- Click the "
+Add Credential " button Enter the Exchange Server URL Enter your UserID and Password configuration data noted above (User ID, Application ID, Client Secret, and Tenant ID) Click Save
Test CredentialscredentialsYou should see a green check mark under the heading 'authentication status'. If not, double check to see that your credentials are correct (check URL, UserID, and password). If you are still receiving an error, check with your Exchange Server administrator. You may need to add your Confluence site as an allowed domainback on your Azure configuration to ensure all the steps were followed and permissions allowed. Add a CalendarcalendarOnce your credentials are authenticated, you may now add the Calendar or Calendars associated with this account. - Click the "
+Add Calendar " button. - Enter the name of the CalendarEnter a name for the Calendar ID (should look like an email address)(optional).
- Select the associated credential (it will default to the above credential if you have only included one)credential from the dropdown.
- Select a calendar from the dropdown or leave blank to select the default calendar.
- Type the name of Add a color to help associate and differentiate this calendar from any others you may add, for example
goldenrod . - Click Save
Navigate to a Page and Editpage and edit itYou are now ready to add a macro to a Confluence page and start displaying Calendar events. Add the Outlook Calendar Events Browser MacroAdd the macro by typing a left bracket "{" and then the name of the Macro. Hit enter to select. Click to the page, then click the macro and Edit it. In the first macro parameter, be sure to use the same Calendar ID you entered as displayed in the Add a Calendar step above. Select the view and configure configuration table from the step above, it should have the pattern "user ID" or "user ID:calendar name". Configure any other parameters as you see fit. Click save in the Macro window, then Save the edits to the page. The Outlook Calendar Events Browser Macro displays events as a scrollable list. If you'd like to see the events in a traditional monthly calendar view, add the Outlook Calendar Events Month View Macro. View the Calendar calendar on the PagepageYour connected Calendar should now be displaying events on the page as a list (or, if there are no events, then it should display the No Events Message). |