H3C Access Controllers
Local Portal Authentication Through the LDAP Server
Configuration Examples

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Contents

Introduction· 1

Prerequisites· 1

Example: Configuring local portal authentication through the LDAP server 1

Network configuration· 1

Restrictions and guidelines· 2

Procedures· 2

Configuring the AC· 2

Configuring the switch· 4

Configuring the LDAP server 5

Verifying the configuration· 8

Configuration files· 8

Related documentation· 10

 

Introduction

The following information provides an example of configuring the local portal service on the AC to send wireless user information to the LDAP server for authentication.

Prerequisites

The following information applies to Comware-based access controllers and access points. Procedures and information in the examples might be slightly different depending on the software or hardware version of the access controllers and access points.

The configuration examples were created and verified in a lab environment, and all the devices were started with the factory default configuration. When you are working on a live network, make sure you understand the potential impact of every command on your network.

The following information is provided based on the assumption that you have basic knowledge of AAA, portal, and WLAN.

Example: Configuring local portal authentication through the LDAP server

Network configuration

As shown in Figure 1, the AP and the client obtain IP addresses from the DHCP server.

Configuration requirements are as follows:

·     Configure the local portal service on the AC to provide authentication pages for clients.

·     Use the LDAP server to authenticate the clients.

Figure 1 Network diagram

 

Restrictions and guidelines

Configure routing to make sure the devices can reach one another.

Use the serial ID labeled on the AP's rear panel to specify an AP.

Edit the authentication pages, compress them to a .zip file (this example uses abc.zip), and then upload the file to the root directory of the storage medium of the AC. On the AC, you must specify this file as the default authentication page file.

To change the default authentication page file, you must first execute the undo default-logon-page command, and then specify a new default authentication page file.

Procedures

Configuring the AC

1.     Configuring VLANs and interfaces:

# Create VLAN 100 and VLAN-interface 100. Assign the VLAN interface an IP address. The AC will use this IP address to establish a CAPWAP tunnel with the AP.

<AC> system-view

[AC] vlan 100

[AC-vlan100] quit

[AC] interface vlan-interface 100

[AC-Vlan-interface100] ip address 2.2.1.1 24

[AC-Vlan-interface100] quit

# Create VLAN 200 and VLAN-interface 200. Assign the VLAN interface an IP address. This VLAN will be used for wireless client access.

[AC] vlan 200

[AC-vlan200] quit

[AC] interface vlan-interface 200

[AC-Vlan-interface200] ip address 2.2.2.1 24

[AC-Vlan-interface200] quit

# Configure GigabitEthernet 1/0/1 (the port connected to the switch) as a trunk port. Assign the port to VLAN 100 and VLAN 200.

[AC] interface gigabitethernet 1/0/1

[AC-GigabitEthernet1/0/1] port link-type trunk

[AC-GigabitEthernet1/0/1] port trunk permit vlan 100 200

[AC-GigabitEthernet1/0/1] quit

2.     Configure the LDAP scheme:

 # Create an LDAP server named ldap and enter its view.

[AC] ldap server ldap

# Specify the administrator DN.

[AC-ldap-server-ldap] login-dn cn=administrator,cn=users,dc=ldap,dc=com

# Specify the base DN for user search.

[AC-ldap-server-ldap] search-base-dn dc=ldap,dc=com

# Specify the IP address of the LDAP server.

[AC-ldap-server-ldap] ip 192.168.0.112

# Specify the administrator password.

[AC-ldap-server-ldap] login-password simple 123456

[AC-ldap-server-ldap] quit

# Create an LDAP scheme named ldap and enter its view.

[AC] ldap scheme ldap

# Specify ldap as the LDAP authentication server.

[AC-ldap-ldap] authentication-server ldap

[AC-ldap-ldap] quit

# Create an ISP domain named ldap and enter its view.

[AC] domain ldap

# Configure the authentication method as LDAP and the authentication and accounting methods as none for portal users in ISP domain ldap.

[AC-isp-ldap]authentication portal ldap-scheme ldap

[AC-isp-ldap] authorization portal none

[AC-isp-ldap] accounting portal none

# Configure the idle cut feature for users in ISP domain ldap. Log out a user if the user's traffic is less than 1024 bytes in 15 minutes.

[AC-isp-ldap] authorization-attribute idle-cut 15 1024

[AC-isp-ldap] quit

3.     Configure portal authentication:

