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 - Descripció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 Plan de Marcado - Uso de datos de Sh en variables de plan de marcado
• ⚙️ Servicios Suplementarios - MMTel-Config para reenvío de llamadas
• 📡 SS7 MAP - Datos de HLR vs prioridad de datos de Sh

Interfaces Relacionadas

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

Monitoreo

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

---

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 reenvío de llamadas (MMTel-Config)
• Autorización de servicios del suscriptor
• Asignación de S-CSCF

Cuándo Ocurren las Búsquedas en Sh

Las Búsquedas en Sh Ocurren En:

• Llamadas MT: Buscar parte llamada (suscriptor de destino)
• Llamadas MO: Buscar parte llamante (suscriptor de origen)
• Llamadas de Emergencia: Buscar parte llamante (para ubicación/identidad)

Datos Recuperados de la Interfaz Sh

El TAS consulta 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 enrutar llamadas dentro de la red de regreso al núcleo IMS

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

• Reenvío de Todas las Llamadas (CFA): Reenvío incondicional a otro número
• Reenvío de Llamadas Ocupadas (CFB): Reenvío cuando el suscriptor está ocupado
• Reenvío de Llamadas Sin Respuesta (CFNRy): Reenvío después de un tiempo de espera (incluye valor del temporizador)
• Reenvío de Llamadas No Alcanzables (CFNRc): Reenví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 reenví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 del Plan de Marcado Establecidas desde Datos de Sh

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

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 de S-CSCF	scscf01.ims.domain o "none"	Dirección del servidor S-CSCF
scscf_domain	Dominio de S-CSCF	ims.domain o "none"	Dominio de 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 (correo 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 de Sh vs Valores Predeterminados de Configuración

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

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

Ejemplo:

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

¿Qué Ocurre Cuando Falla la Búsqueda en Sh?

Escenarios de Fallo:

1. Suscriptor No Provisionado en HSS:

   • Sh devuelve el error "Usuario Desconocido"
   • La variable hangup_case se establece en "UNALLOCATED_NUMBER"
   • La llamada es 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 reenví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 en Sh
rate(subscriber_data_lookups_total{result="success"}[5m]) /
rate(subscriber_data_lookups_total[5m]) * 100

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

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

Umbrales de Alerta:

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

Solución de Problemas:

1. Verificar el estado del par Diameter en la interfaz web (/diameter)
2. Probar la búsqueda en 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 alcanzable 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 MSISDN del suscriptor (por ejemplo, +61403123456)
3. Hacer clic en "Consultar Sh"
4. Revisar los datos devueltos:
   • Identidades IMPI/IMPU
   • Asignación de S-CSCF
   • Servicios MMTel
   • Configuración de reenvío de llamadas

Escenarios de Prueba Comunes:

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