iDEAL: Installatie

Installatie

De installatie van wise-bxmcgi-6.2.2 plaatst alle benodigde software. In de map /home/bng/ideal komen de nieuwe PHP scripts te staan. Hieraan mag NIETS gewijzigd worden: deze worden steeds overschreven met nieuwe versies. Er is één uitzondering, het bestand config.php. Hierin staat het pad naar de configuratiebestanden

• In de map /etc/bng.d/ideal staan de configuratie-bestanden en de certificaten (tenzij aangepast in /home/bng/ideal/config.php).
• In de map /var/log/ideal staan de logbestanden.

Benodigde software

• php 5.3 of hoger
• php-openssl
• php-curl

Als iDeal al is ingericht op de server, dan zijn de certificaten er al. Er is 1 per server nodig:

• /etc/bng.d/ideal/iDealWise.cer
• /etc/bng.d/ideal/iDealWise.pem.

Daarmee is ook /etc/bng.d/ideal/wise.conf ingericht. Anders kan een certificaat worden aangemaakt met de volgende commando's:cd /etc/bng.d/ideal. Het wachtwoord iDe@lPass kan naar eigen inzicht worden aangepast, en moet in wise.conf gezet worden.

openssl genrsa –aes128 –out iDealWise.pem –passout pass:iDe@lPass 2048
in onderstaand commando moet Provincie, Plaats en Organisatie nog aangepast worden:
openssl req –x509 –new –key iDealWise.pem –passin pass:iDe@lPass -days 1825 –out iDealWise.cer -subj '/C=NL/ST=Provincie/L=Plaats/O=Organisatie/OU=ict/CN=ideal'

Logging klaarzetten
mkdir /var/log/ideal
chown -R wwwrun:www /var/log/ideal
chmod -R 775 /var/log/ideal

cd /etc/bng.d/ideal/
iDealWise.cer ophalen

Plaats het certificaat in het dashboard van de bank, zowel test als productie.

Nu moet er een ideal config gemaakt worden
Normaal staat dit in /etc/bng.d/ideal/ideal.conf maar bij meerdere installaties raden we aan om het bestand /etc/bng.d/ideal/ideal.conf.xx te noemen, waarbij xx het nummer van de financiële organisatie is (de naam is overigens vrij te kiezen).

vi /etc/bng.d/ideal/ideal.conf
Vul in ieder geval MERCHANTID is, kies de juiste bank (eerst test, later productie) en haal het hekje weg,
Haal het hekje weg bij het certificaat van de bank.

vi /etc/bng.d/ideal/wise.conf
Vul in ieder geval PRIVATEKEYPASS in, en WISESERVER (hier komt het adres van de Wise webcat).
Wanneer per iDeal installatie een ander retouradres gebruikt moet worden, dan kan dit worden opgegeven door in ideal.conf.xx WISESERVER te overrulen.

De apache configuratie moet mogelijk worden aangepast:
vi /etc/apache2/vhosts.d/bicat-common.include

    Alias /php/ /home/bng/ideal/
    Alias /ideal/ /home/bng/ideal/
    <Directory /home/bng/ideal>
        Order allow,deny
        Allow from all
    </Directory>

In de crontab moeten 2 taken worden opgenomen:
crontab -e
0-59/5 * * * * cd /home/bng/ideal;php IdealStatus.php >/var/log/ideal/status.log 2>&1
1 1 * * * cd /home/bng/ideal;php IdealIssuers.php >/var/log/ideal/issuers.log 2>&1

Testen of het werkt, en de banken goedzetten:
cd /home/bng/ideal;php IdealIssuers.php
cd /home/bng/ideal;php IdealStatus.php

Hierna de eerste keer:
chown -R wwwrun:www /var/log/ideal
chmod -R 775 /var/log/ideal

Om nu de tests voor de banken te doorlopen:
Ga naar http://bicat.bibliotheek.nl/ideal/IdealTest.php en klik steeds op 'volgende' (hier moet het adres gebruikt worden van de Wise webcat).

Wanneer er meerdere iDEAL-installaties zijn, moet ook de config worden meegegeven:
http://bicat.bibliotheek.nl/ideal/Id...=ideal.conf.xx

Bij overgaan naar productie moet in het dashboard op activeren worden geklikt en moet in /etc/bng.d/ideal/ideal.conf de ACQUIRERURL op productie worden gezet. Daarna MOETEN de banken opnieuw worden opgehaald:
cd /home/bng/ideal;php IdealIssuers.php

Problemen opsporen:
Alle logging wordt opgeslagen in /var/log/ideal

• In idealwise.log staat de complete logging (inclusief alle dialogen).
• In idealinfo.log staat de gecomprimeerde log. Deze laatste is altijd het beste uitgangspunt om te gaan zoeken.

Installatie op de Wiseserver

• Vanuit de Manager moet per iDEAL-installatie de benodigde parameters worden ingesteld (zie iDEAL-methode)
• Per instantie moet bij de instantie worden ingesteld met welke iDEAL-methode moet worden gewerkt: Manager > Beheer organisatie > Instanties.
• Verder moet in het onderdeel dagboekgebruik per instantie worden ingesteld welk dagboek moet worden gebruikt voor het verantwoorden van iDEAL-ontvangsten:
  Manager > Financieel > Systeemtabellen > Dagboekgebruik.

iDEAL-methode

Instellen via de Manager > Financiën > Systeemtabellen > iDEAL-methode.