PROBLEEMOPLOSSER KSZ-VERBINDING

PROBLEEMOPLOSSER KSZ-VERBINDING

1 INHOUDSOPGAVE 1 INHOUDSOPGAVE... 1 2 INLEIDING... 3 2.1 Colofon... 4 3 DE PROBLEMEN KOMEN BIJ ÉÉN OF ENKELE GEBRUIKERS VOOR, NIET BIJ ALLE GEBRUIKERS... 5 3.1 Heeft de gebruiker toelating om KSZ te raadplegen?... 5 3.1.1 Machtigingen bekijken... 5 3.1.2 Machtigingen aanpassen... 5 3.1.3 Kan Cevi/Logins machtigingen aanpassen?... 5 Probleemomschrijving... 5 Antwoord... 5 3.2 Is de meest recente CeviKszDLL geïnstalleerd... 6 3.2.1 Welke versie van de DLL is geïnstalleerd?... 7 3.2.2 DLL versie staat op 0. Ik kan niet zien welke versie er geïnstalleerd staat... 7 Oorzaak:... 8 Oplossing:... 8 3.2.3 Laatste versie van de DLL downloaden... 8 3.2.4 DLL installeren... 8 3.2.5 DLL registreren in de toepassing... 8 3.3 Beveiligingsinstellingen Internet Explorer... 8 3.3.1 Oorzaak opsporen... 9 3.3.2 Oplossing... 9 3.4 Crash Handler fouten... 10 3.4.1 Crash Handler komt voor bij versturen van formulieren Wet65... 11 Omschrijving... 11 Probleem... 11 Oplossing... 11 3.5 Onmiddellijk reageert niet bij KSZ dossieropbouw en KSZ onderzoek... 11 3.5.1 Waar komt het voor... 11 Bij dossieropbouw... 11 Bij KSZ Onderzoek... 11 3.5.2 Foutmelding van Windows... 12 3.5.3 Oplossing: Windows Compatibiliteitsmodus aanzetten... 12 3.5.4 Nadeel:... 13 4 HET PROBLEEM KOMT VOOR BIJ ALLE GEBRUIKERS... 14 4.1 Verbinding KSZ werkt niet: de CeviKszdll blijft in rood (of zwart) staan... 14 4.1.1 Opmerking voor besturen die werken met Citrix of Remote Desktop servers... 14 4.1.2 Probleemomschrijving... 14 4.1.3 Kan er buiten NH verbinding gemaakt worden naar KSZ... 14 Probeer de service van KSZ te bereiken... 14 Data execution prevention... 15

2 INLEIDING Dit document helpt je op weg om problemen met de KSZ-verbinding op te sporen en op te lossen. Je kunt dit document gebruiken wanneer je vastgesteld hebt of vermoedt dat er een probleem is met de KSZ-verbinding. In deze handleiding kunnen hoofdstukken voorkomen die niet door gewone gebruikers gebruikt kunnen worden maar eerder geschikt voor de ICT-dienst. We raden aan om de verschillende hoofdstukken in volgorde te overlopen om zo het probleem te ontdekken. De hoofdstukken bouwen voort op wat er in de vorige hoofdstukken is behandeld om het probleem op een effectieve en efficiënte manier op te sporen. Elk hoofdstuk begint met een icoontje om aan te geven wie het probleem best kan bekijken. ICT-beheerder van het OCMW of de gemeente Systeemverantwoordelijke New Horizon Veiligheidsconsulent Gebruikers van de toepassing Hoofdstuk 2: Inleiding Probleemoplosser KSZ-verbinding Versie 2015-08-21

