WiFi: HotSpot - CoovaChilli Pendahuluan - Revision history

Irwan se sh: /* Kebutuhan */

2011-01-25T05:38:22Z

Kebutuhan

← Older revision		Revision as of 05:38, 25 January 2011
Line 7:		Line 7:
	==Kebutuhan==		==Kebutuhan==

	Tutorial ini akan memperlihatkan bagaimana menjalankan [[software]] ini di sebuah mesin. Pada dasarnya, anda dapat menginstalasi Apache, MySQL, dan FreeRADIUS di mesin yang berbeda. Anda hanya perlu mengkonfigursi masing-masing parameter dari [[software]] tersebut. Biasanya, CoovaChilli ~~di jalankan~~ di [[router]] - menggunakan [[firmware]] seperti OpenWrt (atau CoovaAP), SDK vendor (seperti Ubiquiti), atau pre-install [[hardware]] seperti FON atau open-mesh.com.		Tutorial ini akan memperlihatkan bagaimana menjalankan [[software]] ini di sebuah mesin. Pada dasarnya, anda dapat menginstalasi Apache, MySQL, dan FreeRADIUS di mesin yang berbeda. Anda hanya perlu mengkonfigursi masing-masing parameter dari [[software]] tersebut. Biasanya, CoovaChilli dijalankan di [[router]] - menggunakan [[firmware]] seperti OpenWrt (atau CoovaAP), SDK vendor (seperti Ubiquiti), atau pre-install [[hardware]] seperti FON atau open-mesh.com.

	CATATAN: baik coovachilli dan chillispot tidak dapat bekerja di [[OS]] 64 bit. Authentikasi RADIUS bermasalah di setup tersebut.		CATATAN: baik coovachilli dan chillispot tidak dapat bekerja di [[OS]] 64 bit. Authentikasi RADIUS bermasalah di setup tersebut.

	HOWTO ini mengasumsikan bahwa kita mempunyai sebuah mesin x86 dengan dua [[network interface]]. Biasanya, satu menjadi interface [[WAN]], dan "subscriber" [[LAN]] [[interface]] yang akan ~~di kontrol~~ oleh CoovaChilli. [[Interface]] ini dapat berupa [[ethernet]] atau [[WiFi]]. Dalam contoh ini, kita akan mengasumsikan dua [[interface]] [[Ethernet]] untuk [[WAN]] (eth0) dan [[LAN]] (eth1).		HOWTO ini mengasumsikan bahwa kita mempunyai sebuah mesin x86 dengan dua [[network interface]]. Biasanya, satu menjadi interface [[WAN]], dan "subscriber" [[LAN]] [[interface]] yang akan dikontrol oleh CoovaChilli. [[Interface]] ini dapat berupa [[ethernet]] atau [[WiFi]]. Dalam contoh ini, kita akan mengasumsikan dua [[interface]] [[Ethernet]] untuk [[WAN]] (eth0) dan [[LAN]] (eth1).

	==Proses==		==Proses==

Irwan se sh: /* Proses */

2011-01-25T05:35:04Z

Proses

