pyrad 0.8 - native python RADIUS implementation

28 Aug 2004

      pyrad is an implementation of a RADIUS client and server as described in
RFC2865, 2866, and others. It takes care of all the details like
building RADIUS packets, sending and receiving them, and en-/decoding
responses. (RADIUS is a common protocol used for authentication,
authorisation and accounting for remote access (and similar) services).

Changes since previous release
------------------------------

* Fix time-handling in the client packet sending code: it would loop
  forever since the now time was updated at the wrong moment. Fix from
  Michael Mitchell.
* Fix passing of dict parameter when creating reply packets

Example
-------

Here is an example of doing a authentication request:

  import pyrad.packet
  from pyrad.client import Client
  from pyrad.dictionary import Dictionary

  srv=Client(server="radius.my.domain", secret="s3cr3t",
        dict=Dictionary("dicts/dictionary", "dictionary.acc"))

  req=srv.CreateAuthPacket(code=pyrad.packet.AccessRequest,
                User_Name="wichert", NAS_Identifier="localhost")
  req["User-Password"]=req.PwCrypt("password")

  reply=srv.SendPacket(req)
  if reply.code==pyrad.packet.AccessAccept:
      print "access accepted"
  else:
      print "access denied"

  print "Attributes returned by server:"
  for i in reply.keys():
      print "%s: %s" % (i, reply[i])

And an example for a trivial RADIUS server:

  from pyrad import dictionary, packet, server

  class FakeServer(server.Server):
      def _HandleAuthPacket(self, fd, pkt):
          server.Server._HandleAuthPacket(self, fd, pkt)

          reply=self.CreateReplyPacket(pkt)
          reply.code=packet.AccessAccept
          self.SendReplyPacket(fd, reply)

  srv=FakeServer(dict=dictionary.Dictionary("dictionary"))
  srv.hosts["127.0.0.1"]=server.RemoteHost("127.0.0.1", "s3cr3t", "localhost")
  srv.BindToAddress("")
  srv.Run()

Requirements
------------

pyrad requires Python 2.2 or later.

Author, copyright, availability
-------------------------------

pyrad was written by Wichert Akkerman <wichert@wiggy.net>

The current version and documentation can be found at its homepage:

  http://www.wiggy.net/code/pyrad/

-- 
Wichert Akkerman <wichert@wiggy.net>    It is simple to make things.
http://www.wiggy.net/                   It is hard to make things simple.