Entering OAuth Provider in Maximo Real Estate and Facilities for Perceptive app
Register the OAuth provider (Microsoft Azure) in Maximo® Real Estate and Facilities by creating a Microsoft OAuth profile record for the Perceptive app. Configure OAuth settings including application key, secret, URLs, and delegated permissions.
About this task
After you register an OAuth application with Microsoft Azure, you must enter the OAuth provider (Microsoft) in Maximo Real Estate and Facilities. To enter the OAuth provider (and OAuth application), you must create a Microsoft OAuth profile record in Maximo Real Estate and Facilities.
Procedure
- Log in to the Maximo Real Estate and Facilities main portal.
- Navigate to Tools > System Setup > Integration > OAuth Settings.
- Select Add to add a new Microsoft OAuth profile record.
-
In the OAuth Setup section, specify the following OAuth settings:
Option Description Name This name may be displayed to end users, and used in API calls to identify the target record. OAuth Provider Name of the OAuth provider. For example, Microsoft for Microsoft Azure Active Directory. Access type Set the access type as Both or User Delegate (recommended for delegated permissions). Description Description that describes this profile, so an application may display it to end users. OAuth Application Key Enter the value of the Application (Client) ID field from the OAuth application registration in Microsoft Azure. This value is required by Reserve. OAuth Application Secret Enter the value of the client secret Value column from the OAuth application registration in Microsoft Azure. This value is required by Reserve. OAuth Authorize URL Enter the tenant-specific URL value of the OAuth 2.0 authorization endpoint (v2) field from the OAuth application registration in Microsoft Azure. This value is required by Reserve. For example: https://login.microsoftonline.com/<tenant Id>/oauth2/v2.0/authorize. Note: To obtain the URL value, click Overview on the Azure App registrations page, and then click the Endpoints tab. Copy the value of the OAuth 2.0 authorization endpoint (v2) field.OAuth Token URL Enter the tenant-specific URL value of the OAuth 2.0 token endpoint (v2) field from the OAuth application registration in Microsoft Azure. This value is required by Reserve. For example: https://login.microsoftonline.com/<tenant Id>/oauth2/v2.0/token OAuth Redirect URL Enter the value for: <base URL>/p/oauth/. This value is required by Reserve. For example: https://<mref_server>/<mref_context>/app/tririgaRoomReservation/oauth OAuth Scope API permissions that are granted to an OAuth application. For Microsoft Azure, enter: https://graph.microsoft.com/People.Read https://graph.microsoft.com/Calendars.ReadWrite https://graph.microsoft.com/User.ReadBasic.All https://graph.microsoft.com/Contacts.Read offline_access Note: Users might need to approve these permissions when they login.Login section This section is not used by Reserve. Domain Filter Specify the domain name for the OAuth profile. For example, <domain name>.onmicrosoft.com. Important: In multiple-tenant Exchange environments, a valid Domain Filter value must be defined for the OAuth profile so that Maximo Real Estate and Facilities searches for the correct OAuth profile for reserving a room in that particular tenant. However, even in the single-tenant Exchange environments, the Domain Filter value must be defined for the Exchange tenant that is being used.Use with Exchange Clear this checkbox. - Save your new Microsoft OAuth profile record.