Microsoft Exchange policy

A Microsoft Exchange policy contains the connection details that are used by a Microsoft Exchange Input or Microsoft Exchange Request node when connecting to a Microsoft Exchange account.

You can use a Microsoft Exchange Request node in a message flow to connect IBM® App Connect Enterprise to Microsoft Exchange and issue requests perform actions on objects such as attachments, calendars, contacts, conversations, emails, groups, mail folders, organizations, and users. You can use a Microsoft Exchange Input node to monitor and accept input from Microsoft Exchange. The Microsoft Exchange policy controls, at run time, access to the Microsoft Exchange account.

The Microsoft Exchange policy is created when you configure a connection between a Microsoft Exchange Input or Microsoft Exchange Request node and Microsoft Exchange by using the Connector Discovery wizard. During the process of discovery, account credentials are stored in the vault and connection details are stored in the Microsoft Exchange policy. The policy is created with a type of Microsoft Exchange, and the name of the policy is returned to the node and specified in the Connection tab, in the format {policyProjectName}:policyName.

You can also create, update, or delete a Microsoft Exchange policy by using the Manage Discovery Connector Policies and Credentials wizard, which you can access by right-clicking the policy project in the IBM App Connect Enterprise Toolkit and then clicking New > Discovery Connector policies and credentials.

You must deploy this policy before message flows that use the policy are started. If you redeploy a Microsoft Exchange policy, all message flows that are using the policy are stopped and restarted.

For more information about using Microsoft Exchange policies, see Using Microsoft Exchange with IBM App Connect Enterprise.

Table 1. Properties of the Microsoft Exchange policy
Property Property name in .policyxml file Description of properties
Microsoft Exchange Application Type applicationType This property is reserved for future use and must be set to the value online.
Microsoft Exchange Application Version applicationVersion This property is reserved for future use and must be set to the value v1.
Microsoft Exchange Authentication method authenticationMethod This property specifies the type of authentication that is used for the connection between IBM App Connect Enterprise and Microsoft Exchange. This value is reserved for future use and must be set to BASIC_OAUTH.
Credential Name credentialName This property specifies the name of the credential that is used for the connection to Microsoft Exchange.

The specified credential can be defined during connector discovery and stored in the vault. Alternatively, you can specify an existing credential that was configured by using the mqsicredentials command or the server.conf.yaml file, or loaded through an external credential provider.

Proxy name proxyId This property specifies the name of the HTTP Proxy policy that contains details of the HTTP Proxy server URL and the HTTPProxy credential used to make the connection.