Controle de Roaming do OmniHSS

← Voltar para o Guia de Operações

---

Visão Geral

O OmniHSS fornece controle de roaming granular, permitindo que você defina quais redes os assinantes podem acessar para serviços de dados e IMS ao roaming.

Fluxo de Controle de Roaming

---

Estrutura do Perfil de Roaming

Componentes

Regra de Roaming

Cada regra especifica a ação para uma rede específica (combinação de MCC/MNC).

Campos:

• name - Nome descritivo
• mcc - Código do País Móvel (3 dígitos)
• mnc - Código da Rede Móvel (2-3 dígitos)
• data_action - 0 (Permitir) ou 1 (Negar)
• ims_action - 0 (Permitir) ou 1 (Negar)

Perfil de Roaming

Define o comportamento padrão e vincula às regras.

Campos:

• name - Nome do perfil
• data_action_if_no_rules_match - 0 (Permitir) ou 1 (Negar)
• ims_action_if_no_rules_match - 0 (Permitir) ou 1 (Negar)

---

Exemplos de Configuração

Permitir Todo o Roaming

# Criar perfil que permite tudo
curl -k -X POST https://hss.example.com:8443/api/roaming/profile \
  -H "Content-Type: application/json" \
  -d '{
    "roaming_profile": {
      "name": "Permitir Tudo",
      "data_action_if_no_rules_match": 0,
      "ims_action_if_no_rules_match": 0
    }
  }'

Negar Todo o Roaming

# Criar perfil que bloqueia tudo
curl -k -X POST https://hss.example.com:8443/api/roaming/profile \
  -H "Content-Type: application/json" \
  -d '{
    "roaming_profile": {
      "name": "Sem Roaming",
      "data_action_if_no_rules_match": 1,
      "ims_action_if_no_rules_match": 1
    }
  }'

Permitir Redes Específicas (Lista Branca)

# Criar perfil com negação por padrão
PROFILE_ID=$(curl -k -X POST https://hss.example.com:8443/api/roaming/profile \
  -H "Content-Type: application/json" \
  -d '{
    "roaming_profile": {
      "name": "Apenas Operadoras dos EUA",
      "data_action_if_no_rules_match": 1,
      "ims_action_if_no_rules_match": 1
    }
  }' | jq -r '.data.id')

# Permitir AT&T
RULE1=$(curl -k -X POST https://hss.example.com:8443/api/roaming/rule \
  -H "Content-Type: application/json" \
  -d '{
    "roaming_rule": {
      "name": "Permitir AT&T",
      "mcc": "310",
      "mnc": "410",
      "data_action": 0,
      "ims_action": 0
    }
  }' | jq -r '.data.id')

# Permitir Verizon
RULE2=$(curl -k -X POST https://hss.example.com:8443/api/roaming/rule \
  -H "Content-Type: application/json" \
  -d '{
    "roaming_rule": {
      "name": "Permitir Verizon",
      "mcc": "311",
      "mnc": "480",
      "data_action": 0,
      "ims_action": 0
    }
  }' | jq -r '.data.id')

# Vincular regras ao perfil (via banco de dados)
# Inserir registros na tabela join_roaming_profile_to_roaming_rule
# para vincular cada ID de regra ao ID do perfil de roaming

Permitir Dados, Bloquear Voz

# Criar regra que permite dados, mas bloqueia IMS
curl -k -X POST https://hss.example.com:8443/api/roaming/rule \
  -H "Content-Type: application/json" \
  -d '{
    "roaming_rule": {
      "name": "Apenas Dados - T-Mobile",
      "mcc": "310",
      "mnc": "260",
      "data_action": 0,
      "ims_action": 1
    }
  }'

Bloquear Redes Específicas (Lista Negra)

# Criar perfil com permissão por padrão
PROFILE_ID=$(curl -k -X POST https://hss.example.com:8443/api/roaming/profile \
  -H "Content-Type: application/json" \
  -d '{
    "roaming_profile": {
      "name": "Bloquear Redes Caras",
      "data_action_if_no_rules_match": 0,
      "ims_action_if_no_rules_match": 0
    }
  }' | jq -r '.data.id')

# Bloquear rede cara específica
curl -k -X POST https://hss.example.com:8443/api/roaming/rule \
  -H "Content-Type: application/json" \
  -d '{
    "roaming_rule": {
      "name": "Bloquear Rede Cara",
      "mcc": "206",
      "mnc": "01",
      "data_action": 1,
      "ims_action": 1
    }
  }'

