Skip to main content

1Touch.io's Inventa Connector

This Integration is part of the Inventa Pack.#

Supported versions

Supported Cortex XSOAR versions: 5.5.0 and later.

Use the Inventa integration to generate DSAR reports within Inventa instance and retrieve DSAR data for the XSOAR This integration was integrated and tested with version 2.8.0 of Inventa

Configure 1Touch.io's Inventa Connector on Cortex XSOAR#

  1. Navigate to Settings > Integrations > Servers & Services.

  2. Search for 1Touch.io's Inventa Connector.

  3. Click Add instance to create and configure a new integration instance.

    ParameterDescriptionRequired
    Your Inventa server URLTrue
    API KeyThe API Key to use for connectionTrue
    Trust any certificate (not secure)False
    Use system proxy settingsFalse
  4. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.

inventa-get-datasubjects#


Get Data Subject full details

Base Command#

inventa-get-datasubjects

Input#

Argument NameDescriptionRequired
national_idNational ID of a PII.Optional
passport_numberPassport Number of a PII.Optional
driver_licenseDriver's License of a PII.Optional
tax_idTax ID of a PII.Optional
cc_numberCredit Card Number of a PII.Optional
given_nameGiven Name of a PII.Optional
surnameSurname of a PII.Optional
full_nameFull Name of a PII.Optional
vehicle_numberVehicle Number of a PII.Optional
phone_numberPhone Number of a PII.Optional
birthdayBirthday of a PII.Optional
cityCity of Resdence of a PII.Optional
street_addressStreet Address of a PII.Optional

Please note that all the arguments are optional, but they form a constraint which determines extraction of the right PII. Following combinations are treated as constraints:

  • national_id
  • passport_number
  • driver_license
  • tax_id
  • cc_number
  • given_name + vehicle_number
  • given_name + phone_number
  • given_name + surname + birthday
  • given_name + surname + city + street_address
  • full_name + birthday
  • full_name + city + street_address

Context Output#

PathTypeDescription
Inventa.DataSubjects.dataSubjects.idStringID of a Data Subject
Inventa.DataSubjects.dataSubjects.piis.idStringID of an Entity Type for the PII
Inventa.DataSubjects.dataSubjects.piis.piiEntityTypeStringEntity Type name for the PII
Inventa.DataSubjects.dataSubjects.piis.piiEntityValueStringValue of an Entity Type for the PII
Inventa.DataSubjects.dataSubjects.piis.piiEntityValueNewStringNew Value of an Entity Type for the PII
Inventa.DataSubjects.dataSubjects.piis.actionStringAction of an Entity Type for the PII
Inventa.DataSubjects.totalStringTotal number of PII Entities found for the PII

Command Examples#

!inventa-get-datasubjects national_id=12345678
!inventa-get-datasubjects passport_number=AB123456
!inventa-get-datasubjects driver_license=DL456789
!inventa-get-datasubjects tax_id=1234567890
!inventa-get-datasubjects cc_number=1234567890123456
!inventa-get-datasubjects given_name=john vehicle_number=AB456CD
!inventa-get-datasubjects given_name=john phone_number=1234567890
!inventa-get-datasubjects given_name=john surname=smith birthday=01/20/86
!inventa-get-datasubjects given_name=john surname=smith city=vancouver street_address="main square 1"
!inventa-get-datasubjects full_name="john smith" birthday=01/20/86
!inventa-get-datasubjects full_name="john smith" city=vancouver street_address="main square 1"

inventa-get-dsar-transactions#


Retrieves data transactions' details containing info about data subject

Base Command#

inventa-get-dsar-transactions

Input#

Argument NameDescriptionRequired
ticket_idID of a DSAR ticket within Inventa.Required

Context Output#

PathTypeDescription
Inventa.DSAR.Transactions.transactionsStringList of data transactions

Command Example#

!inventa-get-dsar-transactions ticket_id=3

inventa-get-dsar-files#


Retrieves details of files contatining info about data subject

Base Command#

inventa-get-dsar-files

Input#

Argument NameDescriptionRequired
ticket_idID of a DSAR ticket within Inventa.Required

Context Output#

PathTypeDescription
Inventa.DSAR.Files.filesStringList of files containing info about data subject

Command Example#

!inventa-get-dsar-files ticket_id=3

inventa-get-dsar-databases#


Retrieves list of databases and tables containing info about data subject

Base Command#

inventa-get-dsar-databases

Input#

Argument NameDescriptionRequired
ticket_idID of a DSAR ticket within Inventa.Required

Context Output#

PathTypeDescription
Inventa.DSAR.DataBases.databasesStringList of datatables containing info about data subject