← Older revision		Revision as of 05:35, 25 January 2011
Line 15:		Line 15:
	==Proses==		==Proses==

	CoovaChilli akan ~~mengambik~~ alih control dari internal interface (eth1) menggunakan socket raw promiscuous. CoovaChilli kemudian akan menggunakan [[kernel]] modul vtun untuk membangun [[interface]] virtual (bisa tun au tap) untuk meneruskan packet yang ~~di terima~~ atau ~~di kirim~~ ke [[WAN]]. Pada dasarnya, kernel modul vtun digunakan untuk memindahkan paket [[IP]] dari kernel ke mode user, ~~sedemikkan~~ hingga CoovaChilli dapat berfungsi tanpa non-standard kernel module. CoovaChilli kemudian akan memberikan [[DHCP]], [[ARP]], and [[HTTP]] Hijacking pada interface "dhcpif", pada kasus kita adalah eth0.		CoovaChilli akan mengambil alih control dari internal interface (eth1) menggunakan socket raw promiscuous. CoovaChilli kemudian akan menggunakan [[kernel]] modul vtun untuk membangun [[interface]] virtual (bisa tun au tap) untuk meneruskan packet yang diterima atau dikirim ke [[WAN]]. Pada dasarnya, kernel modul vtun digunakan untuk memindahkan paket [[IP]] dari kernel ke mode user, sedemikian hingga CoovaChilli dapat berfungsi tanpa non-standard kernel module. CoovaChilli kemudian akan memberikan [[DHCP]], [[ARP]], and [[HTTP]] Hijacking pada interface "dhcpif", pada kasus kita adalah eth0.

	Sebuah client / laptop akan tersambung ke Interface ini akan di batasi oleh "walled garden" sampai di authorisasi. ~~Clienty~~ / laptop hanya akan dapat memperoleh DNS dan ~~Web site~~ yang sudah di approved oleh "walled garden". Authentikasi (dan authorisasi) di CoovaChilli akan dilakukan menggunakan salah satu dari dua cara berikut. Apakah itu menggunakan MAC based authentication (menggunakan pilihan macauth di chilli.conf) atau menggunakan cara "Universal Access Method" (UAM). Metoda yang ke dua menggunakan [[captive portal]] yang akan menginisiasi proses authentikasi. Saat sebuah client yang tidak ~~terauthentikasi~~ berusaha untuk mengakses Web (pada port 80), permohonan untuk menyambung ke Web akan di tangkap oleh CoovaChilli dan akan di redirect ke [[captive portal]]. Dalam kasus kita, kita akan menggunakan sebuah perl-script dengan nama hotspotlogin.cgi (yang di jalankan oleh apache melalui https).		Sebuah client / laptop akan tersambung ke Interface ini akan di batasi oleh "walled garden" sampai di authorisasi. Client / laptop hanya akan dapat memperoleh DNS dan WebSite yang sudah di-approved oleh "walled garden". Authentikasi (dan authorisasi) di CoovaChilli akan dilakukan menggunakan salah satu dari dua cara berikut. Apakah itu menggunakan MAC based authentication (menggunakan pilihan macauth di chilli.conf) atau menggunakan cara "Universal Access Method" (UAM). Metoda yang ke dua menggunakan [[captive portal]] yang akan menginisiasi proses authentikasi. Saat sebuah client yang tidak ter-authentikasi berusaha untuk mengakses Web (pada port 80), permohonan untuk menyambung ke Web akan di tangkap oleh CoovaChilli dan akan di redirect ke [[captive portal]]. Dalam kasus kita, kita akan menggunakan sebuah perl-script dengan nama hotspotlogin.cgi (yang di jalankan oleh apache melalui https).

	hotspotlogin.cgi akan menyajikan halaman ke user dengan kolom username dan password. Data authentikasi ini akan di forward ke FreeRADIUS server, yang akan kemudian mencocokan informasinya ke back end menggunakan PAP, CHAP, atau MSCHAPv2. FreeRADIUS back-end disini adalah mysql, tentunya bisa servis lain seperti LDAP, Kerberos, unix passwd file atau Active Directory.		hotspotlogin.cgi akan menyajikan halaman ke user dengan kolom username dan password. Data authentikasi ini akan di forward ke FreeRADIUS server, yang akan kemudian mencocokan informasinya ke back end menggunakan PAP, CHAP, atau MSCHAPv2. FreeRADIUS back-end disini adalah mysql, tentunya bisa servis lain seperti LDAP, Kerberos, unix passwd file atau Active Directory.

	User kemudian akan ~~di tentukan~~ apakah ~~di tolak~~ atau ~~di ijinkan~~ oleh FreeRADIUS, yang akan disampaikan oleh hotspotlogin.cgi dalam bentuk message penolakan atau halaman dengan berita "sukses" dan link untuk logout untuk user.		User kemudian akan ditentukan apakah ditolak atau diijinkan oleh FreeRADIUS, yang akan disampaikan oleh hotspotlogin.cgi dalam bentuk message penolakan atau halaman dengan berita "sukses" dan link untuk logout untuk user.

	==Pranala Menarik==		==Pranala Menarik==

Onnowpurbo: /* Pranala Menarik */

2010-05-11T02:18:33Z

Pranala Menarik

