NAME
Parse::IASLog - A parser for Microsoft IAS-formatted log entries.
VERSION
version 1.14
SYNOPSIS
Function Interface:
use strict;
use Data::Dumper;
use Parse::IASLog;
while (<>) {
chomp;
my $record = parse_ias( $_, enumerate => 0 );
next unless $record;
print Dumper( $record );
}
Object Interface:
use strict;
use Data::Dumper;
use Parse::IASLog;
my $ias = Parse::IASLog->new( enumerate => 0 );
while (<>) {
chomp;
my $record = $ias->parse( $_ );
next unless $record;
print Dumper( $record );
}
DESCRIPTION
Parse::IASLog provides a convenient way of parsing lines of text that are formatted in Microsoft Internet Authentication Service (IAS) log format, where attributes are logged as attribute-value pairs.
The parser takes lines of IAS-formatted text and returns on successful parsing a hashref record containing the applicable RADIUS attributes and values.
The module provides a perl implementation of the Iasparse
tool.
FUNCTION INTERFACE
Using the module automagically imports 'parse_ias' into your namespace.
parse_ias
-
Takes a string of IAS-formatted text as the first parameter. Subsequent parameter pairs are treated as options. See new() for full details regarding optional parameters. Returns a hashref on success or undef on failure. See below for the format of the hashref returned.
OBJECT INTERFACE
CONSTRUCTOR
new
-
Creates a new Parse::IASLog object. Takes one optional parameter:
'enumerate', set to a false value to disable the enumeration of known attribute values, default is 1;
METHODS
parse
-
Takes a string of IAS-formatted text. Returns a hashref on success or undef on failure.
The hashref will contain RADIUS attributes as keys. The following
header
attributes should always be present:'NAS-IP-Address', The IP address of the NAS sending the request; 'User-Name', The user name that is requesting access; 'Record-Date', The date that the log was written; 'Record-Time', The time that the log was written; 'Service-Name', The name of the service that is running in the RADIUS server; 'Computer-Name', The name of the RADIUS server;
SEE ALSO
http://technet.microsoft.com/en-us/network/bb643123.aspx
http://en.wikipedia.org/wiki/RADIUS
AUTHOR
Chris Williams
COPYRIGHT AND LICENSE
This software is copyright (c) 2017 by Chris Williams.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.