uziconnect Installatiehandleiding

Transcriptie

1 uziconnect Installatiehandleiding VANAD Enovation is een handelsnaam van ENOVATION B.V. Alle rechten voorbehouden. Niets uit deze uitgave mag worden openbaar gemaakt of verveelvoudigd, opgeslagen in een data verwerkend systeem of uitgezonden in enige vorm door middel van druk, fotokopie of welke andere wijzen dan ook zonder voorafgaande schriftelijke toestemming van de directie van ENOVATION B.V.

2 Inhoudsopgave 1 Inleiding Doelgroep Revisies Installatie Systeemeisen Installatie UZI-pas en kaartlezer Proxy-instellingen Installatie uziconnect Uitschakelen browser plug-in Downloaden uziconnect Lokale installatie uziconnect (standaard versie) Installatie uziconnect (admin versie) Gebruik Gebruik standaard uziconnect Raadplegen applicatielog Gebruik admin-versie uziconnect Raadplegen applicatielog Documentnaam uziconnect Pagina 2 van 13

3 1 Inleiding Deze handleiding beschrijft de installatie en ingebruikname van uziconnect. VANAD Enovation introduceert uziconnect, een oplossing waarmee zonder gebruik van een plug-in op een veilige manier vanuit een webapplicatie met de UZI-pas kan worden gewerkt. Deze handleiding beschrijft hoe u uziconnect kunt downloaden, installeren en gebruiken. 1.1 Doelgroep Dit document is geschreven voor de lokale ICT-beheerder. 1.2 Revisies Versie Datum Auteur Commentaar VANAD Enovation Initiële versie VANAD Enovation Instructie proxy-server toegevoegd. Instructie en toelichting toegevoegd inzake vervangen SESSIONNAME door USERDOMAIN en USERNAME. Diverse tekstuele verbeteringen. Documentnaam uziconnect Pagina 3 van 13

