Splunk Cookie Policy

We use our own and third-party cookies to provide you with a great online experience. We also use these cookies to improve our products and services, support our marketing campaigns, and advertise to you on our website and other websites. Some cookies may continue to collect information after you have left our website. Learn more (including how to update your settings) here.
Accept Cookie Policy

Accept License Agreements

This app is provided by a third party and your right to use the app is in accordance with the license provided by that third-party licensor. Splunk is not responsible for any third-party apps and does not provide any warranty or support. If you have any questions, complaints or claims with respect to this app, please contact the licensor directly.

Thank You

Downloading Aplura Web Proxies App for Splunk
SHA256 checksum (aplura-web-proxies-app-for-splunk_128.tgz) 25f987be619a44fadde7aabdd9cb813206e93ffbd0266a84976ff1f55eb59159
To install your download
For instructions specific to your download, click the Details tab after closing this window.

Flag As Inappropriate

Aplura Web Proxies App for Splunk

Splunk AppInspect Passed
Overview
Details
App for exploring and reporting on Web Proxy events

Aplura Web Proxies App for Splunk Documentation

Overview

About Aplura Web Proxies App for Splunk

Author Aplura, LLC.
App Version 1.2.8
App Build 17
Creates an index false
Implements summarization Currently, the app does not generate summaries

About Aplura Web Proxies App for Splunk

App for exploring and reporting on Web Proxy events

Scripts and binaries

This App provides the following scripts:

Diag.py For use with the diag command.

Scripts

Release notes

Version 1.1.0

  • Initial Release

About this release

Version 1.2.8 of Aplura Web Proxies App for Splunk is compatible with:

Splunk Enterprise versions 7.0, 7.1
Platforms Splunk Enterprise

Compatability

Overview

In many organizations, web proxies separate users from the Web at large. User web activity can often be a good indicator of possible compromise, phishing attempts, abuse, and outdated software. This app provides Splunk dashboards, forms, and reports which can be used to explore your web proxy events, and make sense of what can often be a large volume of data.

To do this, the app relies on the Splunk Common Information Model (CIM) for Web events. This means that the app can report on any web proxy data, as long as it has been on-boarded properly, and is available through the Web data model.

A note on Splunk Data Model Acceleration and Disk Space

This app requires data model acceleration, which will use additional disk space. If you are using the Splunk App for Enterprise Security, this is already enabled, and should have been factored into your retention policies. If not, you should review the documentation on data model acceleration, how it uses disk space, and how to plan for it.

A note on the Splunk Common Information Model

As mentioned above, the app uses the CIM for proxy events. The CIM allows you to take events from a number of sources or products, and report on them in one cohesive manner, using a common set of names for fields and event types.

Available Dashboards

Overview

This dashboard serves as a jumping-off point for exploring your web proxy data. It includes panels for traffic over time, categories, top talkers, and users. Clicking on panels in this dashboard will drill down to the appropriate profile page for further exploration.

User Profile

This form provides panels based on a users activity, including source IP addresses, category history, and destinations. By focusing on a particular user, you can see browsing activity, generate a report for HR, or see where a user may have become infected.

Source Profile

This form provides panels based on source IP addresses, often the users computer or servers. This includes activity over time, categories, users, user agents, and destinations. Use this form when you need to see what sites a particular IP has been visiting, which is useful if you find an un-authenticated session which is attempting to visit different sites.

Category Profile

This form provides panels based on a category. This includes requests over time, destinations, users, and sources. If particular categories are of concern for your organization, you can use this form to find users or systems which have visited the category.

Destination Profile

This form provides panels based on destination, which may be a hostname or IP address. This includes URLs, categories, users, and sources. Using this form allows you to see what users visited a particular site, and which URLs are popular with your users. On sites which are categorized based on different URLs, you can see all of the categories for visits to the destination.If you know of a compromised site (such as a watering hole attack), you can use this form to quickly find users and systems which may have visited it.

Policy Exceptions

This dashboard shows users going to bad categories, showing the categories and user activity. Note that the selection of bad categories, which often changes from organization to organization, can be customized by following the steps in the section titled Customizing Categories for Policy Exceptions. Using this dashboard can highlight users which may be violating your organizations usage agreement or systems which may be compromised.

User Agents

