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-srceconnect-src. - O portal consegue fornecer um token OIDC/JWT por meio de
auth.getTokenquando 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.