# Integração de Acessos LTE - Magma

## Introdução

>[!TIP] Definição - Magma:  
>A **[Magma](https://magmacore.org/)** é uma plataforma de rede móvel que simplifica a implantação e o gerenciamento de redes LTE e 5G. A Magma permite a operadoras, provedores de serviços e empresas implementarem redes celulares de forma eficiente, especialmente em áreas com infraestrutura limitada. Sua arquitetura modular e integração com tecnologias modernas a tornam ideal para expandir a conectividade e promover a inclusão digital.

>[!NOTE] **Acesso à Funcionalidade**  
>**Caminho:** Configurações > Integrações > Integrações Acessos Internet  

### Requisitos de Uso
Para utilizar esta integração no sistema, é necessário ter acesso às credenciais de integração:
- URL;
- Arquivo e senha do certificado SSL;
- Identificador do provedor na Magma.

>[!INFO] Informação:
>Todos os dados citados são fornecidos pela plataforma credenciada.

## Entrega de Valor
A integração da **Magma LTE** ao sistema oferece os seguintes benefícios:  
- Unificação do gerenciamento de banda larga e telefonia móvel;
- Simplificação de processos operacionais;
- Melhoria na gestão de inadimplência;
- Ampliação da oferta de serviços de telecomunicações.

## Configuração da Integração
Siga os passos abaixo para configurar a integração da Magma LTE:  

### Passo 1: Cadastro da Integração no Sistema

1. Acesse o formulário [[integracoes acessos internet|Integrações Acessos Internet]] através do caminho: Configurações > Integrações > Integrações Acessos Internet;
2. Clique no botão **Novo** para iniciar o cadastro da integração;
3. Preencha os campos:
	- **Integração:** selecione a opção **Magma** no botão de seleção;
	- **Nome:** insira uma breve descrição sobre o cadastro da integração 
	- **URL:** insira a URL fornecida pela Magma com o direcionamento da porta utilizada para acesso. Insira, ao final da URL, o **sufixo** `/magma/v1/`;
	- **Certificado SSL:** clique no botão **Arquivo** e selecione o certificado SSL fornecido pela plataforma;
	- **Senha certificado SSL:** insira a senha do certificado SSL;
	- **Active apus:** insira o identificador do seu provedor na plataforma;
	  
4. Clique em **Salvar** para validar o cadastro da integração;

### Passo 2: Cadastro do Plano de Velocidade
Realize o cadastro de um produto para vinculá-lo no plano de velocidade. Em seguida, cadastre o plano de velocidade para incluir nos logins Magma. Siga os passos a seguir:

1. Acesse o formulário de [[cadastro de produtos|Cadastro de Produtos]] através do caminho: Sistema > Cadastro > Produtos;
2. Clique no botão **Novo**;
3. Na aba **Produtos** e na aba **Planejamento**, preencha os campos obrigatórios;
4. Clique em **Salvar** para concluir a configuração do produto.
5. Em seguida, acesse menu Sistema > Provedor > Plano de velocidade > clique no botão Novo para iniciar o registro de um plano de velocidade;
6. Na aba **Plano**, preencha os campos:
	- **Produto:** clique na lupa e selecione o produto cadastrado;
	- **Nome do plano:** insira o nome do plano correspondente;
	
7. Acesse a aba **DICI** e no campo **Tipo de conexão** marque a opção "LTE";

>[!CAUTION] Atenção:
>Para que a ativação do login e autenticação com a Magma ocorram corretamente, é necessário que os **Tipos de transmissão utilizados no sistema** 5.8 e TLE estejam **liberados**.
>Verifique em menu Configurações > Parâmetros > Parâmetros gerais > aba Logins > seção **Tipos de transmissão utilizados no sistema**. Se necessário, marque a caixa de seleção ao lado do parâmetro e clique em **Salvar** para registrar as modificações.

### Importação Acessos LTE

#### Importação em Massa - Rotina de Importar Acessos LTE
A importação dos acessos LTE é um processo de migração em massa de dados de **Acessos LTE**, dado fundamental para a ativação do login PPoE. É um processo opcional.

>[!TIP] IMSI:
>**Definição:** IMSI (International Mobile Subscriber Identity) é um código único que identifica um assinante de telefonia móvel. Ele é armazenado no cartão SIM e é usado para autenticação e identificação de usuários.
>
>Para realizar a importação dos acessos LTE, é necessário ter acesso à listagem de IMSIs disponíveis na Magma.

1. Acesse menu Configurações > Rotinas provedor > botão **Importar Acessos LTE**;
2. Insira o arquivo de acesso LTE fornecido pela plataforma no campo "Arquivo Acessos LTE";
3. Clique em **Salvar** para concluir a importação.

#### Importação Através do Cadastro Manual
Para realizar a importação pelo cadastro manual do acesso LTE, é possível efetuar através do próprio cadastro do login PPoE.

>[!INFO] Importação individual:
>Além da importação em massa, também é possível registrar um único Acesso LTE através do cadastro do login PPoe.

1. Acesse menu Sistema > Provedor > Logins;
2. Clique no botão **Novo**;
3. Marque os campos:
	- **Autenticação:** selecione a opção "Integração";
	- **Tipo de conexão:** selecione a opção "LTE";
	  
4. O campo **Acesso LTE** será exibido. Clique na lupa > Novo;
5. Preencha os campos:
	-  **ID:** identificador na plataforma;
	- **Lte auth key:** insira a chave de autenticação;
	- **Lte auth opc:** insira o IMSI;
	  
>[!TIP] Informações:
>Todos os dados que são preenchidos no sistema, são fornecidos pela plataforma Magma.	  

### Criação do Login PPoE
Para realizar a ativação do acesso LTE, é necessário realizar o cadastro de um login PPoE. Para realizar este procedimento, siga as etapas abaixo:

>[!INFO] Atenção:
>O processo descrito de ativação do login PPoE para o acesso LTE neste material já considera a existência da ativação de um contrato. Caso seja necessário, consulte o guia de instrução de como realizar o cadastro de um contrato: [[cadastro de contratos no sistema|Cadastro de Contrato no Sistema]];

1. Acesse o contrato do cliente do qual irá realizar a ativação através do caminho: Sistema > Cadastros > Contratos;
2. Acesse a aba **Produtos** e certifique-se de que o plano de velocidade criado anteriormente esteja relacionado ao contrato;
3. Em seguida, acesse a aba **Login** e clique no botão **Novo** para registrar o login;
4. Preencha os campos:
	- **Autenticação:** marque a opção **Integração**;
	- **Tipo de conexão:** marque a opção **LTE**;
	- **ID integração:** clique na lupa e selecione a integração da Magma cadastrada em seu sistema;
	- **Acessos LTE:** clique na lupa e selecione o ID do Acesso LTE que será relacionado à este cliente (dados fornecidos pela Magma);
	- **Pacote LTE:** se o **Tipo de conexão for igual à LTE**, clique no botão **Buscar Pacote LTE** e selecione o pacote LTE;
	- **Plano:** clique na lupa e selecione o plano relacionado ao contrato;
	- **Login:** insira o login;
	- **Senha:** insira a senha correspondente;
	  
5. Clique em **Salvar** para concluir a ativação do login LTE.


>[!INFO] Ativação:
>O sistema **somente** ativa o acesso LTE, não abrangendo gerenciamento relacionado à:
>- Controle de acesso;
>- Falha de autenticação;
>- Entrega de rede.

## Fluxo de Trabalho

```mermaid
graph TD
    A[Credenciamento na Plataforma Magma] --> B[Cadastro da Integração no Sistema]
    B --> C[Cadastro de Planos de Velocidade: 5.8/LTE]
    C --> D[Importação dos Acessos LTE]
    D --> E[Ativação do Login LTE]
```

## Considerações Finais
A integração da **Magma LTE** ao sistema de gerenciamento de acessos oferece uma solução moderna e acessível para expandir a conectividade e otimizar a gestão de redes. Com sua arquitetura modular e foco em redução de custos, a Magma é ideal para operadoras, provedores de serviços e empresas que buscam eficiência e escalabilidade.  

## Etiquetas
#Integracoes #IntegracoesAcessoInternet #LTE #Telefonia #IntegracaoMagma #Login 

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes acessos internet|Integrações de Acessos Internet (LTE)]]
- [[login|Login]]
- [[aba cadastro de login|Cadastro de Login]]