Page tree
Skip to end of metadata
Go to start of metadata

For loading data into Squirro, you will need to set up a connection. This requires configuration options, that are used by the various command line tools, the SDK, the API, etc.

Table of Contents


The cluster is the address where your Squirro has been set up. For a Squirro in a Box setup this is generally https://box.ip.address. For the cloud version this is generally or similar.

The self-signed certificate that is deployed by default will cause problems with the command line utilities and show warnings in browsers. To fix this, a SSL certificate can be installed. As a work around, the HTTP version of Squirro can be accessed on port 81 - http://box.ip.address:81.

Authentication Token

For this purpose the Squirro API uses authentication tokens. To create such a token:

  1. Open the Squirro web interface and log in as the user you'll want to use for API access.
  2. Open the user dropdown menu on the top right, then click "API Access".
  3. In the resulting screen under "User Token" press "Generate". The text field will then be populated with a token:

If the text field already has a token, then simply copy that value. If you press "Renew" the current token will be invalidated and a new one is created.

Treat this token like you would your account password. The token gives full access to that account.

Project Identifier

When working with projects, for example to search items, the project's identifier is needed. The user interface provides this identifier:

  1. Log into Squirro.
  2. Open the Settings dropdown menu on the top right (wheelbarrow icon) and click "Project Properties".
  3. The Project Identifier is in the resulting screen and can be copied to the clipboard.
  • No labels