Interfaz Sh (Recuperación de Datos del Suscriptor)

📖 Volver a la Documentación Principal

La interfaz Sh proporciona acceso a los datos del perfil del suscriptor desde el HSS/Repositorio a través de Diameter.

Documentación Relacionada

Documentación Principal

• 📋 README Principal - Visión general y inicio rápido
• 🔧 Guía de Configuración - Configuración de pares Diameter
• 🔧 Guía de Operaciones - Pruebas de la interfaz Sh en el Panel de Control

Integración de Procesamiento de Llamadas

• 🔀 Configuración del Dialplan - Uso de datos Sh en variables de dialplan
• ⚙️ Servicios Suplementarios - MMTel-Config para desvío de llamadas
• 📡 SS7 MAP - Prioridad de datos HLR frente a datos Sh

Interfaces Relacionadas

• 💳 Cobro en Línea - Interfaz Ro (también utiliza Diameter)
• 🔢 Traducción de Números - Normalización de números antes de la búsqueda Sh

Monitoreo

• 📊 Referencia de Métricas - Métricas y monitoreo de la interfaz Sh

---

Interfaz Sh (Recuperación de Datos del Suscriptor)

La interfaz Sh se utiliza para recuperar datos del perfil del suscriptor desde el HSS/Repositorio antes de procesar llamadas. Estos datos incluyen identidades de suscriptores, servicios y configuración de MMTel.

¿Qué es la Interfaz Sh?

La interfaz Sh es una interfaz Diameter estandarizada por 3GPP entre el TAS y el HSS/Repositorio (Repo). Proporciona acceso en tiempo real a:

• Identidades de suscriptores IMS (IMPI/IMPU)
• Configuraciones de desvío de llamadas (MMTel-Config)
• Autorización de servicios del suscriptor
• Asignación de S-CSCF

Cuándo Ocurren las Búsquedas Sh

Las Búsquedas Sh Ocurren En:

• Llamadas MT: Búsqueda de la parte llamada (suscriptor de destino)
• Llamadas MO: Búsqueda de la parte que llama (suscriptor de origen)
• Llamadas de Emergencia: Búsqueda de la parte que llama (para ubicación/identidad)

Datos Recuperados de la Interfaz Sh

El TAS consulta por Sh-User-Data que devuelve un documento XML que contiene:

1. Identidades IMS:

• IMPI (Identidad Privada): username@domain - utilizado para autenticación
  • Formato: {IMSI}@ims.mnc{MNC}.mcc{MCC}.3gppnetwork.org
  • Ejemplo: 505014001234567@ims.mnc001.mcc505.3gppnetwork.org
• IMPU (Identidad Pública): sip:+number@domain - utilizado para enrutamiento
  • Formato: sip:+{MSISDN}@ims.mnc{MNC}.mcc{MCC}.3gppnetwork.org
  • Ejemplo: sip:+61403123456@ims.mnc001.mcc505.3gppnetwork.org

2. Asignación de S-CSCF:

• Nombre del servidor S-CSCF y dominio donde el suscriptor está registrado
• Utilizado para enrutamiento de llamadas en la red hacia el núcleo IMS

3. Servicios MMTel (Configuración de Telefonía Multimedia):

• Desvío de Llamadas Todas (CFA): Desvío incondicional a otro número
• Desvío de Llamadas Ocupado (CFB): Desvío cuando el suscriptor está ocupado
• Desvío de Llamadas Sin Respuesta (CFNRy): Desvío después de un tiempo de espera (incluye valor del temporizador)
• Desvío de Llamadas No Alcanzable (CFNRc): Desvío cuando el suscriptor está fuera de línea/no registrado

¿Qué es MMTel-Config?

MMTel-Config es la configuración del servicio de Telefonía Multimedia del suscriptor almacenada en el HSS/Repositorio. Contiene:

<MMTelSS>
  <CDIV>
    <SS-ActivationState>active</SS-ActivationState>
    <Ruleset>
      <Rule>
        <RuleCondition>communication-diverted</RuleCondition>
        <ForwardTo>+61403555123</ForwardTo>
        <NotificationType>notify</NotificationType>
      </Rule>
    </Ruleset>
  </CDIV>
</MMTelSS>

Servicios MMTel Comunes:

• CDIV (Desvío de Comunicación): Reglas de desvío de llamadas
• OIP (Presentación de Identidad de Origen): Reglas de presentación de ID de llamada
• TIP (Presentación de Identidad de Terminación): Reglas de número de parte llamada

Variables de Dialplan Establecidas desde Datos Sh

Después de una búsqueda Sh exitosa, estas variables se poblan:

