@take2identity/verosint 0.2.136 → 0.2.137

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +25 -24
  2. package/package.json +4 -4
package/README.md CHANGED
@@ -16,8 +16,9 @@
16
16
  Use the `verosint` tool to:
17
17
 
18
18
  * Send events to the SignalPrint endpoint to create a map of identities and access history.
19
+ * Evaluate workflows (formerly known as rule sets) one by one or in bulk.
19
20
  * Generate an [LDAP Schema](https://www.rfc-editor.org/rfc/rfc4512#page-22)
20
- file to store rules evaluation atttributes in user entries.
21
+ file to store workflow evaluation atttributes in user entries.
21
22
 
22
23
  Download the binary from:
23
24
  [releases page](https://gitlab.com/verosint/public/verosint/-/releases).
@@ -92,7 +93,7 @@ verosint evaluate rules-batch --help
92
93
 
93
94
  The tool can read settings from a configuration file in a
94
95
  [YAML](https://yaml.org/) format.
95
- For example, you can store the API key as well as rules inside the file.
96
+ For example, you can store the API key as well as workflows inside the file.
96
97
 
97
98
  By default, the tool looks for the configuration file `.verosint.yaml` in
98
99
  your home directory. You can override this setting with the
@@ -125,7 +126,7 @@ verosint evaluate evaluate rule phone:15123944240 --ruleSetUuid 4f5ab21b-984c-45
125
126
  When using commands involving an account ID you should
126
127
  wrap the identifier in double quotes.
127
128
 
128
- ### Evaluating Rules
129
+ ### Evaluating Workflows
129
130
 
130
131
  #### Single Set of Identifiers
131
132
 
@@ -154,44 +155,44 @@ Responses are provided in the JSON format on the standard output.
154
155
 
155
156
  ##### Examples
156
157
 
157
- ###### 2. Evaluate an IPv6 address, a phone number and an email address for a Rule Set
158
+ ###### 2. Evaluate an IPv6 address, a phone number and an email address for a Workflow
158
159
 
159
160
  ```shell
160
161
  verosint evalute rule ip:2607:fb91:1296:c7dc:a0c4:25a9:ac7a:4384 email:user@example.com phone:15123944240 --ruleSetUuid 4f5ab21b-984c-455e-b889-b6b0272a4567
161
162
 
162
163
  ```
163
164
 
164
- ###### 3. Evaluate an IPv4 for address against a rule set already defined in the configuration
165
+ ###### 3. Evaluate an IPv4 for address against a workflow already defined in the configuration
165
166
 
166
- To obtain the UUID of the rule set, visit the
167
- [Rules](https://app.verosint.com/rules) configuration and copy the UUID of
168
- the rule set you would like to evaluate.
167
+ To obtain the UUID of the workflow, visit the
168
+ [Workflows](https://app.verosint.com/workflows) configuration and copy the UUID of
169
+ the workflow you would like to evaluate.
169
170
 
170
- ![Copy Rule Set UUID](https://gitlab.com/verosint/public/verosint/-/raw/main/assets/copyrulesetuuid.png)
171
+ ![Copy Workflow UUID](https://gitlab.com/verosint/public/verosint/-/raw/main/assets/copyworkflowuuid.png)
171
172
 
172
173
  ```shell
173
174
  verosint evalute rule ip:104.255.6.45 --ruleSetUuid 4f5ab21b-984c-455e-b889-b6b0272a4567
174
175
  ```
175
176
 
176
- ###### 4. Evaluate an Email address against a rule set provided using a local file
177
+ ###### 4. Evaluate an Email address against a workflow provided using a local file
177
178
 
178
- You can export a rule set defined in the [Rules](https://app.verosint.com/rules)
179
+ You can export a workflow defined in the [Workflows](https://app.verosint.com/workflows)
179
180
  configuration into a local file as shown below.
180
181
 
181
- ![Export Rule Set](https://gitlab.com/verosint/public/verosint/-/raw/main/assets/exportruleset.png)
182
+ ![Export Workflow](https://gitlab.com/verosint/public/verosint/-/raw/main/assets/exportworkflow.png)
182
183
 
183
184
  This example evaluates the `babs@jensen.com` email address against the rule defined
184
- in the `mfarule.json` file.
185
+ in the `mfaworkflow.json` file.
185
186
 
186
187
  ```shell
187
- verosint evaluate rule email:babs@jensen.com --ruleSetFile mfarule.json
188
+ verosint evaluate rule email:babs@jensen.com --ruleSetFile mfaworkflow.json
188
189
  ```
189
190
 
190
- ##### 5. Check if an IP address is within 100 kilometers of Austin, TX using a local rule set
191
+ ##### 5. Check if an IP address is within 100 kilometers of Austin, TX using a local workflow
191
192
 
192
- You can place rules inside a local configuration file. The following is
193
+ You can place a workflow inside a local configuration file. The following is
193
194
  an example file that uses the `isWithin` function, which enables you to
194
- create rules for [geo-fencing](https://en.wikipedia.org/wiki/Geo-fence)
195
+ create a workflow for [geo-fencing](https://en.wikipedia.org/wiki/Geo-fence)
195
196
  purposes:
196
197
 
197
198
  ```yaml
@@ -204,7 +205,7 @@ rules:
204
205
  reason: This IP is not within 100 kilometers of Austin, Texas
205
206
  ```
206
207
 
207
- The following example runs the same rule saved in the default
208
+ The following example runs the same workflow saved in the default
208
209
  configuration file against the `104.16.44.99` IP address:
209
210
 
210
211
  ```shell
@@ -213,7 +214,7 @@ verosint evaluate rules ip:104.16.44.99
213
214
 
214
215
  #### Batch Evaluation
215
216
 
216
- Use input files to evaluate multiple sets of identifiers against rules.
217
+ Use input files to evaluate multiple sets of identifiers against workflows.
217
218
  Batch commands can use input and output files in CSV or
218
219
  LDIF format, and can produce a report file formatted as JSON.
219
220
 
@@ -222,7 +223,7 @@ single set of identifiers.
222
223
 
223
224
  ##### Batch Evaluation Examples
224
225
 
225
- ###### 2. Executing Batch Rules Evaluation with column index and LDIF output
226
+ ###### 2. Executing Batch Workflow Evaluation with column index and LDIF output
226
227
 
227
228
  If using an input file that has multiple identifiers, you can provide a
228
229
  column index (where 0 refers to the first column) to indicate where the
@@ -234,7 +235,7 @@ ipaddress,mail,telephone
234
235
  104.16.44.99,babs@jensen.com,15123944240
235
236
  ```
236
237
 
237
- Using the rules present in the default configuration file, the
238
+ Using the workflows present in the default configuration file, the
238
239
  following command generates LDIF-formatted output and JSON report
239
240
  files:
240
241
 
@@ -249,12 +250,12 @@ verosint evaluate rules-batch ip:0 email:1 phone:2 \
249
250
 
250
251
  You can submit events to the SignalPrint endpoint using the
251
252
  `signalprint send-events` subcommand. This subcommand works like the
252
- batch commands for rules. An IP address, a user agent, and an event
253
+ batch commands for workflows. An IP address, a user agent, and an event
253
254
  type are required for each event. You can optionally submit an
254
255
  event timestamp, an account identifier, an email address, and
255
256
  a phone number as well.
256
257
 
257
- The timestamp is expected to be in [RFC3339](https://www.rfc-editor.org/rfc/rfc3339) or [UNIX](https://www.unixtimestamp.com/) format.
258
+ The timestamp is expected to be in [RFC3339](https://www.rfc-editor.org/rfc/rfc3339) or [UNIX](https://www.unixtimestamp.com/) format.
258
259
 
259
260
  For example:
260
261
 
@@ -319,7 +320,7 @@ verosint signalprint send-events --inputFile events.csv
319
320
  ### Generating LDAP Schema
320
321
 
321
322
  This command prints an LDAP schema that allows you to enrich existing
322
- user entries in your directory with rule evaluation data from
323
+ user entries in your directory with workflow evaluation data from
323
324
  the API. The enterprise number (59592) in the object identifiers (OIDs)
324
325
  is registered with the
325
326
  [Internet Assigned Numbers Authority](https://www.iana.org/assignments/enterprise-numbers/).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@take2identity/verosint",
3
- "version": "0.2.136",
3
+ "version": "0.2.137",
4
4
  "description": "Official CLI to interact with Verosint API",
5
5
  "main": "index.js",
6
6
  "scripts": {
@@ -27,9 +27,9 @@
27
27
  ],
28
28
  "homepage": "https://gitlab.com/verosint/public/verosint#readme",
29
29
  "dependencies": {
30
- "axios": "^1.3.4",
30
+ "axios": "^1.7.8",
31
31
  "mkdirp": "^3.0.1",
32
- "tar": "^6.1.13",
33
- "unzipper": "0.12.3"
32
+ "tar": "^7.4.3",
33
+ "unzipper": "^0.12.3"
34
34
  }
35
35
  }