General WebFig Manual

manual:webfig 1
manual:webfig
summary
webfig is a web based routeros configuration utility. it is accessible directly from the router and no additional
software is required (except web browser with javascript, of course).
as webfig is platform independent, it can be used to configure router directly from various mobile devices without
need of a software developed for specific platform.
webfig is designed as an alternitive of winbox, both have similar layouts and both have access to almost any
feature of routeros.
connecting to router
webfig can be launched from the
routers home page which is accessible
by entering routers ip address in the
browser. when home page is
successfully loaded, choose webfig
from the list of available icons as
illustrated in screenshot.
after clicking on webfig icon, login
prompt will ask you to enter username
and password. enter login information
and click connect.
now you should be able to see webfig
in action.
ipv6 connectivity
routeros http service now listens on ipv6 address, too. to connect to ipv6, in your browser enter ipv6 address in
square brackets, for example [2001:db8:1::4]. if it is required to connect to link local address, don t forget to specify
interface name or interface id on windows, for example [fe80::9f94:9396%ether1].
manual:webfig 2
interface overview
webfig interface is designed to be very intuitive especially for winbox users. it has very similar layout: menu bar
on the left side, undo/redo at the top and work are at the rest of available space.
when connected to router, browsers title bar (tab name on chrome) displays currently opened menu, user name used
to authenticate, ip address, system identity, ros version and routerboard model in following format:
[menu] at [username]@[router s ip] ( [routerid] ) - webfig [ros version] on [rb model] ([platform])
menu bar has almost the same design as winbox menu bar. little arrow on the right side of the menu item indicates
that this menu has several sub-menus.
when clicking on such menu item, sub-menus will be listed and the arrow will
be pointing down, indicating that sub-menus are listed.
at the top you can see three common buttons undo/redo buttons similar to
winbox and one additional button log out. in the top right corner, you can see
webfig logo and routerboards model name.
work area has tab design, where you can switch between several configuration
tabs, for example in screenshot there are listed all tabs available in bridge
menu (bridge, ports, filters, nat, rules).
below the tabs are listed buttons for all menu specific commands, for example
add new and settings.
the last part is table of all menu items. first column of an item has item
specific command buttons:
• - enable current item
• - disable current item
• - remove current item
manual:webfig 3
item configuration
when clicking on one of the listed items, webfig will open new page showing all configurable parameters, item
specific commands and status.
at the top you can see item type and item name. in example screenshot you can see that item is an interface with
name bypass
there are also item specific command buttons (ok, cancel, apply, remove and torch). these can vary between
different items. for example torch is available only for interfaces.
common item buttons:
• ok - apply changes to parameters and exit
• cancel - exit and do not apply changes
• apply - apply changes and stay on current page
• remove - remove current item.
status bar similar to winbox shows current status of item specific flags (e.g running flag). grey-ed out flag means
that it is not active. in example screenshot you can see that running is in solid black and slave is grey-ed, which
means that interface is running and is not a slave interface.
list of properties is divided in several sections, for example "general", "stp", "status", "traffic". in winbox these
sections are located in separate tabs, but webfig lists them all in one page specifying section name. in screenshotyou
can see "general" section. grey-edout properties mean that they are read-only and configuration is not possible.
manual:webfig 4
work with files
webfig allows to upload files directly to the router, without using ftp services. to upload files, open files menu,
click on choose file button, pick file and wait until file is uploaded.
files also can be easily downloaded from the router, by clicking download button at the right side of the file entry.
traffic monitoring
[ top | back to content ]
skins
webfig skins is handy tool to make interface more user friendly. it is not a security tool. if user has sufficient rights
it is possible to access hidden features by other means.
designing skins
if user has sufficient permissions (group has policy edit permissions) design skin button becomes available.
pressing that toggle button will open interface editing options. possible operations are:
• hide menu - this will hide all items from menu and its submenus
manual:webfig 5
• hide submenu - only certain submenu will be hidden
• hide tabs - if submenu details have several tabs, it is possible to hide them this way
• rename menus, items - make some certain features more obvious or translate them into your launguage
• add note to to item (in detail view) - to add comments on filed
• make item read-only (in detail view) - for user safety very sensitive fields can be made read only
• hide flags (in detail view) - while it is only possible to hide flag in detail view, this flag will not be visible in list
view and in detailed view
• add limits for field - (in detail view) where it is list of times that are comma or newline separated list of allowed
values:
• number interval .. example: 1..10 will allow values from 1 to 10 for fiels with numbers, example, mtu size.
• field prefix (text fields, mac address, set fields, combo-boxes). if it is required to limit prefix length $ should
be added to the end, for example, limiting wireless interface to "station" only will contain
• add tab - will add grey ribbon with editable label that will separate the fields. ribbon will be added before field
it is added to
• add separator - will add low height horizontal separator before the field it is added to.
note: number interval cannot be set to extend limitations set by routeros for that field
note: set fields are argument that consist of set of check-boxes, for example, setting up policies for user
groups, radius "service"
note: limitations set for combo-boxes will values selectable from dropingdown
configure wireless interface
to configure
status page
note: starting routeros 5.7 webfig interface adds capability for users to create status page where fields from
anywhere can be added and arranged.
satus page can be created by users (with sufficient permissions) and fields on the page can be
reordered.
when status page is created it is default page that opens when logging in the router through webfig
interface.
manual:webfig 6
addition of fields
to add field to status page user has to enter "design skin" mode and from droping-down menu at the field choose
option - "add to status page"
as the result of this action desired field in read-only mode will be added to status page. if at the time status page is
not present at the time, it will be created for the user automatically.
two columns
fields in status page can be arranged in two columns. columns are filled from top to bottom.
when you have only one column then first item intended for second should be dragged to the top of the first item
when black line appear on top of the first item, then drag mouse to the left until shorter black line is displayed as
showed in screenshot. releasing mouse button will create second column. rest of the fields afterwards can be
dragged and dropingped same way as with one column design.
manual:webfig 7
skin design examples
set field
setting limits for set field
and the result:
using skins
to use skins you have to assign skin to group, when that is done users of that group will automatically use selected
skin as their default when logging into webfig.
note: webfig is only configuration interface that can use skins
if it is required to use created skin on other router you can copy files to skins folder on the other
router. on new router it is required to add copied skin to user group to use it.
[ top | back to content ]
article sources and contributors 8
article sources and contributors
manual:webfig source: http://wiki.mikrotik.com/index.php?oldid=22200 contributors: janisk, marisb, normis
image sources, licenses and contributors
file:webfig-1.png source: http://wiki.mikrotik.com/index.php?title=file:webfig-1.png license: unknown contributors: marisb
file:webfig-2.png source: http://wiki.mikrotik.com/index.php?title=file:webfig-2.png license: unknown contributors: marisb
file:webfig-submenu.png source: http://wiki.mikrotik.com/index.php?title=file:webfig-submenu.png license: unknown contributors: marisb
file:webfig-enable.png source: http://wiki.mikrotik.com/index.php?title=file:webfig-enable.png license: unknown contributors: marisb
file:webfig-disable.png source: http://wiki.mikrotik.com/index.php?title=file:webfig-disable.png license: unknown contributors: marisb
file:webfig-remove.png source: http://wiki.mikrotik.com/index.php?title=file:webfig-remove.png license: unknown contributors: marisb
file:webfig-3.png source: http://wiki.mikrotik.com/index.php?title=file:webfig-3.png license: unknown contributors: marisb
file:webfig-upload.png source: http://wiki.mikrotik.com/index.php?title=file:webfig-upload.png license: unknown contributors: marisb
file:webfig-download.png source: http://wiki.mikrotik.com/index.php?title=file:webfig-download.png license: unknown contributors: marisb
image:icon-note.png source: http://wiki.mikrotik.com/index.php?title=file:icon-note.png license: unknown contributors: marisb, route
file:webfig-add-to-stsatus-page.png source: http://wiki.mikrotik.com/index.php?title=file:webfig-add-to-stsatus-page.png license: unknown contributors: janisk
file:webfig-two-columns.png source: http://wiki.mikrotik.com/index.php?title=file:webfig-two-columns.png license: unknown contributors: janisk
file:webfig-set-field-limits-design.png source: http://wiki.mikrotik.com/index.php?title=file:webfig-set-field-limits-design.png license: unknown contributors: janisk
file:webfig-set-field-limits-done.png source: http://wiki.mikrotik.com/index.php?title=file:webfig-set-field-limits-done.png license: unknown contributors: janisk