Skip to main content

Creating a Managed File Transfer Connection

Creating a Managed File Transfer Connection

A managed file transfer (MFT) connection is a configuration item that the production can use to connect securely to an MFT service. If you have multiple productions running on a single InterSystems IRIS server, create a separate MFT connection for each production. In each case, the MFT connection must contain the OAuth 2.0 information you received from the MFT service.

To create an MFT connection:

  1. From the Management Portal, go to the Managed File Transfer Connections page (System Administration > Security > Managed File Transfer Connections).

  2. Click Create Connection to bring up the configuration page.

  3. Specify values for the fields as follows, and then click Save:

    • Connection Name — Name for this connection for use within the production.

    • File management service — MFT service used for this connection.

    • SSL/TLS configuration — Name of the TLS configuration to use for this connection.

    • Email address — Email address of the administrator of the MFT account.

    • Base URL — Root URL meant for use in transferring files (specific to your account).

    • OAuth 2.0 application name — Name of the custom application created within the MFT service.

    • OAuth 2.0 client ID — The application identifier as provided by the MFT service. Each MFT service uses a different name for this item:

      • Box: Client ID

      • Dropbox: App key

      • kiteworks: Client Application ID

    • OAuth 2.0 client secret — The password that the MFT service provided. Each MFT service uses a different name for this item:

      • Box: Client Secret

      • Dropbox: App secret

      • kiteworks: Client Secret Key

    • OAuth 2.0 redirect URL — URL used by the MFT service to connect to InterSystems IRIS. Enter the following values to automatically generate this URL:

      • Use TLS/SSL — Whether to use TLS to connect to the MFT service. In general, you should select this option.

      • Host name — The fully qualified domain name (FQDN) or IP address of the InterSystems IRIS server. See <baseURL>.

      • Port — The web server port specified in the Web Gateway configuration, if any.

      • Prefix — Typically blank. Specify this if needed to accommodate any changes in the Web Gateway configuration.

  4. Verify that the generated redirect URL has the following form:

    https://hostname:port/prefix/csp/sys/oauth2/OAuth2.Response.cls
    

    Or (less common):

    https://hostname/prefix/csp/sys/oauth2/OAuth2.Response.cls
    

    If you omit Prefix, there is only one slash before csp.

    This URL must match the one you supplied to the MFT service when creating the custom application for the production.

  5. If the generated URL does not match what you had provided to the MFT service, then log in to the MFT service and edit the app definition to use the generated URL.

FeedbackOpens in a new tab