WiFi: HotSpot - CoovaChilli Pendahuluan - Revision history

Irwan se sh: /* Kebutuhan */

2011-01-25T05:38:22Z

Kebutuhan

Irwan se sh: /* Proses */

2011-01-25T05:35:04Z

Proses

Onnowpurbo: /* Pranala Menarik */

2010-05-11T02:18:33Z

Pranala Menarik

Onnowpurbo at 03:12, 7 April 2010

2010-04-07T03:12:07Z

Onnowpurbo at 03:02, 7 April 2010

2010-04-07T03:02:35Z

Onnowpurbo: /* Pranala Menarik */

2010-04-07T02:44:27Z

Pranala Menarik

Onnowpurbo at 22:25, 5 March 2010

2010-03-05T22:25:36Z

Onnowpurbo at 23:50, 1 March 2010

2010-03-01T23:50:51Z

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.

@@ Line 7: / Line 7: @@
 ==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.
-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==

@@ Line 15: / Line 15: @@
 ==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.
-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==

← 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]]

@@ 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).
-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.
 ==Pranala Menarik==

@@ Line 1: / Line 1: @@
 [[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.
@@ 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.
-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).

← 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]]

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