WEBPACT. Systeembeheer handleiding

WEBPACT Systeembeheer handleiding

Versienr. 1.0 1.1 1.2 1.3 1.4 1.5 1.6

Datum 15-09-2006 20-09-2006 19-10-2006 26-10-2006 19-12-2006 9 februari 2009 21-01-2010

Naam Jan Mol S.A .van Hamersveld S.A. van Hamersveld S.A. van Hamersveld Jan Mol A.J. de Jonge Jan Mol

Opmerkingen

Highlight toegevoegd Bijgewerkt voor build 1.6.3022.22456 WebPact share + webpact virdir

© Copyright 2012 Vlicomp B.V., Goes Alle rechten voorbehouden. De informatie in dit document kan zonder enige waarschuwing vooraf worden gewijzigd en houdt geen enkele verplichting in voor Vlicomp B.V. Niets uit deze uitgave mag verveelvoudigd worden, in een geautomatiseerd gegevensbestand opgeslagen worden, of openbaar gemaakt worden door middel van druk, fotokopie, microfilm of op welke wijze dan ook, hetzij elektronisch, hetzij mechanisch, zonder voorafgaande schriftelijke toestemming van de uitgever. Alle wijzigingen voorbehouden. All rights reserved. No part of this book may be reproduced, stored in a retrieval system, or transmitted in any form, by print, microfilm, or by any other means, without written permission from the publisher. Auteur(s) Afdrukdatum Wijzigdatum Versie Status Aantal pagina’s Bestand

: Jan Mol, Serge van Hamersveld : 21-01-2010 : 21 januari 2010 : 1.6 : As Build : 20 (inclusief voorblad) : WebPact Systeembeheer.doc

WEBPACT

Inhoudsopgave 1.

INLEIDING .................................................................................................................. 2

2.

INSTELLINGEN SYSTEEMPARAMETERS ................................................................ 3

3.

DE KLANTGEGEVENS............................................................................................... 5

4.

XML BESTANDEN AANMAKEN ................................................................................ 6

5.

PDF BESTANDEN AANMAKEN ALS U BEGINT MET WEBPACT............................ 7

6.

DE INRICHTING VAN DE WEBPACT SERVER ......................................................... 8 6.1 6.2

SYSTEEMEISEN WEBPACT........................................................................................ 8 QUICKLINK................................................................................................................. 8

7.

PLATFORM FOR PRIVACY PREFERENCES ............................................................ 9

8.

CONFIGURATIE BESTANDEN WEBPACT...............................................................12 8.1 WEBPACT.CONFIG......................................................................................................12 8.2 LICENTIE.XML ............................................................................................................13 8.3 GEBRUIKERS.XML ......................................................................................................13 8.4 ROBOTS.TXT .............................................................................................................13 8.5 STYLESHEET.CSS ......................................................................................................15 8.5.1 PLAIN LOOK ........................................................................................................15 8.5.2 GOOGLE LOOK ....................................................................................................16 8.5.3 ALTAVISTA LOOK .................................................................................................16 8.5.4 MARKTPLAATS LOOK ...........................................................................................17 8.6 XML.INI ...................................................................................................................18

As Build, versie 1.6 Pagina 1

WEBPACT

1. Inleiding Met WEBPACT bent u als WINPACT gebruiker in staat om een kopie van uw certificaten aan uw klanten ter beschikking te stellen via Internet. U kunt per klant instellen of de certificaten van die betreffende klant op de Internet site komt te staan. Zo kunt u bepaalde klanten wel, en bepaalde klanten geen toegang geven tot hun certificaten. WEBPACT draait op een Windows IIS server (zie ook hoofdstuk systeemeisen). Van elk certificaat wat u print wordt terwijl u print (als dit bij de klantgegevens is aangegeven) een kopie gemaakt in het pfd formaat (Adobe Acrobat Reader). Deze documenten staan op uw IIS server in een voor de klant onbereikbare plaats. Ieder klant krijgt automatisch een eigen directory voor zijn certificaten, ingedeeld in categorieën.

In dit voorbeeld heeft klant NAM 5 verschillende soorten certificaten, die ook in 5 verschillende subdirectory’s zijn opgeborgen. In een volgende versie krijgen de certificaten ook volgdocumenten mee, zodat er bij elk document een doorverwijzing mogelijk is naar gerelateerde documenten zoals; • Berekeningsgegevens • Tekeningen • Folders


WEBPACT

2. Instellingen systeemparameters

