@take2identity/verosint 0.2.136 → 0.2.138
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.
- package/README.md +25 -24
- 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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
165
|
+
###### 3. Evaluate an IPv4 for address against a workflow already defined in the configuration
|
|
165
166
|
|
|
166
|
-
To obtain the UUID of the
|
|
167
|
-
[
|
|
168
|
-
the
|
|
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
|
-

|
|
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
|
|
177
|
+
###### 4. Evaluate an Email address against a workflow provided using a local file
|
|
177
178
|
|
|
178
|
-
You can export a
|
|
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
|
-

|
|
182
183
|
|
|
183
184
|
This example evaluates the `babs@jensen.com` email address against the rule defined
|
|
184
|
-
in the `
|
|
185
|
+
in the `mfaworkflow.json` file.
|
|
185
186
|
|
|
186
187
|
```shell
|
|
187
|
-
verosint evaluate rule email:babs@jensen.com --ruleSetFile
|
|
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
|
|
191
|
+
##### 5. Check if an IP address is within 100 kilometers of Austin, TX using a local workflow
|
|
191
192
|
|
|
192
|
-
You can place
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
3
|
+
"version": "0.2.138",
|
|
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.
|
|
30
|
+
"axios": "^1.7.8",
|
|
31
31
|
"mkdirp": "^3.0.1",
|
|
32
|
-
"tar": "^
|
|
33
|
-
"unzipper": "0.12.3"
|
|
32
|
+
"tar": "^7.4.3",
|
|
33
|
+
"unzipper": "^0.12.3"
|
|
34
34
|
}
|
|
35
35
|
}
|