REST

This section describes the basic configuration needed to configure the REST module to communicate with a REST service.

The REST module was developed to allow business logic to be separated out into a separate discrete service. This reduces the role of FreeRADIUS to a translation daemon, receiving packets from the network and presenting them in JSON or POST format for consumption by the API, then parsing a JSON or POST response, and translating that back into a network packet.

If you will be developing a new REST API to implement business logic for a AAA service, you should follow the guide in this section, and accept and return data in that format the REST module expected.

The REST module can also communicate with arbitrary REST endpoints, and versions ≥ v4.0.x include a JSON module JSON which allows mapping elements of a JSON response to FreeRADIUS.

If you’re attempting to integrate an existing REST API, this section will provide hints on how to accomplish this.