Interface Sh (Récupération des Données d'Abonné)

📖 Retour à la Documentation Principale

L'interface Sh fournit un accès aux données de profil d'abonné depuis le HSS/Dépôt via Diameter.

Documentation Connexe

Documentation Principale

• 📋 README Principal - Vue d'ensemble et démarrage rapide
• 🔧 Guide de Configuration - Configuration des pairs Diameter
• 🔧 Guide des Opérations - Tests de l'interface Sh dans le Panneau de Contrôle

Intégration du Traitement des Appels

• 🔀 Configuration du Plan de Numérotation - Utilisation des données Sh dans les variables de plan de numérotation
• ⚙️ Services Supplémentaires - MMTel-Config pour le renvoi d'appels
• 📡 SS7 MAP - Priorité des données HLR par rapport aux données Sh

Interfaces Connexes

• 💳 Chargement en Ligne - Interface Ro (utilise également Diameter)
• 🔢 Translation de Numéros - Normalisation des numéros avant la recherche Sh

Surveillance

• 📊 Référence des Métriques - Métriques et surveillance de l'interface Sh

---

Interface Sh (Récupération des Données d'Abonné)

L'interface Sh est utilisée pour récupérer les données de profil d'abonné depuis le HSS/Dépôt avant le traitement des appels. Ces données incluent les identités des abonnés, les services et la configuration MMTel.

Qu'est-ce que l'Interface Sh ?

L'interface Sh est une interface Diameter standardisée par la 3GPP entre le TAS et le HSS/Dépôt (Repo). Elle fournit un accès en temps réel à :

• Identités d'abonnés IMS (IMPI/IMPU)
• Paramètres de renvoi d'appels (MMTel-Config)
• Autorisation de service d'abonné
• Attribution S-CSCF

Quand les Recherches Sh Ont Lieu

Les Recherches Sh Ont Lieu Sur :

• Appels MT : Recherche de la partie appelée (abonné de destination)
• Appels MO : Recherche de la partie appelante (abonné source)
• Appels d'Urgence : Recherche de la partie appelante (pour la localisation/l'identité)

Données Récupérées de l'Interface Sh

Le TAS interroge pour Sh-User-Data qui retourne un document XML contenant :

1. Identités IMS :

• IMPI (Identité Privée) : username@domain - utilisé pour l'authentification
  • Format : {IMSI}@ims.mnc{MNC}.mcc{MCC}.3gppnetwork.org
  • Exemple : 505014001234567@ims.mnc001.mcc505.3gppnetwork.org
• IMPU (Identité Publique) : sip:+number@domain - utilisé pour le routage
  • Format : sip:+{MSISDN}@ims.mnc{MNC}.mcc{MCC}.3gppnetwork.org
  • Exemple : sip:+61403123456@ims.mnc001.mcc505.3gppnetwork.org

2. Attribution S-CSCF :

• Nom du serveur S-CSCF et domaine où l'abonné est enregistré
• Utilisé pour le routage des appels sur le réseau vers le cœur IMS

3. Services MMTel (Configuration de Téléphonie Multimédia) :

• Renvoi d'Appel Total (CFA) : Renvoi inconditionnel vers un autre numéro
• Renvoi d'Appel Occupé (CFB) : Renvoi lorsque l'abonné est occupé
• Renvoi d'Appel Sans Réponse (CFNRy) : Renvoi après un délai d'attente (inclut la valeur du minuteur)
• Renvoi d'Appel Non Joignable (CFNRc) : Renvoi lorsque l'abonné est hors ligne/non enregistré

Qu'est-ce que MMTel-Config ?

MMTel-Config est la configuration du service de Téléphonie Multimédia de l'abonné stockée dans le HSS/Dépôt. Elle contient :

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

Services MMTel Courants :

• CDIV (Diversion de Communication) : Règles de renvoi d'appels
• OIP (Présentation de l'Identité de l'Appelant) : Règles de présentation de l'identité de l'appelant
• TIP (Présentation de l'Identité de l'Appelé) : Règles de numéro de la partie appelée

Variables de Plan de Numérotation Définies à Partir des Données Sh

Après une recherche Sh réussie, ces variables sont peuplées :

Variable	Source	Exemple de Valeur	Description
ims_private_identity	IMPI	505014001234567@ims.domain	Identité utilisateur privée pour l'authentification
ims_public_identity	IMPU	sip:+61403123456@ims.domain	Identité utilisateur publique pour le routage
msisdn	IMPU (analysé)	61403123456	Numéro d'abonné (+ retiré)
imsi	IMPI (analysé)	505014001234567	IMSI de l'identité privée
ims_domain	IMPI/IMPU	ims.mnc001.mcc505.3gppnetwork.org	Domaine IMS
scscf_address	Nom S-CSCF	scscf01.ims.domain ou "none"	Adresse du serveur S-CSCF
scscf_domain	Domaine S-CSCF	ims.domain ou "none"	Domaine S-CSCF
call_forward_all_destination	MMTel CDIV	61403555123 ou "none"	Numéro de destination CFA
call_forward_not_reachable_destination	MMTel CDIV	2222 ou valeur par défaut de configuration	Destination CFNRc (messagerie vocale)
no_reply_timer	MMTel CDIV	30 ou valeur par défaut de configuration	Délai avant que CFNRy s'active

Priorité : Données Sh vs Valeurs Par Défaut de Configuration

Le TAS utilise cette priorité pour les données de renvoi d'appels :

1. MMTel-Config de Sh (priorité la plus élevée - paramètres spécifiques à l'abonné)
2. Données HLR de SS7 MAP (remplace Sh pour les appels MT si le roaming/le renvoi est actif)
3. Valeurs Par Défaut de Configuration (priorité la plus basse - utilisées lorsque aucune donnée Sh n'est disponible)

Exemple :

# Valeurs par défaut de configuration (utilisées uniquement si Sh ne retourne pas de MMTel-Config)
config :tas,
  call_forward_not_reachable_destination: "2222",  # Messagerie vocale
  default_no_reply_timer: 30

Que Se Passe-t-il Lorsque la Recherche Sh Échoue

Scénarios d'Échec :

1. Abonné Non Provisionné dans le HSS :

   • Sh retourne l'erreur "Utilisateur Inconnu"
   • Variable hangup_case définie sur "UNALLOCATED_NUMBER"
   • Appel rejeté avec la réponse SIP appropriée

2. HSS Injoignable / Délai d'Attente :

   • La requête Sh expire (par défaut : 5000ms)
   • Erreur enregistrée et métrique consignée
   • L'appel peut être rejeté ou routé avec des valeurs par défaut (spécifique au déploiement)

3. Pas de MMTel-Config dans la Réponse :

   • L'abonné existe mais n'a pas de renvoi d'appels configuré
   • Les valeurs par défaut de configuration sont utilisées pour call_forward_not_reachable_destination et no_reply_timer
   • L'appel se poursuit normalement avec des valeurs par défaut

Surveillance de l'Interface Sh

Métriques Clés :

# Taux de réussite des recherches Sh
rate(subscriber_data_lookups_total{result="success"}[5m]) /
rate(subscriber_data_lookups_total[5m]) * 100

# Latence des recherches Sh (P95)
histogram_quantile(0.95,
  rate(subscriber_data_duration_milliseconds_bucket[5m]))

# Taux d'erreur Sh
rate(subscriber_data_lookups_total{result="error"}[5m])

Seuils d'Alerte :

• Latence P95 > 100ms : Réponses lentes du HSS
• Taux d'erreur > 5% : Problèmes de connectivité HSS
• Taux d'erreur > 20% : Échec critique du HSS

Dépannage :

1. Vérifiez l'état du pair Diameter dans l'interface Web (/diameter)
2. Testez la recherche Sh dans l'interface Web (/sh_test) avec un abonné connu
3. Consultez les journaux pour les erreurs "Données d'Abonné"
4. Vérifiez que le HSS/Dépôt est joignable depuis le TAS
5. Vérifiez la métrique subscriber_data_lookups_total pour des motifs

Test de l'Interface Sh

Utilisez l'outil de Test Sh de l'interface Web (/sh_test) :

1. Accédez à /sh_test dans le Panneau de Contrôle
2. Entrez le MSISDN de l'abonné (par exemple, +61403123456)
3. Cliquez sur "Interroger Sh"
4. Examinez les données retournées :
   • Identit��s IMPI/IMPU
   • Attribution S-CSCF
   • Services MMTel
   • Configuration de renvoi d'appels

Scénarios de Test Courants :

• Vérifiez que les abonnés nouvellement provisionnés sont dans le HSS
• Vérifiez les paramètres de renvoi d'appels pour un abonné spécifique
• Validez l'attribution S-CSCF après l'enregistrement IMS
• Testez la connectivité HSS et les temps de réponse