Skip to content

FreeRADIUS

Overview

FreeRADIUS is an implementation of RADIUS, a protocol for remote user Authentication, Authorization and Accounting.

In this documentation, you will learn how to collect and send FreeRADIUS logs to Sekoia.io.

Benefit from SEKOIA.IO built-in rules and upgrade FreeRADIUS with the following detection capabilities out-of-the-box.

SEKOIA.IO x FreeRADIUS on ATT&CK Navigator

FreeRADIUS Failed Authentication

A failed authentication was logged by FreeRADIUS

  • Effort: advanced
RYUK Ransomeware - martinstevens Username

Detects user name "martinstevens". Wizard Spider is used to add the user name "martinstevens" to the AD of its victims. It was observed in several campaigns; in 2019 and 2020.

  • Effort: elementary
SEKOIA.IO Intelligence Feed

Detect threats based on indicators of compromise (IOCs) collected by SEKOIA's Threat and Detection Research team.

  • Effort: elementary

Event Categories

The following table lists the data source offered by this integration.

Data Source Description
Authentication logs FreeRADIUS provides authentication and access logs

In details, the following table denotes the type of events produced by this integration.

Name Values
Kind event
Category authentication
Type info

Event Samples

Find below few samples of events and how they are normalized by Sekoia.io.

{
    "message": "(548804) Invalid user (Rejected: User-Name contains whitespace): [john.doe@example.org ] (from client WLAN port 9815 cli 00-11-22-33-44-55)",
    "event": {
        "kind": "event",
        "category": [
            "authentication"
        ],
        "type": [
            "info"
        ],
        "dataset": "freeradius.authentication",
        "reason": "Rejected: User-Name contains whitespace"
    },
    "user": {
        "email": "john.doe@example.org ",
        "name": "john.doe",
        "domain": "example.org "
    },
    "network": {
        "name": "WLAN"
    },
    "source": {
        "port": 9815,
        "mac": "00-11-22-33-44-55"
    },
    "freeradius": {
        "outcome": "Invalid user"
    },
    "related": {
        "user": [
            "john.doe"
        ]
    }
}
{
    "message": "(29512) Login incorrect (No Auth-Type found: rejecting the user via Post-Auth-Type = Reject): [test] (from client LAN port 0)",
    "event": {
        "kind": "event",
        "category": [
            "authentication"
        ],
        "type": [
            "info"
        ],
        "dataset": "freeradius.authentication",
        "reason": "No Auth-Type found: rejecting the user via Post-Auth-Type = Reject"
    },
    "user": {
        "name": "test"
    },
    "network": {
        "name": "LAN"
    },
    "source": {
        "port": 0
    },
    "freeradius": {
        "outcome": "Login incorrect"
    },
    "related": {
        "user": [
            "test"
        ]
    }
}
{
    "message": "(549077) Login OK: [host/hostname.example.org] (from client WLAN port 9815 cli 00-11-22-33-44-55)",
    "event": {
        "kind": "event",
        "category": [
            "authentication"
        ],
        "type": [
            "info"
        ],
        "dataset": "freeradius.authentication"
    },
    "network": {
        "name": "WLAN"
    },
    "source": {
        "port": 9815,
        "mac": "00-11-22-33-44-55",
        "domain": "hostname.example.org",
        "address": "hostname.example.org",
        "top_level_domain": "org",
        "subdomain": "hostname",
        "registered_domain": "example.org"
    },
    "freeradius": {
        "outcome": "Login OK"
    },
    "related": {
        "hosts": [
            "hostname.example.org"
        ]
    }
}
{
    "message": "(549117) Login OK: [john.doe@example.org] (from client abcdef port 2010 cli 1.2.3.4 via TLS tunnel)",
    "event": {
        "kind": "event",
        "category": [
            "authentication"
        ],
        "type": [
            "info"
        ],
        "dataset": "freeradius.authentication"
    },
    "user": {
        "email": "john.doe@example.org",
        "name": "john.doe",
        "domain": "example.org"
    },
    "network": {
        "name": "abcdef",
        "protocol": "TLS"
    },
    "source": {
        "port": 2010,
        "ip": "1.2.3.4",
        "address": "1.2.3.4"
    },
    "freeradius": {
        "outcome": "Login OK"
    },
    "related": {
        "ip": [
            "1.2.3.4"
        ],
        "user": [
            "john.doe"
        ]
    }
}
{
    "message": "(29559) Login OK: [nagios_check] (from client abcdef port 0)",
    "event": {
        "kind": "event",
        "category": [
            "authentication"
        ],
        "type": [
            "info"
        ],
        "dataset": "freeradius.authentication"
    },
    "user": {
        "name": "nagios_check"
    },
    "network": {
        "name": "abcdef"
    },
    "source": {
        "port": 0
    },
    "freeradius": {
        "outcome": "Login OK"
    },
    "related": {
        "user": [
            "nagios_check"
        ]
    }
}
{
    "message": "(19962164) Login OK: [MYDOM\\UR12345678] (from client test port 8 cli 00-11-22-33-44-55)",
    "event": {
        "kind": "event",
        "category": [
            "authentication"
        ],
        "type": [
            "info"
        ],
        "dataset": "freeradius.authentication"
    },
    "user": {
        "name": "UR12345678",
        "domain": "MYDOM"
    },
    "network": {
        "name": "test"
    },
    "source": {
        "port": 8,
        "mac": "00-11-22-33-44-55"
    },
    "freeradius": {
        "outcome": "Login OK"
    },
    "related": {
        "user": [
            "UR12345678"
        ]
    }
}
{
    "message": "(16634082) Login OK: [host/hostname.test.example.org] (from client test port 8 cli 00-11-22-33-44-55 via TLS tunnel)",
    "event": {
        "kind": "event",
        "category": [
            "authentication"
        ],
        "type": [
            "info"
        ],
        "dataset": "freeradius.authentication"
    },
    "network": {
        "name": "test",
        "protocol": "TLS"
    },
    "source": {
        "port": 8,
        "mac": "00-11-22-33-44-55",
        "domain": "hostname.test.example.org",
        "address": "hostname.test.example.org",
        "top_level_domain": "org",
        "subdomain": "hostname.test",
        "registered_domain": "example.org"
    },
    "freeradius": {
        "outcome": "Login OK"
    },
    "related": {
        "hosts": [
            "hostname.test.example.org"
        ]
    }
}

