Getting Data In

SSL/TLS Configuration on Splunk Forwarder (Windows)

BRFZ
Communicator

Hello,

I’ve been reviewing the documentation for configuring SSL/TLS on a Splunk forwarder, but I couldn’t find the specific steps for setting it up on a Windows machine. Would anyone be able to provide the procedure or a link to the relevant documentation?

Best regards,

Labels (4)
0 Karma

PickleRick
SplunkTrust
SplunkTrust

The documentation is about the same regardless of wheteher it's windows or linux. (the only minute difference is CA trust store definition if you use the OS store).

The question is what do you need.

There are two layers here.

1. Configuration of connection encryption (which should be enabled by default) and server's identity verification.

2. Configuration of forwarder authentication to your receiver with TLS.

You should first make sure that the first point is properly configured. Then you can go to configuring the second one. People often try to do both things at the same time and get confused with different settings and different results.

kiran_panchavat
Champion

@BRFZ 

  • A client certificate (e.g., client.pem) for the forwarder, including the private key.
  • The Certificate Authority (CA) certificate (e.g., cacert.pem) that signed the indexer’s server certificate.
  • Place these files in a secure directory on the Windows machine, such as C:\Program Files\SplunkUniversalForwarder\etc\auth\mycerts\. Create the mycerts folder if it doesn’t exist.
  • Open or create the outputs.conf file in C:\Program Files\SplunkUniversalForwarder\etc\system\local\. If it doesn’t exist, create it.
    Add the following configuration to specify the indexer(s) and enable TLS:
[tcpout]
defaultGroup = my_indexers

[tcpout:my_indexers]
server = <indexer_hostname>:9997
clientCert = C:\Program Files\SplunkUniversalForwarder\etc\auth\mycerts\client.pem
sslPassword = <password_for_client_certificate>
sslRootCAPath = C:\Program Files\SplunkUniversalForwarder\etc\auth\mycerts\cacert.pem
sslVerifyServerCert = true
sslCommonNameToCheck = <indexer_common_name>
useClientSSLCompression = true
  • Open or create the server.conf file in C:\Program Files\SplunkUniversalForwarder\etc\system\local\.
  • Add the following to specify the CA certificate for verifying the indexer:
[sslConfig]
sslRootCAPath = C:\Program Files\SplunkUniversalForwarder\etc\auth\mycerts\cacert.pem
  • This ensures the forwarder trusts the CA that signed the indexer’s certificate.
  • Restart the Splunk Forwarder:
  • cd C:\Program Files\SplunkUniversalForwarder\bin and splunk restart

  • Check the forwarder’s logs for errors in C:\Program Files\SplunkUniversalForwarder\var\log\splunk\splunkd.log. Look for messages related to TcpOutputProc or SSL/TLS issues (e.g., X509Verify or SSLCommon errors).

https://community.splunk.com/t5/Getting-Data-In/Why-is-my-Windows-Forwarder-SSL-Configuration-not-fo... 

Your forwarder would need SSL certs and configurations as well to enable SSL communication with your SSL enabled indexer. This documentation will give you all the

https://docs.splunk.com/Documentation/Splunk/9.4.1/Security/ConfigureSplunkforwardingtousesignedcert... 

 

Did this help? If yes, please consider giving kudos, marking it as the solution, or commenting for clarification — your feedback keeps the community going!

BRFZ
Communicator

@kiran_panchavat,

Thank you for your response. I reviewed the documentation, and I found the following phrase for configuring SSL on both indexers and forwarders (non-Windows):

"On forwarders that do not run on Windows, open the server.conf configuration file for editing.
Add the following stanza and settings to the file:
[sslConfig]
sslRootCAPath = <absolute path to the certificate authority certificate>"

Based on this, it seems that the CA configuration is required only on non-Windows systems (Linux). Could you please confirm if this configuration is needed for Windows forwarders as well?

Thank you for your help!

0 Karma

kiran_panchavat
Champion

@BRFZ 

Check this community link 

https://www.reddit.com/r/Splunk/comments/sgeuhl/whats_the_deal_with_uf_hf_ssl_certs/ 

https://community.splunk.com/t5/Getting-Data-In/Why-is-my-Windows-Forwarder-SSL-Configuration-not-fo... 

Did this help? If yes, please consider giving kudos, marking it as the solution, or commenting for clarification — your feedback keeps the community going!

kiran_panchavat
Champion

@BRFZ 

Yes, It's correct. 

 

kiran_panchavat_1-1742820785245.png

 

Did this help? If yes, please consider giving kudos, marking it as the solution, or commenting for clarification — your feedback keeps the community going!

BRFZ
Communicator

Hello,

@kiran_panchavat, @PickleRick , @livehybrid 

Thank you for your responses; they were very helpful for me. However, I would like to know if you happen to know why I am getting ack set to false?

0 Karma

livehybrid
SplunkTrust
SplunkTrust

Hi @BRFZ 

useAck=false is the default value in outputs.conf for whether or not to use indexer acknowledgment.

Essentially, with this set to true it means that the forwarder saves the event until the indexer has acknowledged that it has fully processed the event (typically that it is written to disk).

For more info check out https://docs.splunk.com/Documentation/Splunk/9.4.1/Admin/Outputsconf#:~:text=Distributed%20Deploymen...

Please let me know how you get on and consider adding karma to this or any other answer if it has helped.
Regards

Will 

0 Karma

kiran_panchavat
Champion

@BRFZ 

Your forwarder would need SSL certs and configurations as well to enable SSL communication with your SSL enabled indexer. This documentation will give you all the

https://docs.splunk.com/Documentation/Splunk/9.4.1/Security/ConfigureSplunkforwardingtousesignedcert... 

Did this help? If yes, please consider giving kudos, marking it as the solution, or commenting for clarification — your feedback keeps the community going!

livehybrid
SplunkTrust
SplunkTrust

Hi @BRFZ 

I think the best place to start for setting up SSL/TLS is at https://docs.splunk.com/Documentation/Splunk/9.4.1/Security/ConfigureSplunkforwardingtousesignedcert...

Please let me know how you get on and consider adding karma to this or any other answer if it has helped.
Regards

Will

Get Updates on the Splunk Community!

.conf25 Community Recap

Hello Splunkers, And just like that, .conf25 is in the books! What an incredible few days — full of learning, ...

Splunk App Developers | .conf25 Recap & What’s Next

If you stopped by the Builder Bar at .conf25 this year, thank you! The retro tech beer garden vibes were ...

Congratulations to the 2025-2026 SplunkTrust!

Hello, Splunk Community! We are beyond thrilled to announce our newest group of SplunkTrust members!  The ...