← Older revision		Revision as of 02:18, 11 May 2010
Line 33:		Line 33:
	* [[WiFi: HotSpot - CoovaChilli Fitur dan Keterangan Tambahan]]		* [[WiFi: HotSpot - CoovaChilli Fitur dan Keterangan Tambahan]]
	* [[WiFi: HotSpot]]		* [[WiFi: HotSpot]]

			[[Category: WiFi]]
			[[Category: HotSpot]]
			[[Category: CoovaChilli]]

Onnowpurbo at 03:12, 7 April 2010

2010-04-07T03:12:07Z

← Older revision		Revision as of 03:12, 7 April 2010
Line 19:		Line 19:
	Sebuah client / laptop akan tersambung ke Interface ini akan di batasi oleh "walled garden" sampai di authorisasi. Clienty / laptop hanya akan dapat memperoleh DNS dan Web site yang sudah di approved oleh "walled garden". Authentikasi (dan authorisasi) di CoovaChilli akan dilakukan menggunakan salah satu dari dua cara berikut. Apakah itu menggunakan MAC based authentication (menggunakan pilihan macauth di chilli.conf) atau menggunakan cara "Universal Access Method" (UAM). Metoda yang ke dua menggunakan [[captive portal]] yang akan menginisiasi proses authentikasi. Saat sebuah client yang tidak terauthentikasi berusaha untuk mengakses Web (pada port 80), permohonan untuk menyambung ke Web akan di tangkap oleh CoovaChilli dan akan di redirect ke [[captive portal]]. Dalam kasus kita, kita akan menggunakan sebuah perl-script dengan nama hotspotlogin.cgi (yang di jalankan oleh apache melalui https).		Sebuah client / laptop akan tersambung ke Interface ini akan di batasi oleh "walled garden" sampai di authorisasi. Clienty / laptop hanya akan dapat memperoleh DNS dan Web site yang sudah di approved oleh "walled garden". Authentikasi (dan authorisasi) di CoovaChilli akan dilakukan menggunakan salah satu dari dua cara berikut. Apakah itu menggunakan MAC based authentication (menggunakan pilihan macauth di chilli.conf) atau menggunakan cara "Universal Access Method" (UAM). Metoda yang ke dua menggunakan [[captive portal]] yang akan menginisiasi proses authentikasi. Saat sebuah client yang tidak terauthentikasi berusaha untuk mengakses Web (pada port 80), permohonan untuk menyambung ke Web akan di tangkap oleh CoovaChilli dan akan di redirect ke [[captive portal]]. Dalam kasus kita, kita akan menggunakan sebuah perl-script dengan nama hotspotlogin.cgi (yang di jalankan oleh apache melalui https).

	hotspotlogin.cgi ~~serves a page to the end-~~user ~~with a~~ username ~~and~~ password ~~field~~. ~~These authentication data are then forwarded to the~~ FreeRADIUS server, ~~which matches them with information in it’s~~ back-end ~~(using either~~ PAP, CHAP, or MSCHAPv2). ~~The~~ FreeRADIUS back-end ~~in this case is~~ mysql, ~~but could be any number of services such as~~ LDAP, Kerberos, unix passwd ~~files or even~~ Active Directory ~~(probably).~~		hotspotlogin.cgi akan menyajikan halaman ke user dengan kolom username dan password. Data authentikasi ini akan di forward ke FreeRADIUS server, yang akan kemudian mencocokan informasinya ke back end menggunakan PAP, CHAP, atau MSCHAPv2. FreeRADIUS back-end disini adalah mysql, tentunya bisa servis lain seperti LDAP, Kerberos, unix passwd file atau Active Directory.

	~~A user is then either rejected or authenticated by FreeRADIUS, prompting hotspotlogin.cgi to present either a rejection message or a page with a success message and a logout link to the user~~.

			User kemudian akan di tentukan apakah di tolak atau di ijinkan oleh FreeRADIUS, yang akan disampaikan oleh hotspotlogin.cgi dalam bentuk message penolakan atau halaman dengan berita "sukses" dan link untuk logout untuk user.

	==Pranala Menarik==		==Pranala Menarik==

Onnowpurbo at 03:02, 7 April 2010

2010-04-07T03:02:35Z