4 2 Installatie In dit hoofdstuk is de installatie beschreven. Er zijn verschillende versies van uziconnect: een reguliere versie voor lokale installatie en een adminversie voor installatie op een terminal server. Van beide versies zijn 32- en 64-bits varianten beschikbaar. Dit document beschrijft alleen de installatie op Windows-systemen. 2.1 Systeemeisen uziconnect is geschikt voor de volgende besturingssystemen: Windows 7 / 8 / 10 Windows Server 2008R2 / 2012 / 2012R2 Mac OS X 1 uziconnect kan worden gebruikt in combinatie met de volgende browsers: Internet Explorer 11 2 Firefox Chrome Edge Safari De lijst met ondersteunde platforms en browsers is continu aan wijziging onderhevig en ook afhankelijk van de ondersteuning door desbetreffende platform- of browserleverancier. Voor de UZIpas software kunnen aanvullende systeemeisen gelden, zie Installatie UZI-pas en kaartlezer Voordat u gebruik kunt maken van uziconnect, dient u een kaartlezer en de bijbehorende software te installeren. U kunt deze stap overslaan, indien u al een kaartlezer en UZI-pas in gebruik heeft. Op de website van het UZI-register ( vindt u alle benodigde informatie, waarmee u kunt bepalen welke software u nodig heeft en hoe u deze kunt verkrijgen (zie menu-item Installeren software ). Ook zijn hier diverse handleidingen te downloaden. 2.3 Proxy-instellingen Indien er gebruik wordt gemaakt van een proxy server, dan dient u voor het domein *.uzilocal.nl een uitzondering toe te voegen. Dit kan worden ingesteld via de internet opties van uw systeem of via Internet Explorer (Menu Extra Internetopties Verbindingen LAN-instellingen). 1 alleen de standaard uziconnect, niet de admin-versie voor terminal server configuraties. 2 Voor Internet Explorer 9 en 10 is een browser plug-in beschikbaar als alternatief voor uziconnect. Documentnaam uziconnect Pagina 4 van 13

5 2.4 Installatie uziconnect De wijze van installeren en ingebruikname kan verschillen, afhankelijk van uw omgeving en gebruikte applicatie(s). De verschillende situaties zijn hier beschreven. Indien u nu al werkt met de UZI-pas in de browser, dient eerst de hiervoor gebruikte plug-in te worden uitgeschakeld Uitschakelen browser plug-in Voor de webapplicaties lspconnect User Console en lspconnect Viewer geldt dat zij gebruik maken van een browser plug-in voor de UZI-pas-integratie. Deze applicaties kunnen werken met zowel de plug-in als met uziconnect. Voor u uziconnect kunt gebruiken, dient u de eventueel aanwezige browser plug-in uit te schakelen (niet verwijderen). Dit is uiteraard alleen van toepassing op browsers, die nog plug-ins ondersteunen. Uitschakelen browser plug-in in Internet Explorer (Nederlands): Selecteer Extra Invoegtoepassingen beheren Kies bij Filteren op Alle invoegtoepassingen Selecteer de LSPConnect Token Authentication plugin van ENOVATION B.V. Selecteer Uitschakelen om de plug-in te deactiveren. Documentnaam uziconnect Pagina 5 van 13

6 Documentnaam uziconnect Pagina 6 van 13

7 Uitschakelen browser plug-in in Internet Explorer (Engels): Selecteer Tools -> Manage Add-ons Kies bij Show All add-ons Selecteer de LSPConnect Token Authentication plugin van ENOVATION B.V. Selecteer Disable om de plug-in te deactiveren. Documentnaam uziconnect Pagina 7 van 13

8 Uitschakelen browser plug-in in Firefox: Type in de adresbalk: about:addons Selecteer in de linker menubalk Plug-ins Selecteer de LSPConnect Plugin. Kies rechts de optie Nooit activeren. Documentnaam uziconnect Pagina 8 van 13

9 2.4.2 Downloaden uziconnect Na het uitschakelen van de browser plug-in kunt u naar de webapplicatie (bijvoorbeeld de User Console) gaan en zal deze een melding geven (zie hieronder). Klik op download UZI Connect nu om naar de download-pagina te gaan. U kunt ook rechtstreeks naar deze pagina gaan via Documentnaam uziconnect Pagina 9 van 13

10 Voor installatie op een fat client (desktop/laptop) kan het beste de standaard versie van uziconnect worden gebruikt. De admin-variant is voor installatie op een terminal server Lokale installatie uziconnect (standaard versie) De standaard versie van uziconnect kan door iedere gebruiker worden geïnstalleerd door het installatieprogramma uit te voeren. Hierbij kan er voor worden gekozen om uziconnect automatisch te laten starten. De software wordt geïnstalleerd in de lokale omgeving van de ingelogde gebruiker (..\AppData\Local\Programs\UZI Connect\). Na het starten van uziconnect kan er met de UZI-pas worden ingelogd in de webapplicatie (bijv. de User Console) Installatie uziconnect (admin versie) De admin-versie moet door een gebruiker met administrator-rechten worden geïnstalleerd door het desbetreffende installatieprogramma uit te voeren. De software wordt geïnstalleerd onder Program Files. Tevens wordt er een admin-service gestart, die nodig is om bij te houden welke sessies er actief zijn en op welke poort deze worden afgehandeld. Hiervoor is het nodig om de webapplicatie met extra parameters te starten: url de variabele ${url} in bovenstaande tekst vervangen door de URL waarnaar de browser moet gaan, nadat deze de verbinding met de client heeft opgezet. Let op: voorheen werd de systeemvariabele SESSIONNAME gebruikt om de gebruikerssessie te identificeren, dit is vervangen door de combinatie USERDOMAIN en USERNAME. Deze wijziging is van toepassing op uziconnect versie en hoger. Hiervoor kan een snelkoppeling worden gemaakt naar de browser applicatie (geen url-koppeling). Na het aanmaken van de snelkoppeling kan via eigenschappen (rechtermuisknop klikken op snelkoppeling, selecteer eigenschappen) de aanvullende parameters worden toegevoegd. Documentnaam uziconnect Pagina 10 van 13

11 Hieronder een voorbeeld van een snelkoppeling naar Internet Explorer 11, waarbij de User Console op de testomgeving wordt opgestart. In dit voorbeeld (User Console op de acceptatieomgeving): Doel: nnecttest.enovation.net/user-console/?appid= Beginnen in: "C:\ProgramFiles\InternetExplorer\iexplore.exe" De omgevingsvariabelen USERDOMAIN en USERNAME worden automatisch ingevuld bij het aanroepen van de snelkoppeling. Ander voorbeeld (medicatieviewer op de acceptatieomgeving): Doel: nnecttest.enovation.net/medicationviewer-ui/ Documentnaam uziconnect Pagina 11 van 13

12 3 Gebruik In dit hoofdstuk wordt het gebruik en operationeel beheer van uziconnect toegelicht. De werking van de standaard versie en de admin-versie van uziconnect wijkt iets af, daarom worden beide apart worden behandeld. 3.1 Gebruik standaard uziconnect Tijdens de installatie kan worden opgegeven of uziconnect automatisch wordt opgestart. Indien dit niet is gedaan, kan uziconnect handmatig worden opgestart met behulp van de snelkoppeling op de desktop. Na het opstarten verschijnt er het uziconnect logo in de taakbalk en zal er een statuspagina in de browser worden geopend: Deze pagina kan worden gebruikt om de status van de kaartlezer en de applicatie te controleren, om eventueel naar een eerder gebruikte applicatie te navigeren of om uziconnect af te sluiten. Voor het gebruik van uziconnect is het niet noodzakelijk dat deze pagina open blijft staan, dus deze kan desgewenst worden gesloten. Navigeer naar de webapplicatie waarop u wilt inloggen met de UZI-pas. Steek de UZI-pas in de kaartlezer en log in op de applicatie. Hieronder een voorbeeld van de User Console. Documentnaam uziconnect Pagina 12 van 13

13 Bij de eerste keer inloggen met uziconnect zal het PIN-invoerveld niet automatisch worden getoond. Het logo in de taakbalk knippert en u dient deze eenmalig te selecteren om het pop-up scherm te openen. Dit is standaard gedrag van Windows, waarvoor we helaas nog geen oplossing of workaround hebben. Zodra het pop-up scherm verschijnt, kunt u de PIN-code invoeren en inloggen Raadplegen applicatielog De gebruiker of lokale beheerder kan bij problemen de applicatielog van uziconnect raadplegen. De locatie van de log is: c:\users\<gebruiker>\.uziconnect\uzi-connect.log Bij het aanmelden van problemen met uziconnect verzoeken we u deze log mee te sturen. 3.2 Gebruik admin-versie uziconnect Indien u gebruik maakt van een terminal server (waarop uziconnect is geïnstalleerd), kunt u hierop inloggen (middels een RDP-sessie, niet op de lokale console van de terminal server) en uziconnect starten met behulp van de snelkoppeling op de desktop. Na het opstarten verschijnt er een uziconnect logo in de taakbalk. U kunt vervolgens uw browser starten met de eerder aangemaakte snelkoppeling (zie H2.4.4). Het inloggen met de UZI-pas werkt verder zoals beschreven in het gebruik van de standaard versie Raadplegen applicatielog De gebruiker of lokale beheerder kan bij problemen de applicatielogs van uziconnect raadplegen. De locatie van de logs is: c:\users\<gebruiker>\.uziconnect\uzi-connect.log c:\program Files\UZI-Connect\app\uziconnect-admin.out.log Bij het aanmelden van problemen met uziconnect verzoeken we u deze logs mee te sturen. Documentnaam uziconnect Pagina 13 van 13