The Ingest Processor solution allows you to send encrypted data through your pipelines, and decrypt it before it reaches its destination. That way, you do not have to decrypt your data before processing it in Ingest Processor pipelines. To decrypt your data, apply the decrypt command to your pipelines.

The decrypt command is an SPL2 command that requires a private key, which must be stored in a lookup table. The decrypt command has four required fields: the field to decrypt, the name of the lookup table that your private key is stored under, the specific lookup field name within your lookup table where your private key is stored, and the name of the field where the decrypted value will be outputted.

The Ingest Processor itself does not encrypt data, so your data must already be encrypted before it enters the pipeline.

Prerequisites

Use the decrypt command

To create a pipeline that decrypts your data, complete the following steps:

1. Navigate to the Pipelines page and then select New pipeline, then Ingest Processor pipeline.

2. On the Get started page, select Blank pipeline and then Next.

3. On the Define your pipeline's partition page, do the following:

   1. Select how you want to partition your incoming data that you want to send to your pipeline. you can partition by source type, source, and host.

   2. Enter the conditions for your partition, including the operator and the value. Your pipeline will receive and process teh incoming data that meets these conditions.

   3. Select Next to confirm the pipeline partition.

4. On the Add sample data page, do the following:

   1. Enter or upload sample data for generating previews that show how your pipeline processes data.

   2. Select Next to confirm the sample data that you want to use for your pipeline.

5. Select the name of the destination that you want to send data to.

6. (Optional) If you selected a Splunk platform S2S or Splunk platform HEC destination, you can configure index routing:
   1. Select one of the following options in the expanded destinations panel:

      Option	Description
      Default	The pipeline does not route events to a specific index. If the event metadata already specifies an index, then the event is sent to that index. Otherwise, the event is sent to the default index of the Splunk platform deployment.
      Specify index for events with no index	The pipeline only routes events to your specified index if the event metadata did not already specify an index.
      Specify index for all events	The pipeline routes all events to your specified index.

   2. If you selected Specify index for events with no index or Specify index for all events, then in the Index name field, select or enter the name of the index that you want to send your data to.
   Note: If you're sending data to a Splunk Cloud Platform deployment, be aware that the destination index is determined by a precedence order of configurations. See How does Ingest Processor know which index to send data to? for more information
7. Select Done to confirm the data destination.

8. In the SPL2 editor, Select the plus icon () in the Actions menu and select Decrypt field using lookup.

9. In the menu, provide the name of the lookup table that your private key is stored in, the name of the specific lookup match field, the Field to decrypt and the Decrypted output field where you will store your output.

10. Select Apply to add to your SPL2 pipeline statement.

11. To save your pipeline, do the following:

    1. Select Save pipeline.

    2. In the Name field, enter a name for your pipeline.

    3. (Optional) In the Description field, enter a description for your pipeline.

    4. Select Save.

       The pipeline is now listed on the Pipelines page, and you can apply it to Ingest Processor as needed.

12. To apply this pipeline to an Edge Processor, do the following:
    1. Navigate to the Pipelines page.
    2. In the row that lists your pipeline, select the Actions icon () and then select Apply.
    3. Select the pipeline that you want to apply, and then select Save.
    Note: You can only apply pipelines to Edge Processors that are in the Healthy status.

    It can take a few minutes for the Ingest Processor service to finish applying your pipeline. During this time, all applied pipelines enter the Pending status. Once the operation is complete, the Pending Apply status icon () stops displaying beside the pipeline. Refresh your browser to check if the icon no longer displays.

Your applied pipeline can now decrypt the data that it receives according to the private key in the lookup that you entered.

Example: Use the decrypt command to decrypt data