Histórico da Página

CONTEÚDO

1. Visão geral
2. Exemplo de utilização 
   1. Caminho
      
    
   1. Parâmetros dinâmicos
   2. Pré-requisitos, restrições e parametrizações
   3. Pré-requisitos técnicos
   4. Passo a passo 
3. Tecnologias homologadas
4. Documentação e assuntos relacionados
   
5. Documentação de versões e atualizações

01. VISÃO GERAL

Este documento visa orientar o processo de atualização da autenticação do servidor de comanda mobile e dos aplicativos (Comanda Mobile, Papa Fila), considerando a convivência temporária entre o método de autenticação novo e o método antigo.

Para tornar o uso do Servidor Comanda Mobile ainda mais seguro e alinhado aos padrões atuais, foi realizada uma atualização no processo de comunicação entre o aplicativo e o ambiente do cliente.

Essa melhoria foi planejada para acontecer gradualmente, mantendo o funcionamento normal durante o período de transiçãoA nova autenticação introduz o uso de credenciais explícitas (usuário e senha) na conexão com os endpoints do servidor. Para garantir continuidade operacional durante o processo de atualização, foi implementado um mecanismo de compatibilidade, permitindo que clientes ainda não atualizados continuem operando utilizando o modelo legado.

02. EXEMPLO DE UTILIZAÇÃO

Caminho

Não há.

Parâmetros dinâmicos

...

Este procedimento deve ser seguido nos seguintes cenários:

• Atualização do servidor comanda mobile nos dispositivos já em uso;

• Instalação do aplicativo em novos aparelhos;

• Atualização do ambiente do cliente, mantendo o aplicativo alinhado às melhorias de segurança.

CAMINHO

No dispositivo móvel (celular ou tablet):

Downloads → Arquivo do aplicativo (APK) → Instalar / Atualizar

PARÂMETROS DINÂMICOS

Para que o aplicativo se conecte corretamente ao ambiente, são utilizadas as seguintes informações de acesso:

Essas informações são utilizadas automaticamente pelo aplicativo durante a conexão com o ambiente.

PRÉ-REQUISITOS, RESTRIÇÕES E PARAMETRIZAÇÕES

• O aplicativo servidor comanda mobile deve estar atualizado nos dispositivos

Os parâmetros acima são enviados pelo aplicativo durante a abertura da conexão com o servidor.

O não cumprimento dos Pré-Requisitos a seguir pode impactar o sistema. Confirme as condições exigidas antes de qualquer alteração.

Pré-Requisitos, Restrições e Parametrizações

• O servidor deve estar atualizado para suportar autenticação compatível (nova e antiga).

• Durante o período de transição, recomenda-se atualizar o servidor antes dos primeiro o ambiente e, em seguida, os aplicativos.

• A autenticação antiga (sem usuário e senha) deve ser considerada temporária, apenas para fins de compatibilidade.

Pré-Requisitos técnicos

• Servidor Comanda Mobile atualizado com suporte à nova autenticação.

• Aplicativos compilados com envio de credenciais de autenticação.

• Infraestrutura de rede sem bloqueios para comunicação entre cliente e servidor.

• Parâmetros de autenticação configurados corretamente no ambiente.

Passo a Passo 

1. Atualização do Servidor Comanda Mobile

1. Aplicar a versão do servidor que implementa a autenticação compatível.

2. Validar que o servidor aceita:

   • Conexões sem usuário e senha (modo antigo).

   • Conexões com usuário e senha válidos (modo novo).

3. Reiniciar o serviço do servidor conforme procedimento padrão do ambiente.

2. Atualização dos Aplicativos 

1. Atualizar o executável do aplicativo (Comanda Mobile, Papa Fila).

2. Garantir que o aplicativo esteja configurado para enviar:

   • DSAuthenticationUser

   • DSAuthenticationPassword

3. Validar o comportamento:

   • Credenciais válidas → conexão permitida.

   • Credenciais inválidas → acesso negado com mensagem de autenticação.

3. Validação de compatibilidade

...

Cliente antigo + servidor novo → deve conectar.

...

Cliente novo + servidor novo → deve conectar.

• utilização de versões antigas do aplicativo é considerada temporária e somente para garantir a continuidade da operação.

• O aplicativo deve ser instalado exclusivamente a partir de canais oficiais da TOTVS.

PRÉ-REQUISITOS TÉCNICOS

Para o correto funcionamento do servidor comanda mobile, é necessário:

• Ambiente atualizado conforme orientações da TOTVS (quando aplicável);

• Dispositivos com acesso à internet ou à rede do ambiente;

• Informações de acesso configuradas corretamente.

PASSO A PASSO

Atualização do ambiente (quando aplicável)

1. Aplicar a versão do ambiente que contempla a melhoria de segurança.

2. Reiniciar os serviços conforme o procedimento padrão do cliente.

3. Validar que o ambiente está operacional.

Atualização do aplicativo nos dispositivos

1. Baixar o aplicativo servidor comanda mobile por meio dos canais oficiais da TOTVS: totvs.fluigidentity.com/cloudpass/SPInitPost/receiveSSORequest/zf0y84vo717g8hjx/xlglk8zqmzw44blf1442945918727

2. No dispositivo, acessar a pasta Downloads.

3. Tocar no arquivo do aplicativo para iniciar a instalação ou atualização.

4. Concluir o processo seguindo as instruções exibidas na tela.

5. Abrir o aplicativo após a instalação.

Validação da atualização

Após a atualização, realizar as seguintes validações:

1. O aplicativo abre normalmente;

2. A conexão com o ambiente ocorre sem mensagens de erro;

3. É possível realizar uma operação básica (por exemplo, consultar ou abrir uma comanda)

...

1. .

03. TECNOLOGIAS HOMOLOGADAS

04. DOCUMENTOS E ASSUNTOS RELACIONADOS

Não há.

05. DOCUMENTOS DE VERSÕES E ATUALIZAÇÕES

Não há.