4 2.1 COLOFON Cevi/Logins NV 2015-10-21 Cevi NV - Bisdomplein 3-9000 GENT Tel. Cevi Contact Center: 09 264 07 01 - fax: 09 264 07 02 E-mail: contactcenter@cevi.be Internet: http://www.cevi.be/ - extranet: http://ce-site.cevi.be/ Ondernemersnummer: BE 0860.972.295 Logins NV - Generaal De Wittelaan 17 B32-2800 Mechelen Tel.: 015 45 48 50 - fax: 015 45 48 89 E-mail: helpdesk@logins.be Internet: http://www.logins.be Ondernemersnummer: BE 0458.715.671 Programma: NH Sociale Dienst Ondersteuning: Team Welzijn Cevi/Logins Hoofdstuk 2: Inleiding Probleemoplosser KSZ-verbinding Versie 2015-10-19

5 3 DE PROBLEMEN KOMEN BIJ ÉÉN OF ENKELE GEBRUIKERS VOOR, NIET BIJ ALLE GEBRUIKERS 3.1 HEEFT DE GEBRUIKER TOELATING OM KSZ TE RAADPLEGEN? De gebruiker kan enkel gegevens bij KSZ opvragen als hij of zij voldoende toelatingen gekregen heeft van de veiligheidsconsulent. Deze toelatingen worden machtigingen genoemd. 3.1.1 Machtigingen bekijken Elke gebruiker kan zelf nagaan welke machtigingen hij of zij heeft voor KSZ. In de Sociale Dienst kun je naar menupunt 8.1.1.5 Mijn profiel gaan en in het scherm op de link Bekijk uw machtigingen klikken. Als je geen machtigingen of niet voldoende machtigingen hebt voor de functie die je binnen het bestuur uitoefent, neem dan contact op met de veiligheidsconsulent of applicatieverantwoordelijke KSZ om de machtigingen aan te vragen. 3.1.2 Machtigingen aanpassen Enkel de veiligheidsconsulent of de applicatieverantwoordelijke KSZ kunnen machtigingen aanpassen in de toepassing. In de Sociale Dienst kun je naar menupunt 8.1.16.8 Profielen KSZ gebruikers gaan om de machtigingen voor de verschillende groepen te beheren. 3.1.3 Kan Cevi/Logins machtigingen aanpassen? Probleemomschrijving De veiligheidsconsulent en de applicatiebeheerder KSZ zijn niet aanwezig om machtigingen toe te kennen. Kan dit door Cevi/Logins gebeuren? Antwoord De softwareleveranciers mogen niet beslissen welke gebruikers welke machtigingen mogen hebben om raadplegingen bij KSZ uit te voeren. We raden aan om naast de veiligheidsconsulent ook één of meerdere Applicatieverantwoordelijken KSZ aan te duiden binnen het bestuur om bij afwezigheid van de veiligheidsconsulent ook machtigingen te kunnen toekennen. In uitzonderlijke en dringende gevallen kan Cevi/Logins machtigingen aanpassen op voorwaarde dat we een aanvraag van de secretaris op mail ontvangen. Plaats daarbij de veiligheidsconsulent in CC zodat deze persoon ook op de hoogte is van de aanpassing. Bijvoorbeeld om een nieuwe gebruiker machtigingen te geven kan de secretaris via mail aanvragen de machtigingen toe te kennen. Vermeld dan in de mail de naam van de ge-

6 bruiker (of de gebruikersnaam in NH) en het profiel (de groep van gebruikers) waaraan de gebruiker toegevoegd moet worden. Of wanneer de machtigingen voor een groep moeten aangepast worden, kan de secretaris via mail aanvragen de machtigingen aan te passen. Vermeld dan in de mail de naam van het profiel (de groep van gebruikers) en welke machtigingen aan- of afgezet moeten worden. 3.2 IS DE MEEST RECENTE CEVIKSZDLL GEÏNSTALLEERD Het is mogelijk dat de CeviKszDLL enkel geïnstalleerd kan worden met administratorrechten. Dit hoofdstuk van de handleiding bevat technische informatie en is bedoeld voor de ICT-beheerder van het OCMW of de gemeente. Om verbinding te maken met KSZ, is een dll nodig op de pc van de gebruiker of op de server waarop de gebruikers inloggen om NH te starten (bijvoorbeeld wanneer de toepassing draait op een Citrix-server).

