AdminWeb Menu customizing

AdminWeb support extention menu by adding it yourself.
This feature is only for enterprise server version.

Add menu

Administrator can add menus at "external menus" in setup screen.
- Common menu : They are appeared user and operator's adminWeb both.
- User menu : They are appeared user's adminWeb(8080, 8088 port).
- Operator menu : They are appeared operator's adminWeb(80, 443 port).

Link types.
- Link : It will be appeared on a new popup window link.
- Embedded : It will be appeared in below area. The top menu will show continuously. It is in iframe tag.

User authentication on the external page.

(3) View the external page.

http://x.x.x.x/externalPage?yourparameters&type=op&sid=234&token=b210a4cd328&userId=user1@ourcompany.com
typeop:on operator, user:on user
siduser's seesion id
tokenuser's seesion token
userIduser's id

(4) To verify user token, you have to use below API.

Check SSO

Check user's token. Please see the OpenAPI specification.(link)

1) request
Method POST
URL https://{CloudURL or YourServer's URL}/openapi/1/sso

Body :

field nametypedescriptionoption
idstring company owner's id(email)mandatory
typestring op : on operator, user : on usermandatory
sidnumber user's session idmandatory
tokenstring user's session tokenmandatory
cipstring client ip
String clientIp = request.getRemoteAddr();
String forwardedIp = request.getHeader("X-Forwarded-IP");
if(forwardedIp!=null && forwardedIp.isEmpty()==false)
          clientIp = forwardedIp;
mandatory
agentstring client agent
request.getHeader("User-Agent");
mandatory

Example :

{
    "id" : "user1@ourcompany.com",
    "type" : "op",
    "no" : 234,
    "token" : "b210a4cd328",
    "cip" : "x.x.x.x",
    "agent" : "Mozilla/5.0 (Windows NT 6.1; WOW64; Trident/7.0; rv:11.0) like Gecko"
}					
					
2) response
field nametypedescriptionoption
idstring user/operator idmandatory
namestring user/operator's namemandatory
dbidnumber user id in DB, (Server 5.1.x~)mandatory
typenumber user's type, (Server 5.1.x~)mandatory
levelnumber user's level, (Server 5.1.x~)mandatory

Available error code :

codedescription
401Token invalid
403Request forbidden. parameter invalid

Example :

{
    "id" : "user1@ourcompany.com",
    "name": "user name"
}