AMIGOPOD PowerConnect W Clearpass 100 Software User manual

Copyright © 2010 amigopod. All rights reserved.
SMS over SMTP
Unified Visitor Management
amigopod Technical Note
Revision 1.0
26 August 2010
United States of America
[phone]
Europe, Middle East & Asia
[phone]
Australia & Pacific
[phone]
http://www.amigopod.com

SMS over SMTP Version <Ver>
CONFIDENTIAL 2
Table of Contents
Introduction ..............................................................................................................................3!
Audience ..............................................................................................................................3!
Document Overview .............................................................................................................3!
Disclaimer.............................................................................................................................3!
Configuring SMS over SMTP...................................................................................................4!
Check Plugin Versions .........................................................................................................4!
Enable Advanced Gateways ................................................................................................4!
Select the Supported Carriers..............................................................................................4!
Create the SMS to SMTP Gateway......................................................................................5!
Send a Test Message ..........................................................................................................6!
Example Guest Self-Registration.............................................................................................7!
Mobile Self-Registration .......................................................................................................7!
Create the Self-Registration.................................................................................................7!
Customize Register Page Form ...........................................................................................8!
Troubleshooting .....................................................................................................................13!
SMTP .................................................................................................................................13!
Country Codes ...................................................................................................................13!

SMS over SMTP Version <Ver>
CONFIDENTIAL 3
Introduction
This technical note explains how to configuration process for sending SMS
text messages to end-users via SMTP (e-mail).
Sending via SMTP is a cost effective SMS solution, but requires extra input
from the end user. They will need to enter both their mobile number and their
carrier. The carrier is not always known, as some carriers require a separate
address for pre-paid plans, or they may grandfather the format after buying
another carrier.
Audience
This document is intended for network administrators and system integrators
deploying an amigopod-based visitor management solution.
Basic familiarity with the amigopod Visitor Management Appliance is
assumed. For in-depth information about the features and functions of the
amigopod appliance, refer to the amigopod Deployment Guide.
Document Overview
The first section of the document explains the configuration of the SMS
Gateway itself.
The next section contains an example guest self-registration that utilizes their
mobile number and SMS.
The last section contains some troubleshooting topics.
Disclaimer
The topics of network design, security architectures and visitor access are
complex subjects, and no single document can hope to cover all of the
possible combinations of network equipment, network design, deployment
requirements, and device configurations, nor can all the possible security
implications for a particular recommendation be covered.
Therefore, while you read this document, it is best to consider it as a guide to
developing your own understanding of the network design topics covered,
and as a basis for further investigation.

SMS over SMTP Version <Ver>
CONFIDENTIAL 4
Configuring SMS over SMTP
Check Plugin Versions
SMS over SMTP requires the following plugin versions:
SMS Services Plugin 2.9.2 or later
To verify you have the correct plugin versions installed, navigate to
Administrator > Plugin Manager > Manage Plugins and check the version
number in the list.
Use the Update Plugins link to download and install updated plugins.
If you do not have the required version, or the SMS Services Plugin is
missing, please contact your amigopod reseller.
Enable Advanced Gateways
By default, the SMS Services configuration only supports the amigopod
supported SMS solutions. For SMTP, we require the advanced modules
turned on.
While still on Manage Plugins, select Configure under the SMS Services
Plugin.
Enable Allow advanced SMS handlers and Display Carrier SMTP List and
then click Save Configuration.
Select the Supported Carriers
When the configuration above is saved, a new navigation element SMTP
Carriers will appear under SMS Services. You must enable the carriers you
wish to support. A list of the supported carriers will be presented to the user
during registration. If you make the list too long, you risk overwhelming the
user or are more likely to have them select the wrong carrier.