7 3.2.1 Welke versie van de DLL is geïnstalleerd? In het scherm 1.20.1. KSZ Dossieropbouw staat rechts bovenaan een gekleurd vakje met een nummer in. Het nummer is de versie van de DLL die op deze pc of server geïnstalleerd is. De kleur duidt aan of het mogelijk is om verbinding te maken met KSZ. Een groen vakje geeft aan dat de verbinding met KSZ gemaakt kan worden. Een rood vakje duidt op verbindingsproblemen. Wanneer er geen CeviKszDLL geïnstalleerd is op de pc of server zul je een melding krijgen van de toepassing van zodra je een scherm opent dat gebruik maakt van de KSZverbinding. 3.2.2 DLL versie staat op 0. Ik kan niet zien welke versie er geïnstalleerd staat Je kunt geen KSZ-opvragingen uitvoeren. Wanneer je wil nagaan welke versie van de dll er geïnstalleerd staat, zie je de waarde 0 in een grijs vakje.

8 Oorzaak: Dit betekent dat er een dll geïnstalleerd is (anders kon je dit scherm niet openen) maar dat er een probleem is met de identificatiegegevens die meegestuurd worden naar KSZ. Oplossing: Neem contact op met de helpdesk van Cevi/Logins om het programmanummer (KSZ Userid) te laten invullen in het programma. 3.2.3 Laatste versie van de DLL downloaden De laatste versie van de CeviKszDLL vind je terugop de CE-site van Cevi (http://cesite.extranet.cevi.be) onder Downloads Welzijn. Op de website van Logins (http://www.logins.be) kun je inloggen met de gebruikersnaam en het wachtwoord van je bestuur en vind je de dll onder Logins klanten. Als je het wachtwoord van je bestuur niet kent, kun je dit aanvragen op helpdesk@logins.be. 3.2.4 DLL installeren Eens de dll gedownload is, kan deze geïnstalleerd worden op de pc van de gebruiker of op de server. Volg hierbij de stappen van het installatieprogramma. 3.2.5 DLL registreren in de toepassing Deze stap is niet noodzakelijk, maar kun je best uitvoeren om een goede werking van de dll te verzekeren. Nadat de dll geïnstalleerd is, meld je je aan in New Horizon en ga je naar 8.1.16.1. Registergegevens KSZ en klik je op de knop <Registergegevens KSZ>. 3.3 BEVEILIGINGSINSTELLINGEN INTERNET EXPLORER In 1.20.1 KSZ Dossieropbouw staat het blokje van de DLL in het rood bij een of enkele gebruikers maar andere collega s kunnen wel gegevens opvragen bij KSZ.

9 3.3.1 Oorzaak opsporen 3.3.2 Oplossing Ga naar 8.1.16.2. Logfile communicatie KSZ en zoek op datum vanaf wanneer de problemen zich voordoen een van de gebruikers met problemen op. In logfile KSZ staat foutmelding met error opening secure channel of Fout in de beveiligde kanaalondersteuning bij de opvragingen voor de gebruiker(s) vanaf het moment dat de problemen zich voordoen. Surf vanuit de internetbrowser naar https://bcssksz-servicesprod.smals.be/connectors/webservice/kszbcsswebserviceconnectorport. Deze pagina zal niet bereikbaar zijn. * Open Internet Explorer. * Ga naar Extra s Internetopties Geavanceerd. * En klik vervolgens op <Geavanceerde instellingen herstellen>. Concreet zal de herstelactie onder andere de volgende zaken corrigeren: * Vinkjes bij SSL 2.0 en 3.0 uitvinken. * Vinkjes bij TLS 1.0 (en 1.1 en hoger) aanvinken.

10 3.4 CRASH HANDLER FOUTEN Er komt een grote foutmelding wanneer je KSZ probeert te raadplegen in de New Horizon toepassing.

11 3.4.1 Crash Handler komt voor bij versturen van formulieren Wet65 Omschrijving Wanneer je formulieren W65 probeert te versturen komt er een Crash Handler foutmelding. Na de foutmelding word je volledig uit de toepassing gegooid. Het formulier blijkt achteraf niet verstuurd te zijn. Probleem Deze foutmelding komt af en toe voor op de nieuwere versies van Windows. New Horizon doet normaal gezien een controle op de formulieren, maar daar kan het soms foutlopen. De oplossing voor dit probleem is de controle van de formulieren door NH uit te schakelen. Dit heeft voor u geen verdere gevolgen. De formulieren zullen dan nog altijd gecontroleerd worden door de POD. Dit probleem komt voor bij cliënten met een nieuwe pc of nieuwe laptop wanneer de pc een nieuwere versie van Windows gebruikt. Oplossing (Eventueel veiligheidsconsulent of systeemverantwoordelijke) Die moet in menupunt 8.1.16.1 registergegevens KSZ naar het tabblad Basisparameters gaan. Daar zal onderaan het veld XML validatie staan. Dit veld moet op OFF gezet worden. Druk nadien op <Tab> om de wijziging te aanvaarden en dit veld te verlaten. Van zodra dit gebeurd is, zal de foutmelding niet meer voorvallen. Stuur de formulieren gerust opnieuw door. 3.5 ONMIDDELLIJK REAGEERT NIET BIJ KSZ DOSSIEROPBOUW EN KSZ ONDERZOEK De melding wordt veroorzaakt door een foute verwerking in Windows. Zo kan het zijn dat bij twee identieke pc s met dezelfde configuratie de ene last heeft van dit probleem en de andere niet. De oorzaak is een update van Windows die soms de controle van compatibiliteit in de war stuurt. Het programma is wel compatibel maar Windows denkt dat dit niet het geval is. 3.5.1 Waar komt het voor Bij dossieropbouw Windows geeft onmiddellijk de melding reageert niet wanneer je in de New Horizontoepassing een scherm wilt openen waarbij KSZ gebruikt wordt. Bij KSZ Onderzoek Wanneer je het sociaal onderzoek opent, de gewenste berichten aanduidt en vervolgens op <Uitvoeren> klikt, wordt het scherm wit en loopt de toepassing valst.

12 3.5.2 Foutmelding van Windows nhclient werkt niet meer U kunt online naar een oplossing zoeken en dit programma sluiten. 3.5.3 Oplossing: Windows Compatibiliteitsmodus aanzetten 1) Klik rechts op het icoontje van het programma en klik op Eigenschappen ( Properties ). 2) Ga naar het tabblad Compatibiliteit ( Compatibility ). 3) Onder Compatibiliteitsmodus ( Compatibility mode ) vinkje aanzetten bij Dit programma uitvoeren in compatibiliteitsmodus voor: en kies Windows XP (Service Pack 3). 4) Klik op <Toepassen> en daarna op <OK>.

