Configuring HTTP destinations

Before your connections can successfully send data to a destination, your Tanium as a Service instance must be configured. Contact Tanium Support with the destination URL or IP and service port to submit a request.

For more information, see Tanium as a Service Deployment Guide: Proxy access.

You can send data from Connect to a REST API. You can choose to send all the data to the REST API in a single batch or in multiple segments. Form data is not supported.

Configure a receiver

You must have a script on your server that can receive the HTTP request from Tanium.

The following examples use a service that only accepts JSON format.

ClosedNode.js example

ClosedPython example

ClosedRuby example

Specify general connection information

  1. On the Connect Overview page, scroll to the Connections section and click Create Connection.
  2. Enter a name and description for the connection.
  3. (Optional) In the General Information section, expand Advanced to configure the following settings:

    Log Level

    By default, the logging is set to Information. Set the log level to Trace or Debug if you are debugging the connection. To reduce the amount of logging, you can set the log level to Warning, Error, or Fatal.

    By default, the logging is set to Information. To reduce the amount of logging, you can set the log level to Warning, Error, or Fatal.

    Minimum Pass Percentage

    Minimum percentage of the expected rows that must be processed for the connection to succeed.

    Memory Ceiling (GB)

    Maximum memory for the node process to run the connection.

Configure the connection source

The connection source determines what data you are sending to the destination. This data is usually information from Tanium, such as a saved question, question log, client status, or event. The settings vary depending on which source you choose.

Configure the HTTP destination

Specify the URL, method, and headers for the destination to which you want to send data.

  1. Select HTTP as the destination and then provide a name for the destination.
    • Specify a unique name to save the configuration information as a new destination. Select New, and then enter a Destination Name.

    • Select an existing destination. Select Existing, and then select a destination from the Destination Name drop-down list. If you edit the settings for an existing destination, all connections that use that destination are affected.

    • Copy an existing destination. Select New, and then click Copy Settings. Select a destination from the drop-down list, click Apply, and update the Destination Name.

  2. Specify a URL for the REST API to which you want to send the data and the HTTP method that you want to use for the request. If you specify https for the URL, Secure is automatically selected to validate the Transport Layer Security (TLS) certificate. You can select Trust on First Use to accept the certificate presented from the server and trust only that certificate for future connection runs.

    When you change certificates, you can edit the connection to remove the previous trusted certificate. This option is available after the connection runs and trusts the certificate.

  3. Add any required headers. To specify multiple headers, click + Add Header.
  4. Select an authentication method from Use Authentication. Configure one of the following:
    • None - Do not authenticate against the HTTP destination.
    • Basic Authentication - Authenticate against the HTTP destination with a User Name and Password.
    • IBM Cloud IAM - API Key - Authenticate against an IBM Cloud HTTP destination with an IAM token generated from the Secret API key you enter.

    Click Test Authentication for the IBM Cloud IAM - API Key authentication methods to confirm that you entered the proper authentication information.

  5. If you need to configure the batch size or the timeout, expand Advanced.

Configure filters

(Optional) In the Configure Output > Filters section, you can specify filters to modify the data that you are getting from your connection source before it is sent to the destination.

For more information about the types of filters you can configure, see Reference: Filtering options.

Format data for HTTP

You can choose to save your file in all of the available formats, as listed in Reference: Format types. The default format is JSON. Each format has slightly different configuration options, but all allow you to choose which column data to save.

In the Configure Output > Columns section, you can change the Destination Label of each column and Value Type to force the column to be a String, Numeric, or Date/Time value.

If you choose Numeric for the value, you can specify a default value that is used if the data cannot be coerced into a numeric value. You can specify any negative or positive number.

If you choose Date/Time for the value, specify the format that you want to use for the column. For more information about using a variable, see Time stamp variables.

For more information about column customizations, see Reference: Column customizations.

Schedule the connection

Connections can run at a highly configurable time interval, such as multiple times per hour, day, week, or month.

If you do not enable the schedule, the connection only runs when you manually run it.

Use the Schedule section to update the schedule:

  • Select Enable schedule.
  • In the Schedule Type, select Basic to build a schedule with the provided controls.
  • To view or edit the Cron expression directly, select Advanced - Define as a Cron Expression, and use the Advanced field to edit the Cron expression.

If a user that owns a scheduled connection is deleted, future scheduled instances of that connection do not run. For more information, see Problem: Scheduled connection owned by a deleted user no longer runs.

For more information about Cron syntax, see Reference: Cron syntax.

Save and verify connection

  1. After you enter the details for the connection, click Save.

    To save the connection and immediately run the connection, click Run and Save.

    If needed, resolve any errors or missing information. After the connection creates successfully, the connection details display.

  2. To view details when the connection runs, click the Logs tab.
  3. To view an individual run log, expand the row table.