Atribuição da autenticação por identificador (IFA) a temas

Quando o seu fluxo de autenticação Identifier-First (IFA) for publicado no Flow Designer, você deverá atualizar os temas desejados para personalizar a experiência de login e utilizá-lo.

Antes de começar

Sobre esta tarefa

Atualize os temas desejados para personalizar a experiência de login, atualizando a seguinte página HTML: template/authentication/login/identity sources/identity source selection/combined_login_selection.html.

O recurso de personalização da marca do Verify permite modificar os arquivos HTML do tema e aceita a inclusão de ` JavaScript, ` diretamente no código, para que você possa adicionar um script que inicie o fluxo do IFA diretamente da página de login. theme.zipOs pacotes de temas são atualizados baixando o arquivo, editando seus arquivos e reenviando o .zip arquivo por meio da API de personalização.

Procedimento

  1. Baixe o seu tema atual.

    Os temas podem ser atualizados tanto pela interface do usuário do Verify quanto pela API de personalização.

    Usar a interface de usuário do Verify
    Se você já possui um tema que inclua o script de redirecionamento IFA (atualizado por meio da API ou criado pela sua equipe de desenvolvedores), é possível atribuí-lo aos seus aplicativos diretamente na interface do usuário.
    1. Acesse Experiência do usuário > Marca.
    2. Clique em “Criar tema personalizado ”.
    3. Clique em “Baixar arquivos de modelo principal ” e, em seguida, extraia o .zip arquivo localmente.
      Esses arquivos incluem os modelos de login que você irá personalizar.
    4. Adicione o ` JavaScript ` que inicia o seu fluxo IFA.
      No modelo de login apropriado, adicione
      <script>  window.location.href = "https://<tenant>/v1.0/flows/<flowID>/start"; </script>  
      .
    5. Compacte novamente os arquivos de modelo personalizados.
      Observação: mantenha a estrutura de pastas intacta e compacte o diretório raiz.
    6. De volta à janela, clique em “Carregar arquivo ” e selecione o seu .zip arquivo.
    7. Digite um nome para o tema e clique em “Criar tema ”.
    Use a API de personalização da marca
    1. Solicite o pacote do tema:
      GET https://<tenant>/v1.0/branding/themes/<themeID>
      . Inclua um token de acesso válido. O tema é baixado como um .zip arquivo que contém todos os modelos do tema.
    2. Extraia o .zip arquivo localmente para visualizar e editar os modelos.
  2. Dentro da pasta extraída, localize o modelo da página de login.
    Os caminhos variam de acordo com o tema, mas o modelo de login geralmente fica em:
    /templates/authentication/login/cloud_directory/default/login.html
    /templates/authentication/login/saml/default/login.html
    /templates/authentication/login/oidc/default/login.html
    
     

    Modifique o modelo de login para redirecionar os usuários para o seu fluxo IFA publicado (usando o gatilho URL, conforme descrito em “Configurando a autenticação Identifier-First ”).

  3. No arquivo login.html , adicione um link <script> que redirecione os usuários para o seu fluxo IFA publicado URL.
    Por Exemplo:
    <script>
      window.location.href = "https://<tenant>/v1.0/flows/<flowID>/start";
    </script>
    
     
  4. Compacte novamente a pasta do tema, mantendo a estrutura original.
  5. Carregue o tema atualizado usando a API de branding:
    curl -X PUT 'https://<tenant>/v1.0/branding/themes/<themeID>' \
      --header 'Content-Type: multipart/form-data' \
      -F 'configuration=@themeConfiguration.json' \
      -F 'files=@updatedTheme.zip' \
      -H 'Authorization: Bearer <access_token>'
     
  6. Quando o tema for carregado:
    1. Acesse Aplicativos > Aplicativos no locatário de administração.
    2. Abra o aplicativo que deve utilizar o fluxo IFA.
    3. Vá até o campo “Tema” nas configurações do aplicativo.
    4. Selecione o tema atualizado.
  7. Verifique se o seu tema redireciona para o seu fluxo IFA.
    Caso contrário, verifique novamente a localização do script e certifique-se de que o gatilho de fluxo correto URL foi adicionado.

Resultados

Você concluiu a atribuição do fluxo de autenticação Identifier-First (IFA) aos temas.

O quê fazer em seguida

Configure o fluxo de trabalho de convites. Consulte a seção “Configurando um fluxo de trabalho de convites ”.