Lightyear Integration

Overview

Lightyear.ai is an automated telecom and network procurement platform that helps organizations source, purchase, and manage network services — including internet connectivity, SD-WAN, MPLS, and other telecommunications circuits. For network operations teams, Lightyear.ai serves as the operational platform for procurement and service lifecycle management.

The NetBox Lightyear integration automatically synchronizes your circuit inventory from Lightyear.ai into NetBox, eliminating manual data entry and ensuring your Network Source of Truth stays current with your active services. Without automated synchronization, teams face outdated circuit information, billing discrepancies, and the ongoing overhead of maintaining duplicate records across both platforms.

What Gets Synchronized

• Circuit Types — service categories from your Lightyear inventory
• Providers — telecommunications provider information
• Provider Accounts — provider account numbers linked to circuits
• Circuits — complete circuit inventory including service IDs, status, installation dates, and termination dates

Technical Info

For full details of Lightyear to NetBox object and attribute mappings, please refer to the Technical Info section.

Key Features

• Automated Discovery: Automatically discovers and synchronizes circuit and provider data from Lightyear.ai into NetBox
• Scheduled Synchronization: Keeps NetBox circuit inventory current with your active services managed in Lightyear.ai
• Comprehensive Object Mapping: Maps Lightyear services to NetBox Circuits, Circuit Types, Providers, and Provider Accounts
• NetBox Assurance Integration: Leverages NetBox Assurance for safe data ingestion and deviation management
• Secure Authentication: HMAC-SHA256 signed requests for secure communication with the Lightyear API
• Easy Deployment: Docker-based agents run on a configurable schedule

Integration Architecture

The Lightyear integration is built using the NetBox Labs controller integrations framework, which provides:

• Standardized Integration Pattern: Consistent approach across all controller integrations
• NetBox Assurance Integration: Built-in support for safe data ingestion and deviation management with NetBox Assurance
• Agent Based: Runs as part of the NetBox Discovery agent ecosystem using the Orb Agent Pro image

Compatibility

Supported NetBox Versions

• NetBox Cloud and NetBox Enterprise v4.1 and later with NetBox Assurance

Supported Lightyear API Versions

• This integration is built on the Lightyear Developer API (v1)