AMIGOPOD PowerConnect W Clearpass 100 Software User manual

Adding IP Addresses to
Visitor Accounts
amigopod TechNote
Revision
Date
1.0
20 January 2009
Copyright © 2009 amigopod Pty Ltd
amigopod Head O ice
amigopod Pty Ltd
Suite 101
349 Paci ic Hwy
North Sydney, NSW 2060
Australia
ABN 74 124 753 420
Web
www.amigopod.com
Phone
[phone]
Fax
[phone]

Adding IP Addresses to Visitor Accounts Version 1.0
CONFIDENTIAL
2
Table of Contents
Overview ...............................................................................................................................3
About this Technical Note ..................................................................................................3
Requirements ....................................................................................................................3
Form Customization...........................................................................................................3
Create Account orm ......................................................................................................3
Edit Account orm...........................................................................................................4
View Customization ...........................................................................................................4
Print Template Customization............................................................................................5
Role Customization............................................................................................................6
RADIUS Test .....................................................................................................................7

Adding IP Addresses to Visitor Accounts Version 1.0
CONFIDENTIAL
3
Overview
About this Technical Note
This technical note describes how to con igure the amigopod Visitor
Management Appliance to store a con igurable IP address with user
accounts, and to return those IP addresses in RADIUS Access-Accept
messages.
This con iguration demonstrates:
 Customizing orms and views to collect additional data to store
with a visitor account
 Collecting data or a speci ic ield only when a certain role is
selected
 Adding new ields to the print receipt generated or a visitor
 Adding new RADIUS attributes as part o a role de inition
 Obtaining the value o a RADIUS attribute rom a visitor account
ield
equirements
amigopod RADIUS Services version 1.2.15 or later is required.
Administrator access to the amigopod user inter ace is required.
Form Customization
Create Account form
The irst step involves adding a ield to the Create Account orm to store the
IP address.
 Navigate to Guest Manager, Customization, Customize Forms
& Views
 Select the create_user orm and click Edit Fields
 Select the role_id entry in the table, and click Insert A ter
 Use the ollowing settings to add a new ield to the orm:
o Field Name: ip_address (This is a standard ield and does
not need to be created)
o Field: [x] Enable this ield
o Rank: 72
o Label: IP Address:
o Description: IP address to assign or this user.

Adding IP Addresses to Visitor Accounts Version 1.0
CONFIDENTIAL
4
o CSS Style: width:240px;
o Validator: IsValidIpAddr
o Validation Error: Please enter a valid IP address.
o Advanced: [x] Show advanced properties
o Visible I : role_id.value == 1
 Click Save Changes
 With these settings, the IP Address ield will only be shown when
the ‘Contractor’ role is selected (i.e. role_id == 1).
o To display the IP address or all roles, leave the “Visible I ”
ield blank.
This will result in a Create Account orm similar to the ollowing:
Edit Account form
To allow the entered IP address to be edited, repeat the above orm
customization step or the guest_edit orm.
View Customization
When managing accounts, it is use ul to be able to view the IP addresses that
have already been assigned to visitor accounts. To do this requires editing
the view that displays the visitor accounts.
 Navigate to Guest Manager, Customization, Customize Forms
& Views
 Select the guest_users view and click Edit Fields

Adding IP Addresses to Visitor Accounts Version 1.0
CONFIDENTIAL
5
 Select the role_name entry in the table, and click Insert A ter
 Select the ip_address ield, and keep the remaining settings as
de aults.
 Click Save Changes
This will result in a List Accounts view similar to the ollowing:
Print Template Customization
A ter creating a new visitor account with an assigned IP address, the IP
address can also be included on the visitor’s printed receipt.
To do this, the print template HTML must be modi ied to include the IP
address in ormation i available.
 Navigate to Guest Manager, Print Templates
 Select the GuestManager Receipt template and click Edit
 At a suitable point in the User Account HTML ( or example, a ter
the role name), add the ollowing HTML code:
{if $u.ip_address}
<tr>
<th class="nwaLeft">IP address</th>
<td class="nwaBod ">{$u.ip_address}</td>
</tr>
{/if}
 The above code is shown highlighted in the ollowing screenshot.

Adding IP Addresses to Visitor Accounts Version 1.0
CONFIDENTIAL
6
 Click Update Template
This will result in a print template that looks similar to the ollowing:
ole Customization
Now that IP address in ormation can be entered, edited and printed out or
visitors, the role needs to be updated to use this IP address.
 Navigate to RADIUS Services, User Roles
 Select the Contractor role and click Edit
 Click the Add Attribute tab
 Select the standard RADIUS attribute Framed-IP-Address
 Enter the value as <?= $user['ip_address']

Adding IP Addresses to Visitor Accounts Version 1.0
CONFIDENTIAL
7
o This will return the contents o the user’s ip_address ield
as the value o the Framed-IP-Address attribute when a
RADIUS authentication request is received.
 Click Add Attribute
 Select the standard RADIUS attribute Framed-IP-Netmask
 Enter the value as 255.255.0.0
 Click Add Attribute
 The role editor should now look similar to the ollowing:
 Click Save Changes to update the role with the new attributes
In this example, only the Contractor role has IP addresses assigned. To
include the Framed-IP-Address and Framed-IP-Netmask attributes in other
roles, repeat the above changes or the other roles.
ADIUS Test
Using a RADIUS test client, the above changes can now be veri ied.

Adding IP Addresses to Visitor Accounts Version 1.0
CONFIDENTIAL
8