Commit cb9e5e28 authored by Stefan Schlesinger's avatar Stefan Schlesinger
Browse files

Adding documentation and make $huntgroup optional

parent 144615af

README.md

+40 −0
Original line number Diff line number Diff line
@@ -266,6 +266,18 @@ freeradius::client { "wlan-controllers": 
}

```



```puppet

# Huntgroup Example

freeradius::client { "asa01":

  ip         => '192.168.0.1',

  secret     => 'testing123',

  huntgroups => [

    { name       => 'firewall',

      conditions => [ 'NAS-IP-Address == 192.168.0.1' ] },

  ]

}

```



##### `ip`

The IP address of the client or range in CIDR format. For IPv6, use `ipv6addr`. `ip` and `ip6` are mutually exclusive but one must be supplied.

Default: `undef`.
@@ -322,6 +334,10 @@ Create a firewall exception for this virtual server. If this is set to `true`, y 
##### `attributes`

Array of attributes to assign to this client. Default: empty.





##### `huntgroups`

Array of hashes, each hash defines one freeradius::huntgroup. Hash keys are all passed to a new instance of freeradius::huntgroup.



#### `freeradius::config`



Install arbitrary config snippets from a flat file. These are installed in `/etc/raddb/conf.d`
@@ -430,6 +446,30 @@ fallback, such as the DEFAULT realm. 
For reasons of stability, this home server SHOULD be a virtual server. Otherwise, the fallback may itself be dead!





#### `freeradius::huntgroup`



Define a huntgroup given a name and the conditions under which a huntgroup matches a client.



```puppet

freeradius::huntgroup { 'switchaccess':

  huntgroup  => 'switchaccess',

  conditions => [

    'NAS-IP-Address == 192.168.0.1'

  ]

}



##### `huntgroup`

Name of the huntgroup to assign, if conditions are all met. Default to the resource title.



##### `conditons`

Array of conditions which are used to match the client, each element should contain a condition in the form of 'Key == Value'.



##### `type`





##### `home_server`





#### `freeradius::instantiate`



Instantiate a module that is not automatically instantiated.

manifests/huntgroup.pp

+1 −1
Original line number Diff line number Diff line 
# Install FreeRADIUS huntgroups

define freeradius::huntgroup (

  $ensure      = present,

  $huntgroup,

  $huntgroup   = $title,

  $conditions  = [],

  $order       = 50,

) {