Extracted Fields

The following table lists the fields that are extracted, normalized under the ECS format, analyzed and indexed by the parser. It should be noted that infered fields are not listed.

Name Type Description
event.category keyword Event category. The second categorization field in the hierarchy.
event.dataset keyword Name of the dataset.
event.kind keyword The kind of the event. The highest categorization field in the hierarchy.
event.reason keyword Reason why this event happened, according to the source
event.type keyword Event type. The third categorization field in the hierarchy.
freeradius.outcome keyword The outcome of the event
network.name keyword Name given by operators to sections of their network.
network.protocol keyword Application protocol name.
source.domain keyword The domain name of the source.
source.ip ip IP address of the source.
source.mac keyword MAC address of the source.
source.port long Port of the source.
user.domain keyword Name of the directory the user is a member of.
user.email keyword User email address.
user.name keyword Short name or login of the user.

Configure

This setup guide will lead you into forwarding FreeRADIUS's logs to Sekoia.io

Prerequisites

An internal syslog concentrator is required to collect and forward events to Sekoia.io.

Create the intake in Sekoia.io

Go to the intake page and create a new intake from the format FreeRADIUS. Copy the intake key.

Forward logs to Sekoia.io

Please consult the Syslog Forwarding documentation to forward these logs to Sekoia.io

Enable Syslog forwarding for FreeRADIUS

On the system hosting the FreeRADIUS:

  1. Edit the file /etc/freeradius/radiusd.conf and update the log section:

    $ vi /etc/freeradius/radiusd.conf
    log {
      destination = syslog
      syslog_facility = local1
      stripped_names = no
      auth = yes
    
      # don't logs password
      auth_badpass = no 
      auth_goodpass = no
    }
    
  2. Forward logs to the concentrator:

    • For Debian-based and RedHat-based linux distribution, edit the file /etc/rsyslog.conf and forward facility local1's logs to our log concentrator:

      $ vi /etc/rsyslog.conf
      # ensure the module imuxsock is not commented, to provide support for local system logging
      module(load="imuxsock")
      
      local1.* @<ip to the concentrator>
      

      Restart the rsyslog service:

      $ systemctl restart rsyslog
      
    • For other linux distributions and BSD systems, edit the file /etc/syslog.conf and forward facility local1's logs to our concentrator:

      $ vi /etc/syslog.conf
      local1.* @<ip to the concentrator>
      

      Restart the syslog service.

Enjoy your events

Go to the events page to watch your incoming events.