In code vastgelegde koppelingen omleiden voor apps die zijn gepubliceerd met microsoft Entra-toepassingsproxy

Microsoft Entra-toepassingsproxy maakt uw on-premises apps beschikbaar voor gebruikers die op afstand of op hun eigen apparaten zijn. Sommige apps zijn echter ontwikkeld met lokale koppelingen die zijn ingesloten in de HTML. Deze koppelingen werken niet goed wanneer de app extern wordt gebruikt. Wanneer u meerdere on-premises toepassingen naar elkaar verwijst, verwachten uw gebruikers dat de koppelingen blijven werken wanneer ze niet op kantoor zijn.

De beste manier om ervoor te zorgen dat koppelingen zowel binnen als buiten uw bedrijfsnetwerk hetzelfde werken, is door de externe URL's van uw apps zo te configureren dat ze hetzelfde zijn als hun interne URL's. Gebruik aangepaste domeinen om uw externe URL's te configureren voor uw bedrijfsdomeinnaam in plaats van het standaarddomein van de toepassingsproxy.

Als u geen aangepaste domeinen in uw tenant kunt gebruiken, zijn er verschillende andere opties om deze functionaliteit te bieden. Alle andere opties zijn ook compatibel met aangepaste domeinen en elkaar, zodat u aangepaste domeinen en andere oplossingen kunt configureren.

Notitie

Koppelingsvertaling wordt niet ondersteund voor in code vastgelegde interne URL's die worden gegenereerd via JavaScript.

Optie 1: Gebruik Microsoft Edge : deze oplossing is alleen van toepassing als u van plan bent de toepassing aan te bevelen of te vereisen via de Microsoft Edge-browser. Hiermee worden alle gepubliceerde URL's verwerkt.

Optie 2: Gebruik de MyApps-extensie : voor deze oplossing moeten gebruikers een browserextensie aan de clientzijde installeren, maar deze verwerkt alle gepubliceerde URL's en werkt met de populairste browsers.

Optie 3: Gebruik de instelling voor koppelingsomzetting: de optie is een instelling aan de beheerderszijde die onzichtbaar is voor gebruikers. De URL verwerkt echter alleen URL's in HTML en CSS.

Met deze drie functies blijven uw koppelingen werken, ongeacht waar uw gebruikers zich bevinden. Wanneer u apps hebt die rechtstreeks naar interne eindpunten of poorten verwijzen, kunt u deze interne URL's toewijzen aan de gepubliceerde proxy-URL's van de externe toepassing.

Notitie

De laatste optie is alleen voor tenants die om welke reden dan ook geen aangepaste domeinen kunnen gebruiken om dezelfde interne en externe URL's voor hun apps te hebben. Voordat u deze functie inschakelt, controleert u of aangepaste domeinen in de Microsoft Entra-toepassingsproxy voor u kunnen werken.

Als de toepassing die u moet configureren met koppelingsomzetting SharePoint is, raadpleegt u Alternatieve toegangstoewijzingen configureren voor SharePoint 2013 voor een andere benadering voor het toewijzen van koppelingen.

Optie 1: Microsoft Edge-integratie

U kunt Microsoft Edge gebruiken om uw toepassing en inhoud verder te beveiligen. Als u deze oplossing wilt gebruiken, moet u vereisen of aanbevelen dat gebruikers toegang hebben tot de toepassing via Microsoft Edge. Microsoft Edge herkent alle interne URL's die zijn gepubliceerd met de toepassingsproxy en leidt deze om naar de bijbehorende externe URL. De omleiding zorgt ervoor dat in code vastgelegde interne URL's werken. Als een gebruiker naar de browser gaat en de interne URL rechtstreeks typt, werkt deze zelfs als de gebruiker extern is.

Zie voor meer informatie, waaronder het configureren van deze optie, de webtoegang beheren met behulp van Microsoft Edge voor iOS en Android met Microsoft Intune-documentatie .

Optie 2: Browserextensie MyApps

Met de myApps-browserextensie herkennen alle interne URL's die zijn gepubliceerd met de toepassingsproxy de extensie en worden ze omgeleid naar de bijbehorende externe URL. De omleiding zorgt ervoor dat alle in code vastgelegde interne URL's werken. Als een gebruiker naar de adresbalk van de browser gaat en de interne URL rechtstreeks typt, werkt deze zelfs als de gebruiker extern is.

Als u deze functie wilt gebruiken, moet de gebruiker de extensie downloaden en zijn aangemeld. Er is geen andere configuratie nodig voor beheerders of de gebruikers.

Zie de documentatie voor de browserextensie MyApps voor meer informatie, waaronder het configureren van deze optie.

