Control forwarder access
If you have Splunk Enterprise, you can control how forwarders connect to receiving indexers with tokens. When you assign a token to a receiving indexer, any forwarders that connect to it must provide that token before they can forward data to it. Forwarder access control is different than a Secure Sockets Layer configuration and can be used in environments that do not have SSL enabled between Splunk instances.
Prerequisites to configuring forwarder access control
You must use the REST API to create, configure, and delete tokens. The commands in this topic use the
curl command-line tool.
While this tool is available on most *nix systems, you must download a separate executable on Windows systems as there is no native default. You can get it at the cURL website.
You must reference tokens with configuration files.
When you configure tokens on the universal forwarder and indexer, the following communication happens when a forwarder connects to send data:
- The forwarder connects to the indexer.
- The indexer requests authentication.
- The forwarder provides the token to the indexer.
- The indexer compares the token it received with the token it has.
- If the tokens match, the indexer accepts the connection and sets up the data stream.
- If the tokens do not match, the indexer rejects the connection and logs an entry in
Generate a token
Before you can configure token-based forwarding, you must generate at least one token to use.
1. From a command or shell prompt on the indexer where you want to generate the token, use the REST API to connect to a Splunk Enterprise indexer to create the token:
curl -v -k -u <user>:<password> https://<host>:<management_port>/services/data/inputs/tcp/splunktcptoken -d "name=<name>"
In this command:
passwordare the credentials you use to log into the Splunk Enterprise indexer.
hostis the host name or IP address of the indexer.
management_portis the TCP management port on the indexer.
nameis the friendly name that you want to assign the token.
For example, to create a token called
my_token on the
idx1.mycompany.com instance with the standard user and password for the
curl -v -k -u admin:changeme https://idx1.mycompany.com:8089/services/data/inputs/tcp/splunktcptoken -d "name=my_token"
The host responds with:
This is the Globally Unique Identifier (GUID).
Enable a token
1. From a command or shell prompt, run:
curl -v -k -X "POST" -u <user>:<password> https://idx1.mycompany.com:8089/services/data/inputs/tcp/splunktcptoken/tok1/enable
Disable a token
1. From command or shell prompt, run:
curl -v -k -X "POST" -u <username>:<password> https://idx1.mycompany.com/services/data/inputs/tcp/splunktcptoken/my_token/disable
Delete a token
To change a token, issue the following command:
curl -v -k -X "DELETE" -u <username>:<password> https://idx1.mycompany.com:8089/services/data/inputs/tcp/splunktcptoken/my_token
Configure the indexer with the token
Before you can control forwarders with tokens, set up the indexer with the token you generated. Edit inputs.conf on the forwarder to specify a special stanza along with the token that you generated.
1. Configure the indexer as a receiving indexer.
2. From a shell or command prompt on the indexer, edit
3. In this file, add the following stanza:
[splunktcptoken://my_token] disabled = 0 token = 808F7BD7-1444-4910-B8F5-87B83D694E18
inputs.conf and close it.
5. Restart the indexer.
Configure the forwarder with the token
Configure forwarders with the new token. You can specify tokens in
tcpout and load balancing groups. See Configure forwarding with outputs.conf.
1. From a shell or command prompt on the forwarder, edit
2. Add the following stanza:
[tcpout] server=idx1.mycompany.com:9997 token = 08F7BD7-1444-4910-B8F5-87B83D694E18 ...
3. Save the file and close it.
4. Restart the universal forwarder.
Confirm that the forwarder and indexer can communicate with the tokens
On the indexer, review
splunkd.log for information about forwarder attempts to communicate with an indexer that has tokens enabled.
A forwarder that does not have the correct token generates this output:
ERROR TcpInputProc - Exception: Token sent by forwarder does not match configured tokens src=127.0.0.1:58798! for data received from src=127.0.0.1:58798
A forwarder that does not submit a token to an indexer that has an enabled token generates this output:
ERROR TcpInputProc - Exception: Token not sent by forwarder src=127.0.0.1:58796! for data received from src=127.0.0.1:58796
In either case, the indexer terminates the connection to the forwarder.
A forwarder that does not submit the right token to an indexer that asks for one does not generate an error. It does not forward data to that indexer.
Configure forwarding to Splunk Enterprise indexer clusters
Protect against loss of in-flight data
This documentation applies to the following versions of Splunk® Universal Forwarder: 7.0.0, 7.0.1, 7.0.2, 7.0.3, 7.0.4, 7.0.5, 7.0.6, 7.0.7, 7.0.8, 7.0.9, 7.0.10, 7.0.11, 7.0.13, 7.1.0, 7.1.1, 7.1.2, 7.1.3, 7.1.4, 7.1.5, 7.1.6, 7.1.7, 7.1.8, 7.1.9, 7.1.10