Web Messenger

محتویات ۱ Introduction ۲ Requirments ۲.۱ IBSng ۲.۲ Network ۳ Installation ۳.۱ Web Messenger ۳.۲ IBSng ۴ How it Works ۵ Message Pages ۵.۱ Broadband/Narrowband ۵.۲ IN

Introduction

Parspooyesh Web Messenger is an application, that lets an internet service provider, forcefully show custom html pages (messages) to its users. It can be an advertisement, notification, warnings or any other type of message. After a message is defined by administrator and set to active, each user will see the message, next time they log in. When user starts the browser and tries to visit a page, web messenger will redirect him to the message url. After user confirmed that he saw the message, then he will be redirected to the original page. Each user would see each message just once.

User tries www.google.com => User redirect to www.mysite.com => User confirms visiting of the message by clicking on a button => user redirects to www.google.com

Requirments

IBSng

IBSng version B1.34 or higher and web messenger plugin

Network

All user web traffics needs to be passed through web messenger server. Web messenger will pass user traffic untouched until it's necessary. No proxying or other intrusive action involved. Web Messenger Needs to have users actual ip address. This means no Nat and no Proxying of user traffice before web messenger.

Installation

Web Messenger

extract the latest package and run install.sh

Note

You need to bypass website(s) serving message pages from redirecting to web messenger. This can be done via

iptables -t nat -I PREROUTING -p tcp --dport 80 -d <WEBSITE_IP> -j RETURN

IBSng

• Install a web messenger compatible branch of IBSng
• Add or Update the following line in general section of IBSng.conf

web_messenger_url=http://<WEB_MESSENGER_SERVER_IP>:8001/message_manager/new_login

Note

You need to restart IBSng after changing this parameter

Note

If you remove or comment this line, web messenger will be disabled on IBSng side. You can also do this via IBSng advanced configuration menu on the fly

How it Works

Browse

http://<WEB_MESSENGER_SERVER_IP>:8001/admin/

(don't forget the last slash). Log in with username and password that has been asked during installation.

Define a new message and you are ready to roll.

Message Pages

Message Pages are ordinary web pages (either dynamic or static), that should have a button that indicates user has been viewed the page. The button can be virtually clicked after a certain amount of time by using a javascript on that page.

The button (or link or a simple redirection) should point to

http://<WEB_MESSENGER_SERVER_IP>:8001/message_manager/visit_confirmed

No argument is necessary.

Web Messenger sends few arguments using get method to the message page, to make writing dynamic messages easier. Arguments are different for Broadband/Narrowband or IN Service.

Broadband/Narrowband

• user_id: IBSng User ID of user which visits the message
• username: IBSng internet username of user
• user_credit: IBSng Current credit of user
• user_exp_date: IBSng Expiration date of user
• caller_id: Caller ID of user
• dnis: DNIS of User

IN

• caller_id: Caller ID of user
• dnis: DNIS of User