Redirecionar os links embutidos em código para aplicativos publicados com o Proxy de Aplicativo do Azure Active Directory

  • Artigo
  • 7 minutos para o fim da leitura

O Proxy de Aplicativo do Azure AD disponibiliza seus aplicativos locais para usuários remotos ou que estão em seus próprios dispositivos. No entanto, alguns aplicativos foram desenvolvidos com links locais inseridos no HTML. Esses links não funcionam corretamente quando o aplicativo é usado remotamente. Quando você faz com que vários aplicativos locais apontem uns para os outros, os usuários esperam os links para continuar trabalhando quando não estiverem no escritório.

A melhor maneira de garantir que os links funcionem corretamente dentro e fora de sua rede corporativa é configurar as URLs externas de seus aplicativos para que sejam as mesmas que as URLs internas. Use domínios personalizados para configurar suas URLs externas para que tenham o nome de domínio corporativo em vez do domínio padrão do proxy de aplicativo.

Se você não pode usar domínios personalizados em seu locatário, há várias outras opções para fornecer essa funcionalidade. Todos esses também são compatíveis com domínios personalizados e entre si, assim você pode configurar domínios personalizados e outras soluções, se necessário.

Observação

A conversão de links não tem suporte para URLs internas embutidas em código geradas por meio de JavaScript.

Opção 1: usar o Microsoft Edge – essa solução só será aplicável se você planejar recomendar ou exigir que os usuários acessem o aplicativo com o navegador Microsoft Edge. Ele manipulará todas as URLs publicadas.

Opção 2: usar a extensão do MyApps – essa solução exige que os usuários instalem uma extensão de navegador do lado do cliente, mas manipulará todas as URLs publicadas e funciona com navegadores mais populares.

Opção 3: usar a configuração de conversão de link – esta é uma configuração do lado do administrador que é invisível para os usuários. Porém, ela apenas manipulará URLs em HTML e CSS.

Esses três recursos mantêm seus vínculos de trabalho, independentemente de onde os usuários estão. Quando você tem aplicativos que apontam diretamente para portas ou pontos de extremidade internos, pode mapear essas URLs internas para as URLs de Proxy de Aplicativo externas publicadas.

Observação

A última opção é apenas para locatários que, por qualquer motivo, não podem usar domínios personalizados para ter as mesmas URLs internas e externas para seus aplicativos. Antes de habilitar esse recurso, verifique se domínios personalizados no Proxy de Aplicativo do Azure AD podem funcionar para você.

Ou, se o aplicativo que você precisa configurar com a conversão de link é o SharePoint, consulte Configurar mapeamentos alternativos de acesso para o SharePoint 2013 a fim de conhecer outra abordagem de mapeamento de links.

Opção 1: integração do Microsoft Edge

Você pode usar o Microsoft Edge para proteger ainda mais seu aplicativo e conteúdo. Para usar essa solução, você precisa exigir/recomendar que os usuários acessem o aplicativo pelo navegador Microsoft Edge. Todas as URLs internas publicadas com o Proxy de Aplicativo serão reconhecidas pelo Edge e redirecionadas à URL externa correspondente. Isso garante que todas as URLs internas inseridas no código funcionem, e se um usuário for ao navegador e digitar diretamente a URL interna, ela funcione mesmo se o usuário estiver remoto.

Para saber mais, incluindo como configurar essa opção, confira a documentação Gerenciar o acesso via Web usando o Edge para iOS e Android com o Microsoft Intune.

Opção 2: extensão de navegador MyApps

Com a extensão de navegador My Apps, todas as URLs internas publicadas com o Proxy de Aplicativo são reconhecidas pelo Managed Browser e redirecionadas para a URL externa correspondente. Isso garante que todas as URLs internas inseridas no código funcionem, e se um usuário for à barra de endereço do navegador e digitar diretamente a URL interna, ela funcione mesmo se o usuário estiver remoto.

Para usar esse recurso, o usuário deve fazer o download da extensão e estar conectado. Não há nenhuma outra configuração necessária para os administradores ou usuários.

Para saber mais, incluindo como configurar essa opção, confira a documentação da Extensão de Navegador MyApps.

Observação

A Extensão de Navegador MyApps não dá suporte à conversão de link para URLs curinga.

Quando a translação de link está habilitada, o serviço de Proxy de Aplicativo pesquisa o HTML e o CSS para links internos publicados e converte-os para que seus usuários obtenham uma experiência ininterrupta. É preferível usar a Extensão de Navegador MyApps para a Configuração de Conversão de Link, pois oferece uma experiência mais eficaz aos usuários.

