V5.51: SMS/MMSC User Account Provisioning via Web

V5.51: SMS/MMSC User Account Provisioning via Web SearchSearch
Author Message
Bryce Norwood - NowSMS Support
Board Administrator
Username: Bryce

Post Number: 3314
Registered: 10-2002
Posted on Friday, August 20, 2004 - 03:09 pm:   

In NowSMS v5.51, a web interface has been added for provisioning "SMS Users" and "MMSC Users" accounts.

To enable this interface, check the checkbox on the "Web" page of the NowSMS configuration dialog, and define a username and password to be used for access to these functions via the web interface. Web administration functionality can be limited to a specified list of IP addresses by entering one or more IP addresses in the "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 web administration is enabled, accessing the web interface with a URL of "/admin" will allow access for the web interface for account administration.

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.)

Two different provisioning request formats are defined, one for defining "SMS Users" accounts, and a second for defining "MMSC Users" accounts.

If a parameter of "Type=SMS" is specified, the following parameters are supported:

AdminAction=Add, Modify, Delete, or CreditCheck
Name=Account Name
Password=password
Fullname=Full Name
EnableWebLogin=Yes/No
EnableSmppLogin=Yes/No
EnableSmtpLogin=Yes/No
ForcedSenderAddress=Sender Address
RestrictIPAddress=list of IP addresses
EnableCreditBalance=Yes/No
CreditsToAdd=####
MessageLimitDefault=Yes/No
MessageLimitPerDay=####
MessageLimitPerMonth=####
RecipientAddresses=list of recipient phone numbers that should be routed to this account


As an example, to add credits to an existing account, issue the following URL request:

http://server:port/provision?Type=SMS&AdminAction=Modify&Name=accountname&Credit sToAdd=100


Assuming that the user is authorized to issue a provisioning command (valid username/password, and supported IP address for originating the request), the server will return a normal HTTP response code of 200 with a MIME content type of “text/plain”. The response will start with “OK” if the request was successful, or “ERROR” if the request failed. If a "CreditsToAdd" parameter was specified, or "AdminAction=CreditCheck", the HTTP response will include the text "Credits=####", where "####" is the current balance for the account.

If a parameter of "Type=MMS" is specified, the following parameters are supported:

AdminAction=Add, Modify, Delete, or CreditCheck
PhoneNumber=phonenumber
Name=Alias
Password=password
Fullname=Full Name
MessageLimitDefault=Yes/No
MessageLimitPerDay=####
MessageLimitPerMonth=####


More information on NowSMS v5.51 can be found at the following links:

Release highlights: http://www.nowsms.com/newsletter/20040823.htm
Detail of changes: http://support.nowsms.com/discus/messages/53/5898.html
Download (available 23-Aug-2004): http://www.nowsms.com/downloads/smsmmsgateway.htm