Skip to main content

2024.07.17 Release Note

· 4 min read

July release comes with 1 major feature and some bug fixes:

  • Gossiper Go agent to replace Whisperer Node.js agents

Upgrade risk

warning

Compatibility issue!

Whisperer configuration might have been saved previously with number as json strings by the UI.
For it to work with GO, it needs to be fixed.

Most frequently for RAM circuit breaker value, and custom DNS port value.

ConfigToChange.png

How do I know I have to migrate?

Whisperer won't be able to parse its configuration:

  • It will be displayed as 'disconnected' on the UI
  • It will generate logs telling it cannot read configuration, with the field in error

How to migrate configuration?

  1. Open your whisperer configuration on the UI (Capture tab mostly)
  2. Change anything
  3. Save
  4. You may revert your change if you did not want this change ;)

Key changes

How to upgrade

  1. Use Helm chart 3.1.1 from repository
  2. Adjust global.version field value to 2024.07.17 in your values.yaml
  3. Deploy
tip

See Reference documentation for details.

Versions

Spider

New versions of Spider components:

ComponentVersionDocker tag
Helm chart3.1.1-
Analysis UI10.8latest
Controllers1.4latest
Whisperers6.2latest
Gossipers7.0latest
Back office-latest
Login UI-latest
Monitoring UI-latest

Dependencies

These components are set up in the correct versions by the Helm chart:

DependencyVersionDocker tag
Elastic stack7.17.47.17.4
Redis77-alpine
Traefik2.112.11

Compatibility

Spider has been successfully tested under these versions of dependencies:

3rd party softwareVersion
Helm3.14
Kube1.24 - 1.28

List of changes

Helm chart

✨ New features
  • Support Gossipers in demo mode and development
  • Support debugging Gossipers
⚙️ Improvements
  • Avoid using root user for Controllers
🐞 Bug fixes

Analysis UI

✨ New features
  • Allow to choose agent (Whisperer / Gossiper) when attaching a Whisperer.
  • Allow to choose capture method
  • Report capture method in Whisperer status
⚙️ Improvements
  • Deactivate non loaded plugins in TCP content tab parser dropdown
🐞 Bug fixes
  • Some fixes in payload display of packets.
  • Fix bad special characters protection when exporting to cURL command a request with a querystring containing characters with special meaning in linux shell

Controllers

✨ New features
  • Allow choosing agent
  • Automatic reset of state every 5 min
⚙️ Improvements
  • Avoid using root user
🐞 Bug fixes

Whisperers

✨ New features
  • New Gossiper agent in Go
  • AF Packet capture mode
⚙️ Improvements
🐞 Bug fixes

Back office

✨ New features
  • Allow choosing agent to attach
  • Manage capture method in configuration and status
⚙️ Improvements
🐞 Bug fixes
  • Fix computation of Whisperers instances status: Latest session speed (Upload / Packets lod / Tcp sessions load) was wrong

Login UI

✨ New features
⚙️ Improvements
🐞 Bug fixes

Monitoring UI

✨ New features
⚙️ Improvements
🐞 Bug fixes
  • Fix folding on Apps view - 2 section had same id

Online documentation

Updated parts: N/A

API impacts

note

This section informs about any impact on Spider API, so you may adjust your scripts.

  • POST /controls/v1/controllers/{id}/attachments/

Data impacts

note

The table below tells if there are data mapping changes in Elasticsearch indices, associated or not with migrations (Yes ✅ / No ❌).
Migration are automated at upgrade time, but they may leave unattended indices that you have to remove manually.

IndexDescriptionMigration