Creating a Connection

The first step in creating an integration is to create the connections to the applications with which you want to share data.

  1. In the Integration Cloud Service toolbar, click Designer.
    Description of GUID-7557A237-0437-4506-B9B6-62B88DC0C8D7-default.png follows
    Description of the illustration GUID-7557A237-0437-4506-B9B6-62B88DC0C8D7-default.png

  2. On the Designer Portal, click Connections.
    Description of GUID-DE718BE5-071A-4E11-AD6E-AA6F48EA01AC-default.png follows
    Description of the illustration GUID-DE718BE5-071A-4E11-AD6E-AA6F48EA01AC-default.png

  3. Click Create New Connection.
    Description of GUID-8CBFC9BE-8EE5-44B3-8EDC-DB4B6FB5698C-default.png follows
    Description of the illustration GUID-8CBFC9BE-8EE5-44B3-8EDC-DB4B6FB5698C-default.png
    The Create Connection — Select Adapter dialog is displayed.
  4. Select an adapter from the dialog. You can also search for the type of adapter to use by entering a partial or full name in the Search field, and clicking Search.
    The New Connection — Information dialog is displayed.
  5. Enter the information to describe the connection. Use a meaningful name to help others find your connection when they begin to create their own integrations.
    Description of GUID-E8AD2A83-4A18-45A6-B178-505A5DA95E0E-default.png follows
    Description of the illustration GUID-E8AD2A83-4A18-45A6-B178-505A5DA95E0E-default.png

  6. Click Create.
    Your connection is created and you are now ready to configure connection details, such as email contact, connection properties, security policies, and connection login credentials.

Adding a Contact Email

From the Connection Administrator section of the connection, you can add a contact email address for notifications.

  1. In the Email Address field, enter an email address to receive email notifications when problems occur.
  2. In the upper right corner, click Save.

Configuring Connection Security

Enter connection information so your application can process requests.

  1. Click Configure Credentials.
    The Credentials dialog is displayed.
  2. In the Security Policy field, note that Microsoft Mail Authorization Code Credentials is displayed by default and cannot be deselected. This security policy supports OAuth 2.0 authorization code flow credentials.
  3. Enter the client ID (Microsoft application ID) and client secret (Microsoft private key) values you recorded when you added your application to your Microsoft Email account.
  4. Enter the scope URLs in the Scope field.
    A scope is a list of authorization permissions for the target application.
  5. Click Provide Consent.
  6. Click OK.

Testing the Connection

Test your connection to ensure that it is successfully configured.

  1. In the upper right corner of the page, click Test.
    If successful, the following message is displayed and the progress indicator shows 100%.

    The connection test was successful!

  2. If your connection was unsuccessful, an error message is displayed with details. Verify that the configuration details you entered are correct.
  3. When complete, click Save.