Voor WEBPACT is het belangrijk dat u in bovenstaande scherm (met rood gemarkeerd) de volgende gegevens invult: • Het pad voor de gebruikers.xml (we komen hier in een volgend hoofdstuk op terug), normaal is dit de directory op de IIS server waar de kopie certificaten worden geplaatst (in het voorbeeld f:\klanten). WEBPACT plaatst automatisch de klantcode achter het door u opgegeven pad, zodat dit in het voorbeeld f:\klanten\klantnaam zou worden. Dit kan dus in uw geval ook \\IIS-server01\Webcertificaten zijn. Deze directory moet dus voor alle WINPACT gebruikers bereikbaar zijn. • Het pad voor de certificaten, normaal is dit de directory op de IIS server waar de kopie certificaten worden geplaatst (in het voorbeeld f:\klanten). WEBPACT plaatst automatisch de klantcode achter het door u opgegeven pad, zodat dit in het voorbeeld f:\klanten\klantnaam\xxxxcategorie zou worden. Dit kan dus in uw geval ook \\IISserver01\Webcertificaten zijn. Deze directory moet dus voor alle WINPACT gebruikers bereikbaar zijn. As Build, versie 1.6 Pagina 3

WEBPACT

•

De gegevens voor het briefhoofd (ook al print u uw origineel op voorbedrukt papier, de kopie krijgt alleen de briefhoofdgegevens).

Pas als deze gegevens zijn ingevuld, en de toegang tot deze systeempaden door uw systeembeheerder is geregeld, kunt u aan de slag met WINPACT samen met WEBPACT.


WEBPACT

3. De klantgegevens

In WINPACT geeft u per klant aan of deze klant zijn gegevens kan terugvinden in WEBPACT. Dit doet u door een naam en password op te geven van minimaal 5 karakters lang. Over de directory hoeft u zich geen zorgen te maken, deze wordt automatisch ingevuld als u de klantgegevens opslaat. WEBPACT werkt alleen met klanten waarvan naam en password in WINPACT is ingevuld.


WEBPACT

4. XML bestanden aanmaken WEBPACT maakt, voor het terugzoeken van certificaten via Internet, gebruik van speciale bestanden om de zoekgegevens in op te kunnen slaan, een zgn. XML bestand. Dit is gedaan om uw WINPACT bestanden volledig te kunnen scheiden van uw WEBPACT bestanden, zodat hackers er niet met uw gegevens vandoor kunnen gaan. Dit XML bestand moet u regelmatig opnieuw aanmaken, nadat er in WINPACT gegevens zijn veranderd. Dit kunt u per klant doen, of voor alle klanten die via WEBPACT hun gegevens op Internet kunnen zien, tegelijk. Normaal moet u dus bv. 1 x per week deze handeling verrichten, indien noodzakelijk met een hogere frequentie.

Als u in WinPact bovenstaande keuze maakt, krijgt u het onderstaande scherm te zien.

U ziet dat het onmogelijk is om de paden te veranderen, deze hebt u immers in de systeemparameters opgegeven. Wel kunt u een bepaalde klantcode (bv. VLICOM) opgeven, waarna er alleen voor klant VLICOM de XML bestanden worden aangepast op de WEBPACT site. Deze keuze gebruikt u bv. als u snel voor 1 klant een certificaat moet maken wat direct op Internet beschikbaar moet zijn.


WEBPACT

5. PDF bestanden aanmaken als u begint met WEBPACT Als u als nieuwe gebruiker begint met WEBPACT, zijn meestal nog niet alle certificaten van een bepaalde klant beschikbaar als pdf document op de website. Deze cyclus zou wel 4 jaar kunnen duren, voordat u een bepaald hijswerktuig weer terug krijgt voor inspectie en weer een certificaat aanmaakt. Om per klant in 1 x alle documenten van deze klant in .pdf documenten op de WEBPACT site te kunnen plaatsen, beschikt u in WINPACT over een zgn. Add-in n.l. Cert2Pdf. Indien u hier niet over beschikt (Menu ‘Add-in’, keuze ‘Cert2PDF’) vraag deze dan aan bij Vlicomp.

Bedenk echter wel dat er klanten zijn met wel 10.000 certificaten, en dat de snelheid waarmee uw oude documenten worden omgezet naar PDF niet hoger zal liggen dan ca. 500 documenten per uur en dat u met uw PC gedurende deze tijd niets anders kan doen. Bedenk ook dat de waarde van de opnieuw berekende werklast af kan wijken van het oorspronkelijke document, omdat de normen voor de berekening gedurende de laatste 14 jaar ingrijpend gewijzigd zijn voor met name kettingwerk en staalkabels.


