Gerenciando Temas

Editar online

Os temas são usados para personalizar as aplicações no seu tenant. Os temas concedem aos usuários uma aparência customizada das páginas exibidas pelo IBM® Verify.

Sobre esta tarefa

Importante:

Restrinja o acesso à gestão de temas utilizando as funcionalidades de funções e permissões de administrador. Limite o acesso à função “Desenvolvedor de temas” e à manageThemes autorização. O HTML personalizado pode incluir tags ` JavaScript ` embutidas. Sanitize o conteúdo HTML antes de enviar o arquivo ou defina uma Política de Segurança de Conteúdo personalizada para impedir a execução de scripts embutidos.

Ao configurar um aplicativo no IBM Verify, você pode aplicar um tema para que sua marca apareça nas páginas de login. O grupo de arquivos em um tema pode ser atualizado conforme a necessidade. Os temas são específicos para um locatário.

A maioria dos arquivos de tema contém macros que podem ser modificadas com informações de contexto. Macros são os caracteres entre os símbolos @ em que os dados são renderizados no tempo de execução. Um exemplo do formato é:
@ACTION@
Mantenha as macros no arquivo de tema, mas o restante da formatação da página ou da notificação pode ser modificado de acordo com suas necessidades.
Observação: O tamanho máximo de um arquivo de tema é de 100 KB.

Os arquivos de tema são transferidos por download e por upload usando um arquivo compactado no formato a seguir:

/templates/
           {templateDirectories}/
                  	{locales}/
                               {templateNames}
Observação: as páginas nos diretórios a seguir são compatíveis apenas com o tema padrão. As páginas no tema padrão não são específicas de um aplicativo. Elas se aplicam a todos os aplicativos no seu Verify tenant.
  • templates/notifications/access_applications_request
  • templates/notifications/user_management/admin
  • templates/notifications/user_management/legacy_deprecated
  • templates/notifications/user_management/login/user_password_expired_email.xml
  • templates/notifications/user_management/login/user_password_expiring_email.xml

Depois de criar um tema, aplique-o a seu aplicativo configurando o campo Tema nas configurações do aplicativo. Para obter mais informações, consulte a seção “Configurando os detalhes básicos do aplicativo ”.

Procedimento

Solicite um token de acesso para trabalhar com os temas.
Use um cliente API que tenha a autorização manageTemplates para gerar um token de acesso. Para obter mais informações, consulte Criação de clientes de API.
Request:

curl https://<tenant-hostname>/oidc/endpoint/default/token 
-d "grant_type=client_credentials&client_id=<client_id>&client_secret=<client_secret>"
Response:
{
"access_token":"m1KhswVeQy84CF4sAki88phTkpmnYtaDzWi26ASX",
"grant_id":"079ffb03-61ed-44fe-b42f-cb6f51c8c169",
"token_type":"Bearer",
"expires_in":7200
}

Salve o token de acesso para solicitações subsequentes.

O quê fazer em seguida

Selecione uma das tarefas relacionadas a seguir para continuar a definição de marca para o locatário do seu Verify.