In diesem Dokument wird beschrieben, wie Open Source-Lösungen (Postfix, Maildrop, Kannel) in die Cisco Identity Services Engine (ISE) integriert werden, um eine SMS an Benutzer mit Gastkonten zu senden.
Cisco empfiehlt, dass Sie über Kenntnisse in folgenden Bereichen verfügen:
Die Informationen in diesem Dokument basierend auf folgenden Software- und Hardware-Versionen:
Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell eingerichteten Testumgebung. Alle Geräte, die in diesem Dokument benutzt wurden, begannen mit einer gelöschten (Nichterfüllungs) Konfiguration. Wenn Ihr Netz Live ist, überprüfen Sie, ob Sie die mögliche Auswirkung jedes möglichen Befehls verstehen.
Mit der ISE können Sie Gastkonten für den temporären Netzwerkzugriff erstellen, der in der Regel für Gäste, Besucher, Auftragnehmer, Berater und Kunden bestimmt ist. Solche Konten werden von Sponsorbenutzern über das Sponsorportal erstellt. Wenn Sie das Konto erstellen, ist es möglich, ein dynamisch generiertes Zugriffskennwort mit einer SMS direkt an das Mobiltelefon des Gastbenutzers zu senden.
Die Cisco ISE kann diese Anmeldeinformationen mithilfe des Simple Mail Transfer Protocol (SMTP) per E-Mail an das Mail2SMS-Gateway senden. Dieser Gateway ist für die SMS-Zustellung zuständig.
Es gibt mehrere Mail2SMS Gateway Lösungen auf dem Markt. Sie können in der Regel Daten unter Verwendung verschiedener Protokolle empfangen, wie SMTP, Short Message Peer-to-Peer (SMPP), FTP, HTTP (Simple Object Access Protocol (SOAP), Webdienste), und eine SMS-Nachricht an das jeweilige Mobiltelefon senden.
Vielleicht ist es am besten, ein eigenes SMS Gateway zu bauen. Sie ermöglicht:
Eine gemischte Bereitstellung kann sich lohnen - ein persönliches SMS-Gateway, das auch in einen externen Service integriert ist.
Der Ablauf ist wie folgt:
Jedes Modul dieser Lösung (Postfix, Kannel smsbox und Kannel bearerbox) kann auf einem separaten Server installiert werden. Der Einfachheit halber wird dieses Beispiel auf demselben Server konfiguriert.
Führen Sie diese Schritte aus, um die ISE zu konfigurieren.
Postfix ist ein SMTP-Server, der E-Mails von der ISE empfängt. Die Standardkonfiguration wird bis auf einige kleinere Änderungen verwendet. Führen Sie diese Schritte aus, um die Konfiguration vorzunehmen.
myhostname = smtp.test-cisco.com
mydomain = test-cisco.com
mydestination = $myhostname, $mydomain, localhost
local_transport = maildrop
maildrop unix - n n - - pipe
flags=DRhu user=vmail argv=/usr/bin/maildrop -d ${user}
neptun ~ # useradd sms
neptun ~ # passwd sms
New password:
BAD PASSWORD: it is too simplistic/systematic
Retype new password:
passwd: password updated successfully
neptun ~ # chown -R sms:sms /home/sms/
Im Moment sollten alle E-Mails korrekt an den SMS-Benutzer zugestellt werden. Die Maildir-Struktur wird automatisch erstellt, wenn sie zum ersten Mal E-Mails empfängt.
Kurz vor der Zustellung sucht maildrop im Home-Verzeichnis nach .mailfilter für den Benutzer. Wenn diese Datei gefunden wird, wird das Skript ausgeführt. Die Berechtigungen für die Datei sollten auf den folgenden Benutzer beschränkt sein:
neptun sms # touch /home/sms/.mailfilter
neptun sms # chmod go-rwx /home/sms/.mailfilter
Hier der Inhalt der Datei:
# Mailfilter script for parsing ISE SMS messages
# Author: Michal Garcarz at cisco.com
# Date: 1 Dec 2013
#DEFAULT="$HOME/.maildir/"
DATE=`date`
SHELL="/bin/bash"
# Our log file
logfile "/home/sms/maildrop.log"
# Our verbosity in the log file
VERBOSE="5"
log "-------------SMS MAILFILTER LOG-----------"
log "Email received at: $DATE"
if (/^Subject:.*Guest.*Text.*Notification.*/)
{
log "Email processed by script sending SMS via Kannel"
USERNAME=""
PASSWORD=""
TO=""
if (/^text:Username:(.*)/:b)
{
log "Username exists $MATCH1"
USERNAME=$MATCH1
}
if (/^text:Password:(.*)/:b)
{
log "Password exists $MATCH1"
PASSWORD=$MATCH1
}
if (/^to:(.*)/:b)
{
log "Mobile phone exists $MATCH1"
TO=$MATCH1
}
if ($USERNAME ne "" && $PASSWORD ne "" && $TO ne "")
{
log "Sending via HTTP to kannel username=$USERNAME password=$PASSWORD to=$TO"
DATA="ISE Guest portal Username: $USERNAME Password: $PASSWORD"
#also curl can be used instead of wget
xfilter "wget -O/dev/null \"http://192.168.112.100:13013/cgi-bin/sendsms?username=
tester&password=foobar&to=$TO&text=$DATA\" >> /tmp/maildrop-kannel.log 2>>
/tmp/maildrop-kannel.log"
}
#deliver to maildir (not used since xfilter returns !=0)
to $DEFAULT/
}
Das Skript:
Es gibt hier zwei Protokolldateien:
Sowohl smsbox als auch bearerbox können aus der einzelnen Datei konfiguriert werden. Bei dieser Konfiguration wird der externe SMPP-Server für die Übermittlung verwendet. Es ist einfach, mehrere Dienste im Web zu finden, wenn Sie nach der smpp sms Service Provider Phrase suchen. Die Konfiguration ist einfach, da keine SMS-Nachrichten empfangen und weitergeleitet werden müssen. Diese Lösung ist nur für das Senden vorgesehen und verwendet einen SMPP-Anbieter.
Hier ein Auszug aus der /etc/kannel/kannel.conf:
#bearerbox
group = core
admin-port = 13000
admin-password = bar
smsbox-port = 13001
log-level = 0
log-file = "/var/log/kannel/kannel.log"
access-log = "/var/log/kannel/access.log"
# SMSC SMPP
group = smsc
smsc = smpp
host = ****.com
port = 1775
smsc-username = 4ljt7wi3
smsc-password = ******
system-type =
address-range =
# SMSBOX SETUP
group = smsbox
bearerbox-host = localhost
sendsms-port = 13013
sendsms-chars = "0123456789 +-"
global-sender = 12345
log-file = "/var/log/kannel/smsbox.log"
log-level = 0
access-log = "/var/log/kannel/access.log"
white-list =
black-list =
reply-couldnotfetch =
reply-couldnotrepresent =
reply-requestfailed =
reply-emptymessage =
# SEND-SMS USERS, this credentials has been used in wget script
group = sendsms-user
username = tester
password = foobar
user-deny-ip = "*.*.*.*"
user-allow-ip = "192.168.*.*"
# SMS SERVICE Default
# there should be default always (this is for receiving SMS messages - not used)
group = sms-service
keyword = default
text = "No service specified"
Es ist möglich, ein Mobiltelefon über USB anzuschließen und GSM SMSC zu konfigurieren:
group = smsc
smsc = at #type = GSM
smsc-id = usb0-modem
my-number = 1234
modemtype = auto #types: wavecom, siemens, siemens-tc35, falcom,
nokiaphone, ericsson
device = /dev/ttyUSB0 #phone device seen on server
Auf den meisten Telefonen ist es auch erforderlich, die Modemfunktionalität zu aktivieren. In Android Version 2.2 und höher ist es beispielsweise unter Einstellungen/Tethering und Portable Hotspot/USB tethering aktiviert.
Denken Sie daran, sowohl Bearerbox als auch smsbox auszuführen. Hier ein Beispiel:
neptun ~ # /etc/init.d/kannel-bearerbox start
* Starting kannel bearerbox ... [ ok ]
neptun ~ # /etc/init.d/kannel-smsbox start
* Starting kannel smsbox ... [ ok ]
neptun ~ # netstat -atcpn
Active Internet connections (servers and established)
Proto Recv-Q Send-Q Local Address Foreign Address State PID/Program name
tcp 0 0 0.0.0.0:13013 0.0.0.0:* LISTEN 24170/smsbox
tcp 0 0 0.0.0.0:13000 0.0.0.0:* LISTEN 24151/bearerbox
tcp 0 0 0.0.0.0:13001 0.0.0.0:* LISTEN 24151/bearerbox
Zum Starten muss mindestens ein SMSC konfiguriert sein.
Verwenden Sie diesen Abschnitt, um zu überprüfen, ob Ihre Konfiguration ordnungsgemäß funktioniert.
Der Standardport für das Sponsorportal wird verwendet (8443). Der Sponsor meldet sich unter https://ise.test-cisco.com:8443/sponsorportal/ an.
Vergewissern Sie sich, dass dem Sponsor eine E-Mail-Adresse unter Meine Einstellungen zugewiesen wurde:
Erstellen Sie ein Gastkonto mit einer SMS-Benachrichtigung:
Sie erhalten die Bestätigung, dass das Gastkonto erfolgreich erstellt wurde:
Die ISE sendet eine E-Mail an den konfigurierten SMTP-Server.
Der SMTP-Server empfängt die Nachricht und verwendet maildrop, um sie an das lokale Konto (sms@test-cisco.com) zu senden. Hier ist ein Auszug aus /var/log/messages:
Nov 30 22:39:47 neptun postfix/smtpd[18460]: connect from unknown[192.168.112.1]
Nov 30 22:39:47 neptun postfix/smtpd[18460]: 2B36030B32: client=unknown
[192.168.112.1]
Nov 30 22:39:47 neptun postfix/cleanup[18463]: 2B36030B32: message-id=
<563762958.941385847586377.JavaMail.root@ise2>
Nov 30 22:39:47 neptun postfix/qmgr[32658]: 2B36030B32: from=,
size=689, nrcpt=1 (queue active)
Nov 30 22:39:47 neptun postfix/pipe[18464]: 2B36030B32: to=<sms@test-cisco.com>,
relay=maildrop, delay=0.18, delays=0.14/0/0/0.04, dsn=2.0.0, status=sent (delivered
via maildrop service)
Bevor Sie die E-Mail an die SMS senden, führt das Verzeichnis maildir /home/sms/.mailfilter aus, das eine bestimmte Aktion ausführt.
Hier ein Auszug aus dem Verzeichnis /home/sms/maildrop.log:
-------------SMS MAILFILTER LOG-----------
Email received at: Sat Nov 30 22:39:47 CET 2013
Email processed by script sending SMS via Kannel
Username exists jsmith02
Password exists t6ub79_6r
Mobile phone exists 4850xxxxxxx
Sending via HTTP to kannel username= jsmith02 password= t6ub79_6r to=4850xxxxxxx
Das mailfilter-Skript liest alle Daten und führt xfilter aus, das wget aufruft, um alle Parameter an Kannel zu übergeben.
Hier ein Auszug aus dem Verzeichnis /tmp/maildrop-kannel.log:
--2013-11-30 22:39:47-- http://192.168.112.100:13013/cgi-bin/sendsms?username=
tester&password=foobar&to=4850xxxxxxx&text=ISE%20Guest%20portal%20Username:
%20%20jsmith02%20Password:%20%20t6ub79_6r
Connecting to 192.168.112.100:13013... connected.
HTTP request sent, awaiting response... 202 Accepted
Length: 24 [text/html]
Saving to: `/dev/null'
0K 100% 1.14M=0s
2013-11-30 22:39:47 (1.14 MB/s) - `/dev/null' saved [24/24]
Die HTTP GET-Anforderung wird akzeptiert.
Die Kannel-smsbox berichtet, dass sie eine HTTP-Anfrage von wget erhalten hat, und sie hat diese Anfrage an die bearerbox gesendet, um die SMS zu versenden.
Hier ein Auszug aus dem Verzeichnis /var/log/kannel/smsbox.log:
2013-11-30 22:39:47 [18184] [5] INFO: smsbox: Got HTTP request </cgi-bin/sendsms>
from <192.168.112.100>
2013-11-30 22:39:47 [18184] [5] INFO: sendsms used by
2013-11-30 22:39:47 [18184] [5] INFO: sendsms sender:<tester:12345>
(192.168.112.100) to:<4850xxxxxxx> msg:jsmith02 Password: t6ub79_6r>
2013-11-30 22:39:47 [18184] [5] DEBUG: Stored UUID fd508632-9408-49e1-9eda-
3ce8d4b939d4
2013-11-30 22:39:47 [18184] [5] DEBUG: message length 57, sending 1 messages
2013-11-30 22:39:47 [18184] [5] DEBUG: Status: 202 Answer: <Sent.>
2013-11-30 22:39:47 [18184] [5] DEBUG: Delayed reply - wait for bearerbox
2013-11-30 22:39:47 [18184] [0] DEBUG: Got ACK (0) of fd508632-9408-49e1-9eda-
3ce8d4b939d4
Die Kannel-Trägerbox stellt eine Verbindung zum Remote-SMPP-Server her und sendet die Nachricht erfolgreich.
Hier ein Auszug aus dem Verzeichnis /var/log/kannel/kannel.log:
2013-11-30 22:39:47 [18165] [8] DEBUG: boxc_receiver: sms received
2013-11-30 22:39:47 [18165] [8] DEBUG: send_msg: sending msg to box: <127.0.0.1>
2013-11-30 22:39:47 [18165] [6] DEBUG: SMPP[SMPP:*****.com:1775/0:4ljt7wi3:]:
throughput (0.00,0.00)
2013-11-30 22:39:47 [18165] [6] DEBUG: SMPP[SMPP:*****.com:1775/0:4ljt7wi3:]:
Sending PDU:
2013-11-30 22:39:47 [18165] [6] DEBUG: SMPP PDU 0x2056bf0 dump:
2013-11-30 22:39:47 [18165] [6] DEBUG: type_name: submit_sm
2013-11-30 22:39:47 [18165] [6] DEBUG: command_id: 4 = 0x00000004
2013-11-30 22:39:47 [18165] [6] DEBUG: command_status: 0 = 0x00000000
2013-11-30 22:39:47 [18165] [6] DEBUG: sequence_number: 5 = 0x00000005
2013-11-30 22:39:47 [18165] [6] DEBUG: service_type: NULL
2013-11-30 22:39:47 [18165] [6] DEBUG: source_addr_ton: 2 = 0x00000002
2013-11-30 22:39:47 [18165] [6] DEBUG: source_addr_npi: 1 = 0x00000001
2013-11-30 22:39:47 [18165] [6] DEBUG: source_addr: "12345"
2013-11-30 22:39:47 [18165] [6] DEBUG: dest_addr_ton: 2 = 0x00000002
2013-11-30 22:39:47 [18165] [6] DEBUG: dest_addr_npi: 1 = 0x00000001
2013-11-30 22:39:47 [18165] [6] DEBUG: destination_addr: "4850xxxxxxx"
2013-11-30 22:39:47 [18165] [6] DEBUG: esm_class: 3 = 0x00000003
2013-11-30 22:39:47 [18165] [6] DEBUG: protocol_id: 0 = 0x00000000
2013-11-30 22:39:47 [18165] [6] DEBUG: priority_flag: 0 = 0x00000000
2013-11-30 22:39:47 [18165] [6] DEBUG: schedule_delivery_time: NULL
2013-11-30 22:39:47 [18165] [6] DEBUG: validity_period: NULL
2013-11-30 22:39:47 [18165] [6] DEBUG: registered_delivery: 0 = 0x00000000
2013-11-30 22:39:47 [18165] [6] DEBUG: replace_if_present_flag: 0 = 0x00000000
2013-11-30 22:39:47 [18165] [6] DEBUG: data_coding: 0 = 0x00000000
2013-11-30 22:39:47 [18165] [6] DEBUG: sm_default_msg_id: 0 = 0x00000000
2013-11-30 22:39:47 [18165] [6] DEBUG: sm_length: 57 = 0x00000039
2013-11-30 22:39:47 [18165] [6] DEBUG: short_message:
2013-11-30 22:39:47 [18165] [6] DEBUG: Octet string at 0x205ec70:
2013-11-30 22:39:47 [18165] [6] DEBUG: len: 57
2013-11-30 22:39:47 [18165] [6] DEBUG: size: 58
2013-11-30 22:39:47 [18165] [6] DEBUG: immutable: 0
2013-11-30 22:39:47 [18165] [6] DEBUG: data: 49 53 45 20 47 75 65 73
74 20 70 6f 72 74 61 6c ISE Guest portal
2013-11-30 22:39:47 [18165] [6] DEBUG: data: 20 55 73 65 72 6e 61 6d
65 3a 20 20 6a 73 6d 69 Username: jsmi
2013-11-30 22:39:47 [18165] [6] DEBUG: data: 74 68 30 32 20 50 61 73
73 77 6f 72 64 3a 20 20 th02 Password:
2013-11-30 22:39:47 [18165] [6] DEBUG: data: 74 36 75 62 37 39 11 36
72 t6ub79.6r
2013-11-30 22:39:47 [18165] [6] DEBUG: Octet string dump ends.
2013-11-30 22:39:47 [18165] [6] DEBUG: SMPP PDU dump ends.
2013-11-30 22:39:47 [18165] [6] DEBUG: SMPP[SMPP:******.com:1775/0:4ljt7wi3:]:
throughput (1.00,0.00)
2013-11-30 22:39:47 [18165] [6] DEBUG: SMPP[SMPP:******.com:1775/0:4ljt7wi3:]:
throughput (1.00,0.00)
2013-11-30 22:39:47 [18165] [6] DEBUG: SMPP[SMPP:******.com:1775/0:4ljt7wi3:]:
Got PDU:
2013-11-30 22:39:47 [18165] [6] DEBUG: SMPP PDU 0x2056bf0 dump:
2013-11-30 22:39:47 [18165] [6] DEBUG: type_name: submit_sm_resp
2013-11-30 22:39:47 [18165] [6] DEBUG: command_id: 2147483652 = 0x80000004
2013-11-30 22:39:47 [18165] [6] DEBUG: command_status: 0 = 0x00000000
2013-11-30 22:39:47 [18165] [6] DEBUG: sequence_number: 5 = 0x00000005
2013-11-30 22:39:47 [18165] [6] DEBUG: message_id: "4128473611307259"
2013-11-30 22:39:47 [18165] [6] DEBUG: SMPP PDU dump ends.
2013-11-30 22:39:47 [18165] [6] DEBUG: SMPP[SMPP:******.com:1775/0:4ljt7wi3:]:
throughput (1.00,0.00)
Beachten Sie, dass die Quelladresse auf 12345 festgelegt ist. Diese Einstellung spielt keine Rolle. Dieser Wert wird vom externen SMPP-Server neu geschrieben. Es ist möglich, zusätzliche Dienstleistungen zu kaufen, um anders dargestellt zu werden.
Der Gastbenutzer erhält eine SMS:
In diesem Abschnitt erhalten Sie Informationen zur Behebung von Fehlern in Ihrer Konfiguration.
Dieser Fehler tritt möglicherweise beim Erstellen eines Gastkontos auf: Es kann keine Textnachricht an die folgenden Gastbenutzer gesendet werden: xxxx. Sie müssen Ihre E-Mail-Adresse zur Einstellungsseite hinzufügen. Wenn Sie diese Fehlermeldung erhalten, überprüfen Sie die E-Mail-Adresse des Sponsors.
Überarbeitung | Veröffentlichungsdatum | Kommentare |
---|---|---|
1.0 |
04-Dec-2013 |
Erstveröffentlichung |