← Older revision		Revision as of 03:02, 7 April 2010
Line 1:		Line 1:
	[[Image:Chilli 2.preview.jpg\|right\|200px\|thumb]]		[[Image:Chilli 2.preview.jpg\|right\|200px\|thumb]]

	CoovaChilli adalah sebuah [[software]] access controller [[open source]], berbasis pada Chillispot project yang sekarang sudah tidak aktif. CoovaChilli aktif di kembangkan oleh kontributor Chillispot.		CoovaChilli adalah sebuah [[software]] access controller [[open source]], berbasis pada [[Chillispot]] project yang sekarang sudah tidak aktif. CoovaChilli aktif di kembangkan oleh kontributor [[Chillispot]].

	CoovaChilli adalah sebuah [[software]] access control yang kaya akan fitur, yang dapat memberikan [[captive portal]] / walled-garden environment dan menggunakan RADIUS untuk mengontrol akses dan akunting. CoovaChilli adalah bagian integral dari [[firmware]] CoovaAP OpenWRT.		CoovaChilli adalah sebuah [[software]] access control yang kaya akan fitur, yang dapat memberikan [[captive portal]] / walled-garden environment dan menggunakan RADIUS untuk mengontrol akses dan akunting. CoovaChilli adalah bagian integral dari [[firmware]] CoovaAP OpenWRT.
Line 17:		Line 17:
	CoovaChilli akan mengambik alih control dari internal interface (eth1) menggunakan socket raw promiscuous. CoovaChilli kemudian akan menggunakan [[kernel]] modul vtun untuk membangun [[interface]] virtual (bisa tun au tap) untuk meneruskan packet yang di terima atau di kirim ke [[WAN]]. Pada dasarnya, kernel modul vtun digunakan untuk memindahkan paket [[IP]] dari kernel ke mode user, sedemikkan hingga CoovaChilli dapat berfungsi tanpa non-standard kernel module. CoovaChilli kemudian akan memberikan [[DHCP]], [[ARP]], and [[HTTP]] Hijacking pada interface "dhcpif", pada kasus kita adalah eth0.		CoovaChilli akan mengambik alih control dari internal interface (eth1) menggunakan socket raw promiscuous. CoovaChilli kemudian akan menggunakan [[kernel]] modul vtun untuk membangun [[interface]] virtual (bisa tun au tap) untuk meneruskan packet yang di terima atau di kirim ke [[WAN]]. Pada dasarnya, kernel modul vtun digunakan untuk memindahkan paket [[IP]] dari kernel ke mode user, sedemikkan hingga CoovaChilli dapat berfungsi tanpa non-standard kernel module. CoovaChilli kemudian akan memberikan [[DHCP]], [[ARP]], and [[HTTP]] Hijacking pada interface "dhcpif", pada kasus kita adalah eth0.

	A client ~~connecting to this interface is limited to a~~ "walled garden" ~~until authorized~~. ~~The client is only able to resolve~~ DNS ~~and web browser web sites specifically added to the~~ walled garden. ~~Authentication~~ (~~and authorization~~) in CoovaChilli ~~typically happens in one of two ways~~. ~~Either it was a~~ MAC based authentication (~~using the~~ macauth ~~option in~~ chilli.conf) ~~or it was the more typical~~ "Universal Access Method" (UAM). ~~This method uses a~~ captive portal ~~that initiates authentication~~. ~~When a non-authenticated~~ client ~~tries to connect to a web-page~~ (on port 80) ~~the request is intercepted by~~ CoovaChilli ~~and redirected to the~~ captive portal. ~~In our case~~, ~~we'll use a~~ perl-script ~~called~~ hotspotlogin.cgi (~~served by~~ apache ~~over~~ https).		Sebuah client / laptop akan tersambung ke Interface ini akan di batasi oleh "walled garden" sampai di authorisasi. Clienty / laptop hanya akan dapat memperoleh DNS dan Web site yang sudah di approved oleh "walled garden". Authentikasi (dan authorisasi) di CoovaChilli akan dilakukan menggunakan salah satu dari dua cara berikut. Apakah itu menggunakan MAC based authentication (menggunakan pilihan macauth di chilli.conf) atau menggunakan cara "Universal Access Method" (UAM). Metoda yang ke dua menggunakan [[captive portal]] yang akan menginisiasi proses authentikasi. Saat sebuah client yang tidak terauthentikasi berusaha untuk mengakses Web (pada port 80), permohonan untuk menyambung ke Web akan di tangkap oleh CoovaChilli dan akan di redirect ke [[captive portal]]. Dalam kasus kita, kita akan menggunakan sebuah perl-script dengan nama hotspotlogin.cgi (yang di jalankan oleh apache melalui https).

	hotspotlogin.cgi serves a page to the end-user with a username and password field. These authentication data are then forwarded to the FreeRADIUS server, which matches them with information in it’s back-end (using either PAP, CHAP, or MSCHAPv2). The FreeRADIUS back-end in this case is mysql, but could be any number of services such as LDAP, Kerberos, unix passwd files or even Active Directory (probably).		hotspotlogin.cgi serves a page to the end-user with a username and password field. These authentication data are then forwarded to the FreeRADIUS server, which matches them with information in it’s back-end (using either PAP, CHAP, or MSCHAPv2). The FreeRADIUS back-end in this case is mysql, but could be any number of services such as LDAP, Kerberos, unix passwd files or even Active Directory (probably).

