wlan-docs/configuration-examples/radius-authenticated-ssid

description

description
OpenWiFi 2.0

RADIUS Authenticated SSID

When authenticating clients with back office RADIUS systems, the configuration of OpenWiFi permits this on a per SSID basis.

{% tabs %} {% tab title="Simple RADIUS" %}

    "interfaces": [
        {
            "name": "WAN",
            "role": "upstream",
            "ethernet": [
                {
                    "select-ports": [
                        "WAN*"
                    ]
                }
            ],
            "ipv4": {
                "addressing": "dynamic"
            },
            "ssids": [
                {
                    "name": "OpenWifi",
                    "wifi-bands": [
                        "5G"
                    ],
                    "bss-mode": "ap",
                    "encryption": {
                        "proto": "wpa2",
                        "ieee80211w": "optional"
                    },
                    "radius": {
                        "authentication": {
                            "host": "192.168.178.192",
                            "port": 1812,
                            "secret": "secret"
                        },
                        "accounting": {
                            "host": "192.168.178.192",
                            "port": 1813,
                            "secret": "secret"
                        }
                    }
                }
            ]
        },

{% endtab %}

{% tab title="EAP-Local SSID" %}

            "ssids": [
                {
                    "name": "OpenWifi",
                    "wifi-bands": [
                        "2G"
                    ],
                    "bss-mode": "ap",
                    "encryption": {
                        "proto": "wpa2",
                        "ieee80211w": "optional"
                    },
                    "certificates": {
                        "ca-certificate": "/etc/ucentral/cas.pem",
                        "certificate": "/etc/ucentral/cert.pem",
                        "private-key": "/etc/ucentral/key.pem"
                    },
                    "radius": {
                        "local": {
                            "server-identity": "OpenWiFi-Local-EAP",
                            "users": [
                                {
                                    "user-name": "open",
                                    "password": "wifi"
                                }
                            ]
                        }
                    }
                }
            ]
        },

{% endtab %} {% endtabs %}

Many parameters are possible with RADIUS authentications given the many methods in use worldwide. Many of the EAP methods have configuration options described below.

RADIUS Attribute	Description
nas-identifier	Unique NAS Id used with RADIUS server
chargeable-user-id	Chargeable User Entity per RFC4372
local	Local RADIUS within AP device server-identity users - Local EAP users based on username, PreShared Key and VLAN id
authentication	RADIUS server host IP address port ( example 1812) secret ( Shared secret with RADIUS server ) Additional methods within Access-Request request-attribute ( id of RADIUS server ) id ( numeric value of RADIUS server ) value Any sub-value defined as integer RADIUS attribute value
accounting	RADIUS server host IP address port ( example 1813) secret ( Shared secret with RADIUS server ) Additional methods within Access-Request sent in Accounting request-attribute ( id of RADIUS server ) id ( numeric value of RADIUS server ) value Any sub-value defined as integer RADIUS attribute value
accounting	interval ( Interim accounting interval defined in seconds )