As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Aplicar a identidade visual às páginas de login gerenciado
Você pode querer proporcionar uma experiência de usuário consistente entre seu serviço de autenticação e sua aplicação. Você pode atingir essa meta com formulários personalizados e operações de API de back-end em um AWS SDK ou com login gerenciado. O login gerenciado e a IU hospedada clássica são frontends da web para o componente da sua aplicação que fornece autenticação com grupos de usuários. Para sincronizar seus serviços de autenticação gerenciada com a UX da sua aplicação, você tem duas opções de personalização: o editor de identidade visual e a identidade visual de IU hospedada. Você pode escolher a experiência de sua preferência no console do Amazon Cognito e com as operações de API do grupo de usuários.
- O editor de identidade visual
-
O editor de identidade visual é a mais nova opção de personalização para a mais nova experiência de IU de grupos de usuários, o login gerenciado. O editor de identidade visual é um editor visual no-code para estilos e ativos de login gerenciado e um conjunto de operações de API para configuração programática de inúmeras opções de configuração. Os grupos de usuários que você configura com um domínio e um login gerenciado exibem automaticamente a versão de designer de marcas de suas páginas de login.
- Identidade visual de IU hospedada (clássica)
-
A experiência de marca da IU (clássica) tem duas opções: modificar um arquivo Cascading Style Sheets (CSS) com um conjunto fixo de opções de estilo e adicionar uma imagem de logotipo personalizada. Você pode definir essas opções no console do Amazon Cognito ou com a operação Set UICustomization API. Na época em que o serviço foi lançado, o Amazon Cognito tinha somente essa opção. Os grupos de usuários que você configura com um domínio e a versão de marca da IU hospedada exibem automaticamente a versão clássica de suas páginas de login. Seu plano de recursos também pode ser compatível somente com a interface hospedada.
nota
O editor de identidade visual e a experiência de identidade visual clássica modificam as propriedades visuais do seu serviço de autenticação hospedado. Atualmente, você não pode modificar o texto exibido em suas páginas de login gerenciado, exceto para aplicar a localização em um dos vários idiomas. Para obter mais informações sobre localização, consulte Managed login localization.
Escolher uma experiência de identidade visual e atribuir estilos
No console do Amazon Cognito, novos grupos de usuários usam como padrão a experiência de identidade visual de login gerenciado. Os grupos de usuários que você configurou antes da disponibilização do login gerenciado terão a identidade visual de IU hospedada (clássica). Você pode alternar entre a identidade visual de login gerenciado e de IU hospedada. Quando você altera sua versão de marca, o Amazon Cognito aplica imediatamente a alteração às páginas interativas do domínio do seu grupo de usuários. Com o login gerenciado e a IU hospedada, seu grupo de usuários pode ter um estilo para cada cliente de aplicação.
Cada cliente de aplicação pode ter um estilo de identidade visual distinto, mas um domínio do grupo de usuários serve tanto para o login gerenciado quanto para a IU hospedada. Um estilo é o conjunto de configurações de personalização aplicadas a um cliente de aplicação. Você pode configurar um domínio personalizado e um domínio de prefixo por grupo de usuários. Você pode atribuir diferentes versões de marca aos seus domínios personalizados e de prefixo. No entanto, um domínio de prefixo não é totalmente funcional quando você também tem um domínio personalizado; os endpoints de descoberta .well-known do OIDC apresentam somente caminhos de domínio personalizados. Você só pode usar o domínio de prefixo para operações que não exijam descoberta de endpoint (openid-configuration) em um grupo de usuários com essa configuração. Devido a essas propriedades dos grupos de usuários, você pode escolher efetivamente uma versão de marca por grupo de usuários.
Você pode atribuir estilos aos clientes da aplicação em um grupo de usuários em que um domínio é definido para a versão da marca de login gerenciado. Estilos são um conjunto de configurações visuais composto por arquivos de imagem, opções de exibição e valores CSS. Quando você atribui um estilo a um cliente de aplicação, o Amazon Cognito envia imediatamente suas atualizações para suas páginas de login interativas. O Amazon Cognito exibe suas páginas interativas com a versão de identidade visual escolhida e a personalização que você aplicou a ela.
Atualizar e excluir estilos
Ao criar um estilo, você o vincula a um cliente de aplicação. Para alterar uma atribuição de estilo para um cliente de aplicação, você deve primeiro excluir o estilo original. No momento, não é possível copiar configurações entre estilos. Isso deve ser feito de maneira programática. Para replicar as configurações entre estilos e clientes de aplicativos, obtenha as configurações de um estilo com a operação da DescribeManagedLoginBrandingAPI e aplique-as com CreateManagedLoginBrandingou UpdateManagedLoginBranding. Você não pode alterar os estilos atribuídos de um cliente de aplicação. Você só pode excluir o original e definir um novo. Para obter mais informações sobre como gerenciar estilos com operações de API e SDK, consulte Operações de API e SDK para identidade visual de login gerenciado.
nota
As solicitações programáticas que criam ou atualizam o estilo de identidade visual devem ter um tamanho de solicitação não superior a 2 MB. Se sua solicitação for maior que esse limite, divida sua solicitação em várias solicitações UpdateManagedLoginBranding para grupos de parâmetros que não excedam o tamanho máximo da solicitação. Essas solicitações não resultam na definição de parâmetros não especificados como padrão, portanto, você pode enviar solicitações parciais sem afetar as configurações existentes.
Para excluir um estilo no console do Amazon Cognito, acesse o menu Login gerenciado. Em Estilos, escolha o estilo que deseja excluir e clique em Excluir estilo.
Em linhas gerais, o processo de atribuição de identidade visual a um domínio consiste nas etapas a seguir.
-
Crie um estilo de identidade visual e atribua-o a um cliente de aplicação.
Como atribuir um estilo a um cliente de aplicação
-
No menu Domínio do grupo de usuários, crie um domínio e defina a Versão de marca como Login gerenciado.
-
Navegue até o menu Login gerenciado. Em Estilos, selecione Criar um estilo.
-
Escolha o cliente de aplicação ao qual deseja atribuir seu estilo ou crie um novo cliente de aplicação.
-
Para começar a definir suas configurações de marca, selecione Iniciar editor de identidade visual.
Tópicos
