@knowttl/artium-axi 0.0.10 → 0.0.11

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 CHANGED
@@ -37,7 +37,7 @@ Agents keep a command-line interface with TOON discovery rather than implementin
37
37
  ### Supported pinned tools
38
38
  | Tool | Managed access |
39
39
  | --- | --- |
40
- | Falcon | Read-only API client |
40
+ | Falcon | API client; optional guarded RTR read-only commands |
41
41
  | Vectra | Token or OAuth; optional allow-listed writes |
42
42
  | Azure | Application identity and resource-token broker |
43
43
  | Microsoft Graph | Application identity; optional allow-listed writes |
@@ -162,7 +162,8 @@ Administrator capability alone grants no tool access; upstream permissions remai
162
162
 
163
163
  | Tool | Write capability and unlock |
164
164
  | --- | --- |
165
- | Falcon, LDAP | Fixed read-only; Falcon's NG-SIEM search-job start/stop effects remain available regardless of any legacy saved write setting. LDAP has no writes. |
165
+ | Falcon | Optional guarded RTR execution from the standard read-only command allowlist, with profile narrowing. Host changes, scripts and file transfers remain unavailable. See [Falcon execution setup](docs/runbook.md#falcon-rtr-execution). |
166
+ | LDAP | Fixed read-only. |
166
167
  | Azure | Reviewed resource mutations; administrator `allowWrites: true` plus native command gates. |
167
168
  | Graph, Vectra | Native mutations only with administrator `writes.allowWrites: true` and an explicit operations allow-list, plus native gates. |
168
169
  | Azure DevOps | Reviewed mutations with administrator `allowWrites: true`; raw `api` remains GET-only. |
@@ -19775,7 +19775,7 @@ function errorResponse(error62, requestId) {
19775
19775
  var inputLimits = {
19776
19776
  requestBytes: 16 * 1024 * 1024,
19777
19777
  arguments: 64,
19778
- argumentBytes: 4096,
19778
+ argumentBytes: 64 * 1024,
19779
19779
  stdinBytes: 512 * 1024,
19780
19780
  fileBytes: 1024 * 1024,
19781
19781
  totalFileBytes: 4 * 1024 * 1024,
@@ -20046,6 +20046,29 @@ var adminAuditRoute = {
20046
20046
  authorization: "administrator-and-recent-auth",
20047
20047
  auditEvent: null
20048
20048
  };
20049
+ var falconRtrSettingsSchema = external_exports.strictObject({
20050
+ enabled: external_exports.boolean(),
20051
+ commands: external_exports.array(external_exports.enum([
20052
+ "cat",
20053
+ "cd",
20054
+ "clear",
20055
+ "csrutil",
20056
+ "env",
20057
+ "eventlog",
20058
+ "filehash",
20059
+ "getsid",
20060
+ "help",
20061
+ "history",
20062
+ "ifconfig",
20063
+ "ipconfig",
20064
+ "ls",
20065
+ "mount",
20066
+ "netstat",
20067
+ "ps",
20068
+ "reg query",
20069
+ "users"
20070
+ ])).optional()
20071
+ });
20049
20072
  var nativeSettingsSchemas = {
20050
20073
  "tenable-axi": external_exports.strictObject({ writes: external_exports.strictObject({
20051
20074
  allowWrites: external_exports.boolean(),
@@ -20058,7 +20081,7 @@ var nativeSettingsSchemas = {
20058
20081
  allowWrites: external_exports.boolean(),
20059
20082
  operations: external_exports.array(external_exports.string().min(1).max(256)).min(1).max(64)
20060
20083
  }).optional() }),
20061
- "falcon-axi": external_exports.strictObject({ allowWrites: external_exports.boolean().optional() }),
20084
+ "falcon-axi": external_exports.strictObject({ allowWrites: external_exports.boolean().optional(), rtr: falconRtrSettingsSchema.optional() }),
20062
20085
  "vectra-axi": external_exports.strictObject({ writes: external_exports.strictObject({
20063
20086
  allowWrites: external_exports.boolean(),
20064
20087
  operations: external_exports.array(external_exports.string().min(1).refine((value) => value.trim().length > 0)).min(1)
@@ -20604,7 +20627,7 @@ import { resolve } from "node:path";
20604
20627
  // package.json
20605
20628
  var package_default = {
20606
20629
  name: "artium-axi",
20607
- version: "0.0.10",
20630
+ version: "0.0.11",
20608
20631
  private: true,
20609
20632
  license: "MIT",
20610
20633
  type: "module",
@@ -21018,12 +21041,17 @@ var falcon_axi_default = {
21018
21041
  generatedBy: "scripts/falcon-inventory.mjs",
21019
21042
  tool: "falcon-axi",
21020
21043
  repository: "https://github.com/knowttl/falcon-axi.git",
21021
- tag: "v0.5.1",
21022
- commit: "b595b500681eee476ddeb2d8d459bb9f8ad2125f",
21023
- version: "0.5.1",
21044
+ tag: "v0.6.0",
21045
+ commit: "84017f66e72757a8468992c793b3c1095fe6baa3",
21046
+ version: "0.6.0",
21047
+ distribution: {
21048
+ filename: "falcon_axi-0.6.0-py3-none-any.whl",
21049
+ sha256: "88bacab2be710432807678f6c710fc5f8d00eb5b1d44680f3807d64398b23781",
21050
+ provenance: "https://pypi.org/integrity/falcon-axi/0.6.0/falcon_axi-0.6.0-py3-none-any.whl/provenance"
21051
+ },
21024
21052
  parser: {
21025
21053
  path: "falcon_axi/cli.py",
21026
- sha256: "2f7ee1d6601dafb63e5e40cc3b1fe28b295f67f7da2f9e23e747cca644caa09d",
21054
+ sha256: "d8b94b90440d7c538847a7da5dc8b3daa12fbaee09a400144c70539261ae7ec6",
21027
21055
  aliases: {},
21028
21056
  shortFlags: {},
21029
21057
  repeats: "last value wins",
@@ -21134,6 +21162,20 @@ var falcon_axi_default = {
21134
21162
  },
21135
21163
  input: "No file or raw URL input; cursors and queries remain native values"
21136
21164
  },
21165
+ {
21166
+ command: "detection process",
21167
+ flags: {
21168
+ help: "boolean",
21169
+ region: "value",
21170
+ "allow-unknown-origin": "boolean",
21171
+ "member-cid": "value",
21172
+ "no-member-cid": "boolean",
21173
+ config: "value",
21174
+ profile: "value",
21175
+ full: "boolean"
21176
+ },
21177
+ input: "No file or raw URL input; cursors and queries remain native values"
21178
+ },
21137
21179
  {
21138
21180
  command: "host list",
21139
21181
  flags: {
@@ -22202,6 +22244,68 @@ var falcon_axi_default = {
22202
22244
  },
22203
22245
  input: "No file or raw URL input; cursors and queries remain native values"
22204
22246
  },
22247
+ {
22248
+ command: "rtr session list",
22249
+ flags: {
22250
+ help: "boolean",
22251
+ region: "value",
22252
+ "allow-unknown-origin": "boolean",
22253
+ "member-cid": "value",
22254
+ "no-member-cid": "boolean",
22255
+ config: "value",
22256
+ profile: "value",
22257
+ filter: "value",
22258
+ limit: "value",
22259
+ cursor: "value"
22260
+ },
22261
+ input: "No file or raw URL input; cursors and queries remain native values"
22262
+ },
22263
+ {
22264
+ command: "rtr session show",
22265
+ flags: {
22266
+ help: "boolean",
22267
+ region: "value",
22268
+ "allow-unknown-origin": "boolean",
22269
+ "member-cid": "value",
22270
+ "no-member-cid": "boolean",
22271
+ config: "value",
22272
+ profile: "value",
22273
+ full: "boolean"
22274
+ },
22275
+ input: "No file or raw URL input; cursors and queries remain native values"
22276
+ },
22277
+ {
22278
+ command: "rtr audit list",
22279
+ flags: {
22280
+ help: "boolean",
22281
+ region: "value",
22282
+ "allow-unknown-origin": "boolean",
22283
+ "member-cid": "value",
22284
+ "no-member-cid": "boolean",
22285
+ config: "value",
22286
+ profile: "value",
22287
+ filter: "value",
22288
+ limit: "value",
22289
+ cursor: "value"
22290
+ },
22291
+ input: "No file or raw URL input; cursors and queries remain native values"
22292
+ },
22293
+ {
22294
+ command: "rtr run",
22295
+ flags: {
22296
+ help: "boolean",
22297
+ region: "value",
22298
+ "allow-unknown-origin": "boolean",
22299
+ "member-cid": "value",
22300
+ "no-member-cid": "boolean",
22301
+ config: "value",
22302
+ profile: "value",
22303
+ command: "value",
22304
+ execute: "boolean",
22305
+ confirm: "value"
22306
+ },
22307
+ input: "No file or raw URL input; cursors and queries remain native values"
22308
+ },
22205
22309
  {
22206
22310
  command: "auth status",
22207
22311
  flags: {
@@ -22398,6 +22502,10 @@ var falcon_axi_default = {
22398
22502
  name: "FALCON_AXI_READ_ONLY",
22399
22503
  disposition: "injected"
22400
22504
  },
22505
+ {
22506
+ name: "FALCON_AXI_WRITE_LOG",
22507
+ disposition: "injected"
22508
+ },
22401
22509
  {
22402
22510
  name: "FALCON_AXI_MEMBER_CID",
22403
22511
  disposition: "never injected"
@@ -22417,17 +22525,15 @@ var falcon_axi_default = {
22417
22525
  {
22418
22526
  name: "FALCON_AXI_PROFILE",
22419
22527
  disposition: "never injected"
22420
- },
22421
- {
22422
- name: "FALCON_AXI_WRITE_LOG",
22423
- disposition: "never injected"
22424
22528
  }
22425
22529
  ],
22426
22530
  requirements: {
22427
22531
  runtime: "python",
22428
- timeoutMs: 6e4,
22429
- temporaryFiles: [],
22430
- nativeWrites: "read-only upstream design"
22532
+ timeoutMs: 65e3,
22533
+ temporaryFiles: [
22534
+ "falcon-axi/config.json"
22535
+ ],
22536
+ nativeWrites: "RTR read-only command execution requires host permission, profile opt-in and exact confirmation"
22431
22537
  },
22432
22538
  healthRead: [
22433
22539
  "auth",
@@ -22471,6 +22577,7 @@ var falcon_axi_default = {
22471
22577
  "ioa",
22472
22578
  "correlation-rule",
22473
22579
  "case",
22580
+ "rtr",
22474
22581
  "auth",
22475
22582
  "scopes",
22476
22583
  "sensor-usage",
@@ -38622,8 +38729,8 @@ var awx_axi_default = {
38622
38729
  var tenable_axi_default = {
38623
38730
  generatedBy: "scripts/tenable-inventory.mjs",
38624
38731
  tool: "tenable-axi",
38625
- version: "0.1.0",
38626
- integrity: "sha512-nw1HLOmUZdeo/x1po1uOmFQhZsg0rP1eMGrcwLj+Pd2UkdwKodAQjDCjgBdl5DNLIqaafkUEV6mPMJmkFLQpzw==",
38732
+ version: "0.1.1",
38733
+ integrity: "sha512-ukWwVny4DeEBLqqWJhaM0au4Z5dvQTsDKoE2NhROIE3p114WUz2tT5dOfWL8MaalVrmU/zSMhk+S29sUocR3xg==",
38627
38734
  parserEvidence: "Published command catalogue, mutation registry and reviewed native parsers and transport gates",
38628
38735
  sources: [
38629
38736
  {
@@ -38660,7 +38767,7 @@ var tenable_axi_default = {
38660
38767
  },
38661
38768
  {
38662
38769
  path: "dist/src/exposure.js",
38663
- sha256: "0278853a917eb583c721c69d10c5e466aed9d18c8d910f20991dcfe33faac738"
38770
+ sha256: "5e93b01dc54368627f1f7c1ac4a96579af2f4beae7c2b10189ba190cf5cc9af6"
38664
38771
  },
38665
38772
  {
38666
38773
  path: "dist/src/hook-install.js",
@@ -38668,19 +38775,19 @@ var tenable_axi_default = {
38668
38775
  },
38669
38776
  {
38670
38777
  path: "dist/src/inventory-catalogue.js",
38671
- sha256: "2a4b4338917af9060b6859eaa2cfc94cc5ccb936bf96f744b51755d4d92d98a7"
38778
+ sha256: "ccd42834a43aabffbd90e7326926660e9cff788997ab836cb2eb858fc36f1119"
38672
38779
  },
38673
38780
  {
38674
38781
  path: "dist/src/inventory-export-catalogue.js",
38675
- sha256: "a85ef57098bdec74dccd587b7065ebb4c84b3902043fc87c8aedd878d74b375f"
38782
+ sha256: "cf07efc8540e83fcda3f79df4a5ec6c75e081e1557a52e6e178a24ee7d393905"
38676
38783
  },
38677
38784
  {
38678
38785
  path: "dist/src/inventory-export.js",
38679
- sha256: "5422b59008eecad8476d8c0ce5f287188a2f1ad4fcfe763450ac187423d7d0f2"
38786
+ sha256: "176bd2aef67901383e29f5984867d104fdb8278a40d13d1281aa459ea44a8f9c"
38680
38787
  },
38681
38788
  {
38682
38789
  path: "dist/src/inventory.js",
38683
- sha256: "12ad8effb2728fea7791e5f62716d079484b377c56f8b9cdb83d500842258b7d"
38790
+ sha256: "83bd3b19b1ad54785fdf107b57a66ffc882141706337bb886108b67f75565bb1"
38684
38791
  },
38685
38792
  {
38686
38793
  path: "dist/src/inventory/schema.js",
@@ -38692,11 +38799,11 @@ var tenable_axi_default = {
38692
38799
  },
38693
38800
  {
38694
38801
  path: "dist/src/platform-tag-catalogue.js",
38695
- sha256: "9c887c06dd1179a877696deae8873ffce5e3b3e001f2c61ae7968f883eafe314"
38802
+ sha256: "9efb6f39618f2508e7e3cf58e1f50ce0c994351d5e8d69463c8caad8ecf020d7"
38696
38803
  },
38697
38804
  {
38698
38805
  path: "dist/src/platform-tag.js",
38699
- sha256: "ff31eb9a454ba20d2e378403fd4cb29b097e8de4b8b241b3af13197598a66972"
38806
+ sha256: "89933fd5ed557037afab537d147348cad8131684cd8422f20ee4fb5846707a18"
38700
38807
  },
38701
38808
  {
38702
38809
  path: "dist/src/private-file.js",
@@ -38724,7 +38831,7 @@ var tenable_axi_default = {
38724
38831
  },
38725
38832
  {
38726
38833
  path: "dist/src/transport-core.js",
38727
- sha256: "db13c1c33aa1716bc8a32e3ebc6459421c64f078ea4641f248e552c5b74a621d"
38834
+ sha256: "3419fbee2b091109495216c4da4f68fdaa1779449f9eee29a9ec429b0d306195"
38728
38835
  },
38729
38836
  {
38730
38837
  path: "dist/src/transport.js",
@@ -39190,7 +39297,7 @@ var tenable_axi_default = {
39190
39297
  full: "Full output; default false",
39191
39298
  help: "Show help",
39192
39299
  "body-file": "Optional strict query/filters JSON file, '-' for stdin; maximum 1 MiB",
39193
- properties: "Comma-separated property names",
39300
+ properties: "Comma-separated names from asset properties; id maps to asset_id",
39194
39301
  "use-readable-name": "true|false; API default true",
39195
39302
  "max-chunk-file-size": "5242880-104857600 bytes; API default 20971520",
39196
39303
  sort: "property:asc|desc",
@@ -39281,7 +39388,7 @@ var tenable_axi_default = {
39281
39388
  full: "Full output; default false",
39282
39389
  help: "Show help",
39283
39390
  "body-file": "Optional strict query/filters JSON file, '-' for stdin; maximum 1 MiB",
39284
- properties: "Comma-separated property names",
39391
+ properties: "Comma-separated names from finding properties; id maps to finding_id",
39285
39392
  "use-readable-name": "true|false; API default true",
39286
39393
  "max-chunk-file-size": "5242880-104857600 bytes; API default 20971520",
39287
39394
  sort: "property:asc|desc",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@knowttl/artium-axi",
3
- "version": "0.0.10",
3
+ "version": "0.0.11",
4
4
  "description": "Client CLI and embedded skill for the Artium managed tools server.",
5
5
  "license": "MIT",
6
6
  "type": "module",