--- title: "Journey Assistant | Darwinium" slug: "journey-assistant" description: "Use the Darwinium Journey Assistant to help author and refine journey configuration in the portal." updated: 2024-07-22T14:31:52Z published: 2024-07-22T14:31:52Z canonical: "docs.darwinium.com/journey-assistant" --- > ## 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 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. CautionAvoid 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](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/root_ca.crt?sv=2026-02-06&spr=https&st=2026-11-22T23%3A34%3A53Z&se=2026-11-23T00%3A34%3A53Z&sr=b&sp=r&sig=ESMS2OFECM7iaASwGwFPrPWNcPqJ0fkWTNqMk%2BGe%2Bbs%3D) ### Installation on Firefox Nightly Only install the root CA on a browser you do not use for your everyday activityDo 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:** **![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/Screen%20Shot%202022-07-06%20at%206.50.03%20PM.png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A34%3A53Z&se=2026-11-23T00%3A34%3A53Z&sr=b&sp=r&sig=OXHII4q3dz3CEPzcZo%2F%2FP0H4nhB%2Fn0E4NLabpslwiYw%3D)** ![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/image-1721658592793.png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A34%3A53Z&se=2026-11-23T00%3A34%3A53Z&sr=b&sp=r&sig=t5U9GTpGS9LC6XVKSlCVrhbwh%2FdaU1BZ%2FnE9%2F1Hsoco%3D) ## Using Journey Assistant While editing a journey file, the assistant can be invoked using the command palette (F1): ![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/Screen%20Shot%202022-07-06%20at%207.10.35%20PM.png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A34%3A53Z&se=2026-11-23T00%3A34%3A53Z&sr=b&sp=r&sig=8WBtvvG33HQ%2FP769QjzfD52qC9TBI8rl9h7xk5GObT0%3D) The journey assistant will appear in an adjacent view pane. ![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/image-1657163424559.png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A34%3A53Z&se=2026-11-23T00%3A34%3A53Z&sr=b&sp=r&sig=Emt3q2jVADqYKyYk3v%2BhbyrkmDrEm9OcHfRyX%2B%2F1BNo%3D) 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: ![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/Screen%20Shot%202022-07-06%20at%207.15.40%20PM.png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A34%3A53Z&se=2026-11-23T00%3A34%3A53Z&sr=b&sp=r&sig=vZX09Uh5ZKXnFmm2WkaxaQpIp%2FEDEdio7Zrr2JUB480%3D) In the journey assistant pane, messages representing web requests made by your browser should start being displayed: ![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/Screen%20Shot%202022-07-06%20at%207.13.06%20PM.png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A34%3A53Z&se=2026-11-23T00%3A34%3A53Z&sr=b&sp=r&sig=h6gwAqYhf%2FpCHRxqK4FDaZcaQekmK%2BeQU%2FWCzNC7r4M%3D) ### 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: ![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/image-1657167957470.png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A34%3A53Z&se=2026-11-23T00%3A34%3A53Z&sr=b&sp=r&sig=wzkyhsViRFmFbn1VFSpSdxA%2BMjb3XGw4UtsInaAl%2B8g%3D) 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: ![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/image-1657167986652.png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A34%3A53Z&se=2026-11-23T00%3A34%3A53Z&sr=b&sp=r&sig=IS1MprxhxXXywf7j9cx47Nr63bJ1THvboORlMCt11cM%3D)Import this as a step into your journey by clicking: ![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/Screen%20Shot%202022-07-06%20at%207.12.28%20PM(1).png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A34%3A53Z&se=2026-11-23T00%3A34%3A53Z&sr=b&sp=r&sig=sQGX5ROw6dbVRncLGRV3BMIloj1qibYLbHbZYVVcpic%3D)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](/v1/docs/journey-assistant-ben#install-the-darwinium-root-ca) 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 ![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/Screen%20Shot%202022-07-06%20at%207.10.52%20PM.png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A34%3A53Z&se=2026-11-23T00%3A34%3A53Z&sr=b&sp=r&sig=R1J9lpD2Zm4bkxKQ1Li0vMVqXxOlStLZzcfrTRjwJ5U%3D)use 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 - [Debugging Journeys](/v1/docs/debugging-journeys)