Name: ansible-freeitaliawifi-login-page
Owner: OpenWISP
Description: Standard login page for Free ItaliaWifi federated networks
Created: 2016-10-20 12:35:24.0
Updated: 2017-03-08 09:29:44.0
Pushed: 2016-11-07 11:09:20.0
Homepage: http://www.freeitaliawifi.it/
Size: 158
Language: JavaScript
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
This ansible role makes it easy to deploy and upgrade the standard login page for Free ItaliaWifi federated networks.
By following the instructions in this repository you will be able to define the parts that make your login page unique (logo, RSS feeds, colors, signup links, ecc.) while retaining the main structure of the page intact in order to upgrade easily over time.
This role was tested on debian and ubuntu systems.
If you don't know how to use ansible, don't panic, this procedure will guide you step by step.
If you already know how to use ansible, you can skip this section and jump straight to the “Install this role” section.
First of all you need to understand two key concepts:
Ansible is a configuration management tool that works by entering production servers via SSH, so you need to install it and configure it on the machine where you launch the deployment and this machine must be able to SSH into the production server.
Install ansible on your local machine (not the production server!) if you haven't done already, there are various ways in which you can do this, but we prefer to use the official python package manager, eg:
sudo pip install ansible
If you don't have pip installed see Installing pip on the pip documentation website.
Installing ansible in other ways
is fine too, just make sure to install a version of the 2.0.x series (which is the version with
which we have tested this playbook).
For the sake of simplicity, the easiest thing is to install this role on your local machine
via ansible-galaxy (which was installed when installing ansible), therefore run:
sudo ansible-galaxy install openwisp.freeitaliawifi-login-page
Choose a working directory on your local machine where to put the configuration of freeitaliawifi-login-page.
This will be useful when you will need to upgrade the login page.
Eg:
mkdir ~/wifi-login-playbook
cd ~/wifi-login-playbook
Putting this working directory under version control is also a very good idea.
The inventory file is where group of servers are defined. In our simple case we can get away with defining a group in which we will put just one server.
Create a new file hosts on your local machine with the following contents:
[myserver]
login.mywifiservice.com
Substitute login.mywifiservice.com with your hostname (ip addresses are allowed as well).
Create a new playbook file playbook.yml on your local machine with the following contents:
sts: myserver
les:
- openwisp.freeitaliawifi-login-page
rs:
fiw_path: /var/www/freeitaliawifi-login-page
This setting will deploy a very basic version of the login page with the minimum feature set activated.
The default path of the deployment is /var/www/freeitaliawifi-login-page but it can be changed
by setting the fiw_path variable.
See the section Role Variables to know how to use all the supported variables.
At this stage your directory layout should look like the following:
hosts
playbook.yml
Now is time to deploy the login page to the production server.
Run the playbook on your local machine with:
ansible-playbook -i hosts playbook.yml -u <user> -k --ask-sudo-pass
Substitute <user> with your user.
The --ask-sudo-pass argument will need the sshpass program.
You can remove -k and --ask-sudo-pass if your public SSH key is installed on the server.
When the playbook is done running the login page will be built and deployed at the location specified
in fiw_path, which by default is /var/www/freeitaliawifi-login-page.
Upgrading is as simple as running the playbook again on your local machine.
It's even possible to set up the playbook to run periodically.
This role has many variables that can be changed to best suit your needs.
Below are listed all the variables you can customize. Each variable is preceded by a comment that explains its usage.
sts: yourhost
les:
you can add other roles here
- openwisp.freeitaliawifi-login-page
rs:
# location of the deployment
fiw_path: /var/www/freeitaliawifi-login-page
# theme (more on how to create your theme in the next section)
fiw_theme: default
# <title> value
fiw_title: WiFi Login
# links in main menu, set as empty list to disable (eg: "fiw_menu: []")
fiw_menu:
- text_it: Free ItaliaWifi
text_en: Free ItaliaWifi
href: http://www.freeitaliawifi.it
- text_it: OpenWISP
text_en: OpenWISP
href: http://openwisp.org
# form action, if you don't set this variable your login form will probably not work
fiw_form_action: null
# if set to true, a second logo (images/logo2.png) will be displayed just before the login form
fiw_logo2: false
# signup link
fiw_signup: null
# reset password link
fiw_reset_password: null
# manage account link
fiw_manage_account: null
# pfsense zone used in "fiw_hidden_fields"
fiw_pfsense_zone: null
# redirurl parameter used in "fiw_hidden_fields"
fiw_redirurl: http://openwisp.org
# hidden input fields, you can change this list to suit your captive portal software
fiw_hidden_fields:
- name: zone
value: "{{ fiw_pfsense_zone}}"
- name: accept
value: accept
- name: redirurl
value: "{{ fiw_redirurl}}"
# set this to false to hide the side box with email, phone number and social network links
fiw_contact_box: true
# contact links shown on the side
fiw_contact_links:
- label: E-mail
text: wifi@wifiservice.example
href: mailto:wifi@wifi@wifiservice.example
- label: Helpdesk
text: 06 00.00.0000
href: tel:+3906000000
# URL of facebook page, set to null to hide
fiw_facebook: https://www.facebook.com/OpenWISP/
# URL of twitter profile, set to null to hide
fiw_twitter: https://twitter.com/openwisp
# RSS feeds are fetched from this URL
fiw_feedr_host: feedr.publicwifi.it
# RSS feed loaded on the side, disabled by default
fiw_news_rss: null
# RSS feed loaded on the bottom, disabled by default
fiw_service_rss: null
# links to related pages, displaying logos
fiw_related_links:
- href: http://www.freeitaliawifi.it/
src: images/fiw.png
alt: FreeItaliaWifi
- href: http://www.openwisp.org/
src: images/openwisp.jpg
alt: OpenWISP
- href: http://www.cineca.it/
src: images/cineca.jpg
alt: Cineca
# link to privacy URL
fiw_privacy: "#"
# link to EULA/terms of service
fiw_eula: "#"
# list of Free ItaliaWifi networks
fiw_realm_json: https://ixwifi.cittametropolitanaroma.gov.it/fiw.json
# default realm, must match one of the realms present in "fiw_realm_json"
fiw_default_realm:
label: WiFi esempio
value: wifiesempio.it
In order to create your theme, you must add its custom files to your inventory.
For example, the following paragraphs illustrate to create a theme named mycustomtheme.
Step 1: set fiw_theme to mycustomtheme.
Step 2: ensure your directory layout looks like the one shown below:
hosts
playbook.yml
themes
??? mycustomtheme
??? css
? ??? theme.css
??? images
??? logo1.png
??? logo2.png
theme.css contains your CSS customizations, logo1.png contains your main logo while logo2.png
is an optional logo that is displayed before the login form, but only if the variable fiw_logo2
is set to true.
Any additional image used elsewhere on the page (eg: fiw_related_links) can be stored in the themes dir.
Some domains must be added in the walled garden of your captive portal software, otherwise users won't be able to follow the links on your page.
Pay special attention to the domains used in the following variables:
fiw_menufiw_signupfiw_reset_passwordfiw_manage_accountfiw_related_linksfiw_privacyfiw_eulafiw_realm_json