Variable	Fuente	Valor de Ejemplo	Descripción
ims_private_identity	IMPI	505014001234567@ims.domain	Identidad de usuario privada para autenticación
ims_public_identity	IMPU	sip:+61403123456@ims.domain	Identidad de usuario pública para enrutamiento
msisdn	IMPU (analizado)	61403123456	Número del suscriptor (+ eliminado)
imsi	IMPI (analizado)	505014001234567	IMSI de la identidad privada
ims_domain	IMPI/IMPU	ims.mnc001.mcc505.3gppnetwork.org	Dominio IMS
scscf_address	Nombre S-CSCF	scscf01.ims.domain o "none"	Dirección del servidor S-CSCF
scscf_domain	Dominio S-CSCF	ims.domain o "none"	Dominio S-CSCF
call_forward_all_destination	MMTel CDIV	61403555123 o "none"	Número de destino CFA
call_forward_not_reachable_destination	MMTel CDIV	2222 o valor predeterminado de configuración	Destino CFNRc (buzón de voz)
no_reply_timer	MMTel CDIV	30 o valor predeterminado de configuración	Tiempo de espera antes de que se active CFNRy

Prioridad: Datos Sh vs Valores Predeterminados de Configuración

El TAS utiliza esta prioridad para los datos de desvío de llamadas:

1. MMTel-Config de Sh (prioridad más alta - configuraciones específicas del suscriptor)
2. Datos HLR de SS7 MAP (anula Sh para llamadas MT si el roaming/desvío está activo)
3. Valores Predeterminados de Configuración (prioridad más baja - utilizados cuando no hay datos Sh disponibles)

Ejemplo:

# Valores predeterminados de configuración (utilizados solo si Sh no devuelve MMTel-Config)
config :tas,
  call_forward_not_reachable_destination: "2222",  # Buzón de voz
  default_no_reply_timer: 30

Qué Ocurre Cuando Falla la Búsqueda Sh

Escenarios de Fallo:

1. Suscriptor No Provisionado en HSS:

   • Sh devuelve el error "Usuario Desconocido"
   • Variable hangup_case establecida en "UNALLOCATED_NUMBER"
   • Llamada rechazada con la respuesta SIP apropiada

2. HSS Inalcanzable / Tiempo de Espera:

   • La solicitud Sh se agota (predeterminado: 5000ms)
   • Error registrado y métrica registrada
   • La llamada puede ser rechazada o enrutada con valores predeterminados (específico de la implementación)

3. Sin MMTel-Config en la Respuesta:

   • El suscriptor existe pero no tiene desvío de llamadas configurado
   • Se utilizan valores predeterminados de configuración para call_forward_not_reachable_destination y no_reply_timer
   • La llamada procede normalmente con valores predeterminados

Monitoreo de la Interfaz Sh

Métricas Clave:

# Tasa de éxito de búsqueda Sh
rate(subscriber_data_lookups_total{result="success"}[5m]) /
rate(subscriber_data_lookups_total[5m]) * 100

# Latencia de búsqueda Sh (P95)
histogram_quantile(0.95,
  rate(subscriber_data_duration_milliseconds_bucket[5m]))

# Tasa de error de Sh
rate(subscriber_data_lookups_total{result="error"}[5m])

Umbrales de Alerta:

• Latencia P95 > 100ms: Respuestas lentas del HSS
• Tasa de error > 5%: Problemas de conectividad con el HSS
• Tasa de error > 20%: Fallo crítico del HSS

Solución de Problemas:

1. Verificar el estado del par Diameter en la interfaz web (/diameter)
2. Probar la búsqueda Sh en la interfaz web (/sh_test) con un suscriptor conocido
3. Revisar los registros en busca de errores de "Datos del Suscriptor"
4. Verificar que el HSS/Repositorio sea accesible desde el TAS
5. Comprobar la métrica subscriber_data_lookups_total en busca de patrones

Pruebas de la Interfaz Sh

Utilizar la herramienta de prueba Sh en la interfaz web (/sh_test):

1. Navegar a /sh_test en el Panel de Control
2. Ingresar el MSISDN del suscriptor (por ejemplo, +61403123456)
3. Hacer clic en "Consultar Sh"
4. Revisar los datos devueltos:
   • Identidades IMPI/IMPU
   • Asignación S-CSCF
   • Servicios MMTel
   • Configuración de desvío de llamadas

Escenarios de Prueba Comunes:

• Verificar que los suscriptores recién provisionados estén en el HSS
• Comprobar las configuraciones de desvío de llamadas para un suscriptor específico
• Validar la asignación S-CSCF después del registro IMS
• Probar la conectividad y los tiempos de respuesta del HSS