This dashboard provides analysis of the user-agent strings present in the web proxy events. To do this, the dashboard searches use a lookup which parses the user-agent strings. There are other lookups which perform this function, but TA-user-agents is used by default. For information on customizing the lookup being used, see the section titled Customizing user-agent lookups. Using this dashboard will help you find outdated or unauthorized browsers/software in your environment. Additionally, because some malware either modifies user-agent strings, or have their own, you may find compromised systems on your network.

Proxy Event Search

This form provides an easy way to search proxy events for particular activity.If you already know what you are looking for, this form makes it easy to generate a search that return the events you need. Dont forget that you can use the search icon at the bottom of the events panel to open the search in the Splunk search interface.

About

A simple HTML version of this document.

Prerequisites

Splunk Versions

This app has been tested with Splunk versions 7.0 and 7.1. This app should be installed on the same search head on which the |data_model| data model has been accelerated.

Splunk Common Information Model Add-on

This app depends on data models included in the Splunk Common Information Model Add-on, specifically the |data_model| data model. Please review the information on installing and using the Splunk Common Information Model Add-on and information on configuring the acceleration on the data model.

The Splunk Common Information Model Add-on can be downloaded from Splunkbase.

This app has been tested with versions 4.9 of the CIM add-on.

Data model Acceleration on the Web data model

In order to make the app respond and load quickly, accelerated data models are used to provide summary data. For this data to be available, the |data_model| data model must be accelerated. Information on how to enable acceleration for the |data_model| data model can be found here. The data model must be accelerated for the length of time for which you would like to see reporting.

User-agents Add-on

User-agent strings are very difficult to parse efficiently using regular expressions. To make this easier and faster, an external lookup is used. Be default, the TA-user-agents is used, as it requires no additional data download or internet access. TA-user-agents can be downloaded from here: https://splunkbase.splunk.com/app/1843/

The user-agent lookup being used can be customized. See the section titled Customizing user-agent lookups for more information.

Installation

This app should be installed on a search head where the |data_model| data model has been accelerated. More information on installing or upgrading Splunk apps can be found here.

Simple Installation Process

  • Make sure the field extractions and tags on your proxy events are correct.
  • Install the Splunk Common Information Model Add-on (skip if you are installing on an ES search head).
  • Install the Aplura Web Proxies App for Splunk for Splunk.
  • Enable accelerations on the |data_model| data model (skip if you are installing on an ES search head).
  • Wait for the accelerations to start. After the acceleration searches have run, you should start seeing the dashboards populate.

Customizing Categories for Policy Exceptions

Not all organizations are the same, so there is a good chance that the default bad categories will need to be customized to meet the needs and policies of your organization. Additionally, customizations may be required based on the type of web proxy device generating the events.

Adjusting the lookup for the vendor and product

Different web proxy vendors is different category names, so one list wouldnt cover all vendors. To enable support for different vendors, a macro named wfa_lookup is used.

Currently this app comes pre-configured with lookups for 7 different products:

  • Barracuda: barracuda_wfa
  • Bluecoat (default): bluecoat_wfa
  • Cisco WSA: cisco_wsa_wfa
  • McAfee Web Gateway: mcafee_wg_wfa
  • Palo Alto Firewalls: palo_alto_wfa
  • URLBlacklist: urlblacklist_wfa
  • Websense: websense_wfa

These lookup files can be found in $SPLUNK_HOME/etc/apps/aplura_web_proxies_app/lookups.

To configure the app to use the correct lookup for your data, edit the wfa_lookup macro to match the vendor from the list above. More information on editing Splunk macros can be found in the Splunk documentation.

Note: While Splunk has configuration layering for configuration files, it does not have the same layering for lookup files. This means that if you customize one of these lookup files instead of creating your own, you need to make sure to back it up before upgrading this app, as it may be overwritten.

Creating your own lookup, or customizing an existing one

Because your organizations policies may differ from what is represented in the provided lookups, or you may be using a product which is not listed above, you may wish to use your own custom lookup for Policy Exceptions. A custom lookup for Policy Exceptions should have two columns, category and wfa. The category column should match the name of the category produced by your proxy device to which visits from clients are not allowed, or need to be reviewed. The second column, wfa, should always have a value of TRUE. You can always look at the existing lookups for an example.

