Overview
Mindflow was created to enable individuals to automate their work without requiring coding skills. The goal of this quick start guide is to introduce new users to the essential concepts of Mindflow. We will guide you through the process of creating a simple URL analysis flow.
By the end of this journey, you should be comfortable enough to create your own flows from scratch, while gaining a new understanding of how to optimize your recurring workflows through automation.
This guide will get you started with text documentation and a series of short video tutorials.
💡 This guide allows you to explore the content of our quick start guide independently. If you prefer a guided experience with an instructor, feel free to sign up for our Mindflow Quick Start Guide!
Before you go further
1. Detail your needs
It's important to correctly expose what you want to achieve before going deeper in your projects. To do so, we encourage writing your needs in Agile User Story format like :
WHEN: an alert is emitted …
THEN: enrich it ….
IF: malicious …
THEN: block ip …
And iterate over it adding informations as long as you can, ending in something like that:
WHEN: an alert is emitted in Google Alert Center
THEN: Extract IP address
THEN: Analyze it against Virustotal
IF: malicious score > 0THEN: block ip in Fortinet FW
ENDIF
END
2. Calculate cost, gains, profitability
It can be in goal for profitability, or to convince your hierarchy. But one thing is sure, you'll need to demonstrate the profitability of your project.
COSTS:
One Time :
Automation Development (Including time requesting accesses, hierarchy validation, development, testing)
Recurring :
Maintainability
Licenses
GAINS :
Time Saved : Calculated per day / per people
Backlog reduction
Hidden (hard to calculate):
Process Harmonisation / stability
Human-based error reduction
Opportunity creations
People motivation / well-being
Step by Step
1. Get Started
Navigate to https://your-tenant.mindflow.io and click on Create Account
Once you have clicked on the Create Account
button, an e-mail will be sent to you inviting you to enter the code received.
Now you can log in with your credentials.
The security of your environment is paramount, and we strongly recommend that you configure the 2FA. Go to the Settings
page and click on the Enable Two Factor Authentification
button.
Scan the QR code using your authentication app and enter the verification code.
Congratulations ! You now have access to a brighter future automating things with Mindflow !
2. Create an Environment
Now it's time to create your first environment, which will host your first flow.
Click on the + Create environment
button, edit the environment title by clicking on it and modify the emoji as you wish.
Congratulations ! You can now start playing around and discover a brand-new world !
3. Choose integrations
Now, you are going to select the integrations you want to play with :
Click on the Integrations
tab.
Search for VirusTotal
Select the first integration which doesn’t have the Preset
header.
Congratulations ! You can now play with the freshly added integrations, allowing you to connect tools between them, and much more !
4. Create a Credential
In this section, assuming you already have a VirusTotal account, we will guide you through the process of obtaining an API key from VirusTotal. You will then proceed to build a credential in the Mindflow Vault using that API key.
Log on to https://www.virustotal.com/gui/sign-in, navigate to the API Key
page by clicking on your profile and copy the “API key”.
You can now navigate to the Environment
page and click on the Create a credential
button
Search for VirusTotal in the search bar and select VirusTotal "Native”:
Click on the
+ Credential
drop-down menu and select the correct service :Virus Total
In the
x-apikey
field, insert your api key in theValue
field And finally, click onCreate
Congratulations ! You can now authenticate against your company tools and retrieve more useful data than you could before !
5. Build a flow
Today, you will be creating a flow that enables you to analyze one or multiple URLs through VirusTotal triggered by an email hook and receive the results via email.
Let's get started with Mindflow editor
Now it's time to explore Mindflow's capabilities. These form the core building blocks of your Mindflow flows, and by connecting them together, you can bring your automation ideas to life.
Go in the
Flows
section and select theEnvironment
you want to create the flow inClick on the
+ Create Flow
Edit the emoji by clicking on it
Edit the title by clicking on it
You are now in your flow editor
Click on the blue
+
button in the middle of the designer to add anEmail Trigger
Copy the email, hook under the
Email address
field. Allowing you to trigger the flow with an email.
Go to your mailbox
Create a test mail with several urls (you can copy the one from the video 😉)
Hello you ! You won an iPhone 24 pro plus ultra max ! Click here to redeem : <https://secure.eicar.org/eicar.com.txt> Or here : <https://google.fr> Cheers
Insert the mail you've just copied into the recipient.
Send the e-mail
Click on the
+
button to display the step menuSelect the
Transform data
step and rename it by clicking on it.Click on the ⚙ button
Fill the
Key
field with the value “body”Insert a
/
in theValue
field to display the datas selection menu, then click on your mail in theTriggers
category, click on the last iteration, then select on the field containing the content of the mail you sent
(In the video, it's the text
field that applies to Gmail)
Click on the
+
button below the previously created step and add anotherTransform Data
step.Rename step to “Extract URLs”
Open step configuration menu and fill
Key
name field with “URLs”Insert a / in the
Value
field, and select the "TEXT" data stack in theVariable
section.Then click on the fonction button
fx
that appears when you move the cursor over the right-hand side of the field.Click on the
Add a function
button and select theExtract URLs
function.You’re done configuring the step.
Click on the
+
button of the last step and add aFor each
Rename the step to “For each URL”
Go to the step configuration menu and insert a “/” to access the data selection menu
Select
URLs
in the Variables section, thenURLs
.
Click on the
+
button inside StepFor each
Search and select
VirusTotal
, then select theAnalyze a URL
operationAccess the
Input
menu, then theUrl
field data selection menuType
/
to open the variables panel.Select
For each URL
in the Flow category, thenIteration data
Go to the
Settings
tab of the ⚙️ configuration menu, click on the drop-down menu for theCredential
field and select theVirusTotal credential
you created in 3️⃣ Create a Credential.Rename the
Analyze a URL
step to “Submit URL” and add a relevant description by clicking just below the title.Add the
VirusTotal
operationRetrieve information about a file or URL
in theFor each
just after the previous step.Access the step configuration menu, then the data selection menu in the
id
field. SelectSubmit URL
, then the last iteration, and finallydata
>id
.Navigate to the
Settings
tab and select your credential.Rename step to “Retrieve URL analysis”
Add a condition step after the
Retrieve URL analysis
step and rename it "Is malicious?".Add a new
Transform data
Transform data stepMove the step far enough away to see the editable branch name and rename it "YES" and rename the
Transform data
step to "Set malicious = true".Access the configuration menu and add a variable with the
Key
"malicious" and set theRaw value
to "true".click on the ⚙️ configuration button of the
condition step
to click on the>
button of theIF
fieldAccess the data selection menu of the first field, select
Retrieve URL analysis
, the last iteration thendata
>attributes
>stats
>malicious
change the formula in the drop-down menu to
is greater than
and insert a 0 in the last field
Click on the
+
button under theFor each
step and select theSend email
step.Rename Reply to sender
Access the
Item 0
field data selection menu, then your email, the last iteration thenfrom
>value
>value[0]
>address
Write the subject of your e-mail, for example: Email analysis status in the Subject field.
Write the text of your e-mail in the
Text
field:Hello,The email you submitted was analyzed:Malicious: <INSERT “/” HERE>Cheers,
Insert a “/” just after “Malicious:” in the email text, to display the data selection menu and select the
malicious
variable
Your flow is ready to use! Now, if you try to send an e-mail containing URLs to your flow's trigger e-mail, it will send you an e-mail containing the results of their VirusTotal analyses.
Congratulations ! You have created an awesome flow that avoid you to do manual analysis, and you now have more time to do things that matter !
6. Conclusion
Congratulations! You've just built your first Mindflow workflow! We've covered configuring credentials, using event transformation actions, leveraging cybersecurity integrations for multiple API calls, and using an email hook action to control event flow.
Most importantly, you've witnessed how easy it can be to automate your everyday workflows. Today, we've only scratched the surface of what Mindflow can do.