Notitie

De browserextensie MyApps biedt geen ondersteuning voor koppelingsvertaling voor URL's met jokertekens.

De toepassingsproxyservice zoekt via HTML en CSS naar gepubliceerde interne koppelingen en vertaalt deze wanneer koppelingsomzetting is ingeschakeld. Koppelingsvertaling biedt een ononderbroken ervaring. Het gebruik van de browserextensie MyApps heeft de voorkeur voor de instelling koppelingsomzetting, omdat deze een meer presterende ervaring biedt.

Notitie

Als u optie 2 of 3 gebruikt, moet slechts één van deze tegelijk zijn ingeschakeld.

Nadat de proxyserver de toepassingsgegevens doorgeeft aan de gebruiker, scant toepassingsproxy de toepassing op in code vastgelegde koppelingen en vervangt deze door hun respectieve, gepubliceerde externe URL's.

Toepassingsproxy gaat ervan uit dat toepassingen zijn gecodeerd in UTF-8. Als dat niet het geval is, geeft u het coderingstype op in een HTTP-antwoordheader, zoals Content-Type:text/html;charset=utf-8.

De koppelingsvertalingsfunctie zoekt alleen naar koppelingen in codetags in de hoofdtekst van een app. De toepassingsproxy heeft een afzonderlijke functie voor het vertalen van cookies of URL's in headers.

Er zijn twee veelvoorkomende typen interne koppelingen in on-premises toepassingen:

  • Relatieve interne koppelingen die verwijzen naar een gedeelde resource in een lokale bestandsstructuur, zoals /claims/claims.html. Deze koppelingen werken automatisch in apps die worden gepubliceerd via de toepassingsproxy en blijven werken met of zonder koppelingsomzetting.
  • In code vastgelegde interne koppelingen naar andere on-premises apps, zoals http://expenses of gepubliceerde bestanden, zoals http://expenses/logo.jpg. De koppelingsvertalingsfunctie werkt op in code vastgelegde interne koppelingen en wijzigt deze zodat deze verwijzen naar de externe URL's die externe gebruikers moeten doorlopen.

De volledige lijst met kenmerken in HTML-codetags die toepassingsproxy ondersteunt koppelingsvertalingen, zijn onder andere:

  • 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)

Daarnaast wordt binnen CSS het URL-kenmerk ook vertaald.

Koppelingsomzetting is ingeschakeld voor elke toepassing, zodat u controle hebt over de gebruikerservaring op app-niveau. Schakel koppelingsvertaling in voor een app wanneer u wilt dat de koppelingen van die app worden vertaald, niet koppelingen naar die app.

Stel dat u drie toepassingen hebt gepubliceerd via de toepassingsproxy die allemaal aan elkaar zijn gekoppeld: Voordelen, Uitgaven en Reizen. Er is een vierde app, feedback die niet wordt gepubliceerd via de toepassingsproxy.

Wanneer u koppelingsvertaling inschakelt voor de App Benefits, worden de koppelingen naar Onkosten en Reizen omgeleid naar de externe URL's voor die apps. De koppeling naar Feedback wordt echter niet omgeleid omdat er geen externe URL is. Koppelingen van Onkosten en Reizen terug naar Voordelen werken niet, omdat koppelingsvertaling niet is ingeschakeld voor deze twee apps.

Links from Benefits to other apps when link translation is enabled

Sommige koppelingen worden niet vertaald om de prestaties en beveiliging te verbeteren:

  • Koppelingen niet binnen codetags.
  • Koppelingen niet in HTML of CSS.
  • Koppelingen in indeling met URL-codering.
  • Interne koppelingen die vanuit andere programma's zijn geopend. Koppelingen die worden verzonden via e-mail of chatbericht, of opgenomen in andere documenten, worden niet vertaald. De gebruikers moeten weten om naar de externe URL te gaan.

Als u een van deze twee scenario's wilt ondersteunen, gebruikt u dezelfde interne en externe URL's in plaats van koppelingsomzetting.

Aan de slag met koppelingsvertaling is net zo eenvoudig als klikken op een knop:

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een toepassings-Beheer istrator.

  2. Blader naar Bedrijfstoepassingen voor identiteitstoepassingen>>>Alle toepassingen.

  3. Selecteer de app die u wilt beheren.

  4. Zet de vertaal-URL's in de hoofdtekst van de toepassing op Ja.

    Select Yes to translate URLs in application body

  5. Selecteer Opslaan om uw wijzigingen toe te passen.

Wanneer uw gebruikers toegang hebben tot deze toepassing, scant de proxy nu op interne URL's die worden gepubliceerd via de toepassingsproxy in uw tenant.

Volgende stappen