Once you have created your lookup, edit the wfa_lookup macro with the name of the lookup you have created.

Using Wildcards in category lookups

The use of wildcards for the lookup file is not configured out of the box, however, it can by copying the transforms.conf file from the /default directory to the /local directory and adjusting the configuration of the web_proxies_wfa lookup.

Customizing user-agent lookups

By default, this app uses an external lookup to provide analytics on user-agent string. The default lookup used is the TA-user-agents lookup, however, this can be customized to use another lookup which may be more accurate or provide more fields for customizing the dashboard.

To customize the lookup, download and installed the other lookup. Copy the macros.conf file from the aplura_web_proxies_app/default directory of the app to a aplura_web_proxies_app/local directory (which you may need to create). Edit the macros.conf file, and edit the user_agent_lookup macro to be the name of the custom lookup, and then edit the ua_family_field to match the high-level product name (for example IE or Firefox). The use of the macros expect that the field being used for the lookup will be the CIM-compliant http_user_agent. If the lookup is expecting something else, then the dashboard will need to be customized to match.

References

Splunk Common Information Model

Downloads

Known Issues

Version 1.2.8 of Aplura Web Proxies App for Splunk has the following known issues:

  • None

Support and resources

Questions and answers

Access questions and answers specific to Aplura Web Proxies App for Splunk at https://answers.splunk.com . Be sure to tag your question with the App.

Support

  • Support Email: None
  • Support Offered: Splunk Answers

Installation and Configuration

Software requirements

Splunk Enterprise system requirements

Because this App runs on Splunk Enterprise, all of the Splunk Enterprise system requirements apply.

Download

Download Aplura Web Proxies App for Splunk at https://splunkbase.splunk.com.

Installation steps

Deploy to single server instance

Follow these steps to install the app in a single server instance of Splunk Enterprise:

  1. Deploy as you would any App, and restart Splunk.
  2. Configure.

Deploy to Splunk Cloud

  1. Have your Splunk Cloud Support handle this installation.

Deploy to a Distributed Environment

  1. For each Search Head in the environment, deploy a copy of the App.

User Guide

Configure Aplura Web Proxies App for Splunk

  • Install the App according to your environment (see steps above)

Lookups

Aplura Web Proxies App for Splunk contains the following lookup files.

  • apl_web_barracuda_wfa.csv
  • apl_web_bluecoat_wfa.csv
  • apl_web_checkpoint_wfa.csv
  • apl_web_cisco_wsa_wfa.csv
  • apl_web_mcafee_wg_wfa.csv
  • apl_web_palo_alto_wfa.csv
  • apl_web_urlblacklist_wfa.csv
  • apl_web_web_proxies_http_methods.csv
  • apl_web_websense_wfa.csv

Event Generator

Aplura Web Proxies App for Splunk does not include an event generator.

Acceleration

  1. Summary Indexing: No
  2. Data Model Acceleration: If Enabled
  3. Report Acceleration: No

Third Party Notices

Version 1.2.8 of Aplura Web Proxies App for Splunk incorporates the following Third-party software or third-party services.

  • None

Related Topics

2018, Aplura, LLC. | Powered by Sphinx 1.6.4 & Alabaster 0.7.10

Release Notes

Version 1.2.8
Sept. 30, 2018

Initial Release

19
Installs
61
Downloads
Share Subscribe LOGIN TO DOWNLOAD

Subscribe Share

AppInspect Tooling

Splunk AppInspect evaluates Splunk apps against a set of Splunk-defined criteria to assess the validity and security of an app package and components.

Are you a developer?

As a Splunkbase app developer, you will have access to all Splunk development resources and receive a 50GB license to build an app that will help solve use cases for customers all over the world. Splunkbase has 1000+ apps and add-ons from Splunk, our partners and our community. Find an app or add-on for most any data source and user need, or simply create your own with help from our developer portal.

Follow Us:
© 2005-2018 Splunk Inc. All rights reserved.
Splunk®, Splunk>®, Listen to Your Data®, The Engine for Machine Data®, Hunk®, Splunk Cloud™, Splunk Light™, SPL™ and Splunk MINT™ are trademarks and registered trademarks of Splunk Inc. in the United States and other countries. All other brand names, product names, or trademarks belong to their respective owners.