Pular para o conteúdo
Idioma
Fale com a Cadisa
Documentação do Aura Home

Diagnostique problemas de integração do cliente

Use este guia quando uma incorporação do Aura Home não carregar, não autenticar, não renderizar ou não passar na validação de lançamento em um portal do cliente.

Verificações rápidas

  1. Abra o baseUrl configurado diretamente em uma aba do navegador.
  2. Confirme que a página do portal, o runtime, os assets do SDK e os endpoints de identidade usam HTTPS.
  3. Verifique no console do navegador se há erros de CSP, de framing, de conteúdo misto ou de certificado.
  4. Confirme que o callback de token retorna um token OIDC/JWT válido.
  5. Escute os eventos loaded, ready, configAck, tokenProvided e error do SDK.

Sintomas e correções

Sintoma Causa provável Correção
O iframe está em branco A URL do runtime está errada, bloqueada ou sem permissão para ser exibida em frame. Abra o baseUrl diretamente, verifique as listas de permissões do runtime e inspecione os erros de framing no console do navegador.
O SDK não encontra o contêiner O AuraHome.init é executado antes que o contêiner exista. Crie <div id="aura-home"></div> antes da inicialização ou inicialize depois que o componente for montado.
O evento ready nunca é disparado O runtime carregou, mas não concluiu o handshake do SDK. Verifique o allowedOrigin, a disponibilidade do runtime e os erros de console dentro do iframe, se estiverem acessíveis.
O SSO retorna 401 Token ausente, expirado ou inválido. Valide iss, aud, sub, exp, a assinatura e a configuração OIDC do runtime.
O SAML funciona, mas o Aura Home fica anônimo Não foi feita a ponte da sessão SAML para um token OIDC/JWT. Troque a sessão SAML por meio do gateway de identidade do cliente e retorne o token OIDC/JWT em getToken.
Aviso de conteúdo misto Algum script, iframe, API, folha de estilo ou imagem usa HTTP. Migre todas as URLs da integração para HTTPS.
Aviso de certificado Certificado expirado, SAN incorreto ou cadeia incompleta. Renove ou emita novamente o certificado e sirva a cadeia completa a partir da borda.
O tema não é aplicado O theme.id solicitado não é permitido, os nomes das variáveis CSS são inválidos ou a folha de estilo hospedada está bloqueada. Confirme a lista de permissões do runtime ou o perfil de aparência publicado pelo dashboard, use variáveis que comecem com -- e permita a URL da folha de estilo na CSP.

Trecho de código para depurar eventos

const aura = AuraHome.init({
  container: "#aura-home",
  baseUrl: "https://aura.customer-domain.com/",
  allowedOrigin: "https://aura.customer-domain.com",
  auth: {
    mode: "oidc",
    getToken: async () => customerIdentity.getIdToken()
  }
});

["loaded", "ready", "configAck", "tokenProvided", "error"].forEach((eventName) => {
  aura.on(eventName, (event) => {
    console.info("[Aura Home]", eventName, event);
  });
});

O que enviar ao suporte da Cadisa

  • URL do portal e URL do runtime do Aura Home.
  • Nome do ambiente: development, staging ou production.
  • Erros do console do navegador, com tokens e segredos removidos.
  • Status de rede do runtime no iframe e dos assets do SDK.
  • Resumo das claims do token: apenas emissor, audiência, expiração e presença do sujeito. Não envie tokens brutos.