/liongard-environment-summary

description: Generate a detailed summary of a Liongard environment
argument-hint: "<environment>"
arguments: [environment]

Liongard Environment Summary

Generate a comprehensive summary of a specific Liongard environment, including related agents, launchpoints, systems, and recent detections.

Prerequisites

• Valid Liongard API key configured
• Liongard instance name configured
• User must have read permissions
• Environment must exist in Liongard

Steps

1. **Look up environment by ID or name**

• If numeric, fetch directly by ID

   curl -s "https://${LIONGARD_INSTANCE}.app.liongard.com/api/v1/environments/{id}" \
     -H "X-ROAR-API-KEY: ${LIONGARD_API_KEY}" \
     -H "Content-Type: application/json"

• If text, search environments by name

   curl -s "https://${LIONGARD_INSTANCE}.app.liongard.com/api/v1/environments?page=1&pageSize=100" \
     -H "X-ROAR-API-KEY: ${LIONGARD_API_KEY}" \
     -H "Content-Type: application/json"

• Filter results for matching name
• Suggest similar names if no exact match found

2. **Get agents for the environment**

   curl -s "https://${LIONGARD_INSTANCE}.app.liongard.com/api/v1/agents?environmentId={id}" \
     -H "X-ROAR-API-KEY: ${LIONGARD_API_KEY}" \
     -H "Content-Type: application/json"

3. **Get launchpoints for the environment**

   curl -s "https://${LIONGARD_INSTANCE}.app.liongard.com/api/v1/launchpoints?environmentId={id}&page=1&pageSize=500" \
     -H "X-ROAR-API-KEY: ${LIONGARD_API_KEY}" \
     -H "Content-Type: application/json"

4. **Get systems for the environment**

   curl -s "https://${LIONGARD_INSTANCE}.app.liongard.com/api/v1/systems?environmentId={id}&page=1&pageSize=500" \
     -H "X-ROAR-API-KEY: ${LIONGARD_API_KEY}" \
     -H "Content-Type: application/json"

5. **Get recent detections for the environment**

   curl -s -X POST "https://${LIONGARD_INSTANCE}.app.liongard.com/api/v1/detections" \
     -H "X-ROAR-API-KEY: ${LIONGARD_API_KEY}" \
     -H "Content-Type: application/json" \
     -d '{
       "Pagination": {"Page": 1, "PageSize": 20},
       "conditions": [
         {"path": "EnvironmentID", "op": "eq", "value": <env_id>}
       ],
       "orderBy": [{"path": "DetectedOn", "direction": "desc"}]
     }'

6. **Format comprehensive summary with tables**

• Environment details
• Agent status table
• Launchpoint summary with last inspection times
• System count by inspector type
• Recent detections by severity

Parameters

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | environment | string/int | Yes | - | Environment ID or name to summarize |

Examples

By Environment ID

/liongard-environment-summary 1234

By Environment Name

/liongard-environment-summary "Acme Corporation"

Partial Name Match

/liongard-environment-summary "Acme"

Output

Full Summary

================================================================================
Environment Summary: Acme Corporation
================================================================================

BASIC INFORMATION
--------------------------------------------------------------------------------
ID:             1234
Name:           Acme Corporation
Description:    Primary managed services client
Status:         Active
Tier:           Premium
Created:        2023-01-15
Last Updated:   2024-02-15

AGENTS (2)
--------------------------------------------------------------------------------
| ID    | Name              | Status  | Last Seen           |
|-------|-------------------|---------|---------------------|
| 501   | ACME-AGENT-01     | Online  | 2024-02-15 14:30:00 |
| 502   | ACME-AGENT-02     | Online  | 2024-02-15 14:28:00 |

Online: 2 | Offline: 0

LAUNCHPOINTS (15)
--------------------------------------------------------------------------------
| ID    | Inspector            | Status  | Last Inspection     | Schedule    |
|-------|----------------------|---------|---------------------|-------------|
| 5001  | Active Directory     | Active  | 2024-02-15 02:15:00 | Daily 2 AM  |
| 5002  | Microsoft 365        | Active  | 2024-02-15 03:00:00 | Daily 3 AM  |
| 5003  | Cisco Meraki         | Active  | 2024-02-15 04:00:00 | Daily 4 AM  |
| 5004  | VMware vSphere       | Active  | 2024-02-15 02:30:00 | Daily 2:30  |
| 5005  | Datto BCDR           | Active  | 2024-02-15 05:00:00 | Daily 5 AM  |
| 5006  | SonicWall            | Active  | 2024-02-15 04:30:00 | Daily 4:30  |
| 5007  | DNS Records          | Active  | 2024-02-12 02:00:00 | Weekly Sun  |
| 5008  | SSL Certificates     | Active  | 2024-02-12 03:00:00 | Weekly Sun  |
| ...   | (7 more)             |         |                     |             |

Active: 14 | Inactive: 1 | Error: 0

SYSTEMS BY INSPECTOR (47)
--------------------------------------------------------------------------------
| Inspector            | System Count | Last Inspection     |
|----------------------|--------------|---------------------|
| Active Directory     | 8            | 2024-02-15 02:15:00 |
| Microsoft 365        | 12           | 2024-02-15 03:00:00 |
| Cisco Meraki         | 6            | 2024-02-15 04:00:00 |
| VMware vSphere       | 10           | 2024-02-15 02:30:00 |
| Datto BCDR           | 3            | 2024-02-15 05:00:00 |
| SonicWall            | 2            | 2024-02-15 04:30:00 |
| DNS Records          | 4            | 2024-02-12 02:00:00 |
| SSL Certificates     | 2            | 2024-02-12 03:00:00 |

Total Systems: 47

RECENT DETECTIONS (Last 30 Days)
--------------------------------------------------------------------------------
| Date       | Severity | System            | Summary                          |
|------------|----------|-------------------|----------------------------------|
| 2024-02-15 | High     | DC01.acme.local   | Password policy length