---

Cenários Comuns de Roaming

Cenário 1: Apenas Roaming Doméstico

O assinante pode roaming dentro do país de origem, mas não internacionalmente.

Configuração:

• Padrão: Negar tudo
• Regras: Permitir todos os códigos MCC dos EUA (310, 311, 312, 313, 314, 315, 316)

Cenário 2: Apenas Parceiros de Roaming

O assinante só pode roaming em redes com acordos comerciais.

Configuração:

• Padrão: Negar tudo
• Regras: Permitir cada rede parceira explicitamente (por MCC/MNC)

Cenário 3: Roaming de Dados, Sem Roaming de Voz

O assinante pode usar dados no exterior, mas deve usar Wi-Fi para chamadas de voz.

Configuração:

• Regras: data_action: 0 (permitir), ims_action: 1 (negar)

Cenário 4: Acesso a Serviços de Emergência

Sempre permitir serviços de emergência, mesmo que o roaming esteja bloqueado.

Nota: O manuseio de serviços de emergência é tipicamente feito no nível do MME/rede. As regras de roaming do OmniHSS se aplicam a serviços normais.

---

Referência MCC/MNC

Códigos de País Comuns (MCC)

MCC	País	Redes
310-316	EUA	AT&T, Verizon, T-Mobile, etc.
302	Canadá	Rogers, Bell, Telus
234-235	Reino Unido	Vodafone, O2, EE
262	Alemanha	Deutsche Telekom, Vodafone
208	França	Orange, SFR, Bouygues
222	Itália	TIM, Vodafone, Wind
214	Espanha	Movistar, Vodafone

Operadoras Comuns dos EUA (MCC 310-316)

MCC	MNC	Operadora
310	410	AT&T
311	480	Verizon
310	260	T-Mobile
310	120	Sprint
313	380	(Rede de teste de exemplo)

Listas Completas: Veja ITU-T E.212 ou bancos de dados MCC/MNC

---

Pontos de Aplicação de Roaming

Interface S6a (Dados)

Quando o assinante se conecta à rede visitada:

Interface Cx (IMS)

Quando o assinante se registra no IMS na rede visitada:

---

Solução de Problemas de Roaming

Assinante Não Consegue Conectar na Rede Visitada

Verifique a atribuição do perfil de roaming:

• Consulte o banco de dados para visualizar o perfil de roaming atribuído ao assinante
• Verifique o nome do perfil e as configurações da ação padrão

Verifique se a regra existe para a rede visitada:

• Consulte o banco de dados para regras de roaming correspondentes ao MCC/MNC da rede visitada
• Verifique se uma regra existe para o perfil de roaming do assinante
• Verifique o valor de data_action para essa rede específica

Assinante Consegue Conectar, Mas Não Registrar IMS

Verifique a ação IMS separadamente:

• Consulte as regras de roaming para a rede visitada
• Verifique os valores de data_action e ims_action
• Procure casos em que os dados são permitidos, mas IMS é negado

Comportamento de Roaming Inesperado

Revise os logs para verificações de roaming:

[info] Verificação de roaming: IMSI 001001123456789, PLMN Visitado 310-410
[info] Regra de roaming correspondente: "Permitir AT&T"
[info] Ação de dados: permitir, Ação IMS: permitir

---

Melhores Práticas

Design de Perfil

1. Comece restritivo - Negar por padrão, permitir explicitamente parceiros
2. Teste minuciosamente - Verifique regras em laboratório antes da produção
3. Documente regras - Mantenha uma lista de redes permitidas e por quê
4. Revise regularmente - Atualize conforme os acordos de roaming mudam

Gestão de Regras

1. Use nomes descritivos - "Permitir-ATT-Apenas-Dados" não "Regra1"
2. Verifique MCC/MNC - Verifique os códigos contra bancos de dados oficiais
3. Considere ambos os serviços - Pense em dados e IMS separadamente
4. Monitore o uso - Acompanhe quais redes os assinantes realmente visitam

Procedimentos Operacionais

1. Mudanças de Emergência - Tenha um procedimento para habilitar/desabilitar rapidamente o roaming
2. Atualizações em Massa - Planeje para atualizar os perfis de roaming de múltiplos assinantes
3. Relatórios - Acompanhe o uso de roaming e tentativas negadas
4. Comunicação com Clientes - Notifique os clientes sobre mudanças na política de roaming

---

← Voltar para o Guia de Operações | Próximo: Fluxos de Protocolo →