# Create a portal Web server named newpt and specify http://2.2.2.1/portal as the server's URL.

[AC] portal web-server newpt

[AC-portal-websvr-newpt] url http://2.2.2.1/portal

[AC-portal-websvr-newpt] quit

# Create an HTTP-based local portal Web service.

[AC] portal local-web-server http

# Specify file abc.zip as the default authentication page file. (The file must already exist in the root directory of the storage medium of the AC.)

[AC–portal-local-websvr-http] default-logon-page abc.zip

[AC–portal-local-websvr-http] quit

# Configure two destination-based portal-free rules to permit the traffic destined for the DNS server.

[AC] portal free-rule 1 destination ip any udp 53

[AC] portal free-rule 2 destination ip any tcp 53

4.     Configure the wireless service:

# Create a service template named st1 and enter its view.

[AC] wlan service-template st1

# Set the SSID of the service template to service.

[AC-wlan-st-st1] ssid service

# Assign clients coming online through the service template to VLAN 200.

[AC-wlan-st-st1] vlan 200

# Enable direct portal authentication on the service template.

[AC-wlan-st-st1] portal enable method direct

# Specify ISP domain ldap as the portal authentication domain.

[AC-wlan-st-st1] portal domain ldap

# Specify portal Web server newpt on the service template.

[AC-wlan-st-st1] portal apply web-server newpt

# Configure the AC to forward client data traffic. (Skip this step if the client data traffic forwarder is the AC by default.)

[AC–wlan-st-st1] client forwarding-location ac

# Specify the AKM mode as PSK, and configure the preshared key as 12345678 in plain text.

[AC-wlan-st-st1] akm mode psk

[AC-wlan-st-st1] preshared-key pass-phrase simple 12345678

# Specify the cipher suite as CCMP and the security IE as RSN.

[AC-wlan-st-st1] cipher-suite ccmp

[AC-wlan-st-st1] security-ie rsn

# Enable the service template.

[AC-wlan-st-st1] service-template enable

[AC-wlan-st-st1] quit

5.     Configure the AP:

 

NOTE: In large-scale networks, configure AP groups instead of single APs as a best practice.

 

# Create an AP named ap1 with model WA6320, and specify the AP model and serial ID.

[AC] wlan ap ap1 model WA6320

[AC-wlan-ap-ap1] serial-id 219801A28N819CE0002T

# Create AP group group1 and add AP ap1 to AP group group1.

[AC] wlan ap-group group1

[AC-wlan-ap-group-group1] ap ap1

# Bind service template st1 to radio 2 in AP group group1.

[AC-wlan-ap-group-group1] ap-model WA6320

[AC-wlan-ap-group-group1-ap-model-WA6320] radio 2

[AC-wlan-ap-group-group1-ap-model-WA6320-radio-2] service-template st1

# Enable radio 2.

[AC-wlan-ap-group-group1-ap-model-WA6320-radio-2] radio enable

[AC-wlan-ap-group-group1-ap-model-WA6320-radio-2] return

Configuring the switch

# Create VLAN 100. The switch will use this VLAN to forward traffic on the CAPWAP tunnel between the AC and AP.

<Switch> system-view

[Switch] vlan 100

[Switch-vlan100] quit

# Create VLAN 200. The switch will use this VLAN to forward traffic of wireless clients.

[Switch] vlan 200

[Switch-vlan200] quit

# Create VLAN 2. The switch will use this VLAN to connect to the LDAP server。

[Switch] vlan 2

[Switch-vlan2] quit

# Configure the interface between the switch and LDAP to join VLAN 2（Omitted here）

# Assign the VLAN interface an IP address。

[Switch] interface vlan-interface 2

[Switch-Vlan-interface2] ip address 192.168.0.2 255.255.255.0

[Switch-Vlan-interface2] quit

# Configure GigabitEthernet 1/0/1 (the port connected to the AC) as a trunk port. Assign the trunk port to VLAN 100 and VLAN 200.

[Switch] interface gigabitethernet1/0/1

[Switch-GigabitEthernet1/0/1] port link-type trunk

[Switch-GigabitEthernet1/0/1] port trunk permit vlan 100 200

[Switch-GigabitEthernet1/0/1] quit

# Configure GigabitEthernet 1/0/2 (the port connected to the AP) as an access port. Assign the access port to VLAN 100.

[Switch] interface gigabitethernet1/0/2

[Switch-GigabitEthernet1/0/2] port link-type access

