Views

Difference between revisions of "Send URL"

The Wiki of Unify contains information on clients and devices, communications systems and unified communications. - Unify GmbH & Co. KG is a Trademark Licensee of Siemens AG.

Jump to: navigation, search
Line 22: Line 22:
 
This FPK (if pressed) will trigger the following request
 
This FPK (if pressed) will trigger the following request
  
   https://10.10.0.255:443/?userid=MyUsername&password=MyPassword&id=1&item=2&ipaddress=<IP-OF-DEVICE>&phonenumber=<E164-OF-DEVICE>&devicetype=OpenStage&symbn=MySymbolicName
+
   {{#tag:nowiki|https://10.10.0.255:443/?userid=MyUsername&password=MyPassword&id=1&item=2&ipaddress=<IP-OF-DEVICE>&phonenumber=<E164-OF-DEVICE>&devicetype=OpenStage&symbn=MySymbolicName}}
 +
 
 +
The parts of the URL linked to the configuration items can be seen in the following table
 +
 
 +
{| {{DefaultTable}}
 +
|-
 +
! width="150" | URL part
 +
! width="200" | Configuration Item
 +
! width="300" | Example Value
 +
|-
 +
| Method
 +
| Method
 +
| GET
 +
|-
 +
| Protocol
 +
| Protocol
 +
| https
 +
|-
 +
| Hostname
 +
| Web server address
 +
| 10.10.0.255
 +
|-
 +
| Port
 +
| Port
 +
| 443
 +
|-
 +
| Path
 +
| Path
 +
| /
 +
|-
 +
| Parameter
 +
| Parameters
 +
| id=1&item=2
 +
|-
 +
| Parameter
 +
| Web server user ID
 +
| userid=MyUsername
 +
|-
 +
| Parameter
 +
| Web server password
 +
| password=MyPassword
 +
|-
 +
| Parameter
 +
| Symbolic name
 +
| symbn=MySymbolicName
 +
|}

Revision as of 14:45, 19 January 2017

Introduction

The Send URL function on the OpenScape Desk Phone CP devices, allows a user to send a predefined HTTP or HTTPS request to a server in order to trigger a remote action. The functionality is available from a free programmable key (FPK), that has been configured for this feature. In the server response to a phones HTTP or HTTPS request, the phone can be triggered to (e.g.)

  • turn on the LED of the configured FPK (in different colours)
  • use a different blinking mode
  • overwrite the FPK label (CP600 only)

Technical details

  • The request can be sent in plain HTTP or encrypted HTTPS
  • The request can be of type GET or POST
  • The phone will not follow any type of redirect (3XX)
  • Authentication User ID and password will be sent as Parameters (no HTTP Basic Authentication)
  • When using HTTPS, the connected server can be validated according to the Authentication Policy (see Administration Guide)

Configuration

A Send URL FPK can be configured via web based management or DLS. Please see example screenshot from WBM.

WBM ’Send URL FPK’ configuration

This FPK (if pressed) will trigger the following request

 https://10.10.0.255:443/?userid=MyUsername&password=MyPassword&id=1&item=2&ipaddress=<IP-OF-DEVICE>&phonenumber=<E164-OF-DEVICE>&devicetype=OpenStage&symbn=MySymbolicName

The parts of the URL linked to the configuration items can be seen in the following table

URL part Configuration Item Example Value
Method Method GET
Protocol Protocol https
Hostname Web server address 10.10.0.255
Port Port 443
Path Path /
Parameter Parameters id=1&item=2
Parameter Web server user ID userid=MyUsername
Parameter Web server password password=MyPassword
Parameter Symbolic name symbn=MySymbolicName