Documentation Index

Fetch the complete documentation index at: https://docs.darwinium.com/llms.txt

Use this file to discover all available pages before exploring further.

Journey Assistant

  • Updated on Jul 22, 2024
  • Published on Jun 21, 2022
  • 3 minute(s) read
  • BD
  • CG
 Prev Next

Journey assistant is a developer tool built into the Darwinium workflow IDE. 

It is a Man in the Middle (MITM) proxy server akin to wireshark that provides the ability to rapidly craft steps from web events observed from your browser session when performing actions on your site such as logins or account creations. 

When using the journey assistant, you are provided a one-time session token that is used to authenticate your use and associate it with a running session. It is highly recommended that you use a different browser that you do not use regularly with the proxy service for ease of use (such as Chromium or Firefox Nightly), as the proxy will cease to operate when the journey assistant is not open.

Caution
Avoid using your own PII when the journey assistant is enabled. Although darwinium does not store any session data, it transmits this to your journey assistant interface for the duration that journey assistant is open. It is highly recommended that you only use test credentials when authoring journeys.

Whitelist Darwinium proxy IPs on your origin

The journey proxy uses the following IP addresses:

  • 3.23.188.252
  • 13.59.100.127
  • 3.129.160.160

These will need to be whitelisted by your origin to enable you to reach it using the tool.


Install the Darwinium root CA

Installation of the Darwinium root CA is needed if you wish to introspect HTTPS traffic. The proxy serves as a man-in-the-middle that decrypts TLS traffic from the endpoint and re-encrypts using the Darwinium root CA after details are collected.

The certificate can be found below:

root_ca.crt

Installation on Firefox Nightly

Only install the root CA on a browser you do not use for your everyday activity
Do not install the root CA as part of your operating system settings. We recommend the use of firefox nightly as a candidate for connecting to the journey assistant



Set the Proxy server

Set your browsers proxy server to journey-assistant.darwinium.io port 8200, and ensure that it is enabled for HTTPS.

Setting of the proxy varies from browser-to-browser. Details can easily be found on an internet search. In firefox, for example, this can be done by going to Preferences 
and searching for Proxy:


Using Journey Assistant

While editing a journey file, the assistant can be invoked using the command palette (F1):

The journey assistant will appear in an adjacent view pane.

A token will be provided onscreen. Copy this to your clipboard. 

In your browser with the proxy configured, attempt to navigate to a site you wish to inspect. Enter darwinium as the username, and the token copied to the clipbooard as a password:

In the journey assistant pane, messages representing web requests made by your browser should start being displayed:

 



Creating a journey step from selected points using the journey UI

Select a request from the network events box to view more details about that event:

Select points of interest (such as request/response headers, body content, URL fragment info) that you wish to extract or inject upon by clicking on their corresponding tick boxes:


Import this as a step into your journey by clicking:


The step will be imported with placeholder extract rules. Select the Data Mappings tab of the step to find the mapped attributes, and assign extracted values to Darwinium attributes. If you wish to perform an action other than extraction, delete the extraction part of the rule and replace it with an appropriate rule. See Injection and Extraction Menu for further details.

Getting step definitions as YAML

If you are editing a journey in text-mode, you can import the journey step from the step assistant by selecting Darwinium: Insert Step from Journey assistant from the command palette

use <tab> to navigate to elements that require further user input.

Troubleshooting

How do i know when the proxy server is working?

Messages will appear in the journey assistant corresponding to your browser session. If they do not appear, it is likely that your proxy settings are incorrect, or your token has expired. Try closing the journey assistant, re-opening it, and entering your details into the browser again.


The proxy server stopped working. What do i do?

It is likely that communication between the journey assistant and your browser has ended. Possibly you closed the journey assistant, which resulted in the connection terminating. Try closing the joruney assistant and re-opening it.

See also