Skip to content

Centra v4 api now uses Centra asset ID for unique ID. README contains information on how agent ID is created/updated #37

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
MaxBish merged 4 commits into from
May 12, 2026
Merged

Centra v4 api now uses Centra asset ID for unique ID. README contains information on how agent ID is created/updated #37

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
c1866ef
Adjusted centra_v4_api script to use asset ID as a unique identifier …
TechnoSavage Mar 11, 2026
9ffaf6d
Auto: update integrations JSON and README
github-actions[bot] Mar 11, 2026
e7df249
Merge branch 'main' into update/centra
doug-markiewicz May 12, 2026
8f120a8
Auto: update integrations JSON and README
github-actions[bot] May 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion akamai-guardicore-centra/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,4 +71,12 @@ git clone https://github.com/runZeroInc/runzero-custom-integrations.git
- You will see the task kick off on the [tasks](https://console.runzero.com/tasks) page like any other integration
- The task will update the existing assets with the data pulled from the Custom Integration source
- The task will create new assets for when there are no existing assets that meet merge criteria (hostname, MAC, etc)
- You can search for assets enriched by this custom integration with the runZero search `custom_integration:<INSERT_NAME_HERE>`
- You can search for assets enriched by this custom integration with the runZero search `custom_integration:<INSERT_NAME_HERE>`

**!NOTE!** Centra agent IDs are known to change frequently as the agent ID is determined by several factors such as:
- hostname (minus FQDN)
- BIOS UUID
- product_serial file
- Vendor
- Network interface names and associated hardware addresses (loopbacks, virtual bonding, vlan, excluded interfaces are not considered)
-- Commonly NIC configuration changes are responsible for agent ID changing
2 changes: 1 addition & 1 deletion akamai-guardicore-centra/custom-integration-centra-v4-api.star
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ def build_assets(assets, token):
for asset in assets:
agent_info = asset.get('agent', {})
os_info = asset.get('os_info', {})
asset_id = agent_info.get('id', str(new_uuid))
asset_id = str(asset.get('id', str(new_uuid)))
hostname = asset.get('name', '')
os = os_info.get('type', '')
first_seen = asset.get('first_seen', '')
Expand Down
2 changes: 1 addition & 1 deletion docs/integrations.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"lastUpdated": "2026-05-12T15:43:45.544731Z",
"lastUpdated": "2026-05-12T15:50:53.579414Z",
"totalIntegrations": 35,
"integrationDetails": [
{
Expand Down