WEBPACT

6. De inrichting van de WEBPACT Server 6.1

Systeemeisen WEBPACT

Minimaal IIS (Internet Information Services) 5.1 voorzien van met ASP.NET versie 2.0 Een vast IP adres, een virtuele directory b.v. “webpact” die vanaf de buitenwereld benaderbaar is. LET OP: Het is verstanding om de documenten en de gebruikers.xml NIET in de virtuele directory te zetten, maar in een andere map welke niet een onderliggende map is van “wwwroot”. U heeft dus uit beveiligingsoverweging nodig: - Een virtuele directory WebPact in \inetpub\wwwroot\ met leesrechten voor de anonieme IIS user, hierin komt het WebPact programma - Een share WebPact met alle rechten voor Winpact gebruikers en leesrechten voor de anonieme IIS-user(zowel op de share als op de directory zelf !) De documenten kunnen zowel op de IIS server als op een ander systeem staan. Let op dat de IIS server deze bestanden altijd moet kunnen lezen om ze te kunnen gebruiken. U kunt bijvoorbeeld de map “C:\webpact” maken. Daarin komen onderliggende mappen van uw klanten met daarin hun certificaten die u uit WINPACT exporteert. WEBPACT moet worden geconfigureerd zodat het weet waar de bestanden staan. De certificaten zullen door WEBPACT worden gestreamd zodat de klanten de certificaten van elkaar niet kunnen zien. Wanneer er geprobeerd word misbruik te maken van de streamfunctie zal er een abuse.txt worden aangemaakt in het documentpad waarin staat wie, wat geprobeerd heeft te benaderen. 6.2

QuickLink

Vanaf versie 1.1.2580.18538 is het mogelijk om via een hyperlink het loginscherm over te slaan. Op deze manier kunnen uw klanten direct gebruikmaken van WEBPACT, bijvoorbeeld in hun intranet. Hiervoor moet de klant éénmaal inloggen in WEBPACT op de gebruikelijk manier. Daarna typt de klant in de adresbalk http://uwserver/webpact/showlink.aspx

Daarna krijgt de klant een hyperlink te zien die kan worden gebruikt voor een directe link.

In dit geval: http://192.168.0.254/webpact/login.aspx?enc=B1572832BF536D2FFAED7C982A04E229FAED7C982A04E229E1 B65A2D971AF968FE01CE2A7FBAC8FAFE01CE2A7FBAC8FA


WEBPACT

