13.2 Configuring Servers for Distributed Searching and Reporting

To configure a search initiator for distributed search, you must first enable distributed searching on the search initiator server.

After you enable distributed search, you need to add target servers to the search initiator server. If you know the administrator username and password for the target server, you can add the target server directly from the search initiator.

If you do not know the administrator username and password for a target server, you can set up the search initiator with an opt-in password that allows administrators of target servers to add their target servers to the search initiator. When you do this, administrators of target servers do not need to share their usernames and passwords with you. You must share the opt-in password with the target server administrator.

13.2.1 Enabling Distributed Search

  1. Log in to the Sentinel Web interface as a user in the administrator role.

  2. Click Search Setup in the toolbar, then click Search Targets.

  3. Select This local server and other search targets.

  4. Do one of the following to add target servers to your search initiator:

13.2.2 Using the Administrator Credentials to Add a Search Target Server

If you are the administrator of the search initiator and you know the administrator username and password on the target server, you can add the target server while you are logged in to your search initiator server.

IMPORTANT:You should ensure that the target server that you add is able to communicate with the search initiator. The target server should be able to communicate through TCP/IP. The IP address or host name of the target server must be accessible through firewalls, NATs, etc. You can use the ping command to ensure that there is communication from both ways. If there is a communication failure between the servers, an error is displayed in the extended status page. For more information, see Section 13.4, Managing the Distributed Search Results.

  1. If you are continuing from Section 13.2.1, Enabling Distributed Search, skip to Step 5; otherwise, continue to Step 2.

  2. Log in to the Sentinel Web interface as a user in the administrator role.

  3. Click Search Setup in the toolbar, then click Search Targets.

  4. Select This local server and other search targets.

  5. Click the Create Search Target link.

  6. Specify the following information:

    IP Address/DNS Name: IP address or the DNS name of the target server.

    Port: Port number of the target server. The default port number is 8443. The target server and search initiator do not need to be on the same port.

    User Name: User name to log in to the target server. This must be a user with administrator privileges.

    Password: Password associated with the user name.

  7. Click Login, then click Accept after verifying that the certificate information is correct.

  8. Use the following information to configure the target server:

    The Create Search Target page displays a lists of the various proxy roles on the target server.

    Name: Specify a descriptive name that you want to give to the search target.

    This helps you to easily identify the target server by a name instead of by its IP address or DNS name.

    Search Proxy Role: Select a search proxy role that you want to assign to the search initiator.

    When the search initiator makes search requests to the target server, the proxy role's security filter is used when performing the search. Only events that pass the proxy role's security filter are returned to the search initiator server.

    Only roles that have the Proxy for Authorized Search Initiators permission are listed. This permission is required for the target server to accept and process incoming search requests from the search initiator server.

  9. Click OK.

    The server information is listed in the Search Targets list.

You can now search events or view event reports from the target server. For more information, see Section 13.3, Searching for Events and Section 13.6, Running Reports.

13.2.3 Using the Opt-in Password to Add a Search Target Server

In organizations where administrative control of Sentinel servers is decentralized, it might violate the security policy to share administrator passwords. However, Sentinel allows you to share a limited-purpose opt-in password to add target servers, which is more secure than requiring full administrator credentials. If you are not the administrator of the target server, you can set an opt-in password in the search initiator server, then provide the opt-in password to the target server administrators to allow them to opt in to the search initiator server.

When a target server opts in to the search initiator, a message is sent to the search initiator server requesting that it be added to the list of target servers maintained by the search initiator server. The request authorizes the search initiator to access event data on the target server. The search initiator requires an opt-in password to verify that the opt-in request has originated from a valid target server. During the opt-in process, the search initiator and the target server exchange the appropriate password, which allows the target server to authenticate the search requests from the search initiator.

This procedure is similar to adding a target server, but it is done from the target server instead of the search initiator server.

Setting the Opt-In Password

  1. Log in to the search initiator server as a user in the administrator role.

  2. Click Search Setup in the toolbar.

    The Search configuration page that is displayed has two tabs: Search Targets and Authorized Search Initiators. Ensure that the Search Targets tab is selected.

  3. Select This local server and other search targets.

  4. Click Set Opt-in Password.

  5. Specify the opt-in password, then click Set Password.

  6. Continue with Authorizing a Search Initiator Server to add the target server to the search initiator.

Authorizing a Search Initiator Server

  1. Log in to the target server as a user in the administrator role.

  2. Click Search Setup in the toolbar.

    The Search configuration page that is displayed has two tabs: Search Targets and Authorized Search Initiators. The Search Targets tab is selected by default.

  3. Select the Authorized Searcher Initiators tab.

  4. Check the Allow these authorized search initiators to search this server as a search target box.

  5. Click the Create link.

    The Create Authorized Search Initiator page is displayed.

  6. Specify the following information:

    IP Address/DNS Name: The IP address or the DNS name of the search initiator.

    Port: Port number of the search initiator. This is the port number on which the search initiator listens for incoming opt-in requests. The default port number is 8443.

    Opt-in Password: The opt-in password that you configured on the search initiator. You must obtain this password from the administrator of the search initiator.

  7. Click OK.

    The Confirm Certificate page is displayed.

  8. Verify the certificate information, then click Accept.

    The Create Authorized Search Initiator page is displayed that lists the various proxy roles on the search target servers.

  9. In the Name field, specify a descriptive name that you want to give to the search initiator server.

    This helps you to easily identify the search initiator server by a name instead of by its IP address or DNS name.

  10. Select a proxy role that you want to assign to the search initiator.

    When the search initiator makes search requests to the target server, the proxy role's security filter is used when performing the search. Only events that pass the proxy role's security filter are returned to the search initiator.

    Only roles in the target server that have the Proxy for Authorized Search Initiators permission are listed. This permission is required for the target server to accept and process incoming search requests from the search initiator.

  11. Click OK.

    The search initiator is added to Authorized Search Initiators list and is enabled by default.

    The target server gets is also added under the Search Targets list in the search initiator server. Alternatively, you can click the Refresh link to see the target server in the Search Targets list.