Description

Component name

Normalizer

Applicable contexts

  • SS7 Service

  • SIP Service

  • VoLTE Service

  • XCAP

Features using component

The Sentinel Normalizer normalizes International, Unknown, National, or Subscriber NADI format addresses into either:

  • international address format — starting with CC + MNC

  • national format — starting with MNC

where MNC is specified in the NetworkDialingCode configuration setting.

The Sentinel Normalizer may decide to not normalize the address if the address is either:

  • shorter than the MinNormalizableLength

  • an entry in the SkipNormalizationAddressList

This allows for short codes and specific longer length numbers to avoid normalization. The SkipNormalizationAddressList is a configurable address list scoped by the Sentinel selection key; it is only used by the SIP normalization component.

Normalization is invoked by the call type specific normalization features Voice Call Normalization Feature, SMS Normalization Feature and SIP Normalization Feature. It is also invoked by the XCAP Server to reject requests containing numbers which are not normalizable. Furthermore, MMTelCDIV, MMTelICB and MMTelOCB use the normalization component to normalize numbers in outgoing requests, and when comparing numbers.

Note

Support for formatting of special characters in SS7 signalling (such as: * → B, # → C) is provided by the SS7 Prefix and Suffix Analysis Feature.

Sentinel supports special character mapping only if they are prefixes or suffixes.

Configuration

Parameter Type Description

NationalPrefix

String

National dialling prefix (for example, 0)

CountryCode

String

Country code

NetworkDialingCode

String

Network dialling code, used as the MNC

InternationalEscapeCode

String

Escape code for dialing international numbers (for example, 00)

NormalizeTo

String

Indicates the default format of Nature of Address Indication (NADI); one of: [international, national]

ProfileVersion

Integer

The current profile’s version (used for determining if reloading is required)

MinNormalizableLength

Integer

The minimum length of an address for it to be normalizable.

Normalization address list configuration

The SkipNormalizationAddressList address list uses the standard Address list entry. Addresses that prefix match against entries in the list are not normalized.

Note

Using the 'SkipNormalizationAddressList' to avoid normalizing numbers is only supported by the (SIP) SipNormalization and the SCCCamelToIMSReOriginationSIPFeature in Sentinel-Volte.

Configuration profile naming

Configuration Profile Table Name Description Profile naming

NormalizationFeatureConfigProfileTable

Normalization parameter configuration

SentinelSelectionKey (for example, OpenCloud::::)

${PLATFORMOPERATOR}_Sentinel_AddressListConfigurationTable

Address list configuration

${SELECTIONKEY}:Normalizer:SkipNormalizationAddressList

${PLATFORMOPERATOR}_Sentinel_AddressListEntryTable

Feature specific Address List entry table

Provisioning interfaces

The Normalizer component is provisioned using the Sentinel Normalization REST API or Managing Normalization web interface.

Behaviour

The Normalizer component normalizes addresses based on its configuration. Initially the address to normalize is checked for length against the MinNormalizableLength, and against the SkipNormalizationAddressList. If the address is under the MinNormalizableLength, or matches the prefix list, normalization is skipped.

Then the configuration of the component is checked to determine whether the address should be normalized to national or international format.

  • If the number should be normalized to international format

    • if the number is in national format, the configured CountryCode will be prepended to the address.

    • if the number is in subscriber format, the CountryCode and the configured NetworkDialingCode will be prepended to the address.

    • If the current format of the number is unknown, the format will be determined by checking against the configured InternationalEscapeCode and NationalPrefix, and then normalizing as appropriate. If neither of those prefixes match the address, it will be returned unchanged.

  • If the number should be normalized to national format

    • if the number is in international format, the length of the configured CountryCode will be removed from the start of the address.

    • if the number is in subscriber format, the configured NetworkDialingCode will be prepended to the address.

    • If the current format of the number is unknown, the format will be determined by checking against the configured InternationalEscapeCode and NationalPrefix, and then normalizing as appropriate. If neither of those prefixes match the address, it will be returned unchanged.

Previous page Next page
Sentinel Express Version 3.1.0