Onnowpurbo: /* Pranala Menarik */

2010-04-07T02:44:27Z

Pranala Menarik

← Older revision		Revision as of 02:44, 7 April 2010
Line 26:		Line 26:
	==Pranala Menarik==		==Pranala Menarik==

			* [[WiFi: HotSpot - CoovaChilli Pendahuluan]]
			* [[WiFi: HotSpot - CoovaChilli Kebutuhan Hardware dan Software]]
			* [[WiFi: HotSpot - CoovaChilli Instalasi Radius Server]]
			* [[WiFi: HotSpot - Instalasi CoovaChilli]]
			* [[WiFi: HotSpot - CoovaChilli Instalasi Firewall]]
			* [[WiFi: HotSpot - CoovaChilli Instalasi Apache dan SSL]]
			* [[WiFi: HotSpot - CoovaChilli Fitur dan Keterangan Tambahan]]
	* [[WiFi: HotSpot]]		* [[WiFi: HotSpot]]

Onnowpurbo at 22:25, 5 March 2010

2010-03-05T22:25:36Z

← Older revision		Revision as of 22:25, 5 March 2010
Line 1:		Line 1:
	[[Image:Chilli 2.preview.jpg\|right\|200px\|thumb]]		[[Image:Chilli 2.preview.jpg\|right\|200px\|thumb]]

	~~Introduction~~		CoovaChilli adalah sebuah [[software]] access controller [[open source]], berbasis pada Chillispot project yang sekarang sudah tidak aktif. CoovaChilli aktif di kembangkan oleh kontributor Chillispot.

	CoovaChilli ~~is an open-source~~ software access ~~controller~~, ~~based on the popular (but now defunct) ChilliSpot project, and is actively maintained by an original ChilliSpot contributor~~.		CoovaChilli adalah sebuah [[software]] access control yang kaya akan fitur, yang dapat memberikan [[captive portal]] / walled-garden environment dan menggunakan RADIUS untuk mengontrol akses dan akunting. CoovaChilli adalah bagian integral dari [[firmware]] CoovaAP OpenWRT.

	CoovaChilli is a feature rich software access controller that provides a captive portal / walled-garden environment and uses RADIUS for access provisioning and accounting. CoovaChilli is an integral part of the CoovaAP OpenWRT-based firmware which is specialized for hotspots. For more information on how Coova's Chilli differs from the standard ChilliSpot, see the ChangeLog.		==Kebutuhan==

	~~Requirements~~		Tutorial ini akan memperlihatkan bagaimana menjalankan [[software]] ini di sebuah mesin. Pada dasarnya, anda dapat menginstalasi Apache, MySQL, dan FreeRADIUS di mesin yang berbeda. Anda hanya perlu mengkonfigursi masing-masing parameter dari [[software]] tersebut. Biasanya, CoovaChilli di jalankan di [[router]] - menggunakan [[firmware]] seperti OpenWrt (atau CoovaAP), SDK vendor (seperti Ubiquiti), atau pre-install [[hardware]] seperti FON atau open-mesh.com.

	~~This tutorial will show how to run all this software on a single machine. However, you could install Apache, MySQL, and FreeRADIUS on a separate one, or even have 4 different machines~~: you'll just need to adjust the configuration parameters of each piece of software. Though, the more typical way to run CoovaChilli is on the router itself - using firmware such as OpenWrt (or CoovaAP), vendor SDKs (such as Ubiquiti), or pre-installed in hardware like that used by FON and open-mesh.~~com~~.		CATATAN: baik coovachilli dan chillispot tidak dapat bekerja di [[OS]] 64 bit. Authentikasi RADIUS bermasalah di setup tersebut.

	~~NOTE: both coovachilli and chillispot don't work with 64bit OS~~. ~~RADIUS authentication is flawed in those setups~~.		HOWTO ini mengasumsikan bahwa kita mempunyai sebuah mesin x86 dengan dua [[network interface]]. Biasanya, satu menjadi interface [[WAN]], dan "subscriber" [[LAN]] [[interface]] yang akan di kontrol oleh CoovaChilli. [[Interface]] ini dapat berupa [[ethernet]] atau [[WiFi]]. Dalam contoh ini, kita akan mengasumsikan dua [[interface]] [[Ethernet]] untuk [[WAN]] (eth0) dan [[LAN]] (eth1).

	~~Caveats~~		==Proses==

	~~This HOWTO presumes you have an x86 machine with at least two physical network interfaces. Usually, this is an Ethernet WAN interface and "subscriber" LAN interface that~~ CoovaChilli ~~will~~ control ~~- it can be either a Ethernet or WiFi interface. In our case, we'll assume two Ethernet interfaces for the WAN (eth0) and LAN (eth1).~~		CoovaChilli akan mengambik alih control dari internal interface (eth1) menggunakan socket raw promiscuous. CoovaChilli kemudian akan menggunakan [[kernel]] modul vtun untuk membangun [[interface]] virtual (bisa tun au tap) untuk meneruskan packet yang di terima atau di kirim ke [[WAN]]. Pada dasarnya, kernel modul vtun digunakan untuk memindahkan paket [[IP]] dari kernel ke mode user, sedemikkan hingga CoovaChilli dapat berfungsi tanpa non-standard kernel module. CoovaChilli kemudian akan memberikan [[DHCP]], [[ARP]], and [[HTTP]] Hijacking pada interface "dhcpif", pada kasus kita adalah eth0.

	~~The proccess~~

	~~CoovaChilli takes control of the~~ internal interface (eth1) ~~using a~~ raw promiscuous ~~socket~~. ~~It then uses the~~ vtun ~~kernel module to bring up a~~ virtual ~~interface~~ (~~either a~~ tun or tap) ~~to pass and receive packets to and from the~~ WAN. ~~In fact the~~ vtun ~~kernel module is used to move~~ IP ~~packets from the~~ kernel to user ~~mode~~, ~~in such a way that~~ CoovaChilli ~~can function without any~~ non-standard kernel ~~modules~~. CoovaChilli ~~then provides~~ DHCP, ARP, and HTTP Hijacking ~~on the~~ "dhcpif" ~~interface~~, ~~in our case that's~~ eth0.

	A client connecting to this interface is limited to a "walled garden" until authorized. The client is only able to resolve DNS and web browser web sites specifically added to the walled garden. Authentication (and authorization) in CoovaChilli typically happens in one of two ways. Either it was a MAC based authentication (using the macauth option in chilli.conf) or it was the more typical "Universal Access Method" (UAM). This method uses a captive portal that initiates authentication. When a non-authenticated client tries to connect to a web-page (on port 80) the request is intercepted by CoovaChilli and redirected to the captive portal. In our case, we'll use a perl-script called hotspotlogin.cgi (served by apache over https).		A client connecting to this interface is limited to a "walled garden" until authorized. The client is only able to resolve DNS and web browser web sites specifically added to the walled garden. Authentication (and authorization) in CoovaChilli typically happens in one of two ways. Either it was a MAC based authentication (using the macauth option in chilli.conf) or it was the more typical "Universal Access Method" (UAM). This method uses a captive portal that initiates authentication. When a non-authenticated client tries to connect to a web-page (on port 80) the request is intercepted by CoovaChilli and redirected to the captive portal. In our case, we'll use a perl-script called hotspotlogin.cgi (served by apache over https).
