Splunk® Supported Add-ons

Splunk Add-on for Box

Download manual as PDF

Download topic as PDF

Configure credentials on Box for the Splunk Add-on for Box

Box uses OAuth 2.0 for authentication and authorization. For the Splunk Add-on for Box to collect data from the Box APIs, you must obtain an OAuth 2.0 client ID and client secret from Box. Before you attempt to set up the Splunk Add-on for Box, use the following steps to configure a Box client app and obtain these credentials.

Refer to Box documentation for more details and additional reference information.

  1. Log in to Box using an existing Box account. The role of the Box account that you use for this configuration step affects the scope of the data you can gather with the add-on:
    • If you use a Box account with the admin role, the add-on has permissions to gather all metadata of all files and folders and all enterprise events for your entire organization through the Box APIs.
    • If you use a Box account with a co-admin role, you need to enable the permission to "Run new reports and access existing reports" for that account.
    • If you use an account with a user role, you may not be able to collect all data.
    Use an account with the appropriate roles and permissions to gather the scope of data that you want to collect with the add-on.
  2. Go to https://app.box.com/developers/services/edit/.
  3. Select Custom App and click Next to create a Box Application.
  4. Select Standard OAuth 2.0 (User Authentication) and click Next.
  5. Type a unique name for your application and click Create App. Box displays a message informing you that your app has been created.
  6. Click View Your App. Box directs you to the application configuration page.
  7. Next to OAuth 2.0 Redirect URI, in the Redirect URI field, enter the SSL-secured HTTPS URI of the Splunk Platform instance that you want to be responsible for data collection from Box, usually a heavy forwarder. For example, if the URL of your heavy forwarder is http://<host>:8000/en-US/app/Splunk_TA_box/splunk_ta_box_redirect, then the redirect URI is exactly the same as this. The OAuth 2.0 specification only supports HTTPS redirects, which means you need turn on SSL for Splunk Web on the instance you are using for Box data collection. Refer to Turn on encryption (https) with Splunk Web in the Splunk Enterprise security documentation for details on how to turn on SSL for Splunk Web.
  8. Next to Application Scopes, select the following options:
    • Read all files and folders stored in Box.
    • Read and write all files and folders in Box
    • Manage users
    • Manage groups
    • Manage enterprise properties
  9. Note down the Client ID and Client Secret next to OAuth 2.0 Credentials. You need this when you set up the Splunk Add-on for Box.
  10. Click Save Changes.
Upgrade the Splunk Add-on for Box
Set up the Splunk Add-on for Box

This documentation applies to the following versions of Splunk® Supported Add-ons: released

Was this documentation topic helpful?

Enter your email address, and someone from the documentation team will respond to you:

Please provide your comments here. Ask a question or make a suggestion.

You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters