release version 1.2.1-SNAPSHOT

Change-Id: If080babdf6011608ad4191ea7314a89fd8d11470
1 file changed
tree: 625f38817ed770767547e5d37e0d8b9623a74468
  1. .gitignore
  2. LICENSE.txt
  4. pom.xml
  5. src/

ONOS AAA Application

The ONOS AAA application behaves as a NAS Server and does RADIUS authentication of the ports. It maintains state machines for each of the ports from which it receives EAP Start messages to maintain the current status of the authentication procedure.


 "" : {
      "AAA" : {
         "nasIp": "",
         "nasMac" : "00:1b:22:34:55:78",
         "radiusSecret": "testing123",
         "radiusIp": "",
         "radiusServerPort" : "1812",
         "radiusMac" : "00:1e:67:d2:ee:f7",
         "vlanId" : "4000",
         "radiusConnectionType" : "socket",
         "radiusServerConnectPoints": [ "of:00000000000000b2/2" ],
         "packetCustomizer" : "sample"

Configuration Parameters


IP Address of the NAS which is requesting authentication of the user


MAC Address of the NAS which is requesting authentication of the user (Used only when radiusConnectionType is port)


Shared secret


IP Address of the RADIUS Server


UDP Port Number on which RADIUS Server is listening


MAC address of the RADIUS server or next hop router (Used only when radiusConnectionType is port)


VLAN on which the RADIUS Server is available (Used only when radiusConnectionType is port)


There are two options for communication with the Radius Server

  • "socket" : Communication using a UDP socket.
  • "port" : Communication using directly the port of the SDN switch connected to the Radius Server.

When port is used, the RADIUS packets sent out would carry the IP and MAC address of the device from which the EAP packets were received. That device should be available in the SubscriberAndDeviceInformationService (Sadis). AAA application fetches data from Sadis based on the serial number of the device.


Connect point of SDN switch through which the RADIUS Server is reachable (Used only when radiusConnectionType is port)


The values of RADIUS attributes expected by the RADIUS Server might be different in different scenarios or in case of different Operators.

As of today AAA App provides two different customizers "default" : When you set the value as this, no customization is done to the RADIUS packets "sample" : This is a sample customization wherein specific RADIUS attributes and filled with values from Sadis Service. The src MAC and src IP of the RADIUS messages are set according to the OLT device (from which the EAP Start message is received) configured in Sadis

More customizers might be added to AAA App later which can fill Subscriber specific atrributes into the RADIUS attributes/messages by querying data from Sadis. The key to get data from Sadis is the PortName of the Port from which EAP messages are received.