Autenticação
🔍 Preview
A autenticação é o mecanismo que garante acesso seguro aos dados sensíveis do lojista e viabiliza integrações externas, como ERPs, ferramentas de automação e aplicações de apoio à operação da loja.
Diferente da Persistência de dados, a autenticação não está relacionada à experiência do cliente final, mas sim à segurança e controle de acesso da plataforma.
🎯 Quando você precisa de autenticação
Você precisará lidar com autenticação se estiver:
- Criando integrações com ERPs
- Desenvolvendo ferramentas externas
- Automatizando processos administrativos
- Consumindo dados privados da loja
- Operando fora do contexto dos frontends padrão
- Quem pode acessar
- O que pode acessar
- Até onde pode acessar
- Pedidos completos
- Informações financeiras
- Produtos e estoque
- Configurações da loja
- Integrações e automações
- Persistência de dados é voltada para experiência do cliente final
- Autenticação é voltada para integrações e ferramentas externas
- Nunca exponha credenciais no frontend
- Use autenticação apenas em ambientes controlados
- Separe ambientes de teste e produção
- Trate tokens como dados sensíveis
- Monitore limites e acessos
Se o seu foco é Store Theme, Checkout ou Área Restrita, provavelmente você está procurando Persistência de dados, não Autenticação.
🧠 O que é autenticação na uappi?
Na uappi, autenticação é o processo que valida e autoriza aplicações externas a acessarem a API Privada, garantindo que apenas o lojista (ou sistemas autorizados por ele) tenham acesso a dados sensíveis.
Ela define:
🔑 API Privada
A API Privada concentra dados sensíveis do lojista, como:
O acesso à API Privada exige autenticação obrigatória
Não é possível consumi-la sem credenciais válidas.
♻️ Autenticação ≠ Persistência de dados
Reforçando a separação de conceitos:
| Conceito | Responsabilidade |
|---|---|
| Persistência de dados | Persistência de dados do cliente entre aplicações |
| Autenticação | Segurança e acesso a dados privados do lojista |
🛠️ Boas práticas
🏁 Próximo passo
Agora que você entende como funciona a autenticação e o acesso à API Privada, escolha o caminho mais adequado para o seu cenário:
🔐 Criando integrações ou ferramentas externas
Se o seu objetivo é criar integrações, automações ou ERPs, o próximo passo é entender como autenticar requisições e acessar a API Privada.API Privada: como autenticar, endpoints e recursos
🎨 Trabalhando no front-end da loja
Se você está customizando ou desenvolvendo temas frontend, siga para os tópicos específicos de cada aplicação:Store Theme: estrutura da loja e experiência do cliente