SMS over SMTP Version <Ver>
CONFIDENTIAL 5
The enabled carriers will appear bolded in the list.
NOTE A useful reference site for determining the address syntax is:
http://en.wikipedia.org/wiki/List_of_carriers_providing_SMS_transit. If
necessary you can create or edit an existing entry as you find neceary.
Create the SMS to SMTP Gateway
Amigopod supports multiple SMS gateways used under different scenarios.
We must create a gateway for the other plugins to interact.
Navigate to SMS Services > SMS Gateways and select Create new SMS
gateway.
Select SMS over SMTP as the SMS Gateway. All other entries can be left
blank.
If the gateway is not bolded after you Save Changes, it is not the default SMS
gateway.
Select Make Default.

SMS over SMTP Version <Ver>
CONFIDENTIAL 6
Send a Test Message
Select Send SMS to open the test form. Enter your mobile number and
carrier, and write yourself a brief message.
Click Send Message and you should see a positive response.
Messages sent over SMTP may take a number of seconds to arrive. If the
message takes longer than a couple of minutes, you may want to check the
inbox of your SMTP account.
NOTE The use of SMS over SMTP requires a pre-configured SMTP setup under
Administrator > Network Setup > SMTP Configuration. Please refer to the
documentation if SMTP requires configuration.

SMS over SMTP Version <Ver>
CONFIDENTIAL 7
Example Guest Self-Registration
Mobile Self-Registration
We will create a guest self-registration that asks for their mobile number and
name. The mobile number will become their username.
Create the Self-Registration
Navigate to Guest Manager > Customization > Guest Self-Registration
and select Create new self-registration page. Enter the fields as desired
and Save Changes.

SMS over SMTP Version <Ver>
CONFIDENTIAL 8
Customize Register Page Form
Select Form under Register Page to display the list of fields.
Adjust the fields as desired. In this case we have disabled email.As stated
above, we want to use the phone as the username. In order to do this, we
need to add the username field and re-label it accordingly. Select
visitor_name and click Insert After. Select username under Field Name
and allow the page to refresh. Override the Label and Description as
desired.

SMS over SMTP Version <Ver>
CONFIDENTIAL 9
Save Changes and then select Insert After from the username selection.
Select visitor_carrier under Field Name and allow the page to refresh.
Override the Label and Description as desired.
The fields list.

SMS over SMTP Version <Ver>
CONFIDENTIAL 10
Select Back to guest self-registration editor at the bottom of the fields list.
Select Form under Receipt Page and select visitor_phone.Select Insert
After to add the carrier selection. Select visitor_carrier under Field Name
and allow the page to refresh. Override the Description as ‘_’. A single
underscore ‘_’ denotes do not display a description.
Select Back to guest self-registration editor at the bottom of the fields list.
Select Actions under Receipt Page. Under SMS Delivery choose Always
auto-send guest receipts by email under Enabled, username as the
Phone Number Field, and SMS over SMTP as the Service Provider.
Save Changes to return to the main editor. Select Launch this guest
registration page and enter your credentials.

SMS over SMTP Version <Ver>
CONFIDENTIAL 11
Click Register. The receipt page will be displayed.
You should have received the credentials over SMS as well.

SMS over SMTP Version <Ver>
CONFIDENTIAL 12

SMS over SMTP Version <Ver>
CONFIDENTIAL 13
Troubleshooting
SMTP
If email itself does not seem to be working, please consult the documentation
and troubleshooting for setting up a mail access.
For SMS purposes, we highly suggest a true SMTP server over sendmail, as
you will want to accept replies and detect failures.
Country Codes
Certain carriers are more open to whether or not the country code is allowed.
For instance, T-Mobile North America will work with and without the ‘1’.
However, AT&T must always have the 10-digit number by itself. If a 1 is
included the transmission will fail. Email is asynchronous,thus the only
means of detecting failed messages is to tend to the INBOX of the sending
account.
To make this easier on the end-users, each carrier can be configured to
override the country code value. Select the carrier under SMS Services >
SMTP Carriers and click Edit.You have the following options:
Use the visitors value
Always include the country code
Never include the country code