13 3.5.4 Nadeel: Wanneer je NH opstart, krijg je een melding dat het programma in compatibiliteitsmodus wordt opgestart. Hierop moet je <Ja> klikken om door te gaan. Deze melding weghalen kan, maar is voor alle programma s die met compatibiliteitsmodus gestart worden: http://www.techrepublic.com/blog/windows-and-office/selectively-disable-uac-for-yourtrusted-vista-applications/

14 4 HET PROBLEEM KOMT VOOR BIJ ALLE GEBRUIKERS 4.1 VERBINDING KSZ WERKT NIET: DE CEVIKSZDLL BLIJFT IN ROOD (OF ZWART) STAAN Met de informatie in dit hoofdstuk kun je nagaan wat de oorzaak van verbindingsproblemen is en hoe je dit kunt oplossen. Dit hoofdstuk van de handleiding bevat technische informatie en is bedoeld voor de ICTbeheerder van het OCMW of de gemeente. 4.1.1 Opmerking voor besturen die werken met Citrix of Remote Desktop servers In het volgende hoofdstuk wordt een onderscheid gemaakt tussen problemen bij één of enkele gebruikers en problemen bij alle gebruikers. Als de New Horizon-toepassing werkt op een Citrix-server of remote desktop loggen de gebruikers in op een server waarop de toepassing geïnstalleerd is. Hierdoor kan een losstaand probleem voor alle gebruikers gevolgen hebben. Controleer daarom zeker ook hoofdstuk 3.2 Is de meest recente CeviKszDLL geïnstalleerd op pagina 6. 4.1.2 Probleemomschrijving De gebruiker heeft de nodige machtigingen om opvragingen te starten bij KSZ en beschikt over de laatste versie van de CeviKszDLL en deze werd in de toepassing geregistreerd. Bovendien komt het probleem bij alle collega s voor. In de toepassing Sociale Dienst onder menupunt 1.20.1 KSZ dossieropbouw blijft de dll op rood staan. Bij het KSZ onderzoek komt de melding: NOK aantalhits=0 foutcode=lasterrorcode=10000#severity=error;reasoncode=3100000 1;Diagnostic=An error occurred during the parsing of the request header. Please check your message format.;error Codelist=CBSS; record1=ticket=;no results for this selection Er is dus een probleem met de verbinding naar KSZ. 4.1.3 Kan er buiten NH verbinding gemaakt worden naar KSZ Probeer de service van KSZ te bereiken Surf vanuit de internetbrowser naar https://bcssksz-servicesprod.smals.be/connectors/webservice/kszbcsswebserviceconnectorport (gebruik de link uit 8.1.16.1 om zeker dezelfde link te gebruiken als NH). Verbinding buiten NH ook niet mogelijk: Krijg je een foutmelding op de webpagina, dan is er vermoedelijk een probleem met de firewall-instellingen. De computer kan geen verbinding maken met KSZ. Laat de systeemverantwoordelijke de firewallinstellingen bekijken. Kijk ook de IP-adressen in 8.1.16.1 na. Die moeten verwijzen naar de juiste adressen Hoofdstuk 4: Problemen bij alle gebruikers Probleemoplosser KSZ-verbinding Versie 2015-10-19

