Connect Profiles

Overview

A connect profile is an object that contains the identification and authentication information needed to connect to external databases, FTP, SFTP/SSH servers. Connect profiles are used when running query commands that integrate with external systems or running loggers that directly access external servers to collect data.

Search connect profiles

You can view the list of connect profiles in Settings > Connect Profiles.

Connect profile list

  • Name: The name of the connect profile.
  • Identifier: The unique identifier used to reference the connect profile in loggers or query commands.
  • Type: The type of the connect profile.
  • Config: The list of configuration values for the connect profile.

To find a specific connect profile, use the search bar at the top left of the list. Items are returned if the entered keyword appears in Name, Identifier, or Config. The search is not case-sensitive.

Search results for connect profiles containing 'endpoint'

Add a connect profile

  1. In Settings > Connect Profiles, click the Add button at the top right of the list.

    Location of the Add button

  2. On the Add Connect Profile screen, enter the common settings and type-specific settings. Fields highlighted in light blue are required.

    Add Connect Profile screen

  3. After verifying the values, click the Confirm button at the top right of the screen to create the connect profile.

Common settings

Common settings include the attributes needed to identify and use the connect profile.

Common settings for a connect profile

  • Name: The name used to identify the connect profile. You can use letters, numbers, Korean characters, and special characters. The name must be unique among connect profiles.

  • Identifier: The unique identifier used to reference the connect profile in loggers or query commands. Only letters, numbers, and underscores (_) are allowed.

    Note
    When the type is Database, you cannot use `sonar` as the identifier.
  • Description: A description of the connect profile.

  • Type: The type of the connect profile. Connect profile types provided by apps are also listed here. The type-specific settings change depending on the selected type.

  • Account Sharing: Accounts that can use this connect profile. Click the gear icon to search for and select accounts to share with.

    Account sharing dialog

  • Group Sharing: Account groups that can use this connect profile. Click the gear icon to search for and select account groups to share with.

    Group sharing dialog

Type-specific settings

The type-specific settings change based on the Type selected in the common settings. In addition to the built-in types provided at installation, Logpresso Sonar may include additional types provided by apps.

This document covers only the built-in type settings. For connect profile types provided by apps, refer to the installation guide for the relevant app on the Logpresso Store.

FTP

The type-specific settings when the type is FTP are as follows.

Type-specific settings for FTP

  • Host: Enter the IP address or hostname of the FTP server to connect to.
  • Port: Enter the service port number of the FTP server (default: 21).
  • Account: Enter the login account ID for the FTP server. This can be omitted if the server supports anonymous login.
  • Password: Enter the password for the login account. This can be omitted if the server supports anonymous login.
  • Timeout: Enter the maximum time (in seconds) to wait when connecting (default: 30 seconds).
  • Active Mode: Check this if the FTP server uses active mode transfer (default: unchecked).
  • Extended Passive Mode: Check this if the FTP server uses IPv6 addresses (default: unchecked).
  • Entry Type: Select the operating system of the FTP server. Select Solaris Korean if the FTP server runs Solaris, or HP-UX Korean if it runs HP-UX (default: none selected).
Note
If both Active Mode and Extended Passive Mode are unchecked, the connection defaults to passive mode.
LDAP

The type-specific settings when the type is LDAP are as follows.

Type-specific settings for LDAP

  • Host: Enter the IP address or hostname of the LDAP server to connect to.
  • Port: Enter the service port number of the LDAP server (default: 389).
  • Bind DN: Enter the DN (Distinguished Name) to use for LDAP authentication.
  • Password: Enter the authentication password for the bind DN.
  • Search Base DN: Enter the top-level DN to use as the base for LDAP searches.
SSH

The type-specific settings when the type is SSH are as follows. SSH connect profiles are used for SFTP or SSH connections.

Type-specific settings for SSH

  • Host: Enter the IP address or hostname of the SSH server to connect to.

  • Port: Enter the service port number of the SSH server (default: 22).

  • Account: Enter the user account ID to log in to the SSH server.

  • Authentication Type: Select Authentication Key or Password (default: Authentication Key).

    • If you select Authentication Key, click How to configure the public key. In the How to configure the public key dialog, click Copy public key to clipboard to copy the SSH public key. Click Regenerate SSH Key to renew or replace the SSH key.

      How to configure the public key dialog

    • If you select Password, enter the password for the login account.

  • Timeout: Enter the maximum time (in seconds) to wait when establishing the SSH connection (default: 30 seconds).

  • Keep-alive Interval: Enter the interval (in seconds) for sending keep-alive packets (default: none). If set to 0 or left blank, no keep-alive packets are sent.

TAXII

The type-specific settings when the type is TAXII are as follows.

Type-specific settings for TAXII

  • Endpoint: Enter the URL of the TAXII server to connect to (e.g., https://otx.example.com).
  • Account: Enter the account ID to use for logging in to the TAXII service.
  • Password: Enter the password to use for authenticating with the TAXII service.
Database

The type-specific settings when the type is Database are as follows.

Type-specific settings for Database

  • Database Type: Select the type of database to connect to from the list (default: none). The default list includes Oracle DB, MariaDB, MySQL, and Custom. If a JDBC driver is installed via an app, that driver also appears in the list.
    • Select Custom to enter a JDBC connection string directly.
    • Select Custom to connect to SQLite as well.
  • Host: Enter the IP address or hostname of the database server.
  • Port: Enter the port number of the database server. A default value is automatically set when you select a database type, and you can modify it.
  • Database Name: Enter the name of the database to connect to. If left blank, it connects to all databases.
  • Connection String: If the Database Type is Custom, enter the JDBC connection string directly. Click JDBC String Template to see a list of example strings. Selecting one from the list automatically fills in the field, and you can modify it as needed.
  • Account: Enter the account ID to use for logging in to the database.
  • Password: Enter the account password.
  • Read-only: Check this to set the database connection to read-only mode (default: unchecked).
Tip
To use a JDBC driver provided by an app, set the Database Type to Custom and enter the appropriate Connection String for that database.
Logpresso CTI

The type-specific settings when the type is Logpresso CTI are as follows.

Type-specific settings for Logpresso CTI

  • API Key: The API key required to use Logpresso CTI.
  • HTTP Proxy: The IP address and port of the HTTP proxy server.
Logpresso AI Assistant

The type-specific settings when the type is Logpresso AI Assistant are as follows.

Type-specific settings for Logpresso AI Assistant

  • API Key: Enter the API key to use the Logpresso AI Assistant service.
  • HTTP Proxy: Enter the IP address and port number of the HTTP proxy server.

Edit a connect profile

  1. In the Connect Profiles list, click the Name of the connect profile you want to edit.

    Select connect profile

  2. On the Edit Connect Profile screen, update the fields you need, then click the Confirm button at the top right.
    The Identifier and Type fields cannot be edited. For descriptions of editable fields, refer to Add a connect profile.

    Edit connect profile

Delete connect profiles

  1. In the Connect Profiles list, select the connect profiles you want to delete.

  2. Click the Delete button at the top right of the list.

    Location of the Delete button

  3. In the Delete Connect Profile dialog, review the items to delete, then click the Delete button. Click the Cancel button to cancel the deletion.

    Delete connect profile dialog