Command Example#

!inventa-get-dsar-databases ticket_id=3

inventa-get-datasubject-details#


Get datasubject name and email

Base Command#

inventa-get-datasubject-details

Input#

Argument NameDescriptionRequired
ticket_idID of a DSAR ticket within Inventa.Required

Context Output#

PathTypeDescription
Inventa.DataSubject.nameStringName of a data subject
Inventa.DataSubject.emailStringEmail address of a data subject

Command Example#

!inventa-get-datasubject-details ticket_id = 3

inventa-get-dsar-dataassets#


Retrieves list of data assets containing info about data subject

Base Command#

inventa-get-dsar-dataassets

Input#

Argument NameDescriptionRequired
ticket_idID of a DSAR ticket within Inventa.Required

Context Output#

PathTypeDescription
Inventa.DSAR.DataAssets.dataAssetsStringList of data assets containing info about data subject

Command Example#

inventa-get-dsar-dataassets ticket_id=3

inventa-get-dsar-piis#


Get list of PII categories related to the data subject

Base Command#

inventa-get-dsar-piis

Input#

Argument NameDescriptionRequired
ticket_idID of a DSAR ticket within Inventa.Required

Context Output#

PathTypeDescription
Inventa.DSAR.piisStringList of PII categories related to data subject

Command Example#

!inventa-get-dsar-piis ticket_id=3

inventa-get-entities#


Retrieves list of PII entities described in Inventa

Base Command#

inventa-get-entities

Input#

Argument NameDescriptionRequired

Context Output#

PathTypeDescription
Inventa.Entities.entityStringList of PII entities described in Inventa

Command Example#

!inventa-get-entities

inventa-get-datasubject-id-from-ticket#


Retrieves ID of a data subject from Inventa's DSAR ticket

Base Command#

inventa-get-datasubject-id-from-ticket

Input#

Argument NameDescriptionRequired
ticket_idID of a DSAR ticket within Inventa.Required

Context Output#

PathTypeDescription
Inventa.DataSubjects.datasubject_idStringID of a data subject within Inventa

Command Example#

!inventa-get-datasubject-id-from-ticket ticket_id=3

inventa-get-datasubject-id#


Retrieves ID of a data subject from passed constraints

Base Command#

inventa-get-datasubject-id

Input#

Argument NameDescriptionRequired
national_idNational ID of a PII.Optional
passport_numberPassport Number of a PII.Optional
driver_licenseDriver's License of a PII.Optional
tax_idTax ID of a PII.Optional
cc_numberCredit Card Number of a PII.Optional
given_nameGiven Name of a PII.Optional
surnameSurname of a PII.Optional
full_nameFull Name of a PII.Optional
vehicle_numberVehicle Number of a PII.Optional
phone_numberPhone Number of a PII.Optional
birthdayBirthday of a PII.Optional
cityCity of Resdence of a PII.Optional
street_addressStreet Address of a PII.Optional

Please note that all the arguments are optional, but they form a constraint which determines extraction of the right PII. Following combinations are treated as constraints:

  • national_id
  • passport_number
  • driver_license
  • tax_id
  • cc_number
  • given_name + vehicle_number
  • given_name + phone_number
  • given_name + surname + birthday
  • given_name + surname + city + street_address
  • full_name + birthday
  • full_name + city + street_address

Context Output#

PathTypeDescription
Inventa.DataSubjects.datasubject_idStringID of a data subject within Inventa

Command Example#

!inventa-get-datasubjects national_id=12345678
!inventa-get-datasubjects passport_number=AB123456
!inventa-get-datasubjects driver_license=DL456789
!inventa-get-datasubjects tax_id=1234567890
!inventa-get-datasubjects cc_number=1234567890123456
!inventa-get-datasubjects given_name=john vehicle_number=AB456CD
!inventa-get-datasubjects given_name=john phone_number=1234567890
!inventa-get-datasubjects given_name=john surname=smith birthday=01/20/86
!inventa-get-datasubjects given_name=john surname=smith city=vancouver street_address="main square 1"
!inventa-get-datasubjects full_name="john smith" birthday=01/20/86
!inventa-get-datasubjects full_name="john smith" city=vancouver street_address="main square 1"

inventa-create-ticket#


Creates Inventa ticket

Base Command#

inventa-create-ticket

Input#

Argument NameDescriptionRequired
reasonReason for DSAR report.Required
datasubject_idID of a data subject within Inventa.Required

Context Output#

PathTypeDescription
Inventa.DataSubjects.Ticket.ticket_idStringID of a DSAR ticket, created within Inventa

Command Example#

!inventa-create-ticket reason="test reason" datasubject_id=123asd456789