To add a custom connection, import your Postman collection. The requests in the Postman JSON file are the actions. After you import the collection, the actions become available to use in automation workflows.

Access Custom Connectors for general information.

Prerequisites

  • Create a collection using the process outlined in Use Postman for Custom Connectors.
  • The service you intend to connect must support REST API and JSON content types.
  • Workspace ONE Intelligence needs access to API endpoints. If services are behind a firewall, use the Unified Access Gateway as reverse proxy.
  • If you use OAuth2 for authentication, have the authorization details so Workspace ONE Intelligence can retrieve, refresh, and access tokens for the service.
    • OAuth2 Token URL
    • Client Secret
    • Client ID
    • Grant Type (Client Credentials or Password)

Procedure

  1. In Workspace ONE Intelligence, go to Settings > Integrations > Automation Connections and select Add Custom Connection.
  2. Configure the custom connection.
    Settings Descriptions
    Connection Name Enter an identifiable name for the connection.
    Base URL Enter the URL for the service so Workspace ONE Intelligence can authenticate.

    The URL for the service and the URL for the custom connection must match.

    Auth Type Select the authentication type to use to access the service.

    Workspace ONE Intelligence overrides Postman authentication headers in collections with this setting.

    If your service uses a unique, header-based authentication type, add the header to all your requests in the Postman collection and configure the BaseURL. In this scenario, Workspace ONE Intelligence uses the headers configured in the Postman collection. Examples of header-based authentication types are using an API key or a token.

    • Basic Authentication
      • User Name
      • Password

      To allow Workspace ONE Intelligence access, enter the credentials.

    • OAuth2 Authentication
      • OAuth2 Token URL
      • Client Secret
      • Client ID
      • Grant Type (Client Credentials or Password)

      Enter details so Workspace ONE Intelligence can retrieve, refresh, and access tokens for the service.

    • No Authentication

      If you do not want Workspace ONE Intelligence to override authentication headers, select this menu item.

  3. To import your Postman JSON file, use the select from your computer link in the middle of the UI.
    The UI displays the collection with its requests. These Postman requests are now available as actions for automations.
  4. From the list of imported actions you can test, edit, and delete the action.
    Settings Descriptions
    Delete
    • If an action you want to delete is used in other automations, the system disables those automations and removes the action. You must edit and reenable those automations to allow them to continue to function.
    • Deletion is not reversible.
    Edit
    • You can edit the action names and descriptions.
    • The system gathers names and descriptions from the imported Postman JSON.
    • To edit the action request details, edit the Postman collection and then reimport it into your custom connection.
    Test

    Use the Test menu item to ensure the connection works. The system tests the request configured in the Postman collection.

What to do next

Add the action to a workflow using the category Workspace ONE UEM > Devices. For details, see Configure Workflows.