Este artigo descreve como implementar um fluxo de cadastro e login unificado (SSO) utilizando as APIs abertas da Cativa. Aqui você aprenderá como identificar corretamente uma comunidade, registrar usuários de forma programática e autenticar acessos externos, permitindo que usuários sejam redirecionados para a plataforma da Cativa já autenticados, sem necessidade de login manual.
O conteúdo é indicado para desenvolvedores, equipes técnicas e parceiros que desejam integrar sistemas externos à infraestrutura de comunidades da Cativa com segurança e fluidez.
Introdução
A Cativa disponibiliza um conjunto de APIs abertas que permitem integrar sistemas externos ao fluxo de autenticação das comunidades, viabilizando experiências de acesso mais simples, rápidas e centralizadas para o usuário final.
Neste guia, você verá passo a passo como:
Identificar corretamente uma comunidade a partir de sua URL
Criar usuários via API de forma segura
Implementar um fluxo de login único (Single Sign-On) utilizando tokens de autenticação
Redirecionar usuários para a comunidade já autenticados, eliminando fricções no acesso
A abordagem apresentada neste artigo é ideal para cenários como integrações com plataformas próprias, CRMs, sistemas de pagamento, aplicativos mobile ou qualquer ambiente que exija controle externo sobre o processo de cadastro e login dos usuários na Cativa.
Importante: todas as chamadas descritas utilizam headers específicos da Cativa e seguem os padrões oficiais da API, garantindo compatibilidade, segurança e escalabilidade.
1. Obtenha o Slug ou Nome da comunidade:
Isso só precisa ser feito uma vez
MÉTODO: GET - https://social-api.cativalab.digital/v1.1/customer/name
Adicionar o header na requisição
Header: Cativa-Origin
Valor: url da comunidade (ex: https://comunidade.cativa.digital)
2. Cadastre o usuário
MÉTODO POST - https://social-api.cativalab.digital/v1.1/user
Adicionar o header na requisição
Header: Cativa-Customer
Valor: nome da comunidade obtida na chamada anterior (por ex: inovation)
Resposta cadastrar usuário:
3. Bônus: Crie um fluxo de login único utilizando a API de login com o usuário
MÉTODO POST - https://social-api.cativalab.digital/v1.1/auth/login
Adicionar o header na requisição
Header: Cativa-Customer
Valor: nome da comunidade obtida na chamada anterior (por ex: inovation)
Resposta login usuário
Para redirecionar o usuário para a comunidade já estando autenticado adicione na URL de redirecionamento o seguinte parâmetro:
?externalAuth={accessToken}
onde accessToken é o valor do accessToken retornado tanto no login quanto no registro.
Por exemplo: https://comunidade.cativa.digital?externalAuth=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ…
Este documento contém informação confidencial e privilegiada. Qualquer uso ou divulgação não autorizado deste documento, na sua totalidade ou em parte é estritamente proibido. Todo conteúdo é protegido pela legislação de propriedade intelectual em favor da Cativa Tecnologia e Serviços Digitais Ltda ©, que possui todos os direitos reservados.