Lista Blanca de Direcciones de Origen
Control por par sobre qué direcciones de origen (source_addr) puede usar un cliente SMPP al enviar mensajes.
Descripción General
Cuando un ESME externo (cliente) envía un PDU submit_sm a través del Gateway SMPP, el PDU incluye un campo source_addr que representa la dirección de origen (CLI / ID del remitente). Por defecto, los clientes autenticados pueden usar cualquier dirección de origen. La función de Lista Blanca de Direcciones de Origen permite a los operadores restringir qué direcciones de origen cada par de servidor puede usar.
Esto sigue el mismo patrón que la Lista Blanca de IP existente: cuando la lista blanca está vacía, se permiten todos los valores. Cuando está poblada, solo se aceptan las direcciones de origen que coincidan.
Reglas de Coincidencia
La coincidencia de direcciones de origen admite dos modos:
Coincidencia Exacta
La dirección de origen debe coincidir exactamente con la entrada de la lista blanca. La coincidencia es sensible a mayúsculas y minúsculas.
| Entrada de la Lista Blanca | Dirección de Origen | Resultado |
|---|---|---|
MyBrand | MyBrand | Permitido |
MyBrand | mybrand | Rechazado |
MyBrand | MyBrands | Rechazado |
+61400000001 | +61400000001 | Permitido |
Coincidencia de Comodín (Prefijo)
Agregue * a una entrada de la lista blanca para coincidir con cualquier dirección de origen que comience con el prefijo antes del *.
| Entrada de la Lista Blanca | Dirección de Origen | Resultado |
|---|---|---|
614* | 61400000001 | Permitido |
614* | 61412345678 | Permitido |
614* | 61500000001 | Rechazado |
+614* | +61400000001 | Permitido |
My* | MyBrand | Permitido |
My* | MyCompany | Permitido |
Múltiples Entradas
Cuando se configuran múltiples entradas, la dirección de origen se permite si coincide con cualquiera de las entradas en la lista blanca.
Ejemplo de lista blanca: MyBrand, 614*, +61400000001
| Dirección de Origen | Coincide | Resultado |
|---|---|---|
MyBrand | MyBrand (exacto) | Permitido |
61412345678 | 614* (comodín) | Permitido |
+61400000001 | +61400000001 (exacto) | Permitido |
OtherBrand | Ninguna | Rechazado |
61500000001 | Ninguna | Rechazado |
Manejo de Errores
Cuando un submit_sm es rechazado debido a una violación de la lista blanca de direcciones de origen, el gateway responde con:
| Campo | Valor |
|---|---|
| PDU | submit_sm_resp |
| Estado del Comando | 0x0000000A |
| Nombre del Error | ESME_RINVSRCADR (Dirección de Origen Inválida) |
| ID del Mensaje | Vacío |
Se registra una advertencia con la dirección de origen rechazada y el nombre del par:
Servidor SMPP: Rechazado submit_sm de partner_acme - source_addr 'UnauthorisedBrand' no en la lista blanca
Configuración
A través de la Interfaz Web
- Navegue a SMPP > Servidores Peers
- Haga clic en Editar en el par objetivo (o Agregar Nuevo Servidor Peer)
- Localice el campo Lista Blanca de Direcciones de Origen (debajo de la Lista Blanca de IP)
- Ingrese patrones separados por comas:
MyBrand,614*,+61400000001 - Haga clic en Guardar
Los cambios entran en vigor de inmediato para nuevos PDUs submit_sm en conexiones existentes.
A través del Archivo de Configuración
Agregue source_address_whitelist a la configuración de enlace del servidor en runtime.exs:
config :omnimessage_smpp, :server_binds, [
%{
name: "partner_acme",
system_id: "acme_corp",
password: "secure_password",
allowed_bind_types: [:transmitter, :receiver, :transceiver],
ip_whitelist: ["203.0.113.0/24"],
source_address_whitelist: ["MyBrand", "614*", "+61400000001"],
tps_limit: 50,
queue_check_frequency: 1000
}
]
Parámetros
| Parámetro | Tipo | Requerido | Predeterminado | Descripción |
|---|---|---|---|---|
source_address_whitelist | Lista de cadenas | No | [] (permitir todos) | Lista de patrones de direcciones de origen permitidos. Admite coincidencia exacta y comodín final (* sufijo). Lista vacía permite todas las direcciones de origen. |
Migración
Los pares de servidor existentes se migran automáticamente cuando se inicia el gateway. Los pares creados antes de que se añadiera esta función reciben una lista blanca vacía (todas las direcciones de origen permitidas), preservando el comportamiento existente.
Flujo de Validación
Ejemplos
Restringir a una Sola Marca
Solo permitir mensajes del ID del remitente AcmeCorp:
AcmeCorp
Permitir un Rango de Números Australianos
Permitir cualquier número de móvil australiano (que comience con 614):
614*
Alfanumérico y Numérico Mixto
Permitir un nombre de marca y un rango de números:
AcmeCorp,614*,+61290000001
Permitir Todos (Predeterminado)
Deje el campo vacío para permitir cualquier dirección de origen. Este es el comportamiento predeterminado.
Solución de Problemas
Mensajes Rechazados con ESME_RINVSRCADR
Síntomas: El socio informa submit_sm_resp con estado de comando 0x0A.
Causas posibles:
- La dirección de origen no coincide con ninguna entrada en la lista blanca
- La entrada de la lista blanca tiene un error tipográfico o patrón incorrecto
- Desajuste de mayúsculas y minúsculas (la coincidencia es sensible a mayúsculas y minúsculas)
- El patrón de comodín es demasiado restrictivo
Resolución:
- Verifique la Lista Blanca de Direcciones de Origen del par del servidor en la Interfaz Web
- Compare la dirección de origen rechazada con cada entrada de la lista blanca
- Agregue la dirección de origen faltante o ajuste el patrón de comodín
- Verifique que la coincidencia de mayúsculas y minúsculas sea exacta para las entradas no comodín
La Lista Blanca No Toma Efecto
Síntomas: Mensajes aceptados a pesar de que la dirección de origen no coincide con la lista blanca.
Causas posibles:
- La lista blanca está vacía (permite todo por defecto)
- El ESME está conectado a un par de servidor diferente
- El cambio en el archivo de configuración aún no se ha aplicado (requiere reinicio)
Resolución:
- Verifique que la lista blanca esté poblada (no vacía) en la Interfaz Web
- Verifique a qué par de servidor está vinculado el ESME en el Estado en Vivo
- Si utiliza un archivo de configuración, reinicie el servicio
Documentación Relacionada
- Referencia de Configuración - Documentación completa de parámetros de pares de servidor
- Guía de Uso - Gestión de conexiones SMPP
- Solución de Problemas - Procedimientos generales de solución de problemas