Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
10
October 14, 2005
© Copyright 2005, Now Wireless Ltd.
Table of Contents
Now IMP Server............................................................................................................... 2
System Requirements.................................................................................................. 3
Basic Configuration...................................................................................................... 4
Basic Configuration Step 1: Define the Server's TCP/IP Ports............................... 5
Basic Configuration Step 2: Start the Now IMP Server..........................................7
Basic Configuration Step 3: Define User Accounts............................................... 8
Basic Configuration Step 4a: Connect with a Mobile IM Client............................ 10
Configuring (Most) SonyEricsson Phones......................................................... 10
Configuring (Most) Nokia Series 60 Phones..................................................... 11
Configuring (Most) Nokia Series 40 Phones..................................................... 11
Configuring (Most) Motorola Phones (V80)....................................................... 12
Basic Configuration Step 4b: Connect with a Desktop IM Client......................... 14
Advanced Configuration............................................................................................. 20
Service Page......................................................................................................... 20
Server Page........................................................................................................... 22
Options Page......................................................................................................... 24
Push Page............................................................................................................. 26
WAP Push over UDP........................................................................................ 27
CIR TCP Push Channel (STCP)........................................................................ 28
WAP Push over SMS........................................................................................ 29
SMTP Page........................................................................................................... 30
Users Page............................................................................................................ 32
SSL/TLS Page....................................................................................................... 34
Serial # Page......................................................................................................... 38
User Account Provisioning via HTTP..................................................................... 39
Automated Agents................................................................................................. 42
OTA Provisioning for IMPS.................................................................................... 45
OTA Provisioning for IMPS: SonyEricsson....................................................... 47
OTA Provisioning for IMPS: Nokia (and other OMA Compliant Devices).........49
Self-User Provisioning via the Web....................................................................... 51
External Transports (AOL, MSN, etc.)............................................................................ 58
MSN Transport........................................................................................................... 59
AIM Transport............................................................................................................ 62
Now IMP Client............................................................................................................... 65
Getting Started with the Now IMP Client.................................................................... 67
Adding a Contact....................................................................................................... 70
To be continued......................................................................................................... 73
Mobile phone clients are supported through the Now IMP Server's implementation of
the Open Mobile Alliance (Wireless Village) Instant Messaging and Presence Services
(IMPS) specification. The current release of Now IMP supports the Client Server
Protocol (CSP) version 1.1 or 1.2, with support for both text and binary (WBXML)
protocol variants. As a published standard of the Open Mobile Alliance, many of the
new mobile phone models from major manufacturers include an instant messaging and
presence client that supports this specification.
PC desktop clients are supported through the Now IMP Server's implementation of the
XMPP (Extensible Messaging and Presence Protocol). A Windows based desktop client
supporting XMPP is bundled with the Now IMP Server to enable instant
communications. XMPP is an internet standard, published by the Internet Engineering
Task Force (IETF) in RFC 3920 and RFC 3921.
The Now IMP Server supports the Presence, Instant Messaging (IM) and Group
features of both the IMPS and XMPP specifications, in addition to the fundamental,
common and core features of those specifications.
It is also possible to use the Now IMP Server to allow mobile IM clients to connect to
MSN and/or AOL instant messaging networks, via add-on XMPP transport connectors.
The Now IMP Server allow organisations of any size to deploy their own private instant
messaging network, with SSL/TLS encryption, to enable individuals to interact with
each other across the office or around the world with secure instant messaging
technology. The alert management interface allows corporate applications to quickly
disseminate time critical information to employees.
The Now IMP Server provides a web-based administrative interface for user account
maintenance. The administrative interface also supports a programmatic HTTP
interface for user account definition.
The TCP/IP port number, on which the Now IMP Server will listen for HTTP connections
from mobile IM clients, is configured on the Server page of the configuration dialog,
under the setting HTTP Port Number.
To enable the XMPP Server interface, you must define the XMPP Domain Name. This
is normally the host name on which the Now IMP Server is installed. When connecting
to the Now IMP Server, it is customary to login with an XMPP client by specifying a user
name of user@xmppDomain.name, where “xmppDomain.name” is the host name of
the Now IMP Server. (The Now IMP Client can be configured to assume a default
domain name when it is installed, so that users need only supply their user name to
To start the Now IMP Server, press the Start button on the Service page of the
configuration dialog. Or check the Run as a Service option to install the Now IMP
Server as a service which will automatically start every time the PC is rebooted.
IM User accounts are defined on the Users page of the configuration dialog.
The process of configuring a mobile phone IM client to connect to the Now IMP Server
will vary by client. In some cases, it may be possible to send an OTA (Over The Air)
configuration message to automatically send the settings. The Now SMS/MMS
Gateway product supports sending IMPS configuration documents to mobile phones
over SMS, however that process is beyond the scope of this document.
To configure a mobile phone IM client to connect to the Now IMP Server, you must be
familiar with some of the internet and/or WAP configuration settings for the mobile
operator to which your phone is subscribed.
In most cases, you can duplicate the settings that are used by the Web/WAP Browser
on the mobile phone, and simply add the URL for connecting to the Now IMP Server.
The configuration settings that you will usually need to know include the APN (Access
Point Name) that is used for connecting to GPRS/EDGE/UMTS. You may also need to
know the IP address of a WAP proxy/gateway. (Note: For some IM clients, such as
those on SonyEricsson phones, it is advantageous to install the Now IMP Server in
conjunction with a Now.WAP Proxy Server. In this configuration, the Now IMP Server is
able to send WAP push messages through the Now.WAP Proxy to alert the mobile
phone IM client to new IM messages without requiring polling. The Now IMP Server
also directly supports a separate TCP/IP push channel, which is used by Nokia IM
clients. For more information on Push notification support, refer to the Advanced
Configuration section of this document.) Finally, you will need to supply the HTTP URL
for connecting to the HTTP Port on the Now IMP Server, as well as a valid user name
and password for an account on the server.
In most SonyEricsson phones, the IM Client configuration can be found under the My
Friends application on the mobile phone, under the menu option More/Accounts. The
available configuration settings are:
Username - This setting should contain the name of the user account defined to the
Now IMP Server.
Domain - This setting should be left blank.
Password - This setting should contain the password of the user account defined on
the Now IMP Server.
Server - This setting should contain the HTTP URL for connecting to the Now IMP
Server. For example, http://ip.address:port or http://host.name:port. The :port suffix is
required unless the HTTP Port Number for the Now IMP Server is the default HTTP
port of 80.
Internet Profile - This setting points to an existing internet profile configured on the
mobile phone. Use an appropriate profile that will facilitate connectivity to the HTTP
URL of the Now IMP Server.
For Nokia Series 60 (Symbian) phones, IM settings can be configured under the Chat
or Presence applications. Select Options and then Settings to access the Server
Settings configuration for the IM Client.
The Server Settings include the following settings:
Server Name - This is a descriptive name for the server which is used only within the
IM Client for display purposes.
Access Point in Use - This specifies the internet access point (settings profile) that
should be used for IM client connections. Use an appropriate profile that will facilitate
connectivity to the HTTP URL of the Now IMP Server.
Web Address - This setting should contain the HTTP URL for connecting to the Now
IMP Server. For example, http://ip.address:port or http://host.name:port. The :port
suffix is required unless the HTTP Port Number for the Now IMP Server is the default
HTTP port of 80.
User ID - This setting should contain the name of the user account defined to the Now
IMP Server.
Password - This setting should contain the password of the user account defined on
the Now IMP Server.
For Nokia Series 40 phones, IM settings can be found under by selecting Messages
from the main menu. Then select Chat and Connect. Settings.
For these devices, it is difficult to select an existing configuration setting that is used by
the mobile phone browser, and adapt it for use by the IM Client. You may need to
manually copy the settings that are used by the WAP browser on the phone by writing
them on paper, and re-entering them into the IM Client settings.
When you edit the active chat and presence settings, the following settings are
included:
Chat and presence service name - This is a descriptive name for the server which is
The IM Client on the Motorola V80 is not as sophisticated as the clients on the Nokia
and SonyEricsson phones. It is definitely a first generation effort and is likely to
improve in future phones. One consideration to be aware of with the Motorola V80 is
that it uses a text based version of the IM protocol to communicate with the Now IMP
Server. This results in considerable overhead, with typical transactions, including
polling transactions, transmitting ten times as much data. This phone should definitely
only be used as an IM client in environments where you have an unlimited GPRS data
subscription plan.
The configuration settings for the IM Client can be found under the IM option of the
main menu. Select Offline Settings, and ISP Settings to access the configuration
settings.
GPRS APN - This specifies the Access Point Name (APN) on the GPRS network that
should be used for establishing IP connectivity for the IM client.
The Now IMP Client for Windows is included with the Now IMP Server.
The installation program, IMPClient.exe, is run to install the Now IMP Client on a PC
running Windows 98, Windows ME, Windows NT 4.0, Windows 2000, Windows XP, or
Windows 2003.
After installing the Now IMP Client, select its link from the Windows Start menu.
A login screen will be displayed:
The main screen for the Now IMP Client would normally display the status of those
individuals who are on your instant messaging contact list. However, since this is the
first login, your account will not yet have any instant messaging contacts configured.
This warning is normal. The Now IMP Client uses an internal library which identifies
itself as the Instant Messenger for XMPP. If you select Keep Blocking, this will disable
the ability to perform file transfers via the IM client. If you select Unblock, this will allow
file transfers via the IM client. (Note that file transfers are only available between two
computers that are on the same Local Area Network.)
Now you will want to configure your instant messaging contacts. Either select the link
on the main screen that is labeld Add someone to your contact list, or select
Actions/Add a contact from the menu bar.
It is necessary to supply some information to search for a user. Enter this information,
and press Search.
An authorisation request will be sent to the user, asking if it is permissable for you to
add them to your contact list.
Additional information on using the Now IMP Client can be found elsewhere in this
document, beginning on page 65
This page is used to start and stop the Now IMP Server. It is also used to install Now
IMP as a Windows service, so that it is automatically started every time the PC is
rebooted. The following settings are available on this page:
Run as a Service - Check this setting to install Now IMP as a Windows service.
Remove the check to remove Now IMP from running as a Windows Service.
Start - This button is enabled if the Now IMP Server is not running. Press this button to
start the Now IMP Server.
Stop - This button is enabled if the Now IMP Server is currently running. Press this
button to stop the Now IMP Server.
Service Information - This box contains information about the running service.
This page contains general server configuration settings for the Now IMP Server.
IP Address – This box contains a list of the of the IP Addresses available on the
computer. For configurations where multiple IP addresses are configured on the
computer, it is possible to configure the Now IMP Server to listen for HTTP connections
on the specified port for only a specific IP address. Select one of the listed IP
addresses, or select all available to have the Now IMP Server listen for connections on
any IP address bound to the computer.
HTTP Port Number - This specifies the TCP/IP Port Number on which the Now IMP
Server should listen for connections from mobile IM Clients (Wireless Village / OMA
IMPS Protocol).
HTTPS Port Number - This specifies the TCP/IP Port Number on which the Now IMP
Server should listen for SSL/TLS connections from mobile IM Clients (Wireless Village /
OMA IMPS Protocol). This option is only enabled if an SSL/TLS certificate has been
generated on the SSL/TLS page of the configuration dialog.
To enable the XMPP Server interface, you must define the XMPP Domain Name. This
This page contains general configuration settings for the Now IMP Server.
Session Timeout - This specifies the number of seconds of inactivity before which a
client session is considered inactive. (Note: Even though a session may become
inactive, provisions are in place to allow a session to automatically reconnect without
user intervention.)
Keep Alive Time for Clients - This specifies a time interval, in seconds, that is
broadcast by the server to connected IM Clients. The server informs clients that it
expects to receive a request within this time interval before it may consider a session
inactive. (Note that while this is similar in concept to Session Timeout, that setting
refers to the actual session timeout used by the server, while this is the setting that is
broadcast to IM clients.) Some IM clients will use this is a suggestion for clients as to
the amount of time between polling requests issued by the client.
Minimum Server Poll Interval – This is the minimum amount of time that is required to
elapse between client polling requests of the server. This setting does not control how
often the client polls the server, but rather if the client needs to make multiple requests
Most mobile phone IM clients will connect to the Now IMP Server via a WAP Proxy
server. The typical mode of operation is for an IM client to establish an IP connection
(GPRS/EDGE/UMTS), and poll the server for new messages.
For some IM clients, such as those on SonyEricsson phones, it is advantageous to
install the Now IMP Server in conjunction with a Now.WAP Proxy Server. In this
configuration, the Now IMP Server is able to send WAP push messages through the
Now.WAP Proxy to alert the mobile phone IM client to new IM messages without
requiring polling.
The Now IMP Server also directly supports a separate TCP/IP push channel, which is
used by Nokia IM clients.
The Now IMP Server supports three types of WAP Push notification for IM events:
1.) WAP Push over UDP
2.) CIR TCP Push Channel (STCP)
3.) WAP Push over SMS
WAP Push over UDP is used when a mobile phone connects to Now IMP Server via a
WAP proxy. This type of connection is commonly used in the IM clients built into
SonyEricsson phones.
To support WAP Push over UDP, the Now IMP Server needs to be able to identify the
IP address of the IM client. In a typical configuration, the Now IMP Server will only see
the IP address of the WAP proxy.
To identify the IP address of the IM client, Now IMP must receive the IP address via an
HTTP header that is forwarded by the WAP proxy. The Now IMP Server automatically
looks for X-WAP-Client-IP: and X-Network-Info: headers that are generated by the
Now.WAP Proxy. If the Now IMP Server needs to be configured to look at additional
headers, these headers can be specified as a comma delimited list under the HTTP
Headers for IP Address setting.
Note that in most configurations of a Now IMP Server residing outside of an operator
network, having the IP address of the IM Client is not sufficient for allowing WAP Push
over UDP. This is because in most operator configurations, the mobile phones are
assigned a private IP address on the operator network, and connect to the external
world via a Network Address Translation (NAT) router. This private IP address is not
accessible to the outside world.
For the reason detailed above, the Now IMP Server has special hooks to integrate with
the Now.WAP Proxy Server v2.55 or later. When Now IMP connections are proxied via
the WAP protocols by a Now.WAP server, the Now IMP Server and Now.WAP Proxy
can cooperate to ensure that WAP Push messages over UDP can be delivered, even
when the mobile phone is connected to a private IP address. The Now IMP Server and
Now.WAP Proxy will detect each other automatically to facilitate this cooperation.
However, it is necessary that in the Now.WAP Proxy, the Forward X-MSISDN: header
in content server requests setting is enabled, and that the domain name and/or IP
address of the Now IMP Server be listed in the Content Domains to receive X-MSISDN:
header. This is required even if the Now.WAP Proxy is not able to actually
receive MSISDN information via RADIUS, as these settings will also enable the
enhanced cooperation between the two servers. (Note: The Now.WAP Proxy
server can be installed outside of the operator network.)
The Now IMP Server can use WAP Push notifications over SMS by routing them via a
WAP Push Proxy Gateway (PPG), such as the Now SMS/MMS Gateway. WAP Push
requests are delivered to the PPG using the Push Access Protocol (PAP).
To send WAP Push notifications via a WAP Push Proxy Gateway, check Enable SMS
Push via WAP Push Proxy Gateway (PPG), and supply the settings to connect to the
WAP Push Proxy Gateway.
The PPG Server URL is an HTTP URL for connecting to the Push Proxy Gateway. For
the NowSMS PPG, this URL is generally of the format http://ip.address:port/PAP, where
ip.address is the IP address or DNS host name of the NowSMS server, and port is the
port number for the web interface. “/PAP” is a path in the URL that tells NowSMS that
the request is using the Push Access Protocol (PAP).
User Name and Password are optional parameters, that if present, are used to build a
basic authentication (“Authorization:”) header in the PAP request. In most situations,
this is how the Now IMP Server will authenticate to the PPG.
PPG Push Domain is a configuration setting that is required by some PPGs. When
Now IMP generates a PAP push request, if a PPG Push Domain value is present, it will
be included in the destination push address. For example, if no PPG Push Domain
value is present, the destination push address will be of the format
WAPPUSH=99999999/TYPE=PLMN. If a PPG Push Domain of operator.net is
present, the destination push address will be of the format
WAPPUSH=99999999/TYPE=PLMN@operator.net. Whether or not a PPG Push
Domain is required depends on the PPG, and you will need to check with the
administrator of the PPG. (For NowSMS, the PPG Push Domain field can be left
blank.)
If WAP Push over SMS is enabled, Now IMP will only use WAP Push over SMS for
accounts that have a phone number defined.
By default, WAP Push over SMS will only be used to notify the client of new messages,
and not for updated presence information. If you wish to have the Now IMP Server also
generate WAP Push over SMS for presence updates, you must manually add a
configuration setting to NOWIMPS.INI. Under the [NOWIMPS] header, add
PushMessagesOnly=No. When this setting is present, Now IMP will generate WAP
Push over SMS messages for both notification of new messages and for updated
presence information.
If “Enable Direct WAP Push over UDP" is also enabled, and the server has an IP
address to which to attempt to send a WAP Push over UDP, the server will first attempt
to send the WAP Push over UDP. If the client does not respond to the push within a
timeout period, a WAP Push over SMS will then be attempted. (The default timeout for
WAP Push over UDP is 12 seconds, and can be configured by editing NOWIMPS.INI,
and placing UDPPushTimeout=### under the [NOWIMPS] header.)
The Now IMP Server supports external connectivity via a built-in e-mail gateway,
allowing IM users to send messages to e-mail recipients, and allowing e-mail users to
send messages to IM recipients.
To enable this capability, you must configure settings for the SMTP server that is built
into the Now IMP Server. These settings are configured on the SMTP page of the
configuration dialog.
To enable SMTP e-mail connectivity, check Enable SMTP Server. You should then
configure a host and domain name for the SMTP server. The Host Name should be a
host name for the server which has been configured for internet DNS. When initiating
outbound SMTP connections, the SMTP server will identify itself with this host name.
The Domain Name will be used as the e-mail domain name for routing SMTP e-mail
messages to IM user (e.g., user@domain). Internet DNS should be configured with a
mail exchange (MX) record to route e-mail for this domain to the Now IMP Server (or to
another SMTP server that relays the mail to the Now IMP Server).
The SMTP Port Number is the port number on which the server will listen for inbound
IM User accounts are defined on the Users page of the configuration dialog.
The SSL/TLS page allows you to configure setting related to the use of secure
protocols for client connections to the Now IMP Server.
When Now IMP is initially installed, you must generate an SSL/TLS server certificate
before any secure connections will be allowed.
Press Generate Server Certificate to start the process of generating an SSL/TLS server
certificate.
To request a certificate from a certificate authority, you will need to deliver a certificate
sign request (CSR) to the authority. Now IMP has created a file named SSL.CSR in the
NowIMP program directory which contains the CSR. This file is in text format and can
be opened with a simple text editor, such as Notepad.
When you receive a signed certificate back from the authority, that certificate should be
saved in a text file named SSL.CA, and located in the NowIMP Directory.
You must restart the Now IMP Server in order to recognise any certificate changes.
The serial number page is used to enter serialisation information for a purchased copy
of the Now IMP Server product.
A web interface is available for provisioning Now IMP user accounts. To enable this
interface, the Web Admin User Name and Web Admin Password settings on the
Options page of the configuration dialog must be non-blank. Web administration
functionality can be limited to a specified list of IP addresses by entering one or more IP
addresses in the Admin IP Address Restrictions field. The IP address restrictions
field can contain a comma-delimited list of IP addresses, with the ability for wild cards to
be specified (e.g., 192.168.1.*,127.0.0.1).
When the web administrative interface is enabled, it is possible to connect to this
interface by connecting to the HTTP port of the Now IMP Server, and including /ADMIN
in the URL (e.g., http://ip.address:port/ADMIN).
Additionally, an HTTP-based interface has been added to allow for account provisioning
by external applications. This interface is accessed with a URL of "/provision" followed
by a series of "HTTP GET" parameters. (The admin username and password must be
supplied in the HTTP GET request within an "Authorization:" header.)
The following parameters are supported in this interface:
• AdminAction=Add, Modify, Delete, or Query
• UserName=
• Password=
• Firstname=
• Lastname=
• Alias=
• PhoneNumber=
• EmailAddress=
• AgentURL=
<NowIMPInfo>
<UserList>
<UserInfo>
<UserName>bryce</UserName>
<FirstName>Bryce</FirstName>
<LastName>Norwood</LastName>
<Alias>bryce</Alias>
<PhoneNumber>123</PhoneNumber>
<EMailAddress>nowsms@now.co.uk</EMailAddress>
</UserInfo>
</UserList>
</NowIMPInfo>
If multiple users match the query, the “UserInfo” element will be repeated for each user.
Fields that are not defined for a user, or are left blank (e.g., Alias, PhoneNumber,
EmailAddress), will not be included in the XML response.
For user accounts that are Automated Agents (see page 42), two additional fields will
be included in UserInfo section of the response:
<IsAgent>TRUE</IsAgent>
<AgentURL>http://www.now.co.uk/echo.asp</AgentURL>
<NowIMPInfo>
<ActiveUserList>
<UserInfo>
<UserName>bryce</UserName>
<Protocol>XMPP</Protocol>
<Resource>Now IMP</Resource>
</UserInfo>
<UserInfo>
<UserName>kent</UserName>
<Protocol>IMPS</Protocol>
</UserInfo>
</ActiveUserList>
<ActiveConferenceRoomList>
<ConferenceRoomInfo>
<ConferenceRoomID>/test.conference.room</ConferenceRoomID>
<ConferenceRoomActiveUserList>
<UserName>bryce</UserName>
<UserName>kent</UserName>
</ConferenceRoomActiveUserList>
</ConferenceRoomInfo>
</ActiveConferenceRoomList>
</NowIMPInfo>
When adding an automated agent user account, the setting User account is an
automated agent should be checked.
Every time the Now IMP server receives an instant message for the agent, it will
connect to an HTTP script to allow the agent to process the message. The URL for the
script that you want to associate with the agent should be defined in the Agent URL
parameter of the account.
Now IMP will pass information about the received message to the URL using standard
HTTP GET (CGI style) parameters. The “from=” parameter will contain the sender's IM
address. The “to=” parameter will contain the agent's IM address. The “text=”
parameter will contain the text of the received message.
For example:
http://www.now.co.uk/echo.asp?from=bryce&to=agent&text=this%20is%20a%20test
Parameters are escaped using standard URL escaping. Notice in the example above
that space characters have been replaced with “%20”.
<?
header ("Content-Type: text/plain");
if (isset($_REQUEST['text'])) {
echo "ECHO : " . $_REQUEST['text'];
}
?>
While extremely simplistic, both of the above examples illustrate how an agent script
can process received URL parameters, and generate a reply.
Examples:
http://server:port/agent?User=agent&password=agent&text=This+is+a+broadcast+m
essage+to+all+who+have+added+the+agent+to+their+contact+list.&broadcast=allon
line
http://server:port/agent?User=agent&password=agent&text=This+is+a+message+to+
2+user+accounts.&to=bryce,kent
http://server:port/agent?User=agent&password=agent&text=This+is+a+message+to+
2+user+accounts.&to=bryce%2Ckent
http://server:port/agent?User=agent&password=agent&text=This+is+a+broadcast+m
essage+to+all+connected+users.&systembroadcast=allonline
Most mobile phones that support IMPS have the ability to receive settings for the IMPS
client over-the-air (OTA). This means that the IMPS settings can be sent to the mobile
phone in an SMS message (actually a series of SMS messages are sent that are
treated as a single message by the receiver).
Currently there are two different formats for these OTA messages.
SonyEricsson utilises the format defined by the Nokia/SonyEricsson OTA Specification
v7.1.
Nokia (and other vendors) use the format defined by the Open Mobile Alliance (OMA)
Provisioning Content specification.
Both of these OTA formats use XML based documents, however the XML schema is
significantly different between the two formats.
When the documents are sent out via SMS, they are encoded in a wireless binary XML
(WBXML) format.
One way of sending out these settings documents is using the Now SMS/MMS
Gateway product.
From the Send XML Settings option of the NowSMS web interface, it is possible to
send an XML document containing IMPS settings to a mobile phone.
Programatically, it is possible to post the XML settings document to the NowSMS server
to request that it be sent out via SMS.
An example HTTP POST of an XML settings document to a NowSMS server looks like
this:
POST /?PhoneNumber=xxxxxxxx&OTA=POST HTTP/1.0
Content-Length: yyyyyy
(*blank line*)
<xml settings document>
The “Content-Length:” header specifies the length of the XML document that follows.
(This tells the server how much data to expect in the XML document.)
Optionally, the POST line can be modified to include a username and password to
authenticate to the NowSMS server:
POST /?PhoneNumber=xxxxxxxx&user=username&password=password&OTA=POST HTTP/1.0
Content-Length: yyyyyy
(*blank line*)
<xml settings document>
Note that some Nokia phones require that OTA settings be signed with a PIN code.
The receiving user is then prompted to enter that PIN code when opening the message
The following document is an example OTA document for provisioning the IM client on
a SonyEricsson phone.
<WVSettings>
<WVOTAVersion>1.0</WVOTAVersion>
<WVCommon>
<WVSettingsName>NowIMP</WVSettingsName>
<WVRefName>Internet Profile</WVRefName>
<WVSupportedVersion>1.0</WVSupportedVersion>
<WVSupportedVersion>1.1</WVSupportedVersion>
<WVUserID>username</WVUserID>
<WVPassword>password</WVPassword>
<WVPreferredProtocol></WVPreferredProtocol>
</WVCommon>
<WVHTTP>
<WVSAPURI>http://server:port/</WVSAPURI>
<WVSAPFourWaySupported>T</WVSAPFourWaySupported>
</WVHTTP>
</WVSettings>
Note that in the above settings that there are five fields that you will need to replace
with your settings.
WVSettingsName – This text contains a descriptive name for the settings. (Note that
current SonyEricsson phones seem to ignore this value.)
WVRefName – This text should contain the name of an existing Internet Profile that has
been configured in the mobile phone. Note that it is not possible to provision a new
internet profile at the same time as sending IM settings. If you also need to configure
an internet profile to be used with the settings, a separate configuration message must
be sent with the internet profile settings first. It is possible to remove this statement
from the settings message, in which case the IM client will prompt to select a profile.
WVUserID – This text should contain the name of the user account on the server.
WVPassword – This text should contain the password of the user account on the
server.
WVSAPURI – This text should contain the HTTP URL for connecting to the Now IMP
Server.
<CHARACTERISTIC-LIST>
<CHARACTERISTIC TYPE="ADDRESS">
<PARM NAME="BEARER" VALUE="GPRS"/>
<PARM NAME="PROXY" VALUE="1.2.3.4"/>
<PARM NAME="GPRS_ACCESSPOINTNAME" VALUE="gprs.apn"/>
<PARM NAME="PPP_AUTHTYPE" VALUE="PAP"/>
<PARM NAME="PPP_AUTHUSER" VALUE="GPRSusername"/>
<PARM NAME="PPP_AUTHSECRET" VALUE="GPRSpassword"/>
</CHARACTERISTIC>
<CHARACTERISTIC TYPE="URL" VALUE="http://homepage"/>
<CHARACTERISTIC TYPE="NAME">
<PARM NAME="NAME" VALUE="Internet Profile"/>
</CHARACTERISTIC>
</CHARACTERISTIC-LIST>
To adapt the above example to your environment, several changes are required.
The PARM NAME=”PROXY” value should be changed to reference the IP address of
the WAP proxy to be used. (We recommend using a conventional WAP proxy via the
WSP stack instead of the HTTP stack, as this is the only way to support push
notifications over IP to these devices.)
The PARM NAME=”GPRS_ACCESSPOINTNAME” value should be changed to
reference the GPRS Access Point Name (APN) of the subscriber's mobile operator.
The lines containing PARM NAME=”PPP_AUTHUSER” and “PPP_AUTHSECRET”
can be removed if no username and password is required for connecting to the GPRS
APN. If a username and/or password is required, the values should be edited as
appropriate for the connection.
The CHARACTERISTIC TYPE=”URL” value will contain the home page associated
with the internet profile being created. Although there is not strictly a home page
associated with this connection, it is a good idea to specify a valid WAP portal entry
page here.
The PARM NAME=”NAME” value should be changed to contain a descriptive name for
the settings. Note that the value here will correspond to the WVRefName value in an
IM Settings message.
The following document is an example OTA document for provisioning the IM client
using OMA (Open Mobile Alliance) Provisioning Content, as deployed on Nokia phones.
<wap-provisioningdoc>
<characteristic type="BOOTSTRAP">
<parm name="NAME" value="NowIMP"/>
</characteristic>
<characteristic type="NAPDEF">
<parm name="NAME" value="NowIMP"/>
<parm name="NAPID" value="NowIMP_NAPID"/>
<parm name="BEARER" value="GSM-GPRS"/>
<parm name="NAP-ADDRESS" value="grps.apn"/>
<parm name="NAP-ADDRTYPE" value="APN"/>
<characteristic type="NAPAUTHINFO">
<parm name="AUTHTYPE" value="PAP"/>
<parm name="AUTHNAME" value="GPRSusername"/>
<parm name="AUTHSECRET" value="GPRSpassword"/>
</characteristic>
</characteristic>
<characteristic type="PXLOGICAL">
<parm name="NAME" value="NowIMP"/>
<parm name="PROXY-ID" value="NowIMP_Proxy"/>
<characteristic type="PXPHYSICAL">
<parm name="PHYSICAL-PROXY-ID" value="NowIMP_PhProxy"/>
<parm name="PXADDR" value="1.2.3.4"/>
<parm name="PXADDRTYPE" value="IPV4"/>
<parm name="TO-NAPID" value="NowIMP_NAPID"/>
<characteristic type="PORT">
<parm name="PORTNBR" value="8080"/>
</characteristic>
</characteristic>
</characteristic>
<characteristic type="APPLICATION">
<parm name="APPID" value="wA"/>
<parm name="TO-PROXY" value="NowIMP_Proxy"/>
To adapt the above example to your environment, a number of changes are required.
There are several places in the settings document where parm name=”NAME”
value=”NowIMP” appears. In these cases, “NowIMP” is a descriptive name that is
being associated with the settings. This name is displayed in the user interface of the
mobile phone as a name associated with the IM server and settings, and you should set
this to a name to an appropriate descriptive name for your environment.
You will notice that there are also a number of other places where “NowIMP” appears
as a prefix in the value parameter. This is done to indicate that portions of the settings
are related. While these settings are not displayed anywhere in the phone's user
interface, you may want to change the prefix to one that is specific to your environment.
The parm name=”NAP-ADDRESS” value should be changed to reference the GPRS
Access Point Name (APN) of the subscriber's mobile operator.
The lines containing parm name=”AUTHUSER” and “AUTHSECRET” should be
removed if no username and password is required for connecting to the GPRS APN. If
a username and/or password is required, the values should be edited as appropriate for
the connection.
The parm name=”PXADDR” value should be changed to reference the IP address of
the WAP/HTTP proxy to be used. Note that all Nokia phones that support these
configuration parameters are expecting to connect to an HTTP/WAP2 proxy server.
The parm name=”PORTNBR” value should be changed to reference the port number
to be used on the WAP/HTTP proxy.
The parm name=”ADDR” value should contain the HTTP URL for connecting to the
Now IMP Server.
The parm name=”AAUTHNAME” value should contain the username of the account
on the Now IMP Server, and the parm name=”AAUTHSECRET” value should contain
the password for that same account.
The Now IMP Server includes an interface for allowing users to self-register with the
IMP Server via the web. This interface is designed primarily to help simplify the
process of evaluating the product, and allowing product evaluators an easy way to
create accounts.
When this interface is enabled, it is possible to connect to this interface by connecting
to the HTTP port of the Now IMP Server, and including /SIGNUP in the URL (e.g.,
http://ip.address:port/SIGNUP).
The interface will prompt for a valid e-mail address. It will then send a sign-up
authorisation code to that e-mail address, and require that the user supply this
authorisation code in order to complete the registration process.
To enable this interface, it is necessary to manually edit the NOWIMPS.INI file (located
in the NowIMP program directory), and under the [NOWIMPS] header, add
EmailSignupSupported=Yes. It is also necessary to enable the SMTP e-mail server
that is built into the Now IMP Server.
The self-user provisioning interface uses HTML template files that are located in the
WEB\SIGNUP subdirectory of the NowIMP installation.
The index.htm template file is used to construct the initial screen that is displayed
when connecting to the /SIGNUP URL, as displayed below:
After entering the authorisation code that was received via e-mail, the user is presented
with a screen (account.htm template) that allows them to define an account on the
Now IMP Server.
7
The Server URL in the template is read from an entry in the NOWIMPS.INI file. Under
Note that it is not possible for the user to change the e-mail address associated with an
account. This can only be changed through the administrative interface.
<showsignup>yes</showsignup>
<websignup>http://your.signup.url/path/here</websignup>
If you want to use the built-in User Self Provisioning, specify a websignup URL of
http://server:port/signup.
This warning is normal. The Now IMP Client uses an internal library which identifies
itself as the Instant Messenger for XMPP. If you select Keep Blocking, this will disable
the ability to perform file transfers via the IM client. If you select Unblock, this will allow
file transfers via the IM client. (Note that file transfers are only available between two
computers that are on the same Local Area Network.)
Now you will want to configure your instant messaging contacts. Either select the link
on the main screen that is labeld Add someone to your contact list, or select
Actions/Add a contact from the menu bar.
Searching for a user via the directory is the default option, so press Next.
An authorisation request will be sent to the user, asking if it is permissable for you to
add them to your contact list.
The server will not display presence information for another user unless that user has
authorised it. (Note that some mobile IM clients do not accept presence authorisation
requests. Instead, affected clients have configuration parameters that specify whether
authorisation is granted to anyone who asks, or if it is granted only to those that have
been added to the mobile's contact list.)
Press Finish to send the authorisation request.
Please note that the contact will not appear in your contact list until:
• They have authorised your presence request, or it is automatically authorised based
upon settings defined in the mobile IM client.
• The user must be on-line. Contacts will not display in your contact list unless they
are connected to the IM server. (A user's status can be busy or away, and they will
appear in the contact list. However, if they are not connected, they will not appear.)