Planeje incorporações nos ambientes dev, staging e production

Cada ambiente deve ter URLs de runtime explícitas, origens permitidas, configuração de identidade, cobertura de certificado e verificações de validação.

Matriz de ambientes

Ambiente	URL do portal	`baseUrl` do Aura Home	Identidade	Certificado
Development	`https://dev-portal.customer-domain.com`	Runtime dev do cliente ou da Cadisa	App de IdP de teste ou tenant de teste	Certificado dev confiável
Staging	`https://staging.customer-domain.com`	Runtime staging do Aura Home	App de IdP de staging com claims equivalentes às de production	Certificado staging confiável
Production	`https://portal.customer-domain.com`	Runtime production do Aura Home	App de IdP de production	Certificado de production com renovação automática

Padrão de configuração

const aura = AuraHome.init({
  container: "#aura-home",
  baseUrl: window.AURA_HOME_BASE_URL,
  allowedOrigin: window.AURA_HOME_ALLOWED_ORIGIN,
  sdkHost: window.location.hostname,
  auth: {
    mode: "oidc",
    getToken: async () => customerIdentity.getIdToken()
  }
});

Valores por ambiente

Valor	Precisa ser diferente em cada ambiente?	Observações
`baseUrl`	Geralmente sim	Aponta o SDK para o runtime do Aura Home de destino.
`allowedOrigin`	Geralmente sim	Deve corresponder exatamente à origem do runtime.
`theme.id`	Às vezes	Apenas solicitação visual. Precisa ser aprovado pela lista de permissões do runtime ou publicado por meio do Appearance Editor do dashboard.
Emissor OIDC	Às vezes	Alguns clientes usam apps de IdP separados para staging e production.
Client ID ou audiência OIDC	Frequentemente sim	Recomendado quando o IdP suporta aplicações específicas por ambiente.
Origem do portal pai	Sim	As listas de permissões do runtime devem incluir somente origens aprovadas do cliente.

Checklist de promoção para production

As claims de token de staging correspondem ao contrato de token de production.
O certificado de production é válido e a renovação automática está ativa.
A CSP de production permite o runtime e os endpoints de identidade.
A lista de permissões do runtime de production inclui somente a origem do portal.
O perfil de aparência de production foi pré-visualizado e publicado para o modo light, dark ou system.
Os eventos de ciclo de vida do SDK são monitorados durante a primeira janela de lançamento.