7. Platform for Privacy Preferences Het kan zijn dat u bijvoorbeeld een link naar WEBPACT op uw eigen website wilt plaatsen. In dit geval raden wij u aan om de website niet in een frame in uw eigen website te plaatsen. Het kan namelijk zijn dat de sessievariabelen (cookie) verloren gaan in een frameset in combinatie met bepaalde browsers. Dit komt door de P3P (http://www.w3.org/TR/P3P/) norm. Meer informatie over dit onderwerp kunt u lezen op http://support.microsoft.com/kb/323752 vinden.

Microsoft draagt een manier aan om als nog uw webbrowser deze cookies te accepteren. Let op: Mocht onderstaande manier geen oplossing bieden zult u uw link naar WEBPACT in een nieuw venster moeten laten openen en niet in een frame (zie voorbeeld): [uw tekst]

Oplossing Microsoft: U kunt dit voorkomen door een header met een compact P3P-beleid toe te voegen aan de inhoud van de onderliggende site en u kunt declareren dat er geen schadelijke acties worden uitgevoerd met de gegevens van de gebruiker. Als Internet Explorer een toegestaan beleid constateert, kan de cookie worden ingesteld. Hieronder ziet u een eenvoudig compact beleid dat voldoet aan deze criteria: P3P: CP="CAO PSA OUR"

Dit codevoorbeeld geeft aan dat uw site u toegang biedt tot uw eigen contactgegevens (CAO), dat er alleen 'pseudo-analyse' wordt toegepast op gegevens, wat inhoudt dat de gegevens worden gekoppeld aan uw online persona en niet aan uw fysieke identiteit (PSA) en dat uw gegevens niet worden verstrekt aan externe instanties voor gebruik door deze instanties (OUR). Gebruik de module IIS Management (inetmgr) om de header toe te voegen aan een statisch bestand. Ga als volgt te werk om deze header toe te voegen aan een statisch bestand: 1. Klik op Start, klik op Uitvoeren en typ inetmgr.


WEBPACT

2. Klik in het linkernavigatiedeelvenster op het bestand of de map in de website waaraan u de header wilt toevoegen, klik met de rechtermuisknop op het bestand en kies Eigenschappen.

3. Klik op het tabblad HTTP-headers.


WEBPACT

4. Klik in de sectie Aangepaste HTTP-headers op Toevoegen

5. Typ P3P als de header-naam en typ CP=... als de tekenreeks voor het compacte beleid, waarbij u '...' vervangt door de juiste code voor het compacte beleid.

(bron: http://support.microsoft.com/kb/323752)


WEBPACT

8. Configuratie bestanden WEBPACT 8.1

webpact.config

<settings> <setting> C:\WebPact\winpact\licentie.xml <userxml>C:\WebPact\winpact\gebruikers.xml <userpath>C:\WebPact\winpact\ <maxlinepage>25 http://www.adobe.com/products/acrobat/readstep2.html pdf.ico xmlbutton.gif <sessiontimeout>30 <streamallowedextensions>.pdf <streamforbiddensubstrings>*;~;..\;../;|;$;% <defaultcss> <showlink>True <emptyisall>True Blokken <path>\blokken\ certificaten_blokken.xml Hijsbanden <path>\hijsbanden\ certificaten_hijsbanden.xml Kettingwerk <path>\kettingwerk\ certificaten_kettingwerk.xml …

Configuratie bestand WEBPACT. <userxml> <userpath> <maxlinepage> <sessiontimeout> <streamallowedextensions>. <streamforbiddensubstrings>

<defaultcss> <showlink> <emptyisall>

Het pad waar de licentiefile staat Het pad waar de gebruikers staan Rootpath van de certificaten. Hier staat tevens de abuse.txt Hoeveel regels mogen er op een pagina. 0 is altijd alles laten zin URL naar de downloadpgina van adobe reader. Leeg is geen link op de pagina Icoon van een pdf bestand. Leeg is geen icoon Icoon van een xml bestand. Leeg is geen icoon Hoelang mag een sessie duren. Leeg is default IIS Welke bestandstypes mogen er gestreamd worden (; gescheiden) .pdf is altijd mogelijk Welke substrings mogen er niet voorkomen in het pad (; gescheiden) ..\;../;$ zijn nooit mogelijk Standaard ccs dat word gebruikt Waneer “False” dan kan de pagina showlink.aspx niet worden geopend en gaat webpact terug naar het loginscherm. Waneer “True” dan worden alle certificaten getoond zonder een


WEBPACT

8.2

zoekcriteria op te geven. (als vervanging voor *) Waneer “True” dan worden alle bezoeken vastgelegd in visit.txt in het pad waar de gebruikers staan (op te vragen via statistics.aspx)

licentie.xml

<webpact> 00000000-0000-0000-0000-000000000000 Bedrijfsnaam 12345678 12-2006 <users>1

Hier in komen de licentie gegevens. <users> 8.3 Licentie sleutel die u jaarlijks krijgt opgestuurd. Lisentie naam. Kamer van koophandel nummer Verval datum webpact Aantal gebruikers winpact gebruikers.xml user1 <password>pass1 path1 user2 <password>pass2 path2 … Deze word automatisch gegenereerd door WINPACT <password> 8.4 Login naam Wachtwoord Directory vanaf het rootpath van de certificaten. robots.txt # voor meer info over robots.txt: # http://support.microsoft.com/default.aspx?scid=kb;en-us;217103 User-agent: * # Alle "WebSpiders" Disallow: / # Hebben niets te zoeken in deze map en haar submappen As Build, versie 1.6 Pagina 13 WEBPACT Houdt webcrawlers buiten de deur. As Build, versie 1.6 Pagina 14 WEBPACT 8.5 stylesheet.css A:link {color:navy; text-decoration:none} A:visited {color:red; text-decoration:none} A:active {color:red; text-decoration:none} BODY {font-family: verdana,arial,helvetica,sans-serif; background-color: white; color: black; font-size:small} TABLE.resultlist margin-top:5px} TH.resultlist weight:bold} TD.resultlistodd TD.resultlisteven {width:100%; background-color: white; {background-color: navy; font-size: 10pt; color: black; font-size: 10pt; color: white; font- {background-color: #dddddd; font-size: 8pt; {background-color: white; font-size: 8pt; color: black;} color: black;} … Door optimaal gebruik te maken van stylesheets is WEBPACT uiterst flexibel qua layout. In dit voorbeeld zijn de linkjes naar de documenten navy blauw en als ze ooit een keer geopend zijn zijn ze rood. De regels in de tabel zijn om en om grijs of wit van kleur. De header van de tabel is ook navyblauw met witte letters in bold. Zo zijn er nog veel meer instellingen waar u WEBPACT mee kan aanpassen aan uw smaak. Alles over stylesheets kunt u vinden op http://en.wikipedia.org/wiki/Cascading_Style_Sheets. Enkele voorbeelden vindt u hieronder. 8.5.1 Plain look As Build, versie 1.6 Pagina 15 WEBPACT 8.5.2 Google look 8.5.3 Altavista look As Build, versie 1.6 Pagina 16 WEBPACT 8.5.4 Marktplaats look As Build, versie 1.6 Pagina 17 WEBPACT 8.6 XML.INI Met de xml.ini (Die op de PC’s in de WINPACT directory staat) kunt u bepalen uit welke kolommen de gebruiker van de website kan kiezen per certificaatsoort. Hieronder een voorbeeld: Per producttabel maximaal 100 regels(kolommen), eerst de omschrijving van de kolom, dan een komma, dan de veldnaam, Quotes (') en komma’s zijn niet toegestaan. Er is een extra optie om bv. de certificaatregel een andere kleur te geven als de herkeuringsdatum is verlopen. In dat geval zet u achter de veldnaam een, (komma) en daarna in kleine letters het woord “highlight” [CERTIFICATEN_STAALDRAAD] Regel_1 = Klant,CF_CLT Regel_2 = Inslagnummer,CF_REGNR Regel_3 = Cert datum,CF_DATUM Regel_4 = Referentie,CF_REF Regel_5 = Artikel,CF_ART Regel_6 = Werklast,CF_WERKL [CERTIFICATEN_KETTINGWERK] Regel_1 = Klant,CF_CLT Regel_2 = Inslagnummer,T_REGNR Regel_3 = Cert datum,CF_DATUM Regel_4 = Herkeuring,HK_DATUM,highlight Regel_5 = Artikel,CF_REF Regel_6 = Werklast,T_WERKL Regel_7 = Omschrijving,NAAM Alias_7 = SELECT art_naam FROM artikelen_kettingwerk WHERE art_id = {%t_art%} Regel_8 = Omschr2,CF_OMSCHR2 [CERTIFICATEN_HIJSBANDEN] Regel_1 = Klant,CF_CLT Regel_2 = Inslagnummer,CF_SRNUM Regel_3 = Cert datum,CF_DATUM Regel_4 = Herkeuring,HK_DATUM Regel_5 = Artikel,CF_ART Regel_6 = Toepassing,CF_TOEP Regel_7 = Referentie,CF_REF [CERTIFICATEN_BLOKKEN] Regel_1 = Klant,CF_CLT Regel_2 = Inslagnummer,T_REGNR Regel_3 = Cert datum,CF_DATUM Regel_4 = Herkeuring,HK_DATUM Regel_5 = Artikel,T_ART Regel_6 = Werklast,T_WERKL Regel_7 = Omschr1,OMSCHR Regel_8 = Omschr2,ART_AFM1 … Tevens kan er voor elke regel een alias worden opgegeven als de oorspronkelijke informatie leeg is. Dit kunt u doen door onder de regel waarop dit van toepassing is een Alias met hetzelfde nummer op te nemen. U ziet een voorbeeld hiervan bij kettingwerk. U ziet hier een aantal certificaatsoorten genoemd, als u bijvoorbeeld een ander soort certificaten op de website wilt zetten kunt u tussen de rechte haken [ ] de tabelnaam vermelden (voorbeeld: [CERTIFICATEN_TOUWWERK]) met daaronder de regels (kolommen) met omschrijving en veldnaam uit de tabel. As Build, versie 1.6 Pagina 18 WEBPACT Via de menu keuze in WINPACT ‘Systeembeheer | Database | Bladeren’ kunt u alle tabelnamen en veldnamen terugvinden. Kopieer na wijziging/aanpassing de xml.ini op alle andere PC’s met WINPACT. As Build, versie 1.6 Pagina 19

WEBPACT. Systeembeheer handleiding

Recommend Documents