Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
INN-RADIUS.CONF(5)	   InterNetNews Documentation	      INN-RADIUS.CONF(5)

NAME
     inn-radius.conf - Configuration for nnrpd RADIUS authenticator

DESCRIPTION
     This  describes the format and attributes of the configuration file for the
     nnrpd RADIUS authenticator.  See radius(8) for more information  about  the
     authenticator  program.   The  default  location  for  this file is inn-ra-
     dius.conf in pathetc.

     Blank lines and lines beginning with "#" are ignored, as is anything  after
     a	"#"  on a line.  All other lines should begin with a parameter name fol-
     lowed by a colon and the value of that key, except  that  each  section  of
     configuration for a particular server should be enclosed in:

	 server <name> {
	     # parameters...
	 }

     where <name> is just some convenient label for that server.

SERVER GROUP PARAMETERS
     The available parameters are:

     radhost
	 The  hostname of the RADIUS server to use for authentication.	This pa-
	 rameter must be set.

     radport
	 The port to query on the RADIUS server.  Defaults to 1645 if not set.

     lochost
	 The hostname or IP address making the request.  The RADIUS  server  ex-
	 pects	an  IP address; a hostname will be translated into an IP address
	 with gethostbyname().	If not given, this information isn't included in
	 the request (not all RADIUS setups require this information).

     locport
	 The port the client being  authenticated  is  connecting  to.	 If  not
	 given, defaults to 119.  This doesn't need to be set unless readers are
	 connecting to a non-standard port.

     secret
	 The  shared  secret  with  the  RADIUS server.  If your secret includes
	 spaces, tabs, or "#", be sure to include it in double quotes.	This pa-
	 rameter must be set.

     prefix
	 Prepend the value of this parameter to  all  usernames  before  passing
	 them  to  the	RADIUS	server.   Can  be used to prepend something like
	 "news-" to all usernames in order to put news users  into  a  different
	 namespace  from  other accounts served by the same server.  If not set,
	 nothing is prepended.

     suffix
	 Append the value of this parameter to all usernames before passing them
	 to the RADIUS server.	This is often something like "@example.com", de-
	 pending on how your RADIUS server is set up.  If not  set,  nothing  is
	 appended.

     ignore-source
	 Can  be  set to "true", "yes", "on", "false", "no" or "off".  If set to
	 false, the RADIUS authenticator will check to ensure that the	response
	 it  receives is from the same IP address as it sent the request to (for
	 some added security).	If set to true, it will skip  this  verification
	 check	(if your RADIUS server has multiple IP addresses or if other odd
	 things are going on, it may be perfectly normal  for  the  response  to
	 come from a different IP address).

EXAMPLE
     Here is a configuration for a news server named news.example.com, authenti-
     cating users against radius.example.com and appending "@example.com" to all
     client-supplied usernames before passing them to the RADIUS server:

	 server example {
	     radhost: radius.example.com
	     lochost: news.example.com
	     secret: IamARADIUSsecRET
	     suffix: @example.com
	 }

     The shared secret with the RADIUS server is "IamARADIUSsecRET".

HISTORY
     This  documentation  was written by Russ Allbery <eagle@eyrie.org> based on
     the comments in the sample inn-radius.conf file by Yury B. Razbegin.

SEE ALSO
     radius(8).

INN 2.8.0			   2024-02-11		      INN-RADIUS.CONF(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=inn-radius.conf&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>

home | help