Gateway SMTP (Email)

Gli email vanno inviati a gateway@email.sms.it; è consigliabile utilizzare direttamente il nostro SMTP server: smtp.sms.it per evitare ritardi dovuti a server SMTP intermedi. A questo server SMTP non deve essere però spedita altra posta, che viene rifiutata.

Per qualsiasi problema di irraggiungibilità dell'indirizzo gateway@email.sms.it si può utilizzare l'indirizzo alternativo gateway@email.smsitalia.com, mentre l'indirizzo alternativo riguardante l'utilizzo dell'SMTP server è smtp.smsitalia.com.

Il subject deve essere lasciato vuoto, oppure è necessario valorizzarlo con un codice univoco diverso per ogni spedizione: in questo caso il server scarterà ogni email contrassegnata da un codice già elaborato in precedenza (questo controllo è utile per evitare l'eventualità che i messaggi vengano inviati più volte, nel caso di erronea duplicazione di un email).
Se invece volete impostare un invio differito allora dovrete inserire nel subject la data in cui volete fare partire la spedizione nel formato:

gg/mm/aaaa oo:mm (Formato UTC, cioè il tempo universale senza fusi orari)

Il mittente (from) deve essere abilitato al servizio.

Nel corpo della mail va utilizzata questa sintassi:

*I*numerotelefonico:testomessaggio*V*validazione*F*

Legenda:

La sintassi descritta può anche essere impaginata su più righe, quindi sono valide ed identiche entrambe le seguenti mail:

------
*I*3356451017:Testo del messaggio*V*XXXX*F*
------

e, ad esempio:

------
*I*
3356451017
:
Testo
del messaggio
*V*XXXX
*F*
------

E' inoltre possibile accodarle più messaggi all'interno dello stesso email, ad esempio:

------
*I*347111111:Testo del primo messaggio*V*XXX1*F*
*I*347222222:Testo del secondo messaggio*V*XXX2*F*
*I*347333333:Testo del terzo messaggio*V*XXX3*F*
*I*347444444:Testo del quarto messaggio*V*XXX4*F*
------

Sicurezza: codice di validazione

Viene effettuata una prima verifica sul mittente (From) del messaggio, che deve risultare abilitato al servizio.

Viene quindi verificata, messaggio per messaggio, il codice di validazione. E' possibile utilizzare a scelta uno dei seguenti tre algoritmi, contraddistinti da un grado di sicurezza decrescente.

Nell'analisi seguente, si intende per 'pwcr' la propria password criptata. Questa informazione si può visualizzare attraverso la pagina di configurazione account.

Alta sicurezza (crypt)

E' consigliato l'utilizzo di questa modalità. Si fa riferimento alla funzione crypt(3) della libreria C (unix).

p = primi 4 car. di pwcr
g = ultimi 4 car. del numero GSM destinatario
pg = "p"+"g" (cioè la stringa p seguita dalla stringa g)

x = ultimi 7 car. del numero GSM destinatario
s = i primi 2 car. di x

c = crypt(pg, s).

 

VALIDAZIONE = "A_"+ultimi 11 car. di c

Alta sicurezza (MD5)

E' consigliato l'utilizzo di questa modalità. Si fa riferimento alla funzione MD5, disponibile su svariate piattaforme.

p = primi 4 car. di pwcr
g = ultimi 4 car. del numero GSM destinatario
pg = "p"+"g" (cioè la stringa p seguita dalla stringa g)

c = MD5->hexhash(pg).

 

VALIDAZIONE = "M_"+ultimi 11 car. di c

Media sicurezza

Se non si dispone delle funzioni crypt o MD5, è possibile utilizzare il seguente algoritmo:

 

x = ultimi 6 car. del numero GSM destinatario
a = risultato della reciproca moltiplicazione del valore ASCII dei primi 5 caratteri di pwcr.
v = a modulo x (resto della divisione a : x)

 

VALIDAZIONE = "B_"+v

NOTA: è necessario utilizzare un intero sufficientemente grande (min. 4 bytes) per allocare la variabile a, altrimenti con alcune combinazioni l'algoritmo non fornirà il risultato corretto.

Bassa sicurezza

Vi sconsigliamo di utilizzare questa terza possibilità in quanto offre sicurezza pressochè nulla.

VALIDAZIONE = "C_"+pwcr

Esempi

pwcr = xy9AbKr7.pX
numero GSM destinatario: 3356451017

Alta sicurezza

p = 'xy9A'
g = '1017'
pg = 'xy9A1017'

x = 6451017
s = 64

c = crypt('xy9A1017', 64) = 64ywHtcJE3GQc

 

VALIDAZIONE = A_ywHtcJE3GQc

 

*I*3356451017:Messaggio*V*A_ywHtcJE3GQc*F*

Media sicurezza

x = 451017
a = 120 (x) * 121 (y) * 57 (9) * 65 (A) * 98 (b) = 5272066800

v = 5272066800 modulo 451017 = 129087

poichè 5272066800 / 451017 = 11689
451017 * 11689 = 5271937713
v = 5271937713 - 5272066800 = 129087

 

VALIDAZIONE = B_129087

 

*I*3356451017:Messaggio*V*B_129087*F*

Bassa sicurezza

VALIDAZIONE = C_xy9AbKr7.pX

 

*I*3356451017:Messaggio*V*C_xy9AbKr7.pX*F*