Line 26:		Line 22:

	A user is then either rejected or authenticated by FreeRADIUS, prompting hotspotlogin.cgi to present either a rejection message or a page with a success message and a logout link to the user.		A user is then either rejected or authenticated by FreeRADIUS, prompting hotspotlogin.cgi to present either a rejection message or a page with a success message and a logout link to the user.


			==Pranala Menarik==

			* [[WiFi: HotSpot]]

Onnowpurbo at 23:50, 1 March 2010

2010-03-01T23:50:51Z

← Older revision		Revision as of 23:50, 1 March 2010
Line 1:		Line 1:
			[[Image:Chilli 2.preview.jpg\|right\|200px\|thumb]]

	Introduction		Introduction

Onnowpurbo: New page: Introduction CoovaChilli is an open-source software access controller, based on the popular (but now defunct) ChilliSpot project, and is actively maintained by an original ChilliSpot cont...

2010-03-01T23:34:28Z

New page: Introduction CoovaChilli is an open-source software access controller, based on the popular (but now defunct) ChilliSpot project, and is actively maintained by an original ChilliSpot cont...

New page

Introduction

CoovaChilli is an open-source software access controller, based on the popular (but now defunct) ChilliSpot project, and is actively maintained by an original ChilliSpot contributor.

CoovaChilli is a feature rich software access controller that provides a captive portal / walled-garden environment and uses RADIUS for access provisioning and accounting. CoovaChilli is an integral part of the CoovaAP OpenWRT-based firmware which is specialized for hotspots. For more information on how Coova's Chilli differs from the standard ChilliSpot, see the ChangeLog.

