The interface is HTTP “GET” based, and requires that the HTTP request include an Authorization header. The Authorization header is set with the BASE64 encoded value of “username:password”, where username and password are the values configured for the MMSC Admin interface.

HTTP/provision?AdminAction=Action&PhoneNumber=number&Name=AliasName&Password=password&FullName=Full+Name HTTP/1.0 Authorization: username:password (BASE64 encoded)
<blank line>

Valid values for “AdminAction” are “Add”, “Modify” and “Delete”.

All actions require that a “PhoneNumber” be specified. (If you are configuring phone numbers in international format, be sure to remember that HTTP GET URL parameters must be URL encoded, so that “%2B” is used to represent the “+” character.) The other parameters (Name, Password and FullName) are optional.

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.

Support for restricting access to the MMSC Admin and provisioning web functions by IP address was added in v4.11 of the Now SMS/MMS Gateway. Under the [MMSC] section header, use the AdminIPAddressList setting, which is a comma delimited list of IP addresses that are allowed access to the gateway. Do not include any spaces between addresses. To specify a wildcard address for a subnet, use the "*" character (for example, 192.168.1.* to allow all addresses in the 192.168.1 subnet).

Return to Now SMS/MMS Gateway Technical Bulletins