Pular para o conteúdo
Documentação do Aura Home

Prepare um portal de cliente para o Aura Home

Use este checklist antes do início da implementação. Ele ajuda a Cadisa e a equipe do cliente a alinhar os detalhes de portal, identidade, runtime, segurança e lançamento necessários para uma integração tranquila do SDK.

Informações do cliente

Item Exemplo Responsável
Domínio do portal https://portal.customer-domain.com Cliente
Domínio do runtime do Aura Home https://aura.customer-domain.com Cadisa + Cliente
Provedor de identidade Okta, Azure AD, Auth0, Google ou ponte SAML Cliente
Emissor OIDC https://customer.okta.com/oauth2/default Cliente
Client ID ou audiência aura-home Cliente
Origem pai permitida https://portal.customer-domain.com Cadisa
Perfil de marca ID do tema, URL do logotipo, modo, cor primária, cor de destaque e família de fontes Cliente + Cadisa
Contato técnico Responsável de engenharia designado e canal de suporte Cliente

Prontidão do portal

  • A página do portal tem um contêiner estável para o Aura Home.
  • O portal é servido via HTTPS com um certificado confiável.
  • O portal consegue carregar o pacote do SDK ou o asset empacotado do SDK.
  • A Content Security Policy permite o runtime do Aura Home em frame-src e connect-src.
  • O portal consegue fornecer um token OIDC/JWT por meio de auth.getToken quando o SSO corporativo está ativado.

Decisões de integração

Decisão Padrão recomendado
Seções visíveis Comece com chat e profile; oculte a barra de navegação, o rodapé, o onboarding, os preços e as páginas legais dentro dos portais do cliente.
Altura do contêiner Use um espaço fixo ou uma altura baseada na viewport, como calc(100vh - 120px), com um mínimo adequado.
Autenticação Use OIDC/JWT por meio de auth.getToken; faça a ponte de SAML para OIDC/JWT, se necessário.
Identidade visual Dê preferência a perfis de aparência publicados pelo dashboard e a variáveis CSS permitidas; use folhas de estilo hospedadas apenas para refinamentos mais amplos e específicos do cliente.
Validação de lançamento Teste HTTPS, CSP, claims de token, carregamento do iframe, eventos do SDK e dimensionamento em dispositivos móveis antes da implantação em produção.

Pacote de entrega

Antes do lançamento, as equipes do cliente e da Cadisa devem confirmar o seguinte:

  • URL final do runtime e valores de origem permitida.
  • Valores finais de emissor e audiência da identidade.
  • Responsabilidade pelo certificado e processo de renovação.
  • Regras de CSP de produção.
  • ID do tema aprovado e perfil de aparência publicado pelo dashboard para o runtime de destino.
  • Canal de suporte para falhas de autenticação, iframe ou certificado.