Observação

Se você estiver usando a opção 2 ou 3, só uma delas deverá ser habilitada por vez.

Depois da autenticação, quando o servidor proxy transmite os dados de aplicativo para o usuário, o Proxy de Aplicativo examina o aplicativo em relação a links embutidos em código e os substitui pelas respectivas URLs externas publicadas.

O Proxy de Aplicativo pressupõe que os aplicativos estejam codificados em UTF-8. Se esse não for o caso, especifique o tipo de codificação em um cabeçalho de resposta HTTP, como Content-Type:text/html;charset=utf-8.

O recurso de translação de link procura apenas por links que estão nas marcas de código no corpo do aplicativo. O Proxy de Aplicativo tem um recurso separado para converter cookies ou URLs em cabeçalhos.

Há dois tipos comuns de links internos em aplicativos locais:

  • Links internos relativos que apontam para um recurso compartilhado em uma estrutura de arquivo local como /claims/claims.html. Esses links funcionam automaticamente em aplicativos que são publicados por meio do Proxy de Aplicativo e continuam funcionando com ou sem a conversão de link.
  • Links internos embutidos em código para outros aplicativos locais como http://expenses ou arquivos publicados como http://expenses/logo.jpg. O recurso de conversão de link funciona em links internos embutidos em código e os altera para apontar para as URLs externas de que os usuários remotos precisam para avançar.

A lista completa de atributos em marcas de código HTML dos quais o Proxy de Aplicativo dá suporte à conversão de links inclui:

  • a (href)
  • audio (src)
  • base (href)
  • button (formaction)
  • div (data-background, style, data-src)
  • embed (src)
  • form (action)
  • frame (src)
  • head (profile)
  • html (manifest)
  • iframe (longdesc, src)
  • img (longdesc, src)
  • input (formaction, src, value)
  • link (href)
  • menuitem (icon)
  • meta (content)
  • object (archive, data, codebase)
  • script (src)
  • source (src)
  • track (src)
  • video (src, poster)

Além disso, em CSS, o atributo URL também é convertido.

A translação de link está habilitada para cada aplicativo, para que você tenha controle sobre a experiência do usuário no nível por aplicativo. Ative a translação de link para um aplicativo quando desejar que os links desse aplicativo sejam convertidos, não os links para ele.

Por exemplo, suponha que você tenha três aplicativos publicados por meio do Proxy de Aplicativo que estão vinculados entre si: Benefícios, Despesas e Viagem. Há um quarto aplicativo, Comentários, que não está publicado pelo Proxy de Aplicativo.

Quando você habilita a translação de link para o aplicativo Benefícios, os links para Despesas e Viagem são redirecionados para as URLs externas para esses aplicativos, mas o link para Comentários não é redirecionado porque não há nenhuma URL externa. Os links de Despesas e Viagem para Benefícios não funcionam, pois a translação de link não foi habilitada para esses dois aplicativos.

Links from Benefits to other apps when link translation is enabled

Para melhorar o desempenho e a segurança, alguns links não são convertidos:

  • Links que não estão dentro de marcas de código.
  • Links que não estão em HTML ou CSS.
  • Links em formato codificado de URL.
  • Links internos abertos de outros programas. Links enviados por email, mensagem instantânea ou incluídos em outros documentos não serão convertidos. Os usuários precisam saber ir para a URL externa.

Se você precisar dar suporte a um desses dois cenários, use as mesmas URLs internas e externas em vez da conversão de link.

Começar a trabalhar com a translação de link é tão fácil quanto clicar em um botão:

  1. Entre no Portal do Azure como administrador.

  2. Vá para Azure Active Directory>Aplicativos empresariais>Todos os aplicativos> selecione o aplicativo que deseja gerenciar >Proxy de aplicativo.

  3. Mude Converter URLs no corpo do aplicativo para Sim.

    Select Yes to translate URLs in application body

  4. Selecione Salvar para salvar suas alterações.

Agora, quando os usuários acessarem esse aplicativo, o proxy examinará automaticamente para verificar a existência de URLs internas que foram publicadas por meio do Proxy de Aplicativo no locatário.

Próximas etapas

Usar domínios personalizados com o Proxy de Aplicativo do Azure AD para ter a mesma URL interna e externa

Configurar mapeamentos alternativos de acesso para o SharePoint 2013