Question & Answer
Question
Is there any guidance on configuring the Microsoft EWS probe for OAuth2?
Cause
BasicAuth is depreciated in the Microsoft Exchange server.
Answer
There is a Support's guide to the Microsoft EWS probe.
The Microsoft EWS server needs to be configured with a shared secret to allow clients to connect.
The shared secret is provided by the Microsoft Exchange server or by the client, with a self-signed certificate.
Example Probe property settings
# Mail server login
ServiceURL : 'https://outlook.office365.com/EWS/Exchange.asmx'
Username : 'netcooluser@company.com'
Password : '<netcooluser-password>'
#
# Connect using OAuth2
#
AuthenticationType : 'OAuth2'
Authority : 'https://login.microsoftonline.com/########-####-####-####-############'
Scope : 'https://outlook.office.com/.default'
#
# Connect using the ClientId from the Azure Active Directory
#
ClientId : '########-####-####-####-############'
#
# Connect with client secret Method#1
# ClientSecret: 'xxxxx~xxxx-xxxxxxxxxxxxxxx~xxxxxxxxxxxxx'
#
# OR
#
# Connect with client certificate Method#2
# Using the shared self-signed certificate#
ClientCertificate : '$NCHOME/omnibus/probes/linux2x86/ewsprobe/ews_oauth2_keystore.p12'
ClientCertificatePassword : '<password>'
Useful commands for the client certificate method.
Display the store file details.
keytool -v -list -storetype PKCS12 -keystore $NCHOME/omnibus/probes/linux2x86/ewsprobe/ews_oauth2_keystore.p12 -storepass '<password>'
Create certificate file to upload to the Microsoft Exchange server.
openssl pkcs12 -in $NCHOME/omnibus/probes/linux2x86/ewsprobe/ews_oauth2_keystore.p12 -clcerts -nokeys -out $NCHOME/omnibus/probes/linux2x86/ews_oauth2_keystore.crt
Related Information
[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSSHTQ","label":"Tivoli Netcool\/OMNIbus"},"ARM Category":[{"code":"a8m0z0000000AtCAAU","label":"Probes-\u003E1 Individual Probes-\u003EMicrosoft EWS nco_p_ews"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]
Was this topic helpful?
Document Information
Modified date:
19 September 2023
UID
ibm16837179