[Switch-GigabitEthernet1/0/2] port access vlan 100

# Enable PoE on the access port.

[Switch-GigabitEthernet1/0/2] poe enable

[Switch-GigabitEthernet1/0/2] quit

Configuring the LDAP server

This example uses Microsoft Windows 2003 Server Active Directory to illustrate the configuration on the LDAP server.

1.     Add a user named aaa.

a.     On the LDAP server, select Start > Control Panel > Administrative Tools.

b.     Double-click Active Directory Users and Computers.

The Active Directory Users and Computers window opens.

c.     From the navigation tree, click Users under the ldap.com node.

d.     Select Action > New > User from the menu to open the dialog box for adding a user.

e.     Enter logon name aaa and click Next.

Figure 2 Adding user aaa

 

f.     In the dialog box, enter password 123456, select options as needed, and click Next.

Figure 3 Setting the user's password

 

g.     Click OK.

2.     Add user aaa to user group Users:

a.     From the navigation tree, click Users under the ldap.com node.

b.     In the right pane, right-click user aaa and select Properties.

c.     In the dialog box, click the Member Of tab and click Add.

Figure 4 Modifying user properties

 

d.     In the Select Groups dialog box, enter Users in the Enter the object names to select field, and click OK.

User aaa is added to group Users.

Figure 5 Adding user aaa to group Users

 

3.     Configure the administrator password:

a.     In the right pane, right-click user Administrator and select Set Password.

b.     In the dialog box, enter the administrator password. (Details not shown.)

Verifying the configuration

# Open a Web browser such as IE on the wireless client. Type an IP address in the address bar and press Enter. The portal authentication page opens. Enter username aaa and password 123456 and then click Logon. User aaa passes authentication successfully.

# Display online portal users on the AC.

<AC> display portal user all

 Index:17

 State:ONLINE

 SubState:NONE

 ACL:3777

 Work-mode:stand-alone

 MAC              IP                Vlan     Interface

 ----------------------------------------------------------------------------

 2477-0341-f118   2.2.2.2           200      WLAN-BSS1/0/16

 Total 1 user(s) matched, 1 listed.

Configuration files

·     AC:

#

vlan 100

#

vlan 200

#

wlan service-template st1

client forwarding-location ac

 akm mode psk

 preshared-key pass-phrase simple 12345678

 cipher-suite ccmp

 security-ie rsn

 ssid service

 vlan 200

 portal enable method direct

 portal domain ldap

 portal apply web-server newpt

 service-template enable

#

interface Vlan-interface100

 ip address 2.2.1.1 255.255.255.0

#

interface Vlan-interface200

 ip address 2.2.2.1 255.255.255.0

#

interface GigabitEthernet1/0/1

 port link-type trunk

 port trunk permit vlan 100 200

#

ldap server ldap

 login-dn cn=administrator,cn=users,dc=ldap,dc=com

 search-base-dn dc=ldap,dc=com

 ip 192.168.0.112

 login-password cipher $c$3$CEz2vKCnA2/51D8rFc/+nTNtOx8Gan+81Q==

#

ldap scheme ldap

 authentication-server ldap

#

domain ldap

 authorization-attribute idle-cut 15 1024

 authentication portal ldap-scheme ldap

 authorization portal none

 accounting portal none

#

portal host-check enable

portal free-rule 1 destination ip any udp 53

portal free-rule 2 destination ip any tcp 53

#

portal web-server newpt

 url http://2.2.2.1/portal

#

portal local-web-server http

 default-logon-page abc.zip

#

wlan ap ap1 model WA6320

 serial-id 219801A28N819CE0002T

#

wlan ap-group group1

ap ap1

ap-model WA6320

radio 2

  radio enable

  service-template st1

#

·     Switch:

#

vlan 100

#

vlan 200

#

vlan 2

#

interface Vlan-interface2

 ip address 192.168.0.2 255.255.255.0

#

interface GigabitEthernet1/0/1

 port link-mode bridge

 port link-type trunk

 port trunk permit vlan 100 200

#

interface GigabitEthernet1/0/2

 port link-mode bridge

 port access vlan 100

 poe enable

#

Related documentation

·     User Access and Authentication Command Reference in H3C Access Controllers Command References

·     User Access and Authentication Configuration Guide in H3C Access Controllers Configuration Guides

·     WLAN Access Command Reference in H3C Access Controllers Command References

·     WLAN Access Configuration Guide in H3C Access Controllers Configuration Guides