Skip to content

RADIUS operations guide

FreeRADIUS management for ISP operations.

A practical framework for connecting an open-source RADIUS server to the subscriber, policy, billing and support workflows that keep an ISP running.

Overview

FreeRADIUS is a widely used open-source RADIUS server. It can receive access requests, apply configured authorization logic and record accounting data. Those functions are essential, but they do not by themselves create a complete subscriber-management workflow.

An ISP still needs a reliable way to connect identity, package, billing state, network policy, sessions and support history. The operating model matters as much as the daemon: teams need to know which system owns each field, how changes reach the network and how an access decision can be explained later.

01

Separate the RADIUS engine from the operating workflow.

The RADIUS server answers authentication and authorization requests according to its configuration and records accounting messages sent by network access servers. An ISP management platform sits around that exchange: it gives teams a controlled way to create subscribers, assign plans, manage billing state and understand sessions.

Treating these as separate layers makes ownership clearer. Network engineers can protect the access design while customer-care and finance teams use purpose-built workflows instead of editing RADIUS records directly.

  • RADIUS layer: authentication, authorization and accounting exchanges
  • Operations layer: subscribers, packages, billing, payments and support
  • Network layer: NAS or BNG devices, addressing and service enforcement
02

Define one owner for every important subscriber field.

Duplicate sources of truth are a common cause of access errors. Decide where usernames, credentials, service plans, renewal dates, address assignments and status changes originate. Then document how those values are represented in RADIUS policy and on the access infrastructure.

The result should be traceable in both directions: an operator should be able to start with a subscriber and see the applicable service, or start with a session and identify the account and policy behind it.

  • Identity and authentication method
  • Package, rate policy and renewal state
  • NAS, zone, IP allocation and active-session context
03

Make accounting data operationally useful.

Accounting records become valuable when teams can relate them to a person, plan and network device. Start, interim and stop messages may support session visibility, usage reporting and incident review, but only when NAS clocks, identifiers and update intervals are consistent.

Design for imperfect conditions as well. Duplicate records, a missing stop message or a restarted NAS should not leave the team with an unexplained subscriber state.

  • Keep time synchronization consistent across RADIUS and NAS systems
  • Choose an interim accounting interval appropriate to the operation
  • Reconcile stale or incomplete sessions through a documented process
04

Validate compatibility before changing production access.

FreeRADIUS installations vary. Modules, SQL schemas, custom policies, vendor dictionaries and external integrations can materially change the work required. Inventory the current design before assuming that a management platform can be connected without mapping or migration.

Use a test NAS and representative subscriber cases first. Confirm successful and rejected authentication, returned authorization attributes, accounting, renewal changes and failure recovery before moving a production group.

  • Document the current FreeRADIUS version, modules and custom policy
  • List every NAS or BNG vendor, model and service type
  • Test a rollback path and retain configuration backups
05

Evaluate the management layer against daily work.

A useful interface is not enough. Evaluate how the platform handles the full path from subscriber creation through activation, payment, renewal, support and eventual disconnection. Ask who can change policy, how actions are logged and what happens when a dependency is unavailable.

PHP Radius provides a connected operating layer for RADIUS AAA, subscribers, billing and network context. If FreeRADIUS is already part of your environment, the PHP Radius team should validate integration or migration requirements against the actual configuration before deployment.

  • Role-based access and an auditable change history
  • Clear behavior for billing, renewal and access-state changes
  • Session visibility that support and NOC teams can both use

Primary references

Continue with the protocol and vendor documentation.

Use before scoping or rollout

FreeRADIUS management evaluation checklist

  1. Inventory RADIUS policies, data stores, dictionaries and integrations.
  2. Map subscriber, plan, billing and access fields to a clear system of record.
  3. Confirm NAS compatibility and the required authorization attributes.
  4. Test authentication, rejection, accounting and recovery scenarios.
  5. Document migration stages, backups, rollback and ownership.

Turn planning into a working flow

Review this checklist against your ISP environment.

Share the network, device and subscriber context behind your project. We’ll focus the PHP Radius demonstration on the workflows that need validation.