15 zodat de verbinding via Publilink verloopt. Deze adressen moeten ook goed gerouteerd staan om via Publilink te werken. Verbinding buiten NH ook niet mogelijk: Als er geen verbindingsproblemen zijn, krijg je volgend bericht: Dit laatste betekent dat de computer toegang heeft tot KSZ, maar New Horizon niet. Waarschijnlijk staat de data execution prevention op de server of op de pc ingeschakeld. Data execution prevention De data execution prevention is een beveiliging die NH tegenhoudt om een verbinding met KSZ op te starten. Nieuwe dll installeren De CeviKszDLL vanaf versie 89 is speciaal ontwikkeld om te werken in combinatie met de data execution prevention. We raden aan deze DLL te installeren om de problemen te verhelpen. De Data-execution-prevention voor de nhclient uitschakelen Een andere mogelijkheid is dat je de in de data execution prevention een uitzondering toevoegt voor nhclient.exe of de data execution prevention uitschakelt. Je doet dit als administrator door: Op Mijn computer rechts te klikken en eigenschappen te kiezen. Tabblad Advanced te kiezen. Knop <Settings> van Performance aan te klikken. Tabblad Data Execution Prevention te kiezen. Dan ofwel: Turn on DEP for essential (dit vergt effectief een reboot). Turn on DEP for all programs and services En voeg de nhclient.exe die je gebruikt toe (hiervoor is geen reboot nodig). Hoofdstuk 4: Problemen bij alle gebruikers Probleemoplosser KSZ-verbinding Versie 2015-10-19

Hoofdstuk 4: Problemen bij alle gebruikers Probleemoplosser KSZ-verbinding Versie 2015-10-19 16