Requirements

This tutorial will show how to run all this software on a single machine. However, you could install Apache, MySQL, and FreeRADIUS on a separate one, or even have 4 different machines: you'll just need to adjust the configuration parameters of each piece of software. Though, the more typical way to run CoovaChilli is on the router itself - using firmware such as OpenWrt (or CoovaAP), vendor SDKs (such as Ubiquiti), or pre-installed in hardware like that used by FON and open-mesh.com.

NOTE: both coovachilli and chillispot don't work with 64bit OS. RADIUS authentication is flawed in those setups.

Caveats

This HOWTO presumes you have an x86 machine with at least two physical network interfaces. Usually, this is an Ethernet WAN interface and "subscriber" LAN interface that CoovaChilli will control - it can be either a Ethernet or WiFi interface. In our case, we'll assume two Ethernet interfaces for the WAN (eth0) and LAN (eth1).

The proccess

CoovaChilli takes control of the internal interface (eth1) using a raw promiscuous socket. It then uses the vtun kernel module to bring up a virtual interface (either a tun or tap) to pass and receive packets to and from the WAN. In fact the vtun kernel module is used to move IP packets from the kernel to user mode, in such a way that CoovaChilli can function without any non-standard kernel modules. CoovaChilli then provides DHCP, ARP, and HTTP Hijacking on the "dhcpif" interface, in our case that's eth0.

A client connecting to this interface is limited to a "walled garden" until authorized. The client is only able to resolve DNS and web browser web sites specifically added to the walled garden. Authentication (and authorization) in CoovaChilli typically happens in one of two ways. Either it was a MAC based authentication (using the macauth option in chilli.conf) or it was the more typical "Universal Access Method" (UAM). This method uses a captive portal that initiates authentication. When a non-authenticated client tries to connect to a web-page (on port 80) the request is intercepted by CoovaChilli and redirected to the captive portal. In our case, we'll use a perl-script called hotspotlogin.cgi (served by apache over https).

hotspotlogin.cgi serves a page to the end-user with a username and password field. These authentication data are then forwarded to the FreeRADIUS server, which matches them with information in it’s back-end (using either PAP, CHAP, or MSCHAPv2). The FreeRADIUS back-end in this case is mysql, but could be any number of services such as LDAP, Kerberos, unix passwd files or even Active Directory (probably).

A user is then either rejected or authenticated by FreeRADIUS, prompting hotspotlogin.cgi to present either a rejection message or a page with a success message and a logout link to the user.