Skip to main content

Fix Inventory Core

Fix Inventory Core (fixcore) is the graph persistence and search backend of Fix Inventory. It maintains the graph of resources and provides APIs to update and access them.

Within Fix Inventory Core, there are workflows consisting of steps that result in actions like collect, cleanup or generate_metrics. These actions are received by components like Fix Inventory Worker and Fix Inventory Metrics.

Fix Inventory Core Docker image
somecr.io/someengineering/fixinventorycore:edge

API​

The Fix Inventory Core API is exposed at https://<fixinventory-address>:8900/api-doc. You can also access it at https://inventory.fix.security/docs/reference/api.

Fix Inventory Core has two API endpoints to connect to for CLI purposes:

  1. /cli/evaluate
  2. /cli/execute

The /cli/evaluate functinality is used internally on every /cli/execute before the command executes.

Below is a simulation of sending a Fix Inventory Shell search to the API.

We will evaluate the search before executing it for demonstration. We also introduce a search with a typo to show the response if not successful.

Evaluate​

Correct
> echo 'search is("resource") limit 1' | http :8900/cli/evaluate
​HTTP/1.1 200 OK
​Content-Length: 47
​Content-Type: application/json; charset=utf-8
​Date: Wed, 06 Oct 2021 15:13:08 GMT
​Server: Python/3.9 aiohttp/3.7.4.post0

​[
​    {
​        "execute_query": "is(\"resource\") limit 1"
​    }
​]
Typo
> echo 'graph=resoto search is("resource") limit1' | http :8900/cli/evaluate
​HTTP/1.1 400 Bad Request
​Content-Length: 151
​Content-Type: text/plain; charset=utf-8
​Date: Wed, 06 Oct 2021 15:13:33 GMT
​Server: Python/3.9 aiohttp/3.7.4.post0

​Error: ParseError
​Message: expected one of '!=', '!~', '<', '<=', '=', '==', '=~', '>', '>=', '[A-Za-z][A-Za-z0-9_]*', '`', 'in', 'not in', '~' at 0:21

Execute​

Correct
> echo 'graph=resoto search is("resource") limit 1' | http :8900/cli/execute
​HTTP/1.1 200 OK
​Content-Type: application/json
​Date: Wed, 06 Oct 2021 15:08:10 GMT
​Server: Python/3.9 aiohttp/3.7.4.post0
​Transfer-Encoding: chunked

​[
​    {
​        "id": "06ee67f7c54124c019b80a7f53fa59b231b374fe61f94b91e0c26729440d095c",
​        "kinds": [
​            "base_cloud",
​            "cloud",
​            "resource"
​        ],
​        "metadata": {
​            "python_type": "fixinventory.baseresources.Cloud"
​        },
​        "reported": {
​            "ctime": "2021-09-25T23:49:38Z",
​            "id": "gcp",
​            "kind": "cloud",
​            "name": "gcp",
​            "tags": {}
​        },
​        "revision": "_d_7eKMa---",
​        "type": "node"
​    }
​]
Typo
> echo 'graph=resoto search is("resource") limit1' | http :8900/cli/execute
​HTTP/1.1 400 Bad Request
​Content-Length: 151
​Content-Type: text/plain; charset=utf-8
​Date: Wed, 06 Oct 2021 15:26:54 GMT
​Server: Python/3.9 aiohttp/3.7.4.post0

​Error: ParseError
​Message: expected one of '!=', '!~', '<', '<=', '=', '==', '=~', '>', '>=', '[A-Za-z][A-Za-z0-9_]*', '`', 'in', 'not in', '~' at 0:21

More API Endpoints

Fix Inventory Core is the central hub for everything Fix Inventory does. You can explore additional API endpoints at https://<fixinventory-address>:8900/api-doc or https://inventory.fix.security/docs/reference/api.