Hobbynet Admin Wiki - User contributions [en]

XML-RPC

2022-04-10T12:43:06Z

Hans: Deze versie werkt samen met PHP 8

= XML-RPC interface =

De LDAP server kan direct gemuteerd worden via een LDAP koppeling. Zie
de standaard LDAP pagina voor de uitleg welke poorten daarvoor gebruikt
kunnen worden.

Daarnaast is er de wens ontstaan om via een standaard protocol met de
LDAP omgeving te kunnen communiceren. Er is hiertoe een XML-RPC
koppeling ontwikkeld. XML-RPC is een standaard interface, waarmee het
mogelijk is om vanuit diverse omgevingen op een gestandaardiseerde
manier te communiceren.

== Globale functie omschrijving ==
* Algemene aanroepen
** Controleer of een gebruiker bestaat
** Wijzig het wachtwoord ('userPassword')
** Zoek een gebruiker (t.b.v. kantoor en/of LA-akties groeperingssecretaris)
** Maak een gebruiker aan (geef gebruiker een andere hccLogin waarde, maak ook bij HCCnet deze gebruiker aan)
** Controleer of een gebruiker zijn profiel al doorlopen heeft
** Haal de lijst met opgeheven accounts op
** Haal de lijst met bulletins van een hcc lid (OptIn)

* Aanroepen t.b.v. hcc partners
** Controleer of lidnummer/postcode correct is
** Controleer of lidnummer/postcode correct is, en tevens ingeschreven staat bij een specifieke IG

* Joomla template site functies (op basis van JoomlaToken)
** Maak een JoomlaToken
** Ruim een JoomlaToken op
** Pas mijn OptIn (bulletin inschrijving) aan
** Regel alles rondom Onderwerpen en de autorisatie hiervan
** Pas mijn wachtwoord aan

* Joomla kadernet site functies (op basis van JoomlaToken)
** Zoek een hcc kaderlid (t.b.v. de kaderleden zoekpagina)
** Pas mijn kadermail forwarding aan en toon ja/nee mijn GSM nummer
** Pas het kadernet e-mail wachtwoord aan
** Haal de lijst met alle groeperingen op
** Haal de lijst met alle kaderrollen op

* Joomla hcc.nl site (op basis van JoomlaToken)(mijn.hcc.nl vervanging)
** Pas mijn adresgegevens aan
** Pas mijn voorletters, voornaam, pseudoniem, telefoonnummer, GSM nummer etcetera aan
** Schrijf me in of uit op een bulletin
** Toon info over de kosten van een IG lidmaatschap
** Voer een wachtwoord reset uit op basis van een PWResetToken (een variant op JoomlaToken)
** Vraag een nieuwe HCC code aan, en stuur die per SMS

* Joomla hobby.nl site (op basis van JoomlaToken)(t.b.v. IDEAL betaling)
** Haal het aantal hobbyDomains op

* Aanroepen t.b.v. CRM (Microsoft Dynamics Cloud) koppeling
** Haal de dagelijkse synchronisatie bestanden op
** Werk in het CRM dan wel in LDAP de NAW gegevens bij
** Werk in het CRM dan wel in LDAP de IG gegevens van een lid bij

* HenZ
** Haal de lijst met opzeggers op
** Valideer de opzegdatum van een opgegeven gebruiker

=== Authenticatie ===

Alle aanroepen gebeuren op basis van authenticatie vanuit de aanroeper.
Dit valt uiteen in de volgende categorieën:
* gebruikersnaam ('hccLogin') en wachtwoord ('userPassword')
* hcc lidnummer ('hccLidnr'), Joomla token ('JoomlaToken') en website ('siteID')
* hcc lidnummer ('hccLidnr') en hcc code ('hccCode')
* beheerders-DN ('beheerLogin') en beheerders wachtwoord ('beheerPassword')
* partner-DN ('partnerLogin') en partner wachtwoord ('partnerPassword')

=== Aanroepen, gedaan via de bezoekersregistratie-proxy ===
(de bezoekersregistratie proxy is een mislukt project tbv de Android app van René Prins)
(deze proxy bestaat niet meer) 
Diverse aanroepen kunnen ook via de bezoekersregistratie-proxy aangeroepen worden. 
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
* GeefAlleGroeperingen
* GeefAlleKaderRollen
* GeefLocaties
* GeefLocatieNamen
De bezoekersregistratie aanroepen hebben 'JoomlaToken' als extra parameter nodig:
* LidBezoektBijeenkomst
* GeefBezoekersOverzicht
De aanroepen die over de proxy uitgevoerd worden dienen voorafgegaan te worden door een aanroep naar
* GeefMijnGegevens (dit geeft na validatie immers 'JoomlaToken' terug)

=== Resultaten ===

Alle aanroepen geven de volgende elementen terug:
* Naam van de uitgevoerde procedure ('Action')
* Resultaat van de uitgevoerde procedure ('Status')
* Een tekstuele vertaling van het resultaat dan wel de foutmelding ('Message')
* Tijdens de ontwikkelfase kan er debug-info teruggeleverd worden ('ExtraInfo')
Daarnaast geven specifieke aanroepen extra resultaten terug

== Technische omschrijving ==
XML-RPC beschrijving van acties in hcc.nl LDAP database

<pre>
2022.03.24 HaVe
XML-RPC Hobbynet versie 71.
</pre>

=== Kort overzicht ===

Dit is een lijst met alle XML-RPC aanroepen. In het volgende hoofdstuk worden ze in detail besproken.
<pre>
echo (partners)
ExpandeerPostcode (Joomla module Bas, tbv verhuizingen)
GebruikerBestaatControle (Joomla sites)
GeefAantalDomeinen (Joomla module Bas)
GeefAlleBulletins (Joomla module Bas)
GeefAlleGroeperingen (kadersite, forum, secr. portal, kantoor portal, hobbynet portal)
GeefAlleKaderRollen (forum, secr. portal, kantoor portal, hobbynet portal, Joomla module Bas)
GeefBezoekersOverzicht (bezoekersregistratie)
GeefFactuurOverzicht (Joomla module Bas)
GeefhccEindDatum (HenZ)
GeefKadermailGegevens (kantoor portal)
GeefLocatieNamen (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefLocaties (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefMijnGegevens (Joomla inlog module Bas)
GeefMijnLidnummer (beheer.hcc.nl secretaris portal)
GeefOnderwerpen (Joomla template sites)
GeefSSOUrls (Joomla module Bas)
GeefUitgeschrevenLeden (Joomla sites, HenZ)
HaalAanmeldingsformulier (Joomla module Bas)
HaalFactuur (Joomla module Bas)
HaalIGBedragenOp (Joomla module Bas)
HaalTariefGroepenOp (kantoor portal)
HCCpartner (Partner aanroep)
HCCpartners (Partner aanroep)
HeeftOtpKey (Joomla Hobbynet/LA aanroep)
IsDezeNaamNogBeschikbaar (aangeroepen vanuit de CRM omgeving)
IsDezePseudoniemNogBeschikbaar (kantoor portal)
IsHCCLid (vraagbaak aanroep)
IsKaderLid (in veel apps gebruikt)
LidBezoektBijeenkomst (bezoekersregistratie)
MaakGebruikerAan (mijnhcc.nl, maak hccnet account aan en ldap gebruikersnaam)
MaakOnderwerp (Joomla template sites)
MaakPWResetToken (Joomla module Bas)
MaakTestLogin (Joomla module Bas)
MuteerAanmeldingsformulier (Joomla module Bas)
MuteerGroeperingSamenstelling (Joomla kadernet module Bas)
MuteerOnderwerp (Joomla template sites)
MuteerOnderwerpAutorisatie (Joomla template sites)
NormaliseerTelefoon (Joomla module Bas)
PasHccLoginAan (Joomla module Bas)(enkel Hobbynet)
PasInteressegroepAan (Joomla module Bas)
PasKaderGegevensAan (kadersite, Joomla module Bas)
PasOptInKeuzeAan (Joomla module Bas)
PasPseudoniemAan (Joomla module Bas)
PasUserWachtwoordAan (beheer.hcc.nl Hobbynet gebruikers portal)
PasWachtwoordAan (Joomla module Bas)
RegistreerGast (bezoekersregistratie)
ResetHCCCode (Joomla module Bas)
RuimJoomlaTokenOp (Joomla module Bas)
SchrijfNietlidInOpBulletin (Joomla site bulletin module Bas)
SchrijfNieuwLidIn (Joomla CRM module Bas)
ToonOnderwerpAutorisatie (Joomla template sites)
UpdateMobiel (Joomla module Bas)
UpdateNAW (Joomla module Bas)
UpdateOTP (Joomla module Bas)
Upload_CSV_bestand (CRM webproxy)
ValideerPWResetToken (Joomla module Bas)
ValideerWachtwoordEisen (Joomla module Bas)
Verwerk_JSON_mutatie (CRM webproxy)
VerwijderNietLid (Joomla beheer module Bas)
VerwijderOnderwerp (Joomla template sites)
VraagLidgegevensTokenAan (bezoekersregistratie)
WijzigGebruikersGegevens (kantoor en Joomla template sites, ww aanpassen van gebruiker)
ZoekGroeperingsLid (secr. portal, kantoor portal, hobbynet portal)
ZoekHCCLid (VZ portal)
ZoekKaderLeden (Joomla kadernet module Bas)
</pre>

=== HCC-ldap en/of HCC-net aanroepen ===

<pre>
// ** Joomla sites, www.hcc.nl **
// 1.1 controleer of een gebruiker bestaat - optie 1
// (authenticatie op basis van hccLidnr en hccCode)
// Alleen bedoeld om gebruikers op www.hcc.nl op basis van het lidnr het ww te laten wijzigen
$request = xmlrpc_encode_request(
'GebruikerBestaatControle',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $method,
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd');
if ($hccLidnr != '') { $reply['hccLidnr'] = $hccLidnr; }
if ($hccLogin != '') { $reply['hccLogin'] = $hccLogin; }
if ($hccPseudoniem != '') { $reply['hccPseudoniem'] = $hccPseudoniem; }
if ($cn != '') { $reply['cn'] = $cn; }
if ($sn != '') { $reply['sn'] = $sn; }
if ($mail != '') { $reply['mail'] = $mail; }
if ($mailHccnet != '') { $reply['mailHccnet'] = $mailHccnet; }
if ($hccRegio != '') { $reply['hccRegio'] = $hccRegio; }
if ($hccIG != '') { $reply['hccIG'] = $hccIG; }
if ($hccRol != '') { $reply['hccRol'] = $hccRol; }
if ($ProfielBekend != '') { $reply['ProfielBekend'] = $ProfielBekend; }

// ** Portal mijn.hcc.nl **
// 2.1 wijzig wachtwoord - optie 1
// op basis van hccLidnummer en hccCode
// Essentiele aanroep, gebruikt vanuit mijnhcc.nl (lidnr + hccCode)
// Ook gebruikt t.b.v. wachtwoord-vergeten procedure op de Joomla template sites
// Als de profielpagina nog niet is doorlopen wordt deze aanroep afgekeurd.
//
// Ook gebruikt om gebruiker rechtstreeks vanaf Joomla template sites wachtwoord te
// laten aanpassen (op basis van lidnummer en hcc code)
//
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'WijzigGebruikersGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gewijzigd',
'hccLogin' => $hccLogin,
'cn' => $cn,
'sn' => $sn);

// 2.3 wijzig wachtwoord - optie 3
// (t.b.v. VZ-portal)
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
// * Als hccLidnr gevuld is, dan wordt hccLidnr gebruikt om het juiste record te zoeken
// Als hccLidnr leeg is, dan wordt hccLogin gebruikt om het juiste record te zoeken
// 1 van beide velden MOET aanwezig zijn
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'beheerLogin' => $beheerLogin, // beheerder lidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gebruikersnaam, pseudoniem
// en wachtwoord tevens in LDAP op
// (authenticatie op basis van hcc lidnummer en hcc-code)
// ** Deze gegevens worden doorgezet naar hccnet.nl (action=4) **
//
$request = xmlrpc_encode_request(
'MaakGebruikerAan',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_hccLogin' => $nieuw_hccLogin,
'nieuw_userPassword' => $nieuw_userPassword,
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'TRUE',
'Message' => 'Gebruiker aangemaakt',
'mail' => $mail,
'hccPseudoniem' => $hccPseudoniem);
Output negatief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gebruikersnaam bestaat al' |
'Pseudoniem bestaat al' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!');

// H.3 Haal al mijn gegevens
// (wordt gebruikt door de Joomla inlogmodule)
// Voor gebruik over de proxy t.b.v. de Android app kan compact=TRUE meegegeven worden.
// In dat geval worden enkel de meest essentiele gegevens teruggestuurd
// Voor gebruik na MaakGebruikerAan kan deze functie ook op basis van hccLidnr en JoomlaToken
// worden aangeroepen
// De optionele parameter 'PrevSiteID' is bedoeld voor single-sign-on. Op basis van JoomlaToken,
// hccLidnr en PrevSiteID worden dan de credentials gevalideerd. Als die kloppen, geeft deze aanroep
// een 2e JoomlaToken terug, maar dan uitgegeven op basis van SiteID.
// Als PrevSiteID leeg is, dan wordt het token op basis van siteID gevalideerd.
$request = xmlrpc_encode_request(
'GeefMijnGegevens',
array(
['hccLogin' => $hccLogin,
'userPassword' => $userPassword,]
['hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,]
['PrevSiteID' => $PrevSiteID,]
['compact' => $compact,] // leeg of 'TRUE'
['hccGroepering'=> $hccGroepering,] // Een testgebruiker mag alleen op deze site inloggen
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd',
'hccLidnr' => $hccLidnr,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccAutorisatie' => $hccAutorisatie,
'cn' => $cn,
'sn' => $sn,
'JoomlaToken' => $JoomlaToken,
['hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'givenname' => $givenname,
'hccAanhef' => $hccAanhef,
'hccGeslacht' => $hccGeslacht,
'hccTussenVoegsels' => $hccTussenVoegsels,
'hccAchternaam' => $hccAchternaam,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward,
'hccKaderToonMobiel' => $hccKaderToonMobiel,
'hccOptIn' => $hccOptIn,
'ProfielBekend' => $ProfielBekend,
'hccBeginDatum' => $hccBeginDatum,
'testaccount' => is_testaccount(), // 'TRUE' | 'FALSE'
'hccOtpKey' => $hccOtpKey,
'hccOtep' => $hccOtep,
['kadermail_omvang' => $Formaat, // in Mb
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald;]]);

Output negatief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// ** t.b.v. aanpassen van de opt-in keuzes op een Joomla site **
// H.4 Pas 1 opt-in van een lid aan
// (LET OP: authenticatie op basis van hccLidnr, JoomlaToken en siteID)
// of
// authenticatie op basis van hccLidnr en OptOutToken (voor een directe uitschrijving door een lid)
// Als hccLidnummer gevuld is, dan is dat het lidnummer waar de mutatie op moet worden uitgevoerd.
// Dat kan alleen als de aanvrager HCC#LAD of HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasOptInKeuzeAan',
array(
'hccLidnr' => $hccLidnr,
['JoomlaToken' => $JoomlaToken,]
['OptOutToken' => $OptOutToken,]
['hccLidnummer' => $hccLidnummer,]
'hccOptIn' => $hccOptIn,
'actie' => 'Nieuw' | 'Weg',
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'TRUE',
'Message' => 'OptIn aangepast');
Output negatief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials | Token ongeldig | Token verlopen');

// H.5 Zoek kaderleden NAW (t.b.v. de Joomla kadersite)
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
//
// * Er dient minstens 1 zoekcriterium opgegeven te worden.
// * Als zowel hccRegio als tegelijk ook hccIG opgegeven worden is de uitkomst onvoorspelbaar.
// * Als compact=TRUE worden enkel lidnummer, cn en sn in het antwoord gezet
$request = xmlrpc_encode_request(
'ZoekKaderLeden',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
['hccRegio' => $hccRegio,]
['hccIG' => $hccIG,]
['hccRol' => $hccRol,]
['hccLocatie' => $hccLocatie,]
['achternaam' => $achternaam,]
['compact' => $compact])); // leeg of 'TRUE'

Output positief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'TRUE',
'Message' => 'Kaderleden opgevraagd'
'Kaderleden' => array(
'hccLidNummer' => $hccLidNummer,
'hccRol' => $hccRol,
'hccAanhef' => $hccAanhef,
'givenname' => $givenname,
'cn' => $cn,
'sn' => $sn,
'hccWoonplaats' => $hccWoonplaats,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'hccKaderMail' => $hccKaderMail);

Output negatief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token']);

// H.9 PasKaderGegevensAan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
// Om de kaderleden hun forward in te laten stellen,
// en tegelijkertijd de opt-in / opt-out voor hccToonMobiel te laten regelen
// Kan tevens het kader email wachtwoord aanpassen
$request = xmlrpc_encode_request(
'PasKaderGegevensAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'hccKaderForward' => $hccKaderForward, // '' | $mail | $mailHccNet
'hccKaderToonMobiel' => $hccKaderToonMobiel, // 'TRUE' | 'FALSE' | 'NULL'
['nieuw_kaderPassword' => $nieuw_kaderPassword]));

Output positief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'TRUE',
'Message' => 'kadergegevens aangepast');

Output negatief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token'|'Alleen kaderleden mogen deze aanroep uitvoeren']);

// ** Portal beheer.hcc.nl
// ** H.10 PasUserWachtwoordAan
// (laatste aanroep 2020.04.09)(niet gepoort naar Joomla, maar nog wel op oude beheer portal)
// ** Betalende Hobbynet gebruikers kunnen hiermee hun wachtwoord aanpassen
// (authenticatie op basis van hccLogin en userpassword)
$request = xmlrpc_encode_request(
'PasUserWachtwoordAan',
array(
'hccLogin' => $username,
'userpassword' => $password,
'hobbynetAccount' => $hobbyname,
'nieuw_wachtwoord' => $nieuw_wachtwoord,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!' |
'account $hobbynetAccount behoort niet bij gebruiker $hccLogin' |
'Kan ww van account $hobbynetAccount niet aanpassen');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.11 Pas het pseudoniem van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasPseudoniemAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccPseudoniem' => $hccPseudoniem,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'TRUE',
'Message' => 'Pseudoniem aangepast');
Output negatief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials' | 'Pseudoniem bestaat al');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.12 Controleer of een opgegeven wachtwoord aan de minimum eisen voldoet
$request = xmlrpc_encode_request(
'ValideerWachtwoordEisen',
array(
'userPassword' => $userPassword,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'TRUE',
'Message' => 'Wachtwoord voldoet aan de minimale eisen');
Output negatief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'FALSE',
'Message' => 'Wachtwoord voldoet niet aan de minimale eisen');

// ** H.13 PasWachtwoordAan
// ** Vanuit een Joomla template site kunnen gebruikers hiermee hun eigen wachtwoord aanpassen
// (authenticatie op basis van JoomlaToken, lidnummer, siteID. Extra controle via userpassword)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'userpassword' => $password,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.13.1 PasWachtwoordAan
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee hun eigen wachtwoord resetten
// (authenticatie op basis van PWResetToken en hccLogin).
// (Als de aanroep geslaagd is, dan is daarna het PWResetToken ongeldig)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.14 MaakPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee een wachtwoord reset aanvragen
// Deze aanroep geeft naast het PWResetToken ook het contact emailadres mee terug,
// zodat Joomla een reset-mail kan sturen
// (acties op basis van gebruikersnaam)
$request = xmlrpc_encode_request(
'MaakPWResetToken',
array(
'hccLogin' => $username,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'TRUE',
'PWResetToken' => $PWResetToken,
'mail' => $mail,
'Message' => 'Password reset token aangemaakt');
Output negatief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');

// ** H.15 ValideerPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers een wachtwoord reset aanvragen
// Controleer dat het hier om een bestaand (en nog niet gebruikt) token gaat
$request = xmlrpc_encode_request(
'ValideerPWResetToken',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'TRUE',
'Message' => 'Password reset token gevonden');
Output negatief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'FALSE',
'Message' => 'hccLogin bestaat niet' | 'PWResetToken bestaat niet');

// H.16 Ruim een bestaand JoomlaToken op
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'RuimJoomlaTokenOp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'SiteID' => $siteID,
['ServerID' => gethostname(),]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'TRUE',
'Message' => 'JoomlaToken opgeruimd');
Output negatief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'FALSE',
'Message' => 'Onjuist JoomlaToken');

// ** Joomla module
// ** H.17 GeefAantalDomeinen
// ** Vraag het aantal domeinen op van een betalende Hobbynet gebruiker (t.b.v. IDEAL betaling)
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'GeefAantalDomeinen',
array(
'JoomlaToken' => $JoomlaToken,
'hccLidnr' => $hccLidnr,
'hobbynetAccount' => $hobbyname,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'TRUE',
'hobbynetAccount' => $hobbyname,
'AantalDomeinen' => $aantalDomeinen,
'Message' => 'aantal domeinen opgevraagd');
Output negatief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'account $hobbynetAccount behoort niet bij deze gebruiker');

// ** Joomla module
// ** H.18 ResetHCCCode
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'beheerLogin' => $beheerLogin, // geheime credentials van de site
'beheerPassword' => $beheerPassword, // geheime credentials van de site
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** Joomla module
// ** H.18.1 ResetHCCCode (hcc kantoor aanroep)
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'JoomlaToken' => $JoomlaToken, // Het Joomla token van de sessie van de kantoor medewerker
'hccLidnr' => $hccLidnr, // Het lidnummer van de kantoor medewerker
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** t.b.v. aanpassen van de hccLogin van een gebruiker (Hobbynet functie op Joomla site) **
// H.19 Pas de hccLogin van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// hccLidnummer is het lidnummer waar de mutatie op moet worden uitgevoerd
// Kan alleen als de aanvrager HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasHccLoginAan',
array(
'hccLidnr' => $hccLidnr, // lidnummer van de aanvrager
'JoomlaToken' => $JoomlaToken, // JoomlaToken van de aanvrager
'hccLidnummer' => $hccLidnummer, // pas de hccLogin van dit lidnummer aan
'hccLogin' => $hccLogin, // dit is de gewenste nieuwe hccLogin
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'TRUE',
'Message' => 'hccLogin aangepast');
Output negatief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' |
'Onjuiste credentials' |
'Gebruikersnaam al in gebruik');

// ** t.b.v. het aanmaken van een testaccount door een webmaster
// H.20 Maak een testaccount aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// Kan alleen als de aanvrager WM als rol heeft
$request = xmlrpc_encode_request(
'MaakTestLogin',
array(
'JoomlaToken' => $JoomlaToken, // JoomlaToken van de aanvrager
'hccLidnummer' => $hccLidnummer, // lidnummer van de aanvrager
'hccRol' => $hccRol, // (mag leeg zijn)
'hccGroepering' => $hccGroepering, // (regio of IG)
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
reply = array(
'Action' => 'MaakTestLogin',
'Status' => 'TRUE',
'Message' => 'Tijdelijk test account aangemaakt',
'TestAccountNaam' => 'test-<groepering>-<hccLogin>'
'userpassword' => $nieuw_userpassword,
'hccGroepering' => $hccGroepering,
'hccRol' => $hccRol);
Output negatief:
$reply = array(
'Action' => 'MaakTestLogin',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Gegevenscombinatie onjuist');

// Joomla functie
// ** t.b.v. aanpassen van de OneTime Passwords
// H.21 Pas de OTP gegevens van een lid aan
// (LET OP: authenticatie op basis van hccLidnr, JoomlaToken en siteID)
// Als hccLidnummer gevuld is, dan is dat het lidnummer waar de mutatie op moet worden uitgevoerd.
// Dat kan alleen als de aanvrager HCC#LAD of HN#WM als rol heeft
$request = xmlrpc_encode_request(
'UpdateOTP',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
['hccLidnummer' => $hccLidnummer,]
'hccOtpKey' => $hccOtpKey, // De otp encryptie key van de gebruiker (mag leeg zijn, dan weg)
'hccOtep' => $hccOtep, // Het one time recovery password (mag leeg zijn, dan weg)
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateOTP',
'Status' => 'TRUE',
'Message' => 'OTP gegevens aangepast');
Output negatief:
$reply = array(
'Action' => 'UpdateOTP',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// Joomla functie
// H.22 Heeft een lid een OTP key ja/nee
// (LET OP: authenticatie op basis van hccLidnr, JoomlaToken en siteID)
// hccLidnummer is het lidnummer waar de aanvraag op moet worden uitgevoerd.
// Dat kan alleen als de aanvrager HCC#LAD of HN#WM als rol heeft
$request = xmlrpc_encode_request(
'HeeftOtpKey',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccLidnummer' => $hccLidnummer,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'HeeftOtpKey',
'Status' => 'TRUE',
'HeeftOtpKey' => 'TRUE'|'FALSE',
'Message' => 'OTP status opgevraagd');
Output negatief:
$reply = array(
'Action' => 'HeeftOtpKey',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// 3.1 Geef mijn lidnummer
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'GeefMijnLidnummer',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'TRUE',
'Message' => 'Lidnummer opgevraagd',
'hccLidnr' => $hccLidnr);
Output negatief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.2 Controleer of de gebruikersnaam op dit moment bestaat
// (geen authenticatie)
// ** Deze gegevens worden opgevraagd bij hccnet.nl (action=3) **
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezeNaamNogBeschikbaar',
array(
'nieuw_hccLogin' => $nieuw_hccLogin,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Gebruikersnaam is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Gebruikersnaam bestaat al');

// ** Enkel voor gebruik vanaf de kantoor portal **
// ** t.b.v. het hernoemen van accounts in CRM **
// 8.3 Controleer of een Pseudoniem op dit moment bestaat ??? NIET GEBRUIKT ??
// (geen authenticatie)
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezePseudoniemNogBeschikbaar',
array(
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem));
Output positief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Pseudoniem is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Pseudoniem bestaat al');

// ** t.b.v. de verenigingszaken zoekpagina **
// A.1 Zoek alle bij de query passende hcc leden
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
$request = xmlrpc_encode_request(
'ZoekHCCLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Groepering' => $Groepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (eerste deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| emailadres | (eerste deel van) e-mail adres |
| gebruikersnaam | (eerste deel van) de login naam |
| pseudoniem | (eerste deel van) het pseudoniem |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| niet_leden | het volledige niet-lid lidnummer |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'ZoekMethode' => $ZoekMethode,
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' => array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'sn' => $sn,
'givenName' => $givenName,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccHuisToevoeging' => $hcchuisToevoeging,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'ProfielBekend' => 'TRUE' | 'FALSE'])*);
Output negatief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. beheer.hcc.nl **
// A.3 Zoek alle bij de query passende hcc leden van deze groepering
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'ZoekGroeperingsLid',
array(
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Groepering' => $groepering,
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Bijeenkomst' => $Bijeenkomst,] // Alleen voor gebruik op de
// bijeenkomsten aanwezigheidsregistratie pagina
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| nieuwe_leden | YYYYMMDD vanaf waar gezocht moet worden |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| kaderleden | n.v.t. |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' =>
[array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'cn' => $cn,
'sn' => $sn,
'givenName' => $givenName,
'hccAchternaam' => $hccAchternaam,
'hccTussenVoegsels => hccTussenVoegsels,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem)]*));
Output negatief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker(s) niet gevonden' | 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten **
// A.4 Lid bezoekt bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'LidBezoektBijeenkomst',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
'hccLidnr' => $hccLidnr, // lid dat aanwezig gemeld moet worden
['correctie' => $hccLidnr,] // lid dat gecorrigeerd moet worden
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'TRUE',
'Message' => 'Bezoeker weggeschreven',
'Results' => array(
// info van deze bezoeker
'cn' => $cn, // cn (Verbeek, H.J.)
'hccGeslacht' => $hccGeslacht, // hccGeslacht van de bezoeker
'groeperingslid' => $groeperingslid, // TRUE of FALSE: is deze persoon lid van deze groepering
'mijnGroeperingen' => $mijnGroeperingen, // komma-gescheiden lijst (regio, [hccIG]*)
'aantalBezoeken' => $aantalBezoeken, // hoe vaak heeft dit lid deze bijeenkomst bezocht
// info van de bijeenkomst
'AantalBezoekers' => $AantalBezoekers); // aantal bezoekers van deze bijeenkomst
Output negatief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.5 Vraag Lidgegevens token aan (geldig voor dit lid, en deze groepering, op deze datum)
// Als geen datum gegeven is, dan is het token vandaag geldig
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'VraagLidgegevensTokenAan',
array(
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'hccLidnr' => $hccLidnummer, // vraag het token voor dit lid aan
'groepering' => $groepering, // zoek binnen deze groepering
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'TRUE',
'Message' => 'Token opgevraagd',
'groepering' => $Groepering,
'token' => $token,
'sn' => $sn);
Output negatief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.6 Toon bezoekersoverzicht
// (authenticatie op basis van lidnummer en bezoekersregistratie token)
$request = xmlrpc_encode_request(
'GeefBezoekersOverzicht',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'token' => $token,
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'TRUE',
'Message' => 'Bezoekersoverzicht opgevraagd',
'Bezoekers' => $bezoekers,
['Locatie' => $Locatie]);
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// A.7 Geef het array met alle locaties
// (of beperk dit tot de locaties van de groepering $Groepering)
// Desgewenst worden alle resultaten waarbij hccToonInJoomla aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// Desgewenst worden alle resultaten waarbij ToonOpKaderNet aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocaties',
array(
['Groepering' => $hccGroepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']);
Output positief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);
Output negatief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'FALSE',
'Message' => 'Locaties niet beschikbaar',
'ExtraInfo' => 'Geen locaties gevonden voor groepering $hccGroepering',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);

// A.8 Registreer een niet-hcclid als bezoeker tijdens een bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'RegistreerGast',
array(
'AccountNaam' => $lidnr, // credentials
'AccountCode' => $AccountCode, // credentials
'token' => $token, // credentials
'Bijeenkomst' => $groepering,
'geslacht' => $geslacht,
'naam' => $naam,
'mail' => $mail,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'buitenland' => $buitenland,
['nietLidNummer' => $nietLidNummer,]
['instructies' => $instructies,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $aanroep,
'Status' => 'TRUE',
'Message' => 'Niet-lid als bezoeker geregistreerd',
'Result' => $result_array);

// A.9 Geef het array met alle locatienamen
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocatieNamen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']));
['KaderMutatieFilter' => '' | 'TRUE']));

Output positief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));
Output negatief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'FALSE',
'Message' => 'Locatienamen niet beschikbaar',
'ExtraInfo' => 'Geen locatienamen gevonden',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));

// A.10 Schrijf een niet-lid in op een bulletin
// (2019.12.05: wordt actief gebruikt in Joomla module)
// Deze aanroep mag *ook* worden gebruikt om een wel-lid in te schrijven.
// Voorwaarde is dat bewezen is dat er controle bestaat over het opgegeven email adres
$request = xmlrpc_encode_request(
'SchrijfNietlidInOpBulletin',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'hccOptin' => $hccOptin, // bulletin waarop ingeschreven wordt
'hccOptinSource' => $hccOptinSource, // site waar aanmelding vandaan komt
'Email' => $Email, // niet-lid: email adres
'Naam' => $Naam, // niet-lid: naam
['hccLidNummer' => $hccLidNummer,] // optioneel: ik ben lid, dit is mijn lidnummer
['Postcode' => $Postcode,] // optioneel: niet-lid: postcode
['Huisnummer' => $Huisnummer,] // optioneel: niet-lid: huisnummer
['hccGeslacht' => $hccGeslacht,] // optioneel: niet-lid: geslacht (M/V/O)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'TRUE',
'Message' => 'Inschrijving op bulletin gelukt');
Output negatief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist',
'ExtraInfo' => 'Invalid DN syntax' |
'Invalid credentials');

// ** t.b.v. Joomla module Bas
// A.12 GeefAlleBulletins
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleBulletins',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefAlleBulletins',
'Status' => 'TRUE',
'Message' => 'Bulletins opgevraagd',
'bulletins' => $bulletins);

// ** t.b.v. Joomla module Bas
// A.13 ExpandeerPostcode
// (geen authenticatie)
$request = xmlrpc_encode_request(
'ExpandeerPostcode',
array(
'postcode' => $postcode,
'huisnummer' => $huisnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'ExpandeerPostcode',
'Status' => 'TRUE',
'Message' => 'Postcode opgevraagd',
'detailgegevens' => $detailgegevens);

// ** t.b.v. Joomla module Bas
// A.25 UpdateNAW
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateNAW',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'geslacht' => $geslacht,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'toevoeging' => $toevoeging,
'straat' => $straat,
'woonplaats' => $woonplaats,
'landcode' => $landcode,
'email' => $email,
'voornaam' => $voornaam,
'voorletters' => $voorletters,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateNAW',
'Status' => 'TRUE',
'Message' => 'Contactgegevens bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.18 NormaliseerTelefoon
// (geen authenticatie)
$request = xmlrpc_encode_request(
'NormaliseerTelefoon',
array(
'hccLand' => $hccLand,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'NormaliseerTelefoon',
'Status' => 'TRUE',
'Message' => 'Telefoonnummer genormaliseerd',
'Telefoonnummer' => $Telefoonnummer);

// ** t.b.v. Joomla module Bas
// A.20 UpdateMobiel
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateMobiel',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateMobiel',
'Status' => 'TRUE',
'Message' => 'Mobiel nummer bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.21 HaalIGBedragenOp
// Geef alle IG's waar je zelf lid van kunt worden, inclusief het bijbehorende bedrag
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalIGBedragenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalIGBedragenOp',
'Status' => 'TRUE',
'Message' => 'Interessegroepen en bedragen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.22 HaalTariefGroepenOp
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalTariefGroepenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalTariefGroepenOp',
'Status' => 'TRUE',
'Message' => 'Tariefgroepen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.23 PasInteressegroepAan
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasInteressegroepAan',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
['nieuw' => $IG_lijst_nieuw,]
['weg' => $IG_lijst_weg,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'PasInteressegroepAan',
'Status' => 'TRUE',
'Message' => 'IG keuzen aangepast');

// ** t.b.v. Joomla module Bas
// A.24 GeefSSOUrls
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefSSOUrls',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefSSOUrls',
'Status' => 'TRUE',
'SSO_urls' => $sso_urls,
'Message' => 'Single Sign On URLs opgevraagd');

// ** t.b.v. de verenigingszaken beheer pagina **
// A.26 Verwijder een niet-lid record
$request = xmlrpc_encode_request(
'VerwijderNietLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'hccLidnr' => $hccLidnummer, // het te verwijderen niet-lid nummer
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

Output positief:
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'TRUE',
'Message' => 'Niet-lid record verwijderd',

Output negatief:
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'FALSE',
'Message' => 'Niet-lid record niet gevonden');
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** HenZ **
// ** t.b.v. daily cron job **
// ** t.b.v. dagelijkse opschoon jobs Joomla template sites **
// C.1 Vraag de lijst met uitgeschreven leden op
// Dit kan beperkt worden tot een bepaalde regio of interessegroep
// Daarnaast kan het tijdvak waarin gezocht wordt vrij gekozen worden
// (gesteld dat de LDAP database nog leden uit die periode bevat)
// Antwoord: lijst met (lidnummer, hccLogin, sn,
// datum einde lidmaatschap (formaat:YYYYMMDD))

==> GeefUitgeschrevenLeden <== (oud: GeefOpgezegdeLeden)

$request = xmlrpc_encode_request(
'GeefUitgeschrevenLeden',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccRegio' => $hccRegio, // of leeg
'hccIg' => $hccIg, // of leeg
'datum_vanaf' => $datum_sinds, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: 3 dagen geleden)
'datum_tot' => $datum_tot, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: vandaag)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'TRUE',
'Message' => 'Uitgeschreven leden',
['hccRegio' => $hccRegio,]
['hccIg' => $hccIg,]
['datum_vanaf' => $datum_vanaf,]
['datum_tot' => $datum_tot,]
['Results' => array(
[array(
'hccLogin' => $hccLogin,
'hccLidNummer' => $hccLidnummer,
'sn' => $sn,
'DatumEindeLidmaatschap' => $DatumEindeLidmaatschap)]*);
Output negatief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');
</pre>

=== HCCpartner aanroepen ===
(interface versie 1) 
(oude interface, niet meer gebruiken!)

<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.1 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartner',
array('ControleerHCCLidmaatschap',
array('partnerLogin', $partnerLogin),
array('partnerPassword', $partnerPassword),
array('hccLidnummer', $hcclidnummer),
array('postcode', $postcode)));
Output positief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'TRUE'));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'));
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'),
array('Message', 'Onjuiste credentials'));

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartner',
array(
'OnbekendeAanroep',
array('parameter', $iets)));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'OnbekendeAanroep'),
array('Status', 'FALSE'),
array('Message', 'Opdracht onbekend'));
</pre>

=== HCCpartners aanroepen ===
(interface versie 2)

<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.2 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'ControleerHCCLidmaatschap',
'partnerLogin' => $partnerLogin,
'partnerPassword' => $partnerPassword,
'hccLidnummer' => $hcclidnummer,
'postcode' => $postcode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'TRUE',
['ExtraInfo' => 'groepering=$groepering']); // als de partner beperkt is tot 1 groepering
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE');
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'OnbekendeAanroep',
'parameter' => $iets));
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'OnbekendeAanroep',
'Status' => 'FALSE',
'Message' => 'Opdracht onbekend');
</pre>

=== HCC-kader aanroepen ===

<pre>
// ** beheer.hcc.nl **
// F.2 Controleer of dit een kaderlid is
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'IsKaderLid',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'TRUE',
'Message' => 'Is kaderlid',
'hccLidnr' => $hccLidnr,
'cn' => $cn,
'sn' => $sn,
'hccRol' => $hccRol,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward);
Output negatief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Is geen kaderlid');

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.4 Vraag alle groeperingen op
// Het is mogelijk om een groepering te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// ToonInOverzichtenFilter : attribuut 'hccToonInOverzichten'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// BulletinsFilter : attribuut 'hccBulletins'
// EmailFilter : attribuut 'hccFunctionalEmail'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleGroeperingen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['ToonInOverzichtenFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['BulletinsFilter' => '' | 'TRUE',]
['EmailFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE'));
Output positief:
$reply = array(
'Action' => 'GeefAlleGroeperingen',
'Status' => 'TRUE',
'Message' => 'Lijst met groeperingen opgevraagd',
'Result' => $groeperingen,
['JoomlaFilter' => 'TRUE',]
['ToonInOverzichtenFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']);

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.5 Vraag alle kaderrollen op
// Het is mogelijk om een kaderrol te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleKaderRollen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']));
Output positief:
$reply = array(
'Action' => 'GeefAlleKaderRollen',
'Status' => 'TRUE',
'Message' => 'Lijst met kaderrollen opgevraagd',
'Result' => $kaderrollen,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']);

// ** t.b.v. de kantoor-beheerpagina **
// F.9 Geef de gevevens van de mailbox van dit kaderlid
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
$request = xmlrpc_encode_request(
'GeefKadermailGegevens',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer));
Output positief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'kadermail_omvang' => $Formaat,
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald);
Output negatief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid'));

// ** t.b.v. de Joomla Kadernet module **
// * F.10 MuteerGroeperingSamenstelling
// (authenticatie op basis van lidnummer, JoomlaToken en siteID en als extra hccCode van de aanvrager)
$request = xmlrpc_encode_request(
'MuteerGroeperingSamenstelling',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccCode' => $hccCode,
'groepering' => $groepering,
'hccLidnummer => $hccLidnummer, // lidnummer van het te muteren hcc lid
'hccRol' => $hccRol, // de nieuwe dan wel op te heffen rol
// de rol 'ALLES_WEG' ruimt alle rollen van dit hcc lid voor deze groepering op
'actie' => 'Nieuw' | 'Weg',
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress,]
Output positief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'TRUE',
'Message' => 'Groepering samenstelling aangepast',
['ExtraInfo' => 'Bedankmail gestuuurd aan ex-kaderlid']);
Output negatief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid' |
'Oude rol niet gevonden' |
'Nieuwe rol kan niet samen met bestaande rol' |
'Alleen voorzitter of secretaris kan kadermutaties uitvoeren']);
</pre>

=== HCC-groepering aanroepen ===

<pre>
// I.2 controleer of een gebruiker bestaat op basis van de combinatie
// lidnummer + postcode + huisnummer
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
// (alternatieve authenticatie mogelijk door lidnummer + hcc-code in te vullen)
//
// Aan de aanroeper worden zekere eisen gesteld:
// * dient een rol te vervullen binnen de groepering 'FOR'(forum)
// * dan wel dient de rol 'VRBK' (vraagbaak) te vervullen binnen een groepering
//
// Er wordt door de gehele leden-database gezocht, waarna terug wordt gegeven
// * of dit hcc lid inderdaad bestaat
// en, als het om een aanvraag van een vraagbaak vrijwilliger gaat,
// * tevens of het gezochte hcc lid deel uitmaakt van zijn groepering
//
// 2021.12 Mocht weg: laatste aanroep 2018.07.27
// Toch weer terug: 2022.03.23 (OTOBO ticket 2022032394001082)
//
$request = xmlrpc_encode_request(
'IsHCCLid',
array(
'hccLogin' => [$hccLogin | $hccLidnummer],
'userPassword' => [$userPassword | $hccCode],
'zoekhccLidnr' => $zoekhccLidnr,
'zoekhccPostcode' => $zoekhccPostcode,
'zoekhccHuisnr' => $zoekhccHuisnr,
'zoekgroepering' => $zoekgroepering));
Output positief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gecontroleerd',
['Groeperingslid' => $IsGroeperingLid]));
Output negatief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker bestaat niet' |
'Onjuiste credentials' |
'Wel HCC lid, maar geen lid van groepering $groepering' |
'Onvoldoende rechten' |
'Vul alle verplichte velden in!'));
</pre>

=== HenZ aanroepen ===

<pre>
// I.3 Geef de einddatum van een actief dan wel uitgeschreven lid
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'GeefhccEindDatum',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'TRUE',
'hccLidnummer' => $hccLidnummer,
'hccLogin' => $hccLogin,
'hccEindDatum' => $hccEindDatum ('yyyymmdd' | ''));
Output negatief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Invalid credentials' |
'Lidnummer niet gevonden');
</pre>

=== (Forum,vraagbaak) onderwerpen ===

<pre>
// L.1 MaakOnderwerp
$request = xmlrpc_encode_request(
'MaakOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'description' => $description,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp is aangemaakt',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster');

// L.2 VerwijderOnderwerp

$request = xmlrpc_encode_request(
'VerwijderOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'TRUE',
'onderwerp' => $onderwerpID,
'Message' => 'Onderwerp is verwijderd',
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Ruim eerst alle geautoriseerde gebruikers op' |
'Kan onderwerp niet verwijderen');

// L.3 GeefOnderwerpen
// Geef het array met de lijst van onderwerpen voor de betreffende groepering
//
$request = xmlrpc_encode_request(
'GeefOnderwerpen',
array(
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'TRUE',
'Message' => 'Onderwerpen opgevraagd',
'onderwerpen' => $onderwerpen); // het array met onderwerpen
Output negatief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!');

// L.4 MuteerOnderwerp
// Pas de description van een onderwerp aan
//
$request = xmlrpc_encode_request(
'MuteerOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'description' => $description,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp aangepast',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Onderwerp behoort bij andere groepering');

// L.5 MuteerOnderwerpAutorisatie
// Geef kaderlid $kaderLidNr de autorisatie MOD, VRBK of RED bij onderwerp $onderwerp
// (of haal die autorisatie weg)
$request = xmlrpc_encode_request(
'MuteerOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'onderwerp' => $onderwerpID,
'kaderLidNr' => $kaderLidNr,
'hccAutorisatie' => 'MOD' | 'VRBK' | 'RED',
['verwijder' => 'TRUE']));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Onderwerp autorisatie aangepast');
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Geen kaderlid' |
'Onjuiste autorisatie opgegeven' |
'Onderwerp bestaat niet');

// L.6 ToonOnderwerpAutorisatie
$request = xmlrpc_encode_request(
'ToonOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Autorisaties opgehaald',
'onderwerp' => $onderwerpID,
'description' => $description,
'autorisaties' =>
[Array(
'hccLidnummer' => $hccLidnummer
'cn' => $cn
'hccAutorisatie' => {komma-gescheiden autorisaties})]);
Output negatief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet');
</pre>

=== Microsoft Dynamics Cloud (Cayentis) onderwerpen ===

<pre>
// M.1 Upload_CSV_bestand
// De CRM proxy upload de dagelijkse CSV synchronisatie-bestanden naar de XML-RPC server
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Upload_CSV_bestand',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'CSV_bestand_type' => '1' | '2' | '3' , // 1=Contactpersonen/Hoofdlidmaatschappen
// 2=Gremiumlidmaatschap codes
// 3=Gremiumlidmaatschappen
'CSV_bestand' => $CSV_bestand)); // het CSV bestand (base64 encoded)
Output positief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'TRUE',
'Message' => 'Bestand opgeslagen');
Output negatief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.2 SchrijfNieuwLidIn
//
// Maak in het CRM een nieuw HCC lid aan
// De NAW gegevens worden in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'SchrijfNieuwLidIn',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'NAWgegevens' => $NAW_Array,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress);
// $NAW_array = array(
// 'GeboorteDatum' => $geboortedatum,
// 'Geslacht' => $geslacht,
// 'Voornaam' => $voornaam,
// 'Voorletters' => $voorletters,
// 'Tussenvoegsel' => $tussenvoegsel,
// 'Achternaam' => $achternaam,
// 'Straatnaam' => $straatnaam,
// 'Huisnummer' => $huisnummer,
// 'HuisnummerToevoeging' => $huisnummertoevoeging,
// 'Woonplaats' => $woonplaats,
// 'Postcode' => $postcode,
// 'Land' => $land,
// 'Telefoonnummer' => $telefoonnummer,
// 'MobielNummer' => $mobielnummer,
// 'Mail' => $mail,
// 'IBAN' => $IBAN,
// 'Interessegroep' => $IGs, // komma-gescheiden lijst met IG's
// 'Geschenk' => $geschenk,
// 'Actiecode' => $actiecode,
// 'Voorwaarden' => $Akkoord); // 'Akkoord'
)
Output positief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'TRUE',
'Message' => 'nieuw lid ingeschreven',
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode);
Output negatief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.3 Verwerk_JSON_mutatie
// De CRM proxy kan NAW en/of IG mutaties en/of hccCode mutaties live doorgeven
// Deze gegevens worden in JSON in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Verwerk_JSON_mutatie',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'mutatie_type' => '1' | '2', // 1=Contactpersoon/Hoofdlidmaatschap
// 2=Gremiumlidmaatschap
'JSON_mutatie' => $JSON_mutatie)); // de JSON payload
Output positief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'TRUE',
'Message' => 'Mutatie verwerkt');
Output negatief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.4 Vertaal landcode
// Het CRM werkt met numerieke landcodes, wij met cijfers
// Vertaal die
// Er moet in de aanroep 1 veld aanwezig zijn, beide waarden komen in het antwoord terug
$request = xmlrpc_encode_request(
'ISO_landcode',
array(
['ISO_numeriek' => $ISO_numeriek,]
['ISO_code ' => $ISO_code]));
Output positief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'TRUE',
'Message' => 'ISO code lookup geslaagd',
'ISO_numeriek' => $ISO_numeriek,
'ISO_code ' => $ISO_code,
'ISO_benaming' => $ISO_benaming); // de descriptive name van deze ISO code
Output negatief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'FALSE',
'Message' => 'Kan geen bijpassende vertaling vinden'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.5 MuteerAanmeldingsformulier
// Sla een JSON veld op in de XML-RPC server zodat deze weer opgehaald kan worden door de websites
// Authenticatie op basis van hccLidnummer en JoomlaToken
// Deze mutaties mogen alleen door HN#WM of SITE#WM gedaan worden.

$request = xmlrpc_encode_request(
'MuteerAanmeldingsformulier',
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
'formulierdata' => $formulierdata, // JSON veld met alle gegevens voor het aanmeld formulier
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress ));
Output positief:
$reply = array(
'Action' => 'MuteerAanmeldingsformulier',
'Status' => 'TRUE',
'Message' => 'aanmeldingsformulier bijgewerkt';

// M.6 HaalAanmeldingsformulier
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalAanmeldingsformulier',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalAanmeldingsformulier',
'Status' => 'TRUE',
'formulierdata' => $formulierdata); // JSON veld met alle gegevens voor het aanmeld formulier

// M.7 GeefFactuurOverzicht
// (authenticatie op basis van hccLidnummer + JoomlaToken + siteID
$request = xmlrpc_encode_request(
'GeefFactuurOverzicht',
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefFactuurOverzicht',
'Status' => 'TRUE',
'FactuurOverzicht' => $FactuurOverzicht);
// $FactuurOverzicht =
// array(
// array(
// 'FactuurID' => 'a5b93460-4536-ea11-a813-000d3a2c53fa',
// 'FactuurNummer' => '200118673J5'
// 'FactuurDatum' => '2020-01-15'
// 'bedrag' => 42.37
// 'BetaalStatus' => 0]));
// )

// M.8 HaalFactuur
// (authenticatie op basis van JoomlaToken of FactuurToken)
$request = xmlrpc_encode_request(
'HaalFactuur',
array(
'hccLidnummer' => $hccLidnummer,
['JoomlaToken' => $JoomlaToken,]
['FactuurToken' => $FactuurToken,]
'FactuurNummer' => $FactuurNummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalFactuur',
'Status' => 'TRUE',
'factuur' => $factuurgegevens);
// $factuurgegevens =
// array(
// 'FactuurNummer' => $FactuurNummer,
// 'FactuurDatum' => $FactuurDatum,
// 'FactuurID' => $FactuurID,
// 'Bestandsnaam' => $Bestandsnaam,
// 'PDF' => $PDF) // base64 encoded PDF
</pre>

=== Echo test ===

<pre>

// t.b.v. controle of de verbinding met de XML-RPC server functioneert
// Eenvoudige echo test

$request = xmlrpc_encode_request(
'echo',
array(
'What' => $string,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'echo',
'Status' => 'TRUE',
'Message' => $string);
</pre>

=== HenZ XML-RPC interface ===

Overzicht van XML-RPC procedures die bij HenZ draaien
(worden via de Hobbynet XML-RPC server afgehandeld)

<pre>
- Action=2
wijzig gebruikersnaam en wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=3
controleer of een gebruikersnaam bestaat
(XML-RPC server voert de hccnet XML-call uit, zie 8.2)

- Action=4
creer een nieuwe gebruiker. Per lidnummer is er 1 account. Als er al een
account voor dit lidnummer bestaat wordt het bestaande account hernoemd.
(XML-RPC server voert de hccnet XML-call uit, zie 8.1)

- Action=5
wijzig wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=7
Uitgeschreven lid is weer actief lid geworden
(Wordt aangeroepen vanuit de cronjob)

- Action=8
Lid heeft een nieuwe hcc-code gekregen
(Wordt aangeroepen vanuit de cronjob)
</pre>

=== Release notes ===
<pre>
2012.02.08 Wijzigingen versie 5:
- 4.1 verwijder_hcc_Lidnummer i.p.v. hcc_Lidnummer
- 4.1 optionele extra parameter verwijder_hccLogin
- Optionele parameters aangegeven
- Vanwege de duidelijkheid de beheerLogin en beheerPassword velden
bovenin de betreffende aanroepen gezet
(De volgorde van de parameters is niet relevant, dus dit is geen
interface-aanpassing)
2012.02.16 Wijzigingen versie 6:
- 2.1/2.2/2.3 geef ook cn en sn terug na aanpassen van het wachtwoord
- 3.1 geef cn en sn terug na aanmaken nieuwe gebruiker
2012.02.27 Wijzigingen versie 7:
- Neem de XML-RPC interface van HenZ in deze XML-RPC server op
8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gegevens tevens in LDAP op
- 2.1 wijzig wachtwoord - optie 1
* Nieuw wachtwoord is verplicht, niet optioneel
* wijzigingen worden naar hccnet.nl doorgezet
- 2.2 wijzig wachtwoord, optie 2
* Nieuw wachtwoord is verplicht, niet optioneel
* gebruikersnaam kan niet meer via deze interface aangepast worden
* wijzigingen worden naar hccnet.nl doorgezet
- 2.3 wijzig wachtwoord, optie 3
* wijzigingen worden naar hccnet.nl doorgezet
2012.03.26 Wijzigingen versie 8:
- Breidt de XML-RPC interface van HenZ in deze XML-RPC server uit met
8.2 Controleer of de gebruikersnaam op dit moment bestaat
2012.04.09 Wijzigingen versie 9:
- Vervang alle 'ldap' aanroepen door 'HCCldap' aanroepen
- documentatie van HenZ call action=2 aangepast, action=5 toegevoegd
2012.05.03 Wijzigingen versie 10:
- 1.1 / 1.2 / 1.3 geven nu ook 'ProfielBekend' terug om uniek te bepalen
of deze bezoeker een first-time-login pagina te zien dient te krijgen
- documentatie van 2.1 (wijzig wachtwoord) aangepast:
2.1 kan alleen als profiel is doorlopen
- nieuwe procedure t.b.v. zoekscherm PC30
* A.1 ZoekHCCLid
- hiervoor is de database met diverse velden uitgebreid
(postcode, e-mailadres, huisadres, woonplaats, land, telefoonnummer)
Dit heeft impact op diverse andere procedures (t.b.s.)
- nieuwe procedure t.b.v. 'gewone' profielpagina
* B.1 GeefDBFPersoonID
- nieuwe procedure t.b.v. cron-job
* C.1 GeefOpgezegdeLeden
2012.05.10 Wijzigingen versie 11
- 1.3 GebruikerBestaatControle
* nieuwe parameter: hccPseudoniem
* nieuw veld in antwoord: hccPseudoniem
- 2.3 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 2.4 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 3.1 NieuweGebruiker
* nieuwe parameter: hccPseudoniem
- 8.1 MaakGebruikerAan
* nieuwe parameter: nieuw_hccPseudoniem
* alle parameters zijn verplicht (niet langer optioneel)
* nieuw antwoord: Gegevenscombinatie onjuist
- 8.3 IsDezePseudoniemNogBeschikbaar
* Nieuwe procedure t.b.v. 1e keer doorlopen profielpagina
- A.1 ZoekHCCLid
* 'Zoeklimiet bereikt' wordt als ExtraInfo meegegeven
* nieuwe velden in antwoord: hccPseudoniem en hccLogin
- B.1 GeefDBFPersoonID
* Zoeken kan nu ook op hccLogin en op hccPseudoniem
- C.1 GeefOpgezegdeLeden
* Geef nu ook hccLogin en hccPseudoniem terug
2012.05.14 Wijzigingen versie 12
- 1.x GebruikerBestaatControle
* Geef ook DBFPersoonID terug
- 4.1 Gooi een gebruiker weg.
* Haal ongebruikte parameter hccLogin weg
- 5.1 Wijzig hccIG
* Haal ongebruikte parameter hccLogin weg
- 6.1 Wijzig hccRegio
* Haal ongebruikte parameter hccLogin weg
- 7.1 Wijzig hccRol
* Haal ongebruikte parameter hccLogin weg
2012.05.20 Wijzigingen versie 13
- A.1 ZoekHCCLid
* Geef resultaten gestructureerder formaat
* Geef in ExtraInfo weer hoeveel echte resultaten er gevonden zijn
- C.1 GeefOpgezegdeLeden
* Geef resultaten in gestructureerder formaat
2012.06.03 Wijzigingen versie 14
- 3.1 NieuweGebruiker
* Geef ook DBFPersoonID mee
2012.08.17 Wijzigingen versie 15
- C.1 GeefOpgezegdeLeden
* Geef ook hccLogin in het antwoord terug
- D.1 HCCpartner/ControleerHCCLidmaatschap
* Nieuwe aanroep
2012.09.29 Wijzigingen versie 16
- Alle cron gerelateerde opdrachten verwijderd
* 3.1 NieuweGebruiker
* 4.1 GooiGebruikerWeg
* 5.1 WijzigHccIG
* 6.1 WijzigHccRegio
* 7.1 WijzigHccRol
2012.10.28 Wijzigingen versie 17
- nieuwe procedure t.b.v. PC30 beheerpagina
* A.2 HaalPC30Token
- nieuwe procedure t.b.v. Drupal profielpagina
* 2.4 vervallen
(WijzigGebruikersGegevens op basis van pseudoniem)
* 2.5 WijzigGebruikersGegevens
Nieuwe keuze: wijzig pseudoniem
2012.11.14 Wijzigingen versie 18
- 1.x GebruikerBestaatControle
* Geef ook mail in het antwoord terug
2012.11.30 Wijzigingen versie 19
- E.1 HCCkader/WijzigGebruikersGegevens
* Nieuwe aanroep
- F.1 / F.2 / F.3 ControleerKaderlid
* Nieuwe aanroep
2012.12.18 Wijzigingen versie 20
- Haal DBFPersoonID weg uit alle aanroepen en alle resultaten
* Antwoord van 1.x GebruikerBestaatControle
* B.1 GeefDBFPersoonID opgeheven
- A.1 ZoekHCCLid geeft nu ook hccMobiel terug (t.b.v. PC30 zoekpagina)
- C.1 GeefOpgezegdeLeden verder uitgewerkt:
* Geeft alleen de door Drupal gebruikte velden 'hccLogin' en 'hccEindDatum'
terug in het antwoord
* Geeft nu 'echte' antwoorden i.p.v. dummy resultaten
- F.1 ControleerKaderlid geeft nu ook optioneel 'sn' en 'givenName'
terug (in de beheer-variant)
2013.01.25 Wijzigingen versie 21
- A.1 ZoekHCCLid uitgebreid
* Geeft nu ook hccBeginDatum, hccEindDatum en hccRol terug
2013.02.02 Wijzigingen versie 22
- A.1 ZoekHCCLid
* Interface aangepast
- A.3 ZoekGroeperingsLid
* Nieuwe aanroep
- F.4 GeefAlleGroeperingen
* Nieuwe aanroep
- F.5 GeefAlleKaderRollen
* Nieuwe aanroep
2013.03.01 Wijzigingen versie 23
- A.3 ZoekGroeperingsLid
* Geeft andere resultaten terug
- 2.2 WijzigWachtwoord
* Geeft nu ook hccLogin terug (voor ww-vergeten op de Drupal site)
- HCCenquete implementatie
* G.1 Expandeer NL postcode
* G.2 Haal lidgegevens op
* G.3 Pas lidgegevens aan
2013.03.18 Wijzigingen versie 24
- ZoekGroeperingsLid op basis van token
- A.4 Lid bezoekt bijeenkomst
* nieuwe aanroep
- A.5 VraagLidgegevensTokenAan
* nieuwe aanroep
2013.04.07 Wijzigingen versie 25
- D.1 HCCpartner/ControleerHCCLidmaatschap
Simpeler interface ontwikkeld ('HCCpartners' i.p.v. 'HCCpartner')
- G.3 mag ook Tussenvoegsels aanpassen
2013.04.25 Wijzigingen versie 26
- H.1 HCC-groepering / GebruikerBestaatControle
Nieuwe interface voor validatie vanaf groeperings websites
2013.05.03 Wijzigingen versie 27
- 2.6 HaalOptInKeuzen
* nieuwe aanroep
- 2.7 SchrijfOptInKeuzen
* nieuwe aanroep
- 2.8 HaalOptInLijst
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* nieuwe aanroep
- HCCpartners aanroep nieuwe interface ('Action' => 'ControleerHCCLidmaatschap')
2013.07.05 Wijzigingen versie 28
- 8.1 MaakGebruikerAan
* extra parameters (mail, hccPseudoniem) in het antwoord
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra parameter (mailHccnet)
- A.1 ZoekHCCLid
* extra parameter (mailHccnet)
- A.3 ZoekGroeperingsLid
* extra parameter (mailHccnet)
2013.08.31 Wijzigingen versie 29
- F.1 / F.2 / F.3 HCC-kader / ControleerKaderlid
* extra output parameter (hccKaderMail)
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra output parameter (hccForumLogin)
- H.1 HCC-groepering / GebruikerBestaatControle
* komma-gescheiden lijst met groeperingen mogelijk
* extra output parameter (mailHccnet)
2013.12.26 Wijzigingen versie 30
- 3.1 Geef mijn lidnummer
* nieuwe aanroep
- A.1 ZoekHCCLid
* geef nu ook 'ProfielBekend' terug om aan de PC30 omgeving door te geven
dat het wachtwoord niet veranderd mag worden door PC30
- A.6 GeefBezoekersOverzicht
* geef nu ook 'Locatie' terug indien van toepassing
- A.7 GeefLocaties
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* parameters aangepast
* authenticatie op basis van hccLogin + userPassword of lidnummer + hcc-code
* geen algemene hcc-forum authenticatie meer mogelijk
- F.7 ControleerKaderlidGroep
* Nieuwe aanroep
2014.02.01 Wijzigingen versie 31
- A.8 RegistreerGast
* nieuwe aanroep
- H.2 MatchPostcodeMetRegio
* nieuwe aanroep
- nieuwe interface (losse, unieke aanroepen, niet meer gegroepeerd)
2014.09.27 Wijzigingen versie 32
- C.1 GeefOpgezegdeLeden hernoemd naar GeefUitgeschrevenLeden
- I.3 GeefhccEindDatum
* nieuwe aanroep
- Action=7 en Action=8 toegevoegd aan de HenZ interface
2014.12.12 Wijzigingen versie 33
- F.1 / F.2 / F.3 HCC-kader / IsKaderLid
* extra output parameter (mail, mailHccnet, hccKaderForward)
- F.8 HCC-kader / ZetKaderForward
* nieuwe aanroep
2015.05.06 Wijzigingen versie 34
- GeefMijnGegevens
* nieuwe aanroep
- ValideerPCActiveAbonnee
* vervallen
- 1.4 GebruikerBestaatControle
* extra output parameter (hccKaderForward)
- D.1 HCCpartner/ControleerHCCLidmaatschap
* optionele extra output parameter (ExtraInfo)
2015.09.27 Wijzigingen versie 35
- HeeftForumCredentials
* vervallen
2015.11.20 Wijzigingen versie 36
- SchrijfNietlidInOpBulletin
* nieuwe aanroep
2015.12.13 Wijzigingen versie 37
- serverID als optionele parameter
- SchrijfNietlidInOpBulletin
* Maak velden optioneel
2016.01.05 Wijzigingen versie 38
- A.7 GeefLocaties
* optionele parameter JoomlaFilter
- F.4 GeefAlleGroeperingen
* optionele parameter JoomlaFilter
- F.5 GeefAlleKaderRollen
* optionele parameter JoomlaFilter
2016.01.15 Wijzigingen versie 39
- H.3 GeefMijnGegevens
* geeft nu ook hccOptIn terug
* geeft nu ook JoomlaToken terug
- H.4 PasOptInKeuzeAan
* nieuwe aanroep
- SiteID en RemoteID als optionele parameter
2016.03.17 Wijzigingen versie 40
- H.5 ZoekKaderLeden
* nieuwe aanroep
2016.03.20 Wijzigingen versie 41
- ServerID, SiteID en RemoteID als optionele parameters bij alle aanroepen
- A.7 GeefLocaties
* optionele parameter KadernetFilter
- A.9 GeefLocatieNamen
* optionele parameter KadernetFilter
- F.4 GeefAlleGroeperingen
* optionele parameter KadernetFilter
- F.5 GeefAlleKaderRollen
* optionele parameter KadernetFilter
- F.6 WijzigHccRol
* vervallen
- F.7 IsGroeperingsKaderlid
* vervallen
- 8.3 IsDezePseudoniemNogBeschikbaar
* vervallen
- 2.7 SchrijfOptInKeuzen
* vervallen
- 2.5 WijzigGebruikersGegevens (hccPseudoniem)
* vervallen
- H.2 MatchPostcodeMetRegio
* vervallen
2016.04.02 Wijzigingen versie 42
- H.6 GeefMijnKaderDetails
* nieuwe aanroep
2016.07.03 Wijzigingen versie 43
- Ubuntu 16.04 aanpassingen (PHP versie 7) beschreven
2016.09.01 Wijzigingen versie 44
- H.5 ZoekKaderLeden
* extra parameter 'hccMobiel'
2016.10.13 Wijzigingen versie 45
- H.3 GeefMijnGegevens (dedecated Joomla aanroep)
* hccForumLogin weg als parameter
* Als het om een webmaster gaat, vul dan eventueel hccRegio of hccIG aan
met die groepering, ook als hij geen lid is van die groepering
- I.4 GebruikerBestaatControle
* hccForumLogin weg als parameter
2016.12.01 Wijzigingen versie 46
- 8.3 IsDezePseudoniemNogBeschikbaar teruggezet
2017.05.28 Wijzigingen versie 47
- H.7 GeefMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
- H.8 ZetMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
2017.09.01 Wijzigingen versie 48
- A.10 SchrijfNietlidInOpBulletin nu alleen voor 1 bulletin tegelijk
- 2.2 WijzigGebruikersGegevens (op basis van gebruikersnaam en wachtwoord)
is vervallen (was een oude Drupal aanroep)
- A.3 ZoekGroeperingsLid geeft ook hccKaderToonMobiel terug
- H.7 GeefMinimaleKaderGegevens geeft ook hccKaderToonMobiel terug
2017.11.14 Wijzigingen versie 49
- A.3 ZoekGroeperingsLid geeft geen hccKaderToonMobiel meer terug
- A.3 ZoekGroeperingsLid geeft alleen hccMobiel als hccKaderToonMobiel dat toestaat
2018.02.18 Wijzigingen versie 50
- H.6 GeefMijnKaderDetails geeft ook hccKaderToonMobiel terug
- H.9 PasKaderGegevensAan
* nieuwe aanroep
- H.3 GeefMijnGegevens geeft 3 extra parameters terug (hccKaderMail, hccKaderForward,
hccKaderToonMobiel)
- JoomlaTokens worden gevalideerd op siteID, niet langer op serverID
- diverse aanroepen kunnen nu ook via de bezoekersregistratie-proxy aangeroepen worden.
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
(GeefAlleGroeperingen, GeefAlleKaderRollen, GeefLocaties, GeefLocatieNamen)
De bezoekersregistratie aanroepen hebben enkel JoomlaToken als extra parameter nodig:
(LidBezoektBijeenkomst, GeefBezoekersOverzicht)
2018.02.26 Wijzigingen versie 51
- H.3 GeefMijnGegevens geeft extra parameter hccMobiel terug
- H.9 PasKaderGegevensAan kan nu ook kadermail password aanpassen
- K.1 ValideerToken
* nieuwe aanroep
- K.2 ValideerHCCCode
* nieuwe aanroep
2018.03.17 Wijzigingen versie 52
- H.3 Haal al mijn gegevens
Extra optie 'compact' om alleen essentiele resultaten te verkrijgen
(t.b.v. de Android bezoekersregistratie applicatie)
2018.03.25 Wijzigingen versie 53
- I.2 IsHCCLid
(Oude aanroep teruggezet, wordt nog in vraagbaak module gebruikt)
2018.07.01 Wijzigingen versie 54
* A.1 beheer authenticatie op basis van lidnummer + hccCode (tbv VZ-portal)
* A.2 HaalPC30Token weggehaald
2018.08.22 Wijzigingen versie 55
* 1.2 GebruikerBestaatControle' (op basis van hccLogin en userPassword) weggehaald
* 1.4 GebruikerBestaatControle' (op basis van zoekHccLogin of zoekHccLidnr) weggehaald
* 2.8 HaalOptInLijst weggehaald
* E.1 PasKaderWachtwoordAan weggehaald
* F.1 IsKaderLid (op basis van hccLidnr en hccCode) weggehaald
* F.3 IsKaderLid (op basis van beheerdernaam en beheerderwachtwoord) was al weg
* F.8 ZetKaderForward weggehaald
* H.1 IsGroeperingsLid weggehaald
* H.6 GeefMijnKaderDetails weggehaald
* H.7 GeefMinimaleKaderGegevens weggehaald
* H.8 ZetMinimaleKaderGegevens weggehaald
* K.1 ValideerHCCCode weggehaald
* K.2 ValideerToken weggehaald
* H.3 GeefMijnGegevens geeft omvang kader mailbox mee terug
2018.11.06 Wijzigingen versie 56
Nieuwe aanroepen t.b.v. forum en vraagbaak autorisaties
* L.1 MaakOnderwerp
* L.2 VerwijderOnderwerp
* L.3 GeefOnderwerpen
* L.4 MuteerOnderwerp
* L.5 MuteerOnderwerpAutorisatie
* L.6 ToonOnderwerpAutorisatie
* H.5 ZoekKaderLeden heeft compact optie
2018.11.16 Wijzigingen versie 57
* L.5 MuteerOnderwerpAutorisatie kent nu ook RED(acteur)
2018.12.17 Wijzigingen versie 58
* A.11 GeefBezoekersAantallen (nieuwe aanroep)
* H.10 PasUserWachtwoordAan (nieuwe aanroep)
2019.02.21 Wijzigingen versie 59
* A. 6 GeefBezoekersOverzicht geeft enkel lijst van bezoekers laatste bijeenkomst
2019.10.26 Wijzigingen versie 60
* A.4 Schrijf bezoekers niet meer automatisch in op bulletins
* H.4 PasOptInKeuzeAan kan ook door LA aangeroepen worden
Nieuwe aanroepen t.b.v. eigen implementatie van mijn.hcc.nl in de Joomla modules
* H.11 PasPseudoniemAan
* H.12 ValideerWachtwoordEisen
* H.13 PasWachtwoordAan (1: op JoomlaToken, 2: op PWResetToken)
* H.14 MaakPWResetToken
* H.15 ValideerPWResetToken
* H.16 RuimJoomlaTokenOp
* A.12 GeefAlleBulletins
* A.13 ExpandeerPostcode
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.18 NormaliseerTelefoon
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
* A.21 HaalIGBedragenOp
* A.22 HaalTariefGroepenOp
* A.23 PasInteressegroepAan
* F.10 MuteerGroeperingSamenstelling
* A.24 GeefSSOUrls
Aanpassingen gemaakt aan
8.1 MaakGebruikerAan
F.5 GeefAlleKaderRollen
2020.01.04 Wijzigingen versie 61
Nieuwe aanroepen t.b.v. IDEAL betaling hobbynet abonnees
H.17 GeefAantalDomeinen
2020.01.06 Wijzigingen versie 62
Nieuwe aanroepen t.b.v. Cayentis (CRM webproxy) implementatie
* M.1 Upload_CSV_bestand
* M.2 SchrijfNieuwLidIn
* M.3 Verwerk_JSON_mutatie
* M.4 ISO_landcode
* M.5 MuteerAanmeldingsformulier
* M.6 HaalAanmeldingsformulier
* M.7 GeefFactuurOverzicht
* M.8 HaalFactuur
* A.25 UpdateNAW
Vervallen aanroepen
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
Aangepaste aanroepen
* A.23 PasInteressegroepAan
2020.03.27 Wijzigingen versie 63
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.18 ResetHCCCode
* H.19 PasHccLoginAan
2020.04.10 Wijzigingen versie 64
Nieuwe aanroepen
* A.26 VerwijderNietLid
Aanpassingen gemaakt aan
* A.1 ZoekHCCLid: nieuwe zoekoptie 'niet_leden'
Opnieuw geimplementeerd
* A.20 UpdateMobiel
2020.11.26 Wijzigingen versie 65
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.20 MaakTestLogin
Aanpassingen gemaakt aan
- H.3 GeefMijnGegevens: optionele parameter 'hccGroepering'
Het werken met een testaccount heeft impact op de volgende aanroepen:
- G.7 GeefFactuurOverzicht
- M.8 HaalFactuur
- L.1 MaakOnderwerp
- H.14 MaakPWResetToken
- F.10 MuteerGroeperingSamenstelling
- L.4 MuteerOnderwerp
- L.5 MuteerOnderwerpAutorisatie
- H.19 PasHccLoginAan
- A.23 PasInteressegroepAan
- H.9 PasKaderGegevensAan
- H.4 PasOptInKeuzeAan
- H.11 PasPseudoniemAan
- H.13 PasWachtwoordAan
- H.18 ResetHCCCode
- A.20 UpdateMobiel
- A.25 UpdateNAW
- L.2 VerwijderOnderwerp
- A.5 VraagLidgegevensTokenAan
- 2.1 WijzigGebruikersGegevens
- H.3 GeefMijnGegevens geeft extra parameter terug (testaccount)
2021.08.01 Wijzigingen versie 66
Aanpassingen gemaakt aan
- H.4 PasOptInKeuzeAan werkt nu ook op basis van OptOutToken
2021.10.10 Wijzigingen versie 67
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
- H.21 UpdateOTP
Aanpassingen gemaakt aan
- H.3 GeefMijnGegevens geeft extra parameters terug (hccOtpKey en hccOtep)
2021.10.13 Wijzigingen versie 68
Aanpassingen gemaakt aan
- H.21 UpdateOTP
2021.11.03 Wijzigingen versie 69
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
- H.22 HeeftOtpKey
2021.12.24 Wijzigingen versie 70
Vervallen aanroepen
- A.11 GeefBezoekersAantallen (laatste aanroep 2018.12.15)
- I.2 IsHCCLid (vraagbaak module al minstens 2 jaar niet meer gebruikt)
- 2.6 HaalOptInKeuzen (niet meer in gebruik sinds 2020.03.01)
2022.03.24 Wijzigingen versie 71
- I.2 IsHCCLid
(Oude aanroep teruggezet, Esther vraagt opnieuw om deze functionaliteit tbv vraagbaak, ticket 2022032394001082)
</pre>

= Aanpassingen aan de Apache omgeving =

== Apache modules (PHP 8) ==
Ubuntu 20.04 wordt standaard met PHP versie 7.0 uitgeleverd.

In /etc/apt/sources.list.d/ondrej-ubuntu-php-focal.list dient de volgende regel opgenomen te worden:
deb http://ppa.launchpad.net/ondrej/php/ubuntu focal main

De opdrachten om de modules op te halen zijn:
apt-get install php-xmlrpc
apt-get install apache2
apt-get install ldap-utils
apt-get install php-ldap
apt-get install libapache2-mod-php
apt-get install php-gnupg

= algemeen =

Het encrypted backup script is verplaatst naar '/usr/local/hobbynet/local' en hernoemd naar 'backup-encrypted.bash'.
Dit is omdat deze niet mee mag worden gesynchroniseerd.

Tevens wordt 1x per dag /usr/local/hobbynet/bin gesynchroniseerd (1-richting van hcc-ldap-lb1 naar hcc-ldap-lb2)

== Aanpassingen in de firewall ==
Op de server waar de XML-RPC server staat, moeten enkele firewall aanpassingen gemaakt worden.
* inkomend: sta TCP 443 toe vanaf het interne netwerk (www-prod, www-test), en vanaf eventuele andere plekken die we expliciet toe willen staan.
* inkomend: sta TCP 443 toe vanaf mijn.hcc.nl (XML-RPC aanroepen vanaf de portal)
* inkomend: sta TCP 443 toe vanaf service.hccnet.nl toe (XML-RPC aanroep GeefUitgeschrevenLeden vanuit HenZ)
* uitgaand: sta TCP 443 naar service.hccnet.nl toe (XML-RPC aanroepen naar HenZ)

== Aanpassingen aan AppArmor ==
Alhoewel technisch gezien dit bij slapd behoort, neem ik het toch hier op.

Als het Hobbynet certificaat in de map /disk/site/etc/ssl/hobby.nl/ wordt neergezet, dan zal apparrmor de toegang tot de certificaten blokkeren. Neem daarom in de '''local''' directory van apparmor het volgende op:
# /etc/apparmor.d/local/usr.sbin.slapd
# Site-specific additions and overrides for usr.sbin.slapd.
# For more details, please see /etc/apparmor.d/local/README.
#include <abstractions/ssl_certs>
/disk/site/etc/ssl/hobby.nl/ r,
/disk/site/etc/ssl/hobby.nl/* r,

= CRM (Azure) proxy herstarten =
Als er indicaties zijn dat niet alle JSON berichten meer vanuit het CRM aangeboden worden aan de XML-RPC server, dan kan het helpen om de CRM proxy te herstarten

* Ga naar https://portal.azure.com/
* Login met zelfde account als voor het CRM
* Soms krijg je een popup. Die kan je weg klikken, je wilt geen rondleiding
* Klik op '''hccdyn01-aps-crm01''' voor productie en '''hccdyn01-aps-dev01''' voor test
* En dan kan je op opnieuw starten klikken.

PDNS authoritative dns server's

2022-03-27T17:02:28Z

Hans:

= Doel =
Dit zijn de autoritive name servers van hobbynet

= opzet =
pdns1 is de master server. Hier draait de database op met alle records, in een mysql database.

De overige dns servers draaien een slave van deze server en worden zo automatisch voorzien van de meest recente records.

'''let op alle wijzigingen moeten dus op pdns1 worden uitgevoerd, anders help je de replicatie om zeep'''
= zones =
== zone bewerken ==
=== cli ===
eenvoudig via :
pdnsutil edit-zone (zonenaam zonder extra .)

== zone migreren ==
in /root staat migratie script . Dit script haalt de zone file uit /root/master.

Deze zorgt dat de zone wordt ingelezen in de database en nameserver records worden goed gezet.

/root/migrate.sh

= zone bewerken =
== cli ==
activeren van dnssec gaat relatief eenvoudig draai
/disk/scripting/powerdns/dnssec/activeerdnssec.sh domeinnaam.tld
en de benodigde handelingen worden verricht, ksk en zsk worden aangemaakt en geactiveerd en nsec3 wordt geactiveerd.

Hierna kan je paar uur wachten of je draait het dnsseconderhoud script om te zorgen dat de leverancier wordt bij gewerkt.
== web ==
Je kan de webinterface benaderen via:
https://poweradmin.hobby.nl/

Wacht woord wijzigen kan via about me

Dit is nog tijdelijke web interface
= dnssec =
Om te zorgen dat de KSK key's automatisch worden uitgerold naar de verschillende leveranciers is er een database genaamd Domeinbeheer
== activeren ==
Om DNSsec te activeren, dit gaat alleen vanaf de commandline met het commando
activeerdnssec domein.tld

En als je wilt dat dit direct geactiveerd wordt bij de TLD, dan moet je dit commando draaien:
php /disk/scripting/powerdns/dnssec/dnsseconderhoud.php

Je kan ook wachten tot 4:42 of 16:42 dan draait het onderhoud script uit crontab

== database ==
=== tabellen ===
==== dnssec ====
Deze tabel houd bij welke KSK actief is, en wanneer hij verloopt
{| class="wikitable"
|+
!Naam veld
!Omschrijving
|-
|id
|Primary key
|-
|Domein naam
|Naam van de zone/domein (met extra punt)
|-
|actieve-ksk
|keytag van de actieve ksk
|-
|standby-ksk
|keytag van de standby ksk
|-
|verlopen-ksk
|keytag van de verlopen ksk
|-
|verval-actieve
|Datum wanneer key in gebruik is genomen
|-
|Verval-verlopen
|Datum wanneer key inactief is geworden
|}

==== Leveranciers ====
Om te kunnen bepalen bij welke leverancier een domein hoort wordt aan de hand van de tld bepaald wat de leverancier is.
{| class="wikitable"
|+
!Naam veld
!Omschrijving
|-
|id
|Primary key
|-
|tld
|de extentie van domein
|-
|leveransier
|de leverancier van deze tld
|}
== api ==
=== epp sidn ===
Helaas is de EPP interface best complex en niet al te makkelijk, maar wordt deels eigen scripting gebruikt en deels een php-client van metaregistry opgehaald en up2date gehouden via composer
=== Transip rest api ===
We maken gebruiken van de rest interface van Transip

We hebben een PHP class '''TransIP_AccessToken''' voor het aanmaken van een autorisatie token.

Dit token is 30 min geldig
=== ripe rest api ===
Voor ripe gebruiken we de standaard rest interface van ripe.

We halen het json object op bij RIPE. Als er 1 ds-record niet klopt dan wordt het hele record overschreven, met het meest recente record.

Update van record is traag

=== godaddy api ===
Godaddy heeft geen api, voor dit 1e domein hcc.contact heb ik dnssec uit staan. In de toekomst maken we hier nog wat voor, of we wachten tot transip ook aan .contact doet

= scripting =
Alle scripting staat op /disk/scripting/powerdns

Op deze manier wordt ook netjes geback-upt

== dnsseconderhoud.php ==
Dit script verricht onderhoud in paar fases:

# Fase 1 kijken of er verlopen actieve ksk's zijn en zo ja wissel KSK met standby KSK en maak nieuwe KSK (elke 3 maanden wisselen)
# Fase 2 controleer of records kloppen bij leveranciers en zo nodig update soms altijd update zie api omschrijving
# Fase 3 verwijder alle verlopen KSK die ouder zijn dan 1 week
# Fase 4 verwijder niet gekoppelde KSK's uit powerdns

== functions.php ==
Deze file bevat alle gebruikte functies

== credentials* ==
Spreekt voor zich

== transip/zetnameservergoed.php ==
Dit script zet nameserver van domein goed bij transip
transip/zetnameservergoed.php domein.tld
== sidn/zetnameservergoed.php ==
Dit script zet nameserver van domein goed bij sidn
sidn/zetnameservergoed.php domein.nl

= vragen =
Stoppen met vullen van groeperingen uit ldap (vereenvoudigen)

MediaWikiSites

2022-01-03T15:57:34Z

Hans:

== Lijst met Mediawiki sites die wij bijhouden ==

* Hobbynet wiki (https://wiki.hobby.nl/)

== upgrade procedure ==

* log in op hobbynet-lb1-int

* maak met tar een backup van de wiki:
cd /disk/site/hobbynet/wiki.hobby.nl/
tar -cf wiki-backup-20200830.tar www
bzip2 wiki-backup-20200830.tar

* maak met phpmyadmin een backup van de database

* download de wiki software upgrade van http://www.mediawiki.org/

* volg de instructies zoals beschreven op http://www.mediawiki.org/wiki/Manual:Upgrading 

=== Hobbynet wiki updaten ===
* Volg de instructies om de wiki te updaten

====optie 1: volledige versie downloaden en installeren====
Ons eigen lijstje:

ssh hobbynet-lb1-int
cd /disk/site/hobbynet/wiki.hobby.nl
rm -rf www-old
cp -a www www-old
wget https://releases.wikimedia.org/mediawiki/1.37/mediawiki-1.37.1<nowiki/>.tar.gz
tar xzf mediawiki-1.37.1.tar.gz
chown wiki-hobby-nl:wiki-hobby-nl mediawiki-1.37.1 -R
cp -a www-old/LocalSettings.php mediawiki-1.37.1
cp -a www-old/images/* mediawiki-1.37.1/images
cp -a www-old/getip* mediawiki-1.37.1
rm -rf www
mv mediawiki-1.37.1 www
cd www/maintenance
php update.php

Op 2021.08.15 wilde de update naar 1.36.1 niet starten. Bleek dat eerst de module 'php-intl' met apt erbij gezet moest worden.

Op 2020.08.30 weigerde de update correct te lopen. Bleek dat er geen skins meer waren, en de extensie WikiEditor ontbrak ook.
Pas na het terugzetten van die bestanden uit de oude omgeving wilde het update script draaien
cp -a ../../www-old/skins/MonoBook ../skins/
cp -a ../../www-old/skins/Vector/ ../skins/
cp -a ../../www-old/skins/Timeless/ ../skins/
cp -a ../../www-old/extensions/WikiEditor ../extensions/
php update.php

*Als update.php niet draait, omdat er geen sql modules beschikbaar zouden zijn, selecteer dan eerst de juiste php versie
update-alternatives --config php

* Op de hobbynet wiki staan 2 losse bestanden die geen directe relatie met de wiki software hebben ('''getip.html''' en '''getip.php'''). 
Plaats die bestanden terug, tijdens de wiki upgrade actie!

====optie 2: patch enkel de verschillen====

Op 2021.10.03 is er voor het eerst gebruik gemaakt van de patch procedure om de upgrade naar versie 1.36.2 uit te voeren.
wget https://releases.wikimedia.org/mediawiki/1.36/mediawiki-1.36.2.patch.gz
gunzip mediawiki-1.36.2.patch.gz
patch -p1 --dry-run -i mediawiki-1.36.2.patch
patch -p1 -i mediawiki-1.36.2.patch

MediaWikiSites

2022-01-03T15:36:42Z

Hans:

== Lijst met Mediawiki sites die wij bijhouden ==

* Hobbynet wiki (https://wiki.hobby.nl/)

== upgrade procedure ==

* log in op hobbynet-lb1-int

* maak met tar een backup van de wiki:
cd /disk/site/hobbynet/wiki.hobby.nl/
tar -cf wiki-backup-20200830.tar www
bzip2 wiki-backup-20200830.tar

* maak met phpmyadmin een backup van de database

* download de wiki software upgrade van http://www.mediawiki.org/

* volg de instructies zoals beschreven op http://www.mediawiki.org/wiki/Manual:Upgrading 

=== Hobbynet wiki updaten ===
* Volg de instructies om de wiki te updaten

====optie 1: volledige versie downloaden en installeren====
Ons eigen lijstje:

ssh hobbynet-lb1-int
cd /disk/site/hobbynet/wiki.hobby.nl
rm -rf www-old
cp -a www www-old
wget https://releases.wikimedia.org/mediawiki/1.36/mediawiki-1.36.1<nowiki/>.tar.gz
tar xzf mediawiki-1.36.1.tar.gz
chown wiki-hobby-nl:wiki-hobby-nl mediawiki-1.36.1 -R
cp -a www-old/LocalSettings.php mediawiki-1.36.1
cp -a www-old/images/* mediawiki-1.36.1/images
cp -a www-old/getip* mediawiki-1.36.1
rm -rf www
mv mediawiki-1.36.1 www
cd www/maintenance
php update.php

Op 2021.08.15 wilde de update naar 1.36.1 niet starten. Bleek dat eerst de module 'php-intl' met apt erbij gezet moest worden.

Op 2020.08.30 weigerde de update correct te lopen. Bleek dat er geen skins meer waren, en de extensie WikiEditor ontbrak ook.
Pas na het terugzetten van die bestanden uit de oude omgeving wilde het update script draaien
cp -a ../../www-old/skins/MonoBook ../skins/
cp -a ../../www-old/skins/Vector/ ../skins/
cp -a ../../www-old/skins/Timeless/ ../skins/
cp -a ../../www-old/extensions/WikiEditor ../extensions/
php update.php

*Als update.php niet draait, omdat er geen sql modules beschikbaar zouden zijn, selecteer dan eerst de juiste php versie
update-alternatives --config php

* Op de hobbynet wiki staan 2 losse bestanden die geen directe relatie met de wiki software hebben ('''getip.html''' en '''getip.php'''). 
Plaats die bestanden terug, tijdens de wiki upgrade actie!

====optie 2: patch enkel de verschillen====

Op 2021.10.03 is er voor het eerst gebruik gemaakt van de patch procedure om de upgrade naar versie 1.36.2 uit te voeren.
wget https://releases.wikimedia.org/mediawiki/1.36/mediawiki-1.36.2.patch.gz
gunzip mediawiki-1.36.2.patch.gz
patch -p1 --dry-run -i mediawiki-1.36.2.patch
patch -p1 -i mediawiki-1.36.2.patch

XML-RPC

2021-11-04T11:38:18Z

Hans:

= XML-RPC interface =

De LDAP server kan direct gemuteerd worden via een LDAP koppeling. Zie
de standaard LDAP pagina voor de uitleg welke poorten daarvoor gebruikt
kunnen worden.

Daarnaast is er de wens ontstaan om via een standaard protocol met de
LDAP omgeving te kunnen communiceren. Er is hiertoe een XML-RPC
koppeling ontwikkeld. XML-RPC is een standaard interface, waarmee het
mogelijk is om vanuit diverse omgevingen op een gestandaardiseerde
manier te communiceren.

== Globale functie omschrijving ==
* Algemene aanroepen
** Controleer of een gebruiker bestaat
** Wijzig het wachtwoord ('userPassword')
** Zoek een gebruiker (t.b.v. kantoor en/of LA-akties groeperingssecretaris)
** Maak een gebruiker aan (geef gebruiker een andere hccLogin waarde, maak ook bij HCCnet deze gebruiker aan)
** Controleer of een gebruiker zijn profiel al doorlopen heeft
** Haal de lijst met opgeheven accounts op
** Haal de lijst met bulletins van een hcc lid (OptIn)

* Aanroepen t.b.v. hcc partners
** Controleer of lidnummer/postcode correct is
** Controleer of lidnummer/postcode correct is, en tevens ingeschreven staat bij een specifieke IG

* Joomla template site functies (op basis van JoomlaToken)
** Maak een JoomlaToken
** Ruim een JoomlaToken op
** Pas mijn OptIn (bulletin inschrijving) aan
** Regel alles rondom Onderwerpen en de autorisatie hiervan
** Pas mijn wachtwoord aan

* Joomla kadernet site functies (op basis van JoomlaToken)
** Zoek een hcc kaderlid (t.b.v. de kaderleden zoekpagina)
** Pas mijn kadermail forwarding aan en toon ja/nee mijn GSM nummer
** Pas het kadernet e-mail wachtwoord aan
** Haal de lijst met alle groeperingen op
** Haal de lijst met alle kaderrollen op

* Joomla hcc.nl site (op basis van JoomlaToken)(mijn.hcc.nl vervanging)
** Pas mijn adresgegevens aan
** Pas mijn voorletters, voornaam, pseudoniem, telefoonnummer, GSM nummer etcetera aan
** Schrijf me in of uit op een bulletin
** Toon info over de kosten van een IG lidmaatschap
** Voer een wachtwoord reset uit op basis van een PWResetToken (een variant op JoomlaToken)
** Vraag een nieuwe HCC code aan, en stuur die per SMS

* Joomla hobby.nl site (op basis van JoomlaToken)(t.b.v. IDEAL betaling)
** Haal het aantal hobbyDomains op

* Aanroepen t.b.v. CRM (Microsoft Dynamics Cloud) koppeling
** Haal de dagelijkse synchronisatie bestanden op
** Werk in het CRM dan wel in LDAP de NAW gegevens bij
** Werk in het CRM dan wel in LDAP de IG gegevens van een lid bij

* HenZ
** Haal de lijst met opzeggers op
** Valideer de opzegdatum van een opgegeven gebruiker

=== Authenticatie ===

Alle aanroepen gebeuren op basis van authenticatie vanuit de aanroeper.
Dit valt uiteen in de volgende categorieën:
* gebruikersnaam ('hccLogin') en wachtwoord ('userPassword')
* hcc lidnummer ('hccLidnr'), Joomla token ('JoomlaToken') en website ('siteID')
* hcc lidnummer ('hccLidnr') en hcc code ('hccCode')
* beheerders-DN ('beheerLogin') en beheerders wachtwoord ('beheerPassword')
* partner-DN ('partnerLogin') en partner wachtwoord ('partnerPassword')

=== Aanroepen, gedaan via de bezoekersregistratie-proxy ===
(de bezoekersregistratie proxy is een mislukt project tbv de Android app van René Prins)
(deze proxy bestaat niet meer) 
Diverse aanroepen kunnen ook via de bezoekersregistratie-proxy aangeroepen worden. 
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
* GeefAlleGroeperingen
* GeefAlleKaderRollen
* GeefLocaties
* GeefLocatieNamen
De bezoekersregistratie aanroepen hebben 'JoomlaToken' als extra parameter nodig:
* LidBezoektBijeenkomst
* GeefBezoekersOverzicht
* GeefBezoekersAantallen
De aanroepen die over de proxy uitgevoerd worden dienen voorafgegaan te worden door een aanroep naar
* GeefMijnGegevens (dit geeft na validatie immers 'JoomlaToken' terug)

=== Resultaten ===

Alle aanroepen geven de volgende elementen terug:
* Naam van de uitgevoerde procedure ('Action')
* Resultaat van de uitgevoerde procedure ('Status')
* Een tekstuele vertaling van het resultaat dan wel de foutmelding ('Message')
* Tijdens de ontwikkelfase kan er debug-info teruggeleverd worden ('ExtraInfo')
Daarnaast geven specifieke aanroepen extra resultaten terug

== Technische omschrijving ==
XML-RPC beschrijving van acties in hcc.nl LDAP database

<pre>
2021.11.03 HaVe
XML-RPC Hobbynet versie 69.
</pre>

=== Kort overzicht ===

Dit is een lijst met alle XML-RPC aanroepen. In het volgende hoofdstuk worden ze in detail besproken.
<pre>
echo (partners)
ExpandeerPostcode (Joomla module Bas, tbv verhuizingen)
GebruikerBestaatControle (Joomla sites)
GeefAantalDomeinen (Joomla module Bas)
GeefAlleBulletins (Joomla module Bas)
GeefAlleGroeperingen (kadersite, forum, secr. portal, kantoor portal, hobbynet portal)
GeefAlleKaderRollen (forum, secr. portal, kantoor portal, hobbynet portal, Joomla module Bas)
GeefBezoekersOverzicht (bezoekersregistratie)
GeefBezoekersAantallen (bezoekersregistratie)
GeefFactuurOverzicht (Joomla module Bas)
GeefhccEindDatum (HenZ)
GeefKadermailGegevens (kantoor portal)
GeefLocatieNamen (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefLocaties (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefMijnGegevens (Joomla inlog module Bas)
GeefMijnLidnummer (beheer.hcc.nl secretaris portal)
GeefOnderwerpen (Joomla template sites)
GeefSSOUrls (Joomla module Bas)
GeefUitgeschrevenLeden (Joomla sites, HenZ)
HaalAanmeldingsformulier (Joomla module Bas)
HaalFactuur (Joomla module Bas)
HaalIGBedragenOp (Joomla module Bas)
HaalOptInKeuzen (kantoor portal)
HaalTariefGroepenOp (kantoor portal)
HCCpartner (Partner aanroep)
HCCpartners (Partner aanroep)
HeeftOtpKey (Joomla Hobbynet/LA aanroep)
IsDezeNaamNogBeschikbaar (aangeroepen vanuit de CRM omgeving)
IsDezePseudoniemNogBeschikbaar (kantoor portal)
IsHCCLid (vraagbaak aanroep)
IsKaderLid (in veel apps gebruikt)
LidBezoektBijeenkomst (bezoekersregistratie)
MaakGebruikerAan (mijnhcc.nl, maak hccnet account aan en ldap gebruikersnaam)
MaakOnderwerp (Joomla template sites)
MaakPWResetToken (Joomla module Bas)
MaakTestLogin (Joomla module Bas)
MuteerAanmeldingsformulier (Joomla module Bas)
MuteerGroeperingSamenstelling (Joomla kadernet module Bas)
MuteerOnderwerp (Joomla template sites)
MuteerOnderwerpAutorisatie (Joomla template sites)
NormaliseerTelefoon (Joomla module Bas)
PasHccLoginAan (Joomla module Bas)(enkel Hobbynet)
PasInteressegroepAan (Joomla module Bas)
PasKaderGegevensAan (kadersite, Joomla module Bas)
PasOptInKeuzeAan (Joomla module Bas)
PasPseudoniemAan (Joomla module Bas)
PasUserWachtwoordAan (beheer.hcc.nl Hobbynet gebruikers portal)
PasWachtwoordAan (Joomla module Bas)
RegistreerGast (bezoekersregistratie)
ResetHCCCode (Joomla module Bas)
RuimJoomlaTokenOp (Joomla module Bas)
SchrijfNietlidInOpBulletin (Joomla site bulletin module Bas)
SchrijfNieuwLidIn (Joomla CRM module Bas)
ToonOnderwerpAutorisatie (Joomla template sites)
UpdateContactEmail (Joomla module Bas)
UpdateContactGegevens (Joomla module Bas)
UpdateMobiel (Joomla module Bas)
UpdateNAW (Joomla module Bas)
UpdateOTP (Joomla module Bas)
UpdateTelefoon (Joomla module Bas)
UpdateVoorletters (Joomla module Bas)
UpdateVoornaam (Joomla module Bas)
Upload_CSV_bestand (CRM webproxy)
ValideerPWResetToken (Joomla module Bas)
ValideerWachtwoordEisen (Joomla module Bas)
Verwerk_JSON_mutatie (CRM webproxy)
VerwijderNietLid (Joomla beheer module Bas)
VerwijderOnderwerp (Joomla template sites)
VraagLidgegevensTokenAan (bezoekersregistratie)
WijzigGebruikersGegevens (kantoor en Joomla template sites, ww aanpassen van gebruiker)
ZoekGroeperingsLid (secr. portal, kantoor portal, hobbynet portal)
ZoekHCCLid (VZ portal)
ZoekKaderLeden (Joomla kadernet module Bas)
</pre>

=== HCC-ldap en/of HCC-net aanroepen ===

<pre>
// ** Joomla sites, www.hcc.nl **
// 1.1 controleer of een gebruiker bestaat - optie 1
// (authenticatie op basis van hccLidnr en hccCode)
// Alleen bedoeld om gebruikers op www.hcc.nl op basis van het lidnr het ww te laten wijzigen
$request = xmlrpc_encode_request(
'GebruikerBestaatControle',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $method,
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd');
if ($hccLidnr != '') { $reply['hccLidnr'] = $hccLidnr; }
if ($hccLogin != '') { $reply['hccLogin'] = $hccLogin; }
if ($hccPseudoniem != '') { $reply['hccPseudoniem'] = $hccPseudoniem; }
if ($cn != '') { $reply['cn'] = $cn; }
if ($sn != '') { $reply['sn'] = $sn; }
if ($mail != '') { $reply['mail'] = $mail; }
if ($mailHccnet != '') { $reply['mailHccnet'] = $mailHccnet; }
if ($hccRegio != '') { $reply['hccRegio'] = $hccRegio; }
if ($hccIG != '') { $reply['hccIG'] = $hccIG; }
if ($hccRol != '') { $reply['hccRol'] = $hccRol; }
if ($ProfielBekend != '') { $reply['ProfielBekend'] = $ProfielBekend; }

// ** Portal mijn.hcc.nl **
// 2.1 wijzig wachtwoord - optie 1
// op basis van hccLidnummer en hccCode
// Essentiele aanroep, gebruikt vanuit mijnhcc.nl (lidnr + hccCode)
// Ook gebruikt t.b.v. wachtwoord-vergeten procedure op de Joomla template sites
// Als de profielpagina nog niet is doorlopen wordt deze aanroep afgekeurd.
//
// Ook gebruikt om gebruiker rechtstreeks vanaf Joomla template sites wachtwoord te
// laten aanpassen (op basis van lidnummer en hcc code)
//
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'WijzigGebruikersGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gewijzigd',
'hccLogin' => $hccLogin,
'cn' => $cn,
'sn' => $sn);

// 2.3 wijzig wachtwoord - optie 3
// (t.b.v. VZ-portal)
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
// * Als hccLidnr gevuld is, dan wordt hccLidnr gebruikt om het juiste record te zoeken
// Als hccLidnr leeg is, dan wordt hccLogin gebruikt om het juiste record te zoeken
// 1 van beide velden MOET aanwezig zijn
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'beheerLogin' => $beheerLogin, // beheerder lidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

// ** t.b.v. ophalen van de opt-in keuzes op de beheer pagina **
// 2.6 Geef de complete lijst met opt-ins van dit lid
// (LET OP: authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'HaalOptInKeuzen',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalOptInKeuzen',
'Status' => 'TRUE',
'Message' => 'OptInLijst opgehaald',
'hccOptIn' => $hccOptIn);
Output negatief:
$reply = array(
'Action' => 'HaalOptInKeuzen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gebruikersnaam, pseudoniem
// en wachtwoord tevens in LDAP op
// (authenticatie op basis van hcc lidnummer en hcc-code)
// ** Deze gegevens worden doorgezet naar hccnet.nl (action=4) **
//
$request = xmlrpc_encode_request(
'MaakGebruikerAan',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_hccLogin' => $nieuw_hccLogin,
'nieuw_userPassword' => $nieuw_userPassword,
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'TRUE',
'Message' => 'Gebruiker aangemaakt',
'mail' => $mail,
'hccPseudoniem' => $hccPseudoniem);
Output negatief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gebruikersnaam bestaat al' |
'Pseudoniem bestaat al' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!');

// H.3 Haal al mijn gegevens
// (wordt gebruikt door de Joomla inlogmodule)
// Voor gebruik over de proxy t.b.v. de Android app kan compact=TRUE meegegeven worden.
// In dat geval worden enkel de meest essentiele gegevens teruggestuurd
// Voor gebruik na MaakGebruikerAan kan deze functie ook op basis van hccLidnr en JoomlaToken
// worden aangeroepen
// De optionele parameter 'PrevSiteID' is bedoeld voor single-sign-on. Op basis van JoomlaToken,
// hccLidnr en PrevSiteID worden dan de credentials gevalideerd. Als die kloppen, geeft deze aanroep
// een 2e JoomlaToken terug, maar dan uitgegeven op basis van SiteID.
// Als PrevSiteID leeg is, dan wordt het token op basis van siteID gevalideerd.
$request = xmlrpc_encode_request(
'GeefMijnGegevens',
array(
['hccLogin' => $hccLogin,
'userPassword' => $userPassword,]
['hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,]
['PrevSiteID' => $PrevSiteID,]
['compact' => $compact,] // leeg of 'TRUE'
['hccGroepering'=> $hccGroepering,] // Een testgebruiker mag alleen op deze site inloggen
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd',
'hccLidnr' => $hccLidnr,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccAutorisatie' => $hccAutorisatie,
'cn' => $cn,
'sn' => $sn,
'JoomlaToken' => $JoomlaToken,
['hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'givenname' => $givenname,
'hccAanhef' => $hccAanhef,
'hccGeslacht' => $hccGeslacht,
'hccTussenVoegsels' => $hccTussenVoegsels,
'hccAchternaam' => $hccAchternaam,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward,
'hccKaderToonMobiel' => $hccKaderToonMobiel,
'hccOptIn' => $hccOptIn,
'ProfielBekend' => $ProfielBekend,
'hccBeginDatum' => $hccBeginDatum,
'testaccount' => is_testaccount(), // 'TRUE' | 'FALSE'
'hccOtpKey' => $hccOtpKey,
'hccOtep' => $hccOtep,
['kadermail_omvang' => $Formaat, // in Mb
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald;]]);

Output negatief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// ** t.b.v. aanpassen van de opt-in keuzes op een Joomla site **
// H.4 Pas 1 opt-in van een lid aan
// (LET OP: authenticatie op basis van hccLidnr, JoomlaToken en siteID)
// of
// authenticatie op basis van hccLidnr en OptOutToken (voor een directe uitschrijving door een lid)
// Als hccLidnummer gevuld is, dan is dat het lidnummer waar de mutatie op moet worden uitgevoerd.
// Dat kan alleen als de aanvrager HCC#LAD of HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasOptInKeuzeAan',
array(
'hccLidnr' => $hccLidnr,
['JoomlaToken' => $JoomlaToken,]
['OptOutToken' => $OptOutToken,]
['hccLidnummer' => $hccLidnummer,]
'hccOptIn' => $hccOptIn,
'actie' => 'Nieuw' | 'Weg',
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'TRUE',
'Message' => 'OptIn aangepast');
Output negatief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials | Token ongeldig | Token verlopen');

// H.5 Zoek kaderleden NAW (t.b.v. de Joomla kadersite)
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
//
// * Er dient minstens 1 zoekcriterium opgegeven te worden.
// * Als zowel hccRegio als tegelijk ook hccIG opgegeven worden is de uitkomst onvoorspelbaar.
// * Als compact=TRUE worden enkel lidnummer, cn en sn in het antwoord gezet
$request = xmlrpc_encode_request(
'ZoekKaderLeden',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
['hccRegio' => $hccRegio,]
['hccIG' => $hccIG,]
['hccRol' => $hccRol,]
['hccLocatie' => $hccLocatie,]
['achternaam' => $achternaam,]
['compact' => $compact])); // leeg of 'TRUE'

Output positief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'TRUE',
'Message' => 'Kaderleden opgevraagd'
'Kaderleden' => array(
'hccLidNummer' => $hccLidNummer,
'hccRol' => $hccRol,
'hccAanhef' => $hccAanhef,
'givenname' => $givenname,
'cn' => $cn,
'sn' => $sn,
'hccWoonplaats' => $hccWoonplaats,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'hccKaderMail' => $hccKaderMail);

Output negatief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token']);

// H.9 PasKaderGegevensAan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
// Om de kaderleden hun forward in te laten stellen,
// en tegelijkertijd de opt-in / opt-out voor hccToonMobiel te laten regelen
// Kan tevens het kader email wachtwoord aanpassen
$request = xmlrpc_encode_request(
'PasKaderGegevensAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'hccKaderForward' => $hccKaderForward, // '' | $mail | $mailHccNet
'hccKaderToonMobiel' => $hccKaderToonMobiel, // 'TRUE' | 'FALSE' | 'NULL'
['nieuw_kaderPassword' => $nieuw_kaderPassword]));

Output positief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'TRUE',
'Message' => 'kadergegevens aangepast');

Output negatief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token'|'Alleen kaderleden mogen deze aanroep uitvoeren']);

// ** Portal beheer.hcc.nl
// ** H.10 PasUserWachtwoordAan
// ** Betalende Hobbynet gebruikers kunnen hiermee hun wachtwoord aanpassen
// (authenticatie op basis van hccLogin en userpassword)
$request = xmlrpc_encode_request(
'PasUserWachtwoordAan',
array(
'hccLogin' => $username,
'userpassword' => $password,
'hobbynetAccount' => $hobbyname,
'nieuw_wachtwoord' => $nieuw_wachtwoord,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!' |
'account $hobbynetAccount behoort niet bij gebruiker $hccLogin' |
'Kan ww van account $hobbynetAccount niet aanpassen');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.11 Pas het pseudoniem van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasPseudoniemAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccPseudoniem' => $hccPseudoniem,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'TRUE',
'Message' => 'Pseudoniem aangepast');
Output negatief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials' | 'Pseudoniem bestaat al');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.12 Controleer of een opgegeven wachtwoord aan de minimum eisen voldoet
$request = xmlrpc_encode_request(
'ValideerWachtwoordEisen',
array(
'userPassword' => $userPassword,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'TRUE',
'Message' => 'Wachtwoord voldoet aan de minimale eisen');
Output negatief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'FALSE',
'Message' => 'Wachtwoord voldoet niet aan de minimale eisen');

// ** H.13 PasWachtwoordAan
// ** Vanuit een Joomla template site kunnen gebruikers hiermee hun eigen wachtwoord aanpassen
// (authenticatie op basis van JoomlaToken, lidnummer, siteID. Extra controle via userpassword)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'userpassword' => $password,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.13.1 PasWachtwoordAan
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee hun eigen wachtwoord resetten
// (authenticatie op basis van PWResetToken en hccLogin).
// (Als de aanroep geslaagd is, dan is daarna het PWResetToken ongeldig)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.14 MaakPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee een wachtwoord reset aanvragen
// Deze aanroep geeft naast het PWResetToken ook het contact emailadres mee terug,
// zodat Joomla een reset-mail kan sturen
// (acties op basis van gebruikersnaam)
$request = xmlrpc_encode_request(
'MaakPWResetToken',
array(
'hccLogin' => $username,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'TRUE',
'PWResetToken' => $PWResetToken,
'mail' => $mail,
'Message' => 'Password reset token aangemaakt');
Output negatief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');

// ** H.15 ValideerPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers een wachtwoord reset aanvragen
// Controleer dat het hier om een bestaand (en nog niet gebruikt) token gaat
$request = xmlrpc_encode_request(
'ValideerPWResetToken',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'TRUE',
'Message' => 'Password reset token gevonden');
Output negatief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'FALSE',
'Message' => 'hccLogin bestaat niet' | 'PWResetToken bestaat niet');

// H.16 Ruim een bestaand JoomlaToken op
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'RuimJoomlaTokenOp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'SiteID' => $siteID,
['ServerID' => gethostname(),]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'TRUE',
'Message' => 'JoomlaToken opgeruimd');
Output negatief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'FALSE',
'Message' => 'Onjuist JoomlaToken');

// ** Joomla module
// ** H.17 GeefAantalDomeinen
// ** Vraag het aantal domeinen op van een betalende Hobbynet gebruiker (t.b.v. IDEAL betaling)
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'GeefAantalDomeinen',
array(
'JoomlaToken' => $JoomlaToken,
'hccLidnr' => $hccLidnr,
'hobbynetAccount' => $hobbyname,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'TRUE',
'hobbynetAccount' => $hobbyname,
'AantalDomeinen' => $aantalDomeinen,
'Message' => 'aantal domeinen opgevraagd');
Output negatief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'account $hobbynetAccount behoort niet bij deze gebruiker');

// ** Joomla module
// ** H.18 ResetHCCCode
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'beheerLogin' => $beheerLogin, // geheime credentials van de site
'beheerPassword' => $beheerPassword, // geheime credentials van de site
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** Joomla module
// ** H.18.1 ResetHCCCode (hcc kantoor aanroep)
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'JoomlaToken' => $JoomlaToken, // Het Joomla token van de sessie van de kantoor medewerker
'hccLidnr' => $hccLidnr, // Het lidnummer van de kantoor medewerker
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** t.b.v. aanpassen van de hccLogin van een gebruiker (Hobbynet functie op Joomla site) **
// H.19 Pas de hccLogin van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// hccLidnummer is het lidnummer waar de mutatie op moet worden uitgevoerd
// Kan alleen als de aanvrager HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasHccLoginAan',
array(
'hccLidnr' => $hccLidnr, // lidnummer van de aanvrager
'JoomlaToken' => $JoomlaToken, // JoomlaToken van de aanvrager
'hccLidnummer' => $hccLidnummer, // pas de hccLogin van dit lidnummer aan
'hccLogin' => $hccLogin, // dit is de gewenste nieuwe hccLogin
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'TRUE',
'Message' => 'hccLogin aangepast');
Output negatief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' |
'Onjuiste credentials' |
'Gebruikersnaam al in gebruik');

// ** t.b.v. het aanmaken van een testaccount door een webmaster
// H.20 Maak een testaccount aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// Kan alleen als de aanvrager WM als rol heeft
$request = xmlrpc_encode_request(
'MaakTestLogin',
array(
'JoomlaToken' => $JoomlaToken, // JoomlaToken van de aanvrager
'hccLidnummer' => $hccLidnummer, // lidnummer van de aanvrager
'hccRol' => $hccRol, // (mag leeg zijn)
'hccGroepering' => $hccGroepering, // (regio of IG)
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
reply = array(
'Action' => 'MaakTestLogin',
'Status' => 'TRUE',
'Message' => 'Tijdelijk test account aangemaakt',
'TestAccountNaam' => 'test-<groepering>-<hccLogin>'
'userpassword' => $nieuw_userpassword,
'hccGroepering' => $hccGroepering,
'hccRol' => $hccRol);
Output negatief:
$reply = array(
'Action' => 'MaakTestLogin',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Gegevenscombinatie onjuist');

// Joomla functie
// ** t.b.v. aanpassen van de OneTime Passwords
// H.21 Pas de OTP gegevens van een lid aan
// (LET OP: authenticatie op basis van hccLidnr, JoomlaToken en siteID)
// Als hccLidnummer gevuld is, dan is dat het lidnummer waar de mutatie op moet worden uitgevoerd.
// Dat kan alleen als de aanvrager HCC#LAD of HN#WM als rol heeft
$request = xmlrpc_encode_request(
'UpdateOTP',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
['hccLidnummer' => $hccLidnummer,]
'hccOtpKey' => $hccOtpKey, // De otp encryptie key van de gebruiker (mag leeg zijn, dan weg)
'hccOtep' => $hccOtep, // Het one time recovery password (mag leeg zijn, dan weg)
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateOTP',
'Status' => 'TRUE',
'Message' => 'OTP gegevens aangepast');
Output negatief:
$reply = array(
'Action' => 'UpdateOTP',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// Joomla functie
// H.22 Heeft een lid een OTP key ja/nee
// (LET OP: authenticatie op basis van hccLidnr, JoomlaToken en siteID)
// hccLidnummer is het lidnummer waar de aanvraag op moet worden uitgevoerd.
// Dat kan alleen als de aanvrager HCC#LAD of HN#WM als rol heeft
$request = xmlrpc_encode_request(
'HeefOtpKey',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccLidnummer' => $hccLidnummer,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'HeefOtpKey',
'Status' => 'TRUE',
'HeeftOtpKey' => 'TRUE'|'FALSE',
'Message' => 'OTP status opgevraagd');
Output negatief:
$reply = array(
'Action' => 'HeefOtpKey',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// 3.1 Geef mijn lidnummer
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'GeefMijnLidnummer',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'TRUE',
'Message' => 'Lidnummer opgevraagd',
'hccLidnr' => $hccLidnr);
Output negatief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.2 Controleer of de gebruikersnaam op dit moment bestaat
// (geen authenticatie)
// ** Deze gegevens worden opgevraagd bij hccnet.nl (action=3) **
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezeNaamNogBeschikbaar',
array(
'nieuw_hccLogin' => $nieuw_hccLogin,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Gebruikersnaam is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Gebruikersnaam bestaat al');

// ** Enkel voor gebruik vanaf de kantoor portal **
// ** t.b.v. het hernoemen van accounts in CRM **
// 8.3 Controleer of een Pseudoniem op dit moment bestaat ??? NIET GEBRUIKT ??
// (geen authenticatie)
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezePseudoniemNogBeschikbaar',
array(
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem));
Output positief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Pseudoniem is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Pseudoniem bestaat al');

// ** t.b.v. de verenigingszaken zoekpagina **
// A.1 Zoek alle bij de query passende hcc leden
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
$request = xmlrpc_encode_request(
'ZoekHCCLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Groepering' => $Groepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (eerste deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| emailadres | (eerste deel van) e-mail adres |
| gebruikersnaam | (eerste deel van) de login naam |
| pseudoniem | (eerste deel van) het pseudoniem |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| niet_leden | het volledige niet-lid lidnummer |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'ZoekMethode' => $ZoekMethode,
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' => array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'sn' => $sn,
'givenName' => $givenName,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccHuisToevoeging' => $hcchuisToevoeging,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'ProfielBekend' => 'TRUE' | 'FALSE'])*);
Output negatief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. beheer.hcc.nl **
// A.3 Zoek alle bij de query passende hcc leden van deze groepering
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'ZoekGroeperingsLid',
array(
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Groepering' => $groepering,
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Bijeenkomst' => $Bijeenkomst,] // Alleen voor gebruik op de
// bijeenkomsten aanwezigheidsregistratie pagina
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| nieuwe_leden | YYYYMMDD vanaf waar gezocht moet worden |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| kaderleden | n.v.t. |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' =>
[array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'cn' => $cn,
'sn' => $sn,
'givenName' => $givenName,
'hccAchternaam' => $hccAchternaam,
'hccTussenVoegsels => hccTussenVoegsels,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem)]*));
Output negatief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker(s) niet gevonden' | 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten **
// A.4 Lid bezoekt bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'LidBezoektBijeenkomst',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
'hccLidnr' => $hccLidnr, // lid dat aanwezig gemeld moet worden
['correctie' => $hccLidnr,] // lid dat gecorrigeerd moet worden
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'TRUE',
'Message' => 'Bezoeker weggeschreven',
'Results' => array(
// info van deze bezoeker
'cn' => $cn, // cn (Verbeek, H.J.)
'hccGeslacht' => $hccGeslacht, // hccGeslacht van de bezoeker
'groeperingslid' => $groeperingslid, // TRUE of FALSE: is deze persoon lid van deze groepering
'mijnGroeperingen' => $mijnGroeperingen, // komma-gescheiden lijst (regio, [hccIG]*)
'aantalBezoeken' => $aantalBezoeken, // hoe vaak heeft dit lid deze bijeenkomst bezocht
// info van de bijeenkomst
'AantalBezoekers' => $AantalBezoekers); // aantal bezoekers van deze bijeenkomst
Output negatief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.5 Vraag Lidgegevens token aan (geldig voor dit lid, en deze groepering, op deze datum)
// Als geen datum gegeven is, dan is het token vandaag geldig
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'VraagLidgegevensTokenAan',
array(
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'hccLidnr' => $hccLidnummer, // vraag het token voor dit lid aan
'groepering' => $groepering, // zoek binnen deze groepering
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'TRUE',
'Message' => 'Token opgevraagd',
'groepering' => $Groepering,
'token' => $token,
'sn' => $sn);
Output negatief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.6 Toon bezoekersoverzicht
// (authenticatie op basis van lidnummer en bezoekersregistratie token)
$request = xmlrpc_encode_request(
'GeefBezoekersOverzicht',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'token' => $token,
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'TRUE',
'Message' => 'Bezoekersoverzicht opgevraagd',
'Bezoekers' => $bezoekers,
['Locatie' => $Locatie]);
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// A.7 Geef het array met alle locaties
// (of beperk dit tot de locaties van de groepering $Groepering)
// Desgewenst worden alle resultaten waarbij hccToonInJoomla aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// Desgewenst worden alle resultaten waarbij ToonOpKaderNet aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocaties',
array(
['Groepering' => $hccGroepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']);
Output positief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);
Output negatief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'FALSE',
'Message' => 'Locaties niet beschikbaar',
'ExtraInfo' => 'Geen locaties gevonden voor groepering $hccGroepering',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);

// A.8 Registreer een niet-hcclid als bezoeker tijdens een bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'RegistreerGast',
array(
'AccountNaam' => $lidnr, // credentials
'AccountCode' => $AccountCode, // credentials
'token' => $token, // credentials
'Bijeenkomst' => $groepering,
'geslacht' => $geslacht,
'naam' => $naam,
'mail' => $mail,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'buitenland' => $buitenland,
['nietLidNummer' => $nietLidNummer,]
['instructies' => $instructies,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $aanroep,
'Status' => 'TRUE',
'Message' => 'Niet-lid als bezoeker geregistreerd',
'Result' => $result_array);

// A.9 Geef het array met alle locatienamen
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocatieNamen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']));
['KaderMutatieFilter' => '' | 'TRUE']));

Output positief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));
Output negatief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'FALSE',
'Message' => 'Locatienamen niet beschikbaar',
'ExtraInfo' => 'Geen locatienamen gevonden',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));

// A.10 Schrijf een niet-lid in op een bulletin
// (2019.12.05: wordt actief gebruikt in Joomla module)
// Deze aanroep mag *ook* worden gebruikt om een wel-lid in te schrijven.
// Voorwaarde is dat bewezen is dat er controle bestaat over het opgegeven email adres
$request = xmlrpc_encode_request(
'SchrijfNietlidInOpBulletin',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'hccOptin' => $hccOptin, // bulletin waarop ingeschreven wordt
'hccOptinSource' => $hccOptinSource, // site waar aanmelding vandaan komt
'Email' => $Email, // niet-lid: email adres
'Naam' => $Naam, // niet-lid: naam
['hccLidNummer' => $hccLidNummer,] // optioneel: ik ben lid, dit is mijn lidnummer
['Postcode' => $Postcode,] // optioneel: niet-lid: postcode
['Huisnummer' => $Huisnummer,] // optioneel: niet-lid: huisnummer
['hccGeslacht' => $hccGeslacht,] // optioneel: niet-lid: geslacht (M/V/O)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'TRUE',
'Message' => 'Inschrijving op bulletin gelukt');
Output negatief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist',
'ExtraInfo' => 'Invalid DN syntax' |
'Invalid credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.11 Toon bezoekers aantallen
// (authenticatie op basis van AccountNaam en AccountCode of token)
//
// ==> Mag weg: laatste aanroep 2018.12.15 <==
//
$request = xmlrpc_encode_request(
'GeefBezoekersAantallen',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'token' => $token,
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersAantallen',
'Status' => 'TRUE',
'Message' => 'BezoekersAantallen opgevraagd',
'Datum' => $datum,
'Bijeenkomst' => $Bijeenkomst,
'Bezoekers' => array(
[HCC!seniorenacademie] => Array(
[Gorinchem] => 15
[Woerden] => 36)
...));
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersAantallen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// ** t.b.v. Joomla module Bas
// A.12 GeefAlleBulletins
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleBulletins',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefAlleBulletins',
'Status' => 'TRUE',
'Message' => 'Bulletins opgevraagd',
'bulletins' => $bulletins);

// ** t.b.v. Joomla module Bas
// A.13 ExpandeerPostcode
// (geen authenticatie)
$request = xmlrpc_encode_request(
'ExpandeerPostcode',
array(
'postcode' => $postcode,
'huisnummer' => $huisnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'ExpandeerPostcode',
'Status' => 'TRUE',
'Message' => 'Postcode opgevraagd',
'detailgegevens' => $detailgegevens);

// ** t.b.v. Joomla module Bas
// A.25 UpdateNAW
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateNAW',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'geslacht' => $geslacht,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'toevoeging' => $toevoeging,
'straat' => $straat,
'woonplaats' => $woonplaats,
'landcode' => $landcode,
'email' => $email,
'voornaam' => $voornaam,
'voorletters' => $voorletters,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateContactGegevens',
'Status' => 'TRUE',
'Message' => 'Contactgegevens bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.18 NormaliseerTelefoon
// (geen authenticatie)
$request = xmlrpc_encode_request(
'NormaliseerTelefoon',
array(
'hccLand' => $hccLand,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'NormaliseerTelefoon',
'Status' => 'TRUE',
'Message' => 'Telefoonnummer genormaliseerd',
'Telefoonnummer' => $Telefoonnummer);

// ** t.b.v. Joomla module Bas
// A.20 UpdateMobiel
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateMobiel',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateMobiel',
'Status' => 'TRUE',
'Message' => 'Mobiel nummer bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.21 HaalIGBedragenOp
// Geef alle IG's waar je zelf lid van kunt worden, inclusief het bijbehorende bedrag
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalIGBedragenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalIGBedragenOp',
'Status' => 'TRUE',
'Message' => 'Interessegroepen en bedragen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.22 HaalTariefGroepenOp
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalTariefGroepenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalTariefGroepenOp',
'Status' => 'TRUE',
'Message' => 'Tariefgroepen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.23 PasInteressegroepAan
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasInteressegroepAan',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
['nieuw' => $IG_lijst_nieuw,]
['weg' => $IG_lijst_weg,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'PasInteressegroepAan',
'Status' => 'TRUE',
'Message' => 'IG keuzen aangepast');

// ** t.b.v. Joomla module Bas
// A.24 GeefSSOUrls
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefSSOUrls',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefSSOUrls',
'Status' => 'TRUE',
'SSO_urls' => $sso_urls,
'Message' => 'Single Sign On URLs opgevraagd');

// ** t.b.v. de verenigingszaken beheer pagina **
// A.26 Verwijder een niet-lid record
$request = xmlrpc_encode_request(
'VerwijderNietLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'hccLidnr' => $hccLidnummer, // het te verwijderen niet-lid nummer
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

Output positief:
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'TRUE',
'Message' => 'Niet-lid record verwijderd',

Output negatief:
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'FALSE',
'Message' => 'Niet-lid record niet gevonden');
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** HenZ **
// ** t.b.v. daily cron job **
// ** t.b.v. dagelijkse opschoon jobs Joomla template sites **
// C.1 Vraag de lijst met uitgeschreven leden op
// Dit kan beperkt worden tot een bepaalde regio of interessegroep
// Daarnaast kan het tijdvak waarin gezocht wordt vrij gekozen worden
// (gesteld dat de LDAP database nog leden uit die periode bevat)
// Antwoord: lijst met (lidnummer, hccLogin, sn,
// datum einde lidmaatschap (formaat:YYYYMMDD))

==> GeefUitgeschrevenLeden <== (oud: GeefOpgezegdeLeden)

$request = xmlrpc_encode_request(
'GeefUitgeschrevenLeden',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccRegio' => $hccRegio, // of leeg
'hccIg' => $hccIg, // of leeg
'datum_vanaf' => $datum_sinds, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: 3 dagen geleden)
'datum_tot' => $datum_tot, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: vandaag)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'TRUE',
'Message' => 'Uitgeschreven leden',
['hccRegio' => $hccRegio,]
['hccIg' => $hccIg,]
['datum_vanaf' => $datum_vanaf,]
['datum_tot' => $datum_tot,]
['Results' => array(
[array(
'hccLogin' => $hccLogin,
'hccLidNummer' => $hccLidnummer,
'sn' => $sn,
'DatumEindeLidmaatschap' => $DatumEindeLidmaatschap)]*);
Output negatief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');
</pre>

=== HCCpartner aanroepen ===
(interface versie 1) 
(oude interface, niet meer gebruiken!)

<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.1 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartner',
array('ControleerHCCLidmaatschap',
array('partnerLogin', $partnerLogin),
array('partnerPassword', $partnerPassword),
array('hccLidnummer', $hcclidnummer),
array('postcode', $postcode)));
Output positief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'TRUE'));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'));
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'),
array('Message', 'Onjuiste credentials'));

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartner',
array(
'OnbekendeAanroep',
array('parameter', $iets)));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'OnbekendeAanroep'),
array('Status', 'FALSE'),
array('Message', 'Opdracht onbekend'));
</pre>

=== HCCpartners aanroepen ===
(interface versie 2)

<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.2 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'ControleerHCCLidmaatschap',
'partnerLogin' => $partnerLogin,
'partnerPassword' => $partnerPassword,
'hccLidnummer' => $hcclidnummer,
'postcode' => $postcode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'TRUE',
['ExtraInfo' => 'groepering=$groepering']); // als de partner beperkt is tot 1 groepering
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE');
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'OnbekendeAanroep',
'parameter' => $iets));
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'OnbekendeAanroep',
'Status' => 'FALSE',
'Message' => 'Opdracht onbekend');
</pre>

=== HCC-kader aanroepen ===

<pre>
// ** beheer.hcc.nl **
// F.2 Controleer of dit een kaderlid is
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'IsKaderLid',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'TRUE',
'Message' => 'Is kaderlid',
'hccLidnr' => $hccLidnr,
'cn' => $cn,
'sn' => $sn,
'hccRol' => $hccRol,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward);
Output negatief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Is geen kaderlid');

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.4 Vraag alle groeperingen op
// Het is mogelijk om een groepering te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// ToonInOverzichtenFilter : attribuut 'hccToonInOverzichten'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// BulletinsFilter : attribuut 'hccBulletins'
// EmailFilter : attribuut 'hccFunctionalEmail'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleGroeperingen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['ToonInOverzichtenFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['BulletinsFilter' => '' | 'TRUE',]
['EmailFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE'));
Output positief:
$reply = array(
'Action' => 'GeefAlleGroeperingen',
'Status' => 'TRUE',
'Message' => 'Lijst met groeperingen opgevraagd',
'Result' => $groeperingen,
['JoomlaFilter' => 'TRUE',]
['ToonInOverzichtenFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']);

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.5 Vraag alle kaderrollen op
// Het is mogelijk om een kaderrol te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleKaderRollen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']));
Output positief:
$reply = array(
'Action' => 'GeefAlleKaderRollen',
'Status' => 'TRUE',
'Message' => 'Lijst met kaderrollen opgevraagd',
'Result' => $kaderrollen,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']);

// ** t.b.v. de kantoor-beheerpagina **
// F.9 Geef de gevevens van de mailbox van dit kaderlid
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
$request = xmlrpc_encode_request(
'GeefKadermailGegevens',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer));
Output positief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'kadermail_omvang' => $Formaat,
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald);
Output negatief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid'));

// ** t.b.v. de Joomla Kadernet module **
// * F.10 MuteerGroeperingSamenstelling
// (authenticatie op basis van lidnummer, JoomlaToken en siteID en als extra hccCode van de aanvrager)
$request = xmlrpc_encode_request(
'MuteerGroeperingSamenstelling',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccCode' => $hccCode,
'groepering' => $groepering,
'hccLidnummer => $hccLidnummer, // lidnummer van het te muteren hcc lid
'hccRol' => $hccRol, // de nieuwe dan wel op te heffen rol
// de rol 'ALLES_WEG' ruimt alle rollen van dit hcc lid voor deze groepering op
'actie' => 'Nieuw' | 'Weg',
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress,]
Output positief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'TRUE',
'Message' => 'Groepering samenstelling aangepast',
['ExtraInfo' => 'Bedankmail gestuuurd aan ex-kaderlid']);
Output negatief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid' |
'Oude rol niet gevonden' |
'Nieuwe rol kan niet samen met bestaande rol' |
'Alleen voorzitter of secretaris kan kadermutaties uitvoeren']);
</pre>

=== HCC-groepering aanroepen ===

<pre>
// I.2 controleer of een gebruiker bestaat op basis van de combinatie
// lidnummer + postcode + huisnummer
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
// (alternatieve authenticatie mogelijk door lidnummer + hcc-code in te vullen)
//
// Aan de aanroeper worden zekere eisen gesteld:
// * dient een rol te vervullen binnen de groepering 'FOR'(forum)
// * dan wel dient de rol 'VRBK' (vraagbaak) te vervullen binnen een groepering
//
// Er wordt door de gehele leden-database gezocht, waarna terug wordt gegeven
// * of dit hcc lid inderdaad bestaat
// en, als het om een aanvraag van een vraagbaak vrijwilliger gaat,
// * tevens of het gezochte hcc lid deel uitmaakt van zijn groepering
//
// ==> Mag weg: laatste aanroep 2018.07.27 <==
//
$request = xmlrpc_encode_request(
'IsHCCLid',
array(
'hccLogin' => [$hccLogin | $hccLidnummer],
'userPassword' => [$userPassword | $hccCode],
'zoekhccLidnr' => $zoekhccLidnr,
'zoekhccPostcode' => $zoekhccPostcode,
'zoekhccHuisnr' => $zoekhccHuisnr,
'zoekgroepering' => $zoekgroepering));
Output positief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gecontroleerd',
['Groeperingslid' => $IsGroeperingLid]));
Output negatief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker bestaat niet' |
'Onjuiste credentials' |
'Wel HCC lid, maar geen lid van groepering $groepering' |
'Onvoldoende rechten' |
'Vul alle verplichte velden in!'));
</pre>

=== HenZ aanroepen ===

<pre>
// I.3 Geef de einddatum van een actief dan wel uitgeschreven lid
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'GeefhccEindDatum',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'TRUE',
'hccLidnummer' => $hccLidnummer,
'hccLogin' => $hccLogin,
'hccEindDatum' => $hccEindDatum ('yyyymmdd' | ''));
Output negatief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Invalid credentials' |
'Lidnummer niet gevonden');
</pre>

=== (Forum,vraagbaak) onderwerpen ===

<pre>
// L.1 MaakOnderwerp
$request = xmlrpc_encode_request(
'MaakOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'description' => $description,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp is aangemaakt',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster');

// L.2 VerwijderOnderwerp

$request = xmlrpc_encode_request(
'VerwijderOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'TRUE',
'onderwerp' => $onderwerpID,
'Message' => 'Onderwerp is verwijderd',
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Ruim eerst alle geautoriseerde gebruikers op' |
'Kan onderwerp niet verwijderen');

// L.3 GeefOnderwerpen
// Geef het array met de lijst van onderwerpen voor de betreffende groepering
//
$request = xmlrpc_encode_request(
'GeefOnderwerpen',
array(
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'TRUE',
'Message' => 'Onderwerpen opgevraagd',
'onderwerpen' => $onderwerpen); // het array met onderwerpen
Output negatief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!');

// L.4 MuteerOnderwerp
// Pas de description van een onderwerp aan
//
$request = xmlrpc_encode_request(
'MuteerOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'description' => $description,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp aangepast',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Onderwerp behoort bij andere groepering');

// L.5 MuteerOnderwerpAutorisatie
// Geef kaderlid $kaderLidNr de autorisatie MOD, VRBK of RED bij onderwerp $onderwerp
// (of haal die autorisatie weg)
$request = xmlrpc_encode_request(
'MuteerOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'onderwerp' => $onderwerpID,
'kaderLidNr' => $kaderLidNr,
'hccAutorisatie' => 'MOD' | 'VRBK' | 'RED',
['verwijder' => 'TRUE']));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Onderwerp autorisatie aangepast');
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Geen kaderlid' |
'Onjuiste autorisatie opgegeven' |
'Onderwerp bestaat niet');

// L.6 ToonOnderwerpAutorisatie
$request = xmlrpc_encode_request(
'ToonOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Autorisaties opgehaald',
'onderwerp' => $onderwerpID,
'description' => $description,
'autorisaties' =>
[Array(
'hccLidnummer' => $hccLidnummer
'cn' => $cn
'hccAutorisatie' => {komma-gescheiden autorisaties})]);
Output negatief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet');
</pre>

=== Microsoft Dynamics Cloud (Cayentis) onderwerpen ===

<pre>
// M.1 Upload_CSV_bestand
// De CRM proxy upload de dagelijkse CSV synchronisatie-bestanden naar de XML-RPC server
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Upload_CSV_bestand',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'CSV_bestand_type' => '1' | '2' | '3' , // 1=Contactpersonen/Hoofdlidmaatschappen
// 2=Gremiumlidmaatschap codes
// 3=Gremiumlidmaatschappen
'CSV_bestand' => $CSV_bestand)); // het CSV bestand (base64 encoded)
Output positief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'TRUE',
'Message' => 'Bestand opgeslagen');
Output negatief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.2 SchrijfNieuwLidIn
//
// Maak in het CRM een nieuw HCC lid aan
// De NAW gegevens worden in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'SchrijfNieuwLidIn',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'NAWgegevens' => $NAW_Array,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress);
// $NAW_array = array(
// 'GeboorteDatum' => $geboortedatum,
// 'Geslacht' => $geslacht,
// 'Voornaam' => $voornaam,
// 'Voorletters' => $voorletters,
// 'Tussenvoegsel' => $tussenvoegsel,
// 'Achternaam' => $achternaam,
// 'Straatnaam' => $straatnaam,
// 'Huisnummer' => $huisnummer,
// 'HuisnummerToevoeging' => $huisnummertoevoeging,
// 'Woonplaats' => $woonplaats,
// 'Postcode' => $postcode,
// 'Land' => $land,
// 'Telefoonnummer' => $telefoonnummer,
// 'MobielNummer' => $mobielnummer,
// 'Mail' => $mail,
// 'IBAN' => $IBAN,
// 'Interessegroep' => $IGs, // komma-gescheiden lijst met IG's
// 'Geschenk' => $geschenk,
// 'Actiecode' => $actiecode,
// 'Voorwaarden' => $Akkoord); // 'Akkoord'
)
Output positief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'TRUE',
'Message' => 'nieuw lid ingeschreven',
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode);
Output negatief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.3 Verwerk_JSON_mutatie
// De CRM proxy kan NAW en/of IG mutaties en/of hccCode mutaties live doorgeven
// Deze gegevens worden in JSON in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Verwerk_JSON_mutatie',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'mutatie_type' => '1' | '2', // 1=Contactpersoon/Hoofdlidmaatschap
// 2=Gremiumlidmaatschap
'JSON_mutatie' => $JSON_mutatie)); // de JSON payload
Output positief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'TRUE',
'Message' => 'Mutatie verwerkt');
Output negatief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.4 Vertaal landcode
// Het CRM werkt met numerieke landcodes, wij met cijfers
// Vertaal die
// Er moet in de aanroep 1 veld aanwezig zijn, beide waarden komen in het antwoord terug
$request = xmlrpc_encode_request(
'ISO_landcode',
array(
['ISO_numeriek' => $ISO_numeriek,]
['ISO_code ' => $ISO_code]));
Output positief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'TRUE',
'Message' => 'ISO code lookup geslaagd',
'ISO_numeriek' => $ISO_numeriek,
'ISO_code ' => $ISO_code,
'ISO_benaming' => $ISO_benaming); // de descriptive name van deze ISO code
Output negatief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'FALSE',
'Message' => 'Kan geen bijpassende vertaling vinden'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.5 MuteerAanmeldingsformulier
// Sla een JSON veld op in de XML-RPC server zodat deze weer opgehaald kan worden door de websites
// Authenticatie op basis van hccLidnummer en JoomlaToken
// Deze mutaties mogen alleen door HN#WM of SITE#WM gedaan worden.

$request = xmlrpc_encode_request(
MuteerAanmeldingsformulier,
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
'formulierdata' => $formulierdata, // JSON veld met alle gegevens voor het aanmeld formulier
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress ));
Output positief:
$reply = array(
'Action' => 'MuteerAanmeldingsformulier',
'Status' => 'TRUE',
'Message' => 'aanmeldingsformulier bijgewerkt';

// M.6 HaalAanmeldingsformulier
// (geen authenticatie)
$request = xmlrpc_encode_request(
HaalAanmeldingsformulier,
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalAanmeldingsformulier',
'Status' => 'TRUE',
'formulierdata' => $formulierdata); // JSON veld met alle gegevens voor het aanmeld formulier

// M.7 GeefFactuurOverzicht
// (authenticatie op basis van hccLidnummer + JoomlaToken + siteID
$request = xmlrpc_encode_request(
GeefFactuurOverzicht,
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefFactuurOverzicht',
'Status' => 'TRUE',
'FactuurOverzicht' => $FactuurOverzicht);
// $FactuurOverzicht =
// array(
// array(
// 'FactuurID' => 'a5b93460-4536-ea11-a813-000d3a2c53fa',
// 'FactuurNummer' => '200118673J5'
// 'FactuurDatum' => '2020-01-15'
// 'bedrag' => 42.37
// 'BetaalStatus' => 0]));
// )

// M.8 HaalFactuur
// (authenticatie op basis van JoomlaToken of FactuurToken)
$request = xmlrpc_encode_request(
HaalFactuur,
array(
'hccLidnummer' => $hccLidnummer,
['JoomlaToken' => $JoomlaToken,]
['FactuurToken' => $FactuurToken,]
'FactuurNummer' => $FactuurNummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalFactuur',
'Status' => 'TRUE',
'factuur' => $factuurgegevens);
// $factuurgegevens =
// array(
// 'FactuurNummer' => $FactuurNummer,
// 'FactuurDatum' => $FactuurDatum,
// 'FactuurID' => $FactuurID,
// 'Bestandsnaam' => $Bestandsnaam,
// 'PDF' => $PDF) // base64 encoded PDF
</pre>

=== Echo test ===

<pre>

// t.b.v. controle of de verbinding met de XML-RPC server functioneert
// Eenvoudige echo test

$request = xmlrpc_encode_request(
'echo',
array(
'What' => $string,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'echo',
'Status' => 'TRUE',
'Message' => $string);
</pre>

=== HenZ XML-RPC interface ===

Overzicht van XML-RPC procedures die bij HenZ draaien
(worden via de Hobbynet XML-RPC server afgehandeld)

<pre>
- Action=2
wijzig gebruikersnaam en wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=3
controleer of een gebruikersnaam bestaat
(XML-RPC server voert de hccnet XML-call uit, zie 8.2)

- Action=4
creer een nieuwe gebruiker. Per lidnummer is er 1 account. Als er al een
account voor dit lidnummer bestaat wordt het bestaande account hernoemd.
(XML-RPC server voert de hccnet XML-call uit, zie 8.1)

- Action=5
wijzig wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=7
Uitgeschreven lid is weer actief lid geworden
(Wordt aangeroepen vanuit de cronjob)

- Action=8
Lid heeft een nieuwe hcc-code gekregen
(Wordt aangeroepen vanuit de cronjob)
</pre>

=== Release notes ===
<pre>
2012.02.08 Wijzigingen versie 5:
- 4.1 verwijder_hcc_Lidnummer i.p.v. hcc_Lidnummer
- 4.1 optionele extra parameter verwijder_hccLogin
- Optionele parameters aangegeven
- Vanwege de duidelijkheid de beheerLogin en beheerPassword velden
bovenin de betreffende aanroepen gezet
(De volgorde van de parameters is niet relevant, dus dit is geen
interface-aanpassing)
2012.02.16 Wijzigingen versie 6:
- 2.1/2.2/2.3 geef ook cn en sn terug na aanpassen van het wachtwoord
- 3.1 geef cn en sn terug na aanmaken nieuwe gebruiker
2012.02.27 Wijzigingen versie 7:
- Neem de XML-RPC interface van HenZ in deze XML-RPC server op
8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gegevens tevens in LDAP op
- 2.1 wijzig wachtwoord - optie 1
* Nieuw wachtwoord is verplicht, niet optioneel
* wijzigingen worden naar hccnet.nl doorgezet
- 2.2 wijzig wachtwoord, optie 2
* Nieuw wachtwoord is verplicht, niet optioneel
* gebruikersnaam kan niet meer via deze interface aangepast worden
* wijzigingen worden naar hccnet.nl doorgezet
- 2.3 wijzig wachtwoord, optie 3
* wijzigingen worden naar hccnet.nl doorgezet
2012.03.26 Wijzigingen versie 8:
- Breidt de XML-RPC interface van HenZ in deze XML-RPC server uit met
8.2 Controleer of de gebruikersnaam op dit moment bestaat
2012.04.09 Wijzigingen versie 9:
- Vervang alle 'ldap' aanroepen door 'HCCldap' aanroepen
- documentatie van HenZ call action=2 aangepast, action=5 toegevoegd
2012.05.03 Wijzigingen versie 10:
- 1.1 / 1.2 / 1.3 geven nu ook 'ProfielBekend' terug om uniek te bepalen
of deze bezoeker een first-time-login pagina te zien dient te krijgen
- documentatie van 2.1 (wijzig wachtwoord) aangepast:
2.1 kan alleen als profiel is doorlopen
- nieuwe procedure t.b.v. zoekscherm PC30
* A.1 ZoekHCCLid
- hiervoor is de database met diverse velden uitgebreid
(postcode, e-mailadres, huisadres, woonplaats, land, telefoonnummer)
Dit heeft impact op diverse andere procedures (t.b.s.)
- nieuwe procedure t.b.v. 'gewone' profielpagina
* B.1 GeefDBFPersoonID
- nieuwe procedure t.b.v. cron-job
* C.1 GeefOpgezegdeLeden
2012.05.10 Wijzigingen versie 11
- 1.3 GebruikerBestaatControle
* nieuwe parameter: hccPseudoniem
* nieuw veld in antwoord: hccPseudoniem
- 2.3 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 2.4 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 3.1 NieuweGebruiker
* nieuwe parameter: hccPseudoniem
- 8.1 MaakGebruikerAan
* nieuwe parameter: nieuw_hccPseudoniem
* alle parameters zijn verplicht (niet langer optioneel)
* nieuw antwoord: Gegevenscombinatie onjuist
- 8.3 IsDezePseudoniemNogBeschikbaar
* Nieuwe procedure t.b.v. 1e keer doorlopen profielpagina
- A.1 ZoekHCCLid
* 'Zoeklimiet bereikt' wordt als ExtraInfo meegegeven
* nieuwe velden in antwoord: hccPseudoniem en hccLogin
- B.1 GeefDBFPersoonID
* Zoeken kan nu ook op hccLogin en op hccPseudoniem
- C.1 GeefOpgezegdeLeden
* Geef nu ook hccLogin en hccPseudoniem terug
2012.05.14 Wijzigingen versie 12
- 1.x GebruikerBestaatControle
* Geef ook DBFPersoonID terug
- 4.1 Gooi een gebruiker weg.
* Haal ongebruikte parameter hccLogin weg
- 5.1 Wijzig hccIG
* Haal ongebruikte parameter hccLogin weg
- 6.1 Wijzig hccRegio
* Haal ongebruikte parameter hccLogin weg
- 7.1 Wijzig hccRol
* Haal ongebruikte parameter hccLogin weg
2012.05.20 Wijzigingen versie 13
- A.1 ZoekHCCLid
* Geef resultaten gestructureerder formaat
* Geef in ExtraInfo weer hoeveel echte resultaten er gevonden zijn
- C.1 GeefOpgezegdeLeden
* Geef resultaten in gestructureerder formaat
2012.06.03 Wijzigingen versie 14
- 3.1 NieuweGebruiker
* Geef ook DBFPersoonID mee
2012.08.17 Wijzigingen versie 15
- C.1 GeefOpgezegdeLeden
* Geef ook hccLogin in het antwoord terug
- D.1 HCCpartner/ControleerHCCLidmaatschap
* Nieuwe aanroep
2012.09.29 Wijzigingen versie 16
- Alle cron gerelateerde opdrachten verwijderd
* 3.1 NieuweGebruiker
* 4.1 GooiGebruikerWeg
* 5.1 WijzigHccIG
* 6.1 WijzigHccRegio
* 7.1 WijzigHccRol
2012.10.28 Wijzigingen versie 17
- nieuwe procedure t.b.v. PC30 beheerpagina
* A.2 HaalPC30Token
- nieuwe procedure t.b.v. Drupal profielpagina
* 2.4 vervallen
(WijzigGebruikersGegevens op basis van pseudoniem)
* 2.5 WijzigGebruikersGegevens
Nieuwe keuze: wijzig pseudoniem
2012.11.14 Wijzigingen versie 18
- 1.x GebruikerBestaatControle
* Geef ook mail in het antwoord terug
2012.11.30 Wijzigingen versie 19
- E.1 HCCkader/WijzigGebruikersGegevens
* Nieuwe aanroep
- F.1 / F.2 / F.3 ControleerKaderlid
* Nieuwe aanroep
2012.12.18 Wijzigingen versie 20
- Haal DBFPersoonID weg uit alle aanroepen en alle resultaten
* Antwoord van 1.x GebruikerBestaatControle
* B.1 GeefDBFPersoonID opgeheven
- A.1 ZoekHCCLid geeft nu ook hccMobiel terug (t.b.v. PC30 zoekpagina)
- C.1 GeefOpgezegdeLeden verder uitgewerkt:
* Geeft alleen de door Drupal gebruikte velden 'hccLogin' en 'hccEindDatum'
terug in het antwoord
* Geeft nu 'echte' antwoorden i.p.v. dummy resultaten
- F.1 ControleerKaderlid geeft nu ook optioneel 'sn' en 'givenName'
terug (in de beheer-variant)
2013.01.25 Wijzigingen versie 21
- A.1 ZoekHCCLid uitgebreid
* Geeft nu ook hccBeginDatum, hccEindDatum en hccRol terug
2013.02.02 Wijzigingen versie 22
- A.1 ZoekHCCLid
* Interface aangepast
- A.3 ZoekGroeperingsLid
* Nieuwe aanroep
- F.4 GeefAlleGroeperingen
* Nieuwe aanroep
- F.5 GeefAlleKaderRollen
* Nieuwe aanroep
2013.03.01 Wijzigingen versie 23
- A.3 ZoekGroeperingsLid
* Geeft andere resultaten terug
- 2.2 WijzigWachtwoord
* Geeft nu ook hccLogin terug (voor ww-vergeten op de Drupal site)
- HCCenquete implementatie
* G.1 Expandeer NL postcode
* G.2 Haal lidgegevens op
* G.3 Pas lidgegevens aan
2013.03.18 Wijzigingen versie 24
- ZoekGroeperingsLid op basis van token
- A.4 Lid bezoekt bijeenkomst
* nieuwe aanroep
- A.5 VraagLidgegevensTokenAan
* nieuwe aanroep
2013.04.07 Wijzigingen versie 25
- D.1 HCCpartner/ControleerHCCLidmaatschap
Simpeler interface ontwikkeld ('HCCpartners' i.p.v. 'HCCpartner')
- G.3 mag ook Tussenvoegsels aanpassen
2013.04.25 Wijzigingen versie 26
- H.1 HCC-groepering / GebruikerBestaatControle
Nieuwe interface voor validatie vanaf groeperings websites
2013.05.03 Wijzigingen versie 27
- 2.6 HaalOptInKeuzen
* nieuwe aanroep
- 2.7 SchrijfOptInKeuzen
* nieuwe aanroep
- 2.8 HaalOptInLijst
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* nieuwe aanroep
- HCCpartners aanroep nieuwe interface ('Action' => 'ControleerHCCLidmaatschap')
2013.07.05 Wijzigingen versie 28
- 8.1 MaakGebruikerAan
* extra parameters (mail, hccPseudoniem) in het antwoord
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra parameter (mailHccnet)
- A.1 ZoekHCCLid
* extra parameter (mailHccnet)
- A.3 ZoekGroeperingsLid
* extra parameter (mailHccnet)
2013.08.31 Wijzigingen versie 29
- F.1 / F.2 / F.3 HCC-kader / ControleerKaderlid
* extra output parameter (hccKaderMail)
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra output parameter (hccForumLogin)
- H.1 HCC-groepering / GebruikerBestaatControle
* komma-gescheiden lijst met groeperingen mogelijk
* extra output parameter (mailHccnet)
2013.12.26 Wijzigingen versie 30
- 3.1 Geef mijn lidnummer
* nieuwe aanroep
- A.1 ZoekHCCLid
* geef nu ook 'ProfielBekend' terug om aan de PC30 omgeving door te geven
dat het wachtwoord niet veranderd mag worden door PC30
- A.6 GeefBezoekersOverzicht
* geef nu ook 'Locatie' terug indien van toepassing
- A.7 GeefLocaties
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* parameters aangepast
* authenticatie op basis van hccLogin + userPassword of lidnummer + hcc-code
* geen algemene hcc-forum authenticatie meer mogelijk
- F.7 ControleerKaderlidGroep
* Nieuwe aanroep
2014.02.01 Wijzigingen versie 31
- A.8 RegistreerGast
* nieuwe aanroep
- H.2 MatchPostcodeMetRegio
* nieuwe aanroep
- nieuwe interface (losse, unieke aanroepen, niet meer gegroepeerd)
2014.09.27 Wijzigingen versie 32
- C.1 GeefOpgezegdeLeden hernoemd naar GeefUitgeschrevenLeden
- I.3 GeefhccEindDatum
* nieuwe aanroep
- Action=7 en Action=8 toegevoegd aan de HenZ interface
2014.12.12 Wijzigingen versie 33
- F.1 / F.2 / F.3 HCC-kader / IsKaderLid
* extra output parameter (mail, mailHccnet, hccKaderForward)
- F.8 HCC-kader / ZetKaderForward
* nieuwe aanroep
2015.05.06 Wijzigingen versie 34
- GeefMijnGegevens
* nieuwe aanroep
- ValideerPCActiveAbonnee
* vervallen
- 1.4 GebruikerBestaatControle
* extra output parameter (hccKaderForward)
- D.1 HCCpartner/ControleerHCCLidmaatschap
* optionele extra output parameter (ExtraInfo)
2015.09.27 Wijzigingen versie 35
- HeeftForumCredentials
* vervallen
2015.11.20 Wijzigingen versie 36
- SchrijfNietlidInOpBulletin
* nieuwe aanroep
2015.12.13 Wijzigingen versie 37
- serverID als optionele parameter
- SchrijfNietlidInOpBulletin
* Maak velden optioneel
2016.01.05 Wijzigingen versie 38
- A.7 GeefLocaties
* optionele parameter JoomlaFilter
- F.4 GeefAlleGroeperingen
* optionele parameter JoomlaFilter
- F.5 GeefAlleKaderRollen
* optionele parameter JoomlaFilter
2016.01.15 Wijzigingen versie 39
- H.3 GeefMijnGegevens
* geeft nu ook hccOptIn terug
* geeft nu ook JoomlaToken terug
- H.4 PasOptInKeuzeAan
* nieuwe aanroep
- SiteID en RemoteID als optionele parameter
2016.03.17 Wijzigingen versie 40
- H.5 ZoekKaderLeden
* nieuwe aanroep
2016.03.20 Wijzigingen versie 41
- ServerID, SiteID en RemoteID als optionele parameters bij alle aanroepen
- A.7 GeefLocaties
* optionele parameter KadernetFilter
- A.9 GeefLocatieNamen
* optionele parameter KadernetFilter
- F.4 GeefAlleGroeperingen
* optionele parameter KadernetFilter
- F.5 GeefAlleKaderRollen
* optionele parameter KadernetFilter
- F.6 WijzigHccRol
* vervallen
- F.7 IsGroeperingsKaderlid
* vervallen
- 8.3 IsDezePseudoniemNogBeschikbaar
* vervallen
- 2.7 SchrijfOptInKeuzen
* vervallen
- 2.5 WijzigGebruikersGegevens (hccPseudoniem)
* vervallen
- H.2 MatchPostcodeMetRegio
* vervallen
2016.04.02 Wijzigingen versie 42
- H.6 GeefMijnKaderDetails
* nieuwe aanroep
2016.07.03 Wijzigingen versie 43
- Ubuntu 16.04 aanpassingen (PHP versie 7) beschreven
2016.09.01 Wijzigingen versie 44
- H.5 ZoekKaderLeden
* extra parameter 'hccMobiel'
2016.10.13 Wijzigingen versie 45
- H.3 GeefMijnGegevens (dedecated Joomla aanroep)
* hccForumLogin weg als parameter
* Als het om een webmaster gaat, vul dan eventueel hccRegio of hccIG aan
met die groepering, ook als hij geen lid is van die groepering
- I.4 GebruikerBestaatControle
* hccForumLogin weg als parameter
2016.12.01 Wijzigingen versie 46
- 8.3 IsDezePseudoniemNogBeschikbaar teruggezet
2017.05.28 Wijzigingen versie 47
- H.7 GeefMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
- H.8 ZetMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
2017.09.01 Wijzigingen versie 48
- A.10 SchrijfNietlidInOpBulletin nu alleen voor 1 bulletin tegelijk
- 2.2 WijzigGebruikersGegevens (op basis van gebruikersnaam en wachtwoord)
is vervallen (was een oude Drupal aanroep)
- A.3 ZoekGroeperingsLid geeft ook hccKaderToonMobiel terug
- H.7 GeefMinimaleKaderGegevens geeft ook hccKaderToonMobiel terug
2017.11.14 Wijzigingen versie 49
- A.3 ZoekGroeperingsLid geeft geen hccKaderToonMobiel meer terug
- A.3 ZoekGroeperingsLid geeft alleen hccMobiel als hccKaderToonMobiel dat toestaat
2018.02.18 Wijzigingen versie 50
- H.6 GeefMijnKaderDetails geeft ook hccKaderToonMobiel terug
- H.9 PasKaderGegevensAan
* nieuwe aanroep
- H.3 GeefMijnGegevens geeft 3 extra parameters terug (hccKaderMail, hccKaderForward,
hccKaderToonMobiel)
- JoomlaTokens worden gevalideerd op siteID, niet langer op serverID
- diverse aanroepen kunnen nu ook via de bezoekersregistratie-proxy aangeroepen worden.
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
(GeefAlleGroeperingen, GeefAlleKaderRollen, GeefLocaties, GeefLocatieNamen)
De bezoekersregistratie aanroepen hebben enkel JoomlaToken als extra parameter nodig:
(LidBezoektBijeenkomst, GeefBezoekersOverzicht)
2018.02.26 Wijzigingen versie 51
- H.3 GeefMijnGegevens geeft extra parameter hccMobiel terug
- H.9 PasKaderGegevensAan kan nu ook kadermail password aanpassen
- K.1 ValideerToken
* nieuwe aanroep
- K.2 ValideerHCCCode
* nieuwe aanroep
2018.03.17 Wijzigingen versie 52
- H.3 Haal al mijn gegevens
Extra optie 'compact' om alleen essentiele resultaten te verkrijgen
(t.b.v. de Android bezoekersregistratie applicatie)
2018.03.25 Wijzigingen versie 53
- I.2 IsHCCLid
(Oude aanroep teruggezet, wordt nog in vraagbaak module gebruikt)
2018.07.01 Wijzigingen versie 54
* A.1 beheer authenticatie op basis van lidnummer + hccCode (tbv VZ-portal)
* A.2 HaalPC30Token weggehaald
2018.08.22 Wijzigingen versie 55
* 1.2 GebruikerBestaatControle' (op basis van hccLogin en userPassword) weggehaald
* 1.4 GebruikerBestaatControle' (op basis van zoekHccLogin of zoekHccLidnr) weggehaald
* 2.8 HaalOptInLijst weggehaald
* E.1 PasKaderWachtwoordAan weggehaald
* F.1 IsKaderLid (op basis van hccLidnr en hccCode) weggehaald
* F.3 IsKaderLid (op basis van beheerdernaam en beheerderwachtwoord) was al weg
* F.8 ZetKaderForward weggehaald
* H.1 IsGroeperingsLid weggehaald
* H.6 GeefMijnKaderDetails weggehaald
* H.7 GeefMinimaleKaderGegevens weggehaald
* H.8 ZetMinimaleKaderGegevens weggehaald
* K.1 ValideerHCCCode weggehaald
* K.2 ValideerToken weggehaald
* H.3 GeefMijnGegevens geeft omvang kader mailbox mee terug
2018.11.06 Wijzigingen versie 56
Nieuwe aanroepen t.b.v. forum en vraagbaak autorisaties
* L.1 MaakOnderwerp
* L.2 VerwijderOnderwerp
* L.3 GeefOnderwerpen
* L.4 MuteerOnderwerp
* L.5 MuteerOnderwerpAutorisatie
* L.6 ToonOnderwerpAutorisatie
* H.5 ZoekKaderLeden heeft compact optie
2018.11.16 Wijzigingen versie 57
* L.5 MuteerOnderwerpAutorisatie kent nu ook RED(acteur)
2018.12.17 Wijzigingen versie 58
* A.11 GeefBezoekersAantallen (nieuwe aanroep)
* H.10 PasUserWachtwoordAan (nieuwe aanroep)
2019.02.21 Wijzigingen versie 59
* A. 6 GeefBezoekersOverzicht geeft enkel lijst van bezoekers laatste bijeenkomst
2019.10.26 Wijzigingen versie 60
* A.4 Schrijf bezoekers niet meer automatisch in op bulletins
* H.4 PasOptInKeuzeAan kan ook door LA aangeroepen worden
Nieuwe aanroepen t.b.v. eigen implementatie van mijn.hcc.nl in de Joomla modules
* H.11 PasPseudoniemAan
* H.12 ValideerWachtwoordEisen
* H.13 PasWachtwoordAan (1: op JoomlaToken, 2: op PWResetToken)
* H.14 MaakPWResetToken
* H.15 ValideerPWResetToken
* H.16 RuimJoomlaTokenOp
* A.12 GeefAlleBulletins
* A.13 ExpandeerPostcode
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.18 NormaliseerTelefoon
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
* A.21 HaalIGBedragenOp
* A.22 HaalTariefGroepenOp
* A.23 PasInteressegroepAan
* F.10 MuteerGroeperingSamenstelling
* A.24 GeefSSOUrls
Aanpassingen gemaakt aan
8.1 MaakGebruikerAan
F.5 GeefAlleKaderRollen
2020.01.04 Wijzigingen versie 61
Nieuwe aanroepen t.b.v. IDEAL betaling hobbynet abonnees
H.17 GeefAantalDomeinen
2020.01.06 Wijzigingen versie 62
Nieuwe aanroepen t.b.v. Cayentis (CRM webproxy) implementatie
* M.1 Upload_CSV_bestand
* M.2 SchrijfNieuwLidIn
* M.3 Verwerk_JSON_mutatie
* M.4 ISO_landcode
* M.5 MuteerAanmeldingsformulier
* M.6 HaalAanmeldingsformulier
* M.7 GeefFactuurOverzicht
* M.8 HaalFactuur
* A.25 UpdateNAW
Vervallen aanroepen
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
Aangepaste aanroepen
* A.23 PasInteressegroepAan
2020.03.27 Wijzigingen versie 63
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.18 ResetHCCCode
* H.19 PasHccLoginAan
2020.04.10 Wijzigingen versie 64
Nieuwe aanroepen
* A.26 VerwijderNietLid
Aanpassingen gemaakt aan
* A.1 ZoekHCCLid: nieuwe zoekoptie 'niet_leden'
Opnieuw geimplementeerd
* A.20 UpdateMobiel
2020.11.26 Wijzigingen versie 65
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.20 MaakTestLogin
Aanpassingen gemaakt aan
- H.3 GeefMijnGegevens: optionele parameter 'hccGroepering'
Het werken met een testaccount heeft impact op de volgende aanroepen:
- G.7 GeefFactuurOverzicht
- M.8 HaalFactuur
- L.1 MaakOnderwerp
- H.14 MaakPWResetToken
- F.10 MuteerGroeperingSamenstelling
- L.4 MuteerOnderwerp
- L.5 MuteerOnderwerpAutorisatie
- H.19 PasHccLoginAan
- A.23 PasInteressegroepAan
- H.9 PasKaderGegevensAan
- H.4 PasOptInKeuzeAan
- H.11 PasPseudoniemAan
- H.13 PasWachtwoordAan
- H.18 ResetHCCCode
- A.20 UpdateMobiel
- A.25 UpdateNAW
- L.2 VerwijderOnderwerp
- A.5 VraagLidgegevensTokenAan
- 2.1 WijzigGebruikersGegevens
- H.3 GeefMijnGegevens geeft extra parameter terug (testaccount)
2021.08.01 Wijzigingen versie 66
Aanpassingen gemaakt aan
- H.4 PasOptInKeuzeAan werkt nu ook op basis van OptOutToken
2021.10.10 Wijzigingen versie 67
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
- H.21 UpdateOTP
Aanpassingen gemaakt aan
- H.3 GeefMijnGegevens geeft extra parameters terug (hccOtpKey en hccOtep)
2021.10.13 Wijzigingen versie 68
Aanpassingen gemaakt aan
- H.21 UpdateOTP
2021.11.03 Wijzigingen versie 69
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
- H.22 HeeftOtpKey
</pre>

= Aanpassingen aan de Apache omgeving =

== php.ini aanpassingen ==
De XML-RPC server zal 'ergens' een bestand moeten kunnen vinden met de
gebruikersnamen t.b.v. het authenticeren bij de LDAP-server.

Dit bestand wordt geplaatst in de map '/usr/local/hobbynet/etc'. Om dit
vanuit Apache te mogen benaderen, dient een aanpassing aan php.ini
gemaakt te worden:

/etc/php5/apache2/php.ini

include_path = ".:/usr/share/php:/usr/share/pear:/usr/local/hobbynet/etc"

== Apache modules ==
Nieuwe server geschikt maken voor XML-RPC gebruik

=== Apache modules (PHP 7) ===
Ubuntu 16.04 wordt standaard met PHP versie 7.0 uitgeleverd.
De opdrachten om de modules op te halen zijn:
apt-get install php-xmlrpc
apt-get install apache2
apt-get install ldap-utils
apt-get install php-ldap
apt-get install libapache2-mod-php

== Loadbalancer akties niet naar de logbestanden schrijven ==
De loadbalancer haalt zeer frequent een testbestand op (/test.txt), om
te controleren of de xml-server operationeel is. Dat levert extreem veel
logging op in /var/log/apache2/other_vhosts.log.

Pas de apache configuratie zo aan, dat logging van alle opvragingen
vanaf de loadbalancers uitgezet wordt.
/etc/apache2/sites-enabled/xml-server

# Mark requests from loadbalancers
SetEnvIf Remote_Addr "212\.72\.227\.93" dontlog
SetEnvIf Remote_Addr "212\.72\.227\.94" dontlog
SetEnvIf Remote_Addr "172\.31\.1\.249" dontlog
SetEnvIf Remote_Addr "172\.31\.1\.250" dontlog
CustomLog ${APACHE_LOG_DIR}/access.log common env=!dontlog

= Firewall algemeen =
In de file /etc/hobby-firewall/hobby-firewall.local wordt het script
'/usr/local/hobbynet/bin/gen_fw.sh' aangeroepen.
Deze haalt de IP adressen op uit ldap.
(.local omdat we dit ook zo doen op de webservers).

De firewall wordt 4 x per dag herstart en /etc/hobby-firewall wordt
gesynchroniseerd (1-richting van lb1 naar lb2) met de volgende crontab
entries:

Op lb1:
0 0 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 5 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 11 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 17 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 23 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null

Op lb2:
15 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 0 * * * /etc/init.d/hobby-firewall restart >/dev/null

Het encrypted backup script is verplaatst naar '/usr/local/hobbynet/local' en hernoemd naar 'backup-encrypted.bash'.
Dit is omdat deze niet mee mag worden gesynchroniseerd.

Tevens wordt 1x per dag /usr/local/hobbynet/bin gesynchroniseerd (1-richting van hcc-ldap-lb1 naar hcc-ldap-lb2)

== Aanpassingen in de firewall ==
Op de server waar de XML-RPC server staat, moeten enkele firewall aanpassingen gemaakt worden.
* inkomend: sta TCP 443 toe vanaf het interne netwerk (www-prod, www-test), en vanaf eventuele andere plekken die we expliciet toe willen staan.
* inkomend: sta TCP 443 toe vanaf mijn.hcc.nl (XML-RPC aanroepen vanaf de portal)
* inkomend: sta TCP 443 toe vanaf service.hccnet.nl toe (XML-RPC aanroep GeefUitgeschrevenLeden vanuit HenZ)
* uitgaand: sta TCP 443 naar service.hccnet.nl toe (XML-RPC aanroepen naar HenZ)
* uitgaand: sta TCP 990 en 5000-6000 naar Apps.HCC.local (FTPS verkeer naar de HCC server bij Hobbynet)

== Aanpassingen aan AppArmor ==
Alhoewel technisch gezien dit bij slapd behoort, neem ik het toch hier op.

Als het Hobbynet certificaat in de map /disk/site/etc/ssl/hobby.nl/ wordt neergezet, dan zal apparrmor de toegang tot de certificaten blokkeren. Neem daarom in de '''local''' directory van apparmor het volgende op:
# /etc/apparmor.d/local/usr.sbin.slapd
# Site-specific additions and overrides for usr.sbin.slapd.
# For more details, please see /etc/apparmor.d/local/README.
#include <abstractions/ssl_certs>
/disk/site/etc/ssl/hobby.nl/ r,
/disk/site/etc/ssl/hobby.nl/* r,

= CRM (Azure) proxy herstarten =
Als er indicaties zijn dat niet alle JSON berichten meer vanuit het CRM aangeboden worden aan de XML-RPC server, dan kan het helpen om de CRM proxy te herstarten

* Ga naar https://portal.azure.com/
* Login met zelfde account als voor het CRM
* Soms krijg je een popup. Die kan je weg klikken, je wilt geen rondleiding
* Klik op '''hccdyn01-aps-crm01''' voor productie en '''hccdyn01-aps-dev01''' voor test
* En dan kan je op opnieuw starten klikken.

XML-RPC

2021-10-13T16:10:21Z

Hans:

= XML-RPC interface =

De LDAP server kan direct gemuteerd worden via een LDAP koppeling. Zie
de standaard LDAP pagina voor de uitleg welke poorten daarvoor gebruikt
kunnen worden.

Daarnaast is er de wens ontstaan om via een standaard protocol met de
LDAP omgeving te kunnen communiceren. Er is hiertoe een XML-RPC
koppeling ontwikkeld. XML-RPC is een standaard interface, waarmee het
mogelijk is om vanuit diverse omgevingen op een gestandaardiseerde
manier te communiceren.

== Globale functie omschrijving ==
* Algemene aanroepen
** Controleer of een gebruiker bestaat
** Wijzig het wachtwoord ('userPassword')
** Zoek een gebruiker (t.b.v. kantoor en/of LA-akties groeperingssecretaris)
** Maak een gebruiker aan (geef gebruiker een andere hccLogin waarde, maak ook bij HCCnet deze gebruiker aan)
** Controleer of een gebruiker zijn profiel al doorlopen heeft
** Haal de lijst met opgeheven accounts op
** Haal de lijst met bulletins van een hcc lid (OptIn)

* Aanroepen t.b.v. hcc partners
** Controleer of lidnummer/postcode correct is
** Controleer of lidnummer/postcode correct is, en tevens ingeschreven staat bij een specifieke IG

* Joomla template site functies (op basis van JoomlaToken)
** Maak een JoomlaToken
** Ruim een JoomlaToken op
** Pas mijn OptIn (bulletin inschrijving) aan
** Regel alles rondom Onderwerpen en de autorisatie hiervan
** Pas mijn wachtwoord aan

* Joomla kadernet site functies (op basis van JoomlaToken)
** Zoek een hcc kaderlid (t.b.v. de kaderleden zoekpagina)
** Pas mijn kadermail forwarding aan en toon ja/nee mijn GSM nummer
** Pas het kadernet e-mail wachtwoord aan
** Haal de lijst met alle groeperingen op
** Haal de lijst met alle kaderrollen op

* Joomla hcc.nl site (op basis van JoomlaToken)(mijn.hcc.nl vervanging)
** Pas mijn adresgegevens aan
** Pas mijn voorletters, voornaam, pseudoniem, telefoonnummer, GSM nummer etcetera aan
** Schrijf me in of uit op een bulletin
** Toon info over de kosten van een IG lidmaatschap
** Voer een wachtwoord reset uit op basis van een PWResetToken (een variant op JoomlaToken)
** Vraag een nieuwe HCC code aan, en stuur die per SMS

* Joomla hobby.nl site (op basis van JoomlaToken)(t.b.v. IDEAL betaling)
** Haal het aantal hobbyDomains op

* Aanroepen t.b.v. CRM (Microsoft Dynamics Cloud) koppeling
** Haal de dagelijkse synchronisatie bestanden op
** Werk in het CRM dan wel in LDAP de NAW gegevens bij
** Werk in het CRM dan wel in LDAP de IG gegevens van een lid bij

* HenZ
** Haal de lijst met opzeggers op
** Valideer de opzegdatum van een opgegeven gebruiker

=== Authenticatie ===

Alle aanroepen gebeuren op basis van authenticatie vanuit de aanroeper.
Dit valt uiteen in de volgende categorieën:
* gebruikersnaam ('hccLogin') en wachtwoord ('userPassword')
* hcc lidnummer ('hccLidnr'), Joomla token ('JoomlaToken') en website ('siteID')
* hcc lidnummer ('hccLidnr') en hcc code ('hccCode')
* beheerders-DN ('beheerLogin') en beheerders wachtwoord ('beheerPassword')
* partner-DN ('partnerLogin') en partner wachtwoord ('partnerPassword')

=== Aanroepen, gedaan via de bezoekersregistratie-proxy ===
(de bezoekersregistratie proxy is een mislukt project tbv de Android app van René Prins)
(deze proxy bestaat niet meer) 
Diverse aanroepen kunnen ook via de bezoekersregistratie-proxy aangeroepen worden. 
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
* GeefAlleGroeperingen
* GeefAlleKaderRollen
* GeefLocaties
* GeefLocatieNamen
De bezoekersregistratie aanroepen hebben 'JoomlaToken' als extra parameter nodig:
* LidBezoektBijeenkomst
* GeefBezoekersOverzicht
* GeefBezoekersAantallen
De aanroepen die over de proxy uitgevoerd worden dienen voorafgegaan te worden door een aanroep naar
* GeefMijnGegevens (dit geeft na validatie immers 'JoomlaToken' terug)

=== Resultaten ===

Alle aanroepen geven de volgende elementen terug:
* Naam van de uitgevoerde procedure ('Action')
* Resultaat van de uitgevoerde procedure ('Status')
* Een tekstuele vertaling van het resultaat dan wel de foutmelding ('Message')
* Tijdens de ontwikkelfase kan er debug-info teruggeleverd worden ('ExtraInfo')
Daarnaast geven specifieke aanroepen extra resultaten terug

== Technische omschrijving ==
XML-RPC beschrijving van acties in hcc.nl LDAP database

<pre>
2021.10.13 HaVe
XML-RPC Hobbynet versie 68.
</pre>

=== Kort overzicht ===

Dit is een lijst met alle XML-RPC aanroepen. In het volgende hoofdstuk worden ze in detail besproken.
<pre>
echo (partners)
ExpandeerPostcode (Joomla module Bas, tbv verhuizingen)
GebruikerBestaatControle (Joomla sites)
GeefAantalDomeinen (Joomla module Bas)
GeefAlleBulletins (Joomla module Bas)
GeefAlleGroeperingen (kadersite, forum, secr. portal, kantoor portal, hobbynet portal)
GeefAlleKaderRollen (forum, secr. portal, kantoor portal, hobbynet portal, Joomla module Bas)
GeefBezoekersOverzicht (bezoekersregistratie)
GeefBezoekersAantallen (bezoekersregistratie)
GeefFactuurOverzicht (Joomla module Bas)
GeefhccEindDatum (HenZ)
GeefKadermailGegevens (kantoor portal)
GeefLocatieNamen (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefLocaties (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefMijnGegevens (Joomla inlog module Bas)
GeefMijnLidnummer (beheer.hcc.nl secretaris portal)
GeefOnderwerpen (Joomla template sites)
GeefSSOUrls (Joomla module Bas)
GeefUitgeschrevenLeden (Joomla sites, HenZ)
HaalAanmeldingsformulier (Joomla module Bas)
HaalFactuur (Joomla module Bas)
HaalIGBedragenOp (Joomla module Bas)
HaalOptInKeuzen (kantoor portal)
HaalTariefGroepenOp (kantoor portal)
HCCpartner (Partner aanroep)
HCCpartners (Partner aanroep)
IsDezeNaamNogBeschikbaar (aangeroepen vanuit de CRM omgeving)
IsDezePseudoniemNogBeschikbaar (kantoor portal)
IsHCCLid (vraagbaak aanroep)
IsKaderLid (in veel apps gebruikt)
LidBezoektBijeenkomst (bezoekersregistratie)
MaakGebruikerAan (mijnhcc.nl, maak hccnet account aan en ldap gebruikersnaam)
MaakOnderwerp (Joomla template sites)
MaakPWResetToken (Joomla module Bas)
MaakTestLogin (Joomla module Bas)
MuteerAanmeldingsformulier (Joomla module Bas)
MuteerGroeperingSamenstelling (Joomla kadernet module Bas)
MuteerOnderwerp (Joomla template sites)
MuteerOnderwerpAutorisatie (Joomla template sites)
NormaliseerTelefoon (Joomla module Bas)
PasHccLoginAan (Joomla module Bas)(enkel Hobbynet)
PasInteressegroepAan (Joomla module Bas)
PasKaderGegevensAan (kadersite, Joomla module Bas)
PasOptInKeuzeAan (Joomla module Bas)
PasPseudoniemAan (Joomla module Bas)
PasUserWachtwoordAan (beheer.hcc.nl Hobbynet gebruikers portal)
PasWachtwoordAan (Joomla module Bas)
RegistreerGast (bezoekersregistratie)
ResetHCCCode (Joomla module Bas)
RuimJoomlaTokenOp (Joomla module Bas)
SchrijfNietlidInOpBulletin (Joomla site bulletin module Bas)
SchrijfNieuwLidIn (Joomla CRM module Bas)
ToonOnderwerpAutorisatie (Joomla template sites)
UpdateContactEmail (Joomla module Bas)
UpdateContactGegevens (Joomla module Bas)
UpdateMobiel (Joomla module Bas)
UpdateNAW (Joomla module Bas)
UpdateOTP (Joomla module Bas)
UpdateTelefoon (Joomla module Bas)
UpdateVoorletters (Joomla module Bas)
UpdateVoornaam (Joomla module Bas)
Upload_CSV_bestand (CRM webproxy)
ValideerPWResetToken (Joomla module Bas)
ValideerWachtwoordEisen (Joomla module Bas)
Verwerk_JSON_mutatie (CRM webproxy)
VerwijderNietLid (Joomla beheer module Bas)
VerwijderOnderwerp (Joomla template sites)
VraagLidgegevensTokenAan (bezoekersregistratie)
WijzigGebruikersGegevens (kantoor en Joomla template sites, ww aanpassen van gebruiker)
ZoekGroeperingsLid (secr. portal, kantoor portal, hobbynet portal)
ZoekHCCLid (VZ portal)
ZoekKaderLeden (Joomla kadernet module Bas)
</pre>

=== HCC-ldap en/of HCC-net aanroepen ===

<pre>
// ** Joomla sites, www.hcc.nl **
// 1.1 controleer of een gebruiker bestaat - optie 1
// (authenticatie op basis van hccLidnr en hccCode)
// Alleen bedoeld om gebruikers op www.hcc.nl op basis van het lidnr het ww te laten wijzigen
$request = xmlrpc_encode_request(
'GebruikerBestaatControle',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $method,
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd');
if ($hccLidnr != '') { $reply['hccLidnr'] = $hccLidnr; }
if ($hccLogin != '') { $reply['hccLogin'] = $hccLogin; }
if ($hccPseudoniem != '') { $reply['hccPseudoniem'] = $hccPseudoniem; }
if ($cn != '') { $reply['cn'] = $cn; }
if ($sn != '') { $reply['sn'] = $sn; }
if ($mail != '') { $reply['mail'] = $mail; }
if ($mailHccnet != '') { $reply['mailHccnet'] = $mailHccnet; }
if ($hccRegio != '') { $reply['hccRegio'] = $hccRegio; }
if ($hccIG != '') { $reply['hccIG'] = $hccIG; }
if ($hccRol != '') { $reply['hccRol'] = $hccRol; }
if ($ProfielBekend != '') { $reply['ProfielBekend'] = $ProfielBekend; }

// ** Portal mijn.hcc.nl **
// 2.1 wijzig wachtwoord - optie 1
// op basis van hccLidnummer en hccCode
// Essentiele aanroep, gebruikt vanuit mijnhcc.nl (lidnr + hccCode)
// Ook gebruikt t.b.v. wachtwoord-vergeten procedure op de Joomla template sites
// Als de profielpagina nog niet is doorlopen wordt deze aanroep afgekeurd.
//
// Ook gebruikt om gebruiker rechtstreeks vanaf Joomla template sites wachtwoord te
// laten aanpassen (op basis van lidnummer en hcc code)
//
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'WijzigGebruikersGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gewijzigd',
'hccLogin' => $hccLogin,
'cn' => $cn,
'sn' => $sn);

// 2.3 wijzig wachtwoord - optie 3
// (t.b.v. VZ-portal)
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
// * Als hccLidnr gevuld is, dan wordt hccLidnr gebruikt om het juiste record te zoeken
// Als hccLidnr leeg is, dan wordt hccLogin gebruikt om het juiste record te zoeken
// 1 van beide velden MOET aanwezig zijn
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'beheerLogin' => $beheerLogin, // beheerder lidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

// ** t.b.v. ophalen van de opt-in keuzes op de beheer pagina **
// 2.6 Geef de complete lijst met opt-ins van dit lid
// (LET OP: authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'HaalOptInKeuzen',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalOptInKeuzen',
'Status' => 'TRUE',
'Message' => 'OptInLijst opgehaald',
'hccOptIn' => $hccOptIn);
Output negatief:
$reply = array(
'Action' => 'HaalOptInKeuzen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gebruikersnaam, pseudoniem
// en wachtwoord tevens in LDAP op
// (authenticatie op basis van hcc lidnummer en hcc-code)
// ** Deze gegevens worden doorgezet naar hccnet.nl (action=4) **
//
$request = xmlrpc_encode_request(
'MaakGebruikerAan',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_hccLogin' => $nieuw_hccLogin,
'nieuw_userPassword' => $nieuw_userPassword,
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'TRUE',
'Message' => 'Gebruiker aangemaakt',
'mail' => $mail,
'hccPseudoniem' => $hccPseudoniem);
Output negatief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gebruikersnaam bestaat al' |
'Pseudoniem bestaat al' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!');

// H.3 Haal al mijn gegevens
// (wordt gebruikt door de Joomla inlogmodule)
// Voor gebruik over de proxy t.b.v. de Android app kan compact=TRUE meegegeven worden.
// In dat geval worden enkel de meest essentiele gegevens teruggestuurd
// Voor gebruik na MaakGebruikerAan kan deze functie ook op basis van hccLidnr en JoomlaToken
// worden aangeroepen
// De optionele parameter 'PrevSiteID' is bedoeld voor single-sign-on. Op basis van JoomlaToken,
// hccLidnr en PrevSiteID worden dan de credentials gevalideerd. Als die kloppen, geeft deze aanroep
// een 2e JoomlaToken terug, maar dan uitgegeven op basis van SiteID.
// Als PrevSiteID leeg is, dan wordt het token op basis van siteID gevalideerd.
$request = xmlrpc_encode_request(
'GeefMijnGegevens',
array(
['hccLogin' => $hccLogin,
'userPassword' => $userPassword,]
['hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,]
['PrevSiteID' => $PrevSiteID,]
['compact' => $compact,] // leeg of 'TRUE'
['hccGroepering'=> $hccGroepering,] // Een testgebruiker mag alleen op deze site inloggen
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd',
'hccLidnr' => $hccLidnr,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccAutorisatie' => $hccAutorisatie,
'cn' => $cn,
'sn' => $sn,
'JoomlaToken' => $JoomlaToken,
['hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'givenname' => $givenname,
'hccAanhef' => $hccAanhef,
'hccGeslacht' => $hccGeslacht,
'hccTussenVoegsels' => $hccTussenVoegsels,
'hccAchternaam' => $hccAchternaam,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward,
'hccKaderToonMobiel' => $hccKaderToonMobiel,
'hccOptIn' => $hccOptIn,
'ProfielBekend' => $ProfielBekend,
'hccBeginDatum' => $hccBeginDatum,
'testaccount' => is_testaccount(), // 'TRUE' | 'FALSE'
'hccOtpKey' => $hccOtpKey,
'hccOtep' => $hccOtep,
['kadermail_omvang' => $Formaat, // in Mb
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald;]]);

Output negatief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// ** t.b.v. aanpassen van de opt-in keuzes op een Joomla site **
// H.4 Pas 1 opt-in van een lid aan
// (LET OP: authenticatie op basis van hccLidnr, JoomlaToken en siteID)
// of
// authenticatie op basis van hccLidnr en OptOutToken (voor een directe uitschrijving door een lid)
// Als hccLidnummer gevuld is, dan is dat het lidnummer waar de mutatie op moet worden uitgevoerd.
// Dat kan alleen als de aanvrager HCC#LAD of HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasOptInKeuzeAan',
array(
'hccLidnr' => $hccLidnr,
['JoomlaToken' => $JoomlaToken,]
['OptOutToken' => $OptOutToken,]
['hccLidnummer' => $hccLidnummer,]
'hccOptIn' => $hccOptIn,
'actie' => 'Nieuw' | 'Weg',
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'TRUE',
'Message' => 'OptIn aangepast');
Output negatief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials | Token ongeldig | Token verlopen');

// H.5 Zoek kaderleden NAW (t.b.v. de Joomla kadersite)
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
//
// * Er dient minstens 1 zoekcriterium opgegeven te worden.
// * Als zowel hccRegio als tegelijk ook hccIG opgegeven worden is de uitkomst onvoorspelbaar.
// * Als compact=TRUE worden enkel lidnummer, cn en sn in het antwoord gezet
$request = xmlrpc_encode_request(
'ZoekKaderLeden',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
['hccRegio' => $hccRegio,]
['hccIG' => $hccIG,]
['hccRol' => $hccRol,]
['hccLocatie' => $hccLocatie,]
['achternaam' => $achternaam,]
['compact' => $compact])); // leeg of 'TRUE'

Output positief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'TRUE',
'Message' => 'Kaderleden opgevraagd'
'Kaderleden' => array(
'hccLidNummer' => $hccLidNummer,
'hccRol' => $hccRol,
'hccAanhef' => $hccAanhef,
'givenname' => $givenname,
'cn' => $cn,
'sn' => $sn,
'hccWoonplaats' => $hccWoonplaats,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'hccKaderMail' => $hccKaderMail);

Output negatief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token']);

// H.9 PasKaderGegevensAan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
// Om de kaderleden hun forward in te laten stellen,
// en tegelijkertijd de opt-in / opt-out voor hccToonMobiel te laten regelen
// Kan tevens het kader email wachtwoord aanpassen
$request = xmlrpc_encode_request(
'PasKaderGegevensAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'hccKaderForward' => $hccKaderForward, // '' | $mail | $mailHccNet
'hccKaderToonMobiel' => $hccKaderToonMobiel, // 'TRUE' | 'FALSE' | 'NULL'
['nieuw_kaderPassword' => $nieuw_kaderPassword]));

Output positief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'TRUE',
'Message' => 'kadergegevens aangepast');

Output negatief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token'|'Alleen kaderleden mogen deze aanroep uitvoeren']);

// ** Portal beheer.hcc.nl
// ** H.10 PasUserWachtwoordAan
// ** Betalende Hobbynet gebruikers kunnen hiermee hun wachtwoord aanpassen
// (authenticatie op basis van hccLogin en userpassword)
$request = xmlrpc_encode_request(
'PasUserWachtwoordAan',
array(
'hccLogin' => $username,
'userpassword' => $password,
'hobbynetAccount' => $hobbyname,
'nieuw_wachtwoord' => $nieuw_wachtwoord,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!' |
'account $hobbynetAccount behoort niet bij gebruiker $hccLogin' |
'Kan ww van account $hobbynetAccount niet aanpassen');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.11 Pas het pseudoniem van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasPseudoniemAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccPseudoniem' => $hccPseudoniem,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'TRUE',
'Message' => 'Pseudoniem aangepast');
Output negatief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials' | 'Pseudoniem bestaat al');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.12 Controleer of een opgegeven wachtwoord aan de minimum eisen voldoet
$request = xmlrpc_encode_request(
'ValideerWachtwoordEisen',
array(
'userPassword' => $userPassword,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'TRUE',
'Message' => 'Wachtwoord voldoet aan de minimale eisen');
Output negatief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'FALSE',
'Message' => 'Wachtwoord voldoet niet aan de minimale eisen');

// ** H.13 PasWachtwoordAan
// ** Vanuit een Joomla template site kunnen gebruikers hiermee hun eigen wachtwoord aanpassen
// (authenticatie op basis van JoomlaToken, lidnummer, siteID. Extra controle via userpassword)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'userpassword' => $password,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.13.1 PasWachtwoordAan
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee hun eigen wachtwoord resetten
// (authenticatie op basis van PWResetToken en hccLogin).
// (Als de aanroep geslaagd is, dan is daarna het PWResetToken ongeldig)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.14 MaakPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee een wachtwoord reset aanvragen
// Deze aanroep geeft naast het PWResetToken ook het contact emailadres mee terug,
// zodat Joomla een reset-mail kan sturen
// (acties op basis van gebruikersnaam)
$request = xmlrpc_encode_request(
'MaakPWResetToken',
array(
'hccLogin' => $username,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'TRUE',
'PWResetToken' => $PWResetToken,
'mail' => $mail,
'Message' => 'Password reset token aangemaakt');
Output negatief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');

// ** H.15 ValideerPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers een wachtwoord reset aanvragen
// Controleer dat het hier om een bestaand (en nog niet gebruikt) token gaat
$request = xmlrpc_encode_request(
'ValideerPWResetToken',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'TRUE',
'Message' => 'Password reset token gevonden');
Output negatief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'FALSE',
'Message' => 'hccLogin bestaat niet' | 'PWResetToken bestaat niet');

// H.16 Ruim een bestaand JoomlaToken op
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'RuimJoomlaTokenOp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'SiteID' => $siteID,
['ServerID' => gethostname(),]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'TRUE',
'Message' => 'JoomlaToken opgeruimd');
Output negatief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'FALSE',
'Message' => 'Onjuist JoomlaToken');

// ** Joomla module
// ** H.17 GeefAantalDomeinen
// ** Vraag het aantal domeinen op van een betalende Hobbynet gebruiker (t.b.v. IDEAL betaling)
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'GeefAantalDomeinen',
array(
'JoomlaToken' => $JoomlaToken,
'hccLidnr' => $hccLidnr,
'hobbynetAccount' => $hobbyname,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'TRUE',
'hobbynetAccount' => $hobbyname,
'AantalDomeinen' => $aantalDomeinen,
'Message' => 'aantal domeinen opgevraagd');
Output negatief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'account $hobbynetAccount behoort niet bij deze gebruiker');

// ** Joomla module
// ** H.18 ResetHCCCode
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'beheerLogin' => $beheerLogin, // geheime credentials van de site
'beheerPassword' => $beheerPassword, // geheime credentials van de site
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** Joomla module
// ** H.18.1 ResetHCCCode (hcc kantoor aanroep)
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'JoomlaToken' => $JoomlaToken, // Het Joomla token van de sessie van de kantoor medewerker
'hccLidnr' => $hccLidnr, // Het lidnummer van de kantoor medewerker
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** t.b.v. aanpassen van de hccLogin van een gebruiker (Hobbynet functie op Joomla site) **
// H.19 Pas de hccLogin van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// hccLidnummer is het lidnummer waar de mutatie op moet worden uitgevoerd
// Kan alleen als de aanvrager HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasHccLoginAan',
array(
'hccLidnr' => $hccLidnr, // lidnummer van de aanvrager
'JoomlaToken' => $JoomlaToken, // JoomlaToken van de aanvrager
'hccLidnummer' => $hccLidnummer, // pas de hccLogin van dit lidnummer aan
'hccLogin' => $hccLogin, // dit is de gewenste nieuwe hccLogin
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'TRUE',
'Message' => 'hccLogin aangepast');
Output negatief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' |
'Onjuiste credentials' |
'Gebruikersnaam al in gebruik');

// ** t.b.v. het aanmaken van een testaccount door een webmaster
// H.20 Maak een testaccount aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// Kan alleen als de aanvrager WM als rol heeft
$request = xmlrpc_encode_request(
'MaakTestLogin',
array(
'JoomlaToken' => $JoomlaToken, // JoomlaToken van de aanvrager
'hccLidnummer' => $hccLidnummer, // lidnummer van de aanvrager
'hccRol' => $hccRol, // (mag leeg zijn)
'hccGroepering' => $hccGroepering, // (regio of IG)
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
reply = array(
'Action' => 'MaakTestLogin',
'Status' => 'TRUE',
'Message' => 'Tijdelijk test account aangemaakt',
'TestAccountNaam' => 'test-<groepering>-<hccLogin>'
'userpassword' => $nieuw_userpassword,
'hccGroepering' => $hccGroepering,
'hccRol' => $hccRol);
Output negatief:
$reply = array(
'Action' => 'MaakTestLogin',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Gegevenscombinatie onjuist');

// Joomla webbeheerder functie
// ** t.b.v. aanpassen van de OneTime Passwords van de webbeheerder
// H.21 Pas de OTP gegevens van een lid aan
// (LET OP: authenticatie op basis van hccLidnr, JoomlaToken en siteID)
// Als hccLidnummer gevuld is, dan is dat het lidnummer waar de mutatie op moet worden uitgevoerd.
// Dat kan alleen als de aanvrager HCC#LAD of HN#WM als rol heeft
$request = xmlrpc_encode_request(
'UpdateOTP',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
['hccLidnummer' => $hccLidnummer,]
'hccOtpKey' => $hccOtpKey, // De otp encryptie key van de gebruiker (mag leeg zijn )
'hccOtep => $hccOtep, // Het one time recovery password (mag leeg zijn )
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateOTP',
'Status' => 'TRUE',
'Message' => 'OTP gegevens aangepast');
Output negatief:
$reply = array(
'Action' => 'UpdateOTP',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// 3.1 Geef mijn lidnummer
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'GeefMijnLidnummer',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'TRUE',
'Message' => 'Lidnummer opgevraagd',
'hccLidnr' => $hccLidnr);
Output negatief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.2 Controleer of de gebruikersnaam op dit moment bestaat
// (geen authenticatie)
// ** Deze gegevens worden opgevraagd bij hccnet.nl (action=3) **
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezeNaamNogBeschikbaar',
array(
'nieuw_hccLogin' => $nieuw_hccLogin,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Gebruikersnaam is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Gebruikersnaam bestaat al');

// ** Enkel voor gebruik vanaf de kantoor portal **
// ** t.b.v. het hernoemen van accounts in CRM **
// 8.3 Controleer of een Pseudoniem op dit moment bestaat ??? NIET GEBRUIKT ??
// (geen authenticatie)
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezePseudoniemNogBeschikbaar',
array(
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem));
Output positief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Pseudoniem is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Pseudoniem bestaat al');

// ** t.b.v. de verenigingszaken zoekpagina **
// A.1 Zoek alle bij de query passende hcc leden
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
$request = xmlrpc_encode_request(
'ZoekHCCLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Groepering' => $Groepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (eerste deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| emailadres | (eerste deel van) e-mail adres |
| gebruikersnaam | (eerste deel van) de login naam |
| pseudoniem | (eerste deel van) het pseudoniem |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| niet_leden | het volledige niet-lid lidnummer |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'ZoekMethode' => $ZoekMethode,
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' => array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'sn' => $sn,
'givenName' => $givenName,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccHuisToevoeging' => $hcchuisToevoeging,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'ProfielBekend' => 'TRUE' | 'FALSE'])*);
Output negatief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. beheer.hcc.nl **
// A.3 Zoek alle bij de query passende hcc leden van deze groepering
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'ZoekGroeperingsLid',
array(
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Groepering' => $groepering,
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Bijeenkomst' => $Bijeenkomst,] // Alleen voor gebruik op de
// bijeenkomsten aanwezigheidsregistratie pagina
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| nieuwe_leden | YYYYMMDD vanaf waar gezocht moet worden |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| kaderleden | n.v.t. |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' =>
[array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'cn' => $cn,
'sn' => $sn,
'givenName' => $givenName,
'hccAchternaam' => $hccAchternaam,
'hccTussenVoegsels => hccTussenVoegsels,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem)]*));
Output negatief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker(s) niet gevonden' | 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten **
// A.4 Lid bezoekt bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'LidBezoektBijeenkomst',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
'hccLidnr' => $hccLidnr, // lid dat aanwezig gemeld moet worden
['correctie' => $hccLidnr,] // lid dat gecorrigeerd moet worden
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'TRUE',
'Message' => 'Bezoeker weggeschreven',
'Results' => array(
// info van deze bezoeker
'cn' => $cn, // cn (Verbeek, H.J.)
'hccGeslacht' => $hccGeslacht, // hccGeslacht van de bezoeker
'groeperingslid' => $groeperingslid, // TRUE of FALSE: is deze persoon lid van deze groepering
'mijnGroeperingen' => $mijnGroeperingen, // komma-gescheiden lijst (regio, [hccIG]*)
'aantalBezoeken' => $aantalBezoeken, // hoe vaak heeft dit lid deze bijeenkomst bezocht
// info van de bijeenkomst
'AantalBezoekers' => $AantalBezoekers); // aantal bezoekers van deze bijeenkomst
Output negatief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.5 Vraag Lidgegevens token aan (geldig voor dit lid, en deze groepering, op deze datum)
// Als geen datum gegeven is, dan is het token vandaag geldig
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'VraagLidgegevensTokenAan',
array(
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'hccLidnr' => $hccLidnummer, // vraag het token voor dit lid aan
'groepering' => $groepering, // zoek binnen deze groepering
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'TRUE',
'Message' => 'Token opgevraagd',
'groepering' => $Groepering,
'token' => $token,
'sn' => $sn);
Output negatief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.6 Toon bezoekersoverzicht
// (authenticatie op basis van lidnummer en bezoekersregistratie token)
$request = xmlrpc_encode_request(
'GeefBezoekersOverzicht',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'token' => $token,
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'TRUE',
'Message' => 'Bezoekersoverzicht opgevraagd',
'Bezoekers' => $bezoekers,
['Locatie' => $Locatie]);
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// A.7 Geef het array met alle locaties
// (of beperk dit tot de locaties van de groepering $Groepering)
// Desgewenst worden alle resultaten waarbij hccToonInJoomla aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// Desgewenst worden alle resultaten waarbij ToonOpKaderNet aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocaties',
array(
['Groepering' => $hccGroepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']);
Output positief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);
Output negatief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'FALSE',
'Message' => 'Locaties niet beschikbaar',
'ExtraInfo' => 'Geen locaties gevonden voor groepering $hccGroepering',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);

// A.8 Registreer een niet-hcclid als bezoeker tijdens een bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'RegistreerGast',
array(
'AccountNaam' => $lidnr, // credentials
'AccountCode' => $AccountCode, // credentials
'token' => $token, // credentials
'Bijeenkomst' => $groepering,
'geslacht' => $geslacht,
'naam' => $naam,
'mail' => $mail,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'buitenland' => $buitenland,
['nietLidNummer' => $nietLidNummer,]
['instructies' => $instructies,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $aanroep,
'Status' => 'TRUE',
'Message' => 'Niet-lid als bezoeker geregistreerd',
'Result' => $result_array);

// A.9 Geef het array met alle locatienamen
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocatieNamen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']));
['KaderMutatieFilter' => '' | 'TRUE']));

Output positief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));
Output negatief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'FALSE',
'Message' => 'Locatienamen niet beschikbaar',
'ExtraInfo' => 'Geen locatienamen gevonden',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));

// A.10 Schrijf een niet-lid in op een bulletin
// (2019.12.05: wordt actief gebruikt in Joomla module)
// Deze aanroep mag *ook* worden gebruikt om een wel-lid in te schrijven.
// Voorwaarde is dat bewezen is dat er controle bestaat over het opgegeven email adres
$request = xmlrpc_encode_request(
'SchrijfNietlidInOpBulletin',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'hccOptin' => $hccOptin, // bulletin waarop ingeschreven wordt
'hccOptinSource' => $hccOptinSource, // site waar aanmelding vandaan komt
'Email' => $Email, // niet-lid: email adres
'Naam' => $Naam, // niet-lid: naam
['hccLidNummer' => $hccLidNummer,] // optioneel: ik ben lid, dit is mijn lidnummer
['Postcode' => $Postcode,] // optioneel: niet-lid: postcode
['Huisnummer' => $Huisnummer,] // optioneel: niet-lid: huisnummer
['hccGeslacht' => $hccGeslacht,] // optioneel: niet-lid: geslacht (M/V/O)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'TRUE',
'Message' => 'Inschrijving op bulletin gelukt');
Output negatief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist',
'ExtraInfo' => 'Invalid DN syntax' |
'Invalid credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.11 Toon bezoekers aantallen
// (authenticatie op basis van AccountNaam en AccountCode of token)
//
// ==> Mag weg: laatste aanroep 2018.12.15 <==
//
$request = xmlrpc_encode_request(
'GeefBezoekersAantallen',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'token' => $token,
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersAantallen',
'Status' => 'TRUE',
'Message' => 'BezoekersAantallen opgevraagd',
'Datum' => $datum,
'Bijeenkomst' => $Bijeenkomst,
'Bezoekers' => array(
[HCC!seniorenacademie] => Array(
[Gorinchem] => 15
[Woerden] => 36)
...));
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersAantallen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// ** t.b.v. Joomla module Bas
// A.12 GeefAlleBulletins
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleBulletins',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefAlleBulletins',
'Status' => 'TRUE',
'Message' => 'Bulletins opgevraagd',
'bulletins' => $bulletins);

// ** t.b.v. Joomla module Bas
// A.13 ExpandeerPostcode
// (geen authenticatie)
$request = xmlrpc_encode_request(
'ExpandeerPostcode',
array(
'postcode' => $postcode,
'huisnummer' => $huisnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'ExpandeerPostcode',
'Status' => 'TRUE',
'Message' => 'Postcode opgevraagd',
'detailgegevens' => $detailgegevens);

// ** t.b.v. Joomla module Bas
// A.25 UpdateNAW
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateNAW',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'geslacht' => $geslacht,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'toevoeging' => $toevoeging,
'straat' => $straat,
'woonplaats' => $woonplaats,
'landcode' => $landcode,
'email' => $email,
'voornaam' => $voornaam,
'voorletters' => $voorletters,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateContactGegevens',
'Status' => 'TRUE',
'Message' => 'Contactgegevens bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.18 NormaliseerTelefoon
// (geen authenticatie)
$request = xmlrpc_encode_request(
'NormaliseerTelefoon',
array(
'hccLand' => $hccLand,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'NormaliseerTelefoon',
'Status' => 'TRUE',
'Message' => 'Telefoonnummer genormaliseerd',
'Telefoonnummer' => $Telefoonnummer);

// ** t.b.v. Joomla module Bas
// A.20 UpdateMobiel
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateMobiel',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateMobiel',
'Status' => 'TRUE',
'Message' => 'Mobiel nummer bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.21 HaalIGBedragenOp
// Geef alle IG's waar je zelf lid van kunt worden, inclusief het bijbehorende bedrag
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalIGBedragenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalIGBedragenOp',
'Status' => 'TRUE',
'Message' => 'Interessegroepen en bedragen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.22 HaalTariefGroepenOp
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalTariefGroepenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalTariefGroepenOp',
'Status' => 'TRUE',
'Message' => 'Tariefgroepen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.23 PasInteressegroepAan
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasInteressegroepAan',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
['nieuw' => $IG_lijst_nieuw,]
['weg' => $IG_lijst_weg,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'PasInteressegroepAan',
'Status' => 'TRUE',
'Message' => 'IG keuzen aangepast');

// ** t.b.v. Joomla module Bas
// A.24 GeefSSOUrls
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefSSOUrls',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefSSOUrls',
'Status' => 'TRUE',
'SSO_urls' => $sso_urls,
'Message' => 'Single Sign On URLs opgevraagd');

// ** t.b.v. de verenigingszaken beheer pagina **
// A.26 Verwijder een niet-lid record
$request = xmlrpc_encode_request(
'VerwijderNietLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'hccLidnr' => $hccLidnummer, // het te verwijderen niet-lid nummer
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

Output positief:
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'TRUE',
'Message' => 'Niet-lid record verwijderd',

Output negatief:
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'FALSE',
'Message' => 'Niet-lid record niet gevonden');
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** HenZ **
// ** t.b.v. daily cron job **
// ** t.b.v. dagelijkse opschoon jobs Joomla template sites **
// C.1 Vraag de lijst met uitgeschreven leden op
// Dit kan beperkt worden tot een bepaalde regio of interessegroep
// Daarnaast kan het tijdvak waarin gezocht wordt vrij gekozen worden
// (gesteld dat de LDAP database nog leden uit die periode bevat)
// Antwoord: lijst met (lidnummer, hccLogin, sn,
// datum einde lidmaatschap (formaat:YYYYMMDD))

==> GeefUitgeschrevenLeden <== (oud: GeefOpgezegdeLeden)

$request = xmlrpc_encode_request(
'GeefUitgeschrevenLeden',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccRegio' => $hccRegio, // of leeg
'hccIg' => $hccIg, // of leeg
'datum_vanaf' => $datum_sinds, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: 3 dagen geleden)
'datum_tot' => $datum_tot, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: vandaag)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'TRUE',
'Message' => 'Uitgeschreven leden',
['hccRegio' => $hccRegio,]
['hccIg' => $hccIg,]
['datum_vanaf' => $datum_vanaf,]
['datum_tot' => $datum_tot,]
['Results' => array(
[array(
'hccLogin' => $hccLogin,
'hccLidNummer' => $hccLidnummer,
'sn' => $sn,
'DatumEindeLidmaatschap' => $DatumEindeLidmaatschap)]*);
Output negatief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');
</pre>

=== HCCpartner aanroepen ===
(interface versie 1) 
(oude interface, niet meer gebruiken!)

<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.1 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartner',
array('ControleerHCCLidmaatschap',
array('partnerLogin', $partnerLogin),
array('partnerPassword', $partnerPassword),
array('hccLidnummer', $hcclidnummer),
array('postcode', $postcode)));
Output positief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'TRUE'));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'));
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'),
array('Message', 'Onjuiste credentials'));

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartner',
array(
'OnbekendeAanroep',
array('parameter', $iets)));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'OnbekendeAanroep'),
array('Status', 'FALSE'),
array('Message', 'Opdracht onbekend'));
</pre>

=== HCCpartners aanroepen ===
(interface versie 2)

<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.2 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'ControleerHCCLidmaatschap',
'partnerLogin' => $partnerLogin,
'partnerPassword' => $partnerPassword,
'hccLidnummer' => $hcclidnummer,
'postcode' => $postcode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'TRUE',
['ExtraInfo' => 'groepering=$groepering']); // als de partner beperkt is tot 1 groepering
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE');
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'OnbekendeAanroep',
'parameter' => $iets));
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'OnbekendeAanroep',
'Status' => 'FALSE',
'Message' => 'Opdracht onbekend');
</pre>

=== HCC-kader aanroepen ===

<pre>
// ** beheer.hcc.nl **
// F.2 Controleer of dit een kaderlid is
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'IsKaderLid',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'TRUE',
'Message' => 'Is kaderlid',
'hccLidnr' => $hccLidnr,
'cn' => $cn,
'sn' => $sn,
'hccRol' => $hccRol,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward);
Output negatief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Is geen kaderlid');

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.4 Vraag alle groeperingen op
// Het is mogelijk om een groepering te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// ToonInOverzichtenFilter : attribuut 'hccToonInOverzichten'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// BulletinsFilter : attribuut 'hccBulletins'
// EmailFilter : attribuut 'hccFunctionalEmail'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleGroeperingen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['ToonInOverzichtenFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['BulletinsFilter' => '' | 'TRUE',]
['EmailFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE'));
Output positief:
$reply = array(
'Action' => 'GeefAlleGroeperingen',
'Status' => 'TRUE',
'Message' => 'Lijst met groeperingen opgevraagd',
'Result' => $groeperingen,
['JoomlaFilter' => 'TRUE',]
['ToonInOverzichtenFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']);

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.5 Vraag alle kaderrollen op
// Het is mogelijk om een kaderrol te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleKaderRollen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']));
Output positief:
$reply = array(
'Action' => 'GeefAlleKaderRollen',
'Status' => 'TRUE',
'Message' => 'Lijst met kaderrollen opgevraagd',
'Result' => $kaderrollen,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']);

// ** t.b.v. de kantoor-beheerpagina **
// F.9 Geef de gevevens van de mailbox van dit kaderlid
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
$request = xmlrpc_encode_request(
'GeefKadermailGegevens',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer));
Output positief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'kadermail_omvang' => $Formaat,
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald);
Output negatief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid'));

// ** t.b.v. de Joomla Kadernet module **
// * F.10 MuteerGroeperingSamenstelling
// (authenticatie op basis van lidnummer, JoomlaToken en siteID en als extra hccCode van de aanvrager)
$request = xmlrpc_encode_request(
'MuteerGroeperingSamenstelling',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccCode' => $hccCode,
'groepering' => $groepering,
'hccLidnummer => $hccLidnummer, // lidnummer van het te muteren hcc lid
'hccRol' => $hccRol, // de nieuwe dan wel op te heffen rol
// de rol 'ALLES_WEG' ruimt alle rollen van dit hcc lid voor deze groepering op
'actie' => 'Nieuw' | 'Weg',
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress,]
Output positief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'TRUE',
'Message' => 'Groepering samenstelling aangepast',
['ExtraInfo' => 'Bedankmail gestuuurd aan ex-kaderlid']);
Output negatief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid' |
'Oude rol niet gevonden' |
'Nieuwe rol kan niet samen met bestaande rol' |
'Alleen voorzitter of secretaris kan kadermutaties uitvoeren']);
</pre>

=== HCC-groepering aanroepen ===

<pre>
// I.2 controleer of een gebruiker bestaat op basis van de combinatie
// lidnummer + postcode + huisnummer
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
// (alternatieve authenticatie mogelijk door lidnummer + hcc-code in te vullen)
//
// Aan de aanroeper worden zekere eisen gesteld:
// * dient een rol te vervullen binnen de groepering 'FOR'(forum)
// * dan wel dient de rol 'VRBK' (vraagbaak) te vervullen binnen een groepering
//
// Er wordt door de gehele leden-database gezocht, waarna terug wordt gegeven
// * of dit hcc lid inderdaad bestaat
// en, als het om een aanvraag van een vraagbaak vrijwilliger gaat,
// * tevens of het gezochte hcc lid deel uitmaakt van zijn groepering
//
// ==> Mag weg: laatste aanroep 2018.07.27 <==
//
$request = xmlrpc_encode_request(
'IsHCCLid',
array(
'hccLogin' => [$hccLogin | $hccLidnummer],
'userPassword' => [$userPassword | $hccCode],
'zoekhccLidnr' => $zoekhccLidnr,
'zoekhccPostcode' => $zoekhccPostcode,
'zoekhccHuisnr' => $zoekhccHuisnr,
'zoekgroepering' => $zoekgroepering));
Output positief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gecontroleerd',
['Groeperingslid' => $IsGroeperingLid]));
Output negatief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker bestaat niet' |
'Onjuiste credentials' |
'Wel HCC lid, maar geen lid van groepering $groepering' |
'Onvoldoende rechten' |
'Vul alle verplichte velden in!'));
</pre>

=== HenZ aanroepen ===

<pre>
// I.3 Geef de einddatum van een actief dan wel uitgeschreven lid
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'GeefhccEindDatum',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'TRUE',
'hccLidnummer' => $hccLidnummer,
'hccLogin' => $hccLogin,
'hccEindDatum' => $hccEindDatum ('yyyymmdd' | ''));
Output negatief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Invalid credentials' |
'Lidnummer niet gevonden');
</pre>

=== (Forum,vraagbaak) onderwerpen ===

<pre>
// L.1 MaakOnderwerp
$request = xmlrpc_encode_request(
'MaakOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'description' => $description,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp is aangemaakt',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster');

// L.2 VerwijderOnderwerp

$request = xmlrpc_encode_request(
'VerwijderOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'TRUE',
'onderwerp' => $onderwerpID,
'Message' => 'Onderwerp is verwijderd',
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Ruim eerst alle geautoriseerde gebruikers op' |
'Kan onderwerp niet verwijderen');

// L.3 GeefOnderwerpen
// Geef het array met de lijst van onderwerpen voor de betreffende groepering
//
$request = xmlrpc_encode_request(
'GeefOnderwerpen',
array(
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'TRUE',
'Message' => 'Onderwerpen opgevraagd',
'onderwerpen' => $onderwerpen); // het array met onderwerpen
Output negatief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!');

// L.4 MuteerOnderwerp
// Pas de description van een onderwerp aan
//
$request = xmlrpc_encode_request(
'MuteerOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'description' => $description,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp aangepast',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Onderwerp behoort bij andere groepering');

// L.5 MuteerOnderwerpAutorisatie
// Geef kaderlid $kaderLidNr de autorisatie MOD, VRBK of RED bij onderwerp $onderwerp
// (of haal die autorisatie weg)
$request = xmlrpc_encode_request(
'MuteerOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'onderwerp' => $onderwerpID,
'kaderLidNr' => $kaderLidNr,
'hccAutorisatie' => 'MOD' | 'VRBK' | 'RED',
['verwijder' => 'TRUE']));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Onderwerp autorisatie aangepast');
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Geen kaderlid' |
'Onjuiste autorisatie opgegeven' |
'Onderwerp bestaat niet');

// L.6 ToonOnderwerpAutorisatie
$request = xmlrpc_encode_request(
'ToonOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Autorisaties opgehaald',
'onderwerp' => $onderwerpID,
'description' => $description,
'autorisaties' =>
[Array(
'hccLidnummer' => $hccLidnummer
'cn' => $cn
'hccAutorisatie' => {komma-gescheiden autorisaties})]);
Output negatief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet');
</pre>

=== Microsoft Dynamics Cloud (Cayentis) onderwerpen ===

<pre>
// M.1 Upload_CSV_bestand
// De CRM proxy upload de dagelijkse CSV synchronisatie-bestanden naar de XML-RPC server
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Upload_CSV_bestand',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'CSV_bestand_type' => '1' | '2' | '3' , // 1=Contactpersonen/Hoofdlidmaatschappen
// 2=Gremiumlidmaatschap codes
// 3=Gremiumlidmaatschappen
'CSV_bestand' => $CSV_bestand)); // het CSV bestand (base64 encoded)
Output positief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'TRUE',
'Message' => 'Bestand opgeslagen');
Output negatief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.2 SchrijfNieuwLidIn
//
// Maak in het CRM een nieuw HCC lid aan
// De NAW gegevens worden in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'SchrijfNieuwLidIn',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'NAWgegevens' => $NAW_Array,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress);
// $NAW_array = array(
// 'GeboorteDatum' => $geboortedatum,
// 'Geslacht' => $geslacht,
// 'Voornaam' => $voornaam,
// 'Voorletters' => $voorletters,
// 'Tussenvoegsel' => $tussenvoegsel,
// 'Achternaam' => $achternaam,
// 'Straatnaam' => $straatnaam,
// 'Huisnummer' => $huisnummer,
// 'HuisnummerToevoeging' => $huisnummertoevoeging,
// 'Woonplaats' => $woonplaats,
// 'Postcode' => $postcode,
// 'Land' => $land,
// 'Telefoonnummer' => $telefoonnummer,
// 'MobielNummer' => $mobielnummer,
// 'Mail' => $mail,
// 'IBAN' => $IBAN,
// 'Interessegroep' => $IGs, // komma-gescheiden lijst met IG's
// 'Geschenk' => $geschenk,
// 'Actiecode' => $actiecode,
// 'Voorwaarden' => $Akkoord); // 'Akkoord'
)
Output positief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'TRUE',
'Message' => 'nieuw lid ingeschreven',
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode);
Output negatief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.3 Verwerk_JSON_mutatie
// De CRM proxy kan NAW en/of IG mutaties en/of hccCode mutaties live doorgeven
// Deze gegevens worden in JSON in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Verwerk_JSON_mutatie',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'mutatie_type' => '1' | '2', // 1=Contactpersoon/Hoofdlidmaatschap
// 2=Gremiumlidmaatschap
'JSON_mutatie' => $JSON_mutatie)); // de JSON payload
Output positief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'TRUE',
'Message' => 'Mutatie verwerkt');
Output negatief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.4 Vertaal landcode
// Het CRM werkt met numerieke landcodes, wij met cijfers
// Vertaal die
// Er moet in de aanroep 1 veld aanwezig zijn, beide waarden komen in het antwoord terug
$request = xmlrpc_encode_request(
'ISO_landcode',
array(
['ISO_numeriek' => $ISO_numeriek,]
['ISO_code ' => $ISO_code]));
Output positief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'TRUE',
'Message' => 'ISO code lookup geslaagd',
'ISO_numeriek' => $ISO_numeriek,
'ISO_code ' => $ISO_code,
'ISO_benaming' => $ISO_benaming); // de descriptive name van deze ISO code
Output negatief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'FALSE',
'Message' => 'Kan geen bijpassende vertaling vinden'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.5 MuteerAanmeldingsformulier
// Sla een JSON veld op in de XML-RPC server zodat deze weer opgehaald kan worden door de websites
// Authenticatie op basis van hccLidnummer en JoomlaToken
// Deze mutaties mogen alleen door HN#WM of SITE#WM gedaan worden.

$request = xmlrpc_encode_request(
MuteerAanmeldingsformulier,
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
'formulierdata' => $formulierdata, // JSON veld met alle gegevens voor het aanmeld formulier
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress ));
Output positief:
$reply = array(
'Action' => 'MuteerAanmeldingsformulier',
'Status' => 'TRUE',
'Message' => 'aanmeldingsformulier bijgewerkt';

// M.6 HaalAanmeldingsformulier
// (geen authenticatie)
$request = xmlrpc_encode_request(
HaalAanmeldingsformulier,
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalAanmeldingsformulier',
'Status' => 'TRUE',
'formulierdata' => $formulierdata); // JSON veld met alle gegevens voor het aanmeld formulier

// M.7 GeefFactuurOverzicht
// (authenticatie op basis van hccLidnummer + JoomlaToken + siteID
$request = xmlrpc_encode_request(
GeefFactuurOverzicht,
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefFactuurOverzicht',
'Status' => 'TRUE',
'FactuurOverzicht' => $FactuurOverzicht);
// $FactuurOverzicht =
// array(
// array(
// 'FactuurID' => 'a5b93460-4536-ea11-a813-000d3a2c53fa',
// 'FactuurNummer' => '200118673J5'
// 'FactuurDatum' => '2020-01-15'
// 'bedrag' => 42.37
// 'BetaalStatus' => 0]));
// )

// M.8 HaalFactuur
// (authenticatie op basis van JoomlaToken of FactuurToken)
$request = xmlrpc_encode_request(
HaalFactuur,
array(
'hccLidnummer' => $hccLidnummer,
['JoomlaToken' => $JoomlaToken,]
['FactuurToken' => $FactuurToken,]
'FactuurNummer' => $FactuurNummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalFactuur',
'Status' => 'TRUE',
'factuur' => $factuurgegevens);
// $factuurgegevens =
// array(
// 'FactuurNummer' => $FactuurNummer,
// 'FactuurDatum' => $FactuurDatum,
// 'FactuurID' => $FactuurID,
// 'Bestandsnaam' => $Bestandsnaam,
// 'PDF' => $PDF) // base64 encoded PDF
</pre>

=== Echo test ===

<pre>

// t.b.v. controle of de verbinding met de XML-RPC server functioneert
// Eenvoudige echo test

$request = xmlrpc_encode_request(
'echo',
array(
'What' => $string,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'echo',
'Status' => 'TRUE',
'Message' => $string);
</pre>

=== HenZ XML-RPC interface ===

Overzicht van XML-RPC procedures die bij HenZ draaien
(worden via de Hobbynet XML-RPC server afgehandeld)

<pre>
- Action=2
wijzig gebruikersnaam en wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=3
controleer of een gebruikersnaam bestaat
(XML-RPC server voert de hccnet XML-call uit, zie 8.2)

- Action=4
creer een nieuwe gebruiker. Per lidnummer is er 1 account. Als er al een
account voor dit lidnummer bestaat wordt het bestaande account hernoemd.
(XML-RPC server voert de hccnet XML-call uit, zie 8.1)

- Action=5
wijzig wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=7
Uitgeschreven lid is weer actief lid geworden
(Wordt aangeroepen vanuit de cronjob)

- Action=8
Lid heeft een nieuwe hcc-code gekregen
(Wordt aangeroepen vanuit de cronjob)
</pre>

=== Release notes ===
<pre>
2012.02.08 Wijzigingen versie 5:
- 4.1 verwijder_hcc_Lidnummer i.p.v. hcc_Lidnummer
- 4.1 optionele extra parameter verwijder_hccLogin
- Optionele parameters aangegeven
- Vanwege de duidelijkheid de beheerLogin en beheerPassword velden
bovenin de betreffende aanroepen gezet
(De volgorde van de parameters is niet relevant, dus dit is geen
interface-aanpassing)
2012.02.16 Wijzigingen versie 6:
- 2.1/2.2/2.3 geef ook cn en sn terug na aanpassen van het wachtwoord
- 3.1 geef cn en sn terug na aanmaken nieuwe gebruiker
2012.02.27 Wijzigingen versie 7:
- Neem de XML-RPC interface van HenZ in deze XML-RPC server op
8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gegevens tevens in LDAP op
- 2.1 wijzig wachtwoord - optie 1
* Nieuw wachtwoord is verplicht, niet optioneel
* wijzigingen worden naar hccnet.nl doorgezet
- 2.2 wijzig wachtwoord, optie 2
* Nieuw wachtwoord is verplicht, niet optioneel
* gebruikersnaam kan niet meer via deze interface aangepast worden
* wijzigingen worden naar hccnet.nl doorgezet
- 2.3 wijzig wachtwoord, optie 3
* wijzigingen worden naar hccnet.nl doorgezet
2012.03.26 Wijzigingen versie 8:
- Breidt de XML-RPC interface van HenZ in deze XML-RPC server uit met
8.2 Controleer of de gebruikersnaam op dit moment bestaat
2012.04.09 Wijzigingen versie 9:
- Vervang alle 'ldap' aanroepen door 'HCCldap' aanroepen
- documentatie van HenZ call action=2 aangepast, action=5 toegevoegd
2012.05.03 Wijzigingen versie 10:
- 1.1 / 1.2 / 1.3 geven nu ook 'ProfielBekend' terug om uniek te bepalen
of deze bezoeker een first-time-login pagina te zien dient te krijgen
- documentatie van 2.1 (wijzig wachtwoord) aangepast:
2.1 kan alleen als profiel is doorlopen
- nieuwe procedure t.b.v. zoekscherm PC30
* A.1 ZoekHCCLid
- hiervoor is de database met diverse velden uitgebreid
(postcode, e-mailadres, huisadres, woonplaats, land, telefoonnummer)
Dit heeft impact op diverse andere procedures (t.b.s.)
- nieuwe procedure t.b.v. 'gewone' profielpagina
* B.1 GeefDBFPersoonID
- nieuwe procedure t.b.v. cron-job
* C.1 GeefOpgezegdeLeden
2012.05.10 Wijzigingen versie 11
- 1.3 GebruikerBestaatControle
* nieuwe parameter: hccPseudoniem
* nieuw veld in antwoord: hccPseudoniem
- 2.3 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 2.4 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 3.1 NieuweGebruiker
* nieuwe parameter: hccPseudoniem
- 8.1 MaakGebruikerAan
* nieuwe parameter: nieuw_hccPseudoniem
* alle parameters zijn verplicht (niet langer optioneel)
* nieuw antwoord: Gegevenscombinatie onjuist
- 8.3 IsDezePseudoniemNogBeschikbaar
* Nieuwe procedure t.b.v. 1e keer doorlopen profielpagina
- A.1 ZoekHCCLid
* 'Zoeklimiet bereikt' wordt als ExtraInfo meegegeven
* nieuwe velden in antwoord: hccPseudoniem en hccLogin
- B.1 GeefDBFPersoonID
* Zoeken kan nu ook op hccLogin en op hccPseudoniem
- C.1 GeefOpgezegdeLeden
* Geef nu ook hccLogin en hccPseudoniem terug
2012.05.14 Wijzigingen versie 12
- 1.x GebruikerBestaatControle
* Geef ook DBFPersoonID terug
- 4.1 Gooi een gebruiker weg.
* Haal ongebruikte parameter hccLogin weg
- 5.1 Wijzig hccIG
* Haal ongebruikte parameter hccLogin weg
- 6.1 Wijzig hccRegio
* Haal ongebruikte parameter hccLogin weg
- 7.1 Wijzig hccRol
* Haal ongebruikte parameter hccLogin weg
2012.05.20 Wijzigingen versie 13
- A.1 ZoekHCCLid
* Geef resultaten gestructureerder formaat
* Geef in ExtraInfo weer hoeveel echte resultaten er gevonden zijn
- C.1 GeefOpgezegdeLeden
* Geef resultaten in gestructureerder formaat
2012.06.03 Wijzigingen versie 14
- 3.1 NieuweGebruiker
* Geef ook DBFPersoonID mee
2012.08.17 Wijzigingen versie 15
- C.1 GeefOpgezegdeLeden
* Geef ook hccLogin in het antwoord terug
- D.1 HCCpartner/ControleerHCCLidmaatschap
* Nieuwe aanroep
2012.09.29 Wijzigingen versie 16
- Alle cron gerelateerde opdrachten verwijderd
* 3.1 NieuweGebruiker
* 4.1 GooiGebruikerWeg
* 5.1 WijzigHccIG
* 6.1 WijzigHccRegio
* 7.1 WijzigHccRol
2012.10.28 Wijzigingen versie 17
- nieuwe procedure t.b.v. PC30 beheerpagina
* A.2 HaalPC30Token
- nieuwe procedure t.b.v. Drupal profielpagina
* 2.4 vervallen
(WijzigGebruikersGegevens op basis van pseudoniem)
* 2.5 WijzigGebruikersGegevens
Nieuwe keuze: wijzig pseudoniem
2012.11.14 Wijzigingen versie 18
- 1.x GebruikerBestaatControle
* Geef ook mail in het antwoord terug
2012.11.30 Wijzigingen versie 19
- E.1 HCCkader/WijzigGebruikersGegevens
* Nieuwe aanroep
- F.1 / F.2 / F.3 ControleerKaderlid
* Nieuwe aanroep
2012.12.18 Wijzigingen versie 20
- Haal DBFPersoonID weg uit alle aanroepen en alle resultaten
* Antwoord van 1.x GebruikerBestaatControle
* B.1 GeefDBFPersoonID opgeheven
- A.1 ZoekHCCLid geeft nu ook hccMobiel terug (t.b.v. PC30 zoekpagina)
- C.1 GeefOpgezegdeLeden verder uitgewerkt:
* Geeft alleen de door Drupal gebruikte velden 'hccLogin' en 'hccEindDatum'
terug in het antwoord
* Geeft nu 'echte' antwoorden i.p.v. dummy resultaten
- F.1 ControleerKaderlid geeft nu ook optioneel 'sn' en 'givenName'
terug (in de beheer-variant)
2013.01.25 Wijzigingen versie 21
- A.1 ZoekHCCLid uitgebreid
* Geeft nu ook hccBeginDatum, hccEindDatum en hccRol terug
2013.02.02 Wijzigingen versie 22
- A.1 ZoekHCCLid
* Interface aangepast
- A.3 ZoekGroeperingsLid
* Nieuwe aanroep
- F.4 GeefAlleGroeperingen
* Nieuwe aanroep
- F.5 GeefAlleKaderRollen
* Nieuwe aanroep
2013.03.01 Wijzigingen versie 23
- A.3 ZoekGroeperingsLid
* Geeft andere resultaten terug
- 2.2 WijzigWachtwoord
* Geeft nu ook hccLogin terug (voor ww-vergeten op de Drupal site)
- HCCenquete implementatie
* G.1 Expandeer NL postcode
* G.2 Haal lidgegevens op
* G.3 Pas lidgegevens aan
2013.03.18 Wijzigingen versie 24
- ZoekGroeperingsLid op basis van token
- A.4 Lid bezoekt bijeenkomst
* nieuwe aanroep
- A.5 VraagLidgegevensTokenAan
* nieuwe aanroep
2013.04.07 Wijzigingen versie 25
- D.1 HCCpartner/ControleerHCCLidmaatschap
Simpeler interface ontwikkeld ('HCCpartners' i.p.v. 'HCCpartner')
- G.3 mag ook Tussenvoegsels aanpassen
2013.04.25 Wijzigingen versie 26
- H.1 HCC-groepering / GebruikerBestaatControle
Nieuwe interface voor validatie vanaf groeperings websites
2013.05.03 Wijzigingen versie 27
- 2.6 HaalOptInKeuzen
* nieuwe aanroep
- 2.7 SchrijfOptInKeuzen
* nieuwe aanroep
- 2.8 HaalOptInLijst
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* nieuwe aanroep
- HCCpartners aanroep nieuwe interface ('Action' => 'ControleerHCCLidmaatschap')
2013.07.05 Wijzigingen versie 28
- 8.1 MaakGebruikerAan
* extra parameters (mail, hccPseudoniem) in het antwoord
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra parameter (mailHccnet)
- A.1 ZoekHCCLid
* extra parameter (mailHccnet)
- A.3 ZoekGroeperingsLid
* extra parameter (mailHccnet)
2013.08.31 Wijzigingen versie 29
- F.1 / F.2 / F.3 HCC-kader / ControleerKaderlid
* extra output parameter (hccKaderMail)
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra output parameter (hccForumLogin)
- H.1 HCC-groepering / GebruikerBestaatControle
* komma-gescheiden lijst met groeperingen mogelijk
* extra output parameter (mailHccnet)
2013.12.26 Wijzigingen versie 30
- 3.1 Geef mijn lidnummer
* nieuwe aanroep
- A.1 ZoekHCCLid
* geef nu ook 'ProfielBekend' terug om aan de PC30 omgeving door te geven
dat het wachtwoord niet veranderd mag worden door PC30
- A.6 GeefBezoekersOverzicht
* geef nu ook 'Locatie' terug indien van toepassing
- A.7 GeefLocaties
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* parameters aangepast
* authenticatie op basis van hccLogin + userPassword of lidnummer + hcc-code
* geen algemene hcc-forum authenticatie meer mogelijk
- F.7 ControleerKaderlidGroep
* Nieuwe aanroep
2014.02.01 Wijzigingen versie 31
- A.8 RegistreerGast
* nieuwe aanroep
- H.2 MatchPostcodeMetRegio
* nieuwe aanroep
- nieuwe interface (losse, unieke aanroepen, niet meer gegroepeerd)
2014.09.27 Wijzigingen versie 32
- C.1 GeefOpgezegdeLeden hernoemd naar GeefUitgeschrevenLeden
- I.3 GeefhccEindDatum
* nieuwe aanroep
- Action=7 en Action=8 toegevoegd aan de HenZ interface
2014.12.12 Wijzigingen versie 33
- F.1 / F.2 / F.3 HCC-kader / IsKaderLid
* extra output parameter (mail, mailHccnet, hccKaderForward)
- F.8 HCC-kader / ZetKaderForward
* nieuwe aanroep
2015.05.06 Wijzigingen versie 34
- GeefMijnGegevens
* nieuwe aanroep
- ValideerPCActiveAbonnee
* vervallen
- 1.4 GebruikerBestaatControle
* extra output parameter (hccKaderForward)
- D.1 HCCpartner/ControleerHCCLidmaatschap
* optionele extra output parameter (ExtraInfo)
2015.09.27 Wijzigingen versie 35
- HeeftForumCredentials
* vervallen
2015.11.20 Wijzigingen versie 36
- SchrijfNietlidInOpBulletin
* nieuwe aanroep
2015.12.13 Wijzigingen versie 37
- serverID als optionele parameter
- SchrijfNietlidInOpBulletin
* Maak velden optioneel
2016.01.05 Wijzigingen versie 38
- A.7 GeefLocaties
* optionele parameter JoomlaFilter
- F.4 GeefAlleGroeperingen
* optionele parameter JoomlaFilter
- F.5 GeefAlleKaderRollen
* optionele parameter JoomlaFilter
2016.01.15 Wijzigingen versie 39
- H.3 GeefMijnGegevens
* geeft nu ook hccOptIn terug
* geeft nu ook JoomlaToken terug
- H.4 PasOptInKeuzeAan
* nieuwe aanroep
- SiteID en RemoteID als optionele parameter
2016.03.17 Wijzigingen versie 40
- H.5 ZoekKaderLeden
* nieuwe aanroep
2016.03.20 Wijzigingen versie 41
- ServerID, SiteID en RemoteID als optionele parameters bij alle aanroepen
- A.7 GeefLocaties
* optionele parameter KadernetFilter
- A.9 GeefLocatieNamen
* optionele parameter KadernetFilter
- F.4 GeefAlleGroeperingen
* optionele parameter KadernetFilter
- F.5 GeefAlleKaderRollen
* optionele parameter KadernetFilter
- F.6 WijzigHccRol
* vervallen
- F.7 IsGroeperingsKaderlid
* vervallen
- 8.3 IsDezePseudoniemNogBeschikbaar
* vervallen
- 2.7 SchrijfOptInKeuzen
* vervallen
- 2.5 WijzigGebruikersGegevens (hccPseudoniem)
* vervallen
- H.2 MatchPostcodeMetRegio
* vervallen
2016.04.02 Wijzigingen versie 42
- H.6 GeefMijnKaderDetails
* nieuwe aanroep
2016.07.03 Wijzigingen versie 43
- Ubuntu 16.04 aanpassingen (PHP versie 7) beschreven
2016.09.01 Wijzigingen versie 44
- H.5 ZoekKaderLeden
* extra parameter 'hccMobiel'
2016.10.13 Wijzigingen versie 45
- H.3 GeefMijnGegevens (dedecated Joomla aanroep)
* hccForumLogin weg als parameter
* Als het om een webmaster gaat, vul dan eventueel hccRegio of hccIG aan
met die groepering, ook als hij geen lid is van die groepering
- I.4 GebruikerBestaatControle
* hccForumLogin weg als parameter
2016.12.01 Wijzigingen versie 46
- 8.3 IsDezePseudoniemNogBeschikbaar teruggezet
2017.05.28 Wijzigingen versie 47
- H.7 GeefMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
- H.8 ZetMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
2017.09.01 Wijzigingen versie 48
- A.10 SchrijfNietlidInOpBulletin nu alleen voor 1 bulletin tegelijk
- 2.2 WijzigGebruikersGegevens (op basis van gebruikersnaam en wachtwoord)
is vervallen (was een oude Drupal aanroep)
- A.3 ZoekGroeperingsLid geeft ook hccKaderToonMobiel terug
- H.7 GeefMinimaleKaderGegevens geeft ook hccKaderToonMobiel terug
2017.11.14 Wijzigingen versie 49
- A.3 ZoekGroeperingsLid geeft geen hccKaderToonMobiel meer terug
- A.3 ZoekGroeperingsLid geeft alleen hccMobiel als hccKaderToonMobiel dat toestaat
2018.02.18 Wijzigingen versie 50
- H.6 GeefMijnKaderDetails geeft ook hccKaderToonMobiel terug
- H.9 PasKaderGegevensAan
* nieuwe aanroep
- H.3 GeefMijnGegevens geeft 3 extra parameters terug (hccKaderMail, hccKaderForward,
hccKaderToonMobiel)
- JoomlaTokens worden gevalideerd op siteID, niet langer op serverID
- diverse aanroepen kunnen nu ook via de bezoekersregistratie-proxy aangeroepen worden.
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
(GeefAlleGroeperingen, GeefAlleKaderRollen, GeefLocaties, GeefLocatieNamen)
De bezoekersregistratie aanroepen hebben enkel JoomlaToken als extra parameter nodig:
(LidBezoektBijeenkomst, GeefBezoekersOverzicht)
2018.02.26 Wijzigingen versie 51
- H.3 GeefMijnGegevens geeft extra parameter hccMobiel terug
- H.9 PasKaderGegevensAan kan nu ook kadermail password aanpassen
- K.1 ValideerToken
* nieuwe aanroep
- K.2 ValideerHCCCode
* nieuwe aanroep
2018.03.17 Wijzigingen versie 52
- H.3 Haal al mijn gegevens
Extra optie 'compact' om alleen essentiele resultaten te verkrijgen
(t.b.v. de Android bezoekersregistratie applicatie)
2018.03.25 Wijzigingen versie 53
- I.2 IsHCCLid
(Oude aanroep teruggezet, wordt nog in vraagbaak module gebruikt)
2018.07.01 Wijzigingen versie 54
* A.1 beheer authenticatie op basis van lidnummer + hccCode (tbv VZ-portal)
* A.2 HaalPC30Token weggehaald
2018.08.22 Wijzigingen versie 55
* 1.2 GebruikerBestaatControle' (op basis van hccLogin en userPassword) weggehaald
* 1.4 GebruikerBestaatControle' (op basis van zoekHccLogin of zoekHccLidnr) weggehaald
* 2.8 HaalOptInLijst weggehaald
* E.1 PasKaderWachtwoordAan weggehaald
* F.1 IsKaderLid (op basis van hccLidnr en hccCode) weggehaald
* F.3 IsKaderLid (op basis van beheerdernaam en beheerderwachtwoord) was al weg
* F.8 ZetKaderForward weggehaald
* H.1 IsGroeperingsLid weggehaald
* H.6 GeefMijnKaderDetails weggehaald
* H.7 GeefMinimaleKaderGegevens weggehaald
* H.8 ZetMinimaleKaderGegevens weggehaald
* K.1 ValideerHCCCode weggehaald
* K.2 ValideerToken weggehaald
* H.3 GeefMijnGegevens geeft omvang kader mailbox mee terug
2018.11.06 Wijzigingen versie 56
Nieuwe aanroepen t.b.v. forum en vraagbaak autorisaties
* L.1 MaakOnderwerp
* L.2 VerwijderOnderwerp
* L.3 GeefOnderwerpen
* L.4 MuteerOnderwerp
* L.5 MuteerOnderwerpAutorisatie
* L.6 ToonOnderwerpAutorisatie
* H.5 ZoekKaderLeden heeft compact optie
2018.11.16 Wijzigingen versie 57
* L.5 MuteerOnderwerpAutorisatie kent nu ook RED(acteur)
2018.12.17 Wijzigingen versie 58
* A.11 GeefBezoekersAantallen (nieuwe aanroep)
* H.10 PasUserWachtwoordAan (nieuwe aanroep)
2019.02.21 Wijzigingen versie 59
* A. 6 GeefBezoekersOverzicht geeft enkel lijst van bezoekers laatste bijeenkomst
2019.10.26 Wijzigingen versie 60
* A.4 Schrijf bezoekers niet meer automatisch in op bulletins
* H.4 PasOptInKeuzeAan kan ook door LA aangeroepen worden
Nieuwe aanroepen t.b.v. eigen implementatie van mijn.hcc.nl in de Joomla modules
* H.11 PasPseudoniemAan
* H.12 ValideerWachtwoordEisen
* H.13 PasWachtwoordAan (1: op JoomlaToken, 2: op PWResetToken)
* H.14 MaakPWResetToken
* H.15 ValideerPWResetToken
* H.16 RuimJoomlaTokenOp
* A.12 GeefAlleBulletins
* A.13 ExpandeerPostcode
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.18 NormaliseerTelefoon
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
* A.21 HaalIGBedragenOp
* A.22 HaalTariefGroepenOp
* A.23 PasInteressegroepAan
* F.10 MuteerGroeperingSamenstelling
* A.24 GeefSSOUrls
Aanpassingen gemaakt aan
8.1 MaakGebruikerAan
F.5 GeefAlleKaderRollen
2020.01.04 Wijzigingen versie 61
Nieuwe aanroepen t.b.v. IDEAL betaling hobbynet abonnees
H.17 GeefAantalDomeinen
2020.01.06 Wijzigingen versie 62
Nieuwe aanroepen t.b.v. Cayentis (CRM webproxy) implementatie
* M.1 Upload_CSV_bestand
* M.2 SchrijfNieuwLidIn
* M.3 Verwerk_JSON_mutatie
* M.4 ISO_landcode
* M.5 MuteerAanmeldingsformulier
* M.6 HaalAanmeldingsformulier
* M.7 GeefFactuurOverzicht
* M.8 HaalFactuur
* A.25 UpdateNAW
Vervallen aanroepen
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
Aangepaste aanroepen
* A.23 PasInteressegroepAan
2020.03.27 Wijzigingen versie 63
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.18 ResetHCCCode
* H.19 PasHccLoginAan
2020.04.10 Wijzigingen versie 64
Nieuwe aanroepen
* A.26 VerwijderNietLid
Aanpassingen gemaakt aan
* A.1 ZoekHCCLid: nieuwe zoekoptie 'niet_leden'
Opnieuw geimplementeerd
* A.20 UpdateMobiel
2020.11.26 Wijzigingen versie 65
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.20 MaakTestLogin
Aanpassingen gemaakt aan
- H.3 GeefMijnGegevens: optionele parameter 'hccGroepering'
Het werken met een testaccount heeft impact op de volgende aanroepen:
- G.7 GeefFactuurOverzicht
- M.8 HaalFactuur
- L.1 MaakOnderwerp
- H.14 MaakPWResetToken
- F.10 MuteerGroeperingSamenstelling
- L.4 MuteerOnderwerp
- L.5 MuteerOnderwerpAutorisatie
- H.19 PasHccLoginAan
- A.23 PasInteressegroepAan
- H.9 PasKaderGegevensAan
- H.4 PasOptInKeuzeAan
- H.11 PasPseudoniemAan
- H.13 PasWachtwoordAan
- H.18 ResetHCCCode
- A.20 UpdateMobiel
- A.25 UpdateNAW
- L.2 VerwijderOnderwerp
- A.5 VraagLidgegevensTokenAan
- 2.1 WijzigGebruikersGegevens
- H.3 GeefMijnGegevens geeft extra parameter terug (testaccount)
2021.08.01 Wijzigingen versie 66
Aanpassingen gemaakt aan
- H.4 PasOptInKeuzeAan werkt nu ook op basis van OptOutToken
2021.10.10 Wijzigingen versie 67
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
- H.21 UpdateOTP
Aanpassingen gemaakt aan
- H.3 GeefMijnGegevens geeft extra parameters terug (hccOtpKey en hccOtep)
2021.10.13 Wijzigingen versie 68
Aanpassingen gemaakt aan
- H.21 UpdateOTP
</pre>

= Aanpassingen aan de Apache omgeving =

== php.ini aanpassingen ==
De XML-RPC server zal 'ergens' een bestand moeten kunnen vinden met de
gebruikersnamen t.b.v. het authenticeren bij de LDAP-server.

Dit bestand wordt geplaatst in de map '/usr/local/hobbynet/etc'. Om dit
vanuit Apache te mogen benaderen, dient een aanpassing aan php.ini
gemaakt te worden:

/etc/php5/apache2/php.ini

include_path = ".:/usr/share/php:/usr/share/pear:/usr/local/hobbynet/etc"

== Apache modules ==
Nieuwe server geschikt maken voor XML-RPC gebruik

=== Apache modules (PHP 7) ===
Ubuntu 16.04 wordt standaard met PHP versie 7.0 uitgeleverd.
De opdrachten om de modules op te halen zijn:
apt-get install php-xmlrpc
apt-get install apache2
apt-get install ldap-utils
apt-get install php-ldap
apt-get install libapache2-mod-php

== Loadbalancer akties niet naar de logbestanden schrijven ==
De loadbalancer haalt zeer frequent een testbestand op (/test.txt), om
te controleren of de xml-server operationeel is. Dat levert extreem veel
logging op in /var/log/apache2/other_vhosts.log.

Pas de apache configuratie zo aan, dat logging van alle opvragingen
vanaf de loadbalancers uitgezet wordt.
/etc/apache2/sites-enabled/xml-server

# Mark requests from loadbalancers
SetEnvIf Remote_Addr "212\.72\.227\.93" dontlog
SetEnvIf Remote_Addr "212\.72\.227\.94" dontlog
SetEnvIf Remote_Addr "172\.31\.1\.249" dontlog
SetEnvIf Remote_Addr "172\.31\.1\.250" dontlog
CustomLog ${APACHE_LOG_DIR}/access.log common env=!dontlog

= Firewall algemeen =
In de file /etc/hobby-firewall/hobby-firewall.local wordt het script
'/usr/local/hobbynet/bin/gen_fw.sh' aangeroepen.
Deze haalt de IP adressen op uit ldap.
(.local omdat we dit ook zo doen op de webservers).

De firewall wordt 4 x per dag herstart en /etc/hobby-firewall wordt
gesynchroniseerd (1-richting van lb1 naar lb2) met de volgende crontab
entries:

Op lb1:
0 0 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 5 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 11 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 17 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 23 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null

Op lb2:
15 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 0 * * * /etc/init.d/hobby-firewall restart >/dev/null

Het encrypted backup script is verplaatst naar '/usr/local/hobbynet/local' en hernoemd naar 'backup-encrypted.bash'.
Dit is omdat deze niet mee mag worden gesynchroniseerd.

Tevens wordt 1x per dag /usr/local/hobbynet/bin gesynchroniseerd (1-richting van hcc-ldap-lb1 naar hcc-ldap-lb2)

== Aanpassingen in de firewall ==
Op de server waar de XML-RPC server staat, moeten enkele firewall aanpassingen gemaakt worden.
* inkomend: sta TCP 443 toe vanaf het interne netwerk (www-prod, www-test), en vanaf eventuele andere plekken die we expliciet toe willen staan.
* inkomend: sta TCP 443 toe vanaf mijn.hcc.nl (XML-RPC aanroepen vanaf de portal)
* inkomend: sta TCP 443 toe vanaf service.hccnet.nl toe (XML-RPC aanroep GeefUitgeschrevenLeden vanuit HenZ)
* uitgaand: sta TCP 443 naar service.hccnet.nl toe (XML-RPC aanroepen naar HenZ)
* uitgaand: sta TCP 990 en 5000-6000 naar Apps.HCC.local (FTPS verkeer naar de HCC server bij Hobbynet)

== Aanpassingen aan AppArmor ==
Alhoewel technisch gezien dit bij slapd behoort, neem ik het toch hier op.

Als het Hobbynet certificaat in de map /disk/site/etc/ssl/hobby.nl/ wordt neergezet, dan zal apparrmor de toegang tot de certificaten blokkeren. Neem daarom in de '''local''' directory van apparmor het volgende op:
# /etc/apparmor.d/local/usr.sbin.slapd
# Site-specific additions and overrides for usr.sbin.slapd.
# For more details, please see /etc/apparmor.d/local/README.
#include <abstractions/ssl_certs>
/disk/site/etc/ssl/hobby.nl/ r,
/disk/site/etc/ssl/hobby.nl/* r,

= CRM (Azure) proxy herstarten =
Als er indicaties zijn dat niet alle JSON berichten meer vanuit het CRM aangeboden worden aan de XML-RPC server, dan kan het helpen om de CRM proxy te herstarten

* Ga naar https://portal.azure.com/
* Login met zelfde account als voor het CRM
* Soms krijg je een popup. Die kan je weg klikken, je wilt geen rondleiding
* Klik op '''hccdyn01-aps-crm01''' voor productie en '''hccdyn01-aps-dev01''' voor test
* En dan kan je op opnieuw starten klikken.

XML-RPC

2021-10-12T12:05:43Z

Hans: UpdateOTP

= XML-RPC interface =

De LDAP server kan direct gemuteerd worden via een LDAP koppeling. Zie
de standaard LDAP pagina voor de uitleg welke poorten daarvoor gebruikt
kunnen worden.

Daarnaast is er de wens ontstaan om via een standaard protocol met de
LDAP omgeving te kunnen communiceren. Er is hiertoe een XML-RPC
koppeling ontwikkeld. XML-RPC is een standaard interface, waarmee het
mogelijk is om vanuit diverse omgevingen op een gestandaardiseerde
manier te communiceren.

== Globale functie omschrijving ==
* Algemene aanroepen
** Controleer of een gebruiker bestaat
** Wijzig het wachtwoord ('userPassword')
** Zoek een gebruiker (t.b.v. kantoor en/of LA-akties groeperingssecretaris)
** Maak een gebruiker aan (geef gebruiker een andere hccLogin waarde, maak ook bij HCCnet deze gebruiker aan)
** Controleer of een gebruiker zijn profiel al doorlopen heeft
** Haal de lijst met opgeheven accounts op
** Haal de lijst met bulletins van een hcc lid (OptIn)

* Aanroepen t.b.v. hcc partners
** Controleer of lidnummer/postcode correct is
** Controleer of lidnummer/postcode correct is, en tevens ingeschreven staat bij een specifieke IG

* Joomla template site functies (op basis van JoomlaToken)
** Maak een JoomlaToken
** Ruim een JoomlaToken op
** Pas mijn OptIn (bulletin inschrijving) aan
** Regel alles rondom Onderwerpen en de autorisatie hiervan
** Pas mijn wachtwoord aan

* Joomla kadernet site functies (op basis van JoomlaToken)
** Zoek een hcc kaderlid (t.b.v. de kaderleden zoekpagina)
** Pas mijn kadermail forwarding aan en toon ja/nee mijn GSM nummer
** Pas het kadernet e-mail wachtwoord aan
** Haal de lijst met alle groeperingen op
** Haal de lijst met alle kaderrollen op

* Joomla hcc.nl site (op basis van JoomlaToken)(mijn.hcc.nl vervanging)
** Pas mijn adresgegevens aan
** Pas mijn voorletters, voornaam, pseudoniem, telefoonnummer, GSM nummer etcetera aan
** Schrijf me in of uit op een bulletin
** Toon info over de kosten van een IG lidmaatschap
** Voer een wachtwoord reset uit op basis van een PWResetToken (een variant op JoomlaToken)
** Vraag een nieuwe HCC code aan, en stuur die per SMS

* Joomla hobby.nl site (op basis van JoomlaToken)(t.b.v. IDEAL betaling)
** Haal het aantal hobbyDomains op

* Aanroepen t.b.v. CRM (Microsoft Dynamics Cloud) koppeling
** Haal de dagelijkse synchronisatie bestanden op
** Werk in het CRM dan wel in LDAP de NAW gegevens bij
** Werk in het CRM dan wel in LDAP de IG gegevens van een lid bij

* HenZ
** Haal de lijst met opzeggers op
** Valideer de opzegdatum van een opgegeven gebruiker

=== Authenticatie ===

Alle aanroepen gebeuren op basis van authenticatie vanuit de aanroeper.
Dit valt uiteen in de volgende categorieën:
* gebruikersnaam ('hccLogin') en wachtwoord ('userPassword')
* hcc lidnummer ('hccLidnr'), Joomla token ('JoomlaToken') en website ('siteID')
* hcc lidnummer ('hccLidnr') en hcc code ('hccCode')
* beheerders-DN ('beheerLogin') en beheerders wachtwoord ('beheerPassword')
* partner-DN ('partnerLogin') en partner wachtwoord ('partnerPassword')

=== Aanroepen, gedaan via de bezoekersregistratie-proxy ===
(de bezoekersregistratie proxy is een mislukt project tbv de Android app van René Prins)
(deze proxy bestaat niet meer) 
Diverse aanroepen kunnen ook via de bezoekersregistratie-proxy aangeroepen worden. 
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
* GeefAlleGroeperingen
* GeefAlleKaderRollen
* GeefLocaties
* GeefLocatieNamen
De bezoekersregistratie aanroepen hebben 'JoomlaToken' als extra parameter nodig:
* LidBezoektBijeenkomst
* GeefBezoekersOverzicht
* GeefBezoekersAantallen
De aanroepen die over de proxy uitgevoerd worden dienen voorafgegaan te worden door een aanroep naar
* GeefMijnGegevens (dit geeft na validatie immers 'JoomlaToken' terug)

=== Resultaten ===

Alle aanroepen geven de volgende elementen terug:
* Naam van de uitgevoerde procedure ('Action')
* Resultaat van de uitgevoerde procedure ('Status')
* Een tekstuele vertaling van het resultaat dan wel de foutmelding ('Message')
* Tijdens de ontwikkelfase kan er debug-info teruggeleverd worden ('ExtraInfo')
Daarnaast geven specifieke aanroepen extra resultaten terug

== Technische omschrijving ==
XML-RPC beschrijving van acties in hcc.nl LDAP database

<pre>
2021.10.10 HaVe
XML-RPC Hobbynet versie 67.
</pre>

=== Kort overzicht ===

Dit is een lijst met alle XML-RPC aanroepen. In het volgende hoofdstuk worden ze in detail besproken.
<pre>
echo (partners)
ExpandeerPostcode (Joomla module Bas, tbv verhuizingen)
GebruikerBestaatControle (Joomla sites)
GeefAantalDomeinen (Joomla module Bas)
GeefAlleBulletins (Joomla module Bas)
GeefAlleGroeperingen (kadersite, forum, secr. portal, kantoor portal, hobbynet portal)
GeefAlleKaderRollen (forum, secr. portal, kantoor portal, hobbynet portal, Joomla module Bas)
GeefBezoekersOverzicht (bezoekersregistratie)
GeefBezoekersAantallen (bezoekersregistratie)
GeefFactuurOverzicht (Joomla module Bas)
GeefhccEindDatum (HenZ)
GeefKadermailGegevens (kantoor portal)
GeefLocatieNamen (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefLocaties (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefMijnGegevens (Joomla inlog module Bas)
GeefMijnLidnummer (beheer.hcc.nl secretaris portal)
GeefOnderwerpen (Joomla template sites)
GeefSSOUrls (Joomla module Bas)
GeefUitgeschrevenLeden (Joomla sites, HenZ)
HaalAanmeldingsformulier (Joomla module Bas)
HaalFactuur (Joomla module Bas)
HaalIGBedragenOp (Joomla module Bas)
HaalOptInKeuzen (kantoor portal)
HaalTariefGroepenOp (kantoor portal)
HCCpartner (Partner aanroep)
HCCpartners (Partner aanroep)
IsDezeNaamNogBeschikbaar (aangeroepen vanuit de CRM omgeving)
IsDezePseudoniemNogBeschikbaar (kantoor portal)
IsHCCLid (vraagbaak aanroep)
IsKaderLid (in veel apps gebruikt)
LidBezoektBijeenkomst (bezoekersregistratie)
MaakGebruikerAan (mijnhcc.nl, maak hccnet account aan en ldap gebruikersnaam)
MaakOnderwerp (Joomla template sites)
MaakPWResetToken (Joomla module Bas)
MaakTestLogin (Joomla module Bas)
MuteerAanmeldingsformulier (Joomla module Bas)
MuteerGroeperingSamenstelling (Joomla kadernet module Bas)
MuteerOnderwerp (Joomla template sites)
MuteerOnderwerpAutorisatie (Joomla template sites)
NormaliseerTelefoon (Joomla module Bas)
PasHccLoginAan (Joomla module Bas)(enkel Hobbynet)
PasInteressegroepAan (Joomla module Bas)
PasKaderGegevensAan (kadersite, Joomla module Bas)
PasOptInKeuzeAan (Joomla module Bas)
PasPseudoniemAan (Joomla module Bas)
PasUserWachtwoordAan (beheer.hcc.nl Hobbynet gebruikers portal)
PasWachtwoordAan (Joomla module Bas)
RegistreerGast (bezoekersregistratie)
ResetHCCCode (Joomla module Bas)
RuimJoomlaTokenOp (Joomla module Bas)
SchrijfNietlidInOpBulletin (Joomla site bulletin module Bas)
SchrijfNieuwLidIn (Joomla CRM module Bas)
ToonOnderwerpAutorisatie (Joomla template sites)
UpdateContactEmail (Joomla module Bas)
UpdateContactGegevens (Joomla module Bas)
UpdateMobiel (Joomla module Bas)
UpdateNAW (Joomla module Bas)
UpdateOTP (Joomla module Bas)
UpdateTelefoon (Joomla module Bas)
UpdateVoorletters (Joomla module Bas)
UpdateVoornaam (Joomla module Bas)
Upload_CSV_bestand (CRM webproxy)
ValideerPWResetToken (Joomla module Bas)
ValideerWachtwoordEisen (Joomla module Bas)
Verwerk_JSON_mutatie (CRM webproxy)
VerwijderNietLid (Joomla beheer module Bas)
VerwijderOnderwerp (Joomla template sites)
VraagLidgegevensTokenAan (bezoekersregistratie)
WijzigGebruikersGegevens (kantoor en Joomla template sites, ww aanpassen van gebruiker)
ZoekGroeperingsLid (secr. portal, kantoor portal, hobbynet portal)
ZoekHCCLid (VZ portal)
ZoekKaderLeden (Joomla kadernet module Bas)
</pre>

=== HCC-ldap en/of HCC-net aanroepen ===

<pre>
// ** Joomla sites, www.hcc.nl **
// 1.1 controleer of een gebruiker bestaat - optie 1
// (authenticatie op basis van hccLidnr en hccCode)
// Alleen bedoeld om gebruikers op www.hcc.nl op basis van het lidnr het ww te laten wijzigen
$request = xmlrpc_encode_request(
'GebruikerBestaatControle',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $method,
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd');
if ($hccLidnr != '') { $reply['hccLidnr'] = $hccLidnr; }
if ($hccLogin != '') { $reply['hccLogin'] = $hccLogin; }
if ($hccPseudoniem != '') { $reply['hccPseudoniem'] = $hccPseudoniem; }
if ($cn != '') { $reply['cn'] = $cn; }
if ($sn != '') { $reply['sn'] = $sn; }
if ($mail != '') { $reply['mail'] = $mail; }
if ($mailHccnet != '') { $reply['mailHccnet'] = $mailHccnet; }
if ($hccRegio != '') { $reply['hccRegio'] = $hccRegio; }
if ($hccIG != '') { $reply['hccIG'] = $hccIG; }
if ($hccRol != '') { $reply['hccRol'] = $hccRol; }
if ($ProfielBekend != '') { $reply['ProfielBekend'] = $ProfielBekend; }

// ** Portal mijn.hcc.nl **
// 2.1 wijzig wachtwoord - optie 1
// op basis van hccLidnummer en hccCode
// Essentiele aanroep, gebruikt vanuit mijnhcc.nl (lidnr + hccCode)
// Ook gebruikt t.b.v. wachtwoord-vergeten procedure op de Joomla template sites
// Als de profielpagina nog niet is doorlopen wordt deze aanroep afgekeurd.
//
// Ook gebruikt om gebruiker rechtstreeks vanaf Joomla template sites wachtwoord te
// laten aanpassen (op basis van lidnummer en hcc code)
//
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'WijzigGebruikersGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gewijzigd',
'hccLogin' => $hccLogin,
'cn' => $cn,
'sn' => $sn);

// 2.3 wijzig wachtwoord - optie 3
// (t.b.v. VZ-portal)
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
// * Als hccLidnr gevuld is, dan wordt hccLidnr gebruikt om het juiste record te zoeken
// Als hccLidnr leeg is, dan wordt hccLogin gebruikt om het juiste record te zoeken
// 1 van beide velden MOET aanwezig zijn
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'beheerLogin' => $beheerLogin, // beheerder lidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

// ** t.b.v. ophalen van de opt-in keuzes op de beheer pagina **
// 2.6 Geef de complete lijst met opt-ins van dit lid
// (LET OP: authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'HaalOptInKeuzen',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalOptInKeuzen',
'Status' => 'TRUE',
'Message' => 'OptInLijst opgehaald',
'hccOptIn' => $hccOptIn);
Output negatief:
$reply = array(
'Action' => 'HaalOptInKeuzen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gebruikersnaam, pseudoniem
// en wachtwoord tevens in LDAP op
// (authenticatie op basis van hcc lidnummer en hcc-code)
// ** Deze gegevens worden doorgezet naar hccnet.nl (action=4) **
//
$request = xmlrpc_encode_request(
'MaakGebruikerAan',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_hccLogin' => $nieuw_hccLogin,
'nieuw_userPassword' => $nieuw_userPassword,
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'TRUE',
'Message' => 'Gebruiker aangemaakt',
'mail' => $mail,
'hccPseudoniem' => $hccPseudoniem);
Output negatief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gebruikersnaam bestaat al' |
'Pseudoniem bestaat al' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!');

// H.3 Haal al mijn gegevens
// (wordt gebruikt door de Joomla inlogmodule)
// Voor gebruik over de proxy t.b.v. de Android app kan compact=TRUE meegegeven worden.
// In dat geval worden enkel de meest essentiele gegevens teruggestuurd
// Voor gebruik na MaakGebruikerAan kan deze functie ook op basis van hccLidnr en JoomlaToken
// worden aangeroepen
// De optionele parameter 'PrevSiteID' is bedoeld voor single-sign-on. Op basis van JoomlaToken,
// hccLidnr en PrevSiteID worden dan de credentials gevalideerd. Als die kloppen, geeft deze aanroep
// een 2e JoomlaToken terug, maar dan uitgegeven op basis van SiteID.
// Als PrevSiteID leeg is, dan wordt het token op basis van siteID gevalideerd.
$request = xmlrpc_encode_request(
'GeefMijnGegevens',
array(
['hccLogin' => $hccLogin,
'userPassword' => $userPassword,]
['hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,]
['PrevSiteID' => $PrevSiteID,]
['compact' => $compact,] // leeg of 'TRUE'
['hccGroepering'=> $hccGroepering,] // Een testgebruiker mag alleen op deze site inloggen
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd',
'hccLidnr' => $hccLidnr,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccAutorisatie' => $hccAutorisatie,
'cn' => $cn,
'sn' => $sn,
'JoomlaToken' => $JoomlaToken,
['hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'givenname' => $givenname,
'hccAanhef' => $hccAanhef,
'hccGeslacht' => $hccGeslacht,
'hccTussenVoegsels' => $hccTussenVoegsels,
'hccAchternaam' => $hccAchternaam,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward,
'hccKaderToonMobiel' => $hccKaderToonMobiel,
'hccOptIn' => $hccOptIn,
'ProfielBekend' => $ProfielBekend,
'hccBeginDatum' => $hccBeginDatum,
'testaccount' => is_testaccount(), // 'TRUE' | 'FALSE'
'hccOtpKey' => $hccOtpKey,
'hccOtep' => $hccOtep,
['kadermail_omvang' => $Formaat, // in Mb
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald;]]);

Output negatief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// ** t.b.v. aanpassen van de opt-in keuzes op een Joomla site **
// H.4 Pas 1 opt-in van een lid aan
// (LET OP: authenticatie op basis van hccLidnr, JoomlaToken en siteID)
// of
// authenticatie op basis van hccLidnr en OptOutToken (voor een directe uitschrijving door een lid)
// Als hccLidnummer gevuld is, dan is dat het lidnummer waar de mutatie op moet worden uitgevoerd.
// Dat kan alleen als de aanvrager HCC#LAD of HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasOptInKeuzeAan',
array(
'hccLidnr' => $hccLidnr,
['JoomlaToken' => $JoomlaToken,]
['OptOutToken' => $OptOutToken,]
['hccLidnummer' => $hccLidnummer,]
'hccOptIn' => $hccOptIn,
'actie' => 'Nieuw' | 'Weg',
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'TRUE',
'Message' => 'OptIn aangepast');
Output negatief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials | Token ongeldig | Token verlopen');

// H.5 Zoek kaderleden NAW (t.b.v. de Joomla kadersite)
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
//
// * Er dient minstens 1 zoekcriterium opgegeven te worden.
// * Als zowel hccRegio als tegelijk ook hccIG opgegeven worden is de uitkomst onvoorspelbaar.
// * Als compact=TRUE worden enkel lidnummer, cn en sn in het antwoord gezet
$request = xmlrpc_encode_request(
'ZoekKaderLeden',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
['hccRegio' => $hccRegio,]
['hccIG' => $hccIG,]
['hccRol' => $hccRol,]
['hccLocatie' => $hccLocatie,]
['achternaam' => $achternaam,]
['compact' => $compact])); // leeg of 'TRUE'

Output positief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'TRUE',
'Message' => 'Kaderleden opgevraagd'
'Kaderleden' => array(
'hccLidNummer' => $hccLidNummer,
'hccRol' => $hccRol,
'hccAanhef' => $hccAanhef,
'givenname' => $givenname,
'cn' => $cn,
'sn' => $sn,
'hccWoonplaats' => $hccWoonplaats,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'hccKaderMail' => $hccKaderMail);

Output negatief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token']);

// H.9 PasKaderGegevensAan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
// Om de kaderleden hun forward in te laten stellen,
// en tegelijkertijd de opt-in / opt-out voor hccToonMobiel te laten regelen
// Kan tevens het kader email wachtwoord aanpassen
$request = xmlrpc_encode_request(
'PasKaderGegevensAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'hccKaderForward' => $hccKaderForward, // '' | $mail | $mailHccNet
'hccKaderToonMobiel' => $hccKaderToonMobiel, // 'TRUE' | 'FALSE' | 'NULL'
['nieuw_kaderPassword' => $nieuw_kaderPassword]));

Output positief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'TRUE',
'Message' => 'kadergegevens aangepast');

Output negatief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token'|'Alleen kaderleden mogen deze aanroep uitvoeren']);

// ** Portal beheer.hcc.nl
// ** H.10 PasUserWachtwoordAan
// ** Betalende Hobbynet gebruikers kunnen hiermee hun wachtwoord aanpassen
// (authenticatie op basis van hccLogin en userpassword)
$request = xmlrpc_encode_request(
'PasUserWachtwoordAan',
array(
'hccLogin' => $username,
'userpassword' => $password,
'hobbynetAccount' => $hobbyname,
'nieuw_wachtwoord' => $nieuw_wachtwoord,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!' |
'account $hobbynetAccount behoort niet bij gebruiker $hccLogin' |
'Kan ww van account $hobbynetAccount niet aanpassen');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.11 Pas het pseudoniem van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasPseudoniemAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccPseudoniem' => $hccPseudoniem,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'TRUE',
'Message' => 'Pseudoniem aangepast');
Output negatief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials' | 'Pseudoniem bestaat al');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.12 Controleer of een opgegeven wachtwoord aan de minimum eisen voldoet
$request = xmlrpc_encode_request(
'ValideerWachtwoordEisen',
array(
'userPassword' => $userPassword,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'TRUE',
'Message' => 'Wachtwoord voldoet aan de minimale eisen');
Output negatief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'FALSE',
'Message' => 'Wachtwoord voldoet niet aan de minimale eisen');

// ** H.13 PasWachtwoordAan
// ** Vanuit een Joomla template site kunnen gebruikers hiermee hun eigen wachtwoord aanpassen
// (authenticatie op basis van JoomlaToken, lidnummer, siteID. Extra controle via userpassword)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'userpassword' => $password,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.13.1 PasWachtwoordAan
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee hun eigen wachtwoord resetten
// (authenticatie op basis van PWResetToken en hccLogin).
// (Als de aanroep geslaagd is, dan is daarna het PWResetToken ongeldig)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.14 MaakPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee een wachtwoord reset aanvragen
// Deze aanroep geeft naast het PWResetToken ook het contact emailadres mee terug,
// zodat Joomla een reset-mail kan sturen
// (acties op basis van gebruikersnaam)
$request = xmlrpc_encode_request(
'MaakPWResetToken',
array(
'hccLogin' => $username,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'TRUE',
'PWResetToken' => $PWResetToken,
'mail' => $mail,
'Message' => 'Password reset token aangemaakt');
Output negatief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');

// ** H.15 ValideerPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers een wachtwoord reset aanvragen
// Controleer dat het hier om een bestaand (en nog niet gebruikt) token gaat
$request = xmlrpc_encode_request(
'ValideerPWResetToken',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'TRUE',
'Message' => 'Password reset token gevonden');
Output negatief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'FALSE',
'Message' => 'hccLogin bestaat niet' | 'PWResetToken bestaat niet');

// H.16 Ruim een bestaand JoomlaToken op
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'RuimJoomlaTokenOp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'SiteID' => $siteID,
['ServerID' => gethostname(),]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'TRUE',
'Message' => 'JoomlaToken opgeruimd');
Output negatief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'FALSE',
'Message' => 'Onjuist JoomlaToken');

// ** Joomla module
// ** H.17 GeefAantalDomeinen
// ** Vraag het aantal domeinen op van een betalende Hobbynet gebruiker (t.b.v. IDEAL betaling)
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'GeefAantalDomeinen',
array(
'JoomlaToken' => $JoomlaToken,
'hccLidnr' => $hccLidnr,
'hobbynetAccount' => $hobbyname,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'TRUE',
'hobbynetAccount' => $hobbyname,
'AantalDomeinen' => $aantalDomeinen,
'Message' => 'aantal domeinen opgevraagd');
Output negatief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'account $hobbynetAccount behoort niet bij deze gebruiker');

// ** Joomla module
// ** H.18 ResetHCCCode
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'beheerLogin' => $beheerLogin, // geheime credentials van de site
'beheerPassword' => $beheerPassword, // geheime credentials van de site
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** Joomla module
// ** H.18.1 ResetHCCCode (hcc kantoor aanroep)
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'JoomlaToken' => $JoomlaToken, // Het Joomla token van de sessie van de kantoor medewerker
'hccLidnr' => $hccLidnr, // Het lidnummer van de kantoor medewerker
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** t.b.v. aanpassen van de hccLogin van een gebruiker (Hobbynet functie op Joomla site) **
// H.19 Pas de hccLogin van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// hccLidnummer is het lidnummer waar de mutatie op moet worden uitgevoerd
// Kan alleen als de aanvrager HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasHccLoginAan',
array(
'hccLidnr' => $hccLidnr, // lidnummer van de aanvrager
'JoomlaToken' => $JoomlaToken, // JoomlaToken van de aanvrager
'hccLidnummer' => $hccLidnummer, // pas de hccLogin van dit lidnummer aan
'hccLogin' => $hccLogin, // dit is de gewenste nieuwe hccLogin
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'TRUE',
'Message' => 'hccLogin aangepast');
Output negatief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' |
'Onjuiste credentials' |
'Gebruikersnaam al in gebruik');

// ** t.b.v. het aanmaken van een testaccount door een webmaster
// H.20 Maak een testaccount aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// Kan alleen als de aanvrager WM als rol heeft
$request = xmlrpc_encode_request(
'MaakTestLogin',
array(
'JoomlaToken' => $JoomlaToken, // JoomlaToken van de aanvrager
'hccLidnummer' => $hccLidnummer, // lidnummer van de aanvrager
'hccRol' => $hccRol, // (mag leeg zijn)
'hccGroepering' => $hccGroepering, // (regio of IG)
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
reply = array(
'Action' => 'MaakTestLogin',
'Status' => 'TRUE',
'Message' => 'Tijdelijk test account aangemaakt',
'TestAccountNaam' => 'test-<groepering>-<hccLogin>'
'userpassword' => $nieuw_userpassword,
'hccGroepering' => $hccGroepering,
'hccRol' => $hccRol);
Output negatief:
$reply = array(
'Action' => 'MaakTestLogin',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Gegevenscombinatie onjuist');

// Joomla webbeheerder functie
// ** t.b.v. aanpassen van de OneTime Passwords van de webbeheerder
// H.21 Pas de OTP gegevens van een lid aan
// (LET OP: authenticatie op basis van hccLidnr, JoomlaToken en siteID)
// Als hccLidnummer gevuld is, dan is dat het lidnummer waar de mutatie op moet worden uitgevoerd.
// Dat kan alleen als de aanvrager HCC#LAD of HN#WM als rol heeft
// Als hccOtep en/of hccOtpKey leeg is, dan worden zowel hccOtep als ook hccOtpKey gewist
$request = xmlrpc_encode_request(
'UpdateOTP',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
['hccLidnummer' => $hccLidnummer,]
'hccOtpKey' => $hccOtpKey, // De otp encryptie key van de gebruiker (mag leeg zijn )
'hccOtep => $hccOtep, // Het one time recovery password (mag leeg zijn )
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateOTP',
'Status' => 'TRUE',
'Message' => 'OTP gegevens aangepast');
Output negatief:
$reply = array(
'Action' => 'UpdateOTP',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// 3.1 Geef mijn lidnummer
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'GeefMijnLidnummer',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'TRUE',
'Message' => 'Lidnummer opgevraagd',
'hccLidnr' => $hccLidnr);
Output negatief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.2 Controleer of de gebruikersnaam op dit moment bestaat
// (geen authenticatie)
// ** Deze gegevens worden opgevraagd bij hccnet.nl (action=3) **
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezeNaamNogBeschikbaar',
array(
'nieuw_hccLogin' => $nieuw_hccLogin,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Gebruikersnaam is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Gebruikersnaam bestaat al');

// ** Enkel voor gebruik vanaf de kantoor portal **
// ** t.b.v. het hernoemen van accounts in CRM **
// 8.3 Controleer of een Pseudoniem op dit moment bestaat ??? NIET GEBRUIKT ??
// (geen authenticatie)
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezePseudoniemNogBeschikbaar',
array(
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem));
Output positief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Pseudoniem is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Pseudoniem bestaat al');

// ** t.b.v. de verenigingszaken zoekpagina **
// A.1 Zoek alle bij de query passende hcc leden
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
$request = xmlrpc_encode_request(
'ZoekHCCLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Groepering' => $Groepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (eerste deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| emailadres | (eerste deel van) e-mail adres |
| gebruikersnaam | (eerste deel van) de login naam |
| pseudoniem | (eerste deel van) het pseudoniem |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| niet_leden | het volledige niet-lid lidnummer |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'ZoekMethode' => $ZoekMethode,
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' => array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'sn' => $sn,
'givenName' => $givenName,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccHuisToevoeging' => $hcchuisToevoeging,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'ProfielBekend' => 'TRUE' | 'FALSE'])*);
Output negatief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. beheer.hcc.nl **
// A.3 Zoek alle bij de query passende hcc leden van deze groepering
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'ZoekGroeperingsLid',
array(
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Groepering' => $groepering,
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Bijeenkomst' => $Bijeenkomst,] // Alleen voor gebruik op de
// bijeenkomsten aanwezigheidsregistratie pagina
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| nieuwe_leden | YYYYMMDD vanaf waar gezocht moet worden |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| kaderleden | n.v.t. |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' =>
[array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'cn' => $cn,
'sn' => $sn,
'givenName' => $givenName,
'hccAchternaam' => $hccAchternaam,
'hccTussenVoegsels => hccTussenVoegsels,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem)]*));
Output negatief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker(s) niet gevonden' | 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten **
// A.4 Lid bezoekt bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'LidBezoektBijeenkomst',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
'hccLidnr' => $hccLidnr, // lid dat aanwezig gemeld moet worden
['correctie' => $hccLidnr,] // lid dat gecorrigeerd moet worden
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'TRUE',
'Message' => 'Bezoeker weggeschreven',
'Results' => array(
// info van deze bezoeker
'cn' => $cn, // cn (Verbeek, H.J.)
'hccGeslacht' => $hccGeslacht, // hccGeslacht van de bezoeker
'groeperingslid' => $groeperingslid, // TRUE of FALSE: is deze persoon lid van deze groepering
'mijnGroeperingen' => $mijnGroeperingen, // komma-gescheiden lijst (regio, [hccIG]*)
'aantalBezoeken' => $aantalBezoeken, // hoe vaak heeft dit lid deze bijeenkomst bezocht
// info van de bijeenkomst
'AantalBezoekers' => $AantalBezoekers); // aantal bezoekers van deze bijeenkomst
Output negatief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.5 Vraag Lidgegevens token aan (geldig voor dit lid, en deze groepering, op deze datum)
// Als geen datum gegeven is, dan is het token vandaag geldig
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'VraagLidgegevensTokenAan',
array(
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'hccLidnr' => $hccLidnummer, // vraag het token voor dit lid aan
'groepering' => $groepering, // zoek binnen deze groepering
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'TRUE',
'Message' => 'Token opgevraagd',
'groepering' => $Groepering,
'token' => $token,
'sn' => $sn);
Output negatief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.6 Toon bezoekersoverzicht
// (authenticatie op basis van lidnummer en bezoekersregistratie token)
$request = xmlrpc_encode_request(
'GeefBezoekersOverzicht',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'token' => $token,
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'TRUE',
'Message' => 'Bezoekersoverzicht opgevraagd',
'Bezoekers' => $bezoekers,
['Locatie' => $Locatie]);
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// A.7 Geef het array met alle locaties
// (of beperk dit tot de locaties van de groepering $Groepering)
// Desgewenst worden alle resultaten waarbij hccToonInJoomla aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// Desgewenst worden alle resultaten waarbij ToonOpKaderNet aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocaties',
array(
['Groepering' => $hccGroepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']);
Output positief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);
Output negatief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'FALSE',
'Message' => 'Locaties niet beschikbaar',
'ExtraInfo' => 'Geen locaties gevonden voor groepering $hccGroepering',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);

// A.8 Registreer een niet-hcclid als bezoeker tijdens een bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'RegistreerGast',
array(
'AccountNaam' => $lidnr, // credentials
'AccountCode' => $AccountCode, // credentials
'token' => $token, // credentials
'Bijeenkomst' => $groepering,
'geslacht' => $geslacht,
'naam' => $naam,
'mail' => $mail,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'buitenland' => $buitenland,
['nietLidNummer' => $nietLidNummer,]
['instructies' => $instructies,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $aanroep,
'Status' => 'TRUE',
'Message' => 'Niet-lid als bezoeker geregistreerd',
'Result' => $result_array);

// A.9 Geef het array met alle locatienamen
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocatieNamen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']));
['KaderMutatieFilter' => '' | 'TRUE']));

Output positief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));
Output negatief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'FALSE',
'Message' => 'Locatienamen niet beschikbaar',
'ExtraInfo' => 'Geen locatienamen gevonden',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));

// A.10 Schrijf een niet-lid in op een bulletin
// (2019.12.05: wordt actief gebruikt in Joomla module)
// Deze aanroep mag *ook* worden gebruikt om een wel-lid in te schrijven.
// Voorwaarde is dat bewezen is dat er controle bestaat over het opgegeven email adres
$request = xmlrpc_encode_request(
'SchrijfNietlidInOpBulletin',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'hccOptin' => $hccOptin, // bulletin waarop ingeschreven wordt
'hccOptinSource' => $hccOptinSource, // site waar aanmelding vandaan komt
'Email' => $Email, // niet-lid: email adres
'Naam' => $Naam, // niet-lid: naam
['hccLidNummer' => $hccLidNummer,] // optioneel: ik ben lid, dit is mijn lidnummer
['Postcode' => $Postcode,] // optioneel: niet-lid: postcode
['Huisnummer' => $Huisnummer,] // optioneel: niet-lid: huisnummer
['hccGeslacht' => $hccGeslacht,] // optioneel: niet-lid: geslacht (M/V/O)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'TRUE',
'Message' => 'Inschrijving op bulletin gelukt');
Output negatief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist',
'ExtraInfo' => 'Invalid DN syntax' |
'Invalid credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.11 Toon bezoekers aantallen
// (authenticatie op basis van AccountNaam en AccountCode of token)
//
// ==> Mag weg: laatste aanroep 2018.12.15 <==
//
$request = xmlrpc_encode_request(
'GeefBezoekersAantallen',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'token' => $token,
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersAantallen',
'Status' => 'TRUE',
'Message' => 'BezoekersAantallen opgevraagd',
'Datum' => $datum,
'Bijeenkomst' => $Bijeenkomst,
'Bezoekers' => array(
[HCC!seniorenacademie] => Array(
[Gorinchem] => 15
[Woerden] => 36)
...));
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersAantallen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// ** t.b.v. Joomla module Bas
// A.12 GeefAlleBulletins
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleBulletins',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefAlleBulletins',
'Status' => 'TRUE',
'Message' => 'Bulletins opgevraagd',
'bulletins' => $bulletins);

// ** t.b.v. Joomla module Bas
// A.13 ExpandeerPostcode
// (geen authenticatie)
$request = xmlrpc_encode_request(
'ExpandeerPostcode',
array(
'postcode' => $postcode,
'huisnummer' => $huisnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'ExpandeerPostcode',
'Status' => 'TRUE',
'Message' => 'Postcode opgevraagd',
'detailgegevens' => $detailgegevens);

// ** t.b.v. Joomla module Bas
// A.25 UpdateNAW
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateNAW',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'geslacht' => $geslacht,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'toevoeging' => $toevoeging,
'straat' => $straat,
'woonplaats' => $woonplaats,
'landcode' => $landcode,
'email' => $email,
'voornaam' => $voornaam,
'voorletters' => $voorletters,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateContactGegevens',
'Status' => 'TRUE',
'Message' => 'Contactgegevens bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.18 NormaliseerTelefoon
// (geen authenticatie)
$request = xmlrpc_encode_request(
'NormaliseerTelefoon',
array(
'hccLand' => $hccLand,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'NormaliseerTelefoon',
'Status' => 'TRUE',
'Message' => 'Telefoonnummer genormaliseerd',
'Telefoonnummer' => $Telefoonnummer);

// ** t.b.v. Joomla module Bas
// A.20 UpdateMobiel
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateMobiel',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateMobiel',
'Status' => 'TRUE',
'Message' => 'Mobiel nummer bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.21 HaalIGBedragenOp
// Geef alle IG's waar je zelf lid van kunt worden, inclusief het bijbehorende bedrag
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalIGBedragenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalIGBedragenOp',
'Status' => 'TRUE',
'Message' => 'Interessegroepen en bedragen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.22 HaalTariefGroepenOp
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalTariefGroepenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalTariefGroepenOp',
'Status' => 'TRUE',
'Message' => 'Tariefgroepen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.23 PasInteressegroepAan
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasInteressegroepAan',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
['nieuw' => $IG_lijst_nieuw,]
['weg' => $IG_lijst_weg,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'PasInteressegroepAan',
'Status' => 'TRUE',
'Message' => 'IG keuzen aangepast');

// ** t.b.v. Joomla module Bas
// A.24 GeefSSOUrls
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefSSOUrls',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefSSOUrls',
'Status' => 'TRUE',
'SSO_urls' => $sso_urls,
'Message' => 'Single Sign On URLs opgevraagd');

// ** t.b.v. de verenigingszaken beheer pagina **
// A.26 Verwijder een niet-lid record
$request = xmlrpc_encode_request(
'VerwijderNietLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'hccLidnr' => $hccLidnummer, // het te verwijderen niet-lid nummer
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

Output positief:
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'TRUE',
'Message' => 'Niet-lid record verwijderd',

Output negatief:
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'FALSE',
'Message' => 'Niet-lid record niet gevonden');
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** HenZ **
// ** t.b.v. daily cron job **
// ** t.b.v. dagelijkse opschoon jobs Joomla template sites **
// C.1 Vraag de lijst met uitgeschreven leden op
// Dit kan beperkt worden tot een bepaalde regio of interessegroep
// Daarnaast kan het tijdvak waarin gezocht wordt vrij gekozen worden
// (gesteld dat de LDAP database nog leden uit die periode bevat)
// Antwoord: lijst met (lidnummer, hccLogin, sn,
// datum einde lidmaatschap (formaat:YYYYMMDD))

==> GeefUitgeschrevenLeden <== (oud: GeefOpgezegdeLeden)

$request = xmlrpc_encode_request(
'GeefUitgeschrevenLeden',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccRegio' => $hccRegio, // of leeg
'hccIg' => $hccIg, // of leeg
'datum_vanaf' => $datum_sinds, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: 3 dagen geleden)
'datum_tot' => $datum_tot, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: vandaag)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'TRUE',
'Message' => 'Uitgeschreven leden',
['hccRegio' => $hccRegio,]
['hccIg' => $hccIg,]
['datum_vanaf' => $datum_vanaf,]
['datum_tot' => $datum_tot,]
['Results' => array(
[array(
'hccLogin' => $hccLogin,
'hccLidNummer' => $hccLidnummer,
'sn' => $sn,
'DatumEindeLidmaatschap' => $DatumEindeLidmaatschap)]*);
Output negatief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');
</pre>

=== HCCpartner aanroepen ===
(interface versie 1) 
(oude interface, niet meer gebruiken!)

<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.1 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartner',
array('ControleerHCCLidmaatschap',
array('partnerLogin', $partnerLogin),
array('partnerPassword', $partnerPassword),
array('hccLidnummer', $hcclidnummer),
array('postcode', $postcode)));
Output positief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'TRUE'));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'));
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'),
array('Message', 'Onjuiste credentials'));

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartner',
array(
'OnbekendeAanroep',
array('parameter', $iets)));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'OnbekendeAanroep'),
array('Status', 'FALSE'),
array('Message', 'Opdracht onbekend'));
</pre>

=== HCCpartners aanroepen ===
(interface versie 2)

<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.2 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'ControleerHCCLidmaatschap',
'partnerLogin' => $partnerLogin,
'partnerPassword' => $partnerPassword,
'hccLidnummer' => $hcclidnummer,
'postcode' => $postcode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'TRUE',
['ExtraInfo' => 'groepering=$groepering']); // als de partner beperkt is tot 1 groepering
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE');
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'OnbekendeAanroep',
'parameter' => $iets));
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'OnbekendeAanroep',
'Status' => 'FALSE',
'Message' => 'Opdracht onbekend');
</pre>

=== HCC-kader aanroepen ===

<pre>
// ** beheer.hcc.nl **
// F.2 Controleer of dit een kaderlid is
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'IsKaderLid',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'TRUE',
'Message' => 'Is kaderlid',
'hccLidnr' => $hccLidnr,
'cn' => $cn,
'sn' => $sn,
'hccRol' => $hccRol,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward);
Output negatief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Is geen kaderlid');

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.4 Vraag alle groeperingen op
// Het is mogelijk om een groepering te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// ToonInOverzichtenFilter : attribuut 'hccToonInOverzichten'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// BulletinsFilter : attribuut 'hccBulletins'
// EmailFilter : attribuut 'hccFunctionalEmail'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleGroeperingen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['ToonInOverzichtenFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['BulletinsFilter' => '' | 'TRUE',]
['EmailFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE'));
Output positief:
$reply = array(
'Action' => 'GeefAlleGroeperingen',
'Status' => 'TRUE',
'Message' => 'Lijst met groeperingen opgevraagd',
'Result' => $groeperingen,
['JoomlaFilter' => 'TRUE',]
['ToonInOverzichtenFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']);

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.5 Vraag alle kaderrollen op
// Het is mogelijk om een kaderrol te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleKaderRollen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']));
Output positief:
$reply = array(
'Action' => 'GeefAlleKaderRollen',
'Status' => 'TRUE',
'Message' => 'Lijst met kaderrollen opgevraagd',
'Result' => $kaderrollen,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']);

// ** t.b.v. de kantoor-beheerpagina **
// F.9 Geef de gevevens van de mailbox van dit kaderlid
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
$request = xmlrpc_encode_request(
'GeefKadermailGegevens',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer));
Output positief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'kadermail_omvang' => $Formaat,
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald);
Output negatief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid'));

// ** t.b.v. de Joomla Kadernet module **
// * F.10 MuteerGroeperingSamenstelling
// (authenticatie op basis van lidnummer, JoomlaToken en siteID en als extra hccCode van de aanvrager)
$request = xmlrpc_encode_request(
'MuteerGroeperingSamenstelling',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccCode' => $hccCode,
'groepering' => $groepering,
'hccLidnummer => $hccLidnummer, // lidnummer van het te muteren hcc lid
'hccRol' => $hccRol, // de nieuwe dan wel op te heffen rol
// de rol 'ALLES_WEG' ruimt alle rollen van dit hcc lid voor deze groepering op
'actie' => 'Nieuw' | 'Weg',
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress,]
Output positief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'TRUE',
'Message' => 'Groepering samenstelling aangepast',
['ExtraInfo' => 'Bedankmail gestuuurd aan ex-kaderlid']);
Output negatief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid' |
'Oude rol niet gevonden' |
'Nieuwe rol kan niet samen met bestaande rol' |
'Alleen voorzitter of secretaris kan kadermutaties uitvoeren']);
</pre>

=== HCC-groepering aanroepen ===

<pre>
// I.2 controleer of een gebruiker bestaat op basis van de combinatie
// lidnummer + postcode + huisnummer
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
// (alternatieve authenticatie mogelijk door lidnummer + hcc-code in te vullen)
//
// Aan de aanroeper worden zekere eisen gesteld:
// * dient een rol te vervullen binnen de groepering 'FOR'(forum)
// * dan wel dient de rol 'VRBK' (vraagbaak) te vervullen binnen een groepering
//
// Er wordt door de gehele leden-database gezocht, waarna terug wordt gegeven
// * of dit hcc lid inderdaad bestaat
// en, als het om een aanvraag van een vraagbaak vrijwilliger gaat,
// * tevens of het gezochte hcc lid deel uitmaakt van zijn groepering
//
// ==> Mag weg: laatste aanroep 2018.07.27 <==
//
$request = xmlrpc_encode_request(
'IsHCCLid',
array(
'hccLogin' => [$hccLogin | $hccLidnummer],
'userPassword' => [$userPassword | $hccCode],
'zoekhccLidnr' => $zoekhccLidnr,
'zoekhccPostcode' => $zoekhccPostcode,
'zoekhccHuisnr' => $zoekhccHuisnr,
'zoekgroepering' => $zoekgroepering));
Output positief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gecontroleerd',
['Groeperingslid' => $IsGroeperingLid]));
Output negatief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker bestaat niet' |
'Onjuiste credentials' |
'Wel HCC lid, maar geen lid van groepering $groepering' |
'Onvoldoende rechten' |
'Vul alle verplichte velden in!'));
</pre>

=== HenZ aanroepen ===

<pre>
// I.3 Geef de einddatum van een actief dan wel uitgeschreven lid
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'GeefhccEindDatum',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'TRUE',
'hccLidnummer' => $hccLidnummer,
'hccLogin' => $hccLogin,
'hccEindDatum' => $hccEindDatum ('yyyymmdd' | ''));
Output negatief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Invalid credentials' |
'Lidnummer niet gevonden');
</pre>

=== (Forum,vraagbaak) onderwerpen ===

<pre>
// L.1 MaakOnderwerp
$request = xmlrpc_encode_request(
'MaakOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'description' => $description,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp is aangemaakt',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster');

// L.2 VerwijderOnderwerp

$request = xmlrpc_encode_request(
'VerwijderOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'TRUE',
'onderwerp' => $onderwerpID,
'Message' => 'Onderwerp is verwijderd',
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Ruim eerst alle geautoriseerde gebruikers op' |
'Kan onderwerp niet verwijderen');

// L.3 GeefOnderwerpen
// Geef het array met de lijst van onderwerpen voor de betreffende groepering
//
$request = xmlrpc_encode_request(
'GeefOnderwerpen',
array(
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'TRUE',
'Message' => 'Onderwerpen opgevraagd',
'onderwerpen' => $onderwerpen); // het array met onderwerpen
Output negatief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!');

// L.4 MuteerOnderwerp
// Pas de description van een onderwerp aan
//
$request = xmlrpc_encode_request(
'MuteerOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'description' => $description,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp aangepast',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Onderwerp behoort bij andere groepering');

// L.5 MuteerOnderwerpAutorisatie
// Geef kaderlid $kaderLidNr de autorisatie MOD, VRBK of RED bij onderwerp $onderwerp
// (of haal die autorisatie weg)
$request = xmlrpc_encode_request(
'MuteerOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'onderwerp' => $onderwerpID,
'kaderLidNr' => $kaderLidNr,
'hccAutorisatie' => 'MOD' | 'VRBK' | 'RED',
['verwijder' => 'TRUE']));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Onderwerp autorisatie aangepast');
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Geen kaderlid' |
'Onjuiste autorisatie opgegeven' |
'Onderwerp bestaat niet');

// L.6 ToonOnderwerpAutorisatie
$request = xmlrpc_encode_request(
'ToonOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Autorisaties opgehaald',
'onderwerp' => $onderwerpID,
'description' => $description,
'autorisaties' =>
[Array(
'hccLidnummer' => $hccLidnummer
'cn' => $cn
'hccAutorisatie' => {komma-gescheiden autorisaties})]);
Output negatief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet');
</pre>

=== Microsoft Dynamics Cloud (Cayentis) onderwerpen ===

<pre>
// M.1 Upload_CSV_bestand
// De CRM proxy upload de dagelijkse CSV synchronisatie-bestanden naar de XML-RPC server
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Upload_CSV_bestand',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'CSV_bestand_type' => '1' | '2' | '3' , // 1=Contactpersonen/Hoofdlidmaatschappen
// 2=Gremiumlidmaatschap codes
// 3=Gremiumlidmaatschappen
'CSV_bestand' => $CSV_bestand)); // het CSV bestand (base64 encoded)
Output positief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'TRUE',
'Message' => 'Bestand opgeslagen');
Output negatief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.2 SchrijfNieuwLidIn
//
// Maak in het CRM een nieuw HCC lid aan
// De NAW gegevens worden in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'SchrijfNieuwLidIn',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'NAWgegevens' => $NAW_Array,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress);
// $NAW_array = array(
// 'GeboorteDatum' => $geboortedatum,
// 'Geslacht' => $geslacht,
// 'Voornaam' => $voornaam,
// 'Voorletters' => $voorletters,
// 'Tussenvoegsel' => $tussenvoegsel,
// 'Achternaam' => $achternaam,
// 'Straatnaam' => $straatnaam,
// 'Huisnummer' => $huisnummer,
// 'HuisnummerToevoeging' => $huisnummertoevoeging,
// 'Woonplaats' => $woonplaats,
// 'Postcode' => $postcode,
// 'Land' => $land,
// 'Telefoonnummer' => $telefoonnummer,
// 'MobielNummer' => $mobielnummer,
// 'Mail' => $mail,
// 'IBAN' => $IBAN,
// 'Interessegroep' => $IGs, // komma-gescheiden lijst met IG's
// 'Geschenk' => $geschenk,
// 'Actiecode' => $actiecode,
// 'Voorwaarden' => $Akkoord); // 'Akkoord'
)
Output positief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'TRUE',
'Message' => 'nieuw lid ingeschreven',
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode);
Output negatief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.3 Verwerk_JSON_mutatie
// De CRM proxy kan NAW en/of IG mutaties en/of hccCode mutaties live doorgeven
// Deze gegevens worden in JSON in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Verwerk_JSON_mutatie',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'mutatie_type' => '1' | '2', // 1=Contactpersoon/Hoofdlidmaatschap
// 2=Gremiumlidmaatschap
'JSON_mutatie' => $JSON_mutatie)); // de JSON payload
Output positief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'TRUE',
'Message' => 'Mutatie verwerkt');
Output negatief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.4 Vertaal landcode
// Het CRM werkt met numerieke landcodes, wij met cijfers
// Vertaal die
// Er moet in de aanroep 1 veld aanwezig zijn, beide waarden komen in het antwoord terug
$request = xmlrpc_encode_request(
'ISO_landcode',
array(
['ISO_numeriek' => $ISO_numeriek,]
['ISO_code ' => $ISO_code]));
Output positief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'TRUE',
'Message' => 'ISO code lookup geslaagd',
'ISO_numeriek' => $ISO_numeriek,
'ISO_code ' => $ISO_code,
'ISO_benaming' => $ISO_benaming); // de descriptive name van deze ISO code
Output negatief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'FALSE',
'Message' => 'Kan geen bijpassende vertaling vinden'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.5 MuteerAanmeldingsformulier
// Sla een JSON veld op in de XML-RPC server zodat deze weer opgehaald kan worden door de websites
// Authenticatie op basis van hccLidnummer en JoomlaToken
// Deze mutaties mogen alleen door HN#WM of SITE#WM gedaan worden.

$request = xmlrpc_encode_request(
MuteerAanmeldingsformulier,
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
'formulierdata' => $formulierdata, // JSON veld met alle gegevens voor het aanmeld formulier
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress ));
Output positief:
$reply = array(
'Action' => 'MuteerAanmeldingsformulier',
'Status' => 'TRUE',
'Message' => 'aanmeldingsformulier bijgewerkt';

// M.6 HaalAanmeldingsformulier
// (geen authenticatie)
$request = xmlrpc_encode_request(
HaalAanmeldingsformulier,
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalAanmeldingsformulier',
'Status' => 'TRUE',
'formulierdata' => $formulierdata); // JSON veld met alle gegevens voor het aanmeld formulier

// M.7 GeefFactuurOverzicht
// (authenticatie op basis van hccLidnummer + JoomlaToken + siteID
$request = xmlrpc_encode_request(
GeefFactuurOverzicht,
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefFactuurOverzicht',
'Status' => 'TRUE',
'FactuurOverzicht' => $FactuurOverzicht);
// $FactuurOverzicht =
// array(
// array(
// 'FactuurID' => 'a5b93460-4536-ea11-a813-000d3a2c53fa',
// 'FactuurNummer' => '200118673J5'
// 'FactuurDatum' => '2020-01-15'
// 'bedrag' => 42.37
// 'BetaalStatus' => 0]));
// )

// M.8 HaalFactuur
// (authenticatie op basis van JoomlaToken of FactuurToken)
$request = xmlrpc_encode_request(
HaalFactuur,
array(
'hccLidnummer' => $hccLidnummer,
['JoomlaToken' => $JoomlaToken,]
['FactuurToken' => $FactuurToken,]
'FactuurNummer' => $FactuurNummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalFactuur',
'Status' => 'TRUE',
'factuur' => $factuurgegevens);
// $factuurgegevens =
// array(
// 'FactuurNummer' => $FactuurNummer,
// 'FactuurDatum' => $FactuurDatum,
// 'FactuurID' => $FactuurID,
// 'Bestandsnaam' => $Bestandsnaam,
// 'PDF' => $PDF) // base64 encoded PDF
</pre>

=== Echo test ===

<pre>

// t.b.v. controle of de verbinding met de XML-RPC server functioneert
// Eenvoudige echo test

$request = xmlrpc_encode_request(
'echo',
array(
'What' => $string,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'echo',
'Status' => 'TRUE',
'Message' => $string);
</pre>

=== HenZ XML-RPC interface ===

Overzicht van XML-RPC procedures die bij HenZ draaien
(worden via de Hobbynet XML-RPC server afgehandeld)

<pre>
- Action=2
wijzig gebruikersnaam en wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=3
controleer of een gebruikersnaam bestaat
(XML-RPC server voert de hccnet XML-call uit, zie 8.2)

- Action=4
creer een nieuwe gebruiker. Per lidnummer is er 1 account. Als er al een
account voor dit lidnummer bestaat wordt het bestaande account hernoemd.
(XML-RPC server voert de hccnet XML-call uit, zie 8.1)

- Action=5
wijzig wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=7
Uitgeschreven lid is weer actief lid geworden
(Wordt aangeroepen vanuit de cronjob)

- Action=8
Lid heeft een nieuwe hcc-code gekregen
(Wordt aangeroepen vanuit de cronjob)
</pre>

=== Release notes ===
<pre>
2012.02.08 Wijzigingen versie 5:
- 4.1 verwijder_hcc_Lidnummer i.p.v. hcc_Lidnummer
- 4.1 optionele extra parameter verwijder_hccLogin
- Optionele parameters aangegeven
- Vanwege de duidelijkheid de beheerLogin en beheerPassword velden
bovenin de betreffende aanroepen gezet
(De volgorde van de parameters is niet relevant, dus dit is geen
interface-aanpassing)
2012.02.16 Wijzigingen versie 6:
- 2.1/2.2/2.3 geef ook cn en sn terug na aanpassen van het wachtwoord
- 3.1 geef cn en sn terug na aanmaken nieuwe gebruiker
2012.02.27 Wijzigingen versie 7:
- Neem de XML-RPC interface van HenZ in deze XML-RPC server op
8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gegevens tevens in LDAP op
- 2.1 wijzig wachtwoord - optie 1
* Nieuw wachtwoord is verplicht, niet optioneel
* wijzigingen worden naar hccnet.nl doorgezet
- 2.2 wijzig wachtwoord, optie 2
* Nieuw wachtwoord is verplicht, niet optioneel
* gebruikersnaam kan niet meer via deze interface aangepast worden
* wijzigingen worden naar hccnet.nl doorgezet
- 2.3 wijzig wachtwoord, optie 3
* wijzigingen worden naar hccnet.nl doorgezet
2012.03.26 Wijzigingen versie 8:
- Breidt de XML-RPC interface van HenZ in deze XML-RPC server uit met
8.2 Controleer of de gebruikersnaam op dit moment bestaat
2012.04.09 Wijzigingen versie 9:
- Vervang alle 'ldap' aanroepen door 'HCCldap' aanroepen
- documentatie van HenZ call action=2 aangepast, action=5 toegevoegd
2012.05.03 Wijzigingen versie 10:
- 1.1 / 1.2 / 1.3 geven nu ook 'ProfielBekend' terug om uniek te bepalen
of deze bezoeker een first-time-login pagina te zien dient te krijgen
- documentatie van 2.1 (wijzig wachtwoord) aangepast:
2.1 kan alleen als profiel is doorlopen
- nieuwe procedure t.b.v. zoekscherm PC30
* A.1 ZoekHCCLid
- hiervoor is de database met diverse velden uitgebreid
(postcode, e-mailadres, huisadres, woonplaats, land, telefoonnummer)
Dit heeft impact op diverse andere procedures (t.b.s.)
- nieuwe procedure t.b.v. 'gewone' profielpagina
* B.1 GeefDBFPersoonID
- nieuwe procedure t.b.v. cron-job
* C.1 GeefOpgezegdeLeden
2012.05.10 Wijzigingen versie 11
- 1.3 GebruikerBestaatControle
* nieuwe parameter: hccPseudoniem
* nieuw veld in antwoord: hccPseudoniem
- 2.3 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 2.4 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 3.1 NieuweGebruiker
* nieuwe parameter: hccPseudoniem
- 8.1 MaakGebruikerAan
* nieuwe parameter: nieuw_hccPseudoniem
* alle parameters zijn verplicht (niet langer optioneel)
* nieuw antwoord: Gegevenscombinatie onjuist
- 8.3 IsDezePseudoniemNogBeschikbaar
* Nieuwe procedure t.b.v. 1e keer doorlopen profielpagina
- A.1 ZoekHCCLid
* 'Zoeklimiet bereikt' wordt als ExtraInfo meegegeven
* nieuwe velden in antwoord: hccPseudoniem en hccLogin
- B.1 GeefDBFPersoonID
* Zoeken kan nu ook op hccLogin en op hccPseudoniem
- C.1 GeefOpgezegdeLeden
* Geef nu ook hccLogin en hccPseudoniem terug
2012.05.14 Wijzigingen versie 12
- 1.x GebruikerBestaatControle
* Geef ook DBFPersoonID terug
- 4.1 Gooi een gebruiker weg.
* Haal ongebruikte parameter hccLogin weg
- 5.1 Wijzig hccIG
* Haal ongebruikte parameter hccLogin weg
- 6.1 Wijzig hccRegio
* Haal ongebruikte parameter hccLogin weg
- 7.1 Wijzig hccRol
* Haal ongebruikte parameter hccLogin weg
2012.05.20 Wijzigingen versie 13
- A.1 ZoekHCCLid
* Geef resultaten gestructureerder formaat
* Geef in ExtraInfo weer hoeveel echte resultaten er gevonden zijn
- C.1 GeefOpgezegdeLeden
* Geef resultaten in gestructureerder formaat
2012.06.03 Wijzigingen versie 14
- 3.1 NieuweGebruiker
* Geef ook DBFPersoonID mee
2012.08.17 Wijzigingen versie 15
- C.1 GeefOpgezegdeLeden
* Geef ook hccLogin in het antwoord terug
- D.1 HCCpartner/ControleerHCCLidmaatschap
* Nieuwe aanroep
2012.09.29 Wijzigingen versie 16
- Alle cron gerelateerde opdrachten verwijderd
* 3.1 NieuweGebruiker
* 4.1 GooiGebruikerWeg
* 5.1 WijzigHccIG
* 6.1 WijzigHccRegio
* 7.1 WijzigHccRol
2012.10.28 Wijzigingen versie 17
- nieuwe procedure t.b.v. PC30 beheerpagina
* A.2 HaalPC30Token
- nieuwe procedure t.b.v. Drupal profielpagina
* 2.4 vervallen
(WijzigGebruikersGegevens op basis van pseudoniem)
* 2.5 WijzigGebruikersGegevens
Nieuwe keuze: wijzig pseudoniem
2012.11.14 Wijzigingen versie 18
- 1.x GebruikerBestaatControle
* Geef ook mail in het antwoord terug
2012.11.30 Wijzigingen versie 19
- E.1 HCCkader/WijzigGebruikersGegevens
* Nieuwe aanroep
- F.1 / F.2 / F.3 ControleerKaderlid
* Nieuwe aanroep
2012.12.18 Wijzigingen versie 20
- Haal DBFPersoonID weg uit alle aanroepen en alle resultaten
* Antwoord van 1.x GebruikerBestaatControle
* B.1 GeefDBFPersoonID opgeheven
- A.1 ZoekHCCLid geeft nu ook hccMobiel terug (t.b.v. PC30 zoekpagina)
- C.1 GeefOpgezegdeLeden verder uitgewerkt:
* Geeft alleen de door Drupal gebruikte velden 'hccLogin' en 'hccEindDatum'
terug in het antwoord
* Geeft nu 'echte' antwoorden i.p.v. dummy resultaten
- F.1 ControleerKaderlid geeft nu ook optioneel 'sn' en 'givenName'
terug (in de beheer-variant)
2013.01.25 Wijzigingen versie 21
- A.1 ZoekHCCLid uitgebreid
* Geeft nu ook hccBeginDatum, hccEindDatum en hccRol terug
2013.02.02 Wijzigingen versie 22
- A.1 ZoekHCCLid
* Interface aangepast
- A.3 ZoekGroeperingsLid
* Nieuwe aanroep
- F.4 GeefAlleGroeperingen
* Nieuwe aanroep
- F.5 GeefAlleKaderRollen
* Nieuwe aanroep
2013.03.01 Wijzigingen versie 23
- A.3 ZoekGroeperingsLid
* Geeft andere resultaten terug
- 2.2 WijzigWachtwoord
* Geeft nu ook hccLogin terug (voor ww-vergeten op de Drupal site)
- HCCenquete implementatie
* G.1 Expandeer NL postcode
* G.2 Haal lidgegevens op
* G.3 Pas lidgegevens aan
2013.03.18 Wijzigingen versie 24
- ZoekGroeperingsLid op basis van token
- A.4 Lid bezoekt bijeenkomst
* nieuwe aanroep
- A.5 VraagLidgegevensTokenAan
* nieuwe aanroep
2013.04.07 Wijzigingen versie 25
- D.1 HCCpartner/ControleerHCCLidmaatschap
Simpeler interface ontwikkeld ('HCCpartners' i.p.v. 'HCCpartner')
- G.3 mag ook Tussenvoegsels aanpassen
2013.04.25 Wijzigingen versie 26
- H.1 HCC-groepering / GebruikerBestaatControle
Nieuwe interface voor validatie vanaf groeperings websites
2013.05.03 Wijzigingen versie 27
- 2.6 HaalOptInKeuzen
* nieuwe aanroep
- 2.7 SchrijfOptInKeuzen
* nieuwe aanroep
- 2.8 HaalOptInLijst
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* nieuwe aanroep
- HCCpartners aanroep nieuwe interface ('Action' => 'ControleerHCCLidmaatschap')
2013.07.05 Wijzigingen versie 28
- 8.1 MaakGebruikerAan
* extra parameters (mail, hccPseudoniem) in het antwoord
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra parameter (mailHccnet)
- A.1 ZoekHCCLid
* extra parameter (mailHccnet)
- A.3 ZoekGroeperingsLid
* extra parameter (mailHccnet)
2013.08.31 Wijzigingen versie 29
- F.1 / F.2 / F.3 HCC-kader / ControleerKaderlid
* extra output parameter (hccKaderMail)
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra output parameter (hccForumLogin)
- H.1 HCC-groepering / GebruikerBestaatControle
* komma-gescheiden lijst met groeperingen mogelijk
* extra output parameter (mailHccnet)
2013.12.26 Wijzigingen versie 30
- 3.1 Geef mijn lidnummer
* nieuwe aanroep
- A.1 ZoekHCCLid
* geef nu ook 'ProfielBekend' terug om aan de PC30 omgeving door te geven
dat het wachtwoord niet veranderd mag worden door PC30
- A.6 GeefBezoekersOverzicht
* geef nu ook 'Locatie' terug indien van toepassing
- A.7 GeefLocaties
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* parameters aangepast
* authenticatie op basis van hccLogin + userPassword of lidnummer + hcc-code
* geen algemene hcc-forum authenticatie meer mogelijk
- F.7 ControleerKaderlidGroep
* Nieuwe aanroep
2014.02.01 Wijzigingen versie 31
- A.8 RegistreerGast
* nieuwe aanroep
- H.2 MatchPostcodeMetRegio
* nieuwe aanroep
- nieuwe interface (losse, unieke aanroepen, niet meer gegroepeerd)
2014.09.27 Wijzigingen versie 32
- C.1 GeefOpgezegdeLeden hernoemd naar GeefUitgeschrevenLeden
- I.3 GeefhccEindDatum
* nieuwe aanroep
- Action=7 en Action=8 toegevoegd aan de HenZ interface
2014.12.12 Wijzigingen versie 33
- F.1 / F.2 / F.3 HCC-kader / IsKaderLid
* extra output parameter (mail, mailHccnet, hccKaderForward)
- F.8 HCC-kader / ZetKaderForward
* nieuwe aanroep
2015.05.06 Wijzigingen versie 34
- GeefMijnGegevens
* nieuwe aanroep
- ValideerPCActiveAbonnee
* vervallen
- 1.4 GebruikerBestaatControle
* extra output parameter (hccKaderForward)
- D.1 HCCpartner/ControleerHCCLidmaatschap
* optionele extra output parameter (ExtraInfo)
2015.09.27 Wijzigingen versie 35
- HeeftForumCredentials
* vervallen
2015.11.20 Wijzigingen versie 36
- SchrijfNietlidInOpBulletin
* nieuwe aanroep
2015.12.13 Wijzigingen versie 37
- serverID als optionele parameter
- SchrijfNietlidInOpBulletin
* Maak velden optioneel
2016.01.05 Wijzigingen versie 38
- A.7 GeefLocaties
* optionele parameter JoomlaFilter
- F.4 GeefAlleGroeperingen
* optionele parameter JoomlaFilter
- F.5 GeefAlleKaderRollen
* optionele parameter JoomlaFilter
2016.01.15 Wijzigingen versie 39
- H.3 GeefMijnGegevens
* geeft nu ook hccOptIn terug
* geeft nu ook JoomlaToken terug
- H.4 PasOptInKeuzeAan
* nieuwe aanroep
- SiteID en RemoteID als optionele parameter
2016.03.17 Wijzigingen versie 40
- H.5 ZoekKaderLeden
* nieuwe aanroep
2016.03.20 Wijzigingen versie 41
- ServerID, SiteID en RemoteID als optionele parameters bij alle aanroepen
- A.7 GeefLocaties
* optionele parameter KadernetFilter
- A.9 GeefLocatieNamen
* optionele parameter KadernetFilter
- F.4 GeefAlleGroeperingen
* optionele parameter KadernetFilter
- F.5 GeefAlleKaderRollen
* optionele parameter KadernetFilter
- F.6 WijzigHccRol
* vervallen
- F.7 IsGroeperingsKaderlid
* vervallen
- 8.3 IsDezePseudoniemNogBeschikbaar
* vervallen
- 2.7 SchrijfOptInKeuzen
* vervallen
- 2.5 WijzigGebruikersGegevens (hccPseudoniem)
* vervallen
- H.2 MatchPostcodeMetRegio
* vervallen
2016.04.02 Wijzigingen versie 42
- H.6 GeefMijnKaderDetails
* nieuwe aanroep
2016.07.03 Wijzigingen versie 43
- Ubuntu 16.04 aanpassingen (PHP versie 7) beschreven
2016.09.01 Wijzigingen versie 44
- H.5 ZoekKaderLeden
* extra parameter 'hccMobiel'
2016.10.13 Wijzigingen versie 45
- H.3 GeefMijnGegevens (dedecated Joomla aanroep)
* hccForumLogin weg als parameter
* Als het om een webmaster gaat, vul dan eventueel hccRegio of hccIG aan
met die groepering, ook als hij geen lid is van die groepering
- I.4 GebruikerBestaatControle
* hccForumLogin weg als parameter
2016.12.01 Wijzigingen versie 46
- 8.3 IsDezePseudoniemNogBeschikbaar teruggezet
2017.05.28 Wijzigingen versie 47
- H.7 GeefMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
- H.8 ZetMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
2017.09.01 Wijzigingen versie 48
- A.10 SchrijfNietlidInOpBulletin nu alleen voor 1 bulletin tegelijk
- 2.2 WijzigGebruikersGegevens (op basis van gebruikersnaam en wachtwoord)
is vervallen (was een oude Drupal aanroep)
- A.3 ZoekGroeperingsLid geeft ook hccKaderToonMobiel terug
- H.7 GeefMinimaleKaderGegevens geeft ook hccKaderToonMobiel terug
2017.11.14 Wijzigingen versie 49
- A.3 ZoekGroeperingsLid geeft geen hccKaderToonMobiel meer terug
- A.3 ZoekGroeperingsLid geeft alleen hccMobiel als hccKaderToonMobiel dat toestaat
2018.02.18 Wijzigingen versie 50
- H.6 GeefMijnKaderDetails geeft ook hccKaderToonMobiel terug
- H.9 PasKaderGegevensAan
* nieuwe aanroep
- H.3 GeefMijnGegevens geeft 3 extra parameters terug (hccKaderMail, hccKaderForward,
hccKaderToonMobiel)
- JoomlaTokens worden gevalideerd op siteID, niet langer op serverID
- diverse aanroepen kunnen nu ook via de bezoekersregistratie-proxy aangeroepen worden.
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
(GeefAlleGroeperingen, GeefAlleKaderRollen, GeefLocaties, GeefLocatieNamen)
De bezoekersregistratie aanroepen hebben enkel JoomlaToken als extra parameter nodig:
(LidBezoektBijeenkomst, GeefBezoekersOverzicht)
2018.02.26 Wijzigingen versie 51
- H.3 GeefMijnGegevens geeft extra parameter hccMobiel terug
- H.9 PasKaderGegevensAan kan nu ook kadermail password aanpassen
- K.1 ValideerToken
* nieuwe aanroep
- K.2 ValideerHCCCode
* nieuwe aanroep
2018.03.17 Wijzigingen versie 52
- H.3 Haal al mijn gegevens
Extra optie 'compact' om alleen essentiele resultaten te verkrijgen
(t.b.v. de Android bezoekersregistratie applicatie)
2018.03.25 Wijzigingen versie 53
- I.2 IsHCCLid
(Oude aanroep teruggezet, wordt nog in vraagbaak module gebruikt)
2018.07.01 Wijzigingen versie 54
* A.1 beheer authenticatie op basis van lidnummer + hccCode (tbv VZ-portal)
* A.2 HaalPC30Token weggehaald
2018.08.22 Wijzigingen versie 55
* 1.2 GebruikerBestaatControle' (op basis van hccLogin en userPassword) weggehaald
* 1.4 GebruikerBestaatControle' (op basis van zoekHccLogin of zoekHccLidnr) weggehaald
* 2.8 HaalOptInLijst weggehaald
* E.1 PasKaderWachtwoordAan weggehaald
* F.1 IsKaderLid (op basis van hccLidnr en hccCode) weggehaald
* F.3 IsKaderLid (op basis van beheerdernaam en beheerderwachtwoord) was al weg
* F.8 ZetKaderForward weggehaald
* H.1 IsGroeperingsLid weggehaald
* H.6 GeefMijnKaderDetails weggehaald
* H.7 GeefMinimaleKaderGegevens weggehaald
* H.8 ZetMinimaleKaderGegevens weggehaald
* K.1 ValideerHCCCode weggehaald
* K.2 ValideerToken weggehaald
* H.3 GeefMijnGegevens geeft omvang kader mailbox mee terug
2018.11.06 Wijzigingen versie 56
Nieuwe aanroepen t.b.v. forum en vraagbaak autorisaties
* L.1 MaakOnderwerp
* L.2 VerwijderOnderwerp
* L.3 GeefOnderwerpen
* L.4 MuteerOnderwerp
* L.5 MuteerOnderwerpAutorisatie
* L.6 ToonOnderwerpAutorisatie
* H.5 ZoekKaderLeden heeft compact optie
2018.11.16 Wijzigingen versie 57
* L.5 MuteerOnderwerpAutorisatie kent nu ook RED(acteur)
2018.12.17 Wijzigingen versie 58
* A.11 GeefBezoekersAantallen (nieuwe aanroep)
* H.10 PasUserWachtwoordAan (nieuwe aanroep)
2019.02.21 Wijzigingen versie 59
* A. 6 GeefBezoekersOverzicht geeft enkel lijst van bezoekers laatste bijeenkomst
2019.10.26 Wijzigingen versie 60
* A.4 Schrijf bezoekers niet meer automatisch in op bulletins
* H.4 PasOptInKeuzeAan kan ook door LA aangeroepen worden
Nieuwe aanroepen t.b.v. eigen implementatie van mijn.hcc.nl in de Joomla modules
* H.11 PasPseudoniemAan
* H.12 ValideerWachtwoordEisen
* H.13 PasWachtwoordAan (1: op JoomlaToken, 2: op PWResetToken)
* H.14 MaakPWResetToken
* H.15 ValideerPWResetToken
* H.16 RuimJoomlaTokenOp
* A.12 GeefAlleBulletins
* A.13 ExpandeerPostcode
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.18 NormaliseerTelefoon
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
* A.21 HaalIGBedragenOp
* A.22 HaalTariefGroepenOp
* A.23 PasInteressegroepAan
* F.10 MuteerGroeperingSamenstelling
* A.24 GeefSSOUrls
Aanpassingen gemaakt aan
8.1 MaakGebruikerAan
F.5 GeefAlleKaderRollen
2020.01.04 Wijzigingen versie 61
Nieuwe aanroepen t.b.v. IDEAL betaling hobbynet abonnees
H.17 GeefAantalDomeinen
2020.01.06 Wijzigingen versie 62
Nieuwe aanroepen t.b.v. Cayentis (CRM webproxy) implementatie
* M.1 Upload_CSV_bestand
* M.2 SchrijfNieuwLidIn
* M.3 Verwerk_JSON_mutatie
* M.4 ISO_landcode
* M.5 MuteerAanmeldingsformulier
* M.6 HaalAanmeldingsformulier
* M.7 GeefFactuurOverzicht
* M.8 HaalFactuur
* A.25 UpdateNAW
Vervallen aanroepen
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
Aangepaste aanroepen
* A.23 PasInteressegroepAan
2020.03.27 Wijzigingen versie 63
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.18 ResetHCCCode
* H.19 PasHccLoginAan
2020.04.10 Wijzigingen versie 64
Nieuwe aanroepen
* A.26 VerwijderNietLid
Aanpassingen gemaakt aan
* A.1 ZoekHCCLid: nieuwe zoekoptie 'niet_leden'
Opnieuw geimplementeerd
* A.20 UpdateMobiel
2020.11.26 Wijzigingen versie 65
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.20 MaakTestLogin
Aanpassingen gemaakt aan
- H.3 GeefMijnGegevens: optionele parameter 'hccGroepering'
Het werken met een testaccount heeft impact op de volgende aanroepen:
- G.7 GeefFactuurOverzicht
- M.8 HaalFactuur
- L.1 MaakOnderwerp
- H.14 MaakPWResetToken
- F.10 MuteerGroeperingSamenstelling
- L.4 MuteerOnderwerp
- L.5 MuteerOnderwerpAutorisatie
- H.19 PasHccLoginAan
- A.23 PasInteressegroepAan
- H.9 PasKaderGegevensAan
- H.4 PasOptInKeuzeAan
- H.11 PasPseudoniemAan
- H.13 PasWachtwoordAan
- H.18 ResetHCCCode
- A.20 UpdateMobiel
- A.25 UpdateNAW
- L.2 VerwijderOnderwerp
- A.5 VraagLidgegevensTokenAan
- 2.1 WijzigGebruikersGegevens
- H.3 GeefMijnGegevens geeft extra parameter terug (testaccount)
2021.08.01 Wijzigingen versie 66
Aanpassingen gemaakt aan
- H.4 PasOptInKeuzeAan werkt nu ook op basis van OptOutToken
2021.10.10 Wijzigingen versie 67
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.21 UpdateOTP
H.3 GeefMijnGegevens geeft extra parameters terug (hccOtpKey en hccOtep)
</pre>

= Aanpassingen aan de Apache omgeving =

== php.ini aanpassingen ==
De XML-RPC server zal 'ergens' een bestand moeten kunnen vinden met de
gebruikersnamen t.b.v. het authenticeren bij de LDAP-server.

Dit bestand wordt geplaatst in de map '/usr/local/hobbynet/etc'. Om dit
vanuit Apache te mogen benaderen, dient een aanpassing aan php.ini
gemaakt te worden:

/etc/php5/apache2/php.ini

include_path = ".:/usr/share/php:/usr/share/pear:/usr/local/hobbynet/etc"

== Apache modules ==
Nieuwe server geschikt maken voor XML-RPC gebruik

=== Apache modules (PHP 7) ===
Ubuntu 16.04 wordt standaard met PHP versie 7.0 uitgeleverd.
De opdrachten om de modules op te halen zijn:
apt-get install php-xmlrpc
apt-get install apache2
apt-get install ldap-utils
apt-get install php-ldap
apt-get install libapache2-mod-php

== Loadbalancer akties niet naar de logbestanden schrijven ==
De loadbalancer haalt zeer frequent een testbestand op (/test.txt), om
te controleren of de xml-server operationeel is. Dat levert extreem veel
logging op in /var/log/apache2/other_vhosts.log.

Pas de apache configuratie zo aan, dat logging van alle opvragingen
vanaf de loadbalancers uitgezet wordt.
/etc/apache2/sites-enabled/xml-server

# Mark requests from loadbalancers
SetEnvIf Remote_Addr "212\.72\.227\.93" dontlog
SetEnvIf Remote_Addr "212\.72\.227\.94" dontlog
SetEnvIf Remote_Addr "172\.31\.1\.249" dontlog
SetEnvIf Remote_Addr "172\.31\.1\.250" dontlog
CustomLog ${APACHE_LOG_DIR}/access.log common env=!dontlog

= Firewall algemeen =
In de file /etc/hobby-firewall/hobby-firewall.local wordt het script
'/usr/local/hobbynet/bin/gen_fw.sh' aangeroepen.
Deze haalt de IP adressen op uit ldap.
(.local omdat we dit ook zo doen op de webservers).

De firewall wordt 4 x per dag herstart en /etc/hobby-firewall wordt
gesynchroniseerd (1-richting van lb1 naar lb2) met de volgende crontab
entries:

Op lb1:
0 0 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 5 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 11 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 17 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 23 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null

Op lb2:
15 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 0 * * * /etc/init.d/hobby-firewall restart >/dev/null

Het encrypted backup script is verplaatst naar '/usr/local/hobbynet/local' en hernoemd naar 'backup-encrypted.bash'.
Dit is omdat deze niet mee mag worden gesynchroniseerd.

Tevens wordt 1x per dag /usr/local/hobbynet/bin gesynchroniseerd (1-richting van hcc-ldap-lb1 naar hcc-ldap-lb2)

== Aanpassingen in de firewall ==
Op de server waar de XML-RPC server staat, moeten enkele firewall aanpassingen gemaakt worden.
* inkomend: sta TCP 443 toe vanaf het interne netwerk (www-prod, www-test), en vanaf eventuele andere plekken die we expliciet toe willen staan.
* inkomend: sta TCP 443 toe vanaf mijn.hcc.nl (XML-RPC aanroepen vanaf de portal)
* inkomend: sta TCP 443 toe vanaf service.hccnet.nl toe (XML-RPC aanroep GeefUitgeschrevenLeden vanuit HenZ)
* uitgaand: sta TCP 443 naar service.hccnet.nl toe (XML-RPC aanroepen naar HenZ)
* uitgaand: sta TCP 990 en 5000-6000 naar Apps.HCC.local (FTPS verkeer naar de HCC server bij Hobbynet)

== Aanpassingen aan AppArmor ==
Alhoewel technisch gezien dit bij slapd behoort, neem ik het toch hier op.

Als het Hobbynet certificaat in de map /disk/site/etc/ssl/hobby.nl/ wordt neergezet, dan zal apparrmor de toegang tot de certificaten blokkeren. Neem daarom in de '''local''' directory van apparmor het volgende op:
# /etc/apparmor.d/local/usr.sbin.slapd
# Site-specific additions and overrides for usr.sbin.slapd.
# For more details, please see /etc/apparmor.d/local/README.
#include <abstractions/ssl_certs>
/disk/site/etc/ssl/hobby.nl/ r,
/disk/site/etc/ssl/hobby.nl/* r,

= CRM (Azure) proxy herstarten =
Als er indicaties zijn dat niet alle JSON berichten meer vanuit het CRM aangeboden worden aan de XML-RPC server, dan kan het helpen om de CRM proxy te herstarten

* Ga naar https://portal.azure.com/
* Login met zelfde account als voor het CRM
* Soms krijg je een popup. Die kan je weg klikken, je wilt geen rondleiding
* Klik op '''hccdyn01-aps-crm01''' voor productie en '''hccdyn01-aps-dev01''' voor test
* En dan kan je op opnieuw starten klikken.

MediaWikiSites

2021-10-03T09:09:31Z

Hans: beschrijf hoe er met patch gewerkt is op 2021.10.03

== Lijst met Mediawiki sites die wij bijhouden ==

* Hobbynet wiki (https://wiki.hobby.nl/)

== upgrade procedure ==
* maak met tar een backup van de wiki:
cd /disk/site/wiki
tar -cf wiki-backup-20200830.tar www
bzip2 wiki-backup-20200830.tar

* maak met phpmyadmin een backup van de database

* download de wiki software upgrade van http://www.mediawiki.org/

* volg de instructies zoals beschreven op http://www.mediawiki.org/wiki/Manual:Upgrading 

=== Hobbynet wiki updaten ===
* Volg de instructies om de wiki te updaten

====optie 1: volledige versie downloaden en installeren====
Ons eigen lijstje:

ssh hobbynet-lb1-int
cd /disk/site/hobbynet/wiki.hobby.nl
rm -rf www-old
cp -a www www-old
wget https://releases.wikimedia.org/mediawiki/1.36/mediawiki-1.36.1<nowiki/>.tar.gz
tar xzf mediawiki-1.36.1.tar.gz
chown wiki-hobby-nl:wiki-hobby-nl mediawiki-1.36.1 -R
cp -a www-old/LocalSettings.php mediawiki-1.36.1
cp -a www-old/images/* mediawiki-1.36.1/images
cp -a www-old/getip* mediawiki-1.36.1
rm -rf www
mv mediawiki-1.36.1 www
cd www/maintenance
php update.php

Op 2021.08.15 wilde de update naar 1.36.1 niet starten. Bleek dat eerst de module 'php-intl' met apt erbij gezet moest worden.

Op 2020.08.30 weigerde de update correct te lopen. Bleek dat er geen skins meer waren, en de extensie WikiEditor ontbrak ook.
Pas na het terugzetten van die bestanden uit de oude omgeving wilde het update script draaien
cp -a ../../www-old/skins/MonoBook ../skins/
cp -a ../../www-old/skins/Vector/ ../skins/
cp -a ../../www-old/skins/Timeless/ ../skins/
cp -a ../../www-old/extensions/WikiEditor ../extensions/
php update.php

*Als update.php niet draait, omdat er geen sql modules beschikbaar zouden zijn, selecteer dan eerst de juiste php versie
update-alternatives --config php

* Op de hobbynet wiki staan 2 losse bestanden die geen directe relatie met de wiki software hebben ('''getip.html''' en '''getip.php'''). 
Plaats die bestanden terug, tijdens de wiki upgrade actie!

====optie 2: patch enkel de verschillen====

Op 2021.10.03 is er voor het eerst gebruik gemaakt van de patch procedure om de upgrade naar versie 1.36.2 uit te voeren.
wget https://releases.wikimedia.org/mediawiki/1.36/mediawiki-1.36.2.patch.gz
gunzip mediawiki-1.36.2.patch.gz
patch -p1 --dry-run -i mediawiki-1.36.2.patch
patch -p1 -i mediawiki-1.36.2.patch

MediaWikiSites

2021-08-15T11:16:09Z

Hans: versie 1.36.1

== Lijst met Mediawiki sites die wij bijhouden ==

* Hobbynet wiki (https://wiki.hobby.nl/)

== upgrade procedure ==
* maak met tar een backup van de wiki: 
cd /disk/site/wiki
tar -cf wiki-backup-20200830.tar www
bzip2 wiki-backup-20200830.tar

* maak met phpmyadmin een backup van de database 

* download de wiki software upgrade van http://www.mediawiki.org/ 

* volg de instructies zoals beschreven op http://www.mediawiki.org/wiki/Manual:Upgrading 

=== Hobbynet wiki updaten ===
* Volg de instructies om de wiki te updaten
Ons eigen lijstje:

ssh hobbynet-lb1-int
cd /disk/site/hobbynet/wiki.hobby.nl
rm -rf www-old
cp -a www www-old
wget https://releases.wikimedia.org/mediawiki/1.36/mediawiki-1.36.1<nowiki/>.tar.gz
tar xzf mediawiki-1.36.1.tar.gz
chown wiki-hobby-nl:wiki-hobby-nl mediawiki-1.36.1 -R
cp -a www-old/LocalSettings.php mediawiki-1.36.1
cp -a www-old/images/* mediawiki-1.36.1/images
cp -a www-old/getip* mediawiki-1.36.1
rm -rf www
mv mediawiki-1.36.1 www
cd www/maintenance
php update.php

Op 2021.08.15 wilde de update naar 1.36.1 niet starten. Bleek dat eerst de module 'php-intl' met apt erbij gezet moest worden.

Op 2020.08.30 weigerde de update correct te lopen. Bleek dat er geen skins meer waren, en de extensie WikiEditor ontbrak ook.
Pas na het terugzetten van die bestanden uit de oude omgeving wilde het update script draaien
cp -a ../../www-old/skins/MonoBook ../skins/
cp -a ../../www-old/skins/Vector/ ../skins/
cp -a ../../www-old/skins/Timeless/ ../skins/
cp -a ../../www-old/extensions/WikiEditor ../extensions/
php update.php

* Als update.php niet draait, omdat er geen sql modules beschikbaar zouden zijn, selecteer dan eerst de juiste php versie
update-alternatives --config php

* Op de hobbynet wiki staan 2 losse bestanden die geen directe relatie met de wiki software hebben ('''getip.html''' en '''getip.php'''). 
Plaats die bestanden terug, tijdens de wiki upgrade actie!

XML-RPC

2021-08-01T11:19:44Z

Hans: hccOptOutToken geintroduceerd

= XML-RPC interface =
De LDAP server kan direct gemuteerd worden via een LDAP koppeling. Zie de standaard LDAP pagina voor de uitleg welke poorten daarvoor gebruikt kunnen worden.

Daarnaast is er de wens ontstaan om via een standaard protocol met de LDAP omgeving te kunnen communiceren. Er is hiertoe een XML-RPC koppeling ontwikkeld. XML-RPC is een standaard interface, waarmee het mogelijk is om vanuit diverse omgevingen op een gestandaardiseerde manier te communiceren.
== Globale functie omschrijving ==
* Algemene aanroepen
** Controleer of een gebruiker bestaat
** Wijzig het wachtwoord ('userPassword')
** Zoek een gebruiker (t.b.v. kantoor en/of LA-akties groeperingssecretaris)
** Maak een gebruiker aan (geef gebruiker een andere hccLogin waarde, maak ook bij HCCnet deze gebruiker aan)
** Controleer of een gebruiker zijn profiel al doorlopen heeft
** Haal de lijst met opgeheven accounts op
** Haal de lijst met bulletins van een hcc lid (OptIn)

* Aanroepen t.b.v. hcc partners
** Controleer of lidnummer/postcode correct is
** Controleer of lidnummer/postcode correct is, en tevens ingeschreven staat bij een specifieke IG

* Joomla template site functies (op basis van JoomlaToken)
** Maak een JoomlaToken
** Ruim een JoomlaToken op
** Pas mijn OptIn (bulletin inschrijving) aan
** Regel alles rondom Onderwerpen en de autorisatie hiervan
** Pas mijn wachtwoord aan

* Joomla kadernet site functies (op basis van JoomlaToken)
** Zoek een hcc kaderlid (t.b.v. de kaderleden zoekpagina)
** Pas mijn kadermail forwarding aan en toon ja/nee mijn GSM nummer
** Pas het kadernet e-mail wachtwoord aan
** Haal de lijst met alle groeperingen op
** Haal de lijst met alle kaderrollen op

* Joomla hcc.nl site (op basis van JoomlaToken)(mijn.hcc.nl vervanging)
** Pas mijn adresgegevens aan
** Pas mijn voorletters, voornaam, pseudoniem, telefoonnummer, GSM nummer etcetera aan
** Schrijf me in of uit op een bulletin
** Toon info over de kosten van een IG lidmaatschap
** Voer een wachtwoord reset uit op basis van een PWResetToken (een variant op JoomlaToken)
** Vraag een nieuwe HCC code aan, en stuur die per SMS

* Joomla hobby.nl site (op basis van JoomlaToken)(t.b.v. IDEAL betaling)
** Haal het aantal hobbyDomains op

* Aanroepen t.b.v. CRM (Microsoft Dynamics Cloud) koppeling
** Haal de dagelijkse synchronisatie bestanden op
** Werk in het CRM dan wel in LDAP de NAW gegevens bij
** Werk in het CRM dan wel in LDAP de IG gegevens van een lid bij

* HenZ
** Haal de lijst met opzeggers op
** Valideer de opzegdatum van een opgegeven gebruiker
=== Authenticatie ===
Alle aanroepen gebeuren op basis van authenticatie vanuit de aanroeper. Dit valt uiteen in de volgende categorieën:
* gebruikersnaam ('hccLogin') en wachtwoord ('userPassword')
* hcc lidnummer ('hccLidnr'), Joomla token ('JoomlaToken') en website ('siteID')
* hcc lidnummer ('hccLidnr') en hcc code ('hccCode')
* beheerders-DN ('beheerLogin') en beheerders wachtwoord ('beheerPassword')
* partner-DN ('partnerLogin') en partner wachtwoord ('partnerPassword')
=== Aanroepen, gedaan via de bezoekersregistratie-proxy ===
(de bezoekersregistratie proxy is een mislukt project tbv de Android app van René Prins) (deze proxy bestaat niet meer)

Diverse aanroepen kunnen ook via de bezoekersregistratie-proxy aangeroepen worden.

Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
* GeefAlleGroeperingen
* GeefAlleKaderRollen
* GeefLocaties
* GeefLocatieNamen
De bezoekersregistratie aanroepen hebben 'JoomlaToken' als extra parameter nodig:
* LidBezoektBijeenkomst
* GeefBezoekersOverzicht
* GeefBezoekersAantallen
De aanroepen die over de proxy uitgevoerd worden dienen voorafgegaan te worden door een aanroep naar
* GeefMijnGegevens (dit geeft na validatie immers 'JoomlaToken' terug)
=== Resultaten ===
Alle aanroepen geven de volgende elementen terug:
* Naam van de uitgevoerde procedure ('Action')
* Resultaat van de uitgevoerde procedure ('Status')
* Een tekstuele vertaling van het resultaat dan wel de foutmelding ('Message')
* Tijdens de ontwikkelfase kan er debug-info teruggeleverd worden ('ExtraInfo')
Daarnaast geven specifieke aanroepen extra resultaten terug
== Technische omschrijving ==
XML-RPC beschrijving van acties in hcc.nl LDAP database<pre>
2021.08.01 HaVe
XML-RPC Hobbynet versie 66.
</pre>
=== Kort overzicht ===
Dit is een lijst met alle XML-RPC aanroepen. In het volgende hoofdstuk worden ze in detail besproken.<pre>
echo (partners)
ExpandeerPostcode (Joomla module Bas, tbv verhuizingen)
GebruikerBestaatControle (Joomla sites)
GeefAantalDomeinen (Joomla module Bas)
GeefAlleBulletins (Joomla module Bas)
GeefAlleGroeperingen (kadersite, forum, secr. portal, kantoor portal, hobbynet portal)
GeefAlleKaderRollen (forum, secr. portal, kantoor portal, hobbynet portal, Joomla module Bas)
GeefBezoekersOverzicht (bezoekersregistratie)
GeefBezoekersAantallen (bezoekersregistratie)
GeefFactuurOverzicht (Joomla module Bas)
GeefhccEindDatum (HenZ)
GeefKadermailGegevens (kantoor portal)
GeefLocatieNamen (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefLocaties (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefMijnGegevens (Joomla inlog module Bas)
GeefMijnLidnummer (beheer.hcc.nl secretaris portal)
GeefOnderwerpen (Joomla template sites)
GeefSSOUrls (Joomla module Bas)
GeefUitgeschrevenLeden (Joomla sites, HenZ)
HaalAanmeldingsformulier (Joomla module Bas)
HaalFactuur (Joomla module Bas)
HaalIGBedragenOp (Joomla module Bas)
HaalOptInKeuzen (kantoor portal)
HaalTariefGroepenOp (kantoor portal)
HCCpartner (Partner aanroep)
HCCpartners (Partner aanroep)
IsDezeNaamNogBeschikbaar (aangeroepen vanuit de CRM omgeving)
IsDezePseudoniemNogBeschikbaar (kantoor portal)
IsHCCLid (vraagbaak aanroep)
IsKaderLid (in veel apps gebruikt)
LidBezoektBijeenkomst (bezoekersregistratie)
MaakGebruikerAan (mijnhcc.nl, maak hccnet account aan en ldap gebruikersnaam)
MaakOnderwerp (Joomla template sites)
MaakPWResetToken (Joomla module Bas)
MaakTestLogin (Joomla module Bas)
MuteerAanmeldingsformulier (Joomla module Bas)
MuteerGroeperingSamenstelling (Joomla kadernet module Bas)
MuteerOnderwerp (Joomla template sites)
MuteerOnderwerpAutorisatie (Joomla template sites)
NormaliseerTelefoon (Joomla module Bas)
PasHccLoginAan (Joomla module Bas)(enkel Hobbynet)
PasInteressegroepAan (Joomla module Bas)
PasKaderGegevensAan (kadersite, Joomla module Bas)
PasOptInKeuzeAan (Joomla module Bas)
PasPseudoniemAan (Joomla module Bas)
PasUserWachtwoordAan (beheer.hcc.nl Hobbynet gebruikers portal)
PasWachtwoordAan (Joomla module Bas)
RegistreerGast (bezoekersregistratie)
ResetHCCCode (Joomla module Bas)
RuimJoomlaTokenOp (Joomla module Bas)
SchrijfNietlidInOpBulletin (Joomla site bulletin module Bas)
SchrijfNieuwLidIn (Joomla CRM module Bas)
ToonOnderwerpAutorisatie (Joomla template sites)
UpdateContactEmail (Joomla module Bas)
UpdateContactGegevens (Joomla module Bas)
UpdateMobiel (Joomla module Bas)
UpdateNAW (Joomla module Bas)
UpdateTelefoon (Joomla module Bas)
UpdateVoorletters (Joomla module Bas)
UpdateVoornaam (Joomla module Bas)
Upload_CSV_bestand (CRM webproxy)
ValideerPWResetToken (Joomla module Bas)
ValideerWachtwoordEisen (Joomla module Bas)
Verwerk_JSON_mutatie (CRM webproxy)
VerwijderNietLid (Joomla beheer module Bas)
VerwijderOnderwerp (Joomla template sites)
VraagLidgegevensTokenAan (bezoekersregistratie)
WijzigGebruikersGegevens (kantoor en Joomla template sites, ww aanpassen van gebruiker)
ZoekGroeperingsLid (secr. portal, kantoor portal, hobbynet portal)
ZoekHCCLid (VZ portal)
ZoekKaderLeden (Joomla kadernet module Bas)
</pre>
=== HCC-ldap en/of HCC-net aanroepen ===
<pre>
// ** Joomla sites, www.hcc.nl **
// 1.1 controleer of een gebruiker bestaat - optie 1
// (authenticatie op basis van hccLidnr en hccCode)
// Alleen bedoeld om gebruikers op www.hcc.nl op basis van het lidnr het ww te laten wijzigen
$request = xmlrpc_encode_request(
'GebruikerBestaatControle',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $method,
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd');
if ($hccLidnr != '') { $reply['hccLidnr'] = $hccLidnr; }
if ($hccLogin != '') { $reply['hccLogin'] = $hccLogin; }
if ($hccPseudoniem != '') { $reply['hccPseudoniem'] = $hccPseudoniem; }
if ($cn != '') { $reply['cn'] = $cn; }
if ($sn != '') { $reply['sn'] = $sn; }
if ($mail != '') { $reply['mail'] = $mail; }
if ($mailHccnet != '') { $reply['mailHccnet'] = $mailHccnet; }
if ($hccRegio != '') { $reply['hccRegio'] = $hccRegio; }
if ($hccIG != '') { $reply['hccIG'] = $hccIG; }
if ($hccRol != '') { $reply['hccRol'] = $hccRol; }
if ($ProfielBekend != '') { $reply['ProfielBekend'] = $ProfielBekend; }

// ** Portal mijn.hcc.nl **
// 2.1 wijzig wachtwoord - optie 1
// op basis van hccLidnummer en hccCode
// Essentiele aanroep, gebruikt vanuit mijnhcc.nl (lidnr + hccCode)
// Ook gebruikt t.b.v. wachtwoord-vergeten procedure op de Joomla template sites
// Als de profielpagina nog niet is doorlopen wordt deze aanroep afgekeurd.
//
// Ook gebruikt om gebruiker rechtstreeks vanaf Joomla template sites wachtwoord te
// laten aanpassen (op basis van lidnummer en hcc code)
//
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'WijzigGebruikersGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gewijzigd',
'hccLogin' => $hccLogin,
'cn' => $cn,
'sn' => $sn);

// 2.3 wijzig wachtwoord - optie 3
// (t.b.v. VZ-portal)
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
// * Als hccLidnr gevuld is, dan wordt hccLidnr gebruikt om het juiste record te zoeken
// Als hccLidnr leeg is, dan wordt hccLogin gebruikt om het juiste record te zoeken
// 1 van beide velden MOET aanwezig zijn
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'beheerLogin' => $beheerLogin, // beheerder lidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

// ** t.b.v. ophalen van de opt-in keuzes op de beheer pagina **
// 2.6 Geef de complete lijst met opt-ins van dit lid
// (LET OP: authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'HaalOptInKeuzen',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalOptInKeuzen',
'Status' => 'TRUE',
'Message' => 'OptInLijst opgehaald',
'hccOptIn' => $hccOptIn);
Output negatief:
$reply = array(
'Action' => 'HaalOptInKeuzen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gebruikersnaam, pseudoniem
// en wachtwoord tevens in LDAP op
// (authenticatie op basis van hcc lidnummer en hcc-code)
// ** Deze gegevens worden doorgezet naar hccnet.nl (action=4) **
//
$request = xmlrpc_encode_request(
'MaakGebruikerAan',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_hccLogin' => $nieuw_hccLogin,
'nieuw_userPassword' => $nieuw_userPassword,
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'TRUE',
'Message' => 'Gebruiker aangemaakt',
'mail' => $mail,
'hccPseudoniem' => $hccPseudoniem);
Output negatief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gebruikersnaam bestaat al' |
'Pseudoniem bestaat al' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!');

// H.3 Haal al mijn gegevens
// (wordt gebruikt door de Joomla inlogmodule)
// Voor gebruik over de proxy t.b.v. de Android app kan compact=TRUE meegegeven worden.
// In dat geval worden enkel de meest essentiele gegevens teruggestuurd
// Voor gebruik na MaakGebruikerAan kan deze functie ook op basis van hccLidnr en JoomlaToken
// worden aangeroepen
// De optionele parameter 'PrevSiteID' is bedoeld voor single-sign-on. Op basis van JoomlaToken,
// hccLidnr en PrevSiteID worden dan de credentials gevalideerd. Als die kloppen, geeft deze aanroep
// een 2e JoomlaToken terug, maar dan uitgegeven op basis van SiteID.
// Als PrevSiteID leeg is, dan wordt het token op basis van siteID gevalideerd.
$request = xmlrpc_encode_request(
'GeefMijnGegevens',
array(
['hccLogin' => $hccLogin,
'userPassword' => $userPassword,]
['hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,]
['PrevSiteID' => $PrevSiteID,]
['compact' => $compact,] // leeg of 'TRUE'
['hccGroepering'=> $hccGroepering,] // Een testgebruiker mag alleen op deze site inloggen
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd',
'hccLidnr' => $hccLidnr,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccAutorisatie' => $hccAutorisatie,
'cn' => $cn,
'sn' => $sn,
'JoomlaToken' => $JoomlaToken,
['hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'givenname' => $givenname,
'hccAanhef' => $hccAanhef,
'hccGeslacht' => $hccGeslacht,
'hccTussenVoegsels' => $hccTussenVoegsels,
'hccAchternaam' => $hccAchternaam,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward,
'hccKaderToonMobiel' => $hccKaderToonMobiel,
'hccOptIn' => $hccOptIn,
'ProfielBekend' => $ProfielBekend,
'hccBeginDatum' => $hccBeginDatum,
'testaccount' => is_testaccount(), // 'TRUE' | 'FALSE'
['kadermail_omvang' => $Formaat, // in Mb
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald;]]);

Output negatief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// ** t.b.v. aanpassen van de opt-in keuzes op een Joomla site **
// H.4 Pas 1 opt-in van een lid aan
// (LET OP: authenticatie op basis van hccLidnr, JoomlaToken en siteID)
// of
// authenticatie op basis van hccLidnr en OptOutToken (voor een directe uitschrijving door een lid)
// Als hccLidnummer gevuld is, dan is dat het lidnummer waar de mutatie op moet worden uitgevoerd.
// Dat kan alleen als de aanvrager HCC#LAD of HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasOptInKeuzeAan',
array(
'hccLidnr' => $hccLidnr,
['JoomlaToken' => $JoomlaToken,]
['OptOutToken' => $OptOutToken,]
['hccLidnummer' => $hccLidnummer,]
'hccOptIn' => $hccOptIn,
'actie' => 'Nieuw' | 'Weg',
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'TRUE',
'Message' => 'OptIn aangepast');
Output negatief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials | Token ongeldig | Token verlopen');

// H.5 Zoek kaderleden NAW (t.b.v. de Joomla kadersite)
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
//
// * Er dient minstens 1 zoekcriterium opgegeven te worden.
// * Als zowel hccRegio als tegelijk ook hccIG opgegeven worden is de uitkomst onvoorspelbaar.
// * Als compact=TRUE worden enkel lidnummer, cn en sn in het antwoord gezet
$request = xmlrpc_encode_request(
'ZoekKaderLeden',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
['hccRegio' => $hccRegio,]
['hccIG' => $hccIG,]
['hccRol' => $hccRol,]
['hccLocatie' => $hccLocatie,]
['achternaam' => $achternaam,]
['compact' => $compact])); // leeg of 'TRUE'

Output positief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'TRUE',
'Message' => 'Kaderleden opgevraagd'
'Kaderleden' => array(
'hccLidNummer' => $hccLidNummer,
'hccRol' => $hccRol,
'hccAanhef' => $hccAanhef,
'givenname' => $givenname,
'cn' => $cn,
'sn' => $sn,
'hccWoonplaats' => $hccWoonplaats,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'hccKaderMail' => $hccKaderMail);

Output negatief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token']);

// H.9 PasKaderGegevensAan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
// Om de kaderleden hun forward in te laten stellen,
// en tegelijkertijd de opt-in / opt-out voor hccToonMobiel te laten regelen
// Kan tevens het kader email wachtwoord aanpassen
$request = xmlrpc_encode_request(
'PasKaderGegevensAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'hccKaderForward' => $hccKaderForward, // '' | $mail | $mailHccNet
'hccKaderToonMobiel' => $hccKaderToonMobiel, // 'TRUE' | 'FALSE' | 'NULL'
['nieuw_kaderPassword' => $nieuw_kaderPassword]));

Output positief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'TRUE',
'Message' => 'kadergegevens aangepast');

Output negatief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token'|'Alleen kaderleden mogen deze aanroep uitvoeren']);

// ** Portal beheer.hcc.nl
// ** H.10 PasUserWachtwoordAan
// ** Betalende Hobbynet gebruikers kunnen hiermee hun wachtwoord aanpassen
// (authenticatie op basis van hccLogin en userpassword)
$request = xmlrpc_encode_request(
'PasUserWachtwoordAan',
array(
'hccLogin' => $username,
'userpassword' => $password,
'hobbynetAccount' => $hobbyname,
'nieuw_wachtwoord' => $nieuw_wachtwoord,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!' |
'account $hobbynetAccount behoort niet bij gebruiker $hccLogin' |
'Kan ww van account $hobbynetAccount niet aanpassen');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.11 Pas het pseudoniem van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasPseudoniemAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccPseudoniem' => $hccPseudoniem,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'TRUE',
'Message' => 'Pseudoniem aangepast');
Output negatief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials' | 'Pseudoniem bestaat al');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.12 Controleer of een opgegeven wachtwoord aan de minimum eisen voldoet
$request = xmlrpc_encode_request(
'ValideerWachtwoordEisen',
array(
'userPassword' => $userPassword,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'TRUE',
'Message' => 'Wachtwoord voldoet aan de minimale eisen');
Output negatief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'FALSE',
'Message' => 'Wachtwoord voldoet niet aan de minimale eisen');

// ** H.13 PasWachtwoordAan
// ** Vanuit een Joomla template site kunnen gebruikers hiermee hun eigen wachtwoord aanpassen
// (authenticatie op basis van JoomlaToken, lidnummer, siteID. Extra controle via userpassword)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'userpassword' => $password,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.13.1 PasWachtwoordAan
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee hun eigen wachtwoord resetten
// (authenticatie op basis van PWResetToken en hccLogin).
// (Als de aanroep geslaagd is, dan is daarna het PWResetToken ongeldig)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.14 MaakPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee een wachtwoord reset aanvragen
// Deze aanroep geeft naast het PWResetToken ook het contact emailadres mee terug,
// zodat Joomla een reset-mail kan sturen
// (acties op basis van gebruikersnaam)
$request = xmlrpc_encode_request(
'MaakPWResetToken',
array(
'hccLogin' => $username,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'TRUE',
'PWResetToken' => $PWResetToken,
'mail' => $mail,
'Message' => 'Password reset token aangemaakt');
Output negatief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');

// ** H.15 ValideerPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers een wachtwoord reset aanvragen
// Controleer dat het hier om een bestaand (en nog niet gebruikt) token gaat
$request = xmlrpc_encode_request(
'ValideerPWResetToken',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'TRUE',
'Message' => 'Password reset token gevonden');
Output negatief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'FALSE',
'Message' => 'hccLogin bestaat niet' | 'PWResetToken bestaat niet');

// H.16 Ruim een bestaand JoomlaToken op
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'RuimJoomlaTokenOp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'SiteID' => $siteID,
['ServerID' => gethostname(),]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'TRUE',
'Message' => 'JoomlaToken opgeruimd');
Output negatief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'FALSE',
'Message' => 'Onjuist JoomlaToken');

// ** Joomla module
// ** H.17 GeefAantalDomeinen
// ** Vraag het aantal domeinen op van een betalende Hobbynet gebruiker (t.b.v. IDEAL betaling)
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'GeefAantalDomeinen',
array(
'JoomlaToken' => $JoomlaToken,
'hccLidnr' => $hccLidnr,
'hobbynetAccount' => $hobbyname,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'TRUE',
'hobbynetAccount' => $hobbyname,
'AantalDomeinen' => $aantalDomeinen,
'Message' => 'aantal domeinen opgevraagd');
Output negatief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'account $hobbynetAccount behoort niet bij deze gebruiker');

// ** Joomla module
// ** H.18 ResetHCCCode
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'beheerLogin' => $beheerLogin, // geheime credentials van de site
'beheerPassword' => $beheerPassword, // geheime credentials van de site
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** Joomla module
// ** H.18.1 ResetHCCCode (hcc kantoor aanroep)
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'JoomlaToken' => $JoomlaToken, // Het Joomla token van de sessie van de kantoor medewerker
'hccLidnr' => $hccLidnr, // Het lidnummer van de kantoor medewerker
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** t.b.v. aanpassen van de hccLogin van een gebruiker (Hobbynet functie op Joomla site) **
// H.19 Pas de hccLogin van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// hccLidnummer is het lidnummer waar de mutatie op moet worden uitgevoerd
// Kan alleen als de aanvrager HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasHccLoginAan',
array(
'hccLidnr' => $hccLidnr, // lidnummer van de aanvrager
'JoomlaToken' => $JoomlaToken, // JoomlaToken van de aanvrager
'hccLidnummer' => $hccLidnummer, // pas de hccLogin van dit lidnummer aan
'hccLogin' => $hccLogin, // dit is de gewenste nieuwe hccLogin
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'TRUE',
'Message' => 'hccLogin aangepast');
Output negatief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' |
'Onjuiste credentials' |
'Gebruikersnaam al in gebruik');

// ** t.b.v. het aanmaken van een testaccount door een webmaster
// H.20 Maak een testaccount aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// Kan alleen als de aanvrager WM als rol heeft
$request = xmlrpc_encode_request(
'MaakTestLogin',
array(
'JoomlaToken' => $JoomlaToken, // JoomlaToken van de aanvrager
'hccLidnummer' => $hccLidnummer, // lidnummer van de aanvrager
'hccRol' => $hccRol, // (mag leeg zijn)
'hccGroepering' => $hccGroepering, // (regio of IG)
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
reply = array(
'Action' => 'MaakTestLogin',
'Status' => 'TRUE',
'Message' => 'Tijdelijk test account aangemaakt',
'TestAccountNaam' => 'test-<groepering>-<hccLogin>'
'userpassword' => $nieuw_userpassword,
'hccGroepering' => $hccGroepering,
'hccRol' => $hccRol);
Output negatief:
$reply = array(
'Action' => 'MaakTestLogin',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Gegevenscombinatie onjuist');

// 3.1 Geef mijn lidnummer
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'GeefMijnLidnummer',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'TRUE',
'Message' => 'Lidnummer opgevraagd',
'hccLidnr' => $hccLidnr);
Output negatief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.2 Controleer of de gebruikersnaam op dit moment bestaat
// (geen authenticatie)
// ** Deze gegevens worden opgevraagd bij hccnet.nl (action=3) **
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezeNaamNogBeschikbaar',
array(
'nieuw_hccLogin' => $nieuw_hccLogin,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Gebruikersnaam is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Gebruikersnaam bestaat al');

// ** Enkel voor gebruik vanaf de kantoor portal **
// ** t.b.v. het hernoemen van accounts in CRM **
// 8.3 Controleer of een Pseudoniem op dit moment bestaat ??? NIET GEBRUIKT ??
// (geen authenticatie)
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezePseudoniemNogBeschikbaar',
array(
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem));
Output positief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Pseudoniem is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Pseudoniem bestaat al');

// ** t.b.v. de verenigingszaken zoekpagina **
// A.1 Zoek alle bij de query passende hcc leden
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
$request = xmlrpc_encode_request(
'ZoekHCCLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Groepering' => $Groepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (eerste deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| emailadres | (eerste deel van) e-mail adres |
| gebruikersnaam | (eerste deel van) de login naam |
| pseudoniem | (eerste deel van) het pseudoniem |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| niet_leden | het volledige niet-lid lidnummer |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'ZoekMethode' => $ZoekMethode,
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' => array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'sn' => $sn,
'givenName' => $givenName,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccHuisToevoeging' => $hcchuisToevoeging,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'ProfielBekend' => 'TRUE' | 'FALSE'])*);
Output negatief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. beheer.hcc.nl **
// A.3 Zoek alle bij de query passende hcc leden van deze groepering
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'ZoekGroeperingsLid',
array(
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Groepering' => $groepering,
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Bijeenkomst' => $Bijeenkomst,] // Alleen voor gebruik op de
// bijeenkomsten aanwezigheidsregistratie pagina
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| nieuwe_leden | YYYYMMDD vanaf waar gezocht moet worden |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| kaderleden | n.v.t. |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' =>
[array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'cn' => $cn,
'sn' => $sn,
'givenName' => $givenName,
'hccAchternaam' => $hccAchternaam,
'hccTussenVoegsels => hccTussenVoegsels,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem)]*));
Output negatief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker(s) niet gevonden' | 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten **
// A.4 Lid bezoekt bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'LidBezoektBijeenkomst',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
'hccLidnr' => $hccLidnr, // lid dat aanwezig gemeld moet worden
['correctie' => $hccLidnr,] // lid dat gecorrigeerd moet worden
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'TRUE',
'Message' => 'Bezoeker weggeschreven',
'Results' => array(
// info van deze bezoeker
'cn' => $cn, // cn (Verbeek, H.J.)
'hccGeslacht' => $hccGeslacht, // hccGeslacht van de bezoeker
'groeperingslid' => $groeperingslid, // TRUE of FALSE: is deze persoon lid van deze groepering
'mijnGroeperingen' => $mijnGroeperingen, // komma-gescheiden lijst (regio, [hccIG]*)
'aantalBezoeken' => $aantalBezoeken, // hoe vaak heeft dit lid deze bijeenkomst bezocht
// info van de bijeenkomst
'AantalBezoekers' => $AantalBezoekers); // aantal bezoekers van deze bijeenkomst
Output negatief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.5 Vraag Lidgegevens token aan (geldig voor dit lid, en deze groepering, op deze datum)
// Als geen datum gegeven is, dan is het token vandaag geldig
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'VraagLidgegevensTokenAan',
array(
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'hccLidnr' => $hccLidnummer, // vraag het token voor dit lid aan
'groepering' => $groepering, // zoek binnen deze groepering
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'TRUE',
'Message' => 'Token opgevraagd',
'groepering' => $Groepering,
'token' => $token,
'sn' => $sn);
Output negatief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.6 Toon bezoekersoverzicht
// (authenticatie op basis van lidnummer en bezoekersregistratie token)
$request = xmlrpc_encode_request(
'GeefBezoekersOverzicht',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'token' => $token,
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'TRUE',
'Message' => 'Bezoekersoverzicht opgevraagd',
'Bezoekers' => $bezoekers,
['Locatie' => $Locatie]);
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// A.7 Geef het array met alle locaties
// (of beperk dit tot de locaties van de groepering $Groepering)
// Desgewenst worden alle resultaten waarbij hccToonInJoomla aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// Desgewenst worden alle resultaten waarbij ToonOpKaderNet aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocaties',
array(
['Groepering' => $hccGroepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']);
Output positief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);
Output negatief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'FALSE',
'Message' => 'Locaties niet beschikbaar',
'ExtraInfo' => 'Geen locaties gevonden voor groepering $hccGroepering',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);

// A.8 Registreer een niet-hcclid als bezoeker tijdens een bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'RegistreerGast',
array(
'AccountNaam' => $lidnr, // credentials
'AccountCode' => $AccountCode, // credentials
'token' => $token, // credentials
'Bijeenkomst' => $groepering,
'geslacht' => $geslacht,
'naam' => $naam,
'mail' => $mail,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'buitenland' => $buitenland,
['nietLidNummer' => $nietLidNummer,]
['instructies' => $instructies,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $aanroep,
'Status' => 'TRUE',
'Message' => 'Niet-lid als bezoeker geregistreerd',
'Result' => $result_array);

// A.9 Geef het array met alle locatienamen
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocatieNamen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']));
['KaderMutatieFilter' => '' | 'TRUE']));

Output positief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));
Output negatief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'FALSE',
'Message' => 'Locatienamen niet beschikbaar',
'ExtraInfo' => 'Geen locatienamen gevonden',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));

// A.10 Schrijf een niet-lid in op een bulletin
// (2019.12.05: wordt actief gebruikt in Joomla module)
// Deze aanroep mag *ook* worden gebruikt om een wel-lid in te schrijven.
// Voorwaarde is dat bewezen is dat er controle bestaat over het opgegeven email adres
$request = xmlrpc_encode_request(
'SchrijfNietlidInOpBulletin',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'hccOptin' => $hccOptin, // bulletin waarop ingeschreven wordt
'hccOptinSource' => $hccOptinSource, // site waar aanmelding vandaan komt
'Email' => $Email, // niet-lid: email adres
'Naam' => $Naam, // niet-lid: naam
['hccLidNummer' => $hccLidNummer,] // optioneel: ik ben lid, dit is mijn lidnummer
['Postcode' => $Postcode,] // optioneel: niet-lid: postcode
['Huisnummer' => $Huisnummer,] // optioneel: niet-lid: huisnummer
['hccGeslacht' => $hccGeslacht,] // optioneel: niet-lid: geslacht (M/V/O)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'TRUE',
'Message' => 'Inschrijving op bulletin gelukt');
Output negatief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist',
'ExtraInfo' => 'Invalid DN syntax' |
'Invalid credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.11 Toon bezoekers aantallen
// (authenticatie op basis van AccountNaam en AccountCode of token)
//
// ==> Mag weg: laatste aanroep 2018.12.15 <==
//
$request = xmlrpc_encode_request(
'GeefBezoekersAantallen',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'token' => $token,
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersAantallen',
'Status' => 'TRUE',
'Message' => 'BezoekersAantallen opgevraagd',
'Datum' => $datum,
'Bijeenkomst' => $Bijeenkomst,
'Bezoekers' => array(
[HCC!seniorenacademie] => Array(
[Gorinchem] => 15
[Woerden] => 36)
...));
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersAantallen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// ** t.b.v. Joomla module Bas
// A.12 GeefAlleBulletins
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleBulletins',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefAlleBulletins',
'Status' => 'TRUE',
'Message' => 'Bulletins opgevraagd',
'bulletins' => $bulletins);

// ** t.b.v. Joomla module Bas
// A.13 ExpandeerPostcode
// (geen authenticatie)
$request = xmlrpc_encode_request(
'ExpandeerPostcode',
array(
'postcode' => $postcode,
'huisnummer' => $huisnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'ExpandeerPostcode',
'Status' => 'TRUE',
'Message' => 'Postcode opgevraagd',
'detailgegevens' => $detailgegevens);

// ** t.b.v. Joomla module Bas
// A.25 UpdateNAW
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateNAW',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'geslacht' => $geslacht,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'toevoeging' => $toevoeging,
'straat' => $straat,
'woonplaats' => $woonplaats,
'landcode' => $landcode,
'email' => $email,
'voornaam' => $voornaam,
'voorletters' => $voorletters,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateContactGegevens',
'Status' => 'TRUE',
'Message' => 'Contactgegevens bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.18 NormaliseerTelefoon
// (geen authenticatie)
$request = xmlrpc_encode_request(
'NormaliseerTelefoon',
array(
'hccLand' => $hccLand,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'NormaliseerTelefoon',
'Status' => 'TRUE',
'Message' => 'Telefoonnummer genormaliseerd',
'Telefoonnummer' => $Telefoonnummer);

// ** t.b.v. Joomla module Bas
// A.20 UpdateMobiel
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateMobiel',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateMobiel',
'Status' => 'TRUE',
'Message' => 'Mobiel nummer bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.21 HaalIGBedragenOp
// Geef alle IG's waar je zelf lid van kunt worden, inclusief het bijbehorende bedrag
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalIGBedragenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalIGBedragenOp',
'Status' => 'TRUE',
'Message' => 'Interessegroepen en bedragen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.22 HaalTariefGroepenOp
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalTariefGroepenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalTariefGroepenOp',
'Status' => 'TRUE',
'Message' => 'Tariefgroepen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.23 PasInteressegroepAan
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasInteressegroepAan',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
['nieuw' => $IG_lijst_nieuw,]
['weg' => $IG_lijst_weg,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'PasInteressegroepAan',
'Status' => 'TRUE',
'Message' => 'IG keuzen aangepast');

// ** t.b.v. Joomla module Bas
// A.24 GeefSSOUrls
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefSSOUrls',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefSSOUrls',
'Status' => 'TRUE',
'SSO_urls' => $sso_urls,
'Message' => 'Single Sign On URLs opgevraagd');

// ** t.b.v. de verenigingszaken beheer pagina **
// A.26 Verwijder een niet-lid record
$request = xmlrpc_encode_request(
'VerwijderNietLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'hccLidnr' => $hccLidnummer, // het te verwijderen niet-lid nummer
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

Output positief:
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'TRUE',
'Message' => 'Niet-lid record verwijderd',

Output negatief:
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'FALSE',
'Message' => 'Niet-lid record niet gevonden');
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** HenZ **
// ** t.b.v. daily cron job **
// ** t.b.v. dagelijkse opschoon jobs Joomla template sites **
// C.1 Vraag de lijst met uitgeschreven leden op
// Dit kan beperkt worden tot een bepaalde regio of interessegroep
// Daarnaast kan het tijdvak waarin gezocht wordt vrij gekozen worden
// (gesteld dat de LDAP database nog leden uit die periode bevat)
// Antwoord: lijst met (lidnummer, hccLogin, sn,
// datum einde lidmaatschap (formaat:YYYYMMDD))

==> GeefUitgeschrevenLeden <== (oud: GeefOpgezegdeLeden)

$request = xmlrpc_encode_request(
'GeefUitgeschrevenLeden',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccRegio' => $hccRegio, // of leeg
'hccIg' => $hccIg, // of leeg
'datum_vanaf' => $datum_sinds, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: 3 dagen geleden)
'datum_tot' => $datum_tot, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: vandaag)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'TRUE',
'Message' => 'Uitgeschreven leden',
['hccRegio' => $hccRegio,]
['hccIg' => $hccIg,]
['datum_vanaf' => $datum_vanaf,]
['datum_tot' => $datum_tot,]
['Results' => array(
[array(
'hccLogin' => $hccLogin,
'hccLidNummer' => $hccLidnummer,
'sn' => $sn,
'DatumEindeLidmaatschap' => $DatumEindeLidmaatschap)]*);
Output negatief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');
</pre>
===HCCpartner aanroepen===
(interface versie 1)

(oude interface, niet meer gebruiken!)<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.1 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartner',
array('ControleerHCCLidmaatschap',
array('partnerLogin', $partnerLogin),
array('partnerPassword', $partnerPassword),
array('hccLidnummer', $hcclidnummer),
array('postcode', $postcode)));
Output positief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'TRUE'));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'));
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'),
array('Message', 'Onjuiste credentials'));

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartner',
array(
'OnbekendeAanroep',
array('parameter', $iets)));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'OnbekendeAanroep'),
array('Status', 'FALSE'),
array('Message', 'Opdracht onbekend'));
</pre>
===HCCpartners aanroepen ===
(interface versie 2)<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.2 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'ControleerHCCLidmaatschap',
'partnerLogin' => $partnerLogin,
'partnerPassword' => $partnerPassword,
'hccLidnummer' => $hcclidnummer,
'postcode' => $postcode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'TRUE',
['ExtraInfo' => 'groepering=$groepering']); // als de partner beperkt is tot 1 groepering
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE');
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'OnbekendeAanroep',
'parameter' => $iets));
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'OnbekendeAanroep',
'Status' => 'FALSE',
'Message' => 'Opdracht onbekend');
</pre>
===HCC-kader aanroepen===
<pre>
// ** beheer.hcc.nl **
// F.2 Controleer of dit een kaderlid is
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'IsKaderLid',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'TRUE',
'Message' => 'Is kaderlid',
'hccLidnr' => $hccLidnr,
'cn' => $cn,
'sn' => $sn,
'hccRol' => $hccRol,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward);
Output negatief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Is geen kaderlid');

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.4 Vraag alle groeperingen op
// Het is mogelijk om een groepering te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// ToonInOverzichtenFilter : attribuut 'hccToonInOverzichten'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// BulletinsFilter : attribuut 'hccBulletins'
// EmailFilter : attribuut 'hccFunctionalEmail'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleGroeperingen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['ToonInOverzichtenFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['BulletinsFilter' => '' | 'TRUE',]
['EmailFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE'));
Output positief:
$reply = array(
'Action' => 'GeefAlleGroeperingen',
'Status' => 'TRUE',
'Message' => 'Lijst met groeperingen opgevraagd',
'Result' => $groeperingen,
['JoomlaFilter' => 'TRUE',]
['ToonInOverzichtenFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']);

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.5 Vraag alle kaderrollen op
// Het is mogelijk om een kaderrol te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleKaderRollen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']));
Output positief:
$reply = array(
'Action' => 'GeefAlleKaderRollen',
'Status' => 'TRUE',
'Message' => 'Lijst met kaderrollen opgevraagd',
'Result' => $kaderrollen,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']);

// ** t.b.v. de kantoor-beheerpagina **
// F.9 Geef de gevevens van de mailbox van dit kaderlid
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
$request = xmlrpc_encode_request(
'GeefKadermailGegevens',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer));
Output positief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'kadermail_omvang' => $Formaat,
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald);
Output negatief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid'));

// ** t.b.v. de Joomla Kadernet module **
// * F.10 MuteerGroeperingSamenstelling
// (authenticatie op basis van lidnummer, JoomlaToken en siteID en als extra hccCode van de aanvrager)
$request = xmlrpc_encode_request(
'MuteerGroeperingSamenstelling',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccCode' => $hccCode,
'groepering' => $groepering,
'hccLidnummer => $hccLidnummer, // lidnummer van het te muteren hcc lid
'hccRol' => $hccRol, // de nieuwe dan wel op te heffen rol
// de rol 'ALLES_WEG' ruimt alle rollen van dit hcc lid voor deze groepering op
'actie' => 'Nieuw' | 'Weg',
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress,]
Output positief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'TRUE',
'Message' => 'Groepering samenstelling aangepast',
['ExtraInfo' => 'Bedankmail gestuuurd aan ex-kaderlid']);
Output negatief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid' |
'Oude rol niet gevonden' |
'Nieuwe rol kan niet samen met bestaande rol' |
'Alleen voorzitter of secretaris kan kadermutaties uitvoeren']);
</pre>
===HCC-groepering aanroepen===
<pre>

// I.2 controleer of een gebruiker bestaat op basis van de combinatie
// lidnummer + postcode + huisnummer
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
// (alternatieve authenticatie mogelijk door lidnummer + hcc-code in te vullen)
//
// Aan de aanroeper worden zekere eisen gesteld:
// * dient een rol te vervullen binnen de groepering 'FOR'(forum)
// * dan wel dient de rol 'VRBK' (vraagbaak) te vervullen binnen een groepering
//
// Er wordt door de gehele leden-database gezocht, waarna terug wordt gegeven
// * of dit hcc lid inderdaad bestaat
// en, als het om een aanvraag van een vraagbaak vrijwilliger gaat,
// * tevens of het gezochte hcc lid deel uitmaakt van zijn groepering
//
// ==> Mag weg: laatste aanroep 2018.07.27 <==
//
$request = xmlrpc_encode_request(
'IsHCCLid',
array(
'hccLogin' => [$hccLogin | $hccLidnummer],
'userPassword' => [$userPassword | $hccCode],
'zoekhccLidnr' => $zoekhccLidnr,
'zoekhccPostcode' => $zoekhccPostcode,
'zoekhccHuisnr' => $zoekhccHuisnr,
'zoekgroepering' => $zoekgroepering));
Output positief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gecontroleerd',
['Groeperingslid' => $IsGroeperingLid]));
Output negatief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker bestaat niet' |
'Onjuiste credentials' |
'Wel HCC lid, maar geen lid van groepering $groepering' |
'Onvoldoende rechten' |
'Vul alle verplichte velden in!'));
</pre>
===HenZ aanroepen===
<pre>

// I.3 Geef de einddatum van een actief dan wel uitgeschreven lid
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'GeefhccEindDatum',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'TRUE',
'hccLidnummer' => $hccLidnummer,
'hccLogin' => $hccLogin,
'hccEindDatum' => $hccEindDatum ('yyyymmdd' | ''));
Output negatief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Invalid credentials' |
'Lidnummer niet gevonden');
</pre>
===(Forum,vraagbaak) onderwerpen===
<pre>
// L.1 MaakOnderwerp
$request = xmlrpc_encode_request(
'MaakOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'description' => $description,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp is aangemaakt',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster');

// L.2 VerwijderOnderwerp

$request = xmlrpc_encode_request(
'VerwijderOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'TRUE',
'onderwerp' => $onderwerpID,
'Message' => 'Onderwerp is verwijderd',
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Ruim eerst alle geautoriseerde gebruikers op' |
'Kan onderwerp niet verwijderen');

// L.3 GeefOnderwerpen
// Geef het array met de lijst van onderwerpen voor de betreffende groepering
//
$request = xmlrpc_encode_request(
'GeefOnderwerpen',
array(
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'TRUE',
'Message' => 'Onderwerpen opgevraagd',
'onderwerpen' => $onderwerpen); // het array met onderwerpen
Output negatief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!');

// L.4 MuteerOnderwerp
// Pas de description van een onderwerp aan
//
$request = xmlrpc_encode_request(
'MuteerOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'description' => $description,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp aangepast',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Onderwerp behoort bij andere groepering');

// L.5 MuteerOnderwerpAutorisatie
// Geef kaderlid $kaderLidNr de autorisatie MOD, VRBK of RED bij onderwerp $onderwerp
// (of haal die autorisatie weg)
$request = xmlrpc_encode_request(
'MuteerOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'onderwerp' => $onderwerpID,
'kaderLidNr' => $kaderLidNr,
'hccAutorisatie' => 'MOD' | 'VRBK' | 'RED',
['verwijder' => 'TRUE']));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Onderwerp autorisatie aangepast');
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Geen kaderlid' |
'Onjuiste autorisatie opgegeven' |
'Onderwerp bestaat niet');

// L.6 ToonOnderwerpAutorisatie
$request = xmlrpc_encode_request(
'ToonOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Autorisaties opgehaald',
'onderwerp' => $onderwerpID,
'description' => $description,
'autorisaties' =>
[Array(
'hccLidnummer' => $hccLidnummer
'cn' => $cn
'hccAutorisatie' => {komma-gescheiden autorisaties})]);
Output negatief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet');
</pre>
===Microsoft Dynamics Cloud (Cayentis) onderwerpen ===
<pre>
// M.1 Upload_CSV_bestand
// De CRM proxy upload de dagelijkse CSV synchronisatie-bestanden naar de XML-RPC server
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Upload_CSV_bestand',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'CSV_bestand_type' => '1' | '2' | '3' , // 1=Contactpersonen/Hoofdlidmaatschappen
// 2=Gremiumlidmaatschap codes
// 3=Gremiumlidmaatschappen
'CSV_bestand' => $CSV_bestand)); // het CSV bestand (base64 encoded)
Output positief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'TRUE',
'Message' => 'Bestand opgeslagen');
Output negatief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.2 SchrijfNieuwLidIn
//
// Maak in het CRM een nieuw HCC lid aan
// De NAW gegevens worden in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'SchrijfNieuwLidIn',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'NAWgegevens' => $NAW_Array,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress);
// $NAW_array = array(
// 'GeboorteDatum' => $geboortedatum,
// 'Geslacht' => $geslacht,
// 'Voornaam' => $voornaam,
// 'Voorletters' => $voorletters,
// 'Tussenvoegsel' => $tussenvoegsel,
// 'Achternaam' => $achternaam,
// 'Straatnaam' => $straatnaam,
// 'Huisnummer' => $huisnummer,
// 'HuisnummerToevoeging' => $huisnummertoevoeging,
// 'Woonplaats' => $woonplaats,
// 'Postcode' => $postcode,
// 'Land' => $land,
// 'Telefoonnummer' => $telefoonnummer,
// 'MobielNummer' => $mobielnummer,
// 'Mail' => $mail,
// 'IBAN' => $IBAN,
// 'Interessegroep' => $IGs, // komma-gescheiden lijst met IG's
// 'Geschenk' => $geschenk,
// 'Actiecode' => $actiecode,
// 'Voorwaarden' => $Akkoord); // 'Akkoord'
)
Output positief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'TRUE',
'Message' => 'nieuw lid ingeschreven',
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode);
Output negatief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.3 Verwerk_JSON_mutatie
// De CRM proxy kan NAW en/of IG mutaties en/of hccCode mutaties live doorgeven
// Deze gegevens worden in JSON in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Verwerk_JSON_mutatie',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'mutatie_type' => '1' | '2', // 1=Contactpersoon/Hoofdlidmaatschap
// 2=Gremiumlidmaatschap
'JSON_mutatie' => $JSON_mutatie)); // de JSON payload
Output positief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'TRUE',
'Message' => 'Mutatie verwerkt');
Output negatief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.4 Vertaal landcode
// Het CRM werkt met numerieke landcodes, wij met cijfers
// Vertaal die
// Er moet in de aanroep 1 veld aanwezig zijn, beide waarden komen in het antwoord terug
$request = xmlrpc_encode_request(
'ISO_landcode',
array(
['ISO_numeriek' => $ISO_numeriek,]
['ISO_code ' => $ISO_code]));
Output positief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'TRUE',
'Message' => 'ISO code lookup geslaagd',
'ISO_numeriek' => $ISO_numeriek,
'ISO_code ' => $ISO_code,
'ISO_benaming' => $ISO_benaming); // de descriptive name van deze ISO code
Output negatief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'FALSE',
'Message' => 'Kan geen bijpassende vertaling vinden'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');
</pre>// M.5 MuteerAanmeldingsformulier // Sla een JSON veld op in de XML-RPC server zodat deze weer opgehaald kan worden door de websites // Authenticatie op basis van hccLidnummer en JoomlaToken // Deze mutaties mogen alleen door HN#WM of SITE#WM gedaan worden.
$request = xmlrpc_encode_request(
MuteerAanmeldingsformulier,
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
'formulierdata' => $formulierdata, // JSON veld met alle gegevens voor het aanmeld formulier
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress ));
Output positief:
$reply = array(
'Action' => 'MuteerAanmeldingsformulier',
'Status' => 'TRUE',
'Message' => 'aanmeldingsformulier bijgewerkt';
// M.6 HaalAanmeldingsformulier // (geen authenticatie)
$request = xmlrpc_encode_request(
HaalAanmeldingsformulier,
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalAanmeldingsformulier',
'Status' => 'TRUE',
'formulierdata' => $formulierdata); // JSON veld met alle gegevens voor het aanmeld formulier
// M.7 GeefFactuurOverzicht // (authenticatie op basis van hccLidnummer + JoomlaToken + siteID
$request = xmlrpc_encode_request(
GeefFactuurOverzicht,
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefFactuurOverzicht',
'Status' => 'TRUE',
'FactuurOverzicht' => $FactuurOverzicht);
// $FactuurOverzicht =
// array(
// array(
// 'FactuurID' => 'a5b93460-4536-ea11-a813-000d3a2c53fa',
// 'FactuurNummer' => '200118673J5'
// 'FactuurDatum' => '2020-01-15'
// 'bedrag' => 42.37
// 'BetaalStatus' => 0]));
//
// M.8 HaalFactuur // (authenticatie op basis van JoomlaToken of FactuurToken)
$request = xmlrpc_encode_request(
HaalFactuur,
array(
'hccLidnummer' => $hccLidnummer,
['JoomlaToken' => $JoomlaToken,]
['FactuurToken' => $FactuurToken,]
'FactuurNummer' => $FactuurNummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalFactuur',
'Status' => 'TRUE',
'factuur' => $factuurgegevens);
// $factuurgegevens = // array( // 'FactuurNummer' => $FactuurNummer, // 'FactuurDatum' => $FactuurDatum, // 'FactuurID' => $FactuurID, // 'Bestandsnaam' => $Bestandsnaam, // 'PDF' => $PDF) // base64 encoded PDF
===Echo test ===
<pre>

// t.b.v. controle of de verbinding met de XML-RPC server functioneert
// Eenvoudige echo test

$request = xmlrpc_encode_request(
'echo',
array(
'What' => $string,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'echo',
'Status' => 'TRUE',
'Message' => $string);
</pre>
===HenZ XML-RPC interface===
Overzicht van XML-RPC procedures die bij HenZ draaien (worden via de Hobbynet XML-RPC server afgehandeld)<pre>
- Action=2
wijzig gebruikersnaam en wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=3
controleer of een gebruikersnaam bestaat
(XML-RPC server voert de hccnet XML-call uit, zie 8.2)

- Action=4
creer een nieuwe gebruiker. Per lidnummer is er 1 account. Als er al een
account voor dit lidnummer bestaat wordt het bestaande account hernoemd.
(XML-RPC server voert de hccnet XML-call uit, zie 8.1)

- Action=5
wijzig wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=7
Uitgeschreven lid is weer actief lid geworden
(Wordt aangeroepen vanuit de cronjob)

- Action=8
Lid heeft een nieuwe hcc-code gekregen
(Wordt aangeroepen vanuit de cronjob)
</pre>
===Release notes===
<pre>
2012.02.08 Wijzigingen versie 5:
- 4.1 verwijder_hcc_Lidnummer i.p.v. hcc_Lidnummer
- 4.1 optionele extra parameter verwijder_hccLogin
- Optionele parameters aangegeven
- Vanwege de duidelijkheid de beheerLogin en beheerPassword velden
bovenin de betreffende aanroepen gezet
(De volgorde van de parameters is niet relevant, dus dit is geen
interface-aanpassing)
2012.02.16 Wijzigingen versie 6:
- 2.1/2.2/2.3 geef ook cn en sn terug na aanpassen van het wachtwoord
- 3.1 geef cn en sn terug na aanmaken nieuwe gebruiker
2012.02.27 Wijzigingen versie 7:
- Neem de XML-RPC interface van HenZ in deze XML-RPC server op
8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gegevens tevens in LDAP op
- 2.1 wijzig wachtwoord - optie 1
* Nieuw wachtwoord is verplicht, niet optioneel
* wijzigingen worden naar hccnet.nl doorgezet
- 2.2 wijzig wachtwoord, optie 2
* Nieuw wachtwoord is verplicht, niet optioneel
* gebruikersnaam kan niet meer via deze interface aangepast worden
* wijzigingen worden naar hccnet.nl doorgezet
- 2.3 wijzig wachtwoord, optie 3
* wijzigingen worden naar hccnet.nl doorgezet
2012.03.26 Wijzigingen versie 8:
- Breidt de XML-RPC interface van HenZ in deze XML-RPC server uit met
8.2 Controleer of de gebruikersnaam op dit moment bestaat
2012.04.09 Wijzigingen versie 9:
- Vervang alle 'ldap' aanroepen door 'HCCldap' aanroepen
- documentatie van HenZ call action=2 aangepast, action=5 toegevoegd
2012.05.03 Wijzigingen versie 10:
- 1.1 / 1.2 / 1.3 geven nu ook 'ProfielBekend' terug om uniek te bepalen
of deze bezoeker een first-time-login pagina te zien dient te krijgen
- documentatie van 2.1 (wijzig wachtwoord) aangepast:
2.1 kan alleen als profiel is doorlopen
- nieuwe procedure t.b.v. zoekscherm PC30
* A.1 ZoekHCCLid
- hiervoor is de database met diverse velden uitgebreid
(postcode, e-mailadres, huisadres, woonplaats, land, telefoonnummer)
Dit heeft impact op diverse andere procedures (t.b.s.)
- nieuwe procedure t.b.v. 'gewone' profielpagina
* B.1 GeefDBFPersoonID
- nieuwe procedure t.b.v. cron-job
* C.1 GeefOpgezegdeLeden
2012.05.10 Wijzigingen versie 11
- 1.3 GebruikerBestaatControle
* nieuwe parameter: hccPseudoniem
* nieuw veld in antwoord: hccPseudoniem
- 2.3 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 2.4 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 3.1 NieuweGebruiker
* nieuwe parameter: hccPseudoniem
- 8.1 MaakGebruikerAan
* nieuwe parameter: nieuw_hccPseudoniem
* alle parameters zijn verplicht (niet langer optioneel)
* nieuw antwoord: Gegevenscombinatie onjuist
- 8.3 IsDezePseudoniemNogBeschikbaar
* Nieuwe procedure t.b.v. 1e keer doorlopen profielpagina
- A.1 ZoekHCCLid
* 'Zoeklimiet bereikt' wordt als ExtraInfo meegegeven
* nieuwe velden in antwoord: hccPseudoniem en hccLogin
- B.1 GeefDBFPersoonID
* Zoeken kan nu ook op hccLogin en op hccPseudoniem
- C.1 GeefOpgezegdeLeden
* Geef nu ook hccLogin en hccPseudoniem terug
2012.05.14 Wijzigingen versie 12
- 1.x GebruikerBestaatControle
* Geef ook DBFPersoonID terug
- 4.1 Gooi een gebruiker weg.
* Haal ongebruikte parameter hccLogin weg
- 5.1 Wijzig hccIG
* Haal ongebruikte parameter hccLogin weg
- 6.1 Wijzig hccRegio
* Haal ongebruikte parameter hccLogin weg
- 7.1 Wijzig hccRol
* Haal ongebruikte parameter hccLogin weg
2012.05.20 Wijzigingen versie 13
- A.1 ZoekHCCLid
* Geef resultaten gestructureerder formaat
* Geef in ExtraInfo weer hoeveel echte resultaten er gevonden zijn
- C.1 GeefOpgezegdeLeden
* Geef resultaten in gestructureerder formaat
2012.06.03 Wijzigingen versie 14
- 3.1 NieuweGebruiker
* Geef ook DBFPersoonID mee
2012.08.17 Wijzigingen versie 15
- C.1 GeefOpgezegdeLeden
* Geef ook hccLogin in het antwoord terug
- D.1 HCCpartner/ControleerHCCLidmaatschap
* Nieuwe aanroep
2012.09.29 Wijzigingen versie 16
- Alle cron gerelateerde opdrachten verwijderd
* 3.1 NieuweGebruiker
* 4.1 GooiGebruikerWeg
* 5.1 WijzigHccIG
* 6.1 WijzigHccRegio
* 7.1 WijzigHccRol
2012.10.28 Wijzigingen versie 17
- nieuwe procedure t.b.v. PC30 beheerpagina
* A.2 HaalPC30Token
- nieuwe procedure t.b.v. Drupal profielpagina
* 2.4 vervallen
(WijzigGebruikersGegevens op basis van pseudoniem)
* 2.5 WijzigGebruikersGegevens
Nieuwe keuze: wijzig pseudoniem
2012.11.14 Wijzigingen versie 18
- 1.x GebruikerBestaatControle
* Geef ook mail in het antwoord terug
2012.11.30 Wijzigingen versie 19
- E.1 HCCkader/WijzigGebruikersGegevens
* Nieuwe aanroep
- F.1 / F.2 / F.3 ControleerKaderlid
* Nieuwe aanroep
2012.12.18 Wijzigingen versie 20
- Haal DBFPersoonID weg uit alle aanroepen en alle resultaten
* Antwoord van 1.x GebruikerBestaatControle
* B.1 GeefDBFPersoonID opgeheven
- A.1 ZoekHCCLid geeft nu ook hccMobiel terug (t.b.v. PC30 zoekpagina)
- C.1 GeefOpgezegdeLeden verder uitgewerkt:
* Geeft alleen de door Drupal gebruikte velden 'hccLogin' en 'hccEindDatum'
terug in het antwoord
* Geeft nu 'echte' antwoorden i.p.v. dummy resultaten
- F.1 ControleerKaderlid geeft nu ook optioneel 'sn' en 'givenName'
terug (in de beheer-variant)
2013.01.25 Wijzigingen versie 21
- A.1 ZoekHCCLid uitgebreid
* Geeft nu ook hccBeginDatum, hccEindDatum en hccRol terug
2013.02.02 Wijzigingen versie 22
- A.1 ZoekHCCLid
* Interface aangepast
- A.3 ZoekGroeperingsLid
* Nieuwe aanroep
- F.4 GeefAlleGroeperingen
* Nieuwe aanroep
- F.5 GeefAlleKaderRollen
* Nieuwe aanroep
2013.03.01 Wijzigingen versie 23
- A.3 ZoekGroeperingsLid
* Geeft andere resultaten terug
- 2.2 WijzigWachtwoord
* Geeft nu ook hccLogin terug (voor ww-vergeten op de Drupal site)
- HCCenquete implementatie
* G.1 Expandeer NL postcode
* G.2 Haal lidgegevens op
* G.3 Pas lidgegevens aan
2013.03.18 Wijzigingen versie 24
- ZoekGroeperingsLid op basis van token
- A.4 Lid bezoekt bijeenkomst
* nieuwe aanroep
- A.5 VraagLidgegevensTokenAan
* nieuwe aanroep
2013.04.07 Wijzigingen versie 25
- D.1 HCCpartner/ControleerHCCLidmaatschap
Simpeler interface ontwikkeld ('HCCpartners' i.p.v. 'HCCpartner')
- G.3 mag ook Tussenvoegsels aanpassen
2013.04.25 Wijzigingen versie 26
- H.1 HCC-groepering / GebruikerBestaatControle
Nieuwe interface voor validatie vanaf groeperings websites
2013.05.03 Wijzigingen versie 27
- 2.6 HaalOptInKeuzen
* nieuwe aanroep
- 2.7 SchrijfOptInKeuzen
* nieuwe aanroep
- 2.8 HaalOptInLijst
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* nieuwe aanroep
- HCCpartners aanroep nieuwe interface ('Action' => 'ControleerHCCLidmaatschap')
2013.07.05 Wijzigingen versie 28
- 8.1 MaakGebruikerAan
* extra parameters (mail, hccPseudoniem) in het antwoord
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra parameter (mailHccnet)
- A.1 ZoekHCCLid
* extra parameter (mailHccnet)
- A.3 ZoekGroeperingsLid
* extra parameter (mailHccnet)
2013.08.31 Wijzigingen versie 29
- F.1 / F.2 / F.3 HCC-kader / ControleerKaderlid
* extra output parameter (hccKaderMail)
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra output parameter (hccForumLogin)
- H.1 HCC-groepering / GebruikerBestaatControle
* komma-gescheiden lijst met groeperingen mogelijk
* extra output parameter (mailHccnet)
2013.12.26 Wijzigingen versie 30
- 3.1 Geef mijn lidnummer
* nieuwe aanroep
- A.1 ZoekHCCLid
* geef nu ook 'ProfielBekend' terug om aan de PC30 omgeving door te geven
dat het wachtwoord niet veranderd mag worden door PC30
- A.6 GeefBezoekersOverzicht
* geef nu ook 'Locatie' terug indien van toepassing
- A.7 GeefLocaties
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* parameters aangepast
* authenticatie op basis van hccLogin + userPassword of lidnummer + hcc-code
* geen algemene hcc-forum authenticatie meer mogelijk
- F.7 ControleerKaderlidGroep
* Nieuwe aanroep
2014.02.01 Wijzigingen versie 31
- A.8 RegistreerGast
* nieuwe aanroep
- H.2 MatchPostcodeMetRegio
* nieuwe aanroep
- nieuwe interface (losse, unieke aanroepen, niet meer gegroepeerd)
2014.09.27 Wijzigingen versie 32
- C.1 GeefOpgezegdeLeden hernoemd naar GeefUitgeschrevenLeden
- I.3 GeefhccEindDatum
* nieuwe aanroep
- Action=7 en Action=8 toegevoegd aan de HenZ interface
2014.12.12 Wijzigingen versie 33
- F.1 / F.2 / F.3 HCC-kader / IsKaderLid
* extra output parameter (mail, mailHccnet, hccKaderForward)
- F.8 HCC-kader / ZetKaderForward
* nieuwe aanroep
2015.05.06 Wijzigingen versie 34
- GeefMijnGegevens
* nieuwe aanroep
- ValideerPCActiveAbonnee
* vervallen
- 1.4 GebruikerBestaatControle
* extra output parameter (hccKaderForward)
- D.1 HCCpartner/ControleerHCCLidmaatschap
* optionele extra output parameter (ExtraInfo)
2015.09.27 Wijzigingen versie 35
- HeeftForumCredentials
* vervallen
2015.11.20 Wijzigingen versie 36
- SchrijfNietlidInOpBulletin
* nieuwe aanroep
2015.12.13 Wijzigingen versie 37
- serverID als optionele parameter
- SchrijfNietlidInOpBulletin
* Maak velden optioneel
2016.01.05 Wijzigingen versie 38
- A.7 GeefLocaties
* optionele parameter JoomlaFilter
- F.4 GeefAlleGroeperingen
* optionele parameter JoomlaFilter
- F.5 GeefAlleKaderRollen
* optionele parameter JoomlaFilter
2016.01.15 Wijzigingen versie 39
- H.3 GeefMijnGegevens
* geeft nu ook hccOptIn terug
* geeft nu ook JoomlaToken terug
- H.4 PasOptInKeuzeAan
* nieuwe aanroep
- SiteID en RemoteID als optionele parameter
2016.03.17 Wijzigingen versie 40
- H.5 ZoekKaderLeden
* nieuwe aanroep
2016.03.20 Wijzigingen versie 41
- ServerID, SiteID en RemoteID als optionele parameters bij alle aanroepen
- A.7 GeefLocaties
* optionele parameter KadernetFilter
- A.9 GeefLocatieNamen
* optionele parameter KadernetFilter
- F.4 GeefAlleGroeperingen
* optionele parameter KadernetFilter
- F.5 GeefAlleKaderRollen
* optionele parameter KadernetFilter
- F.6 WijzigHccRol
* vervallen
- F.7 IsGroeperingsKaderlid
* vervallen
- 8.3 IsDezePseudoniemNogBeschikbaar
* vervallen
- 2.7 SchrijfOptInKeuzen
* vervallen
- 2.5 WijzigGebruikersGegevens (hccPseudoniem)
* vervallen
- H.2 MatchPostcodeMetRegio
* vervallen
2016.04.02 Wijzigingen versie 42
- H.6 GeefMijnKaderDetails
* nieuwe aanroep
2016.07.03 Wijzigingen versie 43
- Ubuntu 16.04 aanpassingen (PHP versie 7) beschreven
2016.09.01 Wijzigingen versie 44
- H.5 ZoekKaderLeden
* extra parameter 'hccMobiel'
2016.10.13 Wijzigingen versie 45
- H.3 GeefMijnGegevens (dedecated Joomla aanroep)
* hccForumLogin weg als parameter
* Als het om een webmaster gaat, vul dan eventueel hccRegio of hccIG aan
met die groepering, ook als hij geen lid is van die groepering
- I.4 GebruikerBestaatControle
* hccForumLogin weg als parameter
2016.12.01 Wijzigingen versie 46
- 8.3 IsDezePseudoniemNogBeschikbaar teruggezet
2017.05.28 Wijzigingen versie 47
- H.7 GeefMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
- H.8 ZetMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
2017.09.01 Wijzigingen versie 48
- A.10 SchrijfNietlidInOpBulletin nu alleen voor 1 bulletin tegelijk
- 2.2 WijzigGebruikersGegevens (op basis van gebruikersnaam en wachtwoord)
is vervallen (was een oude Drupal aanroep)
- A.3 ZoekGroeperingsLid geeft ook hccKaderToonMobiel terug
- H.7 GeefMinimaleKaderGegevens geeft ook hccKaderToonMobiel terug
2017.11.14 Wijzigingen versie 49
- A.3 ZoekGroeperingsLid geeft geen hccKaderToonMobiel meer terug
- A.3 ZoekGroeperingsLid geeft alleen hccMobiel als hccKaderToonMobiel dat toestaat
2018.02.18 Wijzigingen versie 50
- H.6 GeefMijnKaderDetails geeft ook hccKaderToonMobiel terug
- H.9 PasKaderGegevensAan
* nieuwe aanroep
- H.3 GeefMijnGegevens geeft 3 extra parameters terug (hccKaderMail, hccKaderForward,
hccKaderToonMobiel)
- JoomlaTokens worden gevalideerd op siteID, niet langer op serverID
- diverse aanroepen kunnen nu ook via de bezoekersregistratie-proxy aangeroepen worden.
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
(GeefAlleGroeperingen, GeefAlleKaderRollen, GeefLocaties, GeefLocatieNamen)
De bezoekersregistratie aanroepen hebben enkel JoomlaToken als extra parameter nodig:
(LidBezoektBijeenkomst, GeefBezoekersOverzicht)
2018.02.26 Wijzigingen versie 51
- H.3 GeefMijnGegevens geeft extra parameter hccMobiel terug
- H.9 PasKaderGegevensAan kan nu ook kadermail password aanpassen
- K.1 ValideerToken
* nieuwe aanroep
- K.2 ValideerHCCCode
* nieuwe aanroep
2018.03.17 Wijzigingen versie 52
- H.3 Haal al mijn gegevens
Extra optie 'compact' om alleen essentiele resultaten te verkrijgen
(t.b.v. de Android bezoekersregistratie applicatie)
2018.03.25 Wijzigingen versie 53
- I.2 IsHCCLid
(Oude aanroep teruggezet, wordt nog in vraagbaak module gebruikt)
2018.07.01 Wijzigingen versie 54
* A.1 beheer authenticatie op basis van lidnummer + hccCode (tbv VZ-portal)
* A.2 HaalPC30Token weggehaald
2018.08.22 Wijzigingen versie 55
* 1.2 GebruikerBestaatControle' (op basis van hccLogin en userPassword) weggehaald
* 1.4 GebruikerBestaatControle' (op basis van zoekHccLogin of zoekHccLidnr) weggehaald
* 2.8 HaalOptInLijst weggehaald
* E.1 PasKaderWachtwoordAan weggehaald
* F.1 IsKaderLid (op basis van hccLidnr en hccCode) weggehaald
* F.3 IsKaderLid (op basis van beheerdernaam en beheerderwachtwoord) was al weg
* F.8 ZetKaderForward weggehaald
* H.1 IsGroeperingsLid weggehaald
* H.6 GeefMijnKaderDetails weggehaald
* H.7 GeefMinimaleKaderGegevens weggehaald
* H.8 ZetMinimaleKaderGegevens weggehaald
* K.1 ValideerHCCCode weggehaald
* K.2 ValideerToken weggehaald
* H.3 GeefMijnGegevens geeft omvang kader mailbox mee terug
2018.11.06 Wijzigingen versie 56
Nieuwe aanroepen t.b.v. forum en vraagbaak autorisaties
* L.1 MaakOnderwerp
* L.2 VerwijderOnderwerp
* L.3 GeefOnderwerpen
* L.4 MuteerOnderwerp
* L.5 MuteerOnderwerpAutorisatie
* L.6 ToonOnderwerpAutorisatie
* H.5 ZoekKaderLeden heeft compact optie
2018.11.16 Wijzigingen versie 57
* L.5 MuteerOnderwerpAutorisatie kent nu ook RED(acteur)
2018.12.17 Wijzigingen versie 58
* A.11 GeefBezoekersAantallen (nieuwe aanroep)
* H.10 PasUserWachtwoordAan (nieuwe aanroep)
2019.02.21 Wijzigingen versie 59
* A. 6 GeefBezoekersOverzicht geeft enkel lijst van bezoekers laatste bijeenkomst
2019.10.26 Wijzigingen versie 60
* A.4 Schrijf bezoekers niet meer automatisch in op bulletins
* H.4 PasOptInKeuzeAan kan ook door LA aangeroepen worden
Nieuwe aanroepen t.b.v. eigen implementatie van mijn.hcc.nl in de Joomla modules
* H.11 PasPseudoniemAan
* H.12 ValideerWachtwoordEisen
* H.13 PasWachtwoordAan (1: op JoomlaToken, 2: op PWResetToken)
* H.14 MaakPWResetToken
* H.15 ValideerPWResetToken
* H.16 RuimJoomlaTokenOp
* A.12 GeefAlleBulletins
* A.13 ExpandeerPostcode
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.18 NormaliseerTelefoon
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
* A.21 HaalIGBedragenOp
* A.22 HaalTariefGroepenOp
* A.23 PasInteressegroepAan
* F.10 MuteerGroeperingSamenstelling
* A.24 GeefSSOUrls
Aanpassingen gemaakt aan
8.1 MaakGebruikerAan
F.5 GeefAlleKaderRollen
2020.01.04 Wijzigingen versie 61
Nieuwe aanroepen t.b.v. IDEAL betaling hobbynet abonnees
H.17 GeefAantalDomeinen
2020.01.06 Wijzigingen versie 62
Nieuwe aanroepen t.b.v. Cayentis (CRM webproxy) implementatie
* M.1 Upload_CSV_bestand
* M.2 SchrijfNieuwLidIn
* M.3 Verwerk_JSON_mutatie
* M.4 ISO_landcode
* M.5 MuteerAanmeldingsformulier
* M.6 HaalAanmeldingsformulier
* M.7 GeefFactuurOverzicht
* M.8 HaalFactuur
* A.25 UpdateNAW
Vervallen aanroepen
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
Aangepaste aanroepen
* A.23 PasInteressegroepAan
2020.03.27 Wijzigingen versie 63
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.18 ResetHCCCode
* H.19 PasHccLoginAan
2020.04.10 Wijzigingen versie 64
Nieuwe aanroepen
* A.26 VerwijderNietLid
Aanpassingen gemaakt aan
* A.1 ZoekHCCLid: nieuwe zoekoptie 'niet_leden'
Opnieuw geimplementeerd
* A.20 UpdateMobiel
2020.11.26 Wijzigingen versie 65
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.20 MaakTestLogin
Aanpassingen gemaakt aan
- H.3 GeefMijnGegevens: optionele parameter 'hccGroepering'
Het werken met een testaccount heeft impact op de volgende aanroepen:
- G.7 GeefFactuurOverzicht
- M.8 HaalFactuur
- L.1 MaakOnderwerp
- H.14 MaakPWResetToken
- F.10 MuteerGroeperingSamenstelling
- L.4 MuteerOnderwerp
- L.5 MuteerOnderwerpAutorisatie
- H.19 PasHccLoginAan
- A.23 PasInteressegroepAan
- H.9 PasKaderGegevensAan
- H.4 PasOptInKeuzeAan
- H.11 PasPseudoniemAan
- H.13 PasWachtwoordAan
- H.18 ResetHCCCode
- A.20 UpdateMobiel
- A.25 UpdateNAW
- L.2 VerwijderOnderwerp
- A.5 VraagLidgegevensTokenAan
- 2.1 WijzigGebruikersGegevens
- H.3 GeefMijnGegevens geeft extra parameter terug (testaccount)
2021.08.01 Wijzigingen versie 66
Aanpassingen gemaakt aan
- H.4 PasOptInKeuzeAan werkt nu ook op basis van OptOutToken
</pre>
=Aanpassingen aan de Apache omgeving =
==php.ini aanpassingen ==
De XML-RPC server zal 'ergens' een bestand moeten kunnen vinden met de gebruikersnamen t.b.v. het authenticeren bij de LDAP-server.

Dit bestand wordt geplaatst in de map '/usr/local/hobbynet/etc'. Om dit vanuit Apache te mogen benaderen, dient een aanpassing aan php.ini gemaakt te worden:
/etc/php5/apache2/php.ini

include_path = ".:/usr/share/php:/usr/share/pear:/usr/local/hobbynet/etc"
== Apache modules==
Nieuwe server geschikt maken voor XML-RPC gebruik
===Apache modules (PHP 7)===
Ubuntu 16.04 wordt standaard met PHP versie 7.0 uitgeleverd. De opdrachten om de modules op te halen zijn:
apt-get install php-xmlrpc
apt-get install apache2
apt-get install ldap-utils
apt-get install php-ldap
apt-get install libapache2-mod-php
==Loadbalancer akties niet naar de logbestanden schrijven==
De loadbalancer haalt zeer frequent een testbestand op (/test.txt), om te controleren of de xml-server operationeel is. Dat levert extreem veel logging op in /var/log/apache2/other_vhosts.log.

Pas de apache configuratie zo aan, dat logging van alle opvragingen vanaf de loadbalancers uitgezet wordt.
/etc/apache2/sites-enabled/xml-server

# Mark requests from loadbalancers
SetEnvIf Remote_Addr "212\.72\.227\.93" dontlog
SetEnvIf Remote_Addr "212\.72\.227\.94" dontlog
SetEnvIf Remote_Addr "172\.31\.1\.249" dontlog
SetEnvIf Remote_Addr "172\.31\.1\.250" dontlog
CustomLog ${APACHE_LOG_DIR}/access.log common env=!dontlog
=Firewall algemeen =
In de file /etc/hobby-firewall/hobby-firewall.local wordt het script '/usr/local/hobbynet/bin/gen_fw.sh' aangeroepen. Deze haalt de IP adressen op uit ldap. (.local omdat we dit ook zo doen op de webservers).

De firewall wordt 4 x per dag herstart en /etc/hobby-firewall wordt gesynchroniseerd (1-richting van lb1 naar lb2) met de volgende crontab entries:

Op lb1:
0 0 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 5 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 11 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 17 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 23 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
Op lb2:
15 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 0 * * * /etc/init.d/hobby-firewall restart >/dev/null
Het encrypted backup script is verplaatst naar '/usr/local/hobbynet/local' en hernoemd naar 'backup-encrypted.bash'. Dit is omdat deze niet mee mag worden gesynchroniseerd.

Tevens wordt 1x per dag /usr/local/hobbynet/bin gesynchroniseerd (1-richting van hcc-ldap-lb1 naar hcc-ldap-lb2)
==Aanpassingen in de firewall==
Op de server waar de XML-RPC server staat, moeten enkele firewall aanpassingen gemaakt worden.
*inkomend: sta TCP 443 toe vanaf het interne netwerk (www-prod, www-test), en vanaf eventuele andere plekken die we expliciet toe willen staan.
*inkomend: sta TCP 443 toe vanaf mijn.hcc.nl (XML-RPC aanroepen vanaf de portal)
*inkomend: sta TCP 443 toe vanaf service.hccnet.nl toe (XML-RPC aanroep GeefUitgeschrevenLeden vanuit HenZ)
*uitgaand: sta TCP 443 naar service.hccnet.nl toe (XML-RPC aanroepen naar HenZ)
*uitgaand: sta TCP 990 en 5000-6000 naar Apps.HCC.local (FTPS verkeer naar de HCC server bij Hobbynet)
== Aanpassingen aan AppArmor==
Alhoewel technisch gezien dit bij slapd behoort, neem ik het toch hier op.

Als het Hobbynet certificaat in de map /disk/site/etc/ssl/hobby.nl/ wordt neergezet, dan zal apparrmor de toegang tot de certificaten blokkeren. Neem daarom in de '''local''' directory van apparmor het volgende op:
# /etc/apparmor.d/local/usr.sbin.slapd
# Site-specific additions and overrides for usr.sbin.slapd.
# For more details, please see /etc/apparmor.d/local/README.
#include <abstractions/ssl_certs>
/disk/site/etc/ssl/hobby.nl/ r,
/disk/site/etc/ssl/hobby.nl/* r,
=CRM (Azure) proxy herstarten =
Als er indicaties zijn dat niet alle JSON berichten meer vanuit het CRM aangeboden worden aan de XML-RPC server, dan kan het helpen om de CRM proxy te herstarten
*Ga naar https://portal.azure.com/
*Login met zelfde account als voor het CRM
*Soms krijg je een popup. Die kan je weg klikken, je wilt geen rondleiding
*Klik op '''hccdyn01-aps-crm01''' voor productie en '''hccdyn01-aps-dev01''' voor test
*En dan kan je op opnieuw starten klikken.

*

MediaWikiSites

2021-04-19T12:53:57Z

Hans: aangepast aan mediawiki release 1.35.2

== Lijst met Mediawiki sites die wij bijhouden ==

* Hobbynet wiki (https://wiki.hobby.nl/)

== upgrade procedure ==
* maak met tar een backup van de wiki: 
cd /disk/site/wiki
tar -cf wiki-backup-20200830.tar www
bzip2 wiki-backup-20200830.tar

* maak met phpmyadmin een backup van de database 

* download de wiki software upgrade van http://www.mediawiki.org/ 

* volg de instructies zoals beschreven op http://www.mediawiki.org/wiki/Manual:Upgrading 

=== Hobbynet wiki updaten ===
* Volg de instructies om de wiki te updaten
Ons eigen lijstje:

ssh hobbynet-lb1-int
cd /disk/site/hobbynet/wiki.hobby.nl
rm -rf www-old
cp -a www www-old
wget <nowiki>https://releases.wikimedia.org/mediawiki/1.35/mediawiki-1.35.2.tar.gz</nowiki>
tar xzf mediawiki-1.35.2.tar.gz
chown wiki-hobby-nl:wiki-hobby-nl mediawiki-1.35.2 -R
cp -a www-old/LocalSettings.php mediawiki-1.35.2
cp -a www-old/images/* mediawiki-1.35.2/images
cp -a www-old/getip* mediawiki-1.35.2
rm -rf www
mv mediawiki-1.35.2 www
cd www/maintenance
php update.php

Op 2020.08.30 weigerde de update correct te lopen. Bleek dat er geen skins meer waren, en de extensie WikiEditor ontbrak ook.
Pas na het terugzetten van die bestanden uit de oude omgeving wilde het update script draaien
cp -a ../../www-old/skins/MonoBook ../skins/
cp -a ../../www-old/skins/Vector/ ../skins/
cp -a ../../www-old/skins/Timeless/ ../skins/
cp -a ../../www-old/extensions/WikiEditor ../extensions/
php update.php

* Als update.php niet draait, omdat er geen sql modules beschikbaar zouden zijn, selecteer dan eerst de juiste php versie
update-alternatives --config php

* Op de hobbynet wiki staan 2 losse bestanden die geen directe relatie met de wiki software hebben ('''getip.html''' en '''getip.php'''). 
Plaats die bestanden terug, tijdens de wiki upgrade actie!

Main Page

2021-01-13T10:34:03Z

Hans: Reverted edits by 2A02:968:FFFF:999:172:31:1:103 (talk) to last revision by Bas

===Hobbynet Admin WIKI===
Shortcuts
[http://otrs.hobby.nl/ HobbyNet Ticket systeem] - OTRS
[https://nagios.hobby.nl/nagios Nagios monitoring] -[[Nagios|''' Uitleg''']]
[https://wiki.hobby.nl/getip.html Waar draait een website] - simpel tooltje om te kijken waar een website draait.

===Algemene informatie===
[[HCC!Hobbynet]] - Wat is Hobbynet - een uitleg voor kantoor (zie ook discussie tab)
[[HCC!verenigingsdag]] - Een draaiboek voor de HCC!verenigingsdag
[[Evenementen lan]] - Een draaiboek voor een Evenementen LAN
[[Kadernet]] - Info over Kadernet voorzieningen (website, forum, etc.)
[[Financien]] - Financiële aspecten van Hobbynet
[[inventaris]] - Hobbynet inventaris overzicht t.b.v. hcc kantoor
[[Windows_licenties]] - Hobbynet overzicht van de windows licenties
[[Beheerders]] - Hobbynet beheerders
[[server_certs]] - Hobbynet CAcert certificaten
[[Hobbykeys]] - Info over het hobbykeys script
[[accounts]] - Diverse account gegevens (o.a. knoppix.nl)

===HCC.NL website platform===
hcc.nl [[netwerk]] - Netwerk voor hcc.nl website platform
[[XML-RPC]] - XML-RPC interface t.b.v. LDAP
[[XML-HENZ-PROXY]] - XML-RPC HenZ proxy t.b.v. cronjob toegang tot HenZ
[[www-prod-lb*]] - Productie servers (loadbalanced)
[[Protocol_onderhoud]] - Afspraken rondom onderhoud en meldingen aan hcc.nl webmasters

===Toegang===
[[KVM over IP]] - Beheer op afstand m.b.v. KVM over IP apparatuur
[[beheerder_accounts]] - Beheerder accounts aanmaken / bijhouden
[[Aanmaken_Gebruiker]] - Aanmaken van een gebruiker
[[Opzeggen_Gebruiker]] - Opzeggen van een gebruiker

===Algemene services===
[[Backup]] - Zo backupen we
[[scp]] - Hobbynet filetransfer omgeving
[[sftp]] - Hobbynet sftp omgeving kantoor en Tripolis
[[Redirect server]] - De redirect server
[[EMAIL]] (ook postfixadmin) - Email server documentatie
[[Roundcube Webmail]] - Upgrading Roundcube
[[LDAP]] (server en client) - LDAP setup
[[LDAP login Authenticatie]] - Om op (web)servers login via LDAP te doen
[[LDAP scripting]] - Scripting die op ldap-lb1 draait
[[LDAP Administrative account]] weg! - Hoe te handelen als het administrative account opeens weg is
[[LDAP groeperings vlaggen]] - Welke vlaggen zijn er voor een groepering en waar dienen ze voor
[[SFTP server]] - sftp server voor uitwisseling met kantoor en tripolis
[[Speciale groepen in ldap en CRM]] - Speciale groepen in ldap en CRM
[[PXE]] - Hobbynet PXE omgeving
[[Web cluster]] - Beschrijving van het Web cluster
[[Nagios]] - Beschrijving van Nagios
[[Nagios_upgrade]] - Hoe upgrade ik Nagios vanuit source
[[Hobbynet repository]] - Informatie over de Hobbynet repository
[[Hobbynet repository inhoud]] - Wat zit er in de Hobbynet repository
[[Cron jobs]] - Niet standaard cronjobs die lopen bij hobbynet
[[Fail2ban]] - Block possible intruders and bots
[[Groepering_hernoemen]] - Beschrijving van het hernoemen van een groeperingsnaam
[[killdisk]] - Software voor secure wissen van disken
[[Wij jitsi server]] - HCC Jitsi server
[[VMware installatie]] - Handige hulpjes bij installatie vmware

=== nieuwe omgeving 03-11-2020 ===
[[Loadbalancers]] - Beschrijving van de Loadbalancer.org loadbalancers
[[Cephfs]] - Shared storage
[[Switches]] - Switches
[[iSCSI]] - iSCSI
[[Automatische installatie]] - Automatische installatie via iPXE
[[iPXE]] - iPXE
[[Sambabal]] - server die Samba shares verzorgt
[[VMware 1 t/m 3]] - vmware 1 t/m 3
[[VMware 4 t/m 6]] - vmware 4 t/m 6
[[Vcenter]] - Beheersomgeving VMware Vcenter
[[MySQL cluster]] - Beschrijving van het MySQL cluster

=== dns ===
[[DNS]] - DNS instellingen t.b.v. de domeinen
[[domein]] - Direct naar domein
[[ns1]] - Direct naar ns1.hobby.nl
[[ns2]] - Direct naar ns2.hobby.nl
[[ns3]] - Direct naar ns3.hobby.nl (bij TransIP)
[[ns4]] - Direct naar ns4.hobby.nl (bij TransIP)
[[Resolv*-int]] - Direct naar resolv nameserver pagina (draait op [[resolv-lb1]], [[resolv-lb2]] en [[resolv-lb3]])
[[DNSSEC ds records publiceren]] - Scripting t.b.v. het publiceren van DNSSEC DS records.
[[DNS scripting]] - Overige DNS scripting
[[DNS Zone updaten]] - een zone updaten
[[Dane]] - Dane records in dns (wat moet je doen bij nieuw ssl cert)

=== Joomla ===

[[Nieuwe joomla site maken]] - Nieuwe Joomla site maken
[[Joomla_xml_server]] - De XML-RPC-server t.b.v. de Joomla template sites
[[Joomla modules]] - Beschrijving van Joomla modules en processen er om heen
[[Joomla Events RSVP Pro]] - RSVP Pro configureren (beperk bijeenkomst tot x personen)

===Uitleg IP space===
[[netwerk]] - Netwerk tekening van Hobbynet
[[IPv4_space|IPv4]] - IPv4 Hobbynet
[[Ipv6_space|IPv6]] - IPv6 Hobbynet

===Kast indeling===
[[kasten]] - Indeling kasten bij BIT ''(pagina heeft onderhoud nodig)''
[[systems]] - Alle systemen van Hobbynet (hardware & netwerk)
[[Powerboot]] - Indeling APC PDU's (feb. 2013)

===Tuning webservers===
[[Hobby-firewall]] - de Hobbynet firewall
[[PHP via fcgi]] - PHP via fcgi en suexec
[[upg_web]] - Door middel van script server upgraden

[[NFS_settings]] - NFS poort instellingen t.b.v. iptables firewall
[[sync Loadbalanced webservers]] - dit script zorgt dat webserver configs worden gesynct
[[Entropy]] - Hoe zorg ik voor meer Entropy op vmware machine

===VPS voor derden===
[[Ubuntu-nl]] - De Ubuntu-nl virtuele server

=== Hobbynet informatie ===
[[Scripting]] - Een poging om de scripting te beschrijven. WIP!
[[agreements]] - Alle Hobbynet contracten met contract beheerder e.d.
[[ToDo]] - Een wensenlijstje van dingen die we kunnen veranderen/verbeteren

===Updaten===
[[Joomlasites]] - Joomla sites die wij bijhouden
[[MediaWikiSites]] - MediaWiki sites die wij bijhouden

===Nood gegevens===
[[Medische protocol Bas|Medisch protocol bas]] - Medisch protocol bas

Dit is een "mediawiki" (http://www.mediawiki.org/). 
Uitleg over het editen is te vinden op: 
http://meta.wikimedia.org/wiki/MediaWiki_User%27s_Guide 
http://en.wikipedia.org/wiki/Wikipedia:How_does_one_edit_a_page

XML-RPC

2020-12-29T14:01:06Z

Hans:

= XML-RPC interface =

De LDAP server kan direct gemuteerd worden via een LDAP koppeling. Zie
de standaard LDAP pagina voor de uitleg welke poorten daarvoor gebruikt
kunnen worden.

Daarnaast is er de wens ontstaan om via een standaard protocol met de
LDAP omgeving te kunnen communiceren. Er is hiertoe een XML-RPC
koppeling ontwikkeld. XML-RPC is een standaard interface, waarmee het
mogelijk is om vanuit diverse omgevingen op een gestandaardiseerde
manier te communiceren.

== Globale functie omschrijving ==
* Algemene aanroepen
** Controleer of een gebruiker bestaat
** Wijzig het wachtwoord ('userPassword')
** Zoek een gebruiker (t.b.v. kantoor en/of LA-akties groeperingssecretaris)
** Maak een gebruiker aan (geef gebruiker een andere hccLogin waarde, maak ook bij HCCnet deze gebruiker aan)
** Controleer of een gebruiker zijn profiel al doorlopen heeft
** Haal de lijst met opgeheven accounts op
** Haal de lijst met bulletins van een hcc lid (OptIn)

* Aanroepen t.b.v. hcc partners
** Controleer of lidnummer/postcode correct is
** Controleer of lidnummer/postcode correct is, en tevens ingeschreven staat bij een specifieke IG

* Joomla template site functies (op basis van JoomlaToken)
** Maak een JoomlaToken
** Ruim een JoomlaToken op
** Pas mijn OptIn (bulletin inschrijving) aan
** Regel alles rondom Onderwerpen en de autorisatie hiervan
** Pas mijn wachtwoord aan

* Joomla kadernet site functies (op basis van JoomlaToken)
** Zoek een hcc kaderlid (t.b.v. de kaderleden zoekpagina)
** Pas mijn kadermail forwarding aan en toon ja/nee mijn GSM nummer
** Pas het kadernet e-mail wachtwoord aan
** Haal de lijst met alle groeperingen op
** Haal de lijst met alle kaderrollen op

* Joomla hcc.nl site (op basis van JoomlaToken)(mijn.hcc.nl vervanging)
** Pas mijn adresgegevens aan
** Pas mijn voorletters, voornaam, pseudoniem, telefoonnummer, GSM nummer etcetera aan
** Schrijf me in of uit op een bulletin
** Toon info over de kosten van een IG lidmaatschap
** Voer een wachtwoord reset uit op basis van een PWResetToken (een variant op JoomlaToken)
** Vraag een nieuwe HCC code aan, en stuur die per SMS

* Joomla hobby.nl site (op basis van JoomlaToken)(t.b.v. IDEAL betaling)
** Haal het aantal hobbyDomains op

* Aanroepen t.b.v. CRM (Microsoft Dynamics Cloud) koppeling
** Haal de dagelijkse synchronisatie bestanden op
** Werk in het CRM dan wel in LDAP de NAW gegevens bij
** Werk in het CRM dan wel in LDAP de IG gegevens van een lid bij

* HenZ
** Haal de lijst met opzeggers op
** Valideer de opzegdatum van een opgegeven gebruiker

=== Authenticatie ===

Alle aanroepen gebeuren op basis van authenticatie vanuit de aanroeper.
Dit valt uiteen in de volgende categorieën:
* gebruikersnaam ('hccLogin') en wachtwoord ('userPassword')
* hcc lidnummer ('hccLidnr'), Joomla token ('JoomlaToken') en website ('siteID')
* hcc lidnummer ('hccLidnr') en hcc code ('hccCode')
* beheerders-DN ('beheerLogin') en beheerders wachtwoord ('beheerPassword')
* partner-DN ('partnerLogin') en partner wachtwoord ('partnerPassword')

=== Aanroepen, gedaan via de bezoekersregistratie-proxy ===
(de bezoekersregistratie proxy is een mislukt project tbv de Android app van René Prins)
(deze proxy bestaat niet meer) 
Diverse aanroepen kunnen ook via de bezoekersregistratie-proxy aangeroepen worden. 
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
* GeefAlleGroeperingen
* GeefAlleKaderRollen
* GeefLocaties
* GeefLocatieNamen
De bezoekersregistratie aanroepen hebben 'JoomlaToken' als extra parameter nodig:
* LidBezoektBijeenkomst
* GeefBezoekersOverzicht
* GeefBezoekersAantallen
De aanroepen die over de proxy uitgevoerd worden dienen voorafgegaan te worden door een aanroep naar
* GeefMijnGegevens (dit geeft na validatie immers 'JoomlaToken' terug)

=== Resultaten ===

Alle aanroepen geven de volgende elementen terug:
* Naam van de uitgevoerde procedure ('Action')
* Resultaat van de uitgevoerde procedure ('Status')
* Een tekstuele vertaling van het resultaat dan wel de foutmelding ('Message')
* Tijdens de ontwikkelfase kan er debug-info teruggeleverd worden ('ExtraInfo')
Daarnaast geven specifieke aanroepen extra resultaten terug

== Technische omschrijving ==
XML-RPC beschrijving van acties in hcc.nl LDAP database

<pre>
2020.11.28 HaVe
XML-RPC Hobbynet versie 65.
</pre>

=== Kort overzicht ===
Dit is een lijst met alle XML-RPC aanroepen. In het volgende hoofdstuk worden ze in detail besproken.
<pre>
echo (partners)
ExpandeerPostcode (Joomla module Bas, tbv verhuizingen)
GebruikerBestaatControle (Joomla sites)
GeefAantalDomeinen (Joomla module Bas)
GeefAlleBulletins (Joomla module Bas)
GeefAlleGroeperingen (kadersite, forum, secr. portal, kantoor portal, hobbynet portal)
GeefAlleKaderRollen (forum, secr. portal, kantoor portal, hobbynet portal, Joomla module Bas)
GeefBezoekersOverzicht (bezoekersregistratie)
GeefBezoekersAantallen (bezoekersregistratie)
GeefFactuurOverzicht (Joomla module Bas)
GeefhccEindDatum (HenZ)
GeefKadermailGegevens (kantoor portal)
GeefLocatieNamen (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefLocaties (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefMijnGegevens (Joomla inlog module Bas)
GeefMijnLidnummer (beheer.hcc.nl secretaris portal)
GeefOnderwerpen (Joomla template sites)
GeefSSOUrls (Joomla module Bas)
GeefUitgeschrevenLeden (Joomla sites, HenZ)
HaalAanmeldingsformulier (Joomla module Bas)
HaalFactuur (Joomla module Bas)
HaalIGBedragenOp (Joomla module Bas)
HaalOptInKeuzen (kantoor portal)
HaalTariefGroepenOp (kantoor portal)
HCCpartner (Partner aanroep)
HCCpartners (Partner aanroep)
IsDezeNaamNogBeschikbaar (aangeroepen vanuit de CRM omgeving)
IsDezePseudoniemNogBeschikbaar (kantoor portal)
IsHCCLid (vraagbaak aanroep)
IsKaderLid (in veel apps gebruikt)
LidBezoektBijeenkomst (bezoekersregistratie)
MaakGebruikerAan (mijnhcc.nl, maak hccnet account aan en ldap gebruikersnaam)
MaakOnderwerp (Joomla template sites)
MaakPWResetToken (Joomla module Bas)
MaakTestLogin (Joomla module Bas)
MuteerAanmeldingsformulier (Joomla module Bas)
MuteerGroeperingSamenstelling (Joomla kadernet module Bas)
MuteerOnderwerp (Joomla template sites)
MuteerOnderwerpAutorisatie (Joomla template sites)
NormaliseerTelefoon (Joomla module Bas)
PasHccLoginAan (Joomla module Bas)(enkel Hobbynet)
PasInteressegroepAan (Joomla module Bas)
PasKaderGegevensAan (kadersite, Joomla module Bas)
PasOptInKeuzeAan (Joomla module Bas)
PasPseudoniemAan (Joomla module Bas)
PasUserWachtwoordAan (beheer.hcc.nl Hobbynet gebruikers portal)
PasWachtwoordAan (Joomla module Bas)
RegistreerGast (bezoekersregistratie)
ResetHCCCode (Joomla module Bas)
RuimJoomlaTokenOp (Joomla module Bas)
SchrijfNietlidInOpBulletin (Joomla site bulletin module Bas)
SchrijfNieuwLidIn (Joomla CRM module Bas)
ToonOnderwerpAutorisatie (Joomla template sites)
UpdateContactEmail (Joomla module Bas)
UpdateContactGegevens (Joomla module Bas)
UpdateMobiel (Joomla module Bas)
UpdateNAW (Joomla module Bas)
UpdateTelefoon (Joomla module Bas)
UpdateVoorletters (Joomla module Bas)
UpdateVoornaam (Joomla module Bas)
Upload_CSV_bestand (CRM webproxy)
ValideerPWResetToken (Joomla module Bas)
ValideerWachtwoordEisen (Joomla module Bas)
Verwerk_JSON_mutatie (CRM webproxy)
VerwijderNietLid (Joomla beheer module Bas)
VerwijderOnderwerp (Joomla template sites)
VraagLidgegevensTokenAan (bezoekersregistratie)
WijzigGebruikersGegevens (kantoor en Joomla template sites, ww aanpassen van gebruiker)
ZoekGroeperingsLid (secr. portal, kantoor portal, hobbynet portal)
ZoekHCCLid (VZ portal)
ZoekKaderLeden (Joomla kadernet module Bas)
</pre>

=== HCC-ldap en/of HCC-net aanroepen ===

<pre>
// ** Joomla sites, www.hcc.nl **
// 1.1 controleer of een gebruiker bestaat - optie 1
// (authenticatie op basis van hccLidnr en hccCode)
// Alleen bedoeld om gebruikers op www.hcc.nl op basis van het lidnr het ww te laten wijzigen
$request = xmlrpc_encode_request(
'GebruikerBestaatControle',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $method,
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd');
if ($hccLidnr != '') { $reply['hccLidnr'] = $hccLidnr; }
if ($hccLogin != '') { $reply['hccLogin'] = $hccLogin; }
if ($hccPseudoniem != '') { $reply['hccPseudoniem'] = $hccPseudoniem; }
if ($cn != '') { $reply['cn'] = $cn; }
if ($sn != '') { $reply['sn'] = $sn; }
if ($mail != '') { $reply['mail'] = $mail; }
if ($mailHccnet != '') { $reply['mailHccnet'] = $mailHccnet; }
if ($hccRegio != '') { $reply['hccRegio'] = $hccRegio; }
if ($hccIG != '') { $reply['hccIG'] = $hccIG; }
if ($hccRol != '') { $reply['hccRol'] = $hccRol; }
if ($ProfielBekend != '') { $reply['ProfielBekend'] = $ProfielBekend; }

// ** Portal mijn.hcc.nl **
// 2.1 wijzig wachtwoord - optie 1
// op basis van hccLidnummer en hccCode
// Essentiele aanroep, gebruikt vanuit mijnhcc.nl (lidnr + hccCode)
// Ook gebruikt t.b.v. wachtwoord-vergeten procedure op de Joomla template sites
// Als de profielpagina nog niet is doorlopen wordt deze aanroep afgekeurd.
//
// Ook gebruikt om gebruiker rechtstreeks vanaf Joomla template sites wachtwoord te
// laten aanpassen (op basis van lidnummer en hcc code)
//
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'WijzigGebruikersGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gewijzigd',
'hccLogin' => $hccLogin,
'cn' => $cn,
'sn' => $sn);

// 2.3 wijzig wachtwoord - optie 3
// (t.b.v. VZ-portal)
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
// * Als hccLidnr gevuld is, dan wordt hccLidnr gebruikt om het juiste record te zoeken
// Als hccLidnr leeg is, dan wordt hccLogin gebruikt om het juiste record te zoeken
// 1 van beide velden MOET aanwezig zijn
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'beheerLogin' => $beheerLogin, // beheerder lidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

// ** t.b.v. ophalen van de opt-in keuzes op de beheer pagina **
// 2.6 Geef de complete lijst met opt-ins van dit lid
// (LET OP: authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'HaalOptInKeuzen',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalOptInKeuzen',
'Status' => 'TRUE',
'Message' => 'OptInLijst opgehaald',
'hccOptIn' => $hccOptIn);
Output negatief:
$reply = array(
'Action' => 'HaalOptInKeuzen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gebruikersnaam, pseudoniem
// en wachtwoord tevens in LDAP op
// (authenticatie op basis van hcc lidnummer en hcc-code)
// ** Deze gegevens worden doorgezet naar hccnet.nl (action=4) **
//
$request = xmlrpc_encode_request(
'MaakGebruikerAan',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_hccLogin' => $nieuw_hccLogin,
'nieuw_userPassword' => $nieuw_userPassword,
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'TRUE',
'Message' => 'Gebruiker aangemaakt',
'mail' => $mail,
'hccPseudoniem' => $hccPseudoniem);
Output negatief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gebruikersnaam bestaat al' |
'Pseudoniem bestaat al' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!');

// H.3 Haal al mijn gegevens
// (wordt gebruikt door de Joomla inlogmodule)
// Voor gebruik over de proxy t.b.v. de Android app kan compact=TRUE meegegeven worden.
// In dat geval worden enkel de meest essentiele gegevens teruggestuurd
// Voor gebruik na MaakGebruikerAan kan deze functie ook op basis van hccLidnr en JoomlaToken
// worden aangeroepen
// De optionele parameter 'PrevSiteID' is bedoeld voor single-sign-on. Op basis van JoomlaToken,
// hccLidnr en PrevSiteID worden dan de credentials gevalideerd. Als die kloppen, geeft deze aanroep
// een 2e JoomlaToken terug, maar dan uitgegeven op basis van SiteID.
// Als PrevSiteID leeg is, dan wordt het token op basis van siteID gevalideerd.
$request = xmlrpc_encode_request(
'GeefMijnGegevens',
array(
['hccLogin' => $hccLogin,
'userPassword' => $userPassword,]
['hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,]
['PrevSiteID' => $PrevSiteID,]
['compact' => $compact,] // leeg of 'TRUE'
['hccGroepering'=> $hccGroepering,] // Een testgebruiker mag alleen op deze site inloggen
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd',
'hccLidnr' => $hccLidnr,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccAutorisatie' => $hccAutorisatie,
'cn' => $cn,
'sn' => $sn,
'JoomlaToken' => $JoomlaToken,
['hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'givenname' => $givenname,
'hccAanhef' => $hccAanhef,
'hccGeslacht' => $hccGeslacht,
'hccTussenVoegsels' => $hccTussenVoegsels,
'hccAchternaam' => $hccAchternaam,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward,
'hccKaderToonMobiel' => $hccKaderToonMobiel,
'hccOptIn' => $hccOptIn,
'ProfielBekend' => $ProfielBekend,
'hccBeginDatum' => $hccBeginDatum,
'testaccount' => is_testaccount(), // 'TRUE' | 'FALSE'
['kadermail_omvang' => $Formaat, // in Mb
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald;]]);

Output negatief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// ** t.b.v. aanpassen van de opt-in keuzes op een Joomla site **
// H.4 Pas 1 opt-in van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// Als hccLidnummer gevuld is, dan is dat het lidnummer waar de mutatie op moet worden uitgevoerd.
// Dat kan alleen als de aanvrager HCC#LAD of HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasOptInKeuzeAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
['hccLidnummer' => $hccLidnummer,]
'hccOptIn' => $hccOptIn,
'actie' => 'Nieuw' | 'Weg',
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'TRUE',
'Message' => 'OptIn aangepast');
Output negatief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// H.5 Zoek kaderleden NAW (t.b.v. de Joomla kadersite)
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
//
// * Er dient minstens 1 zoekcriterium opgegeven te worden.
// * Als zowel hccRegio als tegelijk ook hccIG opgegeven worden is de uitkomst onvoorspelbaar.
// * Als compact=TRUE worden enkel lidnummer, cn en sn in het antwoord gezet
$request = xmlrpc_encode_request(
'ZoekKaderLeden',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
['hccRegio' => $hccRegio,]
['hccIG' => $hccIG,]
['hccRol' => $hccRol,]
['hccLocatie' => $hccLocatie,]
['achternaam' => $achternaam,]
['compact' => $compact])); // leeg of 'TRUE'

Output positief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'TRUE',
'Message' => 'Kaderleden opgevraagd'
'Kaderleden' => array(
'hccLidNummer' => $hccLidNummer,
'hccRol' => $hccRol,
'hccAanhef' => $hccAanhef,
'givenname' => $givenname,
'cn' => $cn,
'sn' => $sn,
'hccWoonplaats' => $hccWoonplaats,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'hccKaderMail' => $hccKaderMail);

Output negatief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token']);

// H.9 PasKaderGegevensAan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
// Om de kaderleden hun forward in te laten stellen,
// en tegelijkertijd de opt-in / opt-out voor hccToonMobiel te laten regelen
// Kan tevens het kader email wachtwoord aanpassen
$request = xmlrpc_encode_request(
'PasKaderGegevensAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'hccKaderForward' => $hccKaderForward, // '' | $mail | $mailHccNet
'hccKaderToonMobiel' => $hccKaderToonMobiel, // 'TRUE' | 'FALSE' | 'NULL'
['nieuw_kaderPassword' => $nieuw_kaderPassword]));

Output positief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'TRUE',
'Message' => 'kadergegevens aangepast');

Output negatief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token'|'Alleen kaderleden mogen deze aanroep uitvoeren']);

// ** Portal beheer.hcc.nl
// ** H.10 PasUserWachtwoordAan
// ** Betalende Hobbynet gebruikers kunnen hiermee hun wachtwoord aanpassen
// (authenticatie op basis van hccLogin en userpassword)
$request = xmlrpc_encode_request(
'PasUserWachtwoordAan',
array(
'hccLogin' => $username,
'userpassword' => $password,
'hobbynetAccount' => $hobbyname,
'nieuw_wachtwoord' => $nieuw_wachtwoord,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!' |
'account $hobbynetAccount behoort niet bij gebruiker $hccLogin' |
'Kan ww van account $hobbynetAccount niet aanpassen');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.11 Pas het pseudoniem van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasPseudoniemAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccPseudoniem' => $hccPseudoniem,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'TRUE',
'Message' => 'Pseudoniem aangepast');
Output negatief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials' | 'Pseudoniem bestaat al');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.12 Controleer of een opgegeven wachtwoord aan de minimum eisen voldoet
$request = xmlrpc_encode_request(
'ValideerWachtwoordEisen',
array(
'userPassword' => $userPassword,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'TRUE',
'Message' => 'Wachtwoord voldoet aan de minimale eisen');
Output negatief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'FALSE',
'Message' => 'Wachtwoord voldoet niet aan de minimale eisen');

// ** H.13 PasWachtwoordAan
// ** Vanuit een Joomla template site kunnen gebruikers hiermee hun eigen wachtwoord aanpassen
// (authenticatie op basis van JoomlaToken, lidnummer, siteID. Extra controle via userpassword)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'userpassword' => $password,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.13.1 PasWachtwoordAan
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee hun eigen wachtwoord resetten
// (authenticatie op basis van PWResetToken en hccLogin).
// (Als de aanroep geslaagd is, dan is daarna het PWResetToken ongeldig)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.14 MaakPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee een wachtwoord reset aanvragen
// Deze aanroep geeft naast het PWResetToken ook het contact emailadres mee terug,
// zodat Joomla een reset-mail kan sturen
// (acties op basis van gebruikersnaam)
$request = xmlrpc_encode_request(
'MaakPWResetToken',
array(
'hccLogin' => $username,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'TRUE',
'PWResetToken' => $PWResetToken,
'mail' => $mail,
'Message' => 'Password reset token aangemaakt');
Output negatief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');

// ** H.15 ValideerPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers een wachtwoord reset aanvragen
// Controleer dat het hier om een bestaand (en nog niet gebruikt) token gaat
$request = xmlrpc_encode_request(
'ValideerPWResetToken',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'TRUE',
'Message' => 'Password reset token gevonden');
Output negatief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'FALSE',
'Message' => 'hccLogin bestaat niet' | 'PWResetToken bestaat niet');

// H.16 Ruim een bestaand JoomlaToken op
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'RuimJoomlaTokenOp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'SiteID' => $siteID,
['ServerID' => gethostname(),]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'TRUE',
'Message' => 'JoomlaToken opgeruimd');
Output negatief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'FALSE',
'Message' => 'Onjuist JoomlaToken');

// ** Joomla module
// ** H.17 GeefAantalDomeinen
// ** Vraag het aantal domeinen op van een betalende Hobbynet gebruiker (t.b.v. IDEAL betaling)
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'GeefAantalDomeinen',
array(
'JoomlaToken' => $JoomlaToken,
'hccLidnr' => $hccLidnr,
'hobbynetAccount' => $hobbyname,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'TRUE',
'hobbynetAccount' => $hobbyname,
'AantalDomeinen' => $aantalDomeinen,
'Message' => 'aantal domeinen opgevraagd');
Output negatief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'account $hobbynetAccount behoort niet bij deze gebruiker');

// ** Joomla module
// ** H.18 ResetHCCCode
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'beheerLogin' => $beheerLogin, // geheime credentials van de site
'beheerPassword' => $beheerPassword, // geheime credentials van de site
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** Joomla module
// ** H.18.1 ResetHCCCode (hcc kantoor aanroep)
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'JoomlaToken' => $JoomlaToken, // Het Joomla token van de sessie van de kantoor medewerker
'hccLidnr' => $hccLidnr, // Het lidnummer van de kantoor medewerker
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** t.b.v. aanpassen van de hccLogin van een gebruiker (Hobbynet functie op Joomla site) **
// H.19 Pas de hccLogin van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// hccLidnummer is het lidnummer waar de mutatie op moet worden uitgevoerd
// Kan alleen als de aanvrager HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasHccLoginAan',
array(
'hccLidnr' => $hccLidnr, // lidnummer van de aanvrager
'JoomlaToken' => $JoomlaToken, // JoomlaToken van de aanvrager
'hccLidnummer' => $hccLidnummer, // pas de hccLogin van dit lidnummer aan
'hccLogin' => $hccLogin, // dit is de gewenste nieuwe hccLogin
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'TRUE',
'Message' => 'hccLogin aangepast');
Output negatief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' |
'Onjuiste credentials' |
'Gebruikersnaam al in gebruik');

// ** t.b.v. het aanmaken van een testaccount door een webmaster
// H.20 Maak een testaccount aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// Kan alleen als de aanvrager WM als rol heeft
$request = xmlrpc_encode_request(
'MaakTestLogin',
array(
'JoomlaToken' => $JoomlaToken, // JoomlaToken van de aanvrager
'hccLidnummer' => $hccLidnummer, // lidnummer van de aanvrager
'hccRol' => $hccRol, // (mag leeg zijn)
'hccGroepering' => $hccGroepering, // (regio of IG)
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
reply = array(
'Action' => 'MaakTestLogin',
'Status' => 'TRUE',
'Message' => 'Tijdelijk test account aangemaakt',
'TestAccountNaam' => 'test-<groepering>-<hccLogin>'
'userpassword' => $nieuw_userpassword,
'hccGroepering' => $hccGroepering,
'hccRol' => $hccRol);
Output negatief:
$reply = array(
'Action' => 'MaakTestLogin',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Gegevenscombinatie onjuist');

// 3.1 Geef mijn lidnummer
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'GeefMijnLidnummer',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'TRUE',
'Message' => 'Lidnummer opgevraagd',
'hccLidnr' => $hccLidnr);
Output negatief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.2 Controleer of de gebruikersnaam op dit moment bestaat
// (geen authenticatie)
// ** Deze gegevens worden opgevraagd bij hccnet.nl (action=3) **
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezeNaamNogBeschikbaar',
array(
'nieuw_hccLogin' => $nieuw_hccLogin,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Gebruikersnaam is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Gebruikersnaam bestaat al');

// ** Enkel voor gebruik vanaf de kantoor portal **
// ** t.b.v. het hernoemen van accounts in CRM **
// 8.3 Controleer of een Pseudoniem op dit moment bestaat ??? NIET GEBRUIKT ??
// (geen authenticatie)
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezePseudoniemNogBeschikbaar',
array(
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem));
Output positief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Pseudoniem is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Pseudoniem bestaat al');

// ** t.b.v. de verenigingszaken zoekpagina **
// A.1 Zoek alle bij de query passende hcc leden
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
$request = xmlrpc_encode_request(
'ZoekHCCLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Groepering' => $Groepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (eerste deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| emailadres | (eerste deel van) e-mail adres |
| gebruikersnaam | (eerste deel van) de login naam |
| pseudoniem | (eerste deel van) het pseudoniem |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| niet_leden | het volledige niet-lid lidnummer |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'ZoekMethode' => $ZoekMethode,
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' => array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'sn' => $sn,
'givenName' => $givenName,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccHuisToevoeging' => $hcchuisToevoeging,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'ProfielBekend' => 'TRUE' | 'FALSE'])*);
Output negatief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. beheer.hcc.nl **
// A.3 Zoek alle bij de query passende hcc leden van deze groepering
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'ZoekGroeperingsLid',
array(
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Groepering' => $groepering,
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Bijeenkomst' => $Bijeenkomst,] // Alleen voor gebruik op de
// bijeenkomsten aanwezigheidsregistratie pagina
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| nieuwe_leden | YYYYMMDD vanaf waar gezocht moet worden |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| kaderleden | n.v.t. |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' =>
[array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'cn' => $cn,
'sn' => $sn,
'givenName' => $givenName,
'hccAchternaam' => $hccAchternaam,
'hccTussenVoegsels => hccTussenVoegsels,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem)]*));
Output negatief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker(s) niet gevonden' | 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten **
// A.4 Lid bezoekt bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'LidBezoektBijeenkomst',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
'hccLidnr' => $hccLidnr, // lid dat aanwezig gemeld moet worden
['correctie' => $hccLidnr,] // lid dat gecorrigeerd moet worden
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'TRUE',
'Message' => 'Bezoeker weggeschreven',
'Results' => array(
// info van deze bezoeker
'cn' => $cn, // cn (Verbeek, H.J.)
'hccGeslacht' => $hccGeslacht, // hccGeslacht van de bezoeker
'groeperingslid' => $groeperingslid, // TRUE of FALSE: is deze persoon lid van deze groepering
'mijnGroeperingen' => $mijnGroeperingen, // komma-gescheiden lijst (regio, [hccIG]*)
'aantalBezoeken' => $aantalBezoeken, // hoe vaak heeft dit lid deze bijeenkomst bezocht
// info van de bijeenkomst
'AantalBezoekers' => $AantalBezoekers); // aantal bezoekers van deze bijeenkomst
Output negatief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.5 Vraag Lidgegevens token aan (geldig voor dit lid, en deze groepering, op deze datum)
// Als geen datum gegeven is, dan is het token vandaag geldig
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'VraagLidgegevensTokenAan',
array(
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'hccLidnr' => $hccLidnummer, // vraag het token voor dit lid aan
'groepering' => $groepering, // zoek binnen deze groepering
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'TRUE',
'Message' => 'Token opgevraagd',
'groepering' => $Groepering,
'token' => $token,
'sn' => $sn);
Output negatief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.6 Toon bezoekersoverzicht
// (authenticatie op basis van lidnummer en bezoekersregistratie token)
$request = xmlrpc_encode_request(
'GeefBezoekersOverzicht',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'token' => $token,
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'TRUE',
'Message' => 'Bezoekersoverzicht opgevraagd',
'Bezoekers' => $bezoekers,
['Locatie' => $Locatie]);
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// A.7 Geef het array met alle locaties
// (of beperk dit tot de locaties van de groepering $Groepering)
// Desgewenst worden alle resultaten waarbij hccToonInJoomla aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// Desgewenst worden alle resultaten waarbij ToonOpKaderNet aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocaties',
array(
['Groepering' => $hccGroepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']);
Output positief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);
Output negatief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'FALSE',
'Message' => 'Locaties niet beschikbaar',
'ExtraInfo' => 'Geen locaties gevonden voor groepering $hccGroepering',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);

// A.8 Registreer een niet-hcclid als bezoeker tijdens een bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'RegistreerGast',
array(
'AccountNaam' => $lidnr, // credentials
'AccountCode' => $AccountCode, // credentials
'token' => $token, // credentials
'Bijeenkomst' => $groepering,
'geslacht' => $geslacht,
'naam' => $naam,
'mail' => $mail,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'buitenland' => $buitenland,
['nietLidNummer' => $nietLidNummer,]
['instructies' => $instructies,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $aanroep,
'Status' => 'TRUE',
'Message' => 'Niet-lid als bezoeker geregistreerd',
'Result' => $result_array);

// A.9 Geef het array met alle locatienamen
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocatieNamen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']));
['KaderMutatieFilter' => '' | 'TRUE']));

Output positief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));
Output negatief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'FALSE',
'Message' => 'Locatienamen niet beschikbaar',
'ExtraInfo' => 'Geen locatienamen gevonden',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));

// A.10 Schrijf een niet-lid in op een bulletin
// (2019.12.05: wordt actief gebruikt in Joomla module)
// Deze aanroep mag *ook* worden gebruikt om een wel-lid in te schrijven.
// Voorwaarde is dat bewezen is dat er controle bestaat over het opgegeven email adres
$request = xmlrpc_encode_request(
'SchrijfNietlidInOpBulletin',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'hccOptin' => $hccOptin, // bulletin waarop ingeschreven wordt
'hccOptinSource' => $hccOptinSource, // site waar aanmelding vandaan komt
'Email' => $Email, // niet-lid: email adres
'Naam' => $Naam, // niet-lid: naam
['hccLidNummer' => $hccLidNummer,] // optioneel: ik ben lid, dit is mijn lidnummer
['Postcode' => $Postcode,] // optioneel: niet-lid: postcode
['Huisnummer' => $Huisnummer,] // optioneel: niet-lid: huisnummer
['hccGeslacht' => $hccGeslacht,] // optioneel: niet-lid: geslacht (M/V/O)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'TRUE',
'Message' => 'Inschrijving op bulletin gelukt');
Output negatief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist',
'ExtraInfo' => 'Invalid DN syntax' |
'Invalid credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.11 Toon bezoekers aantallen
// (authenticatie op basis van AccountNaam en AccountCode of token)
//
// ==> Mag weg: laatste aanroep 2018.12.15 <==
//
$request = xmlrpc_encode_request(
'GeefBezoekersAantallen',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'token' => $token,
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersAantallen',
'Status' => 'TRUE',
'Message' => 'BezoekersAantallen opgevraagd',
'Datum' => $datum,
'Bijeenkomst' => $Bijeenkomst,
'Bezoekers' => array(
[HCC!seniorenacademie] => Array(
[Gorinchem] => 15
[Woerden] => 36)
...));
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersAantallen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// ** t.b.v. Joomla module Bas
// A.12 GeefAlleBulletins
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleBulletins',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefAlleBulletins',
'Status' => 'TRUE',
'Message' => 'Bulletins opgevraagd',
'bulletins' => $bulletins);

// ** t.b.v. Joomla module Bas
// A.13 ExpandeerPostcode
// (geen authenticatie)
$request = xmlrpc_encode_request(
'ExpandeerPostcode',
array(
'postcode' => $postcode,
'huisnummer' => $huisnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'ExpandeerPostcode',
'Status' => 'TRUE',
'Message' => 'Postcode opgevraagd',
'detailgegevens' => $detailgegevens);

// ** t.b.v. Joomla module Bas
// A.25 UpdateNAW
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateNAW',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'geslacht' => $geslacht,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'toevoeging' => $toevoeging,
'straat' => $straat,
'woonplaats' => $woonplaats,
'landcode' => $landcode,
'email' => $email,
'voornaam' => $voornaam,
'voorletters' => $voorletters,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateContactGegevens',
'Status' => 'TRUE',
'Message' => 'Contactgegevens bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.18 NormaliseerTelefoon
// (geen authenticatie)
$request = xmlrpc_encode_request(
'NormaliseerTelefoon',
array(
'hccLand' => $hccLand,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'NormaliseerTelefoon',
'Status' => 'TRUE',
'Message' => 'Telefoonnummer genormaliseerd',
'Telefoonnummer' => $Telefoonnummer);

// ** t.b.v. Joomla module Bas
// A.20 UpdateMobiel
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateMobiel',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateMobiel',
'Status' => 'TRUE',
'Message' => 'Mobiel nummer bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.21 HaalIGBedragenOp
// Geef alle IG's waar je zelf lid van kunt worden, inclusief het bijbehorende bedrag
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalIGBedragenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalIGBedragenOp',
'Status' => 'TRUE',
'Message' => 'Interessegroepen en bedragen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.22 HaalTariefGroepenOp
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalTariefGroepenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalTariefGroepenOp',
'Status' => 'TRUE',
'Message' => 'Tariefgroepen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.23 PasInteressegroepAan
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasInteressegroepAan',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
['nieuw' => $IG_lijst_nieuw,]
['weg' => $IG_lijst_weg,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'PasInteressegroepAan',
'Status' => 'TRUE',
'Message' => 'IG keuzen aangepast');

// ** t.b.v. Joomla module Bas
// A.24 GeefSSOUrls
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefSSOUrls',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefSSOUrls',
'Status' => 'TRUE',
'SSO_urls' => $sso_urls,
'Message' => 'Single Sign On URLs opgevraagd');

// ** t.b.v. de verenigingszaken beheer pagina **
// A.26 Verwijder een niet-lid record
$request = xmlrpc_encode_request(
'VerwijderNietLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'hccLidnr' => $hccLidnummer, // het te verwijderen niet-lid nummer
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

Output positief:
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'TRUE',
'Message' => 'Niet-lid record verwijderd',

Output negatief:
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'FALSE',
'Message' => 'Niet-lid record niet gevonden');
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** HenZ **
// ** t.b.v. daily cron job **
// ** t.b.v. dagelijkse opschoon jobs Joomla template sites **
// C.1 Vraag de lijst met uitgeschreven leden op
// Dit kan beperkt worden tot een bepaalde regio of interessegroep
// Daarnaast kan het tijdvak waarin gezocht wordt vrij gekozen worden
// (gesteld dat de LDAP database nog leden uit die periode bevat)
// Antwoord: lijst met (lidnummer, hccLogin, sn,
// datum einde lidmaatschap (formaat:YYYYMMDD))

==> GeefUitgeschrevenLeden <== (oud: GeefOpgezegdeLeden)

$request = xmlrpc_encode_request(
'GeefUitgeschrevenLeden',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccRegio' => $hccRegio, // of leeg
'hccIg' => $hccIg, // of leeg
'datum_vanaf' => $datum_sinds, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: 3 dagen geleden)
'datum_tot' => $datum_tot, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: vandaag)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'TRUE',
'Message' => 'Uitgeschreven leden',
['hccRegio' => $hccRegio,]
['hccIg' => $hccIg,]
['datum_vanaf' => $datum_vanaf,]
['datum_tot' => $datum_tot,]
['Results' => array(
[array(
'hccLogin' => $hccLogin,
'hccLidNummer' => $hccLidnummer,
'sn' => $sn,
'DatumEindeLidmaatschap' => $DatumEindeLidmaatschap)]*);
Output negatief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');
</pre>

=== HCCpartner aanroepen ===
(interface versie 1) 
(oude interface, niet meer gebruiken!)

<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.1 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartner',
array('ControleerHCCLidmaatschap',
array('partnerLogin', $partnerLogin),
array('partnerPassword', $partnerPassword),
array('hccLidnummer', $hcclidnummer),
array('postcode', $postcode)));
Output positief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'TRUE'));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'));
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'),
array('Message', 'Onjuiste credentials'));

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartner',
array(
'OnbekendeAanroep',
array('parameter', $iets)));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'OnbekendeAanroep'),
array('Status', 'FALSE'),
array('Message', 'Opdracht onbekend'));
</pre>

=== HCCpartners aanroepen ===
(interface versie 2)

<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.2 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'ControleerHCCLidmaatschap',
'partnerLogin' => $partnerLogin,
'partnerPassword' => $partnerPassword,
'hccLidnummer' => $hcclidnummer,
'postcode' => $postcode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'TRUE',
['ExtraInfo' => 'groepering=$groepering']); // als de partner beperkt is tot 1 groepering
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE');
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'OnbekendeAanroep',
'parameter' => $iets));
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'OnbekendeAanroep',
'Status' => 'FALSE',
'Message' => 'Opdracht onbekend');
</pre>

=== HCC-kader aanroepen ===

<pre>
// ** beheer.hcc.nl **
// F.2 Controleer of dit een kaderlid is
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'IsKaderLid',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'TRUE',
'Message' => 'Is kaderlid',
'hccLidnr' => $hccLidnr,
'cn' => $cn,
'sn' => $sn,
'hccRol' => $hccRol,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward);
Output negatief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Is geen kaderlid');

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.4 Vraag alle groeperingen op
// Het is mogelijk om een groepering te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// ToonInOverzichtenFilter : attribuut 'hccToonInOverzichten'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// BulletinsFilter : attribuut 'hccBulletins'
// EmailFilter : attribuut 'hccFunctionalEmail'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleGroeperingen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['ToonInOverzichtenFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['BulletinsFilter' => '' | 'TRUE',]
['EmailFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE'));
Output positief:
$reply = array(
'Action' => 'GeefAlleGroeperingen',
'Status' => 'TRUE',
'Message' => 'Lijst met groeperingen opgevraagd',
'Result' => $groeperingen,
['JoomlaFilter' => 'TRUE',]
['ToonInOverzichtenFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']);

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.5 Vraag alle kaderrollen op
// Het is mogelijk om een kaderrol te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleKaderRollen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']));
Output positief:
$reply = array(
'Action' => 'GeefAlleKaderRollen',
'Status' => 'TRUE',
'Message' => 'Lijst met kaderrollen opgevraagd',
'Result' => $kaderrollen,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']);

// ** t.b.v. de kantoor-beheerpagina **
// F.9 Geef de gevevens van de mailbox van dit kaderlid
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
$request = xmlrpc_encode_request(
'GeefKadermailGegevens',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer));
Output positief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'kadermail_omvang' => $Formaat,
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald);
Output negatief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid'));

// ** t.b.v. de Joomla Kadernet module **
// * F.10 MuteerGroeperingSamenstelling
// (authenticatie op basis van lidnummer, JoomlaToken en siteID en als extra hccCode van de aanvrager)
$request = xmlrpc_encode_request(
'MuteerGroeperingSamenstelling',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccCode' => $hccCode,
'groepering' => $groepering,
'hccLidnummer => $hccLidnummer, // lidnummer van het te muteren hcc lid
'hccRol' => $hccRol, // de nieuwe dan wel op te heffen rol
// de rol 'ALLES_WEG' ruimt alle rollen van dit hcc lid voor deze groepering op
'actie' => 'Nieuw' | 'Weg',
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress,]
Output positief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'TRUE',
'Message' => 'Groepering samenstelling aangepast',
['ExtraInfo' => 'Bedankmail gestuuurd aan ex-kaderlid']);
Output negatief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid' |
'Oude rol niet gevonden' |
'Nieuwe rol kan niet samen met bestaande rol' |
'Alleen voorzitter of secretaris kan kadermutaties uitvoeren']);
</pre>

=== HCC-groepering aanroepen ===

<pre>

// I.2 controleer of een gebruiker bestaat op basis van de combinatie
// lidnummer + postcode + huisnummer
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
// (alternatieve authenticatie mogelijk door lidnummer + hcc-code in te vullen)
//
// Aan de aanroeper worden zekere eisen gesteld:
// * dient een rol te vervullen binnen de groepering 'FOR'(forum)
// * dan wel dient de rol 'VRBK' (vraagbaak) te vervullen binnen een groepering
//
// Er wordt door de gehele leden-database gezocht, waarna terug wordt gegeven
// * of dit hcc lid inderdaad bestaat
// en, als het om een aanvraag van een vraagbaak vrijwilliger gaat,
// * tevens of het gezochte hcc lid deel uitmaakt van zijn groepering
//
// ==> Mag weg: laatste aanroep 2018.07.27 <==
//
$request = xmlrpc_encode_request(
'IsHCCLid',
array(
'hccLogin' => [$hccLogin | $hccLidnummer],
'userPassword' => [$userPassword | $hccCode],
'zoekhccLidnr' => $zoekhccLidnr,
'zoekhccPostcode' => $zoekhccPostcode,
'zoekhccHuisnr' => $zoekhccHuisnr,
'zoekgroepering' => $zoekgroepering));
Output positief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gecontroleerd',
['Groeperingslid' => $IsGroeperingLid]));
Output negatief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker bestaat niet' |
'Onjuiste credentials' |
'Wel HCC lid, maar geen lid van groepering $groepering' |
'Onvoldoende rechten' |
'Vul alle verplichte velden in!'));
</pre>

=== HenZ aanroepen ===

<pre>

// I.3 Geef de einddatum van een actief dan wel uitgeschreven lid
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'GeefhccEindDatum',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'TRUE',
'hccLidnummer' => $hccLidnummer,
'hccLogin' => $hccLogin,
'hccEindDatum' => $hccEindDatum ('yyyymmdd' | ''));
Output negatief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Invalid credentials' |
'Lidnummer niet gevonden');
</pre>

=== (Forum,vraagbaak) onderwerpen ===

<pre>
// L.1 MaakOnderwerp
$request = xmlrpc_encode_request(
'MaakOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'description' => $description,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp is aangemaakt',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster');

// L.2 VerwijderOnderwerp

$request = xmlrpc_encode_request(
'VerwijderOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'TRUE',
'onderwerp' => $onderwerpID,
'Message' => 'Onderwerp is verwijderd',
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Ruim eerst alle geautoriseerde gebruikers op' |
'Kan onderwerp niet verwijderen');

// L.3 GeefOnderwerpen
// Geef het array met de lijst van onderwerpen voor de betreffende groepering
//
$request = xmlrpc_encode_request(
'GeefOnderwerpen',
array(
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'TRUE',
'Message' => 'Onderwerpen opgevraagd',
'onderwerpen' => $onderwerpen); // het array met onderwerpen
Output negatief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!');

// L.4 MuteerOnderwerp
// Pas de description van een onderwerp aan
//
$request = xmlrpc_encode_request(
'MuteerOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'description' => $description,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp aangepast',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Onderwerp behoort bij andere groepering');

// L.5 MuteerOnderwerpAutorisatie
// Geef kaderlid $kaderLidNr de autorisatie MOD, VRBK of RED bij onderwerp $onderwerp
// (of haal die autorisatie weg)
$request = xmlrpc_encode_request(
'MuteerOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'onderwerp' => $onderwerpID,
'kaderLidNr' => $kaderLidNr,
'hccAutorisatie' => 'MOD' | 'VRBK' | 'RED',
['verwijder' => 'TRUE']));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Onderwerp autorisatie aangepast');
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Geen kaderlid' |
'Onjuiste autorisatie opgegeven' |
'Onderwerp bestaat niet');

// L.6 ToonOnderwerpAutorisatie
$request = xmlrpc_encode_request(
'ToonOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Autorisaties opgehaald',
'onderwerp' => $onderwerpID,
'description' => $description,
'autorisaties' =>
[Array(
'hccLidnummer' => $hccLidnummer
'cn' => $cn
'hccAutorisatie' => {komma-gescheiden autorisaties})]);
Output negatief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet');
</pre>

=== Microsoft Dynamics Cloud (Cayentis) onderwerpen ===

<pre>
// M.1 Upload_CSV_bestand
// De CRM proxy upload de dagelijkse CSV synchronisatie-bestanden naar de XML-RPC server
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Upload_CSV_bestand',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'CSV_bestand_type' => '1' | '2' | '3' , // 1=Contactpersonen/Hoofdlidmaatschappen
// 2=Gremiumlidmaatschap codes
// 3=Gremiumlidmaatschappen
'CSV_bestand' => $CSV_bestand)); // het CSV bestand (base64 encoded)
Output positief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'TRUE',
'Message' => 'Bestand opgeslagen');
Output negatief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.2 SchrijfNieuwLidIn
//
// Maak in het CRM een nieuw HCC lid aan
// De NAW gegevens worden in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'SchrijfNieuwLidIn',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'NAWgegevens' => $NAW_Array,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress);
// $NAW_array = array(
// 'GeboorteDatum' => $geboortedatum,
// 'Geslacht' => $geslacht,
// 'Voornaam' => $voornaam,
// 'Voorletters' => $voorletters,
// 'Tussenvoegsel' => $tussenvoegsel,
// 'Achternaam' => $achternaam,
// 'Straatnaam' => $straatnaam,
// 'Huisnummer' => $huisnummer,
// 'HuisnummerToevoeging' => $huisnummertoevoeging,
// 'Woonplaats' => $woonplaats,
// 'Postcode' => $postcode,
// 'Land' => $land,
// 'Telefoonnummer' => $telefoonnummer,
// 'MobielNummer' => $mobielnummer,
// 'Mail' => $mail,
// 'IBAN' => $IBAN,
// 'Interessegroep' => $IGs, // komma-gescheiden lijst met IG's
// 'Geschenk' => $geschenk,
// 'Actiecode' => $actiecode,
// 'Voorwaarden' => $Akkoord); // 'Akkoord'
)
Output positief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'TRUE',
'Message' => 'nieuw lid ingeschreven',
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode);
Output negatief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.3 Verwerk_JSON_mutatie
// De CRM proxy kan NAW en/of IG mutaties en/of hccCode mutaties live doorgeven
// Deze gegevens worden in JSON in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Verwerk_JSON_mutatie',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'mutatie_type' => '1' | '2', // 1=Contactpersoon/Hoofdlidmaatschap
// 2=Gremiumlidmaatschap
'JSON_mutatie' => $JSON_mutatie)); // de JSON payload
Output positief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'TRUE',
'Message' => 'Mutatie verwerkt');
Output negatief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.4 Vertaal landcode
// Het CRM werkt met numerieke landcodes, wij met cijfers
// Vertaal die
// Er moet in de aanroep 1 veld aanwezig zijn, beide waarden komen in het antwoord terug
$request = xmlrpc_encode_request(
'ISO_landcode',
array(
['ISO_numeriek' => $ISO_numeriek,]
['ISO_code ' => $ISO_code]));
Output positief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'TRUE',
'Message' => 'ISO code lookup geslaagd',
'ISO_numeriek' => $ISO_numeriek,
'ISO_code ' => $ISO_code,
'ISO_benaming' => $ISO_benaming); // de descriptive name van deze ISO code
Output negatief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'FALSE',
'Message' => 'Kan geen bijpassende vertaling vinden'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');
</pre>
// M.5 MuteerAanmeldingsformulier
// Sla een JSON veld op in de XML-RPC server zodat deze weer opgehaald kan worden door de websites
// Authenticatie op basis van hccLidnummer en JoomlaToken
// Deze mutaties mogen alleen door HN#WM of SITE#WM gedaan worden.

$request = xmlrpc_encode_request(
MuteerAanmeldingsformulier,
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
'formulierdata' => $formulierdata, // JSON veld met alle gegevens voor het aanmeld formulier
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress ));
Output positief:
$reply = array(
'Action' => 'MuteerAanmeldingsformulier',
'Status' => 'TRUE',
'Message' => 'aanmeldingsformulier bijgewerkt';

// M.6 HaalAanmeldingsformulier
// (geen authenticatie)
$request = xmlrpc_encode_request(
HaalAanmeldingsformulier,
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalAanmeldingsformulier',
'Status' => 'TRUE',
'formulierdata' => $formulierdata); // JSON veld met alle gegevens voor het aanmeld formulier
</pre>

// M.7 GeefFactuurOverzicht
// (authenticatie op basis van hccLidnummer + JoomlaToken + siteID
$request = xmlrpc_encode_request(
GeefFactuurOverzicht,
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefFactuurOverzicht',
'Status' => 'TRUE',
'FactuurOverzicht' => $FactuurOverzicht);
// $FactuurOverzicht =
// array(
// array(
// 'FactuurID' => 'a5b93460-4536-ea11-a813-000d3a2c53fa',
// 'FactuurNummer' => '200118673J5'
// 'FactuurDatum' => '2020-01-15'
// 'bedrag' => 42.37
// 'BetaalStatus' => 0]));
// )

// M.8 HaalFactuur
// (authenticatie op basis van JoomlaToken of FactuurToken)
$request = xmlrpc_encode_request(
HaalFactuur,
array(
'hccLidnummer' => $hccLidnummer,
['JoomlaToken' => $JoomlaToken,]
['FactuurToken' => $FactuurToken,]
'FactuurNummer' => $FactuurNummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalFactuur',
'Status' => 'TRUE',
'factuur' => $factuurgegevens);
// $factuurgegevens =
// array(
// 'FactuurNummer' => $FactuurNummer,
// 'FactuurDatum' => $FactuurDatum,
// 'FactuurID' => $FactuurID,
// 'Bestandsnaam' => $Bestandsnaam,
// 'PDF' => $PDF) // base64 encoded PDF
</pre>

=== Echo test ===

<pre>

// t.b.v. controle of de verbinding met de XML-RPC server functioneert
// Eenvoudige echo test

$request = xmlrpc_encode_request(
'echo',
array(
'What' => $string,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'echo',
'Status' => 'TRUE',
'Message' => $string);
</pre>

=== HenZ XML-RPC interface ===

Overzicht van XML-RPC procedures die bij HenZ draaien
(worden via de Hobbynet XML-RPC server afgehandeld)

<pre>
- Action=2
wijzig gebruikersnaam en wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=3
controleer of een gebruikersnaam bestaat
(XML-RPC server voert de hccnet XML-call uit, zie 8.2)

- Action=4
creer een nieuwe gebruiker. Per lidnummer is er 1 account. Als er al een
account voor dit lidnummer bestaat wordt het bestaande account hernoemd.
(XML-RPC server voert de hccnet XML-call uit, zie 8.1)

- Action=5
wijzig wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=7
Uitgeschreven lid is weer actief lid geworden
(Wordt aangeroepen vanuit de cronjob)

- Action=8
Lid heeft een nieuwe hcc-code gekregen
(Wordt aangeroepen vanuit de cronjob)
</pre>

=== Release notes ===
<pre>
2012.02.08 Wijzigingen versie 5:
- 4.1 verwijder_hcc_Lidnummer i.p.v. hcc_Lidnummer
- 4.1 optionele extra parameter verwijder_hccLogin
- Optionele parameters aangegeven
- Vanwege de duidelijkheid de beheerLogin en beheerPassword velden
bovenin de betreffende aanroepen gezet
(De volgorde van de parameters is niet relevant, dus dit is geen
interface-aanpassing)
2012.02.16 Wijzigingen versie 6:
- 2.1/2.2/2.3 geef ook cn en sn terug na aanpassen van het wachtwoord
- 3.1 geef cn en sn terug na aanmaken nieuwe gebruiker
2012.02.27 Wijzigingen versie 7:
- Neem de XML-RPC interface van HenZ in deze XML-RPC server op
8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gegevens tevens in LDAP op
- 2.1 wijzig wachtwoord - optie 1
* Nieuw wachtwoord is verplicht, niet optioneel
* wijzigingen worden naar hccnet.nl doorgezet
- 2.2 wijzig wachtwoord, optie 2
* Nieuw wachtwoord is verplicht, niet optioneel
* gebruikersnaam kan niet meer via deze interface aangepast worden
* wijzigingen worden naar hccnet.nl doorgezet
- 2.3 wijzig wachtwoord, optie 3
* wijzigingen worden naar hccnet.nl doorgezet
2012.03.26 Wijzigingen versie 8:
- Breidt de XML-RPC interface van HenZ in deze XML-RPC server uit met
8.2 Controleer of de gebruikersnaam op dit moment bestaat
2012.04.09 Wijzigingen versie 9:
- Vervang alle 'ldap' aanroepen door 'HCCldap' aanroepen
- documentatie van HenZ call action=2 aangepast, action=5 toegevoegd
2012.05.03 Wijzigingen versie 10:
- 1.1 / 1.2 / 1.3 geven nu ook 'ProfielBekend' terug om uniek te bepalen
of deze bezoeker een first-time-login pagina te zien dient te krijgen
- documentatie van 2.1 (wijzig wachtwoord) aangepast:
2.1 kan alleen als profiel is doorlopen
- nieuwe procedure t.b.v. zoekscherm PC30
* A.1 ZoekHCCLid
- hiervoor is de database met diverse velden uitgebreid
(postcode, e-mailadres, huisadres, woonplaats, land, telefoonnummer)
Dit heeft impact op diverse andere procedures (t.b.s.)
- nieuwe procedure t.b.v. 'gewone' profielpagina
* B.1 GeefDBFPersoonID
- nieuwe procedure t.b.v. cron-job
* C.1 GeefOpgezegdeLeden
2012.05.10 Wijzigingen versie 11
- 1.3 GebruikerBestaatControle
* nieuwe parameter: hccPseudoniem
* nieuw veld in antwoord: hccPseudoniem
- 2.3 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 2.4 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 3.1 NieuweGebruiker
* nieuwe parameter: hccPseudoniem
- 8.1 MaakGebruikerAan
* nieuwe parameter: nieuw_hccPseudoniem
* alle parameters zijn verplicht (niet langer optioneel)
* nieuw antwoord: Gegevenscombinatie onjuist
- 8.3 IsDezePseudoniemNogBeschikbaar
* Nieuwe procedure t.b.v. 1e keer doorlopen profielpagina
- A.1 ZoekHCCLid
* 'Zoeklimiet bereikt' wordt als ExtraInfo meegegeven
* nieuwe velden in antwoord: hccPseudoniem en hccLogin
- B.1 GeefDBFPersoonID
* Zoeken kan nu ook op hccLogin en op hccPseudoniem
- C.1 GeefOpgezegdeLeden
* Geef nu ook hccLogin en hccPseudoniem terug
2012.05.14 Wijzigingen versie 12
- 1.x GebruikerBestaatControle
* Geef ook DBFPersoonID terug
- 4.1 Gooi een gebruiker weg.
* Haal ongebruikte parameter hccLogin weg
- 5.1 Wijzig hccIG
* Haal ongebruikte parameter hccLogin weg
- 6.1 Wijzig hccRegio
* Haal ongebruikte parameter hccLogin weg
- 7.1 Wijzig hccRol
* Haal ongebruikte parameter hccLogin weg
2012.05.20 Wijzigingen versie 13
- A.1 ZoekHCCLid
* Geef resultaten gestructureerder formaat
* Geef in ExtraInfo weer hoeveel echte resultaten er gevonden zijn
- C.1 GeefOpgezegdeLeden
* Geef resultaten in gestructureerder formaat
2012.06.03 Wijzigingen versie 14
- 3.1 NieuweGebruiker
* Geef ook DBFPersoonID mee
2012.08.17 Wijzigingen versie 15
- C.1 GeefOpgezegdeLeden
* Geef ook hccLogin in het antwoord terug
- D.1 HCCpartner/ControleerHCCLidmaatschap
* Nieuwe aanroep
2012.09.29 Wijzigingen versie 16
- Alle cron gerelateerde opdrachten verwijderd
* 3.1 NieuweGebruiker
* 4.1 GooiGebruikerWeg
* 5.1 WijzigHccIG
* 6.1 WijzigHccRegio
* 7.1 WijzigHccRol
2012.10.28 Wijzigingen versie 17
- nieuwe procedure t.b.v. PC30 beheerpagina
* A.2 HaalPC30Token
- nieuwe procedure t.b.v. Drupal profielpagina
* 2.4 vervallen
(WijzigGebruikersGegevens op basis van pseudoniem)
* 2.5 WijzigGebruikersGegevens
Nieuwe keuze: wijzig pseudoniem
2012.11.14 Wijzigingen versie 18
- 1.x GebruikerBestaatControle
* Geef ook mail in het antwoord terug
2012.11.30 Wijzigingen versie 19
- E.1 HCCkader/WijzigGebruikersGegevens
* Nieuwe aanroep
- F.1 / F.2 / F.3 ControleerKaderlid
* Nieuwe aanroep
2012.12.18 Wijzigingen versie 20
- Haal DBFPersoonID weg uit alle aanroepen en alle resultaten
* Antwoord van 1.x GebruikerBestaatControle
* B.1 GeefDBFPersoonID opgeheven
- A.1 ZoekHCCLid geeft nu ook hccMobiel terug (t.b.v. PC30 zoekpagina)
- C.1 GeefOpgezegdeLeden verder uitgewerkt:
* Geeft alleen de door Drupal gebruikte velden 'hccLogin' en 'hccEindDatum'
terug in het antwoord
* Geeft nu 'echte' antwoorden i.p.v. dummy resultaten
- F.1 ControleerKaderlid geeft nu ook optioneel 'sn' en 'givenName'
terug (in de beheer-variant)
2013.01.25 Wijzigingen versie 21
- A.1 ZoekHCCLid uitgebreid
* Geeft nu ook hccBeginDatum, hccEindDatum en hccRol terug
2013.02.02 Wijzigingen versie 22
- A.1 ZoekHCCLid
* Interface aangepast
- A.3 ZoekGroeperingsLid
* Nieuwe aanroep
- F.4 GeefAlleGroeperingen
* Nieuwe aanroep
- F.5 GeefAlleKaderRollen
* Nieuwe aanroep
2013.03.01 Wijzigingen versie 23
- A.3 ZoekGroeperingsLid
* Geeft andere resultaten terug
- 2.2 WijzigWachtwoord
* Geeft nu ook hccLogin terug (voor ww-vergeten op de Drupal site)
- HCCenquete implementatie
* G.1 Expandeer NL postcode
* G.2 Haal lidgegevens op
* G.3 Pas lidgegevens aan
2013.03.18 Wijzigingen versie 24
- ZoekGroeperingsLid op basis van token
- A.4 Lid bezoekt bijeenkomst
* nieuwe aanroep
- A.5 VraagLidgegevensTokenAan
* nieuwe aanroep
2013.04.07 Wijzigingen versie 25
- D.1 HCCpartner/ControleerHCCLidmaatschap
Simpeler interface ontwikkeld ('HCCpartners' i.p.v. 'HCCpartner')
- G.3 mag ook Tussenvoegsels aanpassen
2013.04.25 Wijzigingen versie 26
- H.1 HCC-groepering / GebruikerBestaatControle
Nieuwe interface voor validatie vanaf groeperings websites
2013.05.03 Wijzigingen versie 27
- 2.6 HaalOptInKeuzen
* nieuwe aanroep
- 2.7 SchrijfOptInKeuzen
* nieuwe aanroep
- 2.8 HaalOptInLijst
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* nieuwe aanroep
- HCCpartners aanroep nieuwe interface ('Action' => 'ControleerHCCLidmaatschap')
2013.07.05 Wijzigingen versie 28
- 8.1 MaakGebruikerAan
* extra parameters (mail, hccPseudoniem) in het antwoord
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra parameter (mailHccnet)
- A.1 ZoekHCCLid
* extra parameter (mailHccnet)
- A.3 ZoekGroeperingsLid
* extra parameter (mailHccnet)
2013.08.31 Wijzigingen versie 29
- F.1 / F.2 / F.3 HCC-kader / ControleerKaderlid
* extra output parameter (hccKaderMail)
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra output parameter (hccForumLogin)
- H.1 HCC-groepering / GebruikerBestaatControle
* komma-gescheiden lijst met groeperingen mogelijk
* extra output parameter (mailHccnet)
2013.12.26 Wijzigingen versie 30
- 3.1 Geef mijn lidnummer
* nieuwe aanroep
- A.1 ZoekHCCLid
* geef nu ook 'ProfielBekend' terug om aan de PC30 omgeving door te geven
dat het wachtwoord niet veranderd mag worden door PC30
- A.6 GeefBezoekersOverzicht
* geef nu ook 'Locatie' terug indien van toepassing
- A.7 GeefLocaties
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* parameters aangepast
* authenticatie op basis van hccLogin + userPassword of lidnummer + hcc-code
* geen algemene hcc-forum authenticatie meer mogelijk
- F.7 ControleerKaderlidGroep
* Nieuwe aanroep
2014.02.01 Wijzigingen versie 31
- A.8 RegistreerGast
* nieuwe aanroep
- H.2 MatchPostcodeMetRegio
* nieuwe aanroep
- nieuwe interface (losse, unieke aanroepen, niet meer gegroepeerd)
2014.09.27 Wijzigingen versie 32
- C.1 GeefOpgezegdeLeden hernoemd naar GeefUitgeschrevenLeden
- I.3 GeefhccEindDatum
* nieuwe aanroep
- Action=7 en Action=8 toegevoegd aan de HenZ interface
2014.12.12 Wijzigingen versie 33
- F.1 / F.2 / F.3 HCC-kader / IsKaderLid
* extra output parameter (mail, mailHccnet, hccKaderForward)
- F.8 HCC-kader / ZetKaderForward
* nieuwe aanroep
2015.05.06 Wijzigingen versie 34
- GeefMijnGegevens
* nieuwe aanroep
- ValideerPCActiveAbonnee
* vervallen
- 1.4 GebruikerBestaatControle
* extra output parameter (hccKaderForward)
- D.1 HCCpartner/ControleerHCCLidmaatschap
* optionele extra output parameter (ExtraInfo)
2015.09.27 Wijzigingen versie 35
- HeeftForumCredentials
* vervallen
2015.11.20 Wijzigingen versie 36
- SchrijfNietlidInOpBulletin
* nieuwe aanroep
2015.12.13 Wijzigingen versie 37
- serverID als optionele parameter
- SchrijfNietlidInOpBulletin
* Maak velden optioneel
2016.01.05 Wijzigingen versie 38
- A.7 GeefLocaties
* optionele parameter JoomlaFilter
- F.4 GeefAlleGroeperingen
* optionele parameter JoomlaFilter
- F.5 GeefAlleKaderRollen
* optionele parameter JoomlaFilter
2016.01.15 Wijzigingen versie 39
- H.3 GeefMijnGegevens
* geeft nu ook hccOptIn terug
* geeft nu ook JoomlaToken terug
- H.4 PasOptInKeuzeAan
* nieuwe aanroep
- SiteID en RemoteID als optionele parameter
2016.03.17 Wijzigingen versie 40
- H.5 ZoekKaderLeden
* nieuwe aanroep
2016.03.20 Wijzigingen versie 41
- ServerID, SiteID en RemoteID als optionele parameters bij alle aanroepen
- A.7 GeefLocaties
* optionele parameter KadernetFilter
- A.9 GeefLocatieNamen
* optionele parameter KadernetFilter
- F.4 GeefAlleGroeperingen
* optionele parameter KadernetFilter
- F.5 GeefAlleKaderRollen
* optionele parameter KadernetFilter
- F.6 WijzigHccRol
* vervallen
- F.7 IsGroeperingsKaderlid
* vervallen
- 8.3 IsDezePseudoniemNogBeschikbaar
* vervallen
- 2.7 SchrijfOptInKeuzen
* vervallen
- 2.5 WijzigGebruikersGegevens (hccPseudoniem)
* vervallen
- H.2 MatchPostcodeMetRegio
* vervallen
2016.04.02 Wijzigingen versie 42
- H.6 GeefMijnKaderDetails
* nieuwe aanroep
2016.07.03 Wijzigingen versie 43
- Ubuntu 16.04 aanpassingen (PHP versie 7) beschreven
2016.09.01 Wijzigingen versie 44
- H.5 ZoekKaderLeden
* extra parameter 'hccMobiel'
2016.10.13 Wijzigingen versie 45
- H.3 GeefMijnGegevens (dedecated Joomla aanroep)
* hccForumLogin weg als parameter
* Als het om een webmaster gaat, vul dan eventueel hccRegio of hccIG aan
met die groepering, ook als hij geen lid is van die groepering
- I.4 GebruikerBestaatControle
* hccForumLogin weg als parameter
2016.12.01 Wijzigingen versie 46
- 8.3 IsDezePseudoniemNogBeschikbaar teruggezet
2017.05.28 Wijzigingen versie 47
- H.7 GeefMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
- H.8 ZetMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
2017.09.01 Wijzigingen versie 48
- A.10 SchrijfNietlidInOpBulletin nu alleen voor 1 bulletin tegelijk
- 2.2 WijzigGebruikersGegevens (op basis van gebruikersnaam en wachtwoord)
is vervallen (was een oude Drupal aanroep)
- A.3 ZoekGroeperingsLid geeft ook hccKaderToonMobiel terug
- H.7 GeefMinimaleKaderGegevens geeft ook hccKaderToonMobiel terug
2017.11.14 Wijzigingen versie 49
- A.3 ZoekGroeperingsLid geeft geen hccKaderToonMobiel meer terug
- A.3 ZoekGroeperingsLid geeft alleen hccMobiel als hccKaderToonMobiel dat toestaat
2018.02.18 Wijzigingen versie 50
- H.6 GeefMijnKaderDetails geeft ook hccKaderToonMobiel terug
- H.9 PasKaderGegevensAan
* nieuwe aanroep
- H.3 GeefMijnGegevens geeft 3 extra parameters terug (hccKaderMail, hccKaderForward,
hccKaderToonMobiel)
- JoomlaTokens worden gevalideerd op siteID, niet langer op serverID
- diverse aanroepen kunnen nu ook via de bezoekersregistratie-proxy aangeroepen worden.
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
(GeefAlleGroeperingen, GeefAlleKaderRollen, GeefLocaties, GeefLocatieNamen)
De bezoekersregistratie aanroepen hebben enkel JoomlaToken als extra parameter nodig:
(LidBezoektBijeenkomst, GeefBezoekersOverzicht)
2018.02.26 Wijzigingen versie 51
- H.3 GeefMijnGegevens geeft extra parameter hccMobiel terug
- H.9 PasKaderGegevensAan kan nu ook kadermail password aanpassen
- K.1 ValideerToken
* nieuwe aanroep
- K.2 ValideerHCCCode
* nieuwe aanroep
2018.03.17 Wijzigingen versie 52
- H.3 Haal al mijn gegevens
Extra optie 'compact' om alleen essentiele resultaten te verkrijgen
(t.b.v. de Android bezoekersregistratie applicatie)
2018.03.25 Wijzigingen versie 53
- I.2 IsHCCLid
(Oude aanroep teruggezet, wordt nog in vraagbaak module gebruikt)
2018.07.01 Wijzigingen versie 54
* A.1 beheer authenticatie op basis van lidnummer + hccCode (tbv VZ-portal)
* A.2 HaalPC30Token weggehaald
2018.08.22 Wijzigingen versie 55
* 1.2 GebruikerBestaatControle' (op basis van hccLogin en userPassword) weggehaald
* 1.4 GebruikerBestaatControle' (op basis van zoekHccLogin of zoekHccLidnr) weggehaald
* 2.8 HaalOptInLijst weggehaald
* E.1 PasKaderWachtwoordAan weggehaald
* F.1 IsKaderLid (op basis van hccLidnr en hccCode) weggehaald
* F.3 IsKaderLid (op basis van beheerdernaam en beheerderwachtwoord) was al weg
* F.8 ZetKaderForward weggehaald
* H.1 IsGroeperingsLid weggehaald
* H.6 GeefMijnKaderDetails weggehaald
* H.7 GeefMinimaleKaderGegevens weggehaald
* H.8 ZetMinimaleKaderGegevens weggehaald
* K.1 ValideerHCCCode weggehaald
* K.2 ValideerToken weggehaald
* H.3 GeefMijnGegevens geeft omvang kader mailbox mee terug
2018.11.06 Wijzigingen versie 56
Nieuwe aanroepen t.b.v. forum en vraagbaak autorisaties
* L.1 MaakOnderwerp
* L.2 VerwijderOnderwerp
* L.3 GeefOnderwerpen
* L.4 MuteerOnderwerp
* L.5 MuteerOnderwerpAutorisatie
* L.6 ToonOnderwerpAutorisatie
* H.5 ZoekKaderLeden heeft compact optie
2018.11.16 Wijzigingen versie 57
* L.5 MuteerOnderwerpAutorisatie kent nu ook RED(acteur)
2018.12.17 Wijzigingen versie 58
* A.11 GeefBezoekersAantallen (nieuwe aanroep)
* H.10 PasUserWachtwoordAan (nieuwe aanroep)
2019.02.21 Wijzigingen versie 59
* A. 6 GeefBezoekersOverzicht geeft enkel lijst van bezoekers laatste bijeenkomst
2019.10.26 Wijzigingen versie 60
* A.4 Schrijf bezoekers niet meer automatisch in op bulletins
* H.4 PasOptInKeuzeAan kan ook door LA aangeroepen worden
Nieuwe aanroepen t.b.v. eigen implementatie van mijn.hcc.nl in de Joomla modules
* H.11 PasPseudoniemAan
* H.12 ValideerWachtwoordEisen
* H.13 PasWachtwoordAan (1: op JoomlaToken, 2: op PWResetToken)
* H.14 MaakPWResetToken
* H.15 ValideerPWResetToken
* H.16 RuimJoomlaTokenOp
* A.12 GeefAlleBulletins
* A.13 ExpandeerPostcode
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.18 NormaliseerTelefoon
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
* A.21 HaalIGBedragenOp
* A.22 HaalTariefGroepenOp
* A.23 PasInteressegroepAan
* F.10 MuteerGroeperingSamenstelling
* A.24 GeefSSOUrls
Aanpassingen gemaakt aan
8.1 MaakGebruikerAan
F.5 GeefAlleKaderRollen
2020.01.04 Wijzigingen versie 61
Nieuwe aanroepen t.b.v. IDEAL betaling hobbynet abonnees
H.17 GeefAantalDomeinen
2020.01.06 Wijzigingen versie 62
Nieuwe aanroepen t.b.v. Cayentis (CRM webproxy) implementatie
* M.1 Upload_CSV_bestand
* M.2 SchrijfNieuwLidIn
* M.3 Verwerk_JSON_mutatie
* M.4 ISO_landcode
* M.5 MuteerAanmeldingsformulier
* M.6 HaalAanmeldingsformulier
* M.7 GeefFactuurOverzicht
* M.8 HaalFactuur
* A.25 UpdateNAW
Vervallen aanroepen
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
Aangepaste aanroepen
* A.23 PasInteressegroepAan
2020.03.27 Wijzigingen versie 63
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.18 ResetHCCCode
* H.19 PasHccLoginAan
2020.04.10 Wijzigingen versie 64
Nieuwe aanroepen
* A.26 VerwijderNietLid
Aanpassingen gemaakt aan
* A.1 ZoekHCCLid: nieuwe zoekoptie 'niet_leden'
Opnieuw geimplementeerd
* A.20 UpdateMobiel
2020.11.26 Wijzigingen versie 65
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.20 MaakTestLogin
Aanpassingen gemaakt aan
- H.3 GeefMijnGegevens: optionele parameter 'hccGroepering'
Het werken met een testaccount heeft impact op de volgende aanroepen:
- G.7 GeefFactuurOverzicht
- M.8 HaalFactuur
- L.1 MaakOnderwerp
- H.14 MaakPWResetToken
- F.10 MuteerGroeperingSamenstelling
- L.4 MuteerOnderwerp
- L.5 MuteerOnderwerpAutorisatie
- H.19 PasHccLoginAan
- A.23 PasInteressegroepAan
- H.9 PasKaderGegevensAan
- H.4 PasOptInKeuzeAan
- H.11 PasPseudoniemAan
- H.13 PasWachtwoordAan
- H.18 ResetHCCCode
- A.20 UpdateMobiel
- A.25 UpdateNAW
- L.2 VerwijderOnderwerp
- A.5 VraagLidgegevensTokenAan
- 2.1 WijzigGebruikersGegevens
- H.3 GeefMijnGegevens geeft extra parameter terug (testaccount)
</pre>

= Aanpassingen aan de Apache omgeving =

== php.ini aanpassingen ==
De XML-RPC server zal 'ergens' een bestand moeten kunnen vinden met de
gebruikersnamen t.b.v. het authenticeren bij de LDAP-server.

Dit bestand wordt geplaatst in de map '/usr/local/hobbynet/etc'. Om dit
vanuit Apache te mogen benaderen, dient een aanpassing aan php.ini
gemaakt te worden:

/etc/php5/apache2/php.ini

include_path = ".:/usr/share/php:/usr/share/pear:/usr/local/hobbynet/etc"

== Apache modules ==
Nieuwe server geschikt maken voor XML-RPC gebruik

=== Apache modules (PHP 7) ===
Ubuntu 16.04 wordt standaard met PHP versie 7.0 uitgeleverd.
De opdrachten om de modules op te halen zijn:
apt-get install php-xmlrpc
apt-get install apache2
apt-get install ldap-utils
apt-get install php-ldap
apt-get install libapache2-mod-php

== Loadbalancer akties niet naar de logbestanden schrijven ==
De loadbalancer haalt zeer frequent een testbestand op (/test.txt), om
te controleren of de xml-server operationeel is. Dat levert extreem veel
logging op in /var/log/apache2/other_vhosts.log.

Pas de apache configuratie zo aan, dat logging van alle opvragingen
vanaf de loadbalancers uitgezet wordt.
/etc/apache2/sites-enabled/xml-server

# Mark requests from loadbalancers
SetEnvIf Remote_Addr "212\.72\.227\.93" dontlog
SetEnvIf Remote_Addr "212\.72\.227\.94" dontlog
SetEnvIf Remote_Addr "172\.31\.1\.249" dontlog
SetEnvIf Remote_Addr "172\.31\.1\.250" dontlog
CustomLog ${APACHE_LOG_DIR}/access.log common env=!dontlog

= Firewall algemeen =
In de file /etc/hobby-firewall/hobby-firewall.local wordt het script
'/usr/local/hobbynet/bin/gen_fw.sh' aangeroepen.
Deze haalt de IP adressen op uit ldap.
(.local omdat we dit ook zo doen op de webservers).

De firewall wordt 4 x per dag herstart en /etc/hobby-firewall wordt
gesynchroniseerd (1-richting van lb1 naar lb2) met de volgende crontab
entries:

Op lb1:
0 0 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 5 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 11 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 17 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 23 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null

Op lb2:
15 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 0 * * * /etc/init.d/hobby-firewall restart >/dev/null

Het encrypted backup script is verplaatst naar '/usr/local/hobbynet/local' en hernoemd naar 'backup-encrypted.bash'.
Dit is omdat deze niet mee mag worden gesynchroniseerd.

Tevens wordt 1x per dag /usr/local/hobbynet/bin gesynchroniseerd (1-richting van hcc-ldap-lb1 naar hcc-ldap-lb2)

== Aanpassingen in de firewall ==
Op de server waar de XML-RPC server staat, moeten enkele firewall aanpassingen gemaakt worden.
* inkomend: sta TCP 443 toe vanaf het interne netwerk (www-prod, www-test), en vanaf eventuele andere plekken die we expliciet toe willen staan.
* inkomend: sta TCP 443 toe vanaf mijn.hcc.nl (XML-RPC aanroepen vanaf de portal)
* inkomend: sta TCP 443 toe vanaf service.hccnet.nl toe (XML-RPC aanroep GeefUitgeschrevenLeden vanuit HenZ)
* uitgaand: sta TCP 443 naar service.hccnet.nl toe (XML-RPC aanroepen naar HenZ)
* uitgaand: sta TCP 990 en 5000-6000 naar Apps.HCC.local (FTPS verkeer naar de HCC server bij Hobbynet)

== Aanpassingen aan AppArmor ==
Alhoewel technisch gezien dit bij slapd behoort, neem ik het toch hier op.

Als het Hobbynet certificaat in de map /disk/site/etc/ssl/hobby.nl/ wordt neergezet, dan zal apparrmor de toegang tot de certificaten blokkeren. Neem daarom in de '''local''' directory van apparmor het volgende op:
# /etc/apparmor.d/local/usr.sbin.slapd
# Site-specific additions and overrides for usr.sbin.slapd.
# For more details, please see /etc/apparmor.d/local/README.
#include <abstractions/ssl_certs>
/disk/site/etc/ssl/hobby.nl/ r,
/disk/site/etc/ssl/hobby.nl/* r,

= CRM (Azure) proxy herstarten =
Als er indicaties zijn dat niet alle JSON berichten meer vanuit het CRM aangeboden worden aan de xml-rpc server, dan kan het helpen om de CRM proxy te herstarten

* Ga naar https://portal.azure.com/
* Login met zelfde account als voor het CRM
* Soms krijg je een popup. Die kan je weg klikken, je wilt geen rondleiding
* Klik op '''hccdyn01-aps-crm01''' voor productie en '''hccdyn01-aps-dev01''' voor test
* En dan kan je op opnieuw starten klikken.

Loadbalancers

2020-12-29T13:49:31Z

Hans:

=doel=
De loadbalancer zorgt er voor dat onze webdiensten redundant uitgevoerd worden.
= OPGELET =
''' heel belangrijk ''' de loadbalancer mag je nooit migreren als ze aan staan, hierdoor krijg je een 'split brain' situatie

Dit is dan ook geblokkeerd in vmware zoals omschreven hier https://frankdenneman.nl/2014/08/18/disable-vmotion-single-vm/ met 1 aanpassing query mag wel en vmotion als uit staat mag wel

=opzet=
We hebben 2 virtuele loadbalancers: loadbalancer1 en loadbalancer2. Elk draait op een andere hypervisor te weten vmware4 en vmware5

== normale situatie ==
Dit geeft weer hoe in normale situaties het verkeer loopt. 
[[File:normaal.png|600px]]

[[File:normaal.dia]]

== webserver faalt ==
Dit geeft weer hoe het verkeer loopt wanneer een webserver faalt. 
[[File:webserverfaalt.png|600px]]

[[File:webserverfaalt.dia]]

== loadbalancer faalt ==
Dit geeft weer hoe het verkeer loopt wanneer een loadbalancer faalt. 
[[File:lbfaalt.png|600px]]

[[File:lbfaalt.dia]]

=IP plan=
== 212.72.224 IP reeks (eth1)==
<pre>
212.72.224.240 2a02:968:1:2:212:72:224:240 loadbalancer1-vlan100.hobby.nl (IP adressen voor loadbalancer zelf)
212.72.224.241 2a02:968:1:2:212:72:224:241 loadbalancer2-vlan100.hobby.nl (IP adressen voor loadbalancer zelf)
</pre>

==== 212.72.227 IP reeks (eth3)====
<pre>
212.72.227.88 en 2a02:968:1:7:212:72:227:88 loadbalancer1-vlan107.hobby.nl (IP adressen voor loadbalancer zelf)
212.72.227.89 en 2a02:968:1:7:212:72:227:89 loadbalancer2-vlan107.hobby.nl (IP adressen voor loadbalancer zelf)
</pre>

==== 212.72.229 IP reeks (eth2)====
<pre>
212.72.229.240 2a02:968:1:1:212:72:229:240 loadbalancer1-vlan102.hobby.nl (IP adressen voor loadbalancer zelf)
212.72.229.241 2a02:968:1:1:212:72:229:241 loadbalancer2-vlan102.hobby.nl (IP adressen voor loadbalancer zelf)
</pre>

</pre>

==== 172.31.1 IP reeks (eth0) ====
<pre>
172.31.1.240 2a02:968:ffff:999:172:31:1:240 loadbalancer1-vlan999.hobby.nl (IP adressen voor loadbalancer zelf)
172.31.1.241 2a02:968:ffff:999:172:31:1:241 loadbalancer2-vlan999.hobby.nl (IP adressen voor loadbalancer zelf)
</pre>
==== 172.31.254 IP reeks (eth5) ====
<pre>
172.31.254.240 2a02:968:ffff:997:172:31:254:240 loadbalancer1-vlan997.hobby.nl (IP adressen voor loadbalancer zelf)
172.31.254.241 2a02:968:ffff:997:172:31:254:241 loadbalancer2-vlan997.hobby.nl (IP adressen voor loadbalancer zelf)
</pre>
===== dns aliassen =====
Via interne netwerk zijn de dns aliassen aangemaakt loadbalancer1-int.hobby.nl en loadbalancer2-int.hobby.nl op die manier konden gebruik blijven maken van hobbynet wildcard certificaat.

=configuratie=
== termen ==
* Virtual service : De dienst die geloadbalanced wordt (dit kan layer 4 of layer 7 zijn)

Configuratie gebeurt altijd via de webinterface. Enkel bij hele uitzonderlijke gevallen moet je wat via SSH doen.

De loadbalancers zijn te bereiken via:
* https://loadbalancer1-int.hobby.nl:9443/
* https://loadbalancer2-int.hobby.nl:9443/

== ssh toegang ==
SSH keys kunnen toegevoegd worden, dit vereist echter strak formaat namelijk
ssh-rsa <snip> je key </snip> bas@een.domein.nl
Het is heel belangrijk dat je key in dit formaat is, ook ben je verplicht een hostnaam in te geven, gebruik daarvoor gewoon je naam dit moet namelijk uniek zijn. 
'''Key's mogen niet met de hand worden toegevoegd via SSH !''' 
Je kan in de loadbalancer onder Local Configuration -> SSH Keys en dan het tab SSH Authentication

'''Configuratie van dit onderdeel moet je op beide loadbalancers doen want dit wordt niet gerepliceerd!'''

= Direct routing =
Op dit moment maken we nog gebruik van direct routing, dit wil zeggen dat de loadbalancer het inkomend verkeer door stuurt naar de server en de server stuurt zelf het antwoord door naar de client.

== standaard setup ==
Standaard gebruiken wij een setup waarbij altijd de load over meerdere servers verspreid wordt

=== instellen van Virtual service layer 4 ===

==== van scratch ====
Ga naar cluster configuration -> layer 4 - virtual services en klik daar op 'Add a new Virtual Service'

* 1) Vul hier de naam van virtual service in. Standaard is dat VIP(nr) naam.url.nl-v4 (of v6 bij IPv6) ('''let op: geen spatie tussen vip en het nummer van de vip''')
* 2) Het IP-adres wat aan de buitenkant wordt gebruikt
* 3) De poort nummers voor web standaard 80,443 je mag meer poort nummers opgeven door te scheiden met een ,
Klik op update

[[File:Add Virtual service layer 4 stap1.png|600px]]

Herhaal de bovenstaande stappen voor het IPv6 adres

Nu moeten we nog bestemming toevoegen : waar moet het verkeer naar toe worden gerouteerd.

Ga naar cluster configuration -> layer 4 - Real Servers 
Zoek daar je Virtual service op en klik op modify

Tip je standaard staat de Virtual service die je net hebt gemaakt onderaan 
Klik op 'Add a new Real Server" bij de Virtual service die we net hebben aangemaakt

1) Zet naam van de bestemming neer dit geval Joomla-lb1-v4 (of v6 bij IPv6)
2) Vul het IP-adres van de bestemming in
3) Klik op update

[[File:Add a new Real server.png|600px]]

Indien het hier geen fallback scenario betreft herhaal de bovenstaande stap voor de 2e bestemming

Herhaal deze stappen voor IPv6 virtual service

===== fallback scenario =====
Bij fallback senario wil je dat verkeer standaard op 1e server uitkomt, behalve wanneer deze er niet is. Bijvoorbeeld bij mail en de xml-rpc server, in dit geval voeg je '''geen''' 2e realserver toe.

Ga terug naar cluster configuration -> layer 4 - virtual services, zoek je virtual service op en klik op modify 
TIP boven in zit zoek veld

* Zoek de sectie 'Fallback Server' op
* Vul het IP-adres in van de fallback server in, laat de overige velden leeg
* klik op update
Herhaal deze stappen voor IPv6 virtual service

[[File:Fallback server.png|600px]]

==== bestaande virtual service kopiëren ====
Maar dit alles kan ook veel makkelijker, als er alleen vip is die de zelfde bestemming heeft etc etc

Ga terug naar cluster configuration -> layer 4 - virtual services, zoek je virtual service op die je kopiëren en klik op modify 
Zie afbeelding 5 rechts 
Klik op Duplicate service

[[File:Duplicate service.png|600px]]

Negeer de waarschuwing is melding dat toevoeging heeft gedaan zodat er geen dubbele namen zijn
* 1) Vervang hier de naam van virtual service. Standaard is dat VIP(nr) naam.url.nl-v4 (of v6 bij IPv6) ('''let op : geen spatie tussen vip en het nummer van de vip''')
* 2) Vervang het IP-adres wat aan de buitenkant wordt gebruikt
* 3) Controleer de poortnummers voor web standaard 80,443 je mag meer poortnummers opgeven door te scheiden met een , 
Klik op update 
Herhaal deze stappen voor IPv6 virtual service

[[File:Duplicate service2.png|600px]]

= firewall lock down script =
Het standaard lockdownscript (de term die in de loadbalancer wordt gebruikt) is aangepast met de volgende de aanpassingen:
* Onze VPN IP-reeksen toegevoegd als admin reeksen
* Voor SNMP is aparte chain aangemaakt
* Al het SNMP verkeer dat niet het IP-adres (eth0) van de loadbalancer is wordt gereject
Hier vindt je kopie van het huidige lockdown script van 28-09-2020 10:00
[[File:Lockdownscript.txt]]
Dit script kan je bewerken via Maintenance -> Firewall Lock Down Wizzard 
Met 'Modify the firewall lock down wizard script' pas je het script aan. 
Met 'Update Firewall lockdown' wordt het de firewall herladen 
Standaard wordt het IP-adres waarmee je bent ingelogd ingevuld bij 'Administration subnet'. Dit is om te zorgen dat je er altijd weer in kan als je een foutje hebt gemaakt.

'''Configuratie van dit onderdeel moet je op beide loadbalancers doen want dit wordt niet gerepliceerd!'''

= backup =
Elke dag backuppen we om 22:00

== ssh_config aanpassing ==
Omdat de loadbalancer heel veel IP-adressen heeft zou het script ad random een IP-adres uitzoeken en dat gaat natuurlijk fout. Daarom hebben we een source IP-adres gespecificeerd. In /etc/ssh/ssh_config zijn daarom volgende regels toegevoegd:
<pre>
host backup2bit-int.hobby.nl
BindAddress=2a02:968:ffff:999:172:31:1:240
</pre>
Verder wordt standaard script dat ook logging draait gebruikt voor de backup /usr/local/hobbynet/bin/backup_etc

= handleidingen=
Deze vind je in de loadbalancer onder support -> Useful Links

= uitzonderingen =
Voor dbadmin*.hobby.nl en vraagbaak.hcc.nl is er uitzondering daar wordt geen applicatie cookie gebruikt voor Persistence Mode, maar het source IP-adres, de applicatie kan er niet tegen

= LET OP : update instructies =
1. schakel master uit
2. maak snapshot in vmware van master
3. zet master weer aan
4. wacht tot master weer helemaal op is
5. zet slave uit
6. maak snapshot slave
7. zet slave weer aan.
8. maak via web interface backup van alle bestanden en download die op master
9. maak via web interface backup van alle bestanden en download die op slave (zodra slave weer volledig operationeel is)
10. maak slave master (login op slave, vouw groene vlak open en klik op take over)
11. update master via Maintenance -> software update en kies voor online update
12. maak master weer master (login op slave, vouw groene vlak open en klik op take over) als dat niet al vanzelf is gebeurd
11. update slave via Maintenance -> software update en kies voor online update
12. Zet reminder in OTRS om snap shots te verwijderen na 4 dagen (dit kan terwijl machines online zijn)

== aandachts punten ==
1. altijd dienen master en slave direct na elkaar te worden geupdate
2. het maken van het snapshot moet gebeuren als de VM uit staat ! dit komt om dat de VM vertraagd wordt tijdens het maken van het snapshot waardoor hij meerdere keren gaat overschakelen naar slave en weer terug.
3. Mocht de update mislukken kan met paar klikken terug naar het snapshot wat je voor de update hebt gemaakt.

Speciale groepen in ldap en CRM

2020-12-27T11:44:48Z

Hans:

Er zijn speciale groepen in CRM met speciale functie deze hebben standaard 3 of 4 letters hier onder lijst

= SRVB =

Deze groep wordt gebruik voor het faciliteren van de mailing list van de vraagbaak 
Deze groep heeft 1 lid namelijk Bas (lidnummer 199641) (zonder leden in het CRM werd de groep vanuit het CRM niet geëxporteerd). 
De afspraken over deze groep zoals die met kantoor zijn gemaakt zijn als volgt: 

* Autorisatie kunnen alleen gedaan worden door Hobbynet
* '''niemand''' wordt lid van deze groepering behalve Bas
* Er worden '''geen''' kaderrollen aan deze groepering gekoppeld
* Deze groep wordt nergens anders voor gebruikt
* Deze groep heeft geen functionele e-mail adressen
* Deze groep wordt niet meegenomen in overzicht op kadernet

= NWF =

NWF wordt gebruikt als export van HCC!nieuwsbrief

<strike>Sinds medio 2017 worden de NWF inschrijvingen in het CRM bijgehouden. Zowel de in- als ook de uitschrijvingen moeten sinds dat moment dus aan LA door worden gegeven.
CRM is leidend.</strike>

= SITE =

Deze groep wordt gebruikt voor autorisaties voor www.hcc.nl website 

De afspraken over deze groep zoals die met kantoor zijn gemaakt zijn als volgt: 

* Autorisatie kunnen alleen gedaan worden door Bas, Joris en Bert
* Bij het toekennen van nieuwe autorisatie wordt persoon lid gemaakt van deze groepering en krijgt de bijbehorende kaderrol
* De volgende kaderrollen mogen alleen gebruikt worden:
** Redacteur
** Agenda Beheerder
** Webmaster
* Is de kaderrol ingetrokken bij deze groep, en er zijn verder geen kaderrollen meer, dan moet de ledenadministratie deze persoon ook weer uitschrijven uit deze groepering.
* Deze groep heeft geen nieuwsbrief of functionele e-mail adressen
* Deze groep wordt niet meegenomen in het overzicht op kadernet

= KNET =

Deze groep wordt gebruikt voor autorisaties voor kadernet.hcc.nl website

De afspraken over deze groep zoals die met kantoor zijn gemaakt zijn als volgt: 

* Autorisatie kunnen alleen gedaan worden door Bas, Wijnand en Bert
* Bij het toekennen van nieuwe autorisatie wordt persoon lid gemaakt van deze groepering en krijgt de bijbehorende kaderrol
* De volgende kaderrollen mogen gebruikt worden
** Redacteur
** Agenda Beheerder
** Webmaster
* Is de kaderrol ingetrokken bij deze groep, en er zijn verder geen kaderrollen meer, dan moet de ledenadministratie deze persoon ook weer uitschrijven uit deze groepering.
* Deze groep heeft geen nieuwsbrief of functionele e-mail adressen
* Deze groep wordt niet meegenomen in overzicht op kadernet

= COSA =
Speciale groepering, bedoeld om leden van Beleggen, die deelnemen aan hun COSA sub-werkgroep, een nieuwsbrief te kunnen sturen.

= DEMO =
Behoort bij de demo omgeving

= HKAS =
Leden van de kascommissie hebben de rol 'LID'. Dienen in het CRM ook aan deze groepering gekoppeld te worden, en weer ontkoppeld als ze de rol opgeven.

= KADE =
Een virtuele groepering, die 'onder water' gebruikt wordt. Alle kader- en kernleden maken deel uit van deze groepering.

= PCAS =
Deze groep wordt gebruikt voor autorisaties voor www.pcactive.nl website 
De afspraken hieromtrent zijn min of meer gelijk aan die van SITE

= PNNL =
Een (mislukte?) poging om de noordelijke groeperingen 1 overkoepelende site te geven

Main Page

2020-12-27T10:26:07Z

Hans:

===Hobbynet Admin WIKI===
Shortcuts
[http://otrs.hobby.nl/ HobbyNet Ticket systeem] - OTRS
[https://nagios.hobby.nl/nagios Nagios monitoring] -[[Nagios|''' Uitleg''']]
[https://wiki.hobby.nl/getip.html Waar draait een website] - simpel tooltje om te kijken waar een website draait.

===Algemene informatie===
[[HCC!Hobbynet]] - Wat is Hobbynet - een uitleg voor kantoor (zie ook discussie tab)
[[HCC!verenigingsdag]] - Een draaiboek voor de HCC!verenigingsdag
[[Evenementen lan]] - Een draaiboek voor een Evenementen LAN
[[Kadernet]] - Info over Kadernet voorzieningen (website, forum, etc.)
[[Financien]] - Financiële aspecten van Hobbynet
[[inventaris]] - Hobbynet inventaris overzicht t.b.v. hcc kantoor
[[Windows_licenties]] - Hobbynet overzicht van de windows licenties
[[Beheerders]] - Hobbynet beheerders
[[server_certs]] - Hobbynet CAcert certificaten
[[Hobbykeys]] - Info over het hobbykeys script
[[accounts]] - Diverse account gegevens (o.a. knoppix.nl)

===HCC.NL website platform===
hcc.nl [[netwerk]] - Netwerk voor hcc.nl website platform
[[XML-RPC]] - XML-RPC interface t.b.v. LDAP
[[XML-HENZ-PROXY]] - XML-RPC HenZ proxy t.b.v. cronjob toegang tot HenZ
[[www-prod-lb*]] - Productie servers (loadbalanced)
[[Protocol_onderhoud]] - Afspraken rondom onderhoud en meldingen aan hcc.nl webmasters

===Toegang===
[[KVM over IP]] - Beheer op afstand m.b.v. KVM over IP apparatuur
[[beheerder_accounts]] - Beheerder accounts aanmaken / bijhouden
[[Aanmaken_Gebruiker]] - Aanmaken van een gebruiker
[[Opzeggen_Gebruiker]] - Opzeggen van een gebruiker

===Algemene services===
[[Backup]] - Zo backupen we
[[scp]] - Hobbynet filetransfer omgeving
[[sftp]] - Hobbynet sftp omgeving kantoor en Tripolis
[[Redirect server]] - De redirect server
[[EMAIL]] (ook postfixadmin) - Email server documentatie
[[Roundcube Webmail]] - Upgrading Roundcube
[[LDAP]] (server en client) - LDAP setup
[[LDAP login Authenticatie]] - Om op (web)servers login via LDAP te doen
[[LDAP scripting]] - Scripting die op ldap-lb1 draait
[[LDAP Administrative account]] weg! - Hoe te handelen als het administrative account opeens weg is
[[LDAP groeperings vlaggen]] - Welke vlaggen zijn er voor een groepering en waar dienen ze voor
[[SFTP server]] - sftp server voor uitwisseling met kantoor en tripolis
[[Speciale groepen in ldap en CRM]] - Speciale groepen in ldap en CRM
[[PXE]] - Hobbynet PXE omgeving
[[Web cluster]] - Beschrijving van het Web cluster
[[Loadbalancers]] - Beschrijving van de LoadbalancerNG
[[Nagios]] - Beschrijving van Nagios
[[Nagios_upgrade]] - Hoe upgrade ik Nagios vanuit source
[[Hobbynet repository]] - Informatie over de Hobbynet repository
[[Hobbynet repository inhoud]] - Wat zit er in de Hobbynet repository
[[Cron jobs]] - Niet standaard cronjobs die lopen bij hobbynet
[[Fail2ban]] - Block possible intruders and bots
[[Groepering_hernoemen]] - Beschrijving van het hernoemen van een groeperingsnaam
[[killdisk]] - Software voor secure wissen van disken
[[Wij jitsi server]] - HCC Jitsi server
[[VMware installatie]] - Handige hulpjes bij installatie vmware

=== nieuwe omgeving 03-11-2020 ===
[[Cephfs]] - Shared storage
[[Switches]] - Switches
[[iSCSI]] - iSCSI
[[Automatische installatie]] - Automatische installatie via iPXE
[[iPXE]] - iPXE
[[Sambabal]] - server die Samba shares verzorgt
[[VMware 1 t/m 3]] - vmware 1 t/m 3
[[VMware 4 t/m 6]] - vmware 4 t/m 6
[[Vcenter]] - Beheersomgeving VMware Vcenter
[[MySQL cluster]] - Beschrijving van het MySQL cluster

=== dns ===
[[DNS]] - DNS instellingen t.b.v. de domeinen
[[domein]] - Direct naar domein
[[ns1]] - Direct naar ns1.hobby.nl
[[ns2]] - Direct naar ns2.hobby.nl
[[ns3]] - Direct naar ns3.hobby.nl (bij TransIP)
[[ns4]] - Direct naar ns4.hobby.nl (bij TransIP)
[[Resolv*-int]] - Direct naar resolv nameserver pagina (draait op [[resolv-lb1]], [[resolv-lb2]] en [[resolv-lb3]])
[[DNSSEC ds records publiceren]] - Scripting t.b.v. het publiceren van DNSSEC DS records.
[[DNS scripting]] - Overige DNS scripting
[[DNS Zone updaten]] - een zone updaten
[[Dane]] - Dane records in dns (wat moet je doen bij nieuw ssl cert)

=== Joomla ===

[[Nieuwe joomla site maken]] - Nieuwe Joomla site maken
[[Joomla_xml_server]] - De XML-RPC-server t.b.v. de Joomla template sites
[[Joomla modules]] - Beschrijving van Joomla modules en processen er om heen
[[Joomla Events RSVP Pro]] - RSVP Pro configureren (beperk bijeenkomst tot x personen)

===Uitleg IP space===
[[netwerk]] - Netwerk tekening van Hobbynet
[[IPv4_space|IPv4]] - IPv4 Hobbynet
[[Ipv6_space|IPv6]] - IPv6 Hobbynet

===Kast indeling===
[[kasten]] - Indeling kasten bij BIT ''(pagina heeft onderhoud nodig)''
[[systems]] - Alle systemen van Hobbynet (hardware & netwerk)
[[Powerboot]] - Indeling APC PDU's (feb. 2013)

===Tuning webservers===
[[Hobby-firewall]] - de Hobbynet firewall
[[PHP via fcgi]] - PHP via fcgi en suexec
[[upg_web]] - Door middel van script server upgraden

[[NFS_settings]] - NFS poort instellingen t.b.v. iptables firewall
[[sync Loadbalanced webservers]] - dit script zorgt dat webserver configs worden gesynct
[[Entropy]] - Hoe zorg ik voor meer Entropy op vmware machine

===VPS voor derden===
[[Ubuntu-nl]] - De Ubuntu-nl virtuele server

=== Hobbynet informatie ===
[[Scripting]] - Een poging om de scripting te beschrijven. WIP!
[[agreements]] - Alle Hobbynet contracten met contract beheerder e.d.
[[ToDo]] - Een wensenlijstje van dingen die we kunnen veranderen/verbeteren

===Updaten===
[[Joomlasites]] - Joomla sites die wij bijhouden
[[MediaWikiSites]] - MediaWiki sites die wij bijhouden

===Nood gegevens===
[[Medische protocol Bas|Medisch protocol bas]] - Medisch protocol bas

Dit is een "mediawiki" (http://www.mediawiki.org/). 
Uitleg over het editen is te vinden op: 
http://meta.wikimedia.org/wiki/MediaWiki_User%27s_Guide 
http://en.wikipedia.org/wiki/Wikipedia:How_does_one_edit_a_page

LDAP

2020-12-09T16:35:49Z

Hans:

==Introductie==
Om een centrale plaats te hebben om authenticatie te doen voor www.hcc.nl en sub-sites zoals een forum, is gekozen voor het gebruik van een LDAP database/directory. Hierin wordt alles opgeslagen wat nodig is voor het functioneren van de site, inclusief NAW gegevens <strike>die op dit moment alleen opgeslagen worden t.b.v. het PC30 beheerscherm</strike>.

==LDAP server keuze==
De voor de hand liggende keuze is OpenLDAP. Echter zijn er geluiden gehoord dat OpenLDAP niet zou schalen. Alternatieven zijn b.v. 389server maar die is erg slecht gesupport onder Ubuntu. Voorlopig starten we met OpenLDAP.

==Loadbalanced==
Er zijn twee servers (ldap-lb1 en ldap-lb2) die achter een loadbalancer in preferred server mode staan zodat het verkeer altijd naar server1 gestuurd wordt. Beide servers houden elkaar up-to-date. In de gewone situatie zullen alle reads en writes naar server1 gaan en server2 wordt door server1 bijgewerkt. Valt server1 weg, dan zal de loadbalancer overschakelen naar server2 waar vanaf dan de read en writes plaatsvinden. Zodra server1 weer beschikbaar is, wordt die bijgewerkt en zal weer master worden.

==Installatie==
Installatie van OpenLDAP is simpel:
aptitude install slapd ldap-utils
Omdat er gebruikgemaakt wordt van php scripts, is het ook nodig '''php-cli''' en '''php-ldap''' te installeren. De configuratie van OpenLDAP is sinds Karmic Koala iets gecompliceerder geworden. 'cn=config' wordt nog steeds gebruikt maar tijdens installatie wordt alleen een skeleton configuratie geïnstalleerd. Er wordt niet meer gevraagd om een password tijdens de installatie en "dpkg-reconfigure slapd" zet alleen de skeleton configuratie terug. Je moet zelf de database, root dn en acl's opzetten (als root of met sudo). Run '''dpkg-reconfigure slapd''' om terug te gaan naar een lege directory.

UPDATE: in Oneiric Ocelot (11.10) is weer wel de mogelijkheid gegeven bij installatie een database aan te maken. Default wordt echter de fqdn hostname gebruikt. Bij dpkg-reconfigure kan het gewenste domein wel opnieuw gegeven worden. De initiële configuratie staat in /usr/share/slapd/slapd.init.ldif.

UPDATE: bij de upgrade naar 16.04.1 zijn proefondervindelijk nog wat extra handelingen nodig gebleken. 
XML-RPC server updaten naar Ubuntu 16.04. WIP!
<pre>
- apt-get install phpmyadmin
- apt-get install aptitude
- apt-get install php-xmlrpc
- apt-get install php-ldap
- phpenmod xml
- phpenmod mysqli
('php -m' toont de geactiveerde modules)
- apache2ctl restart

phpmyadmin werkt niet:
- apt-get install php-mbstring
- apt-get install php-gettext

ontbrekende pakketten volgens hjv:

apt-get install aptitude
apt-get install phpmyadmin
apt-get install php-mbstring
apt-get install php-gettext
apt-get install php-xmlrpc
apt-get install php-ldap
apt-get install mysql-server
apt-get install ldapscripts
apt-get install php-xml
apt-get install slapd
apt-get install ldap-utils
a2enmod ssl

* Voer de laatste stappen uit, zoals beschreven in de Hobbynet wiki: *

- openldap moet lid zijn van de groep ssl-cert!
apt-get install ssl-cert
adduser openldap ssl-cert
(of vi /etc/group
ssl-cert:x:116:openldap)

- Zorg dat de LDAP daemon bij de certificaten kan komen.
LET OP: op alle hobbynet servers staan de certificaten in /disk/site/etc/ssl/hobby.nl/
chgrp ssl-cert /disk/site/etc/ssl/hobby.nl/hobby.nl.*
chmod 440 /disk/site/etc/ssl/hobby.nl/hobby.nl.key
en dus niet langer
chgrp ssl-cert /etc/ssl/private/hobby.nl.*
chmod 440 /etc/ssl/private/hobby.nl.key

- Vertel LDAP (en PHP) clients welke certificaten toegestaan zijn
(2017-09-23: verouderde info, niet langer in gebruik)
vi /etc/ldap/ldap.conf
TLS_CERT /etc/ssl/private/hobby.nl.crt
TLS_KEY /etc/ssl/private/hobby.nl.key
TLS_REQCERT allow

- mysql laat het bestand ibdata1 ongelimiteerd groeien (InnoDB bestanden)
/etc/mysql/mysql.conf.d/innodb_file_per_table.cnf
[mysql]
innodb_file_per_table

=============
Hobbynet aanpassingen
/etc/bash.bashrc
export http_proxy=http://squid-int.hobby.nl:3128
export https_proxy=http://squid-int.hobby.nl:3128
export ftp_proxy=http://squid-int.hobby.nl:3128
</pre>

===Locatie bestanden===
Om de benodigde bestanden op de server te krijgen zal scp gebruikt moet worden. Upload alles in een privé subdirectory. Copiëer daarna alles naar de juiste plaats en verander de owner in root.

* Alle ldif em tmpl bestanden gaan naar /usr/local/hobbynet/lib
* init_ldap en andere scripts gaan naar /usr/local/hobbynet/bin
* alle data bestanden (dumps) en update ldifs gaan naar /usr/local/hobbynet/data
* etc/ldap/schema/hcc_schema.* gaan naar /etc/ldap/schema
* etc/ldap/schema/ppolicy.ldif gaat naar /etc/ldap/schema

==Initiële database==
Direct na installatie (of na dpkg-reconfigure slapd) staat er een werkende doch lege directory in OpenLDAP. Access is alleen geregeld voor root. Dit heeft te maken met het feit dat vanaf Karmic Koala OpenLDAP alleen het minst noodzakelijke bevat om slapd te starten. Wordt echter init_ldap gebruikt dan wordt een werkende directory gemaakt met alle statische data (in diverse ou's) erin. Alleen zijn er geen leden geladen in de ou=leden en ou=inactieve_leden.
===slapd.init.ldif ===
Bij installatie/reconfiguratie wordt /usr/share/slapd/slapd.init.ldif ingelezen. Zie aldaar indien nodig.

==init_ldap script==
Het lokale script init-ldap doet een reset van de initiële Openldap configuratie. Dit heeft tot gevolg dat de DIT dc=hcc,dc=nl met een rootDN '''cn=admin,dc=hcc,dc=nl''' steeds opnieuw aangemaakt wordt. Alles wat we toegevoegd/gewijzigd willen hebben in de cn=config volgt daarna. Dit wordt afgesloten met een restart van de slapd server. Het script '''restore_ldap''' laadt vervolgens de laatste dump terug. Bij wijzigingen aan het schema is het raadzaam altijd een '''dump_ldap''' te doen zodat een later een actuele dump kan worden teruggeladen.

Het (plain text) password van cn=admin,dc=hcc,dc=nl moet bij het aanroepen van '''init_ldap''' op de commandline worden meegegeven. Tijdens de dpkg-reconfigure moet het password nog 2x gegeven worden. Lees eventueel ook de [http://www.openldap.org/doc/admin/ OpenLDAP Admin Guide].

Het init_ldap script bevat allerlei logica om op meerdere ldap servers gedraaid te kunnen worden. In grote lijnen valt het script in een aantal blokken uiteen:
* voorbereidingen om "dpkg-reconfigure slapd" te draaien
* definities van input files
* check host
* bouwen van het skelet van de nieuwe directory
Zie voor details van de scripts '''init_ldap''', '''dump_ldap''' en '''restore_ldap''' op een van de servers (in /usr/local/hobbynet/bin).

==onderdelen van init_ldap==
Init_ldap is opgezet om stap voor stap de database op te bouwen. Hieronder een beschrijving van de losse ldif bestanden die ingelezen worden. Incidenteel wordt een ldif gewijzigd; kijk altijd in de actuele bestanden!

===add-schema.ldif===
Omdat wij een aantal eigen attributes en Objectclasses hebben toegevoegd aam het schema, moeten deze aan OpenLDAP worden toegevoegd. Het schema moet nog worden omgezet naar ldif format.
* Hiertoe wordt het onderstaande schema in /etc/ldap/schema geplaatst als hcc_schema.schema.
* Vervolgens worden de stappen uitgevoerd zoals beschreven in de [https://help.ubuntu.com/11.10/serverguide/C/openldap-server.html Ubuntu Server guide], onder '''Modifying the slapd Configuration Database'''.
* De resulterende output file '''cn=hcc_schema.ldif''' moet dan nog naar /etc/ldap/schema/hcc_schema.ldif gecopieerd worden.
Als dit proces herhaald moet worden, start dan met een lege output directory en verwijder een eventueel achtergebleven cn=hcc_schema.ldif bestand.

De extra schema's worden middels een '''include''' toegevoegd. '''Ppolicy''' is op gelijke wijze als '''hcc_schema''' tot .ldif geconverteerd. Alle stappen om een nieuwe '''hcc-schema.ldif''' te maken zijn gescript in '''upd_schema'''. In '''init_ldap''' wordt het eigen schema en de password policy geladen:
<pre>
#######################################
## add-schema.ldif ##
#######################################
include: file:///etc/ldap/schema/hcc_schema.ldif
include: file:///etc/ldap/schema/ppolicy.ldif
include: file:///etc/ldap/schema/ldapns.ldif
</pre>

====schema updates====
Soms wordt een attribute toegevoegd of gewijzigd. Hiertoe dient het bestand hcc_schema.schema in /usr/local/hobbynet/etc/ldap/schema, gewijzigd te worden. Daarna dient er een ldif versie van gemaakt te worden. Gebruik hiervoor '''upd_schema.sh''' in dezelfde directory. De resulterende hcc_schema.ldif wordt in dit script naar /etc/ldap/schema gecopieërd. Bij grote wijzigingen is het aan te bevelen door de hele rebuild cycle te gaan (dump, init, restore). Bij triviale aanpassingen zou hcc_schema.ldif ook '''direct''' in de actieve directory geplaatst kunnen worden, gevolgd door slechts een '''service slapd restart'''. Gebruik hiervoor (blijf in de lokale schema directory):
<pre>
cp "ldif_output/cn=config/cn=schema/cn={14}hcc_schema.ldif" "/etc/ldap/slapd.d/cn=config/cn=schema/cn={4}hcc_schema.ldif"
</pre>
LET OP: De nummers tussen accolades zijn bepaald door de volgorde van andere scripts! Zolang geen andere schema's worden toegevoegd zullen ze niet veranderen.
 
Ook kan met de ldap-tools gewerkt worden. Gebruik ldapsearch en ldapmodify, eventueel met de -f optie om een voorbereide serie opdrachten uit te voeren. Gebruik ldapsearch om eerst de structuur te vinden:
<pre>
$ sudo ldapsearch -Q -LLL -Y EXTERNAL -H ldapi:/// -b cn={4}hcc_schema,cn=schema,cn=config
</pre>
Hier een voorbeeld om een objectClass aan te passen:
<pre>
$ cat pas_aan.ldif
dn: cn={4}hcc_schema,cn=schema,cn=config
changetype: modify
delete: olcObjectClasses
olcObjectClasses: {7}( 1.3.6.1.4.1.12795.2.8 NAME 'hccRelatieNaam' \
DESC 'Naam van een klant of partner' SUP top STRUCTURAL MUST ( cn $userPassword )
MAY ( hccXmlIp4 $ hccXmlIp6 $ hccXmlAllow $ description ) )
-
add: olcObjectClasses
olcObjectClasses: {7}( 1.3.6.1.4.1.12795.2.8 NAME 'hccRelatieNaam' \
DESC 'Naam van een klant of partner' SUP top STRUCTURAL MUST ( cn $userPassword )
MAY ( hccXmlIp4 $ hccXmlIp6 $ hccXmlAllow $ description $ hccIg ) )
-

$sudo ldapmodify -Q -Y EXTERNAL -H ldapi:/// -f pas_aan.ldif
</pre>

===modify_config.ldif===
Dit template dient om de SSL/TLS instelling toe te voegen in de ldap configuratie. Toegevoegd worden de certificaat gegevens om met TLS te kunnen werken. Het loglevel wordt op '''STATS''' gezet. Dit geeft niet teveel logging maar is toch goed bruikbaar. Om extra logging te krijgen op b.v. ACL's, verander olcLogLevel dan in "stats ACL".

Dit template wordt tijdens het draaien van het init_ldap script gecopieerd naar modify-config.ldif. Eventueel kan met place holders gewerkt worden (@...@), dit om op alle servers (ook test servers) één en hetzelfde script te kunnen gebruiken. Er zijn nog enkele van deze templates.
<pre>
#######################################
## modify-config.hobbynet ##
#######################################
dn: cn=config
replace: olcLogLevel
olcLogLevel: stats
-
replace: olcTLSCACertificateFile
olcTLSCACertificateFile: /disk/site/etc/ssl/hobby.nl/CA-bundel.crt
-
replace: olcTLSCertificateFile
olcTLSCertificateFile: /disk/site/etc/ssl/hobby.nl/hobby.nl.crt
-
replace: olcTLSCertificateKeyFile
olcTLSCertificateKeyFile: /disk/site/etc/ssl/hobby.nl/hobby.nl.key

</pre>
Om de logging in een apart bestand te krijgen moet in /etc/rsyslog.d een extra bestand '''openldap.conf''' geplaatst worden.
<pre>
local4.* -/var/log/openldap.log
</pre>
Tevens willen we logrotate op dit bestand. Plaats in /etc/logrotate.d het bestand '''openldap''' met de volgende inhoud
<pre>
/var/log/openldap.log
{
rotate 4
weekly
missingok
notifempty
compress
delaycompress
sharedscripts
postrotate
reload rsyslog >/dev/null 2>&1 || true
endscript
}
</pre>

===modify-hdb.ldif===
Hier worden de wijzigingen op de backend db gemaakt. Er worden een aantal attributes ge-indexeerd en de search SizeLimit wordt op '''unlimited''' gezet. De waarden die in DB_CONFIG moeten komen (Berkely DB parameters) staan ook in dit bestand. Deze versie is outdated. De ACL regels zijn drastisch gewijzigd. Raadpleeg altijd de laatste versie op de server zelf.
<pre>
#######################################
## modify-hdb.ldif ##
#######################################
dn: olcDatabase={1}hdb,cn=config
replace: olcAccess
#
# hobbynetlogin heeft lees rechten op ou=users
olcAccess: to attrs=@posixAccount,@posixGroup,@shadowAccount,@hostObject
by dn="cn=hobbynetlogin,ou=applicaties,dc=hcc,dc=nl" read
by * break
#
# drupal/test moet hccOptIn kunnen schrijven vanaf de
# profiel pagina. Overige klanten kunnen hccOptin
# alleen lezen. self mag schrijven
olcAccess: to attrs=hccOptIn
by self write
by dn="cn=drupal-hcc-nl,ou=klanten,dc=hcc,dc=nl" write
by * break
#
# anonieme klanten moeten kunnen inloggen
# en mogen hun eigen password wijzigen
olcAccess: to attrs=userPassword,shadowLastChange
by self write
by anonymous auth
by * break
#
# user mag enkele eigen attr wijzigen
olcAccess: to attrs=hccLogin,hccPseudoniem,hccKaderPassword
by self write
by * break
#
# beheerders hebben schrijfrechten op alles (updateDN)
# klanten hebben alleen lees rechten op alles (readDN)
# self mag lezen
olcAccess: to *
by self read
by dn="cn=xml-hoge-rechten,ou=applicaties,dc=hcc,dc=nl" write
by dn="cn=xml-lage-rechten,ou=applicaties,dc=hcc,dc=nl" read
by dn.one="ou=beheer,dc=hcc,dc=nl" write
by dn.one="ou=klanten,dc=hcc,dc=nl" read
by * break
#
# helpdesk heeft leesrechten op ou=leden
olcAccess: to attrs=@hccOrgPerson,@hccKaderFunctie
by dn.one="ou=helpdesk,dc=hcc,dc=nl" read
by * break
#
# partners mogen een paar attrs lezen
olcAccess: to attrs=hccLidNummer,hccPostcode,hccPostcodeZoekveld
by dn.one="ou=partners,dc=hcc,dc=nl" read
#
# iedereen moet (pseudo attr) entry en objectClass kunnen lezen
olcAccess: to attrs=entry,objectClass
by * read
#
# vangnet: blokkeer alle toegang tot de overige attrs.
olcAccess: to *
by * none
-
replace: olcDbDirectory
olcDbDirectory: /var/lib/ldap
-
replace: olcSizeLimit
olcSizeLimit: 100000
-
replace: olcDbCachesize
olcDbCachesize: 200000
-
replace: olcDbCheckpoint
olcDbCheckpoint: 1024 5
-
replace: olcDbConfig
olcDbConfig: set_cachesize 0 536870912 0
olcDbConfig: set_lk_max_objects 1000
olcDbConfig: set_lk_max_locks 1000
olcDbConfig: set_lk_max_lockers 1000
olcDbConfig: set_flags DB_LOG_AUTOREMOVE
olcDbConfig: set_flags DB_TXN_NOSYNC
-
replace: olcDbIDLcacheSize
olcDbIDLcacheSize: 600000
</pre>

===modify_index.ldif===
Een kale configuratie is heel snel voor wat betreft het opnieuw vullen met gegevens. Bij het aanmaken van een verse LDAP database worden er dan ook zo min mogelijk indexen aangemaakt. 
Zodra de inhoud is ingelezen kunnen de 'echte' indexen aangemaakt worden.
<pre>
#######################################
## modify-index.ldif ##
#######################################
dn: olcDatabase={1}hdb,cn=config
replace: olcDbIndex
olcDbIndex: default pres,eq
olcDbIndex: objectClass,entryUUID,entryCSN eq
olcDbIndex: hccLidNummer,hccLogin,hccForumLogin eq
olcDbIndex: uid,uidNumber,gidNumber,memberUid,member eq
olcDbIndex: cn,host,hccPseudoniem,hccOptin,hccLocatie eq
olcDbIndex: sn,hccPostcodeZoekveld,hccIg,hccRegio eq,subfinal
olcDbIndex: hccRol,hccBezoek eq,pres,subfinal
olcDbIndex: hccBulletins pres
olcDbIndex: aboNummer eq
olcDbIndex: aboPostcodeZoekveld eq,subfinal
olcDbIndex: mail,mailHccnet,hccKaderMail pres,eq
olcDbIndex: hccProfiel pres
</pre>

===ppolicy overlay===
* vanuit LDAP de minimale lengte van een wachtwoord afdwingen
* in LDAP SSHA versleuteling activeren 
(olcPPolicyHashCleartext: TRUE)
<pre>
#######################################
## add-ppolicy.ldif ##
#######################################
dn: cn=module, cn=config
cn: module
objectClass: olcModuleList
objectClass: top
olcModuleLoad: ppolicy
olcmodulepath: /usr/lib/ldap

dn: olcOverlay=ppolicy,olcDatabase={1}hdb,cn=config
objectClass: olcOverlayConfig
objectClass: olcPPolicyConfig
olcOverlay: ppolicy
olcPPolicyDefault: cn=default,ou=policies,dc=hcc,dc=nl
olcPPolicyUseLockout: TRUE
olcPPolicyHashCleartext: TRUE
</pre>
The default ppolicy looks like this:
<pre>
dn: cn=default,ou=policies,dc=hcc,dc=nl
objectClass: pwdPolicy
objectClass: device
cn: default
pwdCheckQuality: 1
pwdMinLength: 8
pwdAttribute: 2.5.4.35
pwdAllowUserChange: TRUE
</pre>

===Syncrepl overlay===
Om twee servers met elkaar in sync te houden is nog wat aanvullende configuratie nodig. In onze situatie zal altijd maar één server bevraagd worden; bij een failover van de loadbancer zal dus de andere server gebruikt worden. Bij het teruggaan naar server 1 zal de directory bijgewerkt worden. Wij gebruiken de z.g. Mirror Mode. Zie de [http://www.openldap.org/doc/admin/ LDAP Admin Guide]. '''Mirror configuratie is specifiek per server!'''
<pre>
#######################################
## add-syncrepl.tmpl ##
#######################################
dn: cn=config
changetype: modify
replace: olcServerID
olcServerID: @SID@

dn: cn=module{0},cn=config
changetype: modify
add: olcModuleLoad
olcModuleLoad: syncprov

dn: olcOverlay=syncprov,olcDatabase={1}hdb,cn=config
changetype: add
objectClass: olcOverlayConfig
objectClass: olcSyncProvConfig
olcOverlay: syncprov
olcSpCheckpoint: 100 5
olcSpSessionlog: 100

dn: olcDatabase={1}hdb,cn=config
changetype: modify
add: olcSyncRepl
olcSyncRepl: rid=@RID@
provider=ldap://@PROVIDER@
binddn="cn=admin,dc=hcc,dc=nl" bindmethod=simple credentials="@PASSWORD@"
searchbase="dc=hcc,dc=nl"
type=refreshAndPersist
interval=00:00:00:10
retry="5 5 300 5"
timeout=1
starttls=yes
-
add: olcMirrorMode
olcMirrorMode: TRUE
</pre>
De andere server krijgt ServerID 2 en de provider is het IP adres van de andere server.

===Unique overlay===
Deze overlay dient er voor te zorgen dat o.a het attribuut hccLogin een unieke waarde bevat.
<pre>
#######################################
## add-unique.ldif ##
#######################################
dn: cn=module,cn=config
cn: module
objectclass: olcModuleList
objectclass: top
olcmoduleload: unique
olcmodulepath: /usr/lib/ldap

dn: olcOverlay=unique,olcDatabase={1}hdb,cn=config
objectClass: olcOverlayConfig
objectClass: olcUniqueConfig
olcOverlay: unique
olcUniqueAttribute: uid uidNumber hccLogin
</pre>

==SSL/TLS beveiliging==
Gebruik de juiste .pem bestanden in /etc/ssl/certs en /etc/ssl/private.

We maken gebruik van een RapidSSL certificaat. Als dit niet standaard in Ubuntu bekend is, zet dan eerst GeoTrust_RapidSSL_-_ca-bundle.pem in de map /etc/ssl/certs neer. Voer nu een '''c_rehash .''' uit in /etc/ssl/certs om de cache te updaten (omdat GeoTrust_RapidSSL_-_ca-bundle.pem nieuw werd toegevoegd).

De ownership is belangrijk. Hiertoe wordt de groep "openldap" toegevoegd aan de groep ssl-cert.
adduser openldap ssl-cert

Als dit fout gaat, doe dan eerst:
apt-get install ssl-cert

Zet het certificaat en de private key in de juiste groep:
chgrp ssl-cert /etc/ssl/private/hobby.nl.*
chmod 440 /etc/ssl/private/hobby.nl.key

Het resultaat is dan als volgt:
root@hcc-ldap-lb1:~# ls -l /etc/ssl/private/hcc*
-rw-r--r-- 1 root ssl-cert 1724 Nov 22 20:47 hobby.nl.crt
-r--r----- 1 root ssl-cert 1679 Nov 22 20:25 hobby.nl.key

root@hcc-ldap-lb1:~# grep openldap /etc/group
ssl-cert:x:114:openldap
openldap:x:118:

2020.12.09: Op een nieuwe Ubuntu installatie staat apparmor standaard aan. Weg ermee!
apt remove --assume-yes --purge apparmor
<strike>Per september 2017 staan de certificaten in /disk/site/etc/ssl/hobby.nl, net als op alle andere servers. Omdat apparmor actief is moet deze directory worden toegevoegd aan /etc/apparmor.d/local/usr.sbin.slapd. Die file ziet er dan als volgt uit:
<pre>
# Site-specific additions and overrides for usr.sbin.slapd.
# For more details, please see /etc/apparmor.d/local/README.
#include <abstractions/ssl_certs>
/disk/site/etc/ssl/hobby.nl/ r,
/disk/site/etc/ssl/hobby.nl/* r,
</pre>
</strike>

Als Openldap ook op poort 636 benaderd wordt (naast TLS op 389), moet in /etc/default/slapd ldaps:/// opgenomen worden bij de SLAPD_SERVICES. 
'netstat -an' dient dan 636 te laten zien voor zowel IPv4 als IPv6.

Om de cn=config te zien kan je het volgende commando gebruiken:
<pre>
ldapsearch -Y EXTERNAL -H ldapi:/// -b cn=config

of, wat botter maar korter:
cat /etc/ldap/slapd.d/cn\=config.ldif
</pre>

==Backup, initialize, restore==
Om het hele skelet van ldap in één keer te herstellen dient '''init_ldap''' gebruikt te worden. Als argument '''moet''' het admin beheer wachtwoord mee gegeven worden.

===lokaal===
Backups kunnen gemaakt worden terwijl slapd draait maar geadviseerd wordt slapd te stoppen. Voor dumpen moet '''slapcat''' gebruikt worden. Backups kunnen gemaakt worden per database of een filter daarop, naar een ldif bestand.
slapcat -l hcc-dump.ldif -b "dc=hcc,dc=nl"
Dit maakt een dump van alles onder '''dc=hcc,dc=nl''' naar het bestand hcc-dump.ldif. Ook is het mogelijk het database nummer te gebruiken, config is altijd nummer 0, hdb is gewoonlijk 1.

Het '''dump_ldap''' script dumpt alle ou's in aparte .ldif bestanden; het omgekeerde doet '''restore_ldap'''.
Terug inlezen kan alleen in een lege directory, dus direct nadat '''init_ldap''' is gedaan. Gebruik voor het terugplaatsen '''slapadd'''. Aan te bevelen is '''-c''' mee te geven zodat ondanks fouten doorgegaan wordt.

Voor slapadd '''moet''' slapd gestopt zijn. Denk er om alvorens te slapd starten het ownership van de bestanden in /var/lib/ldap recht te zetten! (dit lijkt niet meer nodig te zijn vbs20130526)
/etc/init.d/slapd stop
slapadd -l hcc-dump.ldif -w -c >errors.txt
chown openldap:openldap /var/lib/ldap/*
/etc/init.d/slapd start

===remote===
Er wordt dagelijks een encrypted remote backup gemaakt naar backup2bit. Zie voor meer info [[Encrypted_backup]]. Dit script maakt gebruik van unieke gpg keys. Op elke server is dus een eigen versie nodig van '''backup-encrypted'''. 
Recente lokale backups zijn te vinden in '''/usr/local/hobbynet/tmp'''.

===Verse ldap maken===
Transactie log bij het toevoegen van b.v. een nieuwe ou:

<pre>
Op beide servers:
schema van test server gecopieerd en geactiveerd
dump-ldap gedraaid
systemctl stop slapd.service

Er is nu géén ldap service! Werk dus snel...

op ldap-lb1:
init-ldap.sh <adminpw>
restore-ldap.sh
wacht op indexering (tot slapd uit top verdwijnt)
Slapd service is nu in de lucht op ldap-lb1
systemctl stop slapd.service

op ldap-lb2:
init-ldap.sh <adminpw>
restore-ldap.sh
wacht op indexering (tot slapd uit top verdwijnt)
Slapd service is nu in de lucht op ldap-lb2

op ldap-lb1:
systemctl start slapd.service
Beide slapd servers zijn in de lucht en moeten synchroniseren.

op beide servers:
check replicatie (netstat en functioneel)

root@ldap-lb1:/usr/local/hobbynet/bin# netstat -n | grep 389
tcp 0 0 172.31.8.4:36838 172.31.8.5:389 ESTABLISHED
tcp 0 0 172.31.8.4:36836 172.31.8.5:389 ESTABLISHED
tcp 0 0 172.31.8.4:389 172.31.8.5:58112 ESTABLISHED
tcp 0 0 172.31.8.4:389 172.31.8.5:58114 ESTABLISHED

Functioneel door met ADS op beide servers in te loggen en een willekeurig veld in je eigen entry te wijzigen op lb1. Kijk of het gebeurd is op lb2 en wijzig het daar terug. Check op de andere server of het gebeurd is. Er kan een zekere vertraging in optreden.

Stel er is een nieuwe ou gemaakt: denk aan het bij werken van de dump en restore scripts.

update dump-ldap.sh en restore-ldap.sh met de nieuwe ou

op ldap-lb1:
export tarieven.ldif op test server en import op ldap-lb1
</pre>

==crontab==
# script dat updates ophaalt (maar niet installeert), zodat nagios ze ook detecteert
0 9 * * * /usr/local/hobbynet/bin/upd_srv >/dev/null
0 18 * * * /usr/local/hobbynet/bin/upd_srv >/dev/null

==LDAP Clients==
Er zijn meerdere LDAP clients. De meest populaire zijn Apache Directory Studio ("ADS") en phpLdapAdmin ("PLA"). 
De eerste is veel uitgbreider maar vereist een Java Runtime Environment ("JRE"). Onder Windows is dat JRE(13) of (open)JDK-(13). 
PhpLdapAdmin draait onder apache. Beide clients hebben wat configuratie nodig; Bij ADS gaat alles stapsgewijs in de GUI. Voor PLA moet /etc/phpldapadmin/config.php aangepast worden.

Binnen Hobbynet wordt uitsluitend gebruik gemaakt van ADS.

===StartTLS===
Aanbevolen wordt StartTLS op poort 389 te gebruiken. Alternatief is LDAPS op poort 636 maar dat is deprecated.

Voor beide clients is het belangrijk dat de root certificaten gevonden kunnen worden. Als Apache al een server cert kent zou PLA geen probleem mogen zijn. ADS maakt deel uit van de JRE. JRE moet dus de root certificaten kunnen vinden.

===ADS onder Windows===
2019-10-31 HJV: Oude info, als referentie leuk, maar niet meer relevant 
Onder Windows moet met '''keytool.exe''' gewerkt worden. De uitleg heb ik van [http://www.talkingtree.com/blog/index.cfm?mode=entry&entry=25AA75A4-45A6-2844-7CA3EECD842DB576 hier]. Het komt erop neer dat de .pem of .der certificaten van CAcert in de keystore gezet worden. Kopieer deze certificaat bestanden in C:\Program Files\Java\jre6\lib\security (jre6 kan ondertussen jre7 zijn in Vista of W7). Doe dan in een terminal window:
<pre>
Haal de benodigde bestanden op (op een Linux systeem):
wget http://www.cacert.org/certs/root.der -O root.der
wget http://www.cacert.org/certs/class3.der -O class3.der
copieer de bestanden naar de Windows omgeving in C:\Program Files (x86)\Java\jre6\lib\security.

Open een commandwindow:
cd C:\Program Files (x86)\Java\jre6\lib\security
..\..\bin\keytool -import -trustcacerts -keystore cacerts -storepass changeit -noprompt -alias cacertclass1 -file root.der
..\..\bin\keytool -import -trustcacerts -keystore cacerts -storepass changeit -noprompt -alias cacertclass3 -file class3.der
</pre>
De Windows JRE is ook te managen via het Java applet in het configuratiescherm. Toevoegen van root certificaten lijkt niet mogelijk voor system; wel voor user. Niet verder naar gezocht.

===ADS onder Linux===
Apache Directory Studio laat zich uit een tarball installeren. Dit kan geheel in userspace; er is geen make install o.i.d. nodig. ADS loopt vanuit de lokatie waar het uitgepakt is.

===ADS gebruik===
ADS kan erg handig zijn voor het snel dumpen van hele ou's in .ldif formaat. Zo'n dump kan direct op een andere server worden ingelezen.

===PhpLdapAdmin onder Linux===
Voor ldap clients (phpldapadmin) dient de client configuratie goed te zijn. Deze bevindt zich in /etc/ldap/ldap.conf. Het is voldoende als de directory met de root certificaten bekend is. Deze client configuratie is meer php-ldap gebonden dan alleen voor PLA. Ook de Drupal LDAPauth module werkt met ditzelfde beatand. Zie ook de [http://phpldapadmin.sourceforge.net/wiki/index.php/Server:server:tls phpldapadmin wiki].
<pre>
#
# LDAP Defaults
#

# See ldap.conf(5) for details
# This file should be world readable but not world writable.

#BASE dc=example,dc=com
#URI ldap://ldap.example.com ldap://ldap-master.example.com:666

#SIZELIMIT 12
#TIMELIMIT 15
#DEREF never
TLS_CACERT /etc/ssl/certs/CAcert_org.pem
TLS_CERT /etc/ssl/private/hobby.nl.crt
TLS_KEY /etc/ssl/private/hobby.nl.key
TLS_REQCERT allow
#TLS_REQCERT never
</pre>
Denk er wel aan na wijzigingen Apache te herstarten.
===PAM en NSS via LDAP===
Het inloggen van gebruikers kan ook via een LDAP server en client geschieden. Hiervoor dienen enkele pakketten geïnstalleerd en geconfigureerd te worden. Er zijn wijzigingen nodig in /etc/nsswitch.conf en de /etc/pam.d/common-* bestanden. Beide zijn via dedicated tools aan te passen.

Installeer '''libnss-ldapd''' om de benodigde libraries te verkrijgen. Apt-get zal tevens '''libpam-ldapd''', '''nslcd''' en '''nscd''' binnen brengen.
<pre>
apt-get install libnss-ldapd auth-client-config ldap-utils
The following extra packages will be installed:
libpam-ldapd nscd nslcd
</pre>
Libnss-ldapd is een doorontwikkeling van libnss-ldap en bevat meerdere verbeteringen. Zie: [http://arthurdejong.org/nss-pam-ldapd/ deze site] van de ontwikkelaar. Bij de installatie wordt een user '''nslcd''' aangemaakt; denk erom die in de .tmpl bestanden te zetten!

nsswitch.conf laat zich configureren via '''auth-client-config''' maar lac_ldap is alleen aanwezig als '''ldap-auth-config''' ook is geinstalleerd. Zo niet gebruik dan de tweede regel:
<pre>
auth-client-config -t nss -p lac_ldap
auth-client-config -t nss -p ldap_example
</pre>
Het resultaat is dat nsswitch.conf zowel in files (/etc/passwd etc.) zoekt als in ldap.
<pre>
# /etc/nsswitch.conf
#
# Example configuration of GNU Name Service Switch functionality.
# If you have the `glibc-doc-reference' and `info' packages installed, try:
# `info libc "Name Service Switch"' for information about this file.

# pre_auth-client-config # passwd: compat
passwd: files ldap
# pre_auth-client-config # group: compat
group: files ldap
# pre_auth-client-config # shadow: compat
shadow: files ldap

hosts: files dns
networks: files

protocols: db files
services: db files
ethers: db files
rpc: db files

# pre_auth-client-config # netgroup: nis
netgroup: nis
</pre>
Het aanpassen van de PAM bestanden gaat sinds enige releases met '''pam-auth-update'''. Kies in het menu voor zowel unix als ldap. Default wordt nu ldap authenticatie gebruikt voor uid >= 1000. Bij Hobbynet willen we vanaf 300 ldap gebruiken. Door een licht gemodificeerde versie van /usr/share/pam-configs/ldap te maken (ldap-hobbynet), kan ook voor de hobbynet instelling gekozen worden. Dit is de ldap-hobbynet versie:
<pre>
Name: LDAP Authentication (uid>300)
Default: yes
Priority: 128
Auth-Type: Primary
Auth-Initial:
[success=end default=ignore] pam_ldap.so minimum_uid=300
Auth:
[success=end default=ignore] pam_ldap.so minimum_uid=300 use_first_pass
Account-Type: Additional
Account:
[success=ok new_authtok_reqd=done ignore=ignore user_unknown=ignore authinfo_unavail=ignore default=bad] pam_ldap.so minimum_uid=300
Password-Type: Primary
Password-Initial:
[success=end default=ignore] pam_ldap.so minimum_uid=300
Password:
[success=end default=ignore] pam_ldap.so minimum_uid=300 try_first_pass
Session-Type: Additional
Session:
[success=ok default=ignore] pam_ldap.so minimum_uid=300
</pre>

Dit is in een standaard opzet van LDAP voldoende om zowel lokale gebruikers als gebruikers opgeslagen in LDAP, te laten inloggen en hun password te laten wijzigen. In de Hobbynet setup moet er echter nog meer gebeuren in de ACL's van de LDAP server configuratie. Omdat Hobbynet de laatste ACL regel heeft gewijzigd in een '''deny-all''', is er een helper of proxy account nodig dat read access heeft of een aantal cruciale velden in de posixAccount objectClass. Zie verder de lsiting van nslcd.conf.

Libnss-ldapd en libpam-ldapd hebben een gezamelijke daemon '''nslcd''' die z'n configuratie uit '''/etc/nslcd.conf''' haalt. Hierin is ook een voorziening voor het helper account. Aan het eind vande '''nslcd.conf''' staat de voorziening voor host-based login. Als het attribute '''host''' de fqdn of alleen de host naam bevat, bepaald dat of inloggen op die host mogelijk is. '''*''' staat inloggen op alle hosts toe.

Eventueel kan het daemon proces voor debugging doeleinden ook als command ('''nslcd -d''') gestart worden. Om de bevragingen van de LDAP server wat te verminderen, kan '''nscd''' voor caching zorgen. Deze cache daemon heeft zijn eigen configuratie bestand: '''/etc/nslcd.conf'''. De default instellingen zijn goed; eventueel kan de logging naar een bestand gestuurd worden.

Verbinding met de LDAP server kan met StartTLS beveiligd worden. Hier de inhoud van nslcd.conf:
<pre>
# /etc/nslcd.conf
# nslcd configuration file. See nslcd.conf(5)
# for details.

# The user and group nslcd should run as.
uid nslcd
gid nslcd

# log location and level
#log /var/log/nslcd.log debug

# The location at which the LDAP server(s) should be reachable.
uri ldap://ldap2-int.hobby.nl/

# The search base that will be used for all queries.
base dc=hcc,dc=nl

# Other base mappings
base group ou=groups,dc=hcc,dc=nl
base passwd ou=users,dc=hcc,dc=nl
base shadow ou=users,dc=hcc,dc=nl

# The search scope.
#scope sub

# The LDAP protocol version to use.
ldap_version 3

# The DN to bind with for normal lookups.
#binddn cn=annonymous,dc=example,dc=net
#bindpw secret
binddn cn=hobbynetlogin,ou=applicaties,dc=hcc,dc=nl
bindpw xxxxxxxxxxxxxxxxx

# The DN used for password modifications by root.
#rootpwmoddn cn=admin,dc=example,dc=com

# SSL options
ssl off
ssl start_tls
#tls_reqcert never
tls_cacertfile /etc/ssl/certs/cacert.org.pem
#tls_cert /etc/ssl/private/server.crt
#tls_key /etc/ssl/private/server.key

# The minimum uid
nss_min_uid 300

pam_authz_search (&(objectClass=posixAccount)(uid=$username)(|(host=$hostname)(host=$fqdn)(host=\\*)))
</pre>

===users en groepen toevoegen===
Hiervoor moet '''ldapscripts''' zijn geïnstalleerd. Dit is het geval op de ldap-lb1 server. Dat levert de volgende extra commando's op:
<pre>
ldaprenamemachine
ldapadduser
ldapdeleteuserfromgroup
ldapfinger
ldapid
ldapgid
ldapmodifyuser
ldaprenameuser
lsldap
ldapaddusertogroup
ldapsetpasswd
ldapinit
ldapaddgroup
ldapdeletegroup
ldapmodifygroup
ldapdeletemachine
ldaprenamegroup
ldapaddmachine
ldapmodifymachine
ldapsetprimarygroup
ldapdeleteuser
</pre>
Meest gebruikt zijn '''ldapaddgroup, ldapadduser, ldapsetpasswd'''.
Er zijn manpages maar er is ook uitgebreide uitleg in de [https://help.ubuntu.com/14.04/serverguide/openldap-server.html Ubuntu server guide]. Omdat wij het automatisch maken van de home dir uit hebben staan, moet die met de hand aangemaakt worden en moet de owner goed gezet worden.

===host-based login===
Met een kleine uitbreiding in het schema van de LDAP server, kan host-based login gerealiseerd worden. Ook in de '''nslcd.conf''' is een uitbreiding nodig.

In de LDAP server dient de objectClass '''hostObject''' aan de entries in de ou=users toegevoegd te worden. Deze (auxilary) objectClass brengt slechts één attribute met zich mee: '''host'''. De regel in nslcd.conf checkt of één van de waarden van '''host''' gelijk is aan de naam van de server waarop ingelogd wordt. De waarde '''*''' geldt als wildcard. Zie de regel ''
'pam_authz_search'''' in '''nslcd.conf'''.

===Password aanpassen===
Via LDAP ingelogde gebruikers kunnen net als lokale gebruikers hun wachtwoord met '''passwd''' wijzigen. Wel moet aan de eisen in de LDAP ppolicy module voldaan worden.

==PHP scripting==
Initieel worden alle leden op basis van hun hcc lidnummer ingelezen. Zodra de profielwizard doorlopen is, zal het lidnummer vervangen moeten worden door de gebruikersnaam. Er zijn verschillende php-scripts gemaakt, o.a. om snel alle kaderrollen te verwijderen. Php-scripts staan in de '''/usr/local/hobbynet/bin''' directory.
Voor de php-scripting zijn enkele php7.x pakketten nodig. Installeer deze met apt-get. Het gaat om:
* php-cli
* php-ldap

== Apache authenticatie via LDAP ==
In plaats van .htpassword authenticatie, kan ook LDAP gebruikt worden. Activeer daartoe de Apache module
'authnz_ldap'.
a2enmod authnz_ldap
Denk er om dat dit in een loadbalanced situatie op beide servers gedaan dient te worden!

=== Voorbeeld van een LDAP configuratie in de Apache config ===
(alleen als voorbeeld, niet zo gebruiken!) 

<pre>
# // 1) Hobbynet webmaster
# // 2) Vraagbaak medewerker van een willekeurige groepering
# (|(hccRol=*#VRBK)(hccRol=HN#WM))
<Location "/apps/vraagbaak">
<RequireAll>
Authname "HCC!vraagbaak (gebruik uw hcc.nl gebruikersnaam/wachtwoord)"
AuthType Basic
AuthBasicProvider ldap
AuthLDAPUrl ldap://hcc-ldap-int.hobby.nl/ou=leden,dc=hcc,dc=nl?hccLogin??(|(hccRol=*#VRBK)(hccRol=HN#WM))(hccProfiel=TRUE) TLS
require valid-user
</RequireAll>
</Location>
</pre>

=== Hoe kan LDAP veilig gebruikt worden vanuit Apache===
Zet een script neer in de gebruikersomgeving, en gebruik mod_authz_external. Doe de controle vervolgens via de XML-RPC server. 

'''Zie [[Kadernet]] voor een voorbeeld.'''

== TODO lijst ==
''Dit is een lijst in wording, graag aanvullen''
* 'dun' loadbalancer script maken om te controleren dat LDAP echt luistert

LDAP

2020-12-09T16:30:23Z

Hans:

==Introductie==
Om een centrale plaats te hebben om authenticatie te doen voor www.hcc.nl en sub-sites zoals een forum, is gekozen voor het gebruik van een LDAP database/directory. Hierin wordt alles opgeslagen wat nodig is voor het functioneren van de site, inclusief NAW gegevens <strike>die op dit moment alleen opgeslagen worden t.b.v. het PC30 beheerscherm</strike>.

==LDAP server keuze==
De voor de hand liggende keuze is OpenLDAP. Echter zijn er geluiden gehoord dat OpenLDAP niet zou schalen. Alternatieven zijn b.v. 389server maar die is erg slecht gesupport onder Ubuntu. Voorlopig starten we met OpenLDAP.

==Loadbalanced==
Er zijn twee servers (ldap-lb1 en ldap-lb2) die achter een loadbalancer in preferred server mode staan zodat het verkeer altijd naar server1 gestuurd wordt. Beide servers houden elkaar up-to-date. In de gewone situatie zullen alle reads en writes naar server1 gaan en server2 wordt door server1 bijgewerkt. Valt server1 weg, dan zal de loadbalancer overschakelen naar server2 waar vanaf dan de read en writes plaatsvinden. Zodra server1 weer beschikbaar is, wordt die bijgewerkt en zal weer master worden.

==Installatie==
Installatie van OpenLDAP is simpel:
aptitude install slapd ldap-utils
Omdat er gebruikgemaakt wordt van php scripts, is het ook nodig '''php-cli''' en '''php-ldap''' te installeren. De configuratie van OpenLDAP is sinds Karmic Koala iets gecompliceerder geworden. 'cn=config' wordt nog steeds gebruikt maar tijdens installatie wordt alleen een skeleton configuratie geïnstalleerd. Er wordt niet meer gevraagd om een password tijdens de installatie en "dpkg-reconfigure slapd" zet alleen de skeleton configuratie terug. Je moet zelf de database, root dn en acl's opzetten (als root of met sudo). Run '''dpkg-reconfigure slapd''' om terug te gaan naar een lege directory.

UPDATE: in Oneiric Ocelot (11.10) is weer wel de mogelijkheid gegeven bij installatie een database aan te maken. Default wordt echter de fqdn hostname gebruikt. Bij dpkg-reconfigure kan het gewenste domein wel opnieuw gegeven worden. De initiële configuratie staat in /usr/share/slapd/slapd.init.ldif.

UPDATE: bij de upgrade naar 16.04.1 zijn proefondervindelijk nog wat extra handelingen nodig gebleken. 
XML-RPC server updaten naar Ubuntu 16.04. WIP!
<pre>
- apt-get install phpmyadmin
- apt-get install aptitude
- apt-get install php-xmlrpc
- apt-get install php-ldap
- phpenmod xml
- phpenmod mysqli
('php -m' toont de geactiveerde modules)
- apache2ctl restart

phpmyadmin werkt niet:
- apt-get install php-mbstring
- apt-get install php-gettext

ontbrekende pakketten volgens hjv:

apt-get install aptitude
apt-get install phpmyadmin
apt-get install php-mbstring
apt-get install php-gettext
apt-get install php-xmlrpc
apt-get install php-ldap
apt-get install mysql-server
apt-get install ldapscripts
apt-get install php-xml
apt-get install slapd
apt-get install ldap-utils
a2enmod ssl

* Voer de laatste stappen uit, zoals beschreven in de Hobbynet wiki: *

- openldap moet lid zijn van de groep ssl-cert!
apt-get install ssl-cert
adduser openldap ssl-cert
(of vi /etc/group
ssl-cert:x:116:openldap)

- Zorg dat de LDAP daemon bij de certificaten kan komen.
LET OP: op alle hobbynet servers staan de certificaten in /disk/site/etc/ssl/hobby.nl/
chgrp ssl-cert /disk/site/etc/ssl/hobby.nl/hobby.nl.*
chmod 440 /disk/site/etc/ssl/hobby.nl/hobby.nl.key
en dus niet langer
chgrp ssl-cert /etc/ssl/private/hobby.nl.*
chmod 440 /etc/ssl/private/hobby.nl.key

- Vertel LDAP (en PHP) clients welke certificaten toegestaan zijn
(2017-09-23: verouderde info, niet langer in gebruik)
vi /etc/ldap/ldap.conf
TLS_CERT /etc/ssl/private/hobby.nl.crt
TLS_KEY /etc/ssl/private/hobby.nl.key
TLS_REQCERT allow

- mysql laat het bestand ibdata1 ongelimiteerd groeien (InnoDB bestanden)
/etc/mysql/mysql.conf.d/innodb_file_per_table.cnf
[mysql]
innodb_file_per_table

=============
Hobbynet aanpassingen
/etc/bash.bashrc
export http_proxy=http://squid-int.hobby.nl:3128
export https_proxy=http://squid-int.hobby.nl:3128
export ftp_proxy=http://squid-int.hobby.nl:3128
</pre>

===Locatie bestanden===
Om de benodigde bestanden op de server te krijgen zal scp gebruikt moet worden. Upload alles in een privé subdirectory. Copiëer daarna alles naar de juiste plaats en verander de owner in root.

* Alle ldif em tmpl bestanden gaan naar /usr/local/hobbynet/lib
* init_ldap en andere scripts gaan naar /usr/local/hobbynet/bin
* alle data bestanden (dumps) en update ldifs gaan naar /usr/local/hobbynet/data
* etc/ldap/schema/hcc_schema.* gaan naar /etc/ldap/schema
* etc/ldap/schema/ppolicy.ldif gaat naar /etc/ldap/schema

==Initiële database==
Direct na installatie (of na dpkg-reconfigure slapd) staat er een werkende doch lege directory in OpenLDAP. Access is alleen geregeld voor root. Dit heeft te maken met het feit dat vanaf Karmic Koala OpenLDAP alleen het minst noodzakelijke bevat om slapd te starten. Wordt echter init_ldap gebruikt dan wordt een werkende directory gemaakt met alle statische data (in diverse ou's) erin. Alleen zijn er geen leden geladen in de ou=leden en ou=inactieve_leden.
===slapd.init.ldif ===
Bij installatie/reconfiguratie wordt /usr/share/slapd/slapd.init.ldif ingelezen. Zie aldaar indien nodig.

==init_ldap script==
Het lokale script init-ldap doet een reset van de initiële Openldap configuratie. Dit heeft tot gevolg dat de DIT dc=hcc,dc=nl met een rootDN '''cn=admin,dc=hcc,dc=nl''' steeds opnieuw aangemaakt wordt. Alles wat we toegevoegd/gewijzigd willen hebben in de cn=config volgt daarna. Dit wordt afgesloten met een restart van de slapd server. Het script '''restore_ldap''' laadt vervolgens de laatste dump terug. Bij wijzigingen aan het schema is het raadzaam altijd een '''dump_ldap''' te doen zodat een later een actuele dump kan worden teruggeladen.

Het (plain text) password van cn=admin,dc=hcc,dc=nl moet bij het aanroepen van '''init_ldap''' op de commandline worden meegegeven. Tijdens de dpkg-reconfigure moet het password nog 2x gegeven worden. Lees eventueel ook de [http://www.openldap.org/doc/admin/ OpenLDAP Admin Guide].

Het init_ldap script bevat allerlei logica om op meerdere ldap servers gedraaid te kunnen worden. In grote lijnen valt het script in een aantal blokken uiteen:
* voorbereidingen om "dpkg-reconfigure slapd" te draaien
* definities van input files
* check host
* bouwen van het skelet van de nieuwe directory
Zie voor details van de scripts '''init_ldap''', '''dump_ldap''' en '''restore_ldap''' op een van de servers (in /usr/local/hobbynet/bin).

==onderdelen van init_ldap==
Init_ldap is opgezet om stap voor stap de database op te bouwen. Hieronder een beschrijving van de losse ldif bestanden die ingelezen worden. Incidenteel wordt een ldif gewijzigd; kijk altijd in de actuele bestanden!

===add-schema.ldif===
Omdat wij een aantal eigen attributes en Objectclasses hebben toegevoegd aam het schema, moeten deze aan OpenLDAP worden toegevoegd. Het schema moet nog worden omgezet naar ldif format.
* Hiertoe wordt het onderstaande schema in /etc/ldap/schema geplaatst als hcc_schema.schema.
* Vervolgens worden de stappen uitgevoerd zoals beschreven in de [https://help.ubuntu.com/11.10/serverguide/C/openldap-server.html Ubuntu Server guide], onder '''Modifying the slapd Configuration Database'''.
* De resulterende output file '''cn=hcc_schema.ldif''' moet dan nog naar /etc/ldap/schema/hcc_schema.ldif gecopieerd worden.
Als dit proces herhaald moet worden, start dan met een lege output directory en verwijder een eventueel achtergebleven cn=hcc_schema.ldif bestand.

De extra schema's worden middels een '''include''' toegevoegd. '''Ppolicy''' is op gelijke wijze als '''hcc_schema''' tot .ldif geconverteerd. Alle stappen om een nieuwe '''hcc-schema.ldif''' te maken zijn gescript in '''upd_schema'''. In '''init_ldap''' wordt het eigen schema en de password policy geladen:
<pre>
#######################################
## add-schema.ldif ##
#######################################
include: file:///etc/ldap/schema/hcc_schema.ldif
include: file:///etc/ldap/schema/ppolicy.ldif
include: file:///etc/ldap/schema/ldapns.ldif
</pre>

====schema updates====
Soms wordt een attribute toegevoegd of gewijzigd. Hiertoe dient het bestand hcc_schema.schema in /usr/local/hobbynet/etc/ldap/schema, gewijzigd te worden. Daarna dient er een ldif versie van gemaakt te worden. Gebruik hiervoor '''upd_schema.sh''' in dezelfde directory. De resulterende hcc_schema.ldif wordt in dit script naar /etc/ldap/schema gecopieërd. Bij grote wijzigingen is het aan te bevelen door de hele rebuild cycle te gaan (dump, init, restore). Bij triviale aanpassingen zou hcc_schema.ldif ook '''direct''' in de actieve directory geplaatst kunnen worden, gevolgd door slechts een '''service slapd restart'''. Gebruik hiervoor (blijf in de lokale schema directory):
<pre>
cp "ldif_output/cn=config/cn=schema/cn={14}hcc_schema.ldif" "/etc/ldap/slapd.d/cn=config/cn=schema/cn={4}hcc_schema.ldif"
</pre>
LET OP: De nummers tussen accolades zijn bepaald door de volgorde van andere scripts! Zolang geen andere schema's worden toegevoegd zullen ze niet veranderen.
 
Ook kan met de ldap-tools gewerkt worden. Gebruik ldapsearch en ldapmodify, eventueel met de -f optie om een voorbereide serie opdrachten uit te voeren. Gebruik ldapsearch om eerst de structuur te vinden:
<pre>
$ sudo ldapsearch -Q -LLL -Y EXTERNAL -H ldapi:/// -b cn={4}hcc_schema,cn=schema,cn=config
</pre>
Hier een voorbeeld om een objectClass aan te passen:
<pre>
$ cat pas_aan.ldif
dn: cn={4}hcc_schema,cn=schema,cn=config
changetype: modify
delete: olcObjectClasses
olcObjectClasses: {7}( 1.3.6.1.4.1.12795.2.8 NAME 'hccRelatieNaam' \
DESC 'Naam van een klant of partner' SUP top STRUCTURAL MUST ( cn $userPassword )
MAY ( hccXmlIp4 $ hccXmlIp6 $ hccXmlAllow $ description ) )
-
add: olcObjectClasses
olcObjectClasses: {7}( 1.3.6.1.4.1.12795.2.8 NAME 'hccRelatieNaam' \
DESC 'Naam van een klant of partner' SUP top STRUCTURAL MUST ( cn $userPassword )
MAY ( hccXmlIp4 $ hccXmlIp6 $ hccXmlAllow $ description $ hccIg ) )
-

$sudo ldapmodify -Q -Y EXTERNAL -H ldapi:/// -f pas_aan.ldif
</pre>

===modify_config.ldif===
Dit template dient om de SSL/TLS instelling toe te voegen in de ldap configuratie. Toegevoegd worden de certificaat gegevens om met TLS te kunnen werken. Het loglevel wordt op '''STATS''' gezet. Dit geeft niet teveel logging maar is toch goed bruikbaar. Om extra logging te krijgen op b.v. ACL's, verander olcLogLevel dan in "stats ACL".

Dit template wordt tijdens het draaien van het init_ldap script gecopieerd naar modify-config.ldif. Eventueel kan met place holders gewerkt worden (@...@), dit om op alle servers (ook test servers) één en hetzelfde script te kunnen gebruiken. Er zijn nog enkele van deze templates.
<pre>
#######################################
## modify-config.hobbynet ##
#######################################
dn: cn=config
replace: olcLogLevel
olcLogLevel: stats
-
replace: olcTLSCACertificateFile
olcTLSCACertificateFile: /disk/site/etc/ssl/hobby.nl/CA-bundel.crt
-
replace: olcTLSCertificateFile
olcTLSCertificateFile: /disk/site/etc/ssl/hobby.nl/hobby.nl.crt
-
replace: olcTLSCertificateKeyFile
olcTLSCertificateKeyFile: /disk/site/etc/ssl/hobby.nl/hobby.nl.key

</pre>
Om de logging in een apart bestand te krijgen moet in /etc/rsyslog.d een extra bestand '''openldap.conf''' geplaatst worden.
<pre>
local4.* -/var/log/openldap.log
</pre>
Tevens willen we logrotate op dit bestand. Plaats in /etc/logrotate.d het bestand '''openldap''' met de volgende inhoud
<pre>
/var/log/openldap.log
{
rotate 4
weekly
missingok
notifempty
compress
delaycompress
sharedscripts
postrotate
reload rsyslog >/dev/null 2>&1 || true
endscript
}
</pre>

===modify-hdb.ldif===
Hier worden de wijzigingen op de backend db gemaakt. Er worden een aantal attributes ge-indexeerd en de search SizeLimit wordt op '''unlimited''' gezet. De waarden die in DB_CONFIG moeten komen (Berkely DB parameters) staan ook in dit bestand. Deze versie is outdated. De ACL regels zijn drastisch gewijzigd. Raadpleeg altijd de laatste versie op de server zelf.
<pre>
#######################################
## modify-hdb.ldif ##
#######################################
dn: olcDatabase={1}hdb,cn=config
replace: olcAccess
#
# hobbynetlogin heeft lees rechten op ou=users
olcAccess: to attrs=@posixAccount,@posixGroup,@shadowAccount,@hostObject
by dn="cn=hobbynetlogin,ou=applicaties,dc=hcc,dc=nl" read
by * break
#
# drupal/test moet hccOptIn kunnen schrijven vanaf de
# profiel pagina. Overige klanten kunnen hccOptin
# alleen lezen. self mag schrijven
olcAccess: to attrs=hccOptIn
by self write
by dn="cn=drupal-hcc-nl,ou=klanten,dc=hcc,dc=nl" write
by * break
#
# anonieme klanten moeten kunnen inloggen
# en mogen hun eigen password wijzigen
olcAccess: to attrs=userPassword,shadowLastChange
by self write
by anonymous auth
by * break
#
# user mag enkele eigen attr wijzigen
olcAccess: to attrs=hccLogin,hccPseudoniem,hccKaderPassword
by self write
by * break
#
# beheerders hebben schrijfrechten op alles (updateDN)
# klanten hebben alleen lees rechten op alles (readDN)
# self mag lezen
olcAccess: to *
by self read
by dn="cn=xml-hoge-rechten,ou=applicaties,dc=hcc,dc=nl" write
by dn="cn=xml-lage-rechten,ou=applicaties,dc=hcc,dc=nl" read
by dn.one="ou=beheer,dc=hcc,dc=nl" write
by dn.one="ou=klanten,dc=hcc,dc=nl" read
by * break
#
# helpdesk heeft leesrechten op ou=leden
olcAccess: to attrs=@hccOrgPerson,@hccKaderFunctie
by dn.one="ou=helpdesk,dc=hcc,dc=nl" read
by * break
#
# partners mogen een paar attrs lezen
olcAccess: to attrs=hccLidNummer,hccPostcode,hccPostcodeZoekveld
by dn.one="ou=partners,dc=hcc,dc=nl" read
#
# iedereen moet (pseudo attr) entry en objectClass kunnen lezen
olcAccess: to attrs=entry,objectClass
by * read
#
# vangnet: blokkeer alle toegang tot de overige attrs.
olcAccess: to *
by * none
-
replace: olcDbDirectory
olcDbDirectory: /var/lib/ldap
-
replace: olcSizeLimit
olcSizeLimit: 100000
-
replace: olcDbCachesize
olcDbCachesize: 200000
-
replace: olcDbCheckpoint
olcDbCheckpoint: 1024 5
-
replace: olcDbConfig
olcDbConfig: set_cachesize 0 536870912 0
olcDbConfig: set_lk_max_objects 1000
olcDbConfig: set_lk_max_locks 1000
olcDbConfig: set_lk_max_lockers 1000
olcDbConfig: set_flags DB_LOG_AUTOREMOVE
olcDbConfig: set_flags DB_TXN_NOSYNC
-
replace: olcDbIDLcacheSize
olcDbIDLcacheSize: 600000
</pre>

===modify_index.ldif===
Een kale configuratie is heel snel voor wat betreft het opnieuw vullen met gegevens. Bij het aanmaken van een verse LDAP database worden er dan ook zo min mogelijk indexen aangemaakt. 
Zodra de inhoud is ingelezen kunnen de 'echte' indexen aangemaakt worden.
<pre>
#######################################
## modify-index.ldif ##
#######################################
dn: olcDatabase={1}hdb,cn=config
replace: olcDbIndex
olcDbIndex: default pres,eq
olcDbIndex: objectClass,entryUUID,entryCSN eq
olcDbIndex: hccLidNummer,hccLogin,hccForumLogin eq
olcDbIndex: uid,uidNumber,gidNumber,memberUid,member eq
olcDbIndex: cn,host,hccPseudoniem,hccOptin,hccLocatie eq
olcDbIndex: sn,hccPostcodeZoekveld,hccIg,hccRegio eq,subfinal
olcDbIndex: hccRol,hccBezoek eq,pres,subfinal
olcDbIndex: hccBulletins pres
olcDbIndex: aboNummer eq
olcDbIndex: aboPostcodeZoekveld eq,subfinal
olcDbIndex: mail,mailHccnet,hccKaderMail pres,eq
olcDbIndex: hccProfiel pres
</pre>

===ppolicy overlay===
* vanuit LDAP de minimale lengte van een wachtwoord afdwingen
* in LDAP SSHA versleuteling activeren 
(olcPPolicyHashCleartext: TRUE)
<pre>
#######################################
## add-ppolicy.ldif ##
#######################################
dn: cn=module, cn=config
cn: module
objectClass: olcModuleList
objectClass: top
olcModuleLoad: ppolicy
olcmodulepath: /usr/lib/ldap

dn: olcOverlay=ppolicy,olcDatabase={1}hdb,cn=config
objectClass: olcOverlayConfig
objectClass: olcPPolicyConfig
olcOverlay: ppolicy
olcPPolicyDefault: cn=default,ou=policies,dc=hcc,dc=nl
olcPPolicyUseLockout: TRUE
olcPPolicyHashCleartext: TRUE
</pre>
The default ppolicy looks like this:
<pre>
dn: cn=default,ou=policies,dc=hcc,dc=nl
objectClass: pwdPolicy
objectClass: device
cn: default
pwdCheckQuality: 1
pwdMinLength: 8
pwdAttribute: 2.5.4.35
pwdAllowUserChange: TRUE
</pre>

===Syncrepl overlay===
Om twee servers met elkaar in sync te houden is nog wat aanvullende configuratie nodig. In onze situatie zal altijd maar één server bevraagd worden; bij een failover van de loadbancer zal dus de andere server gebruikt worden. Bij het teruggaan naar server 1 zal de directory bijgewerkt worden. Wij gebruiken de z.g. Mirror Mode. Zie de [http://www.openldap.org/doc/admin/ LDAP Admin Guide]. '''Mirror configuratie is specifiek per server!'''
<pre>
#######################################
## add-syncrepl.tmpl ##
#######################################
dn: cn=config
changetype: modify
replace: olcServerID
olcServerID: @SID@

dn: cn=module{0},cn=config
changetype: modify
add: olcModuleLoad
olcModuleLoad: syncprov

dn: olcOverlay=syncprov,olcDatabase={1}hdb,cn=config
changetype: add
objectClass: olcOverlayConfig
objectClass: olcSyncProvConfig
olcOverlay: syncprov
olcSpCheckpoint: 100 5
olcSpSessionlog: 100

dn: olcDatabase={1}hdb,cn=config
changetype: modify
add: olcSyncRepl
olcSyncRepl: rid=@RID@
provider=ldap://@PROVIDER@
binddn="cn=admin,dc=hcc,dc=nl" bindmethod=simple credentials="@PASSWORD@"
searchbase="dc=hcc,dc=nl"
type=refreshAndPersist
interval=00:00:00:10
retry="5 5 300 5"
timeout=1
starttls=yes
-
add: olcMirrorMode
olcMirrorMode: TRUE
</pre>
De andere server krijgt ServerID 2 en de provider is het IP adres van de andere server.

===Unique overlay===
Deze overlay dient er voor te zorgen dat o.a het attribuut hccLogin een unieke waarde bevat.
<pre>
#######################################
## add-unique.ldif ##
#######################################
dn: cn=module,cn=config
cn: module
objectclass: olcModuleList
objectclass: top
olcmoduleload: unique
olcmodulepath: /usr/lib/ldap

dn: olcOverlay=unique,olcDatabase={1}hdb,cn=config
objectClass: olcOverlayConfig
objectClass: olcUniqueConfig
olcOverlay: unique
olcUniqueAttribute: uid uidNumber hccLogin
</pre>

==SSL/TLS beveiliging==
Gebruik de juiste .pem bestanden in /etc/ssl/certs en /etc/ssl/private.

We maken gebruik van een RapidSSL certificaat. Als dit niet standaard in Ubuntu bekend is, zet dan eerst GeoTrust_RapidSSL_-_ca-bundle.pem in de map /etc/ssl/certs neer. Voer nu een '''c_rehash .''' uit in /etc/ssl/certs om de cache te updaten (omdat GeoTrust_RapidSSL_-_ca-bundle.pem nieuw werd toegevoegd).

De ownership is belangrijk. Hiertoe wordt de groep "openldap" toegevoegd aan de groep ssl-cert.
adduser openldap ssl-cert

Als dit fout gaat, doe dan eerst:
apt-get install ssl-cert

Zet het certificaat en de private key in de juiste groep:
chgrp ssl-cert /etc/ssl/private/hobby.nl.*
chmod 440 /etc/ssl/private/hobby.nl.key

Het resultaat is dan als volgt:
root@hcc-ldap-lb1:~# ls -l /etc/ssl/private/hcc*
-rw-r--r-- 1 root ssl-cert 1724 Nov 22 20:47 hobby.nl.crt
-r--r----- 1 root ssl-cert 1679 Nov 22 20:25 hobby.nl.key

root@hcc-ldap-lb1:~# grep openldap /etc/group
ssl-cert:x:114:openldap
openldap:x:118:

2020.12.09: Op een nieuwe Ubuntu installatie staat apparmor standaard aan. Weg ermee!
apt remove --assume-yes --purge apparmor
<strike>Per september 2017 staan de certificaten in /disk/site/etc/ssl/hobby.nl, net als op alle andere servers. Omdat apparmor actief is moet deze directory worden toegevoegd aan /etc/apparmor.d/local/usr.sbin.slapd. Die file ziet er dan als volgt uit:
<pre>
# Site-specific additions and overrides for usr.sbin.slapd.
# For more details, please see /etc/apparmor.d/local/README.
#include <abstractions/ssl_certs>
/disk/site/etc/ssl/hobby.nl/ r,
/disk/site/etc/ssl/hobby.nl/* r,
</pre>
Als Openldap ook op poort 636 benaderd wordt (naast TLS op 389), moet in /etc/default/slapd ldaps:/// opgenomen worden bij de SLAPD_SERVICES. Netstat -a dient dan 636 te laten zien voor zowel IPv4 als IPv6.
</strike>

Om de cn=config te zien kan je het volgende commando gebruiken:
<pre>
ldapsearch -Y EXTERNAL -H ldapi:/// -b cn=config

of, wat botter maar korter:
cat /etc/ldap/slapd.d/cn\=config.ldif
</pre>

==Backup, initialize, restore==
Om het hele skelet van ldap in één keer te herstellen dient '''init_ldap''' gebruikt te worden. Als argument '''moet''' het admin beheer wachtwoord mee gegeven worden.

===lokaal===
Backups kunnen gemaakt worden terwijl slapd draait maar geadviseerd wordt slapd te stoppen. Voor dumpen moet '''slapcat''' gebruikt worden. Backups kunnen gemaakt worden per database of een filter daarop, naar een ldif bestand.
slapcat -l hcc-dump.ldif -b "dc=hcc,dc=nl"
Dit maakt een dump van alles onder '''dc=hcc,dc=nl''' naar het bestand hcc-dump.ldif. Ook is het mogelijk het database nummer te gebruiken, config is altijd nummer 0, hdb is gewoonlijk 1.

Het '''dump_ldap''' script dumpt alle ou's in aparte .ldif bestanden; het omgekeerde doet '''restore_ldap'''.
Terug inlezen kan alleen in een lege directory, dus direct nadat '''init_ldap''' is gedaan. Gebruik voor het terugplaatsen '''slapadd'''. Aan te bevelen is '''-c''' mee te geven zodat ondanks fouten doorgegaan wordt.

Voor slapadd '''moet''' slapd gestopt zijn. Denk er om alvorens te slapd starten het ownership van de bestanden in /var/lib/ldap recht te zetten! (dit lijkt niet meer nodig te zijn vbs20130526)
/etc/init.d/slapd stop
slapadd -l hcc-dump.ldif -w -c >errors.txt
chown openldap:openldap /var/lib/ldap/*
/etc/init.d/slapd start

===remote===
Er wordt dagelijks een encrypted remote backup gemaakt naar backup2bit. Zie voor meer info [[Encrypted_backup]]. Dit script maakt gebruik van unieke gpg keys. Op elke server is dus een eigen versie nodig van '''backup-encrypted'''. 
Recente lokale backups zijn te vinden in '''/usr/local/hobbynet/tmp'''.

===Verse ldap maken===
Transactie log bij het toevoegen van b.v. een nieuwe ou:

<pre>
Op beide servers:
schema van test server gecopieerd en geactiveerd
dump-ldap gedraaid
systemctl stop slapd.service

Er is nu géén ldap service! Werk dus snel...

op ldap-lb1:
init-ldap.sh <adminpw>
restore-ldap.sh
wacht op indexering (tot slapd uit top verdwijnt)
Slapd service is nu in de lucht op ldap-lb1
systemctl stop slapd.service

op ldap-lb2:
init-ldap.sh <adminpw>
restore-ldap.sh
wacht op indexering (tot slapd uit top verdwijnt)
Slapd service is nu in de lucht op ldap-lb2

op ldap-lb1:
systemctl start slapd.service
Beide slapd servers zijn in de lucht en moeten synchroniseren.

op beide servers:
check replicatie (netstat en functioneel)

root@ldap-lb1:/usr/local/hobbynet/bin# netstat -n | grep 389
tcp 0 0 172.31.8.4:36838 172.31.8.5:389 ESTABLISHED
tcp 0 0 172.31.8.4:36836 172.31.8.5:389 ESTABLISHED
tcp 0 0 172.31.8.4:389 172.31.8.5:58112 ESTABLISHED
tcp 0 0 172.31.8.4:389 172.31.8.5:58114 ESTABLISHED

Functioneel door met ADS op beide servers in te loggen en een willekeurig veld in je eigen entry te wijzigen op lb1. Kijk of het gebeurd is op lb2 en wijzig het daar terug. Check op de andere server of het gebeurd is. Er kan een zekere vertraging in optreden.

Stel er is een nieuwe ou gemaakt: denk aan het bij werken van de dump en restore scripts.

update dump-ldap.sh en restore-ldap.sh met de nieuwe ou

op ldap-lb1:
export tarieven.ldif op test server en import op ldap-lb1
</pre>

==crontab==
# script dat updates ophaalt (maar niet installeert), zodat nagios ze ook detecteert
0 9 * * * /usr/local/hobbynet/bin/upd_srv >/dev/null
0 18 * * * /usr/local/hobbynet/bin/upd_srv >/dev/null

==LDAP Clients==
Er zijn meerdere LDAP clients. De meest populaire zijn Apache Directory Studio ("ADS") en phpLdapAdmin ("PLA"). 
De eerste is veel uitgbreider maar vereist een Java Runtime Environment ("JRE"). Onder Windows is dat JRE(13) of (open)JDK-(13). 
PhpLdapAdmin draait onder apache. Beide clients hebben wat configuratie nodig; Bij ADS gaat alles stapsgewijs in de GUI. Voor PLA moet /etc/phpldapadmin/config.php aangepast worden.

Binnen Hobbynet wordt uitsluitend gebruik gemaakt van ADS.

===StartTLS===
Aanbevolen wordt StartTLS op poort 389 te gebruiken. Alternatief is LDAPS op poort 636 maar dat is deprecated.

Voor beide clients is het belangrijk dat de root certificaten gevonden kunnen worden. Als Apache al een server cert kent zou PLA geen probleem mogen zijn. ADS maakt deel uit van de JRE. JRE moet dus de root certificaten kunnen vinden.

===ADS onder Windows===
2019-10-31 HJV: Oude info, als referentie leuk, maar niet meer relevant 
Onder Windows moet met '''keytool.exe''' gewerkt worden. De uitleg heb ik van [http://www.talkingtree.com/blog/index.cfm?mode=entry&entry=25AA75A4-45A6-2844-7CA3EECD842DB576 hier]. Het komt erop neer dat de .pem of .der certificaten van CAcert in de keystore gezet worden. Kopieer deze certificaat bestanden in C:\Program Files\Java\jre6\lib\security (jre6 kan ondertussen jre7 zijn in Vista of W7). Doe dan in een terminal window:
<pre>
Haal de benodigde bestanden op (op een Linux systeem):
wget http://www.cacert.org/certs/root.der -O root.der
wget http://www.cacert.org/certs/class3.der -O class3.der
copieer de bestanden naar de Windows omgeving in C:\Program Files (x86)\Java\jre6\lib\security.

Open een commandwindow:
cd C:\Program Files (x86)\Java\jre6\lib\security
..\..\bin\keytool -import -trustcacerts -keystore cacerts -storepass changeit -noprompt -alias cacertclass1 -file root.der
..\..\bin\keytool -import -trustcacerts -keystore cacerts -storepass changeit -noprompt -alias cacertclass3 -file class3.der
</pre>
De Windows JRE is ook te managen via het Java applet in het configuratiescherm. Toevoegen van root certificaten lijkt niet mogelijk voor system; wel voor user. Niet verder naar gezocht.

===ADS onder Linux===
Apache Directory Studio laat zich uit een tarball installeren. Dit kan geheel in userspace; er is geen make install o.i.d. nodig. ADS loopt vanuit de lokatie waar het uitgepakt is.

===ADS gebruik===
ADS kan erg handig zijn voor het snel dumpen van hele ou's in .ldif formaat. Zo'n dump kan direct op een andere server worden ingelezen.

===PhpLdapAdmin onder Linux===
Voor ldap clients (phpldapadmin) dient de client configuratie goed te zijn. Deze bevindt zich in /etc/ldap/ldap.conf. Het is voldoende als de directory met de root certificaten bekend is. Deze client configuratie is meer php-ldap gebonden dan alleen voor PLA. Ook de Drupal LDAPauth module werkt met ditzelfde beatand. Zie ook de [http://phpldapadmin.sourceforge.net/wiki/index.php/Server:server:tls phpldapadmin wiki].
<pre>
#
# LDAP Defaults
#

# See ldap.conf(5) for details
# This file should be world readable but not world writable.

#BASE dc=example,dc=com
#URI ldap://ldap.example.com ldap://ldap-master.example.com:666

#SIZELIMIT 12
#TIMELIMIT 15
#DEREF never
TLS_CACERT /etc/ssl/certs/CAcert_org.pem
TLS_CERT /etc/ssl/private/hobby.nl.crt
TLS_KEY /etc/ssl/private/hobby.nl.key
TLS_REQCERT allow
#TLS_REQCERT never
</pre>
Denk er wel aan na wijzigingen Apache te herstarten.
===PAM en NSS via LDAP===
Het inloggen van gebruikers kan ook via een LDAP server en client geschieden. Hiervoor dienen enkele pakketten geïnstalleerd en geconfigureerd te worden. Er zijn wijzigingen nodig in /etc/nsswitch.conf en de /etc/pam.d/common-* bestanden. Beide zijn via dedicated tools aan te passen.

Installeer '''libnss-ldapd''' om de benodigde libraries te verkrijgen. Apt-get zal tevens '''libpam-ldapd''', '''nslcd''' en '''nscd''' binnen brengen.
<pre>
apt-get install libnss-ldapd auth-client-config ldap-utils
The following extra packages will be installed:
libpam-ldapd nscd nslcd
</pre>
Libnss-ldapd is een doorontwikkeling van libnss-ldap en bevat meerdere verbeteringen. Zie: [http://arthurdejong.org/nss-pam-ldapd/ deze site] van de ontwikkelaar. Bij de installatie wordt een user '''nslcd''' aangemaakt; denk erom die in de .tmpl bestanden te zetten!

nsswitch.conf laat zich configureren via '''auth-client-config''' maar lac_ldap is alleen aanwezig als '''ldap-auth-config''' ook is geinstalleerd. Zo niet gebruik dan de tweede regel:
<pre>
auth-client-config -t nss -p lac_ldap
auth-client-config -t nss -p ldap_example
</pre>
Het resultaat is dat nsswitch.conf zowel in files (/etc/passwd etc.) zoekt als in ldap.
<pre>
# /etc/nsswitch.conf
#
# Example configuration of GNU Name Service Switch functionality.
# If you have the `glibc-doc-reference' and `info' packages installed, try:
# `info libc "Name Service Switch"' for information about this file.

# pre_auth-client-config # passwd: compat
passwd: files ldap
# pre_auth-client-config # group: compat
group: files ldap
# pre_auth-client-config # shadow: compat
shadow: files ldap

hosts: files dns
networks: files

protocols: db files
services: db files
ethers: db files
rpc: db files

# pre_auth-client-config # netgroup: nis
netgroup: nis
</pre>
Het aanpassen van de PAM bestanden gaat sinds enige releases met '''pam-auth-update'''. Kies in het menu voor zowel unix als ldap. Default wordt nu ldap authenticatie gebruikt voor uid >= 1000. Bij Hobbynet willen we vanaf 300 ldap gebruiken. Door een licht gemodificeerde versie van /usr/share/pam-configs/ldap te maken (ldap-hobbynet), kan ook voor de hobbynet instelling gekozen worden. Dit is de ldap-hobbynet versie:
<pre>
Name: LDAP Authentication (uid>300)
Default: yes
Priority: 128
Auth-Type: Primary
Auth-Initial:
[success=end default=ignore] pam_ldap.so minimum_uid=300
Auth:
[success=end default=ignore] pam_ldap.so minimum_uid=300 use_first_pass
Account-Type: Additional
Account:
[success=ok new_authtok_reqd=done ignore=ignore user_unknown=ignore authinfo_unavail=ignore default=bad] pam_ldap.so minimum_uid=300
Password-Type: Primary
Password-Initial:
[success=end default=ignore] pam_ldap.so minimum_uid=300
Password:
[success=end default=ignore] pam_ldap.so minimum_uid=300 try_first_pass
Session-Type: Additional
Session:
[success=ok default=ignore] pam_ldap.so minimum_uid=300
</pre>

Dit is in een standaard opzet van LDAP voldoende om zowel lokale gebruikers als gebruikers opgeslagen in LDAP, te laten inloggen en hun password te laten wijzigen. In de Hobbynet setup moet er echter nog meer gebeuren in de ACL's van de LDAP server configuratie. Omdat Hobbynet de laatste ACL regel heeft gewijzigd in een '''deny-all''', is er een helper of proxy account nodig dat read access heeft of een aantal cruciale velden in de posixAccount objectClass. Zie verder de lsiting van nslcd.conf.

Libnss-ldapd en libpam-ldapd hebben een gezamelijke daemon '''nslcd''' die z'n configuratie uit '''/etc/nslcd.conf''' haalt. Hierin is ook een voorziening voor het helper account. Aan het eind vande '''nslcd.conf''' staat de voorziening voor host-based login. Als het attribute '''host''' de fqdn of alleen de host naam bevat, bepaald dat of inloggen op die host mogelijk is. '''*''' staat inloggen op alle hosts toe.

Eventueel kan het daemon proces voor debugging doeleinden ook als command ('''nslcd -d''') gestart worden. Om de bevragingen van de LDAP server wat te verminderen, kan '''nscd''' voor caching zorgen. Deze cache daemon heeft zijn eigen configuratie bestand: '''/etc/nslcd.conf'''. De default instellingen zijn goed; eventueel kan de logging naar een bestand gestuurd worden.

Verbinding met de LDAP server kan met StartTLS beveiligd worden. Hier de inhoud van nslcd.conf:
<pre>
# /etc/nslcd.conf
# nslcd configuration file. See nslcd.conf(5)
# for details.

# The user and group nslcd should run as.
uid nslcd
gid nslcd

# log location and level
#log /var/log/nslcd.log debug

# The location at which the LDAP server(s) should be reachable.
uri ldap://ldap2-int.hobby.nl/

# The search base that will be used for all queries.
base dc=hcc,dc=nl

# Other base mappings
base group ou=groups,dc=hcc,dc=nl
base passwd ou=users,dc=hcc,dc=nl
base shadow ou=users,dc=hcc,dc=nl

# The search scope.
#scope sub

# The LDAP protocol version to use.
ldap_version 3

# The DN to bind with for normal lookups.
#binddn cn=annonymous,dc=example,dc=net
#bindpw secret
binddn cn=hobbynetlogin,ou=applicaties,dc=hcc,dc=nl
bindpw xxxxxxxxxxxxxxxxx

# The DN used for password modifications by root.
#rootpwmoddn cn=admin,dc=example,dc=com

# SSL options
ssl off
ssl start_tls
#tls_reqcert never
tls_cacertfile /etc/ssl/certs/cacert.org.pem
#tls_cert /etc/ssl/private/server.crt
#tls_key /etc/ssl/private/server.key

# The minimum uid
nss_min_uid 300

pam_authz_search (&(objectClass=posixAccount)(uid=$username)(|(host=$hostname)(host=$fqdn)(host=\\*)))
</pre>

===users en groepen toevoegen===
Hiervoor moet '''ldapscripts''' zijn geïnstalleerd. Dit is het geval op de ldap-lb1 server. Dat levert de volgende extra commando's op:
<pre>
ldaprenamemachine
ldapadduser
ldapdeleteuserfromgroup
ldapfinger
ldapid
ldapgid
ldapmodifyuser
ldaprenameuser
lsldap
ldapaddusertogroup
ldapsetpasswd
ldapinit
ldapaddgroup
ldapdeletegroup
ldapmodifygroup
ldapdeletemachine
ldaprenamegroup
ldapaddmachine
ldapmodifymachine
ldapsetprimarygroup
ldapdeleteuser
</pre>
Meest gebruikt zijn '''ldapaddgroup, ldapadduser, ldapsetpasswd'''.
Er zijn manpages maar er is ook uitgebreide uitleg in de [https://help.ubuntu.com/14.04/serverguide/openldap-server.html Ubuntu server guide]. Omdat wij het automatisch maken van de home dir uit hebben staan, moet die met de hand aangemaakt worden en moet de owner goed gezet worden.

===host-based login===
Met een kleine uitbreiding in het schema van de LDAP server, kan host-based login gerealiseerd worden. Ook in de '''nslcd.conf''' is een uitbreiding nodig.

In de LDAP server dient de objectClass '''hostObject''' aan de entries in de ou=users toegevoegd te worden. Deze (auxilary) objectClass brengt slechts één attribute met zich mee: '''host'''. De regel in nslcd.conf checkt of één van de waarden van '''host''' gelijk is aan de naam van de server waarop ingelogd wordt. De waarde '''*''' geldt als wildcard. Zie de regel ''
'pam_authz_search'''' in '''nslcd.conf'''.

===Password aanpassen===
Via LDAP ingelogde gebruikers kunnen net als lokale gebruikers hun wachtwoord met '''passwd''' wijzigen. Wel moet aan de eisen in de LDAP ppolicy module voldaan worden.

==PHP scripting==
Initieel worden alle leden op basis van hun hcc lidnummer ingelezen. Zodra de profielwizard doorlopen is, zal het lidnummer vervangen moeten worden door de gebruikersnaam. Er zijn verschillende php-scripts gemaakt, o.a. om snel alle kaderrollen te verwijderen. Php-scripts staan in de '''/usr/local/hobbynet/bin''' directory.
Voor de php-scripting zijn enkele php7.x pakketten nodig. Installeer deze met apt-get. Het gaat om:
* php-cli
* php-ldap

== Apache authenticatie via LDAP ==
In plaats van .htpassword authenticatie, kan ook LDAP gebruikt worden. Activeer daartoe de Apache module
'authnz_ldap'.
a2enmod authnz_ldap
Denk er om dat dit in een loadbalanced situatie op beide servers gedaan dient te worden!

=== Voorbeeld van een LDAP configuratie in de Apache config ===
(alleen als voorbeeld, niet zo gebruiken!) 

<pre>
# // 1) Hobbynet webmaster
# // 2) Vraagbaak medewerker van een willekeurige groepering
# (|(hccRol=*#VRBK)(hccRol=HN#WM))
<Location "/apps/vraagbaak">
<RequireAll>
Authname "HCC!vraagbaak (gebruik uw hcc.nl gebruikersnaam/wachtwoord)"
AuthType Basic
AuthBasicProvider ldap
AuthLDAPUrl ldap://hcc-ldap-int.hobby.nl/ou=leden,dc=hcc,dc=nl?hccLogin??(|(hccRol=*#VRBK)(hccRol=HN#WM))(hccProfiel=TRUE) TLS
require valid-user
</RequireAll>
</Location>
</pre>

=== Hoe kan LDAP veilig gebruikt worden vanuit Apache===
Zet een script neer in de gebruikersomgeving, en gebruik mod_authz_external. Doe de controle vervolgens via de XML-RPC server. 

'''Zie [[Kadernet]] voor een voorbeeld.'''

== TODO lijst ==
''Dit is een lijst in wording, graag aanvullen''
* 'dun' loadbalancer script maken om te controleren dat LDAP echt luistert

Cron jobs

2020-12-08T16:21:54Z

Hans:

= Beschrijving =
Op deze pagina staan de door hobbynet aangemaakte cronjobs, met een korte omschrijving en wanneer het draait zodat je in 1 overzicht kan zien waar wat en wanneer draait.

= servers specifiek=

== scripting ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| scripting
| /usr/local/hobbynet/bin/upd_servers
| root
| Check op updates en download deze, en herstart de firewalls en memcache
| 06:45 18:45
| 2x per dag
|

|-
| scripting
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y >/dev/null
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:01 18:01
| 2 x per dag
|

|-
| scripting
| /usr/local/hobbynet/bin/sync_all
| root
| Update de gecentraliseerde webserver config op loadbalanced servers
| 06:30
| 1x per dag
|

|-
| scripting
| /usr/local/hobbynet/bin/sync_fw
| root
| Update en herstart firewall op machines die geen nfs mount hebben
| 00:42
| 1x per dag
|

|}

== domein ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| domein
| /usr/sbin/nsd-control write
| root
| Schrijf alle slave zones uit geheugen naar file
| ieder uur
| 24x per dag
|

|-
| domein
| /usr/local/hobbynet/opendnssec/ods-dsseen --all
| root
| Activeer nog niet geactiveerde dnssec sleutels
| *:30
| 24x per dag
|

|-
| domein
| /usr/local/hobbynet/opendnssec/ods-dsseen --really-all
| root
| Activeer nog niet geactiveerde dnssec sleutels voor eerste keer en loop echt alle zones na
| 01:20
| 1x per dag
|

|-
| domein
| /usr/local/hobbynet/opendnssec/sidn/update-prod-from-live.php
| root
| Update alle DNS zones op basis gegevens van SIDN
| 22:15
| 1x per dag
|

|-
| domein
| /usr/local/hobbynet/opendnssec/transip/update-prod-from-transip.php
| root
| Update alle DNS zones op basis gegevens van Transip
| 22:15
| 1x per dag
|

|}

== ldap-lb1 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| ldap-lb1
| /usr/local/hobbynet/bin/sync_hobbynetfw_2.sh
| root
| Synchroniseer firewall regels van ldap-lb1 naar ldap-lb2 
''' moet draaien voor de firewall restart '''
| 05:55 11:55 17:55 23:55
| 4 x per dag
|

|-
| ldap-lb1
| /etc/init.d/hobby-firewall restart
| root
| Herstart Firewall 
''' moet draaien na de firewall synchronisatie job '''
| 06:00 12:00 18:00 00:00
| 4 x per dag
|

|-
| ldap-lb1
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y >/dev/null
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/local/backup-encrypted.bash >>/var/log/backup_encrypted.log
| root
| Encrypted backup naar Backup2bit
| 23:45
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/sync_hobbynetbin_2.sh
| root
| Sync bin dir naar ldap-lb2
| 23:50
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/sync_hobbynetetc_2.sh
| root
| Sync etc dir naar ldap-lb2
| 23:51
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/sync_hobbynetlib_2.sh
| root
| Sync lib dir naar ldap-lb2
| 23:52
| 1 x per dag
|

|}

== extra op ldap-lb1 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| ldap-lb1
| /usr/local/hobbynet/bin/cron_joomla.sh
| root
| Draai joomla cron job voor joomla sites met login module zodat er zo min mogelijk lid gegevens in backup zitten
| 00:15
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/LDAP_export_passwords.sh
| root
| Zet de (door LA/de gebruiker) aangepaste wachtwoorden over naar het CRM
| 23:20
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/gen_iplist_partners.sh
| root
| Maak /usr/local/hobbynet/apache2conf/iplists/iplist-partners-24 aan
| 03:07
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/LDAP_cronjob.sh
| root
| Doe alle processing CRM->LDAP
| 03:10
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/run_tripolis_import.sh >/var/log/run_tripolis_import.log
| root
| Haal de opt-outs op van Tripolis
| 03:15
| 1 x per dag
|
|-
| ldap-lb1
| /usr/local/hobbynet/bin/mail_tripolis_import_report.sh
| root
| Haal de handmatige tripolis opt-outs op, en mail die naar de ledenadministratie
| 03:31
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/upd_mailserver.sh >/var/log/upd_mailserver.log
| root
| Ververs postfixadmin op mail-lb1 en mail-lb2
| 03:26
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/mail_upd_mail_report.sh
| root
| Mail resultaat van upd_mailserver naar Egbert
| 03:30
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/upload_leden_csv.sh
| root
| Maak en plaats de ledenlijst voor Kantoor
| 03:35
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/upload_kader_csv.sh
| root
| Maak en plaats de kaderlijst voor Kantoor
| 03:40
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/unblock_joomla.sh
| root
| De-blokkeer actieve users
| 03:45
| 1x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/upload_bezoekersstatistiek.sh
| root
| Haal de aantallen bezoekers, en zet die over naar de Joomla kadersite (en de beta-site)
| 03:47
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/run_tripolis_export.sh >/var/log/run_tripolis_export.log
| root
| Maak overzicht van alle opt-ins voor Tripolis
| 03:50
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/mail_tripolis_export_report.sh
| root
| Mail de resultaten van de Tripolis export run naar Egbert
| 03:52
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/renameusers_joomla.sh
| root
| Hernoem de users die hernoemd zijn in ldap in de joomla sites
| 03:50
| 1x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/statistiek_xml.sh
| root
| Maak en plaats statistiek overzicht van alle HCC groeperingen
| 03:55
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/cron_joomla.sh
| root
| Draai voordat update_joomla.php draait nogmaals de cron job, zodat ook in de user backup zo min mogelijk lid gegevens zitten, en dat alle sites zijn bijgewerkt aan de hand van de laatste ldap import
| 03:55
| 1 x per dag
|

|-
| ldap-lb1
| php /usr/local/hobbynet/bin/update_joomla.php
| root
| Voer dagelijkse Joomla onderhoud uit op alle Joomla template sites
| 04:00
| 1x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/run_maand_rapport.sh
| root
| Doe de Hobbynet maand rapportage
| 04:00
| 1e van de maand
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/tel_unieke_bezoekers-volgens-LDAP.sh
| root
| Bepaal het aantal unieke bezoekers volgens LDAP, mail dat aan VB
| 04:05
| 1e van de maand
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/huisgenoot_lidmaatschappen.sh
| root
| Maak een lijst van onjuiste huisgenoot-lidmaatschappen
| 04:10
| 1e van de maand
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/schoon_alles_op.sh
| root
| Schoon mySQL en LDAP op
| 04:05
| 2e van de maand
|

|}

== ldap-lb2 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| ldap-lb2
| /etc/init.d/hobby-firewall restart
| root
| Herstart Firewall
| 06:15 12:15 18:15 00:15
| 4 x per dag
|

|-
| ldap-lb2
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|-
| ldap-lb2
| /usr/local/hobbynet/local/backup-encrypted.bash
| root
| Encrypted backup naar Backup2bit
| 23:30
| 1 x per dag
|

|}

== ldap-test ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| ldap-test
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|}

== xml-lb1, xml-lb2 en xml-test ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| xml-lb1
| /etc/init.d/hobby-firewall restart
| root
| Herstart Firewall
| 06:00 12:00 18:00 00:00
| 4 x per dag
|

|-
| xml-lb1
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|-
| xml-lb1
| /usr/local/hobbynet/local/backup-encrypted.bash >>/var/log/backup_encrypted.log
| root
| Encrypted backup naar Backup2bit
| 23:45
| 1 x per dag
|

|-
| xml-lb2
| /usr/local/hobbynet/local/backup-encrypted.bash >>/var/log/backup_encrypted.log
| root
| Encrypted backup naar Backup2bit
| 23:30
| 1 x per dag
|

|-
| xml-lb2
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|-
| xml-test
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|}
== opslag 1,2 en 3 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| opslag 1 t/m 3
| test -x /usr/local/hobbynet/bin/defragdisk && /usr/local/hobbynet/bin/defragdisk >/dev/null
| root
| Defragmenteer de /disk partitie op de actieve storage server
| 03:42
| Elke 13e en 28e van de maand
| '''mits hij de actieve storage server is'''

|-
| opslag 1 t/m 3
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|-
| opslag 1 t/m 3
| test -x /usr/local/hobbynet/bin/backup2bas && /usr/local/hobbynet/bin/backup2bas >/dev/null
| root
| Backup van /disk naar nas bij Bas 
| 01:42
| Elke dag
| '''mits hij de actieve storage server is'''

|-
| opslag 1 t/m 3
| test -x /usr/local/hobbynet/bin/backup2nas && /usr/local/hobbynet/bin/backup2nas >/dev/null
| root
| Backup van /disk naar nas in het rack 
| 06:42
| Elke dag
| '''mits hij de actieve storage server is'''

|}

== nagios-lb1 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| nagios-lb1
| /usr/local/hobbynet/bin/sync_nagios
| root
| Synchroniseer nagios-lb1 naar nagios-lb2
| 00:00 06:00 12:00 18:00
| 6 x per dag
|

|}

== nagios-lb2 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|}

== db01 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| db01
| /usr/local/hobbynet/bin/database-onderhoud >/dev/null
| root
| Database onderhoud
| 02:36
| 1 x per dag
|

|}

== db02 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| db02
| /usr/local/hobbynet/bin/database-onderhoud >/dev/null
| root
| Database onderhoud
| 00:36
| 1 x per dag
|

|}

== hcc-db03 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| hcc-db03
| /usr/local/hobbynet/bin/database-onderhoud >/dev/null
| root
| Database onderhoud
| 02:36
| 1 x per dag
|

|}

== hcc-db04 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| hcc-db04
| /usr/local/hobbynet/bin/database-onderhoud >/dev/null
| root
| Database onderhoud
| 00:36
| 1 x per dag
|

|}

== backup2bit ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_mysql01
| root
| Maak database dump en Rsync databases naar backup2bit
| 00:05
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_mysql02
| root
| Maak database dump en Rsync databases naar backup2bit
| 12:10
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_mysql03
| root
| Maak database dump en Rsync databases naar backup2bit
| 00:40
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_mysql04
| root
| Maak database dump en Rsync databases naar backup2bit
| 12:10
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_mysql05
| root
| Maak database dump en Rsync databases naar backup2bit
| 00:15
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_mysql06
| root
| Maak database dump en Rsync databases naar backup2bit
| 12:14
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_domein
| root
| Maak database dump en Rsync databases naar backup2bit
| 12:15
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_otrs
| root
| Maak database dump en Rsync databases naar backup2bit
| 00:35
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_mail-lb1
| root
| Maak database dump en Rsync databases naar backup2bit
| 00:40
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_mail-lb2
| root
| Maak database dump en Rsync databases naar backup2bit
| 12:40
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_server_configs
| root
| Backup server configs van alle servers
| 23:01
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_usrlocalhobbynet
| root
| Backup /usr/local/hobbynet naar /disk/backup/hobbynet
| 00:01
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_pxe
| root
| Backup /var/lib/tftpboot (van de PXE server) naar /disk/backup/pxe-int/pxe
| 23:55
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/sync_ns3
| root
| Zet hcc.nl, hobby.nl en pc-active.nl over naar de backup-omgeving op ns3
| 06:42
| Elke dag
|

|}

== sftp ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| sftp
| /usr/local/hobbynet/local/backup >>/var/log/backup.log
| root
| Backup server config naar backup2bit-int
| 23:45
| Elke dag
|

|-
| sftp
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|}

==logging==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| logging
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|-
| logging
| /usr/local/hobbynet/bin/backup_etc
| root
| Trek een backup van de etc map, en zet die over naar backup2bit
| 22:00 
| Elke dag
|

|}

= alle servers =
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| alle servers
| /home/bas/baskeys
| bas
| Update ssh keys voor bas
|
| Elk uur
|

|}

XML-RPC

2020-11-28T13:42:10Z

Hans:

= XML-RPC interface =

De LDAP server kan direct gemuteerd worden via een LDAP koppeling. Zie
de standaard LDAP pagina voor de uitleg welke poorten daarvoor gebruikt
kunnen worden.

Daarnaast is er de wens ontstaan om via een standaard protocol met de
LDAP omgeving te kunnen communiceren. Er is hiertoe een XML-RPC
koppeling ontwikkeld. XML-RPC is een standaard interface, waarmee het
mogelijk is om vanuit diverse omgevingen op een gestandaardiseerde
manier te communiceren.

== Globale functie omschrijving ==
* Algemene aanroepen
** Controleer of een gebruiker bestaat
** Wijzig het wachtwoord ('userPassword')
** Zoek een gebruiker (t.b.v. kantoor en/of LA-akties groeperingssecretaris)
** Maak een gebruiker aan (geef gebruiker een andere hccLogin waarde, maak ook bij HCCnet deze gebruiker aan)
** Controleer of een gebruiker zijn profiel al doorlopen heeft
** Haal de lijst met opgeheven accounts op
** Haal de lijst met bulletins van een hcc lid (OptIn)

* Aanroepen t.b.v. hcc partners
** Controleer of lidnummer/postcode correct is
** Controleer of lidnummer/postcode correct is, en tevens ingeschreven staat bij een specifieke IG

* Joomla template site functies (op basis van JoomlaToken)
** Maak een JoomlaToken
** Ruim een JoomlaToken op
** Pas mijn OptIn (bulletin inschrijving) aan
** Regel alles rondom Onderwerpen en de autorisatie hiervan
** Pas mijn wachtwoord aan

* Joomla kadernet site functies (op basis van JoomlaToken)
** Zoek een hcc kaderlid (t.b.v. de kaderleden zoekpagina)
** Pas mijn kadermail forwarding aan en toon ja/nee mijn GSM nummer
** Pas het kadernet e-mail wachtwoord aan
** Haal de lijst met alle groeperingen op
** Haal de lijst met alle kaderrollen op

* Joomla hcc.nl site (op basis van JoomlaToken)(mijn.hcc.nl vervanging)
** Pas mijn adresgegevens aan
** Pas mijn voorletters, voornaam, pseudoniem, telefoonnummer, GSM nummer etcetera aan
** Schrijf me in of uit op een bulletin
** Toon info over de kosten van een IG lidmaatschap
** Voer een wachtwoord reset uit op basis van een PWResetToken (een variant op JoomlaToken)
** Vraag een nieuwe HCC code aan, en stuur die per SMS

* Joomla hobby.nl site (op basis van JoomlaToken)(t.b.v. IDEAL betaling)
** Haal het aantal hobbyDomains op

* Aanroepen t.b.v. CRM (Microsoft Dynamics Cloud) koppeling
** Haal de dagelijkse synchronisatie bestanden op
** Werk in het CRM dan wel in LDAP de NAW gegevens bij
** Werk in het CRM dan wel in LDAP de IG gegevens van een lid bij

* HenZ
** Haal de lijst met opzeggers op
** Valideer de opzegdatum van een opgegeven gebruiker

=== Authenticatie ===

Alle aanroepen gebeuren op basis van authenticatie vanuit de aanroeper.
Dit valt uiteen in de volgende categorieën:
* gebruikersnaam ('hccLogin') en wachtwoord ('userPassword')
* hcc lidnummer ('hccLidnr'), Joomla token ('JoomlaToken') en website ('siteID')
* hcc lidnummer ('hccLidnr') en hcc code ('hccCode')
* beheerders-DN ('beheerLogin') en beheerders wachtwoord ('beheerPassword')
* partner-DN ('partnerLogin') en partner wachtwoord ('partnerPassword')

=== Aanroepen, gedaan via de bezoekersregistratie-proxy ===
(de bezoekersregistratie proxy is een mislukt project tbv de Android app van René Prins)
(deze proxy bestaat niet meer) 
Diverse aanroepen kunnen ook via de bezoekersregistratie-proxy aangeroepen worden. 
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
* GeefAlleGroeperingen
* GeefAlleKaderRollen
* GeefLocaties
* GeefLocatieNamen
De bezoekersregistratie aanroepen hebben 'JoomlaToken' als extra parameter nodig:
* LidBezoektBijeenkomst
* GeefBezoekersOverzicht
* GeefBezoekersAantallen
De aanroepen die over de proxy uitgevoerd worden dienen voorafgegaan te worden door een aanroep naar
* GeefMijnGegevens (dit geeft na validatie immers 'JoomlaToken' terug)

=== Resultaten ===

Alle aanroepen geven de volgende elementen terug:
* Naam van de uitgevoerde procedure ('Action')
* Resultaat van de uitgevoerde procedure ('Status')
* Een tekstuele vertaling van het resultaat dan wel de foutmelding ('Message')
* Tijdens de ontwikkelfase kan er debug-info teruggeleverd worden ('ExtraInfo')
Daarnaast geven specifieke aanroepen extra resultaten terug

== Technische omschrijving ==
XML-RPC beschrijving van acties in hcc.nl LDAP database

<pre>
2020.11.28 HaVe
XML-RPC Hobbynet versie 65.
</pre>

=== Kort overzicht ===
Dit is een lijst met alle XML-RPC aanroepen. In het volgende hoofdstuk worden ze in detail besproken.
<pre>
echo (partners)
ExpandeerPostcode (Joomla module Bas, tbv verhuizingen)
GebruikerBestaatControle (Joomla sites)
GeefAantalDomeinen (Joomla module Bas)
GeefAlleBulletins (Joomla module Bas)
GeefAlleGroeperingen (kadersite, forum, secr. portal, kantoor portal, hobbynet portal)
GeefAlleKaderRollen (forum, secr. portal, kantoor portal, hobbynet portal, Joomla module Bas)
GeefBezoekersOverzicht (bezoekersregistratie)
GeefBezoekersAantallen (bezoekersregistratie)
GeefFactuurOverzicht (Joomla module Bas)
GeefhccEindDatum (HenZ)
GeefKadermailGegevens (kantoor portal)
GeefLocatieNamen (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefLocaties (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefMijnGegevens (Joomla inlog module Bas)
GeefMijnLidnummer (beheer.hcc.nl secretaris portal)
GeefOnderwerpen (Joomla template sites)
GeefSSOUrls (Joomla module Bas)
GeefUitgeschrevenLeden (Joomla sites, HenZ)
HaalAanmeldingsformulier (Joomla module Bas)
HaalFactuur (Joomla module Bas)
HaalIGBedragenOp (Joomla module Bas)
HaalOptInKeuzen (kantoor portal)
HaalTariefGroepenOp (kantoor portal)
HCCpartner (Partner aanroep)
HCCpartners (Partner aanroep)
IsDezeNaamNogBeschikbaar (aangeroepen vanuit de CRM omgeving)
IsDezePseudoniemNogBeschikbaar (kantoor portal)
IsHCCLid (vraagbaak aanroep)
IsKaderLid (in veel apps gebruikt)
LidBezoektBijeenkomst (bezoekersregistratie)
MaakGebruikerAan (mijnhcc.nl, maak hccnet account aan en ldap gebruikersnaam)
MaakOnderwerp (Joomla template sites)
MaakPWResetToken (Joomla module Bas)
MaakTestLogin (Joomla module Bas)
MuteerAanmeldingsformulier (Joomla module Bas)
MuteerGroeperingSamenstelling (Joomla kadernet module Bas)
MuteerOnderwerp (Joomla template sites)
MuteerOnderwerpAutorisatie (Joomla template sites)
NormaliseerTelefoon (Joomla module Bas)
PasHccLoginAan (Joomla module Bas)(enkel Hobbynet)
PasInteressegroepAan (Joomla module Bas)
PasKaderGegevensAan (kadersite, Joomla module Bas)
PasOptInKeuzeAan (Joomla module Bas)
PasPseudoniemAan (Joomla module Bas)
PasUserWachtwoordAan (beheer.hcc.nl Hobbynet gebruikers portal)
PasWachtwoordAan (Joomla module Bas)
RegistreerGast (bezoekersregistratie)
ResetHCCCode (Joomla module Bas)
RuimJoomlaTokenOp (Joomla module Bas)
SchrijfNietlidInOpBulletin (Joomla site bulletin module Bas)
SchrijfNieuwLidIn (Joomla CRM module Bas)
ToonOnderwerpAutorisatie (Joomla template sites)
UpdateContactEmail (Joomla module Bas)
UpdateContactGegevens (Joomla module Bas)
UpdateMobiel (Joomla module Bas)
UpdateNAW (Joomla module Bas)
UpdateTelefoon (Joomla module Bas)
UpdateVoorletters (Joomla module Bas)
UpdateVoornaam (Joomla module Bas)
Upload_CSV_bestand (CRM webproxy)
ValideerPWResetToken (Joomla module Bas)
ValideerWachtwoordEisen (Joomla module Bas)
Verwerk_JSON_mutatie (CRM webproxy)
VerwijderNietLid (Joomla beheer module Bas)
VerwijderOnderwerp (Joomla template sites)
VraagLidgegevensTokenAan (bezoekersregistratie)
WijzigGebruikersGegevens (kantoor en Joomla template sites, ww aanpassen van gebruiker)
ZoekGroeperingsLid (secr. portal, kantoor portal, hobbynet portal)
ZoekHCCLid (VZ portal)
ZoekKaderLeden (Joomla kadernet module Bas)
</pre>

=== HCC-ldap en/of HCC-net aanroepen ===

<pre>
// ** Joomla sites, www.hcc.nl **
// 1.1 controleer of een gebruiker bestaat - optie 1
// (authenticatie op basis van hccLidnr en hccCode)
// Alleen bedoeld om gebruikers op www.hcc.nl op basis van het lidnr het ww te laten wijzigen
$request = xmlrpc_encode_request(
'GebruikerBestaatControle',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $method,
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd');
if ($hccLidnr != '') { $reply['hccLidnr'] = $hccLidnr; }
if ($hccLogin != '') { $reply['hccLogin'] = $hccLogin; }
if ($hccPseudoniem != '') { $reply['hccPseudoniem'] = $hccPseudoniem; }
if ($cn != '') { $reply['cn'] = $cn; }
if ($sn != '') { $reply['sn'] = $sn; }
if ($mail != '') { $reply['mail'] = $mail; }
if ($mailHccnet != '') { $reply['mailHccnet'] = $mailHccnet; }
if ($hccRegio != '') { $reply['hccRegio'] = $hccRegio; }
if ($hccIG != '') { $reply['hccIG'] = $hccIG; }
if ($hccRol != '') { $reply['hccRol'] = $hccRol; }
if ($ProfielBekend != '') { $reply['ProfielBekend'] = $ProfielBekend; }

// ** Portal mijn.hcc.nl **
// 2.1 wijzig wachtwoord - optie 1
// op basis van hccLidnummer en hccCode
// Essentiele aanroep, gebruikt vanuit mijnhcc.nl (lidnr + hccCode)
// Ook gebruikt t.b.v. wachtwoord-vergeten procedure op de Joomla template sites
// Als de profielpagina nog niet is doorlopen wordt deze aanroep afgekeurd.
//
// Ook gebruikt om gebruiker rechtstreeks vanaf Joomla template sites wachtwoord te
// laten aanpassen (op basis van lidnummer en hcc code)
//
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'WijzigGebruikersGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gewijzigd',
'hccLogin' => $hccLogin,
'cn' => $cn,
'sn' => $sn);

// 2.3 wijzig wachtwoord - optie 3
// (t.b.v. VZ-portal)
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
// * Als hccLidnr gevuld is, dan wordt hccLidnr gebruikt om het juiste record te zoeken
// Als hccLidnr leeg is, dan wordt hccLogin gebruikt om het juiste record te zoeken
// 1 van beide velden MOET aanwezig zijn
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'beheerLogin' => $beheerLogin, // beheerder lidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

// ** t.b.v. ophalen van de opt-in keuzes op de beheer pagina **
// 2.6 Geef de complete lijst met opt-ins van dit lid
// (LET OP: authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'HaalOptInKeuzen',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalOptInKeuzen',
'Status' => 'TRUE',
'Message' => 'OptInLijst opgehaald',
'hccOptIn' => $hccOptIn);
Output negatief:
$reply = array(
'Action' => 'HaalOptInKeuzen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gebruikersnaam, pseudoniem
// en wachtwoord tevens in LDAP op
// (authenticatie op basis van hcc lidnummer en hcc-code)
// ** Deze gegevens worden doorgezet naar hccnet.nl (action=4) **
//
$request = xmlrpc_encode_request(
'MaakGebruikerAan',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_hccLogin' => $nieuw_hccLogin,
'nieuw_userPassword' => $nieuw_userPassword,
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'TRUE',
'Message' => 'Gebruiker aangemaakt',
'mail' => $mail,
'hccPseudoniem' => $hccPseudoniem);
Output negatief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gebruikersnaam bestaat al' |
'Pseudoniem bestaat al' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!');

// H.3 Haal al mijn gegevens
// (wordt gebruikt door de Joomla inlogmodule)
// Voor gebruik over de proxy t.b.v. de Android app kan compact=TRUE meegegeven worden.
// In dat geval worden enkel de meest essentiele gegevens teruggestuurd
// Voor gebruik na MaakGebruikerAan kan deze functie ook op basis van hccLidnr en JoomlaToken
// worden aangeroepen
// De optionele parameter 'PrevSiteID' is bedoeld voor single-sign-on. Op basis van JoomlaToken,
// hccLidnr en PrevSiteID worden dan de credentials gevalideerd. Als die kloppen, geeft deze aanroep
// een 2e JoomlaToken terug, maar dan uitgegeven op basis van SiteID.
// Als PrevSiteID leeg is, dan wordt het token op basis van siteID gevalideerd.
$request = xmlrpc_encode_request(
'GeefMijnGegevens',
array(
['hccLogin' => $hccLogin,
'userPassword' => $userPassword,]
['hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,]
['PrevSiteID' => $PrevSiteID,]
['compact' => $compact,] // leeg of 'TRUE'
['hccGroepering'=> $hccGroepering,] // Een testgebruiker mag alleen op deze site inloggen
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd',
'hccLidnr' => $hccLidnr,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccAutorisatie' => $hccAutorisatie,
'cn' => $cn,
'sn' => $sn,
'JoomlaToken' => $JoomlaToken,
['hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'givenname' => $givenname,
'hccAanhef' => $hccAanhef,
'hccGeslacht' => $hccGeslacht,
'hccTussenVoegsels' => $hccTussenVoegsels,
'hccAchternaam' => $hccAchternaam,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward,
'hccKaderToonMobiel' => $hccKaderToonMobiel,
'hccOptIn' => $hccOptIn,
'ProfielBekend' => $ProfielBekend,
'hccBeginDatum' => $hccBeginDatum,
['kadermail_omvang' => $Formaat, // in Mb
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald;]]);

Output negatief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// ** t.b.v. aanpassen van de opt-in keuzes op een Joomla site **
// H.4 Pas 1 opt-in van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// Als hccLidnummer gevuld is, dan is dat het lidnummer waar de mutatie op moet worden uitgevoerd.
// Dat kan alleen als de aanvrager HCC#LAD of HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasOptInKeuzeAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
['hccLidnummer' => $hccLidnummer,]
'hccOptIn' => $hccOptIn,
'actie' => 'Nieuw' | 'Weg',
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'TRUE',
'Message' => 'OptIn aangepast');
Output negatief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// H.5 Zoek kaderleden NAW (t.b.v. de Joomla kadersite)
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
//
// * Er dient minstens 1 zoekcriterium opgegeven te worden.
// * Als zowel hccRegio als tegelijk ook hccIG opgegeven worden is de uitkomst onvoorspelbaar.
// * Als compact=TRUE worden enkel lidnummer, cn en sn in het antwoord gezet
$request = xmlrpc_encode_request(
'ZoekKaderLeden',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
['hccRegio' => $hccRegio,]
['hccIG' => $hccIG,]
['hccRol' => $hccRol,]
['hccLocatie' => $hccLocatie,]
['achternaam' => $achternaam,]
['compact' => $compact])); // leeg of 'TRUE'

Output positief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'TRUE',
'Message' => 'Kaderleden opgevraagd'
'Kaderleden' => array(
'hccLidNummer' => $hccLidNummer,
'hccRol' => $hccRol,
'hccAanhef' => $hccAanhef,
'givenname' => $givenname,
'cn' => $cn,
'sn' => $sn,
'hccWoonplaats' => $hccWoonplaats,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'hccKaderMail' => $hccKaderMail);

Output negatief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token']);

// H.9 PasKaderGegevensAan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
// Om de kaderleden hun forward in te laten stellen,
// en tegelijkertijd de opt-in / opt-out voor hccToonMobiel te laten regelen
// Kan tevens het kader email wachtwoord aanpassen
$request = xmlrpc_encode_request(
'PasKaderGegevensAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'hccKaderForward' => $hccKaderForward, // '' | $mail | $mailHccNet
'hccKaderToonMobiel' => $hccKaderToonMobiel, // 'TRUE' | 'FALSE' | 'NULL'
['nieuw_kaderPassword' => $nieuw_kaderPassword]));

Output positief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'TRUE',
'Message' => 'kadergegevens aangepast');

Output negatief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token'|'Alleen kaderleden mogen deze aanroep uitvoeren']);

// ** Portal beheer.hcc.nl
// ** H.10 PasUserWachtwoordAan
// ** Betalende Hobbynet gebruikers kunnen hiermee hun wachtwoord aanpassen
// (authenticatie op basis van hccLogin en userpassword)
$request = xmlrpc_encode_request(
'PasUserWachtwoordAan',
array(
'hccLogin' => $username,
'userpassword' => $password,
'hobbynetAccount' => $hobbyname,
'nieuw_wachtwoord' => $nieuw_wachtwoord,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!' |
'account $hobbynetAccount behoort niet bij gebruiker $hccLogin' |
'Kan ww van account $hobbynetAccount niet aanpassen');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.11 Pas het pseudoniem van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasPseudoniemAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccPseudoniem' => $hccPseudoniem,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'TRUE',
'Message' => 'Pseudoniem aangepast');
Output negatief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials' | 'Pseudoniem bestaat al');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.12 Controleer of een opgegeven wachtwoord aan de minimum eisen voldoet
$request = xmlrpc_encode_request(
'ValideerWachtwoordEisen',
array(
'userPassword' => $userPassword,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'TRUE',
'Message' => 'Wachtwoord voldoet aan de minimale eisen');
Output negatief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'FALSE',
'Message' => 'Wachtwoord voldoet niet aan de minimale eisen');

// ** H.13 PasWachtwoordAan
// ** Vanuit een Joomla template site kunnen gebruikers hiermee hun eigen wachtwoord aanpassen
// (authenticatie op basis van JoomlaToken, lidnummer, siteID. Extra controle via userpassword)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'userpassword' => $password,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.13.1 PasWachtwoordAan
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee hun eigen wachtwoord resetten
// (authenticatie op basis van PWResetToken en hccLogin).
// (Als de aanroep geslaagd is, dan is daarna het PWResetToken ongeldig)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.14 MaakPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee een wachtwoord reset aanvragen
// Deze aanroep geeft naast het PWResetToken ook het contact emailadres mee terug,
// zodat Joomla een reset-mail kan sturen
// (acties op basis van gebruikersnaam)
$request = xmlrpc_encode_request(
'MaakPWResetToken',
array(
'hccLogin' => $username,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'TRUE',
'PWResetToken' => $PWResetToken,
'mail' => $mail,
'Message' => 'Password reset token aangemaakt');
Output negatief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');

// ** H.15 ValideerPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers een wachtwoord reset aanvragen
// Controleer dat het hier om een bestaand (en nog niet gebruikt) token gaat
$request = xmlrpc_encode_request(
'ValideerPWResetToken',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'TRUE',
'Message' => 'Password reset token gevonden');
Output negatief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'FALSE',
'Message' => 'hccLogin bestaat niet' | 'PWResetToken bestaat niet');

// H.16 Ruim een bestaand JoomlaToken op
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'RuimJoomlaTokenOp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'SiteID' => $siteID,
['ServerID' => gethostname(),]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'TRUE',
'Message' => 'JoomlaToken opgeruimd');
Output negatief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'FALSE',
'Message' => 'Onjuist JoomlaToken');

// ** Joomla module
// ** H.17 GeefAantalDomeinen
// ** Vraag het aantal domeinen op van een betalende Hobbynet gebruiker (t.b.v. IDEAL betaling)
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'GeefAantalDomeinen',
array(
'JoomlaToken' => $JoomlaToken,
'hccLidnr' => $hccLidnr,
'hobbynetAccount' => $hobbyname,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'TRUE',
'hobbynetAccount' => $hobbyname,
'AantalDomeinen' => $aantalDomeinen,
'Message' => 'aantal domeinen opgevraagd');
Output negatief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'account $hobbynetAccount behoort niet bij deze gebruiker');

// ** Joomla module
// ** H.18 ResetHCCCode
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'beheerLogin' => $beheerLogin, // geheime credentials van de site
'beheerPassword' => $beheerPassword, // geheime credentials van de site
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** Joomla module
// ** H.18.1 ResetHCCCode (hcc kantoor aanroep)
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'JoomlaToken' => $JoomlaToken, // Het Joomla token van de sessie van de kantoor medewerker
'hccLidnr' => $hccLidnr, // Het lidnummer van de kantoor medewerker
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** t.b.v. aanpassen van de hccLogin van een gebruiker (Hobbynet functie op Joomla site) **
// H.19 Pas de hccLogin van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// hccLidnummer is het lidnummer waar de mutatie op moet worden uitgevoerd
// Kan alleen als de aanvrager HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasHccLoginAan',
array(
'hccLidnr' => $hccLidnr, // lidnummer van de aanvrager
'JoomlaToken' => $JoomlaToken, // JoomlaToken van de aanvrager
'hccLidnummer' => $hccLidnummer, // pas de hccLogin van dit lidnummer aan
'hccLogin' => $hccLogin, // dit is de gewenste nieuwe hccLogin
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'TRUE',
'Message' => 'hccLogin aangepast');
Output negatief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' |
'Onjuiste credentials' |
'Gebruikersnaam al in gebruik');

// ** t.b.v. het aanmaken van een testaccount door een webmaster
// H.20 Maak een testaccount aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// Kan alleen als de aanvrager WM als rol heeft
$request = xmlrpc_encode_request(
'MaakTestLogin',
array(
'JoomlaToken' => $JoomlaToken, // JoomlaToken van de aanvrager
'hccLidnummer' => $hccLidnummer, // lidnummer van de aanvrager
'hccRol' => $hccRol, // (mag leeg zijn)
'hccGroepering' => $hccGroepering, // (regio of IG)
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
reply = array(
'Action' => 'MaakTestLogin',
'Status' => 'TRUE',
'Message' => 'Tijdelijk test account aangemaakt',
'TestAccountNaam' => 'test-<groepering>-<hccLogin>'
'userpassword' => $nieuw_userpassword,
'hccGroepering' => $hccGroepering,
'hccRol' => $hccRol);
Output negatief:
$reply = array(
'Action' => 'MaakTestLogin',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Gegevenscombinatie onjuist');

// 3.1 Geef mijn lidnummer
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'GeefMijnLidnummer',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'TRUE',
'Message' => 'Lidnummer opgevraagd',
'hccLidnr' => $hccLidnr);
Output negatief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.2 Controleer of de gebruikersnaam op dit moment bestaat
// (geen authenticatie)
// ** Deze gegevens worden opgevraagd bij hccnet.nl (action=3) **
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezeNaamNogBeschikbaar',
array(
'nieuw_hccLogin' => $nieuw_hccLogin,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Gebruikersnaam is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Gebruikersnaam bestaat al');

// ** Enkel voor gebruik vanaf de kantoor portal **
// ** t.b.v. het hernoemen van accounts in CRM **
// 8.3 Controleer of een Pseudoniem op dit moment bestaat ??? NIET GEBRUIKT ??
// (geen authenticatie)
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezePseudoniemNogBeschikbaar',
array(
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem));
Output positief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Pseudoniem is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Pseudoniem bestaat al');

// ** t.b.v. de verenigingszaken zoekpagina **
// A.1 Zoek alle bij de query passende hcc leden
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
$request = xmlrpc_encode_request(
'ZoekHCCLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Groepering' => $Groepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (eerste deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| emailadres | (eerste deel van) e-mail adres |
| gebruikersnaam | (eerste deel van) de login naam |
| pseudoniem | (eerste deel van) het pseudoniem |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| niet_leden | het volledige niet-lid lidnummer |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'ZoekMethode' => $ZoekMethode,
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' => array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'sn' => $sn,
'givenName' => $givenName,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccHuisToevoeging' => $hcchuisToevoeging,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'ProfielBekend' => 'TRUE' | 'FALSE'])*);
Output negatief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. beheer.hcc.nl **
// A.3 Zoek alle bij de query passende hcc leden van deze groepering
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'ZoekGroeperingsLid',
array(
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Groepering' => $groepering,
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Bijeenkomst' => $Bijeenkomst,] // Alleen voor gebruik op de
// bijeenkomsten aanwezigheidsregistratie pagina
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| nieuwe_leden | YYYYMMDD vanaf waar gezocht moet worden |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| kaderleden | n.v.t. |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' =>
[array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'cn' => $cn,
'sn' => $sn,
'givenName' => $givenName,
'hccAchternaam' => $hccAchternaam,
'hccTussenVoegsels => hccTussenVoegsels,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem)]*));
Output negatief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker(s) niet gevonden' | 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten **
// A.4 Lid bezoekt bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'LidBezoektBijeenkomst',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
'hccLidnr' => $hccLidnr, // lid dat aanwezig gemeld moet worden
['correctie' => $hccLidnr,] // lid dat gecorrigeerd moet worden
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'TRUE',
'Message' => 'Bezoeker weggeschreven',
'Results' => array(
// info van deze bezoeker
'cn' => $cn, // cn (Verbeek, H.J.)
'hccGeslacht' => $hccGeslacht, // hccGeslacht van de bezoeker
'groeperingslid' => $groeperingslid, // TRUE of FALSE: is deze persoon lid van deze groepering
'mijnGroeperingen' => $mijnGroeperingen, // komma-gescheiden lijst (regio, [hccIG]*)
'aantalBezoeken' => $aantalBezoeken, // hoe vaak heeft dit lid deze bijeenkomst bezocht
// info van de bijeenkomst
'AantalBezoekers' => $AantalBezoekers); // aantal bezoekers van deze bijeenkomst
Output negatief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.5 Vraag Lidgegevens token aan (geldig voor dit lid, en deze groepering, op deze datum)
// Als geen datum gegeven is, dan is het token vandaag geldig
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'VraagLidgegevensTokenAan',
array(
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'hccLidnr' => $hccLidnummer, // vraag het token voor dit lid aan
'groepering' => $groepering, // zoek binnen deze groepering
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'TRUE',
'Message' => 'Token opgevraagd',
'groepering' => $Groepering,
'token' => $token,
'sn' => $sn);
Output negatief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.6 Toon bezoekersoverzicht
// (authenticatie op basis van lidnummer en bezoekersregistratie token)
$request = xmlrpc_encode_request(
'GeefBezoekersOverzicht',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'token' => $token,
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'TRUE',
'Message' => 'Bezoekersoverzicht opgevraagd',
'Bezoekers' => $bezoekers,
['Locatie' => $Locatie]);
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// A.7 Geef het array met alle locaties
// (of beperk dit tot de locaties van de groepering $Groepering)
// Desgewenst worden alle resultaten waarbij hccToonInJoomla aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// Desgewenst worden alle resultaten waarbij ToonOpKaderNet aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocaties',
array(
['Groepering' => $hccGroepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']);
Output positief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);
Output negatief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'FALSE',
'Message' => 'Locaties niet beschikbaar',
'ExtraInfo' => 'Geen locaties gevonden voor groepering $hccGroepering',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);

// A.8 Registreer een niet-hcclid als bezoeker tijdens een bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'RegistreerGast',
array(
'AccountNaam' => $lidnr, // credentials
'AccountCode' => $AccountCode, // credentials
'token' => $token, // credentials
'Bijeenkomst' => $groepering,
'geslacht' => $geslacht,
'naam' => $naam,
'mail' => $mail,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'buitenland' => $buitenland,
['nietLidNummer' => $nietLidNummer,]
['instructies' => $instructies,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $aanroep,
'Status' => 'TRUE',
'Message' => 'Niet-lid als bezoeker geregistreerd',
'Result' => $result_array);

// A.9 Geef het array met alle locatienamen
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocatieNamen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']));
['KaderMutatieFilter' => '' | 'TRUE']));

Output positief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));
Output negatief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'FALSE',
'Message' => 'Locatienamen niet beschikbaar',
'ExtraInfo' => 'Geen locatienamen gevonden',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));

// A.10 Schrijf een niet-lid in op een bulletin
// (2019.12.05: wordt actief gebruikt in Joomla module)
// Deze aanroep mag *ook* worden gebruikt om een wel-lid in te schrijven.
// Voorwaarde is dat bewezen is dat er controle bestaat over het opgegeven email adres
$request = xmlrpc_encode_request(
'SchrijfNietlidInOpBulletin',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'hccOptin' => $hccOptin, // bulletin waarop ingeschreven wordt
'hccOptinSource' => $hccOptinSource, // site waar aanmelding vandaan komt
'Email' => $Email, // niet-lid: email adres
'Naam' => $Naam, // niet-lid: naam
['hccLidNummer' => $hccLidNummer,] // optioneel: ik ben lid, dit is mijn lidnummer
['Postcode' => $Postcode,] // optioneel: niet-lid: postcode
['Huisnummer' => $Huisnummer,] // optioneel: niet-lid: huisnummer
['hccGeslacht' => $hccGeslacht,] // optioneel: niet-lid: geslacht (M/V/O)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'TRUE',
'Message' => 'Inschrijving op bulletin gelukt');
Output negatief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist',
'ExtraInfo' => 'Invalid DN syntax' |
'Invalid credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.11 Toon bezoekers aantallen
// (authenticatie op basis van AccountNaam en AccountCode of token)
//
// ==> Mag weg: laatste aanroep 2018.12.15 <==
//
$request = xmlrpc_encode_request(
'GeefBezoekersAantallen',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'token' => $token,
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersAantallen',
'Status' => 'TRUE',
'Message' => 'BezoekersAantallen opgevraagd',
'Datum' => $datum,
'Bijeenkomst' => $Bijeenkomst,
'Bezoekers' => array(
[HCC!seniorenacademie] => Array(
[Gorinchem] => 15
[Woerden] => 36)
...));
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersAantallen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// ** t.b.v. Joomla module Bas
// A.12 GeefAlleBulletins
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleBulletins',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefAlleBulletins',
'Status' => 'TRUE',
'Message' => 'Bulletins opgevraagd',
'bulletins' => $bulletins);

// ** t.b.v. Joomla module Bas
// A.13 ExpandeerPostcode
// (geen authenticatie)
$request = xmlrpc_encode_request(
'ExpandeerPostcode',
array(
'postcode' => $postcode,
'huisnummer' => $huisnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'ExpandeerPostcode',
'Status' => 'TRUE',
'Message' => 'Postcode opgevraagd',
'detailgegevens' => $detailgegevens);

// ** t.b.v. Joomla module Bas
// A.25 UpdateNAW
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateNAW',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'geslacht' => $geslacht,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'toevoeging' => $toevoeging,
'straat' => $straat,
'woonplaats' => $woonplaats,
'landcode' => $landcode,
'email' => $email,
'voornaam' => $voornaam,
'voorletters' => $voorletters,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateContactGegevens',
'Status' => 'TRUE',
'Message' => 'Contactgegevens bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.18 NormaliseerTelefoon
// (geen authenticatie)
$request = xmlrpc_encode_request(
'NormaliseerTelefoon',
array(
'hccLand' => $hccLand,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'NormaliseerTelefoon',
'Status' => 'TRUE',
'Message' => 'Telefoonnummer genormaliseerd',
'Telefoonnummer' => $Telefoonnummer);

// ** t.b.v. Joomla module Bas
// A.20 UpdateMobiel
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateMobiel',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateMobiel',
'Status' => 'TRUE',
'Message' => 'Mobiel nummer bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.21 HaalIGBedragenOp
// Geef alle IG's waar je zelf lid van kunt worden, inclusief het bijbehorende bedrag
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalIGBedragenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalIGBedragenOp',
'Status' => 'TRUE',
'Message' => 'Interessegroepen en bedragen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.22 HaalTariefGroepenOp
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalTariefGroepenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalTariefGroepenOp',
'Status' => 'TRUE',
'Message' => 'Tariefgroepen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.23 PasInteressegroepAan
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasInteressegroepAan',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
['nieuw' => $IG_lijst_nieuw,]
['weg' => $IG_lijst_weg,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'PasInteressegroepAan',
'Status' => 'TRUE',
'Message' => 'IG keuzen aangepast');

// ** t.b.v. Joomla module Bas
// A.24 GeefSSOUrls
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefSSOUrls',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefSSOUrls',
'Status' => 'TRUE',
'SSO_urls' => $sso_urls,
'Message' => 'Single Sign On URLs opgevraagd');

// ** t.b.v. de verenigingszaken beheer pagina **
// A.26 Verwijder een niet-lid record
$request = xmlrpc_encode_request(
'VerwijderNietLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'hccLidnr' => $hccLidnummer, // het te verwijderen niet-lid nummer
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

Output positief:
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'TRUE',
'Message' => 'Niet-lid record verwijderd',

Output negatief:
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'FALSE',
'Message' => 'Niet-lid record niet gevonden');
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** HenZ **
// ** t.b.v. daily cron job **
// ** t.b.v. dagelijkse opschoon jobs Joomla template sites **
// C.1 Vraag de lijst met uitgeschreven leden op
// Dit kan beperkt worden tot een bepaalde regio of interessegroep
// Daarnaast kan het tijdvak waarin gezocht wordt vrij gekozen worden
// (gesteld dat de LDAP database nog leden uit die periode bevat)
// Antwoord: lijst met (lidnummer, hccLogin, sn,
// datum einde lidmaatschap (formaat:YYYYMMDD))

==> GeefUitgeschrevenLeden <== (oud: GeefOpgezegdeLeden)

$request = xmlrpc_encode_request(
'GeefUitgeschrevenLeden',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccRegio' => $hccRegio, // of leeg
'hccIg' => $hccIg, // of leeg
'datum_vanaf' => $datum_sinds, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: 3 dagen geleden)
'datum_tot' => $datum_tot, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: vandaag)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'TRUE',
'Message' => 'Uitgeschreven leden',
['hccRegio' => $hccRegio,]
['hccIg' => $hccIg,]
['datum_vanaf' => $datum_vanaf,]
['datum_tot' => $datum_tot,]
['Results' => array(
[array(
'hccLogin' => $hccLogin,
'hccLidNummer' => $hccLidnummer,
'sn' => $sn,
'DatumEindeLidmaatschap' => $DatumEindeLidmaatschap)]*);
Output negatief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');
</pre>

=== HCCpartner aanroepen ===
(interface versie 1) 
(oude interface, niet meer gebruiken!)

<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.1 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartner',
array('ControleerHCCLidmaatschap',
array('partnerLogin', $partnerLogin),
array('partnerPassword', $partnerPassword),
array('hccLidnummer', $hcclidnummer),
array('postcode', $postcode)));
Output positief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'TRUE'));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'));
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'),
array('Message', 'Onjuiste credentials'));

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartner',
array(
'OnbekendeAanroep',
array('parameter', $iets)));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'OnbekendeAanroep'),
array('Status', 'FALSE'),
array('Message', 'Opdracht onbekend'));
</pre>

=== HCCpartners aanroepen ===
(interface versie 2)

<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.2 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'ControleerHCCLidmaatschap',
'partnerLogin' => $partnerLogin,
'partnerPassword' => $partnerPassword,
'hccLidnummer' => $hcclidnummer,
'postcode' => $postcode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'TRUE',
['ExtraInfo' => 'groepering=$groepering']); // als de partner beperkt is tot 1 groepering
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE');
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'OnbekendeAanroep',
'parameter' => $iets));
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'OnbekendeAanroep',
'Status' => 'FALSE',
'Message' => 'Opdracht onbekend');
</pre>

=== HCC-kader aanroepen ===

<pre>
// ** beheer.hcc.nl **
// F.2 Controleer of dit een kaderlid is
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'IsKaderLid',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'TRUE',
'Message' => 'Is kaderlid',
'hccLidnr' => $hccLidnr,
'cn' => $cn,
'sn' => $sn,
'hccRol' => $hccRol,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward);
Output negatief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Is geen kaderlid');

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.4 Vraag alle groeperingen op
// Het is mogelijk om een groepering te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// ToonInOverzichtenFilter : attribuut 'hccToonInOverzichten'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// BulletinsFilter : attribuut 'hccBulletins'
// EmailFilter : attribuut 'hccFunctionalEmail'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleGroeperingen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['ToonInOverzichtenFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['BulletinsFilter' => '' | 'TRUE',]
['EmailFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE'));
Output positief:
$reply = array(
'Action' => 'GeefAlleGroeperingen',
'Status' => 'TRUE',
'Message' => 'Lijst met groeperingen opgevraagd',
'Result' => $groeperingen,
['JoomlaFilter' => 'TRUE',]
['ToonInOverzichtenFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']);

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.5 Vraag alle kaderrollen op
// Het is mogelijk om een kaderrol te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleKaderRollen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']));
Output positief:
$reply = array(
'Action' => 'GeefAlleKaderRollen',
'Status' => 'TRUE',
'Message' => 'Lijst met kaderrollen opgevraagd',
'Result' => $kaderrollen,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']);

// ** t.b.v. de kantoor-beheerpagina **
// F.9 Geef de gevevens van de mailbox van dit kaderlid
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
$request = xmlrpc_encode_request(
'GeefKadermailGegevens',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer));
Output positief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'kadermail_omvang' => $Formaat,
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald);
Output negatief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid'));

// ** t.b.v. de Joomla Kadernet module **
// * F.10 MuteerGroeperingSamenstelling
// (authenticatie op basis van lidnummer, JoomlaToken en siteID en als extra hccCode van de aanvrager)
$request = xmlrpc_encode_request(
'MuteerGroeperingSamenstelling',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccCode' => $hccCode,
'groepering' => $groepering,
'hccLidnummer => $hccLidnummer, // lidnummer van het te muteren hcc lid
'hccRol' => $hccRol, // de nieuwe dan wel op te heffen rol
// de rol 'ALLES_WEG' ruimt alle rollen van dit hcc lid voor deze groepering op
'actie' => 'Nieuw' | 'Weg',
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress,]
Output positief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'TRUE',
'Message' => 'Groepering samenstelling aangepast',
['ExtraInfo' => 'Bedankmail gestuuurd aan ex-kaderlid']);
Output negatief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid' |
'Oude rol niet gevonden' |
'Nieuwe rol kan niet samen met bestaande rol' |
'Alleen voorzitter of secretaris kan kadermutaties uitvoeren']);
</pre>

=== HCC-groepering aanroepen ===

<pre>

// I.2 controleer of een gebruiker bestaat op basis van de combinatie
// lidnummer + postcode + huisnummer
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
// (alternatieve authenticatie mogelijk door lidnummer + hcc-code in te vullen)
//
// Aan de aanroeper worden zekere eisen gesteld:
// * dient een rol te vervullen binnen de groepering 'FOR'(forum)
// * dan wel dient de rol 'VRBK' (vraagbaak) te vervullen binnen een groepering
//
// Er wordt door de gehele leden-database gezocht, waarna terug wordt gegeven
// * of dit hcc lid inderdaad bestaat
// en, als het om een aanvraag van een vraagbaak vrijwilliger gaat,
// * tevens of het gezochte hcc lid deel uitmaakt van zijn groepering
//
// ==> Mag weg: laatste aanroep 2018.07.27 <==
//
$request = xmlrpc_encode_request(
'IsHCCLid',
array(
'hccLogin' => [$hccLogin | $hccLidnummer],
'userPassword' => [$userPassword | $hccCode],
'zoekhccLidnr' => $zoekhccLidnr,
'zoekhccPostcode' => $zoekhccPostcode,
'zoekhccHuisnr' => $zoekhccHuisnr,
'zoekgroepering' => $zoekgroepering));
Output positief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gecontroleerd',
['Groeperingslid' => $IsGroeperingLid]));
Output negatief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker bestaat niet' |
'Onjuiste credentials' |
'Wel HCC lid, maar geen lid van groepering $groepering' |
'Onvoldoende rechten' |
'Vul alle verplichte velden in!'));
</pre>

=== HenZ aanroepen ===

<pre>

// I.3 Geef de einddatum van een actief dan wel uitgeschreven lid
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'GeefhccEindDatum',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'TRUE',
'hccLidnummer' => $hccLidnummer,
'hccLogin' => $hccLogin,
'hccEindDatum' => $hccEindDatum ('yyyymmdd' | ''));
Output negatief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Invalid credentials' |
'Lidnummer niet gevonden');
</pre>

=== (Forum,vraagbaak) onderwerpen ===

<pre>
// L.1 MaakOnderwerp
$request = xmlrpc_encode_request(
'MaakOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'description' => $description,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp is aangemaakt',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster');

// L.2 VerwijderOnderwerp

$request = xmlrpc_encode_request(
'VerwijderOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'TRUE',
'onderwerp' => $onderwerpID,
'Message' => 'Onderwerp is verwijderd',
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Ruim eerst alle geautoriseerde gebruikers op' |
'Kan onderwerp niet verwijderen');

// L.3 GeefOnderwerpen
// Geef het array met de lijst van onderwerpen voor de betreffende groepering
//
$request = xmlrpc_encode_request(
'GeefOnderwerpen',
array(
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'TRUE',
'Message' => 'Onderwerpen opgevraagd',
'onderwerpen' => $onderwerpen); // het array met onderwerpen
Output negatief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!');

// L.4 MuteerOnderwerp
// Pas de description van een onderwerp aan
//
$request = xmlrpc_encode_request(
'MuteerOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'description' => $description,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp aangepast',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Onderwerp behoort bij andere groepering');

// L.5 MuteerOnderwerpAutorisatie
// Geef kaderlid $kaderLidNr de autorisatie MOD, VRBK of RED bij onderwerp $onderwerp
// (of haal die autorisatie weg)
$request = xmlrpc_encode_request(
'MuteerOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'onderwerp' => $onderwerpID,
'kaderLidNr' => $kaderLidNr,
'hccAutorisatie' => 'MOD' | 'VRBK' | 'RED',
['verwijder' => 'TRUE']));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Onderwerp autorisatie aangepast');
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Geen kaderlid' |
'Onjuiste autorisatie opgegeven' |
'Onderwerp bestaat niet');

// L.6 ToonOnderwerpAutorisatie
$request = xmlrpc_encode_request(
'ToonOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Autorisaties opgehaald',
'onderwerp' => $onderwerpID,
'description' => $description,
'autorisaties' =>
[Array(
'hccLidnummer' => $hccLidnummer
'cn' => $cn
'hccAutorisatie' => {komma-gescheiden autorisaties})]);
Output negatief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet');
</pre>

=== Microsoft Dynamics Cloud (Cayentis) onderwerpen ===

<pre>
// M.1 Upload_CSV_bestand
// De CRM proxy upload de dagelijkse CSV synchronisatie-bestanden naar de XML-RPC server
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Upload_CSV_bestand',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'CSV_bestand_type' => '1' | '2' | '3' , // 1=Contactpersonen/Hoofdlidmaatschappen
// 2=Gremiumlidmaatschap codes
// 3=Gremiumlidmaatschappen
'CSV_bestand' => $CSV_bestand)); // het CSV bestand (base64 encoded)
Output positief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'TRUE',
'Message' => 'Bestand opgeslagen');
Output negatief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.2 SchrijfNieuwLidIn
//
// Maak in het CRM een nieuw HCC lid aan
// De NAW gegevens worden in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'SchrijfNieuwLidIn',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'NAWgegevens' => $NAW_Array,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress);
// $NAW_array = array(
// 'GeboorteDatum' => $geboortedatum,
// 'Geslacht' => $geslacht,
// 'Voornaam' => $voornaam,
// 'Voorletters' => $voorletters,
// 'Tussenvoegsel' => $tussenvoegsel,
// 'Achternaam' => $achternaam,
// 'Straatnaam' => $straatnaam,
// 'Huisnummer' => $huisnummer,
// 'HuisnummerToevoeging' => $huisnummertoevoeging,
// 'Woonplaats' => $woonplaats,
// 'Postcode' => $postcode,
// 'Land' => $land,
// 'Telefoonnummer' => $telefoonnummer,
// 'MobielNummer' => $mobielnummer,
// 'Mail' => $mail,
// 'IBAN' => $IBAN,
// 'Interessegroep' => $IGs, // komma-gescheiden lijst met IG's
// 'Geschenk' => $geschenk,
// 'Actiecode' => $actiecode,
// 'Voorwaarden' => $Akkoord); // 'Akkoord'
)
Output positief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'TRUE',
'Message' => 'nieuw lid ingeschreven',
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode);
Output negatief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.3 Verwerk_JSON_mutatie
// De CRM proxy kan NAW en/of IG mutaties en/of hccCode mutaties live doorgeven
// Deze gegevens worden in JSON in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Verwerk_JSON_mutatie',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'mutatie_type' => '1' | '2', // 1=Contactpersoon/Hoofdlidmaatschap
// 2=Gremiumlidmaatschap
'JSON_mutatie' => $JSON_mutatie)); // de JSON payload
Output positief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'TRUE',
'Message' => 'Mutatie verwerkt');
Output negatief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.4 Vertaal landcode
// Het CRM werkt met numerieke landcodes, wij met cijfers
// Vertaal die
// Er moet in de aanroep 1 veld aanwezig zijn, beide waarden komen in het antwoord terug
$request = xmlrpc_encode_request(
'ISO_landcode',
array(
['ISO_numeriek' => $ISO_numeriek,]
['ISO_code ' => $ISO_code]));
Output positief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'TRUE',
'Message' => 'ISO code lookup geslaagd',
'ISO_numeriek' => $ISO_numeriek,
'ISO_code ' => $ISO_code,
'ISO_benaming' => $ISO_benaming); // de descriptive name van deze ISO code
Output negatief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'FALSE',
'Message' => 'Kan geen bijpassende vertaling vinden'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');
</pre>
// M.5 MuteerAanmeldingsformulier
// Sla een JSON veld op in de XML-RPC server zodat deze weer opgehaald kan worden door de websites
// Authenticatie op basis van hccLidnummer en JoomlaToken
// Deze mutaties mogen alleen door HN#WM of SITE#WM gedaan worden.

$request = xmlrpc_encode_request(
MuteerAanmeldingsformulier,
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
'formulierdata' => $formulierdata, // JSON veld met alle gegevens voor het aanmeld formulier
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress ));
Output positief:
$reply = array(
'Action' => 'MuteerAanmeldingsformulier',
'Status' => 'TRUE',
'Message' => 'aanmeldingsformulier bijgewerkt';

// M.6 HaalAanmeldingsformulier
// (geen authenticatie)
$request = xmlrpc_encode_request(
HaalAanmeldingsformulier,
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalAanmeldingsformulier',
'Status' => 'TRUE',
'formulierdata' => $formulierdata); // JSON veld met alle gegevens voor het aanmeld formulier
</pre>

// M.7 GeefFactuurOverzicht
// (authenticatie op basis van hccLidnummer + JoomlaToken + siteID
$request = xmlrpc_encode_request(
GeefFactuurOverzicht,
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefFactuurOverzicht',
'Status' => 'TRUE',
'FactuurOverzicht' => $FactuurOverzicht);
// $FactuurOverzicht =
// array(
// array(
// 'FactuurID' => 'a5b93460-4536-ea11-a813-000d3a2c53fa',
// 'FactuurNummer' => '200118673J5'
// 'FactuurDatum' => '2020-01-15'
// 'bedrag' => 42.37
// 'BetaalStatus' => 0]));
// )

// M.8 HaalFactuur
// (authenticatie op basis van JoomlaToken of FactuurToken)
$request = xmlrpc_encode_request(
HaalFactuur,
array(
'hccLidnummer' => $hccLidnummer,
['JoomlaToken' => $JoomlaToken,]
['FactuurToken' => $FactuurToken,]
'FactuurNummer' => $FactuurNummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalFactuur',
'Status' => 'TRUE',
'factuur' => $factuurgegevens);
// $factuurgegevens =
// array(
// 'FactuurNummer' => $FactuurNummer,
// 'FactuurDatum' => $FactuurDatum,
// 'FactuurID' => $FactuurID,
// 'Bestandsnaam' => $Bestandsnaam,
// 'PDF' => $PDF) // base64 encoded PDF
</pre>

=== Echo test ===

<pre>

// t.b.v. controle of de verbinding met de XML-RPC server functioneert
// Eenvoudige echo test

$request = xmlrpc_encode_request(
'echo',
array(
'What' => $string,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'echo',
'Status' => 'TRUE',
'Message' => $string);
</pre>

=== HenZ XML-RPC interface ===

Overzicht van XML-RPC procedures die bij HenZ draaien
(worden via de Hobbynet XML-RPC server afgehandeld)

<pre>
- Action=2
wijzig gebruikersnaam en wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=3
controleer of een gebruikersnaam bestaat
(XML-RPC server voert de hccnet XML-call uit, zie 8.2)

- Action=4
creer een nieuwe gebruiker. Per lidnummer is er 1 account. Als er al een
account voor dit lidnummer bestaat wordt het bestaande account hernoemd.
(XML-RPC server voert de hccnet XML-call uit, zie 8.1)

- Action=5
wijzig wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=7
Uitgeschreven lid is weer actief lid geworden
(Wordt aangeroepen vanuit de cronjob)

- Action=8
Lid heeft een nieuwe hcc-code gekregen
(Wordt aangeroepen vanuit de cronjob)
</pre>

=== Release notes ===
<pre>
2012.02.08 Wijzigingen versie 5:
- 4.1 verwijder_hcc_Lidnummer i.p.v. hcc_Lidnummer
- 4.1 optionele extra parameter verwijder_hccLogin
- Optionele parameters aangegeven
- Vanwege de duidelijkheid de beheerLogin en beheerPassword velden
bovenin de betreffende aanroepen gezet
(De volgorde van de parameters is niet relevant, dus dit is geen
interface-aanpassing)
2012.02.16 Wijzigingen versie 6:
- 2.1/2.2/2.3 geef ook cn en sn terug na aanpassen van het wachtwoord
- 3.1 geef cn en sn terug na aanmaken nieuwe gebruiker
2012.02.27 Wijzigingen versie 7:
- Neem de XML-RPC interface van HenZ in deze XML-RPC server op
8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gegevens tevens in LDAP op
- 2.1 wijzig wachtwoord - optie 1
* Nieuw wachtwoord is verplicht, niet optioneel
* wijzigingen worden naar hccnet.nl doorgezet
- 2.2 wijzig wachtwoord, optie 2
* Nieuw wachtwoord is verplicht, niet optioneel
* gebruikersnaam kan niet meer via deze interface aangepast worden
* wijzigingen worden naar hccnet.nl doorgezet
- 2.3 wijzig wachtwoord, optie 3
* wijzigingen worden naar hccnet.nl doorgezet
2012.03.26 Wijzigingen versie 8:
- Breidt de XML-RPC interface van HenZ in deze XML-RPC server uit met
8.2 Controleer of de gebruikersnaam op dit moment bestaat
2012.04.09 Wijzigingen versie 9:
- Vervang alle 'ldap' aanroepen door 'HCCldap' aanroepen
- documentatie van HenZ call action=2 aangepast, action=5 toegevoegd
2012.05.03 Wijzigingen versie 10:
- 1.1 / 1.2 / 1.3 geven nu ook 'ProfielBekend' terug om uniek te bepalen
of deze bezoeker een first-time-login pagina te zien dient te krijgen
- documentatie van 2.1 (wijzig wachtwoord) aangepast:
2.1 kan alleen als profiel is doorlopen
- nieuwe procedure t.b.v. zoekscherm PC30
* A.1 ZoekHCCLid
- hiervoor is de database met diverse velden uitgebreid
(postcode, e-mailadres, huisadres, woonplaats, land, telefoonnummer)
Dit heeft impact op diverse andere procedures (t.b.s.)
- nieuwe procedure t.b.v. 'gewone' profielpagina
* B.1 GeefDBFPersoonID
- nieuwe procedure t.b.v. cron-job
* C.1 GeefOpgezegdeLeden
2012.05.10 Wijzigingen versie 11
- 1.3 GebruikerBestaatControle
* nieuwe parameter: hccPseudoniem
* nieuw veld in antwoord: hccPseudoniem
- 2.3 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 2.4 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 3.1 NieuweGebruiker
* nieuwe parameter: hccPseudoniem
- 8.1 MaakGebruikerAan
* nieuwe parameter: nieuw_hccPseudoniem
* alle parameters zijn verplicht (niet langer optioneel)
* nieuw antwoord: Gegevenscombinatie onjuist
- 8.3 IsDezePseudoniemNogBeschikbaar
* Nieuwe procedure t.b.v. 1e keer doorlopen profielpagina
- A.1 ZoekHCCLid
* 'Zoeklimiet bereikt' wordt als ExtraInfo meegegeven
* nieuwe velden in antwoord: hccPseudoniem en hccLogin
- B.1 GeefDBFPersoonID
* Zoeken kan nu ook op hccLogin en op hccPseudoniem
- C.1 GeefOpgezegdeLeden
* Geef nu ook hccLogin en hccPseudoniem terug
2012.05.14 Wijzigingen versie 12
- 1.x GebruikerBestaatControle
* Geef ook DBFPersoonID terug
- 4.1 Gooi een gebruiker weg.
* Haal ongebruikte parameter hccLogin weg
- 5.1 Wijzig hccIG
* Haal ongebruikte parameter hccLogin weg
- 6.1 Wijzig hccRegio
* Haal ongebruikte parameter hccLogin weg
- 7.1 Wijzig hccRol
* Haal ongebruikte parameter hccLogin weg
2012.05.20 Wijzigingen versie 13
- A.1 ZoekHCCLid
* Geef resultaten gestructureerder formaat
* Geef in ExtraInfo weer hoeveel echte resultaten er gevonden zijn
- C.1 GeefOpgezegdeLeden
* Geef resultaten in gestructureerder formaat
2012.06.03 Wijzigingen versie 14
- 3.1 NieuweGebruiker
* Geef ook DBFPersoonID mee
2012.08.17 Wijzigingen versie 15
- C.1 GeefOpgezegdeLeden
* Geef ook hccLogin in het antwoord terug
- D.1 HCCpartner/ControleerHCCLidmaatschap
* Nieuwe aanroep
2012.09.29 Wijzigingen versie 16
- Alle cron gerelateerde opdrachten verwijderd
* 3.1 NieuweGebruiker
* 4.1 GooiGebruikerWeg
* 5.1 WijzigHccIG
* 6.1 WijzigHccRegio
* 7.1 WijzigHccRol
2012.10.28 Wijzigingen versie 17
- nieuwe procedure t.b.v. PC30 beheerpagina
* A.2 HaalPC30Token
- nieuwe procedure t.b.v. Drupal profielpagina
* 2.4 vervallen
(WijzigGebruikersGegevens op basis van pseudoniem)
* 2.5 WijzigGebruikersGegevens
Nieuwe keuze: wijzig pseudoniem
2012.11.14 Wijzigingen versie 18
- 1.x GebruikerBestaatControle
* Geef ook mail in het antwoord terug
2012.11.30 Wijzigingen versie 19
- E.1 HCCkader/WijzigGebruikersGegevens
* Nieuwe aanroep
- F.1 / F.2 / F.3 ControleerKaderlid
* Nieuwe aanroep
2012.12.18 Wijzigingen versie 20
- Haal DBFPersoonID weg uit alle aanroepen en alle resultaten
* Antwoord van 1.x GebruikerBestaatControle
* B.1 GeefDBFPersoonID opgeheven
- A.1 ZoekHCCLid geeft nu ook hccMobiel terug (t.b.v. PC30 zoekpagina)
- C.1 GeefOpgezegdeLeden verder uitgewerkt:
* Geeft alleen de door Drupal gebruikte velden 'hccLogin' en 'hccEindDatum'
terug in het antwoord
* Geeft nu 'echte' antwoorden i.p.v. dummy resultaten
- F.1 ControleerKaderlid geeft nu ook optioneel 'sn' en 'givenName'
terug (in de beheer-variant)
2013.01.25 Wijzigingen versie 21
- A.1 ZoekHCCLid uitgebreid
* Geeft nu ook hccBeginDatum, hccEindDatum en hccRol terug
2013.02.02 Wijzigingen versie 22
- A.1 ZoekHCCLid
* Interface aangepast
- A.3 ZoekGroeperingsLid
* Nieuwe aanroep
- F.4 GeefAlleGroeperingen
* Nieuwe aanroep
- F.5 GeefAlleKaderRollen
* Nieuwe aanroep
2013.03.01 Wijzigingen versie 23
- A.3 ZoekGroeperingsLid
* Geeft andere resultaten terug
- 2.2 WijzigWachtwoord
* Geeft nu ook hccLogin terug (voor ww-vergeten op de Drupal site)
- HCCenquete implementatie
* G.1 Expandeer NL postcode
* G.2 Haal lidgegevens op
* G.3 Pas lidgegevens aan
2013.03.18 Wijzigingen versie 24
- ZoekGroeperingsLid op basis van token
- A.4 Lid bezoekt bijeenkomst
* nieuwe aanroep
- A.5 VraagLidgegevensTokenAan
* nieuwe aanroep
2013.04.07 Wijzigingen versie 25
- D.1 HCCpartner/ControleerHCCLidmaatschap
Simpeler interface ontwikkeld ('HCCpartners' i.p.v. 'HCCpartner')
- G.3 mag ook Tussenvoegsels aanpassen
2013.04.25 Wijzigingen versie 26
- H.1 HCC-groepering / GebruikerBestaatControle
Nieuwe interface voor validatie vanaf groeperings websites
2013.05.03 Wijzigingen versie 27
- 2.6 HaalOptInKeuzen
* nieuwe aanroep
- 2.7 SchrijfOptInKeuzen
* nieuwe aanroep
- 2.8 HaalOptInLijst
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* nieuwe aanroep
- HCCpartners aanroep nieuwe interface ('Action' => 'ControleerHCCLidmaatschap')
2013.07.05 Wijzigingen versie 28
- 8.1 MaakGebruikerAan
* extra parameters (mail, hccPseudoniem) in het antwoord
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra parameter (mailHccnet)
- A.1 ZoekHCCLid
* extra parameter (mailHccnet)
- A.3 ZoekGroeperingsLid
* extra parameter (mailHccnet)
2013.08.31 Wijzigingen versie 29
- F.1 / F.2 / F.3 HCC-kader / ControleerKaderlid
* extra output parameter (hccKaderMail)
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra output parameter (hccForumLogin)
- H.1 HCC-groepering / GebruikerBestaatControle
* komma-gescheiden lijst met groeperingen mogelijk
* extra output parameter (mailHccnet)
2013.12.26 Wijzigingen versie 30
- 3.1 Geef mijn lidnummer
* nieuwe aanroep
- A.1 ZoekHCCLid
* geef nu ook 'ProfielBekend' terug om aan de PC30 omgeving door te geven
dat het wachtwoord niet veranderd mag worden door PC30
- A.6 GeefBezoekersOverzicht
* geef nu ook 'Locatie' terug indien van toepassing
- A.7 GeefLocaties
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* parameters aangepast
* authenticatie op basis van hccLogin + userPassword of lidnummer + hcc-code
* geen algemene hcc-forum authenticatie meer mogelijk
- F.7 ControleerKaderlidGroep
* Nieuwe aanroep
2014.02.01 Wijzigingen versie 31
- A.8 RegistreerGast
* nieuwe aanroep
- H.2 MatchPostcodeMetRegio
* nieuwe aanroep
- nieuwe interface (losse, unieke aanroepen, niet meer gegroepeerd)
2014.09.27 Wijzigingen versie 32
- C.1 GeefOpgezegdeLeden hernoemd naar GeefUitgeschrevenLeden
- I.3 GeefhccEindDatum
* nieuwe aanroep
- Action=7 en Action=8 toegevoegd aan de HenZ interface
2014.12.12 Wijzigingen versie 33
- F.1 / F.2 / F.3 HCC-kader / IsKaderLid
* extra output parameter (mail, mailHccnet, hccKaderForward)
- F.8 HCC-kader / ZetKaderForward
* nieuwe aanroep
2015.05.06 Wijzigingen versie 34
- GeefMijnGegevens
* nieuwe aanroep
- ValideerPCActiveAbonnee
* vervallen
- 1.4 GebruikerBestaatControle
* extra output parameter (hccKaderForward)
- D.1 HCCpartner/ControleerHCCLidmaatschap
* optionele extra output parameter (ExtraInfo)
2015.09.27 Wijzigingen versie 35
- HeeftForumCredentials
* vervallen
2015.11.20 Wijzigingen versie 36
- SchrijfNietlidInOpBulletin
* nieuwe aanroep
2015.12.13 Wijzigingen versie 37
- serverID als optionele parameter
- SchrijfNietlidInOpBulletin
* Maak velden optioneel
2016.01.05 Wijzigingen versie 38
- A.7 GeefLocaties
* optionele parameter JoomlaFilter
- F.4 GeefAlleGroeperingen
* optionele parameter JoomlaFilter
- F.5 GeefAlleKaderRollen
* optionele parameter JoomlaFilter
2016.01.15 Wijzigingen versie 39
- H.3 GeefMijnGegevens
* geeft nu ook hccOptIn terug
* geeft nu ook JoomlaToken terug
- H.4 PasOptInKeuzeAan
* nieuwe aanroep
- SiteID en RemoteID als optionele parameter
2016.03.17 Wijzigingen versie 40
- H.5 ZoekKaderLeden
* nieuwe aanroep
2016.03.20 Wijzigingen versie 41
- ServerID, SiteID en RemoteID als optionele parameters bij alle aanroepen
- A.7 GeefLocaties
* optionele parameter KadernetFilter
- A.9 GeefLocatieNamen
* optionele parameter KadernetFilter
- F.4 GeefAlleGroeperingen
* optionele parameter KadernetFilter
- F.5 GeefAlleKaderRollen
* optionele parameter KadernetFilter
- F.6 WijzigHccRol
* vervallen
- F.7 IsGroeperingsKaderlid
* vervallen
- 8.3 IsDezePseudoniemNogBeschikbaar
* vervallen
- 2.7 SchrijfOptInKeuzen
* vervallen
- 2.5 WijzigGebruikersGegevens (hccPseudoniem)
* vervallen
- H.2 MatchPostcodeMetRegio
* vervallen
2016.04.02 Wijzigingen versie 42
- H.6 GeefMijnKaderDetails
* nieuwe aanroep
2016.07.03 Wijzigingen versie 43
- Ubuntu 16.04 aanpassingen (PHP versie 7) beschreven
2016.09.01 Wijzigingen versie 44
- H.5 ZoekKaderLeden
* extra parameter 'hccMobiel'
2016.10.13 Wijzigingen versie 45
- H.3 GeefMijnGegevens (dedecated Joomla aanroep)
* hccForumLogin weg als parameter
* Als het om een webmaster gaat, vul dan eventueel hccRegio of hccIG aan
met die groepering, ook als hij geen lid is van die groepering
- I.4 GebruikerBestaatControle
* hccForumLogin weg als parameter
2016.12.01 Wijzigingen versie 46
- 8.3 IsDezePseudoniemNogBeschikbaar teruggezet
2017.05.28 Wijzigingen versie 47
- H.7 GeefMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
- H.8 ZetMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
2017.09.01 Wijzigingen versie 48
- A.10 SchrijfNietlidInOpBulletin nu alleen voor 1 bulletin tegelijk
- 2.2 WijzigGebruikersGegevens (op basis van gebruikersnaam en wachtwoord)
is vervallen (was een oude Drupal aanroep)
- A.3 ZoekGroeperingsLid geeft ook hccKaderToonMobiel terug
- H.7 GeefMinimaleKaderGegevens geeft ook hccKaderToonMobiel terug
2017.11.14 Wijzigingen versie 49
- A.3 ZoekGroeperingsLid geeft geen hccKaderToonMobiel meer terug
- A.3 ZoekGroeperingsLid geeft alleen hccMobiel als hccKaderToonMobiel dat toestaat
2018.02.18 Wijzigingen versie 50
- H.6 GeefMijnKaderDetails geeft ook hccKaderToonMobiel terug
- H.9 PasKaderGegevensAan
* nieuwe aanroep
- H.3 GeefMijnGegevens geeft 3 extra parameters terug (hccKaderMail, hccKaderForward,
hccKaderToonMobiel)
- JoomlaTokens worden gevalideerd op siteID, niet langer op serverID
- diverse aanroepen kunnen nu ook via de bezoekersregistratie-proxy aangeroepen worden.
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
(GeefAlleGroeperingen, GeefAlleKaderRollen, GeefLocaties, GeefLocatieNamen)
De bezoekersregistratie aanroepen hebben enkel JoomlaToken als extra parameter nodig:
(LidBezoektBijeenkomst, GeefBezoekersOverzicht)
2018.02.26 Wijzigingen versie 51
- H.3 GeefMijnGegevens geeft extra parameter hccMobiel terug
- H.9 PasKaderGegevensAan kan nu ook kadermail password aanpassen
- K.1 ValideerToken
* nieuwe aanroep
- K.2 ValideerHCCCode
* nieuwe aanroep
2018.03.17 Wijzigingen versie 52
- H.3 Haal al mijn gegevens
Extra optie 'compact' om alleen essentiele resultaten te verkrijgen
(t.b.v. de Android bezoekersregistratie applicatie)
2018.03.25 Wijzigingen versie 53
- I.2 IsHCCLid
(Oude aanroep teruggezet, wordt nog in vraagbaak module gebruikt)
2018.07.01 Wijzigingen versie 54
* A.1 beheer authenticatie op basis van lidnummer + hccCode (tbv VZ-portal)
* A.2 HaalPC30Token weggehaald
2018.08.22 Wijzigingen versie 55
* 1.2 GebruikerBestaatControle' (op basis van hccLogin en userPassword) weggehaald
* 1.4 GebruikerBestaatControle' (op basis van zoekHccLogin of zoekHccLidnr) weggehaald
* 2.8 HaalOptInLijst weggehaald
* E.1 PasKaderWachtwoordAan weggehaald
* F.1 IsKaderLid (op basis van hccLidnr en hccCode) weggehaald
* F.3 IsKaderLid (op basis van beheerdernaam en beheerderwachtwoord) was al weg
* F.8 ZetKaderForward weggehaald
* H.1 IsGroeperingsLid weggehaald
* H.6 GeefMijnKaderDetails weggehaald
* H.7 GeefMinimaleKaderGegevens weggehaald
* H.8 ZetMinimaleKaderGegevens weggehaald
* K.1 ValideerHCCCode weggehaald
* K.2 ValideerToken weggehaald
* H.3 GeefMijnGegevens geeft omvang kader mailbox mee terug
2018.11.06 Wijzigingen versie 56
Nieuwe aanroepen t.b.v. forum en vraagbaak autorisaties
* L.1 MaakOnderwerp
* L.2 VerwijderOnderwerp
* L.3 GeefOnderwerpen
* L.4 MuteerOnderwerp
* L.5 MuteerOnderwerpAutorisatie
* L.6 ToonOnderwerpAutorisatie
* H.5 ZoekKaderLeden heeft compact optie
2018.11.16 Wijzigingen versie 57
* L.5 MuteerOnderwerpAutorisatie kent nu ook RED(acteur)
2018.12.17 Wijzigingen versie 58
* A.11 GeefBezoekersAantallen (nieuwe aanroep)
* H.10 PasUserWachtwoordAan (nieuwe aanroep)
2019.02.21 Wijzigingen versie 59
* A. 6 GeefBezoekersOverzicht geeft enkel lijst van bezoekers laatste bijeenkomst
2019.10.26 Wijzigingen versie 60
* A.4 Schrijf bezoekers niet meer automatisch in op bulletins
* H.4 PasOptInKeuzeAan kan ook door LA aangeroepen worden
Nieuwe aanroepen t.b.v. eigen implementatie van mijn.hcc.nl in de Joomla modules
* H.11 PasPseudoniemAan
* H.12 ValideerWachtwoordEisen
* H.13 PasWachtwoordAan (1: op JoomlaToken, 2: op PWResetToken)
* H.14 MaakPWResetToken
* H.15 ValideerPWResetToken
* H.16 RuimJoomlaTokenOp
* A.12 GeefAlleBulletins
* A.13 ExpandeerPostcode
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.18 NormaliseerTelefoon
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
* A.21 HaalIGBedragenOp
* A.22 HaalTariefGroepenOp
* A.23 PasInteressegroepAan
* F.10 MuteerGroeperingSamenstelling
* A.24 GeefSSOUrls
Aanpassingen gemaakt aan
8.1 MaakGebruikerAan
F.5 GeefAlleKaderRollen
2020.01.04 Wijzigingen versie 61
Nieuwe aanroepen t.b.v. IDEAL betaling hobbynet abonnees
H.17 GeefAantalDomeinen
2020.01.06 Wijzigingen versie 62
Nieuwe aanroepen t.b.v. Cayentis (CRM webproxy) implementatie
* M.1 Upload_CSV_bestand
* M.2 SchrijfNieuwLidIn
* M.3 Verwerk_JSON_mutatie
* M.4 ISO_landcode
* M.5 MuteerAanmeldingsformulier
* M.6 HaalAanmeldingsformulier
* M.7 GeefFactuurOverzicht
* M.8 HaalFactuur
* A.25 UpdateNAW
Vervallen aanroepen
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
Aangepaste aanroepen
* A.23 PasInteressegroepAan
2020.03.27 Wijzigingen versie 63
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.18 ResetHCCCode
* H.19 PasHccLoginAan
2020.04.10 Wijzigingen versie 64
Nieuwe aanroepen
* A.26 VerwijderNietLid
Aanpassingen gemaakt aan
* A.1 ZoekHCCLid: nieuwe zoekoptie 'niet_leden'
Opnieuw geimplementeerd
* A.20 UpdateMobiel
2020.11.26 Wijzigingen versie 65
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.20 MaakTestLogin
Aanpassingen gemaakt aan
- H.3 GeefMijnGegevens: optionele parameter 'hccGroepering'
</pre>

= Aanpassingen aan de Apache omgeving =

== php.ini aanpassingen ==
De XML-RPC server zal 'ergens' een bestand moeten kunnen vinden met de
gebruikersnamen t.b.v. het authenticeren bij de LDAP-server.

Dit bestand wordt geplaatst in de map '/usr/local/hobbynet/etc'. Om dit
vanuit Apache te mogen benaderen, dient een aanpassing aan php.ini
gemaakt te worden:

/etc/php5/apache2/php.ini

include_path = ".:/usr/share/php:/usr/share/pear:/usr/local/hobbynet/etc"

== Apache modules ==
Nieuwe server geschikt maken voor XML-RPC gebruik

=== Apache modules (PHP 7) ===
Ubuntu 16.04 wordt standaard met PHP versie 7.0 uitgeleverd.
De opdrachten om de modules op te halen zijn:
apt-get install php-xmlrpc
apt-get install apache2
apt-get install ldap-utils
apt-get install php-ldap
apt-get install libapache2-mod-php

== Loadbalancer akties niet naar de logbestanden schrijven ==
De loadbalancer haalt zeer frequent een testbestand op (/test.txt), om
te controleren of de xml-server operationeel is. Dat levert extreem veel
logging op in /var/log/apache2/other_vhosts.log.

Pas de apache configuratie zo aan, dat logging van alle opvragingen
vanaf de loadbalancers uitgezet wordt.
/etc/apache2/sites-enabled/xml-server

# Mark requests from loadbalancers
SetEnvIf Remote_Addr "212\.72\.227\.93" dontlog
SetEnvIf Remote_Addr "212\.72\.227\.94" dontlog
SetEnvIf Remote_Addr "172\.31\.1\.249" dontlog
SetEnvIf Remote_Addr "172\.31\.1\.250" dontlog
CustomLog ${APACHE_LOG_DIR}/access.log common env=!dontlog

= Firewall algemeen =
In de file /etc/hobby-firewall/hobby-firewall.local wordt het script
'/usr/local/hobbynet/bin/gen_fw.sh' aangeroepen.
Deze haalt de IP adressen op uit ldap.
(.local omdat we dit ook zo doen op de webservers).

De firewall wordt 4 x per dag herstart en /etc/hobby-firewall wordt
gesynchroniseerd (1-richting van lb1 naar lb2) met de volgende crontab
entries:

Op lb1:
0 0 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 5 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 11 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 17 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 23 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null

Op lb2:
15 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 0 * * * /etc/init.d/hobby-firewall restart >/dev/null

Het encrypted backup script is verplaatst naar '/usr/local/hobbynet/local' en hernoemd naar 'backup-encrypted.bash'.
Dit is omdat deze niet mee mag worden gesynchroniseerd.

Tevens wordt 1x per dag /usr/local/hobbynet/bin gesynchroniseerd (1-richting van hcc-ldap-lb1 naar hcc-ldap-lb2)

== Aanpassingen in de firewall ==
Op de server waar de XML-RPC server staat, moeten enkele firewall aanpassingen gemaakt worden.
* inkomend: sta TCP 443 toe vanaf het interne netwerk (www-prod, www-test), en vanaf eventuele andere plekken die we expliciet toe willen staan.
* inkomend: sta TCP 443 toe vanaf mijn.hcc.nl (XML-RPC aanroepen vanaf de portal)
* inkomend: sta TCP 443 toe vanaf service.hccnet.nl toe (XML-RPC aanroep GeefUitgeschrevenLeden vanuit HenZ)
* uitgaand: sta TCP 443 naar service.hccnet.nl toe (XML-RPC aanroepen naar HenZ)
* uitgaand: sta TCP 990 en 5000-6000 naar Apps.HCC.local (FTPS verkeer naar de HCC server bij Hobbynet)

== Aanpassingen aan AppArmor ==
Alhoewel technisch gezien dit bij slapd behoort, neem ik het toch hier op.

Als het Hobbynet certificaat in de map /disk/site/etc/ssl/hobby.nl/ wordt neergezet, dan zal apparrmor de toegang tot de certificaten blokkeren. Neem daarom in de '''local''' directory van apparmor het volgende op:
# /etc/apparmor.d/local/usr.sbin.slapd
# Site-specific additions and overrides for usr.sbin.slapd.
# For more details, please see /etc/apparmor.d/local/README.
#include <abstractions/ssl_certs>
/disk/site/etc/ssl/hobby.nl/ r,
/disk/site/etc/ssl/hobby.nl/* r,

MySQL cluster

2020-11-22T16:34:46Z

Hans:

=doel=
Om te zorgen dat onze database server ook volledig redundant is hebben we hier een cluster gemaakt, onze loadbalancer zorgt er voor dat verkeer of op db01 of op db02 terecht komt.
=opzet=

= loadbalancing =
Onze servers zijn opgezet in een master-master setup, dus er kan op beide gemuteerd worden, de loadbalancer verspreid de mutatie naar de andere server. 
'''belangrijk''' 
Op alle clusters moet database lbtest aanwezig zijn met tabel lbtest. Deze tabel moet minimaal 1 record hebben, hier test de loadbalancer namelijk op. De usernaam voor loadbalancer en nagios is lbtest met ww Testing123! deze gebruiker heeft alleen select rechten op deze database

= database clusters =
== dbclus01-int ==
Dit cluster bestaat uit mysql01 en mysql02

== hcc-dbclus02-int ==
Dit cluster bestaat uit mysql03 en mysql04

== dbclus04-int ==
Dit cluster bestaat uit mysql05 en mysql06

=configuratie =

== configuratie files ==
al deze bestanden bevinden zich in /etc/mysql/mysql.conf.d

=== mysqld.cnf ===
In deze file hebben we 1 aanpassing gedaan we hebben
bind-address = 127.0.0.1
voorzien van commentaar

=== ssl.cnf ===
Mysql beschikt over ssl daarom is dit ook geconfigureerd, onder andere de replicatie gebruikt het. De ssl.cnf file ziet er zo uit:
[mysqld]
ssl-ca=/disk/site/etc/ssl/hobby.nl/CA-bundel.crt
ssl-cert=/disk/site/etc/ssl/hobby.nl/hobby.nl.crt
ssl-key=/disk/site/etc/ssl/hobby.nl/hobby.nl.key

=== replicatie.cnf ===
Bij de replicatie is het belangrijk dat de oneven servers het server id 1 hebben en de even server id 2. Er mogen nooit 2 de zelfde id's zijn. Ook is de waarde van auto-increment-offset belangrijk; bij de oneven server is dat 1 en bij even 2. 

Voor oneven server ziet hij er zo uit:
#sql mode uit voor toestaan lege velden
sql-mode = ""
server-id = 1
replicate-same-server-id = 0
auto-increment-increment = 2
auto-increment-offset = 1
relay-log = mysql01-relay-bin
binlog_format = "STATEMENT"
replicate-ignore-db = information_schema
replicate-ignore-db = mysql
binlog-ignore-db = information_schema
binlog-ignore-db = mysql
log_bin = /var/log/mysql/mysql-bin.log
slave-skip-errors = 1062

=== credentials.cnf ===
Op de server is root voor localhost voorzien van een wachtwoord om toch mysqldump en het mysql commando te kunnen gebruiken. De eigenaar van deze file is root:mysql met permissies 640.

=== tunning.cnf ===
Deze file bevat performance tuning. Dit is server specifiek, maar er moet in ieder geval deze regel in staan :
[mysqld]
skip-name-resolve = 1

= starten/herstellen replicatie =
== herstel ==
Bij herstellen moet je op beide servers de volgende sql commando's uitvoeren:
stop slave;
reset slave;
Op de '''defecte''' server verwijder je vervolgens alle databases '''nadat je eerst een backup hebt gemaakt'''

=== start replicatie ===
Zorg er voor dat de database niet meer benaderd/gemuteerd wordt. Zet hem uit in de loadbalancer, zowel voor IPv4 als voor IPv6 
Haal bij de '''goede''' server de log positie op:
mysql> show master status\G

*************************** 1. row ***************************
File: mysql-bin.000057
Position: 71061044
Binlog_Do_DB:
Binlog_Ignore_DB: information_schema,mysql
Executed_Gtid_Set:
1 row in set (0.00 sec)
Noteer de file en position 
maak mysqldump en pipe die naar de gefaalde server
mysqldump --all-databases |mysql -h mysql0*-int -u jegebruikersnaam -p
Vul je wachtwoord in en de database wordt gedump naar de ander server (dit kan effe duren).

Op de andere server log je nu in en geef je het volgende commando's in mysql, vul dan het password in van repl user en position bij master_log_pos en de file bij master_log_file
CHANGE MASTER TO MASTER_HOST='mysql0*-int.hobby.nl', MASTER_USER='repl', '''MASTER_PASSWORD='******',''' '''MASTER_LOG_FILE='mysql-bin.000057',''' '''MASTER_LOG_POS=71061044,''' MASTER_SSL = 1, MASTER_SSL_CA = '/disk/site/etc/ssl/hobby.nl/CA-bundel.crt', MASTER_SSL_CERT = '/disk/site/etc/ssl/hobby.nl/hobby.nl.crt', MASTER_SSL_KEY = '/disk/site/etc/ssl/hobby.nl/hobby.nl.key';
start slave;

Nu moeten we controleren of de replicatie deze kant op loopt, dit doe je met het commando
mysql> show slave status\G
*************************** 1. row ***************************
Slave_IO_State: Waiting for master to send event
Master_Host: mysql02-int.hobby.nl
Master_User: repl
Master_Port: 3306
Connect_Retry: 60
Master_Log_File: mysql-bin.000026
Read_Master_Log_Pos: 72292974
Relay_Log_File: mysql01-relay-bin.000056
Relay_Log_Pos: 72293189
Relay_Master_Log_File: mysql-bin.000026
'''Slave_IO_Running: Yes'''
'''Slave_SQL_Running: Yes'''
Replicate_Do_DB:
Replicate_Ignore_DB: information_schema,mysql
Replicate_Do_Table:
Replicate_Ignore_Table:
Replicate_Wild_Do_Table:
Replicate_Wild_Ignore_Table:
Last_Errno: 0
Last_Error:
Skip_Counter: 0
Exec_Master_Log_Pos: 72292974
Relay_Log_Space: 72293447
Until_Condition: None
Until_Log_File:
Until_Log_Pos: 0
Master_SSL_Allowed: Yes
Master_SSL_CA_File: /disk/site/etc/ssl/hobby.nl/CA-bundel.crt
Master_SSL_CA_Path:
Master_SSL_Cert: /disk/site/etc/ssl/hobby.nl/hobby.nl.crt
Master_SSL_Cipher:
Master_SSL_Key: /disk/site/etc/ssl/hobby.nl/hobby.nl.key
Seconds_Behind_Master: 0
Master_SSL_Verify_Server_Cert: No
Last_IO_Errno: 0
Last_IO_Error:
Last_SQL_Errno: 0
Last_SQL_Error:
Replicate_Ignore_Server_Ids:
Master_Server_Id: 2
Master_UUID: f0de239e-2c10-11eb-b1d1-005056a982be
Master_Info_File: mysql.slave_master_info
SQL_Delay: 0
SQL_Remaining_Delay: NULL
Slave_SQL_Running_State: Slave has read all relay log; waiting for more updates
Master_Retry_Count: 86400
Master_Bind:
Last_IO_Error_Timestamp:
Last_SQL_Error_Timestamp:
Master_SSL_Crl:
Master_SSL_Crlpath:
Retrieved_Gtid_Set:
Executed_Gtid_Set:
Auto_Position: 0
Replicate_Rewrite_DB:
Channel_Name:
Master_TLS_Version:
Master_public_key_path:
Get_master_public_key: 0
Network_Namespace:
1 row in set, 1 warning (0.00 sec)
Controleer of '''Slave_IO_Running''' en '''Slave_SQL_Running''' op yes staan. 
Als dit is het geval moeten we de replicatie naar de 1e server ook herstellen. Dit doe je door dezelfde stappen te herhalen vanaf 'show master status'

Inventaris

2020-11-14T11:21:27Z

Hans: /* Inventaris overzicht. */

== Inventaris overzicht. ==

In dit overzicht behoort tenminste alle apparatuur voor te komen, die maximaal 3 jaar oud is.

De gegevens van deze pagina kunnen gebruikt worden als basis van het jaarlijks in te vullen hardware inventarisatie formulier, zoals dat door de penningmeester ieder jaar aan het hcc kantoor ter hand gesteld dient te worden.

{| border="1" cellpadding="2"
! datum aankoop || artikelomschrijving || serienummer || aankoopprijs || leverancier

|-


|30 oktober 2019

|''cisco-sw-01'' 
SG350X-48 48-Port Gigabit Stackable Managed Switch

|DNI241508JA '''vervangen onder garantie 26-10-2020''' 
 <s>DNI2228066K</s>
Factuur: [[Media:f-cisco-switch-2019-10-30-1.pdf]]

| € 362,81 ex BTW

| Azerty
|-


|30 oktober 2019

|''cisco-sw-02'' 
SG350X-48 48-Port Gigabit Stackable Managed Switch

|DNI240108FY '''vervangen onder garantie 26-10-2020''' 
 <s>DNI22280660</s>
Factuur: [[Media:f-cisco-switch-2019-10-30-1.pdf]]

| € 362,81 ex BTW

| Azerty
|-


|22 oktober 2020

|''cisco-sw-03'' 
SX550X-24-K9-EU 
Cisco SX550X-24 24-Port 10GBase-T Stackable Managed Switch

|<s>DNI243100NK</s>
DNI243100Q5 Nieuw SR vervangen DOA

Factuur: [[Media:f-cisco-switch-2020-10-22.pdf]]

| € 2600,00 ex BTW

| infradax
|-


|22 oktober 2020

|''cisco-sw-04-vlan999'' 
SX550X-24-K9-EU 
Cisco SX550X-24 24-Port 10GBase-T Stackable Managed Switch

|DNI243100NL
Factuur: [[Media:f-cisco-switch-2020-10-22.pdf]]

| € 2600,00 ex BTW

| infradax
|-

|12 oktober 2020

|''sfp+'s 10gb'' 
sfp-10GLR-31

|
F2011618820 
F2011618819 
F2011618680 
G1807213492 

Factuur: [[Media:f-fscom-sfps.pdf]]

| € 20,00 ex BTW per stuk (1 gratis :-) proef monster)

| fs.com
|-
|-

|21 oktober 2020

|''DAC kabels sfp+ 10gb'' 
30849


|
G2002057456 
G2002057457

Factuur: [[Media:f-fscom-dac.pdf]]

| € 20,00 ex BTW per stuk (1 gratis :-) proef monster)

| fs.com
|-

|12 oktober 2020

|''sfp programmer'' 
96657


|
B2003000553

Factuur: [[Media:f-fscom-sfps.pdf]]

| € 165,00 ex BTW per stuk

| fs.com
|-


|
september 2020

|''rt-01'' 
MikroTik CCR1016-12S-1S+ router

|912A0B49A749 
Factuur: [[Media:Mikrotik-CCR1016-12S-1S-router-2020.pdf]]

| € 478,33 ex BTW

| interproject polen
|-


|10 juli 2018

|''rt-02'' 
MikroTik CCR1016-12S-1S+ router

|6EFD08521BE4
Factuur: [[media:Mikrotik-CCR1016-12S-1S-router-2.pdf]]

| € 643,80 ex BTW

| KommaGo
|-


|3 juli 2018 
september 2020

|''rt-old'' 1 defecte voeding van 2 als backup in rack 
MikroTik CCR1016-12S-1S+ router

|6EFD087C1C40 
Factuur: [[media:Mikrotik-CCR1016-12S-1S-router-2.pdf]]

| € 643,80 ex BTW

| KommaGo
|-


|juni 2013

|''KVM'' 
* KV1416A-R2 
* Blackbox 16 ports KVM 
* [[Media:f-kvm2013.pdf]]

|13022015224 
[[Media:foto-srnr-kvm.jpg]]

| € 1.987 ex BTW

|Blackbox
|-


| 22 november 2017

| ''logging'' (ex-lb1) 
* PRIMERGY RX1330 M3 
* 1x 8GB DDR4-2400 U ECC 
* Intel(R) Core(TM) i3-7100 CPU @ 3.90GHz 
* 60GB SATAdom 
* 2 x Gbit I210 Gigabit Network interface onboard 
* 4 x Gbit I350 Gigabit Network interface 

|
* Product serienummer : YMDH003824 
* Factuur: [[Media:lb-1-2-bit.pdf]] 

| € 1.396,26 ex BTW

| BIT, Ede
|-


| 22 november 2017

| ''srv01'' (ex-lb2) 
* PRIMERGY RX1330 M3 
* 1x 8GB DDR4-2400 U ECC 
* Intel(R) Core(TM) i3-7100 CPU @ 3.90GHz 
* 60GB SATAdom 
* 2 x Gbit I210 Gigabit Network interface onboard 
* 4 x Gbit I350 Gigabit Network interface 

|
* Product serienummer : YMDH003825 
* Factuur: [[Media:lb-1-2-bit.pdf]] 

| € 1.396,26 ex BTW

| BIT, Ede
|-


| 15 Augustus 2017

| ''vmware1'' 
* Fujitsu Primergy RX2530 M2 
* 4x 32GB DDR4-2400 U ECC (uitbreidbaar naar 12 per socket, upgradebaar naar 64GB per bank) 
* 4 x 900 GB SSD (raid 5) 
* Intel Xeon e5-2620 v4 @ 2.10GHz 8 cores 16 logical processors 
* 4x1Gb T OC|14000-LOM netwerk interface 
* ILOm

|
* Product serienummer : YM6B011958 
* 3 jaar onsite garantie via BIT binnen 8 uur recovery
* Factuur: [[Media:f-bit-vmwar123.pdf]] 

| € 6.996,21 ex BTW

| Bit, Ede
|-


| 15 Augustus 2017

| ''vmware2'' 
* Fujitsu Primergy RX2530 M2 
* 4x 32GB DDR4-2400 U ECC (uitbreidbaar naar 12 per socket, upgradebaar naar 64GB per bank) 
* 4 x 900 GB SSD (raid 5) 
* Intel Xeon e5-2620 v4 @ 2.10GHz 8 cores 16 logical processors 
* 4x1Gb T OC|14000-LOM netwerk interface 
* ILOm

|
* Product serienummer : YM6B011957 
* 3 jaar onsite garantie via BIT binnen 8 uur recovery
* Factuur: [[Media:f-bit-vmwar123.pdf]] 

| € 6.996,21 ex BTW

| Bit, Ede
|-


| 15 Augustus 2017

| ''vmware3'' 
* Fujitsu Primergy RX2530 M2 
* 4x 32GB DDR4-2400 U ECC (uitbreidbaar naar 12 per socket, upgradebaar naar 64GB per bank) 
* 4 x 900 GB SSD (raid 5) 
* Intel Xeon e5-2620 v4 @ 2.10GHz 8 cores 16 logical processors 
* 4x1Gb T OC|14000-LOM netwerk interface 
* ILOm

|
* Product serienummer : YM6B011956 
* 3 jaar onsite garantie via BIT binnen 8 uur recovery
* Factuur: [[Media:f-bit-vmwar123.pdf]] 

| € 6.996,21 ex BTW

| Bit, Ede
|-


| 12 November 2020

| ''vmware4'' 
* Supermicro AS -1113S-WN10RT 
* 256GB MEM
*
* 4x 10 Gb lan Intel
* 2 x onboard lan 1 Gb
* 1x ILOm/ipmi/bmc netwerk interface 1 Gb

|
* Product serienummer : E338207X0902807 
* 3 jaar onsite garantie via BIT
* Factuur: [[Media:f-bit-vmwar456.pdf]] volgt nog nog niet verstuurd 

|

| Bit, Ede
|-


| 12 November 2020

| ''vmware5'' 
* Supermicro AS -1113S-WN10RT 
* 256GB MEM
*
* 4x 10 Gb lan Intel
* 2 x onboard lan 1 Gb
* 1x ILOm/ipmi/bmc netwerk interface 1 Gb

|
* Product serienummer : E338207X0902806 
* 3 jaar onsite garantie via BIT
* Factuur: [[Media:f-bit-vmwar456.pdf]] volgt nog nog niet verstuurd 

|

| Bit, Ede
|-


| 12 November 2020

| ''vmware6'' 
* Supermicro AS -1113S-WN10RT 
* 256GB MEM
*
* 4x 10 Gb lan Intel
* 2 x onboard lan 1 Gb
* 1x ILOm/ipmi/bmc netwerk interface 1 Gb

|
* Product serienummer : E338207X0902805 
* 3 jaar onsite garantie via BIT
* Factuur: [[Media:f-bit-vmwar456.pdf]] volgt nog nog niet verstuurd 

|

| Bit, Ede
|-


| 14 februari 2013

| ''Powerboot-1'' 
APC AP8959EU3 
* 24 schakelbare 230V poorten 

| ZA1238010076

| € 755 ex BTW

| Acesdirect
|-


| 14 februari 2013

| ''Powerboot-2'' 
APC AP8959EU3 
* 24 schakelbare 230V poorten 

| ZA1238010081

| € 755 ex BTW

| Acesdirect
|}

== Afgeschreven apparatuur, niet meer in het rack, niet meer in gebruik ==

{| border="1" cellpadding="2"
! datum aankoop || artikelomschrijving || serienummer || aankoopprijs || leverancier

|-

|

|

|

|

|

|-


| juli 2018

| ''logging old'' 
* Fujitsu RX100 S6 
* 1x 8GB DDR4-2400 U ECC 
* Intel(R) Xeon(R) CPU X3430 @ 2.40GHz 
* 466GB disk 

|
YL8V001703

| € 0 ex BTW (gift)

| BIT, Ede
|-

|-

Inventaris

2020-11-14T08:35:11Z

Hans:

== Inventaris overzicht. ==

In dit overzicht behoort tenminste alle apparatuur voor te komen, die maximaal 3 jaar oud is.

De gegevens van deze pagina kunnen gebruikt worden als basis van het jaarlijks in te vullen hardware inventarisatie formulier, zoals dat door de penningmeester ieder jaar aan het hcc kantoor ter hand gesteld dient te worden.

{| border="1" cellpadding="2"
! datum aankoop || artikelomschrijving || serienummer || aankoopprijs || leverancier

|-


|30 oktober 2019

|''cisco-sw-01'' 
SG350X-48 48-Port Gigabit Stackable Managed Switch

|DNI241508JA '''vervangen onder garantie 26=10=2020''' 
 <s>DNI2228066K</s>
Factuur: [[Media:f-cisco-switch-2019-10-30-1.pdf]]

| € 362,81 ex BTW

| Azerty
|-


|30 oktober 2019

|''cisco-sw-02'' 
SG350X-48 48-Port Gigabit Stackable Managed Switch

|DNI240108FY '''vervangen onder garantie 26=10=2020''' 
 <s>DNI22280660</s>
Factuur: [[Media:f-cisco-switch-2019-10-30-1.pdf]]

| € 362,81 ex BTW

| Azerty
|-


|22 oktober 2020

|''cisco-sw-03'' 
SX550X-24-K9-EU 
Cisco SX550X-24 24-Port 10GBase-T Stackable Managed Switch

|<s>DNI243100NK</s>
DNI243100Q5 Nieuw SR vervangen DOA

Factuur: [[Media:f-cisco-switch-2020-10-22.pdf]]

| € 2600,00 ex BTW

| infradax
|-


|22 oktober 2020

|''cisco-sw-04-vlan999'' 
SX550X-24-K9-EU 
Cisco SX550X-24 24-Port 10GBase-T Stackable Managed Switch

|DNI243100NL
Factuur: [[Media:f-cisco-switch-2020-10-22.pdf]]

| € 2600,00 ex BTW

| infradax
|-

|12 oktober 2020

|''sfp+'s 10gb'' 
sfp-10GLR-31

|
F2011618820 
F2011618819 
F2011618680 
G1807213492 

Factuur: [[Media:f-fscom-sfps.pdf]]

| € 20,00 ex BTW per stuk (1 gratis :-) proef monster)

| fs.com
|-
|-

|21 oktober 2020

|''DAC kabels sfp+ 10gb'' 
30849


|
G2002057456 
G2002057457

Factuur: [[Media:f-fscom-dac.pdf]]

| € 20,00 ex BTW per stuk (1 gratis :-) proef monster)

| fs.com
|-

|12 oktober 2020

|''sfp programmer'' 
96657


|
B2003000553

Factuur: [[Media:f-fscom-sfps.pdf]]

| € 165,00 ex BTW per stuk

| fs.com
|-


|
september 2020

|''rt-01'' 
MikroTik CCR1016-12S-1S+ router

|912A0B49A749 
Factuur: [[Media:Mikrotik-CCR1016-12S-1S-router-2020.pdf]]

| € 478,33 ex BTW

| interproject polen
|-


|10 juli 2018

|''rt-02'' 
MikroTik CCR1016-12S-1S+ router

|6EFD08521BE4
Factuur: [[media:Mikrotik-CCR1016-12S-1S-router-2.pdf]]

| € 643,80 ex BTW

| KommaGo
|-


|3 juli 2018 
september 2020

|''rt-old'' 1 defecte voeding van 2 als backup in rack 
MikroTik CCR1016-12S-1S+ router

|6EFD087C1C40 
Factuur: [[media:Mikrotik-CCR1016-12S-1S-router-2.pdf]]

| € 643,80 ex BTW

| KommaGo
|-


|juni 2013

|''KVM'' 
* KV1416A-R2 
* Blackbox 16 ports KVM 
* [[Media:f-kvm2013.pdf]]

|13022015224 
[[Media:foto-srnr-kvm.jpg]]

| € 1.987 ex BTW

|Blackbox
|-


| 22 november 2017

| ''logging new'' 
* PRIMERGY RX1330 M3 
* 1x 8GB DDR4-2400 U ECC 
* Intel(R) Core(TM) i3-7100 CPU @ 3.90GHz 
* 60GB SATAdom 
* 2 x Gbit I210 Gigabit Network interface onboard 
* 4 x Gbit I350 Gigabit Network interface 

|
* Product serienummer : YMDH003824 
* Factuur: [[Media:lb-1-2-bit.pdf]] 

| € 1.396,26 ex BTW

| BIT, Ede
|-


| 22 november 2017

| ''LB2'' 
* PRIMERGY RX1330 M3 
* 1x 8GB DDR4-2400 U ECC 
* Intel(R) Core(TM) i3-7100 CPU @ 3.90GHz 
* 60GB SATAdom 
* 2 x Gbit I210 Gigabit Network interface onboard 
* 4 x Gbit I350 Gigabit Network interface 

|
* Product serienummer : YMDH003825 
* Factuur: [[Media:lb-1-2-bit.pdf]] 

| € 1.396,26 ex BTW

| BIT, Ede
|-


| 15 Augustus 2017

| ''vmware1'' 
* Fujitsu Primergy RX2530 M2 
* 4x 32GB DDR4-2400 U ECC (uitbreidbaar naar 12 per socket, upgradebaar naar 64GB per bank) 
* 4 x 900 GB SSD (raid 5) 
* Intel Xeon e5-2620 v4 @ 2.10GHz 8 cores 16 logical processors 
* 4x1Gb T OC|14000-LOM netwerk interface 
* ILOm

|
* Product serienummer : YM6B011958 
* 3 jaar onsite garantie via BIT binnen 8 uur recovery
* Factuur: [[Media:f-bit-vmwar123.pdf]] 

| € 6.996,21 ex BTW

| Bit, Ede
|-


| 15 Augustus 2017

| ''vmware2'' 
* Fujitsu Primergy RX2530 M2 
* 4x 32GB DDR4-2400 U ECC (uitbreidbaar naar 12 per socket, upgradebaar naar 64GB per bank) 
* 4 x 900 GB SSD (raid 5) 
* Intel Xeon e5-2620 v4 @ 2.10GHz 8 cores 16 logical processors 
* 4x1Gb T OC|14000-LOM netwerk interface 
* ILOm

|
* Product serienummer : YM6B011957 
* 3 jaar onsite garantie via BIT binnen 8 uur recovery
* Factuur: [[Media:f-bit-vmwar123.pdf]] 

| € 6.996,21 ex BTW

| Bit, Ede
|-


| 15 Augustus 2017

| ''vmware3'' 
* Fujitsu Primergy RX2530 M2 
* 4x 32GB DDR4-2400 U ECC (uitbreidbaar naar 12 per socket, upgradebaar naar 64GB per bank) 
* 4 x 900 GB SSD (raid 5) 
* Intel Xeon e5-2620 v4 @ 2.10GHz 8 cores 16 logical processors 
* 4x1Gb T OC|14000-LOM netwerk interface 
* ILOm

|
* Product serienummer : YM6B011956 
* 3 jaar onsite garantie via BIT binnen 8 uur recovery
* Factuur: [[Media:f-bit-vmwar123.pdf]] 

| € 6.996,21 ex BTW

| Bit, Ede
|-


| 12 November 2020

| ''vmware4'' 
* Supermicro AS -1113S-WN10RT 
* 256GB MEM
*
* 4x 10 Gb lan Intel
* 2 x onboard lan 1 Gb
* 1x ILOm/ipmi/bmc netwerk interface 1 Gb

|
* Product serienummer : E338207X0902806 
* 3 jaar onsite garantie via BIT
* Factuur: [[Media:f-bit-vmwar456.pdf]] volgt nog nog niet verstuurd 

|

| Bit, Ede
|-


| 12 November 2020

| ''vmware5'' 
* Supermicro AS -1113S-WN10RT 
* 256GB MEM
*
* 4x 10 Gb lan Intel
* 2 x onboard lan 1 Gb
* 1x ILOm/ipmi/bmc netwerk interface 1 Gb

|
* Product serienummer : E338207X0902805 
* 3 jaar onsite garantie via BIT
* Factuur: [[Media:f-bit-vmwar456.pdf]] volgt nog nog niet verstuurd 

|

| Bit, Ede
|-


| 12 November 2020

| ''vmware6'' 
* Supermicro AS -1113S-WN10RT 
* 256GB MEM
*
* 4x 10 Gb lan Intel
* 2 x onboard lan 1 Gb
* 1x ILOm/ipmi/bmc netwerk interface 1 Gb

|
* Product serienummer : E338207X0902805 
* 3 jaar onsite garantie via BIT
* Factuur: [[Media:f-bit-vmwar456.pdf]] volgt nog nog niet verstuurd 

|

| Bit, Ede
|-


| 14 februari 2013

| ''Powerboot-1'' 
APC AP8959EU3 
* 24 schakelbare 230V poorten 

| ZA1238010076

| € 755 ex BTW

| Acesdirect
|-


| 14 februari 2013

| ''Powerboot-2'' 
APC AP8959EU3 
* 24 schakelbare 230V poorten 

| ZA1238010081

| € 755 ex BTW

| Acesdirect
|}

== Afgeschreven apparatuur, niet meer in het rack, niet meer in gebruik ==

{| border="1" cellpadding="2"
! datum aankoop || artikelomschrijving || serienummer || aankoopprijs || leverancier

|-

|

|

|

|

|

|-


| juli 2018

| ''logging old'' 
* Fujitsu RX100 S6 
* 1x 8GB DDR4-2400 U ECC 
* Intel(R) Xeon(R) CPU X3430 @ 2.40GHz 
* 466GB disk 

|
YL8V001703

| € 0 ex BTW (gift)

| BIT, Ede
|-

|-

Automatische installatie

2020-11-09T10:42:52Z

Hans:

= doel =
Server automatisch conform standaard installeren

= vereisten =
* server met interne interface
* optie tot pxe boot
* minimaal 4 gb werkgeheugen tijdens installatie 
Toelichting: het ISO image wordt tijdelijk in het geheugen geladen. 
Na installatie kan je het werkgeheugen terugschroeven indien nodig.

= vmware machine aanmaken aandachtspunten =
Het is handigste als servers op zelfde manier worden aangemaakt daarom volgende aandachtspunten voor het netwerk.
Maak netwerk altijd in deze volgorde aan : ''' Twijfel je toch over de benamingen boot eerst via een live omgeving en bekijk de benamingen van interface '''

== machine met extern en interne interface ==
* externe interface (ens160)
* interne interface (ens192)
* storage interface (ens224)
* eventueel overige interfaces

== machine met interne interface ==
* interne interface (ens160)
* storage interface (ens192)

= stappen =
* start machine met PXE
* kies in menu optie (a)uto installers Hobbynet...
* Kies Ubuntu Server 20.04.1 amd64 (focal Fossa)
* vul de hostnaam in
* vul de interface naam in van 1e interface
* vul het ip adres van deze interface
* vul het subnetmask in cider notatie dus /24 /25 etc etc
* vul het gateway IP adres in
* Als er een tweede interface is '''(Storage interface niet mee gerekend)''' vul de interface naam in, ander laat alle velden van 2e interface leeg
* vul het IP adres van deze interface in
* vul het subnetmask in cider notatie dus /24 /25 etc etc
* vul het gateway IP adres in
* Vul de interface naam in van de storage interface
* Druk op enter
Bij een server met alleen een interne en storage interface ziet dat er als volgt uit: 
[[File:Ipxe autoinstall.png|frame|Automatische installatie van server met alleen interne en storage interface]]
Nu wordt ondertussen de volledige geautomatiseerde installatie uitgevoerd.
* na afloop van de geautomatiseerde installatie krijg je 1 login prompt, wacht tot de server nog een keer reboot, dan pas is de automatische installatie afgerond

IPXE

2020-11-09T10:35:27Z

Hans:

= doel =
Het faciliteren van netwerk boot waaronder automatische installatie voor hobbynet

= hoe werkt het =
Op de server [[pxe]] draait een tftpserver daar zijn de bestanden geplaatst die nodig zijn bij het booten via ipxe

== bestanden ==
* undionly.kpxe (dit is de bootfile voor de dhcp server)
* ipxe.php (deze php file maakt het ipxe menu)
* no-cloud-configuratie.php (deze file maakt automatische configuratie voor automatische installaties)
* ubuntu-ipxe/**/server/ Hierin staan de bestanden vmlinuz en initrd, benodigd bij deze versie (** is het versie nr)
* ubuntu-ipxe/**/desktop/ Hierin staan de bestanden vmlinuz en initrd, benodigd bij deze versie (** is het versie nr)

= het proces bij niet automatische installatie=
De installatie haalt de iso en hij boot de installatie

= het proces bij automatische installatie =
Voor uitleg hoe je een automatische installatie uitvoert kijk hier [[Automatische installatie]] .

De basis: bij automatische installatie worden je netwerk parameters gevraagd en de hostnaam, daarna wordt er automatisch installatie gedaan. 
Aan de hand van je antwoorden genereert no-cloud-configuratie.php een yaml file waarna aan de hand daarvan de server wordt geïnstalleerd conform de hobbynet standaard. 
De server start (vrij snel nadat je 1e keer de login prompt ziet) ziet nog 1 x opnieuw op. Dit wordt door het pakket hobby-postinstall geregeld, dit is omdat niet alle pakketten via no-cloud-init installatie kunnen, het pakket maakt een cron entry van @reboot die 30 seconde na de reboot de hobby-install uitvoert en de user '''a''' verwijdert etc .

Sambabal

2020-11-09T10:25:55Z

Hans:

= doel =
Deze server verzorgt samba shares naar de shared storage. 
Dit heeft vooral voordelen met ontwikkelen in de joomla sites 

= configuratie =
Die is vrij recht toe recht aan.
* apt install samba
* mkdir /etc/samba/samba.d.conf
* plaats hier in shares.conf met share definities
Doe de volgende aanpassingen in /etc/samba/smb.conf
* Verander de variable workgroup naar ad.hobby.nl
* voeg de regel '''include = /etc/samba/samba.d.conf/*.conf''' toe
* herstart samba '''systemctl restart smbd.service nmbd.service'''

= user toevoegen en activeren =
Dat gaat als volgt :
root@sambabal:/etc/samba# smbpasswd -a bas
New SMB password:
Retype new SMB password:
Added user bas.
root@sambabal:/etc/samba# smbpasswd -e bas
Enabled user bas.

= firewall=
Deze firewall regels zijn toegevoegd:
== ipv4 ==
# samba mag van de vpn reeksen
$IPTABLES -A INPUT -p udp -s 192.168.200.0/24 --dport 137 -j ACCEPT
$IPTABLES -A INPUT -p udp -s 192.168.200.0/24 --dport 138 -j ACCEPT
$IPTABLES -A INPUT -p tcp -s 192.168.200.0/24 --dport 139 -j ACCEPT
$IPTABLES -A INPUT -p tcp -s 192.168.200.0/24 --dport 445 -j ACCEPT
$IPTABLES -A INPUT -p udp -s 172.31.2.0/24 --dport 137 -j ACCEPT
$IPTABLES -A INPUT -p udp -s 172.31.2.0/24 --dport 138 -j ACCEPT
$IPTABLES -A INPUT -p tcp -s 172.31.2.0/24 --dport 139 -j ACCEPT
$IPTABLES -A INPUT -p tcp -s 172.31.2.0/24 --dport 445 -j ACCEPT
== ipv6 ==
$IP6TABLES -A INPUT -p udp -s 2a05:f080:0:300::/64 --dport 137 -j ACCEPT
$IP6TABLES -A INPUT -p udp -s 2a05:f080:0:300::/64 --dport 138 -j ACCEPT
$IP6TABLES -A INPUT -p tcp -s 2a05:f080:0:300::/64 --dport 139 -j ACCEPT
$IP6TABLES -A INPUT -p tcp -s 2a05:f080:0:300::/64 --dport 445 -j ACCEPT
$IP6TABLES -A INPUT -p udp -s 2a02:968:fffe:ffff::/64 --dport 137 -j ACCEPT
$IP6TABLES -A INPUT -p udp -s 2a02:968:fffe:ffff::/64 --dport 138 -j ACCEPT
$IP6TABLES -A INPUT -p tcp -s 2a02:968:fffe:ffff::/64 --dport 139 -j ACCEPT
$IP6TABLES -A INPUT -p tcp -s 2a02:968:fffe:ffff::/64 --dport 445 -j ACCEPT

Cephfs

2020-11-07T12:19:52Z

Hans:

=doel=
De shared storage is uitbesteed aan Bit, hier wat uitleg er voor

= installatie bij Hobbynet =
Ken een IP adres toe uit de reeks 2001:7b8:89:0::/64 
Standaard pakken wij het IPv4 adres van de interne interface en dat plakken we in het IPv6 adres, dus 172.31.1.19 wordt 2001:7b8:89:0:172:31:1:19/64. 
En er moet een route worden toegevoegd voor 2001:7b8:80::/48 naar 2001:7b8:89::1

Je interface ziet er dan zo uit:
ens224:
dhcp6: no
accept-ra: no
addresses:
- 2001:7b8:89:0:172:31:1:19/64
routes:
- to: 2001:7b8:80::/48
via: 2001:7b8:89::1
critical: true

Installeer eerst de Hobbunet cephfs repo en daarna het pakket 'hobby-cephfs'
apt install hobby-cephfs-repo
apt install hobby-cephfs

= fstab =
== read write ==
Een read/write entry ziet er zo uit :
[2001:7b8:80:1:0:1:1:1],[2001:7b8:80:1:0:1:1:2],[2001:7b8:80:3:0:2c:1:3],[2001:7b8:80:3:0:2c:1:4],[2001:7b8:80:2:0:2a:1:5]:/HCCHC/170920/disk/site/etc/ssl /disk/site/etc/ssl ceph name=HCCHC-170920-cephfs,secretfile=/etc/ceph/ceph.client.HCCHC-170920-cephfs.key,noatime,_netdev 0 2
'''1 regel'''
== read only==
Een readonly entry ziet er zo uit :
[2001:7b8:80:1:0:1:1:1],[2001:7b8:80:1:0:1:1:2],[2001:7b8:80:3:0:2c:1:3],[2001:7b8:80:3:0:2c:1:4],[2001:7b8:80:2:0:2a:1:5]:/HCCHC/170920/disk/site/etc/ssl/wildcard.hcc.nl /disk/site/etc/ssl/wildcard.hcc.nl ceph name=HCCHC-170989-cephfs,secretfile=/etc/ceph/ceph.client.HCCHC-170989-cephfs.key,noatime,_netdev,ro 0 2
== standaard mounts in fstab ==
Deze mounts worden standaard in fstab geplaatst (terwille van de leesbaarheid zijn de regels afgebroken met '--' op het eind):
#cephfs
#Hobbynet shared Directory's

[2001:7b8:80:1:0:1:1:1],[2001:7b8:80:1:0:1:1:2],[2001:7b8:80:3:0:2c:1:3],[2001:7b8:80:3:0:2c:1:4],[2001:7b8:80:2:0:2a:1:5]:/HCCHC/170920/disk/usr/local/hobbynet/bin --
/usr/local/hobbynet/bin ceph name=HCCHC-170989-cephfs,secretfile=/etc/ceph/ceph.client.HCCHC-170989-cephfs.key,noatime,_netdev,ro 0 2
[2001:7b8:80:1:0:1:1:1],[2001:7b8:80:1:0:1:1:2],[2001:7b8:80:3:0:2c:1:3],[2001:7b8:80:3:0:2c:1:4],[2001:7b8:80:2:0:2a:1:5]:/HCCHC/170920/disk/usr/local/hobbynet/etc --
/usr/local/hobbynet/etc ceph name=HCCHC-170989-cephfs,secretfile=/etc/ceph/ceph.client.HCCHC-170989-cephfs.key,noatime,_netdev,ro 0 2
[2001:7b8:80:1:0:1:1:1],[2001:7b8:80:1:0:1:1:2],[2001:7b8:80:3:0:2c:1:3],[2001:7b8:80:3:0:2c:1:4],[2001:7b8:80:2:0:2a:1:5]:/HCCHC/170920/disk/usr/local/hobbynet/lib --
/usr/local/hobbynet/lib ceph name=HCCHC-170989-cephfs,secretfile=/etc/ceph/ceph.client.HCCHC-170989-cephfs.key,noatime,_netdev,ro 0 2
[2001:7b8:80:1:0:1:1:1],[2001:7b8:80:1:0:1:1:2],[2001:7b8:80:3:0:2c:1:3],[2001:7b8:80:3:0:2c:1:4],[2001:7b8:80:2:0:2a:1:5]:/HCCHC/170920/disk/usr/local/hobbynet/home --
/usr/local/hobbynet/home ceph name=HCCHC-170920-cephfs,secretfile=/etc/ceph/ceph.client.HCCHC-170920-cephfs.key,noatime,_netdev 0 2

#firewall
[2001:7b8:80:1:0:1:1:1],[2001:7b8:80:1:0:1:1:2],[2001:7b8:80:3:0:2c:1:3],[2001:7b8:80:3:0:2c:1:4],[2001:7b8:80:2:0:2a:1:5]:/HCCHC/170920/disk/usr/local/hobbynet/firewall/general --
/usr/local/hobbynet/firewall/general ceph name=HCCHC-170989-cephfs,secretfile=/etc/ceph/ceph.client.HCCHC-170989-cephfs.key,noatime,_netdev,ro 0 2

= firewalling =
In de algemene IPv6 firewall regels staan we al het verkeer toe van en naar 2001:7b8:80::/48, met uitzondering van port 22 (ssh) inkomend. 
Voor inkomend staat dit in '''/usr/local/hobbynet/firewall/general/in_up.ip6''':
#drop ssh van cephstorage bit
$IP6TABLES -A INPUT -p tcp -s 2001:7b8:80::/48 --dport 22 -j ACCEPT

#overig verkeer van cephstorage bit moet mogen
$IP6TABLES -A INPUT -s 2001:7b8:80::/48 -j ACCEPT
Voor uitgaand is dat in '''/usr/local/hobbynet/firewall/general/out_up.ip6'''
#verkeer naar cephstorage bit moet mogen
$IP6TABLES -A OUTPUT -d 2001:7b8:80::/48 -j ACCEPT

= keys =

RW user:
[client.HCCHC-170920-cephfs]
key = AQBOo5Zf3rJQCxAA/yqzR0OX9LajCv+waicd2w==
caps mds = "allow rw path=/HCCHC/170920"
caps mon = "allow r"
caps osd = "allow rw pool=BITED-153874-cephfs_data namespace=HCCHC-01"

RO user:
[client.HCCHC-170989-cephfs]
key = AQBRo5Zfx9FzBRAAMuNwqySs17SJJJ9bPHnuew==
caps mds = "allow r path=/HCCHC/170920"
caps mon = "allow r"
caps osd = "allow r pool=BITED-153874-cephfs_data namespace=HCCHC-01"

= uitleg bit =
Uit Bit ticket 170920 https://status.bit.nl/tickets/?id=170920&query=f35a540e5379df8ed2c734707a7984e3
Hieronder de uitleg voor het instellen van de Cephfs.

1) Zorg ervoor dat de server een IP adres krijgt in de netwerk range 2001:7b8:89::/48
2) Zorg ervoor dat er een route is ingesteld naar de Ceph storage omgeving

/sbin/ip -6 route add 2001:7b8:80::/48 via 2001:7b8:89::1

3) Installeer de Ceph tooling

$ wget -qO- https://download.ceph.com/keys/release.asc | apt-key add -
$ echo "deb http://ceph.download.bit.nl/debian-mimic bionic main" \
| sudo tee /etc/apt/sources.list.d/ceph.list
$ apt update
$ apt install ceph-common

4) Maak een bestand aan in /etc/ceph/ceph.conf met onderstaande informatie:

[global]
# IPs here instead of hostname so we work independent of DNS
mon_host = [2001:7b8:80:1:0:1:1:1],[2001:7b8:80:1:0:1:1:2],[2001:7b8:80:3:0:2c:1:3],[2001:7b8:80:3:0:2c:1:4],[2001:7b8:80:2:0:2a:1:5]

5) Plaats de client key waarmee de authenticatie plaatsvind op de Cephfs. De nodige gegevens hiervan zijn te vinden in de securebox.

$ cat /etc/ceph/ceph.client.FOOBA-123456-cephfs.keyring
[client.FOOBA-123456-cephfs]
key = AQDpqB....
caps mds = "allow rw path=/FOOBA/123456"
caps mon = "allow r"
caps osd = "allow rw pool=BITED-153874-cephfs_data namespace=FOOBA-01"

6) Plaats de key zelf ook nog los in een file. Dit is dezelfde key als in stap 5 is gebruikt.

$ cat /etc/ceph/ceph.client.FOOBA-123456-cephfs.key
AQDpqB....

7) Zet onderstaande regel in fstab

mon1.ceph.bit.nl,mon2.ceph.bit.nl,mon3.ceph.bit.nl,mon4.ceph.bit.nl,mon5.ceph.bit.nl:/HCCHC/170920 /mnt/data ceph name=FOOBA-123456-cephfs,secretfile=/etc/ceph/ceph.client.FOOBA-123456-cephfs.key,noatime,_netdev 0 2

Hierna zal het mogelijk moeten zijn om /mnt/data te mounten met Cephfs. Wanneer er alleen RO rechten toegestaan zijn, dan dien je vanaf stap 5 de key te gebruiken voor de RO user.
{{Note}} In orginele bit ticket ontbrak 'apt install ceph-common'. deze toegevoegd 
{{Note}} In orginele bit ticket zat typo in mount path /HCCHC/17092 moest /HCCHC/170920 zijn (gecorrigeerd) 
{{Note}} Van de aan ons toegekende /48 wordt alleen de 1e /64 gebruikt dus 2001:7b8:89:0::/64

MySQL cluster

2020-10-26T09:38:38Z

Hans:

=doel=
Om te zorgen dat onze database server ook volledig redundant is hebben we hier een cluster gemaakt, onze loadbalancer zorgt er voor dat verkeer of op db01 of op db02 terecht komt.
=opzet=
== normale situatie ==
Dit geeft weer hoe in normale situaties het verkeer loopt. 
[[File:DBnormaal.png]]

[[File:DBnormaal.dia]]

== Loadbalancer faalt ==
Dit geeft weer hoe in een situatie het verkeer loopt als er een loadbalancer faalt. 
[[File:DBlbfaalt.png]]

[[File:DBlbfaalt.dia]]

== Database server faalt ==
Dit geeft weer hoe in een situatie het verkeer loopt als er een Database server faalt. 
[[File:DBdbfaalt.png]]

[[File:DBdbfaalt.dia]]

== Server id's ==
Elke server in het cluster heeft een unique id. Wij houden dan ook voor elke server unique aan ook zitten ze niet in het zelfde cluster.

Server ids:
<pre>
1 db01
2. db02
3. db03
4. db04
5 ldap-lb1
6. ldap-lb2
7 mail-lb1
8 mail-lb2
</pre>

= loadbalancing =
Omdat we maar willen dat er 1 server wordt aangesproken (i.p.v. allebei tegelijk), zodat er geen locking problemen ontstaan, is de loadbalancer in failover mode geconfigureerd. Voor meer info zie [[Loadbalancers]]

= database cluster 01 (hobbynet) dbclus01-int =
== configuratie ==
De twee servers staan in 'master master replicatie', dit wil zeggen als er een mutatie wordt gedaan op server 1 dat deze ook wordt doorgevoerd op server 2.

De loadbalancer zorgt er voor dat server 1 altijd wordt aangesproken. Is server 1 down dan wordt er omgeschakeld naar server2 zonder dat de gebruiker hier iets van merkt.

== config files ==
=== db01 ===
De config aanpassingen die gedaan zijn op standaard config zijn:
#sql mode uit voor toestaan lege velden
sql-mode = ""
server-id = '''1'''
replicate-same-server-id = 0
auto-increment-increment = 2
auto-increment-offset = 1

log_bin = /var/log/mysql/mysql-bin.log
expire_logs_days = 10
max_binlog_size = 100M
binlog_format = "STATEMENT"
replicate-ignore-db = information_schema
replicate-ignore-db = mysql
binlog-ignore-db = information_schema
binlog-ignore-db = mysql

=== db02 ===
de config aanpassingen die gedaan zijn op standaard config zijn:
#sql mode uit voor toestaan lege velden
sql-mode = ""
server-id = '''2'''
replicate-same-server-id = 0
auto-increment-increment = 2
auto-increment-offset = 2

log_bin = /var/log/mysql/mysql-bin.log
expire_logs_days = 10
max_binlog_size = 100M
binlog_format = "STATEMENT"
replicate-ignore-db = information_schema
replicate-ignore-db = mysql
binlog-ignore-db = information_schema
binlog-ignore-db = mysql

= database cluster 02 (hcc.nl) hcc-dbclus02-int=
== configuratie ==
De twee servers staan in de 'master master replicatie' mode, dit wil zeggen als er een mutatie wordt gedaan op server 1, dat deze ook wordt doorgevoerd op server 2.

De loadbalancer zorgt er voor dat server 1 altijd wordt aangesproken. Is server 1 down dat wordt er omgeschakeld naar server2 zonder dat gebruiker hier iets van merkt.

== config files ==
=== hcc-db03 ===
De config aanpassingen die gedaan zijn op standaard config zijn:

server-id = '''3'''
log_bin = /var/log/mysql/mysql-bin.log
replicate-same-server-id = 0
auto-increment-increment = 2
auto-increment-offset = 1

expire_logs_days = 10
max_binlog_size = 100M
binlog_do_db = bas
# lbtest mag nooit weg ivm loadbalancing test of mysql nog werkt!
binlog_do_db = lbtest
binlog_do_db = www-prod
<snip>
binlog_ignore_db = mysql

=== hcc-db04 ===
De config aanpassingen die gedaan zijn op standaard config zijn:
server-id = '''4'''
replicate-same-server-id = 0
auto-increment-increment = 2
auto-increment-offset = 2

log_bin = /var/log/mysql/mysql-bin.log
expire_logs_days = 10
max_binlog_size = 100M
binlog_do_db = bas
# lbtest mag nooit weg ivm loadbalancing test of mysql nog werkt!
binlog_do_db = lbtest
binlog_do_db = www-prod
<snip>
binlog_ignore_db = mysql

= database aan replicatie toevoegen =
* maak zo nodig de database user aan op '''beide database servers'''
* ken rechten toe op '''beide database servers'''

LET OP: ''de gebruiker en de rechten worden niet gerepliceerd, die moeten dus echt zoals hier beschreven '''dubbel''' worden aangemaakt!''

= database uit replicatie verwijderen =
* verwijder database op 1 van beide database servers
* verwijder zo nodig bij behorende user op '''beide database servers'''

= status replicatie bekijken =
== goede status ==
Een goede status ziet er als volgt uit:
<pre>
mysql> show slave status\G
*************************** 1. row ***************************
Slave_IO_State: Waiting for master to send event
Master_Host: 172.31.1.214
Master_User: repl
Master_Port: 3306
Connect_Retry: 60
Master_Log_File: mysql-bin.000023
Read_Master_Log_Pos: 23081
Relay_Log_File: db01-int-relay-bin.000135
Relay_Log_Pos: 251
Relay_Master_Log_File: mysql-bin.000023
Slave_IO_Running: Yes
Slave_SQL_Running: Yes
Replicate_Do_DB:
Replicate_Ignore_DB:
Replicate_Do_Table:
Replicate_Ignore_Table:
Replicate_Wild_Do_Table:
Replicate_Wild_Ignore_Table:
Last_Errno: 0
Last_Error:
Skip_Counter: 0
Exec_Master_Log_Pos: 23081
Relay_Log_Space: 554
Until_Condition: None
Until_Log_File:
Until_Log_Pos: 0
Master_SSL_Allowed: No
Master_SSL_CA_File:
Master_SSL_CA_Path:
Master_SSL_Cert:
Master_SSL_Cipher:
Master_SSL_Key:
Seconds_Behind_Master: 0
Master_SSL_Verify_Server_Cert: No
Last_IO_Errno: 0
Last_IO_Error:
Last_SQL_Errno : 0
Last_SQL_Error:
1 row in set (0.00 sec)
</pre>
Zowel Slave_IO_Running als Slave_SQL_Running staan op 'yes', en Slave_IO_State staat op 'Waiting for master to send event'

== foute status ==
Zo ziet een foute status er uit.
<pre>
mysql> show slave status\G
*************************** 1. row ***************************
Slave_IO_State: Reconnecting after a failed master event read
Master_Host: 172.31.1.214
Master_User: repl
Master_Port: 3306
Connect_Retry: 60
Master_Log_File: mysql-bin.000023
Read_Master_Log_Pos: 23081
Relay_Log_File: db01-int-relay-bin.000136
Relay_Log_Pos: 251
Relay_Master_Log_File: mysql-bin.000023
Slave_IO_Running: No
Slave_SQL_Running: Yes
Replicate_Do_DB:
Replicate_Ignore_DB:
Replicate_Do_Table:
Replicate_Ignore_Table:
Replicate_Wild_Do_Table:
Replicate_Wild_Ignore_Table:
Last_Errno: 0
Last_Error:
Skip_Counter: 0
Exec_Master_Log_Pos: 23081
Relay_Log_Space: 554
Until_Condition: None
Until_Log_File:
Until_Log_Pos: 0
Master_SSL_Allowed: No
Master_SSL_CA_File:
Master_SSL_CA_Path:
Master_SSL_Cert:
Master_SSL_Cipher:
Master_SSL_Key:
Seconds_Behind_Master: NULL
Master_SSL_Verify_Server_Cert: No
Last_IO_Errno: 2013
Last_IO_Error: error reconnecting to master 'repl@172.31.1.214:3306' - retry-time: 60 retries: 86400
Last_SQL_Errno: 0
Last_SQL_Error:
1 row in set (0.00 sec)
</pre>
zoals je kan zien staat Slave_IO_Running op 'No' en staat er een melding bij Last_IO_Error. In dit geval staat de ander db server gewoon uit voor bijvoorbeeld een OS update. Dit probleem zal zich daarom vanzelf weer herstellen.

= herstel van replicatie =
== automatisch ==
Als als goed gaat wordt nadat een server weer online komt hij weer helemaal upd2date gebracht.
== handmatig ==
Op het moment dat een server niet automatisch up2date wordt gebracht, moet dit handmatig gebeuren.
=== replicatie stop zetten ===
Dan moet op beide server het commando "stop slave;" gegeven worden. 
De host die niet up2date is moet in de loadbalancer worden uitgeschakeld, indien mogelijk beide servers, dat voorkomt fouten.
Zolang directe toegang tot de servers mogelijk is (load-banlancer probleem) moet de firewall even aangepast worden.

=== replicatie herstellen ===
==== voor de gefaalde host ====
Maak eerst backup van de gefaalde en goede host je weet maar nooit. 
Hierna drop je alle databases die gerepliceerd worden. '''dus niet MYSQL!!!!''' 
Daar doe je eerst op de master een "show master status \g" op de goede host. De gegevens hieruit hebben we nodig om de replicatie naar de gefaalde host weer op gang te brengen.
<pre>
mysql> show master status \g
+------------------+----------+-----------------------------------------------------------------+------------------+
| File | Position | Binlog_Do_DB | Binlog_Ignore_DB |
+------------------+----------+-----------------------------------------------------------------+------------------+
| mysql-bin.000012 | 4154828 | bas,lbtest,www-prod,www-test,hcc-gebruikers,hcc-gebruikers-test | mysql |
+------------------+----------+-----------------------------------------------------------------+------------------+
1 row in set (0.00 sec)
</pre>
Hier moet de huidige stand van zaken overbrengen naar de gefaalde host dat doe je als volgt:
<pre>
mysqldump --all-databases | mysql -h hostgefaald-int -u bas -pjegeheimewachtwoord
</pre>
Gebruik hier natuurlijk je mysql credentials met volledige rechten. 
daarna login met mysql in op de gefaalde host en geef je volgende query in. 
<pre>
CHANGE MASTER TO MASTER_HOST='IP goede DB server', MASTER_USER='repl', MASTER_PASSWORD='*******', MASTER_LOG_FILE='mysql-bin.000012', MASTER_LOG_POS=4154828 ;
</pre>
De master_log_file en _master_log_pos haal je op van de eerder gedane 'show master status' 
Hierna geef je het commando 'start slave;' 
Hierna ga je het commando 'show slave status\G' om te zien of alles weer loopt, als het goed is ziet het er dan ongeveer zo uit.
<pre>
mysql> show slave status\G
*************************** 1. row ***************************
Slave_IO_State: Waiting for master to send event
Master_Host: 172.31.1.214
Master_User: repl
Master_Port: 3306
Connect_Retry: 60
Master_Log_File: mysql-bin.000023
Read_Master_Log_Pos: 23081
Relay_Log_File: db01-int-relay-bin.000135
Relay_Log_Pos: 251
Relay_Master_Log_File: mysql-bin.000023
Slave_IO_Running: Yes
Slave_SQL_Running: Yes
Replicate_Do_DB:
Replicate_Ignore_DB:
Replicate_Do_Table:
Replicate_Ignore_Table:
Replicate_Wild_Do_Table:
Replicate_Wild_Ignore_Table:
Last_Errno: 0
Last_Error:
Skip_Counter: 0
Exec_Master_Log_Pos: 23081
Relay_Log_Space: 554
Until_Condition: None
Until_Log_File:
Until_Log_Pos: 0
Master_SSL_Allowed: No
Master_SSL_CA_File:
Master_SSL_CA_Path:
Master_SSL_Cert:
Master_SSL_Cipher:
Master_SSL_Key:
Seconds_Behind_Master: 0
Master_SSL_Verify_Server_Cert: No
Last_IO_Errno: 0
Last_IO_Error:
Last_SQL_Errno : 0
Last_SQL_Error:
1 row in set (0.00 sec)
</pre>
Het belangrijkste is dat dat state op 'Waiting for master to send event' en de volgende beide op 'yes' staan. (let op de state kan even duren voordat hij deze status krijgt)
<pre>
Slave_IO_State : Waiting for master to send event
Slave_IO_Running : Yes
Slave_SQL_Running: Yes
</pre>
Nu kan de goede host weer worden bijgeschakeld in de loadbalancer, want hij stuurt zijn wijzigingen door naar de ander database server. 
Nu moet nog alleen de replicatie van de gefaalde host naar de goede host ook hersteld worden. Op het inlezen van e database na is dit het zelfde concept. Denk eraan het IP adres in de CHANGE_MASTER goed te zetten!

==== voor de goede host ====
Nu moeten we ook op de voormalig gefaalde host een "show master status \g" doen. De gegevens van hier hebben we nodig om de replicatie naar de goede host weer op gang te brengen. ''' de waarde verschillen bijna elke keer als je het commando geeft'''
<pre>
mysql> show master status \g
+------------------+----------+-----------------------------------------------------------------+------------------+
| File | Position | Binlog_Do_DB | Binlog_Ignore_DB |
+------------------+----------+-----------------------------------------------------------------+------------------+
| mysql-bin.000012 | 4154828 | bas,lbtest,www-prod,www-test,hcc-gebruikers,hcc-gebruikers-test | mysql |
+------------------+----------+-----------------------------------------------------------------+------------------+
1 row in set (0.00 sec)
</pre>
Hierna starten we op de goede host de replicatie weer op halen bij de voormalig gefaalde DB server.
''(??wat wordt hier bedoeld??)''

<pre>
CHANGE MASTER TO MASTER_HOST='IP voormalig gefaalde DB server', MASTER_USER='repl', MASTER_PASSWORD='fxq5jLqWDYXYKhPD', MASTER_LOG_FILE='mysql-bin.000012', MASTER_LOG_POS=4154828 ;
</pre>
De master_log_file en _master_log_pos haal je op van de eerder gedane 'show master status' 
Hierna geef je het commando 'start slave;' 
Hierna kan je met het commando 'show slave status\G' zien of alles weer loopt, als het goed is ziet er dan ongeveer zo uit.
<pre>
mysql> show slave status\G
*************************** 1. row ***************************
Slave_IO_State: Waiting for master to send event
Master_Host: 172.31.1.214
Master_User: repl
Master_Port: 3306
Connect_Retry: 60
Master_Log_File: mysql-bin.000023
Read_Master_Log_Pos: 23081
Relay_Log_File: db01-int-relay-bin.000135
Relay_Log_Pos: 251
Relay_Master_Log_File: mysql-bin.000023
Slave_IO_Running: Yes
Slave_SQL_Running: Yes
Replicate_Do_DB:
Replicate_Ignore_DB:
Replicate_Do_Table:
Replicate_Ignore_Table:
Replicate_Wild_Do_Table:
Replicate_Wild_Ignore_Table:
Last_Errno: 0
Last_Error:
Skip_Counter: 0
Exec_Master_Log_Pos: 23081
Relay_Log_Space: 554
Until_Condition: None
Until_Log_File:
Until_Log_Pos: 0
Master_SSL_Allowed: No
Master_SSL_CA_File:
Master_SSL_CA_Path:
Master_SSL_Cert:
Master_SSL_Cipher:
Master_SSL_Key:
Seconds_Behind_Master: 0
Master_SSL_Verify_Server_Cert: No
Last_IO_Errno: 0
Last_IO_Error:
Last_SQL_Errno : 0
Last_SQL_Error:
1 row in set (0.00 sec)
</pre>
Het belangrijkste is dat dat 'state' op 'Waiting for master to send event' en de volgende beide op 'yes' staan (let op: de state kan even duren voor dat hij deze status krijgt).
<pre>
Slave_IO_State : Waiting for master to send event
Slave_IO_Running : Yes
Slave_SQL_Running: Yes
</pre>
Als ook dit in orde is kan je ook deze host weer bijschakelen in de loadbalancer.

= maximaal aantal connecties =
Op db01 en db02 berperken we het aantal connecties per gebruiker omdat nog wat gebruikers heel veel connecties blijven open en daar door de mysql server voor iedereen onbereikbaar maken.
Daarnaast is er ook ingesteld, dat als 180 seconden connectie niks doet hij getermineerd wordt.

De config die voor nodig is:
<pre>
#maximaal aantal connecties en hum time out waarde
max_connections = 1000
interactive_timeout = 180
wait_timeout = 180
</pre>
= offset =
Om te zorgen dat er tijdens de replicatie geen dubbele key's ontstaan (omdat beide server theoretisch precies tegelijk een mutatie kunnen uitvoeren) zit er een offset ingebouwd. 
Dit houdt in dat db01-int alle '''oneven''' nrs gebruikt en db02-int alle '''even''' nrs voor auto increment.
Db01 begint bij 1 en volgende 3 etcetera
Db02 begint bij 2 en volgende 4 etcetera

= Betekenis van de mysql-bin bestanden =
De bin log files zijn nodig voor replicatie en juist als er een down is geweest voor controle.

En dat de aantallen per server afwijken dat kan heel goed, het gaat er om hoeveel mutaties er op 1 server zijn uit gevoerd, dus het aantal kan en zal verschillen per server.

Het aantal bestanden wordt zelf door mysql gereguleerd en hangt vanaf van het aantal en grootte mutaties.
Log files ouder dan 10 dagen worden verwijderd.

Zeker als er veel Joomla updates zijn geweest en die zijn tegen 1 server aangehouden bijvoorbeeld op 22 october dan zullen daar veel meer en grote logs zijn.

root@mail-lb1:/var/log/mysql# ls -l | grep bin
-rw-r----- 1 mysql mysql 1180363 Oct 17 06:25 mysql-bin.000811
-rw-r----- 1 mysql mysql 1548726 Oct 18 06:25 mysql-bin.000812
-rw-r----- 1 mysql mysql 147778 Oct 18 17:59 mysql-bin.000813
-rw-r----- 1 mysql mysql 1045 Oct 18 18:11 mysql-bin.000814

= links =
http://www.hbyconsultancy.com/blog/create-a-master-master-mysql-replication-ubuntu-server-10-04-x64.html de handleiding die ik gebruikt heb in eerste instantie 
http://www.neocodesoftware.com/replication/ deze handleiding heb ik later gebruikt om het een en ander te verbeteren

Inventaris

2020-10-26T08:18:09Z

Hans: /* Inventaris overzicht. */

== Inventaris overzicht. ==

In dit overzicht behoort tenminste alle apparatuur voor te komen, die maximaal 3 jaar oud is.

De gegevens van deze pagina kunnen gebruikt worden als basis van het jaarlijks in te vullen hardware inventarisatie formulier, zoals dat door de penningmeester ieder jaar aan het hcc kantoor ter hand gesteld dient te worden.

{| border="1" cellpadding="2"
! datum aankoop || artikelomschrijving || serienummer || aankoopprijs || leverancier

|-


|30 oktober 2019

|''cisco-sw-01'' 
SG350X-48 48-Port Gigabit Stackable Managed Switch

|DNI2228066K
Factuur: [[Media:f-cisco-switch-2019-10-30.pdf]]

| € 362,81 ex BTW

| Azerty
|-


|30 oktober 2019

|''cisco-sw-02'' 
SG350X-48 48-Port Gigabit Stackable Managed Switch

|DNI22280660
Factuur: [[Media:f-cisco-switch-2019-10-30.pdf]]

| € 362,81 ex BTW

| Azerty
|-


|22 oktober 2020

|''cisco-sw-03-vlan999'' 
SX550X-24-K9-EU 
Cisco SX550X-24 24-Port 10GBase-T Stackable Managed Switch

|DNI243100NK
Factuur: [[Media:f-cisco-switch-2020-10-22.pdf]]

| € 2600,00 ex BTW

| infradax
|-


|22 oktober 2020

|''cisco-sw-04-vlan999'' 
SX550X-24-K9-EU 
Cisco SX550X-24 24-Port 10GBase-T Stackable Managed Switch

|DNI243100NL
Factuur: [[Media:f-cisco-switch-2020-10-22.pdf]]

| € 2600,00 ex BTW

| infradax
|-


|<strike>3 juli 2018</strike> 
september 2020

|''rt-01'' 
MikroTik CCR1016-12S-1S+ router

|<strike>6EFD087C1C40</strike> 912A0B49A749 
Factuur: [[Media:Mikrotik-CCR1016-12S-1S-router-1.pdf]]

| € 643,80 ex BTW

| KommaGo
|-


|10 juli 2018

|''rt-02'' 
MikroTik CCR1016-12S-1S+ router

|6EFD08521BE4
Factuur: [[media:Mikrotik-CCR1016-12S-1S-router-2.pdf]]

| € 643,80 ex BTW

| KommaGo
|-


|juni 2013

|''KVM'' 
* KV1416A-R2 
* Blackbox 16 ports KVM 
* [[Media:f-kvm2013.pdf]]

|13022015224 
[[Media:foto-srnr-kvm.jpg]]

| € 1.987 ex BTW

|Blackbox
|-


| 22 november 2017

| ''logging new'' 
* PRIMERGY RX1330 M3 
* 1x 8GB DDR4-2400 U ECC 
* Intel(R) Core(TM) i3-7100 CPU @ 3.90GHz 
* 60GB SATAdom 
* 2 x Gbit I210 Gigabit Network interface onboard 
* 4 x Gbit I350 Gigabit Network interface 

|
* Product serienummer : YMDH003824 
* Factuur: [[Media:lb-1-2-bit.pdf]] 

| € 1.396,26 ex BTW

| BIT, Ede
|-


| 22 november 2017

| ''LB2'' 
* PRIMERGY RX1330 M3 
* 1x 8GB DDR4-2400 U ECC 
* Intel(R) Core(TM) i3-7100 CPU @ 3.90GHz 
* 60GB SATAdom 
* 2 x Gbit I210 Gigabit Network interface onboard 
* 4 x Gbit I350 Gigabit Network interface 

|
* Product serienummer : YMDH003825 
* Factuur: [[Media:lb-1-2-bit.pdf]] 

| € 1.396,26 ex BTW

| BIT, Ede
|-


| 15 Augustus 2017

| ''vmware1'' 
* Fujitsu Primergy RX2530 M2 
* 4x 32GB DDR4-2400 U ECC (uitbreidbaar naar 12 per socket, upgradebaar naar 64GB per bank) 
* 4 x 900 GB SSD (raid 5) 
* Intel Xeon e5-2620 v4 @ 2.10GHz 8 cores 16 logical procesors 
* 4x1Gb T OC|14000-LOM netwerk interface 
* ILOm

|
* Product serienummer : YM6B011958 
* 3 jaar onsite garantie via BIT binnen 8 uur recovery
* Factuur: [[Media:f-bit-vmwar123.pdf]] 

| € 6.996,21 ex BTW

| Bit, Ede
|-


| 15 Augustus 2017

| ''vmware2'' 
* Fujitsu Primergy RX2530 M2 
* 4x 32GB DDR4-2400 U ECC (uitbreidbaar naar 12 per socket, upgradebaar naar 64GB per bank) 
* 4 x 900 GB SSD (raid 5) 
* Intel Xeon e5-2620 v4 @ 2.10GHz 8 cores 16 logical procesors 
* 4x1Gb T OC|14000-LOM netwerk interface 
* ILOm

|
* Product serienummer : YM6B011957 
* 3 jaar onsite garantie via BIT binnen 8 uur recovery
* Factuur: [[Media:f-bit-vmwar123.pdf]] 

| € 6.996,21 ex BTW

| Bit, Ede
|-


| 15 Augustus 2017

| ''vmware3'' 
* Fujitsu Primergy RX2530 M2 
* 4x 32GB DDR4-2400 U ECC (uitbreidbaar naar 12 per socket, upgradebaar naar 64GB per bank) 
* 4 x 900 GB SSD (raid 5) 
* Intel Xeon e5-2620 v4 @ 2.10GHz 8 cores 16 logical procesors 
* 4x1Gb T OC|14000-LOM netwerk interface 
* ILOm

|
* Product serienummer : YM6B011956 
* 3 jaar onsite garantie via BIT binnen 8 uur recovery
* Factuur: [[Media:f-bit-vmwar123.pdf]] 

| € 6.996,21 ex BTW

| Bit, Ede
|-


| juli 2018

| ''logging old'' 
* Fujitsu RX100 S6 
* 1x 8GB DDR4-2400 U ECC 
* Intel(R) Xeon(R) CPU X3430 @ 2.40GHz 
* 466GB disk 

|
YL8V001703

| € 0 ex BTW (gift)

| BIT, Ede
|-


| 14 februari 2013

| ''Powerboot-1'' 
APC AP8959EU3 
* 24 schakelbare 230V poorten 

| ZA1238010076

| € 755 ex BTW

| Acesdirect
|-


| 14 februari 2013

| ''Powerboot-2'' 
APC AP8959EU3 
* 24 schakelbare 230V poorten 

| ZA1238010081

| € 755 ex BTW

| Acesdirect
|}

== Afgeschreven apparatuur, niet meer in het rack, niet meer in gebruik ==

{| border="1" cellpadding="2"
! datum aankoop || artikelomschrijving || serienummer || aankoopprijs || leverancier

|-

|

|


|



|

|-

|-

LDAP scripting

2020-09-24T10:44:35Z

Hans:

=Inleiding=
Omdat de ldap server in sneltreinvaart de bron voor allerlei services aan het worden is, ontstaat er ook een migratie van (veelal perl) scripts op scripting-int naar php scripts op ldap-lb1-int. ldap-lb1-int is net als scripting-int een server met verhoogde security. Er mag dus wel '''van''' deze server '''naar''' andere servers geconnect worden maar niet andersom. Dit is vergelijkbaar met de situatie op scripting-int. Deze mogelijkheid is essentieel voor de goede werking van sommige scripts.

==Type scripts==
Er zijn globaal een aantal soorten scripts te onderscheiden:
* De eigenlijke scripts die een bepaalde taak uitvoeren en vaak naar stdout schrijven (.php soms geen extensie).
* De cronjob scripts. Gewoonlijk herkenbaar aan de '''.sh''' extensie. Deze scripts bundelen vaak meerdere php scripts tot complete oplossingen.
* Scripts die voor initialiseren en backuppen van de ldap directory nodig zijn ('''init_ldap, dump_ldap en restore_ldap'''). Behalve dump_ldap mogen deze scripts nooit zomaar gedraaid worden; de ldap directory zou vernield worden.

==Overzicht scripts==
<pre>
0_DIT_IS_EEN_LOCAL_DIR gen_passwd_admin.php LDAP_include.php sync_hccforums.php
cron_joomla.php gen_passwd_code2.php LDAP_include_telefoon.php sync_hobbynetbin_2.sh
cron_joomla.sh gen_passwd_hcc.php LDAP_lid_weg.php sync_hobbynetdata_2.sh
database-onderhoud.sh gen_shadow_admin.php _LDAP_schoon_4045431_op.php sync_hobbynetetc_2.sh
dump_ldap.sh gen_shadow_code2.php LDAP_schoon_database.php sync_hobbynetfw_2.sh
enquete-specials gen_shadow_hcc.php LDAP_schoon_mysql_op.php sync_hobbynetlib_2.sh
forum-specials get_all_mailbox_sizes.sh LDAP_vul_leden.php tel_unieke_bezoekers-volgens-LDAP_en_SQL.php
gen_bezoekersstatistiek_xml.php get_ip4 LDAP_vul_leden_vanuit_HCCLeden.php tel_unieke_bezoekers-volgens-LDAP.php
gen_compusers_csv.php get_ip6 LDAP_vul_locaties.php tel_unieke_bezoekers-volgens-LDAP.sh
gen_dmarc_hcc.php getip-http LDAP_vul_profielbekend.php test.php
gen_group_admin.php getupdatesites_joomla.php mailman-specials unblock_joomla.php
gen_group_code2.php getupdatesites_joomla.sh mail_tripolis_export_report.sh unblock_joomla.sh
gen_group_hcc.php hccforums_db.php mail_tripolis_import_report.sh update_domeinen.php
gen_hobbyabon.php huisgenoot_lidmaatschappen.php optouts update_domeinen.sh
gen_iplist_partners.php huisgenoot_lidmaatschappen.sh other-specials update_hccforums.sh
gen_iplist_partners.sh import_tripolis_csv.php popbull-specials update_joomla.php
gen_kader_csv.php init_ldap_mdb.sh postcode-specials update_joomla.sh
gen_kaderfunc.php init_ldap.sh purge_hccforums.php update_joomla.sh.save
gen_kaderlist.php kader_maak_html.php renameusers_joomla.php upd_code2_accounts.sh
gen_ldap_bul_export.php kader_maak_lijsten.sh renameusers_joomla.sh upd_hcc_accounts.sh
gen_ldap_cor_export.php kader_maak_txt.php restore_ldap.sh upd_ldap_dev.sh
gen_ldap_hoofdbestuur_export.php kader_maak_xb_csv.php rss_joomla.php upd_ldap-test-dev.expect
gen_ldap_kader_export.php LDAP_bepaal_startconditie.php rss_joomla.sh upd_ldap_test.sh
gen_ldap_ledenraad_export.php ldap.conf.ldif ruimsmsverstuurdsmsop.sql upd_mailserver_report.sh
gen_ldap_niet_leden_export.php LDAP_controleer_groeperingen.php run_maand_rapport.sh upd_mailserver.sh
gen_leden_csv.php LDAP_controleer_kader.php run_tripolis_export.sh upd_nameserver.sh
gen_leden_dubbel.log LDAP_cronjob.sh run_tripolis_import.sh upd_srv
gen_leden_dubbel.php LDAP_forceer_CSV.sh schoon_alles_op_include.php upg_vmware_tools
gen_maand_rap.php LDAP_ftps_lget_CRM_leden.sh schoon_alles_op.sh upload_bezoekersstatistiek.sh
gen_maand_rap.php.old LDAP_herstel_profielbekend.php schoon_breg_token_tabel_op.php upload_compusers_csv.sh
gen_mail_exclude_txt.php LDAP_include_henz.php schoon_forms_database_op.php upload_kader_csv.sh
gen_mx_hcc.php LDAP_include_ISO.php schoon_JoomlaTokens_tabel_op.php upload_leden_csv.sh
gen_mx_hcc.php.backup LDAP_include_Joomla_db.php schoon_LDAP_en_hcc_Bezoek_op.php vergelijk_scripts.readme
gen_mx_hcc.php.save LDAP_include_mail.php statistiek_xml.php verrijk_factuur.php
gen_mx_hobby.php LDAP_include_pbkdf2.php statistiek_xml.sh verrijk_factuur.sh
</pre>

==Crontab==
<pre>
# For more information see the manual pages of crontab(5) and cron(8)
##############################################################################################################
# Wijzigingen graag ook aanbrengen op deze wiki pagina: https://wiki.hobby.nl/index.php?title=LDAP_scripting #
##############################################################################################################
# m h dom mon dow command

# Update rssfeeds joomla
1 */1 * * * /usr/local/hobbynet/bin/rss_joomla.sh >>/var/log/rss_joomla.log

# Synchroniseer firewall regels van ldap-lb1 naar ldap-lb2
55 5 * * * /usr/local/hobbynet/bin/sync_hobbynetfw_2.sh
55 11 * * * /usr/local/hobbynet/bin/sync_hobbynetfw_2.sh
55 17 * * * /usr/local/hobbynet/bin/sync_hobbynetfw_2.sh
55 23 * * * /usr/local/hobbynet/bin/sync_hobbynetfw_2.sh

# Herstart Firewall
0 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
0 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
0 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
0 0 * * * /etc/init.d/hobby-firewall restart >/dev/null

# Check op updates en download deze alvast ivm Nagios detectie
0 6 * * * apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y >/dev/null
0 18 * * * apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y >/dev/null

# Maak een beveiligde backup
45 23 * * * /usr/local/hobbynet/local/backup-encrypted.bash >>/var/log/backup_encrypted.log

# Sync bin dir naar ldap-lb2
50 23 * * * /usr/local/hobbynet/bin/sync_hobbynetbin_2.sh
# Sync etc dir naar ldap-lb2
51 23 * * * /usr/local/hobbynet/bin/sync_hobbynetetc_2.sh
# Sync lib dir naar ldap-lb2
52 23 * * * /usr/local/hobbynet/bin/sync_hobbynetlib_2.sh

# Voer de cron_joomla.sh cronjob uit voor de bit backup
01 0 * * * /usr/local/hobbynet/bin/cron_joomla.sh >>/var/log/cron_joomla.log

# Voer de cron_joomla.sh cronjob uit voor 'update_joomla.sh'
15 1 * * * /usr/local/hobbynet/bin/cron_joomla.sh >>/var/log/cron_joomla.log

# Forceer dat er een verse set CSV bestanden klaar wordt gezet
05 3 * * * /usr/local/hobbynet/bin/LDAP_forceer_CSV.sh >/dev/null

# Doe alle processing CRM->LDAP
10 3 * * * /usr/local/hobbynet/bin/LDAP_cronjob.sh >>/var/log/LDAP_cronjob.log

# Maak /usr/local/hobbynet/apache2conf/iplists/iplist-partners-24 aan
7 3 * * * /usr/local/hobbynet/bin/gen_iplist_partners.sh

# Ververs postfixadmin op mail-lb1 en mail-lb2. Mail report
26 3 * * * /usr/local/hobbynet/bin/upd_mailserver.sh >/var/log/upd_mailserver.log
30 3 * * * /usr/local/hobbynet/bin/upd_mailserver_report.sh

# Haal de opt-outs op van Tripolis
15 3 * * * /usr/local/hobbynet/bin/run_tripolis_import.sh >/var/log/run_tripolis_import.log

# Haal de handmatige Tripolis opt-outs op, en mail die naar Egbert
31 3 * * * /usr/local/hobbynet/bin/mail_tripolis_import_report.sh

# Maak en plaats de ledenlijst voor Kantoor
35 3 * * * /usr/local/hobbynet/bin/upload_leden_csv.sh >/dev/null

# Maak en plaats de kaderlijst voor Kantoor
40 3 * * * /usr/local/hobbynet/bin/upload_kader_csv.sh >/dev/null

# Deblokkeer actieve joomla gebruikers
45 3 * * * /usr/local/hobbynet/bin/unblock_joomla.sh >>/var/log/unblock_joomla.log

# Haal de aantallen bezoekers, en zet die over naar de beschermde kantoor omgeving
47 3 * * * /usr/local/hobbynet/bin/upload_bezoekersstatistiek.sh >/dev/null

# Maak overzicht van alle opt-ins voor Tripolis
50 3 * * * /usr/local/hobbynet/bin/run_tripolis_export.sh >/var/log/run_tripolis_export.log

# Hernoem in Joomla de users die zijn hernoemd in ldap
50 3 * * * /usr/local/hobbynet/bin/renameusers_joomla.sh >>/var/log/renameusers_joomla.log

# Haal het resultaat van de Tripolis export op, en mail die naar Egbert
52 3 * * * /usr/local/hobbynet/bin/mail_tripolis_export_report.sh

# Maak en plaats statistiek overzicht van alle HCC groeperingen
55 3 * * * /usr/local/hobbynet/bin/statistiek_xml.sh >/dev/null

# Start joomla onderhoud
0 4 * * * /usr/local/hobbynet/bin/update_joomla.sh >>/var/log/update_joomla.log

# Doe de Hobbynet maand rapportage
0 4 1 * * /usr/local/hobbynet/bin/run_maand_rapport.sh >/dev/null

# Bepaal het aantal unieke (en totaal aantal) bezoekers van de laatste 12 maanden, mail dat aan VB
5 4 1 * * /usr/local/hobbynet/bin/tel_unieke_bezoekers-volgens-LDAP.sh >/dev/null

# Maak een lijst van onjuiste huisgenoot-lidmaatschappen
10 4 1 * * /usr/local/hobbynet/bin/huisgenoot_lidmaatschappen.sh >/dev/null

# Schoon mySQL en LDAP op
5 4 2 * * /usr/local/hobbynet/bin/schoon_alles_op.sh

# Verrijk een naar SFTP geupload factuur bestand met factuurtokens
15 * * * * /bin/bash /usr/local/hobbynet/bin/verrijk_factuur.sh >>/var/log/verrijk_factuur.log

# ruim sms database op
42 12 * * * cat /usr/local/hobbynet/bin/ruimsmsverstuurdsmsop.sql |mysql >/dev/null
</pre>

=Toepassingen=
Soms zijn er een aantal scripts die bij elkaar horen en er voor een bepaalde toepassing zijn, zoals om de mailserver te updaten, dagelijkse bestanden voor Kantoor te maken, dagelijkse bestanden voor het Tripolis mail systeem en niet geheel onbelangrijk, scripts die ldap dagelijks bijwerken met de '''master''' data die in het HCC CRM wordt bijgehouden (als er een mutatie gemist is, b.v. omdat een JSON aanroep vanuit het CRM naar de Hobbynet XML-RPC server overdag mislukt is).

==LDAP==
Drie scripts zijn essentieel om de hele LDAP database te dumpen, te initialiseren en weer te vullen. Dit proces is nodig als een schema change moet worden aangebracht in de LDAP configuratie. Zie ook de pagina over de LDAP server.
* '''dump_ldap.sh''' Dumpt alle ou's in afzonderlijke ldif bestanden in de data directory en maakt er ook een tarball van.
* '''init_ldap.sh <beheer-password>''' Bouwt de hele LDAP structuur van de grond af op.
* '''restore_ldap.sh''' Vult de hele LDAP structuur met file uit de dump_ldap stap.

==Statistieken==
Iedere nacht worden er door het script '''statistiek_xml.sh''' van alle groeperingen en van de complete HCC leden database statistieken in XML formaat gemaakt. Daarna worden deze statistieken met het script '''statistiek_xml.sh''' naar de kadernet server overgezet.

==Mailserver==
<strike>De mailserver kreeg tot voor kort 2 bestanden van scripting-int, husers en b3a.txt. De inhoud van beide bestanden kan ook uit ldap gehaald worden. Hiervoor zijn de volgende scripts in gebruik:</strike>
* <strike>'''gen_hobbyabon.php'''. Dit script maakt een equivalent aan van husers en bevat alleen de betalende Hobbynet abonnees (enige tientallen regels).</strike>
* <strike>'''gen_kaderfunc.php'''. Dit script is de vervanger van b3a.txt, de lijst van alle kaderfuncties (ongeveer 1200).</strike>
* <strike>'''gen_kaderlist.php'''. Een hulp bestand met alleen de 7 cijferige lidnummers van alle kaderleden (ruim 700). Deze lijst wordt op de mailserver gebruikt om incidenteel kadermailboxen op te ruimen.</strike>
* <strike>'''gen_mail_exclude_txt.php'''. Nog een hulp bestand waar in de interessegroepen staan die geen functionele mailadressen nodig hebben. Dit zijn vooral de ig's die geen echte ig zijn zoals de HCC zelf en de RvA en RvT maar wel als zodanig in ldap staan. Ook de cursus presentatoren vallen hieronder.</strike>
* '''upd_mailserver_report.sh'''. Dit script mailt de dagelijkse logs ter controle of alles goed is gegaan.
* '''upd_mailserver.sh'''. Bundelt de php scripts tot een cronjob die elke nacht loopt. Dit script draait de 4 php scripts, doet wat na bewerking, kopieert de output naar mail-lb1-int en start '''upd_mailserver_all''' op mail-lb1-int. Tenslotte worden nog de relay-domains opgehaald van mail-lb1-int (dat bestand is pas up-to-date nadat upd_mailserver_all op mail-lb1-int heeft gelopen).Hierna is mail-lb2 nog niet geheel up-to-date. Het script dat door ldap-lb1 is gestart, doet aan het eind een rsync van de datadir op mail-lb1 naar mail-lb2. Tenslotte start mail-lb1 een script op mail-lb2 om die ook up-to-date te maken. Dit is dus een drietraps systeem.

==Mailman==
<strike>Omdat ter zijner tijd een aantal Mailman mailinglijsten naar Tripolis gaan, is een script gemaakt om de Mailman info over de abonnees op te halen. Om aan die summiere gegevens te herkennen of iemand lid of niet-lid is een php script gemaakt (te vinden in mailman-specials).</strike>
* <strike>'''import_mailman_lists.sh''' Haalt de abonnee gegevens op. Er is een aanroep in dit script van een script op de mailserver. Dat script maakt bestanden aan met zinvolle namen. Die worden opgehaald en worden in de lokale data (sub)directory geplaatst.</strike>
* <strike>'''import_mailman_csv.php''' Leest alle opgehaalde bestanden in de lokale data (sub)directory, maakt zo nodig niet-leden aan en plaatst '''optins''' voor de locatie bulletins bij de leden en de niet-leden. Het bepalen van lid of niet-lid gebeurt puur op email adres. Als een lid op een mailinglist staat meteen adres dat '''niet''' in zijn record in LDAP staat, wordt er een niet-lid record aangemaakt! Het netto effect is dat dit lid het bulletin dubbbel zal ontvangen.</strike>

==Maandrapportage==
* '''gen_maand_rap.php'''. Verzamelt alle data van Hobbynet abonnees en alle andere users in ldap. Optie '''-m''' mailt naar de accounthouder in het ldap record. Sinds medio 2020 krijgen hcc groepering webmasters deze mail niet meer, omdat ze nu allemaal gebruik maken van een Joomla template site, en daar geen 'eigenaar' meer van zijn.
* <strike>'''gen_pc30_maand_rap.php'''. Mailt specifiek de gegevens van de PC30 agents naar de teamleider.</strike>
* '''run_maand_rapport.sh'''. Cronjob die bovenstaande scripts 1x per maand draait.

==Passwd, shadow en group==
<strike>
* gen_group_admin.php
* gen_group_code2.php
* gen_group_hcc.php
* gen_passwd_admin.php
* gen_passwd_code2.php
* gen_passwd_hcc.php
* gen_shadow_admin.php
* gen_shadow_code2.php
* gen_shadow_hcc.php
* upd_admin_accounts.sh (is er niet)
* upd_code2_accounts.sh
* upd_hcc_accounts.sh

Deze scripts genereren de passwd, shadow en group entries voor de betalende leden (_code2), de admins (_admin, de lagere goden, op het moment niet gebruikt; er is wel een .hobby met alleen Roel v.d. Bussche erin) en voor de HCC groeperingen (_hcc). De output wordt op de shared etc omgeving neergezet zodat elke (web)server ze kan toevoegen aan de passwd.temp/shadow.temp/group.temp files. Hiervoor wordt de lokale job upd_usr (of upd_hobby_only) gedraaid.
</strike>

==HCC Verenigingsbureau==
Het HCC Verenigingsbureau ('VB') heeft beschikking over een ledenlijst en een kader/kernledenlijst die dagelijks up-to-date zijn. Deze lijsten zijn in CSV formaat zodat men zelf in de hand heeft hoe het bestand gebruikt wordt. Ze worden dagelijks op de Hobbynet sftp server (dedicated server t.b.v. gebuik vanaf het VB) geplaatst.

Daarnaast krijgt VB iedere dag een actueel overzicht van de aantallen bezoekers (bezoekers statistiek).

* '''upload_kader_csv.sh''' de cronjob
* '''gen_kader_csv.php''' het php script dat een bestand in CSV formaat maakt met de door VB gewenste velden.
* '''upload_leden_csv.sh''' de cronjob
* '''gen_leden_csv.php''' het php script dat een bestand in CSV formaat maakt met de door VB gewenste velden.
* '''upload_bezoekersstatistiek.sh''' de cronjob
* '''gen_bezoekersstatistiek_csv.php''' het php script dat een bestand in CSV formaat maakt met de bezoekersstatistieken.

==CompUsers==
2020: VB heeft 'eigen' afspraken met CU gemaakt, en stuurt ze op eigen houtje zomaar ledenbestanden toe. Onze scripts zijn daarmee zinloos geworden.

<strike>Met CompUsers zijn speciale afspraken gemaakt door Kantoor in januari 2014. Zij krijgen een sterk verkorte lijst van ALLE leden voor hun administratie. Het streven is dit zo spoedig mogelijk te vervangen door een ander mechanisme zoals de partner check.

* '''upload_compusers_csv.sh''' de cronjob
* '''gen_compusers_csv.php''' het script dat een CSV maakt. Dit is een afgeslankt vorm van het '''gen_leden_csv.php''' script.</strike>

=Koppeling met Tripolis=
Het oude "popbull" systeem dat bij HenZ draait is in de zomer van 2013 vervangen door Tripolis. Tripolis wordt al jaren gebruikt door kantoor voor het versturen van Digizine en de Nieuwsflash. Per groepering wordt een account aangemaakt met beperkte rechten waar mee de Correspondent van de groepering mailings kan versturen. Om Tripolis en ldap in sync te houden wordt er elke nacht data uitgewisseld. Ldap is leidend in deze maar als mensen zich uitschrijven (opt-out) via de knop onder aan de mailing, moet dat doorgegeven worden aan ldap.

==Sync van Tripolis naar ldap==
* '''run_tripolis_import.sh''' de eigenlijke cronjob
* '''import_tripolis_csv.php''' vertaalt de CSV van opt-outs naar het wissen van de individuele optins.

Tripolis plaatst elke nacht om 00:01 een CSV bestand met de opt-outs per bulletin van de vorige dag. Dit gebeurt met datums. Als de datum van gisteren ingevuld staat is daar een optout geweest. Als er geen opt-outs zijn, bevat het veld slechts een lege string. Het bestand wordt naar de ldap server gehaald waar een aantal versies bewaard worden. De bestanden wordt verwijderd van de sftp omgeving. Vervolgens worden het gedownloade bestand verwerkt om bij het lid de hccOptIn van dit bulletin te verwijderen.

==Sync van ldap naar Tripolis==
* '''run_tripolis_export.sh''' de eigenlijk cronjob
* '''gen_ldap_bul_export.php''' maakt een volledige lijst aan van emailadres, lidnr en optins. Dit bestand gaat naar de sftp omgeving van Tripolis.
* '''gen_ldap_cor_export.php''' maakt een lijst van alle correspondenten voor kantoor. Dit bestand gaat naar de sftp omgeving van Kantoor.

Het export bestand wordt elke nacht (om 02:50) op de sftp omgeving voor Tripolis klaargezet. Tripolis haalt het om 05:00 op. Omdat de opt-outs van Tripolis om 02:15 verwerkt worden, is dit bestand dus al bijgewerkt voor wat betreft die opt-outs. Alle andere wijzigingen komen van de hcc.nl profielpagina's of mutaties door derden op ldap (mutaties door Hobbynet staff of PC30).

==Rapportage==
<strike>Om ook de ledenadministratie in te lichten over leden die een optout op één of meer Tripolis mailings hebben gedaan, wordt na het verwerken van de optouts een mail gestuurd naar ledenadministratie@hcc.nl. Elke dag is er een nieuwe log file maar die wordt door dezelfde cronjob aan een archive geplakt. Zie mail_tripolis_reports.sh.</strike>

Egbert laat zich iedere nacht een rapportage mail sturen, zie mail_tripolis_export_report.sh.

==Eénmalige jobs==
Er zijn een aantal php scripts voor éénmalig gebruik gemaakt. Deze worden niet in de cronjobs gebruikt maar waren slechts bedoeld om de lijsten opgeleverd door VB in LDAP te krijgen. Deze scripts zijn in de subdirectory '''popbull-specials''' geplaatst.
* '''import_digizine_csv.php''' de initiële Digizine lijst
* '''import_nieuwsflash_csv.php''' de initiële Nieuwsflash lijst
* '''import_popbull_csv.php''' de initiële lijst zoals die van HenZ (popbull provider) komt

=ISIZ enquête=
Op verzoek geschreven scripts voor eenmalig gebruik. Terug te vinden in in de '''enquete-specials''' subdirectory.
* '''gen_enquete_csv.php''' enquête per email
* '''gen_enquete_csv_no_mail.php''' enquête per post

=Nameserver=
* gen_mx_hcc.php
* gen_mx_hobby.php
* upd_nameserver.sh

=Firewall (op ldap servers)=
* gen_xml_fw_ip4.php
* gen_xml_fw_ip6.php
* sync_hobbynetfw.sh
* gen_fw.sh

MediaWikiSites

2020-08-30T15:55:57Z

Hans: /* upgrade procedure */

== Lijst met Mediawiki sites die wij bijhouden ==

* Hobbynet wiki (https://wiki.hobby.nl/)

== upgrade procedure ==
* maak met tar een backup van de wiki: 
cd /disk/site/wiki
tar -cf wiki-backup-20200830.tar www
bzip2 wiki-backup-20200830.tar

* maak met phpmyadmin een backup van de database 

* download de wiki software upgrade van http://www.mediawiki.org/ 

* volg de instructies zoals beschreven op http://www.mediawiki.org/wiki/Manual:Upgrading 

=== Hobbynet wiki updaten ===
* Volg de instructies om de wiki te updaten
Ons eigen lijstje:

cd /disk/site/wiki
rm -rf www-old
cp -a www www-old
wget https://releases.wikimedia.org/mediawiki/1.34/mediawiki-1.34.2.tar.gz
tar xzf mediawiki-1.34.2.tar.gz
chown wiki-hobby-nl:www-hobby-nl mediawiki-1.34.2 -R
cp -a www-old/LocalSettings.php mediawiki-1.34.2
cp -a www-old/images/* mediawiki-1.34.2/images
cp -a www-old/getip* mediawiki-1.34.2
rm -rf www
mv mediawiki-1.34.2 www
cd www/maintenance
php update.php

Op 2020.08.30 weigerde de update correct te lopen. Bleek dat er geen skins meer waren, en de extensie WikiEditor ontbrak ook.
Pas na het terugzetten van die bestanden uit de oude omgeving wilde het update script draaien
cp -a ../../www-old/skins/MonoBook ../skins/
cp -a ../../www-old/skins/Vector/ ../skins/
cp -a ../../www-old/skins/Timeless/ ../skins/
cp -a ../../www-old/extensions/WikiEditor ../extensions/
php update.php

* Als update.php niet draait, omdat er geen sql modules beschikbaar zouden zijn, selecteer dan eerst de juiste php versie
update-alternatives --config php

* Op de hobbynet wiki staan 2 losse bestanden die geen directe relatie met de wiki software hebben ('''getip.html''' en '''getip.php'''). 
Plaats die bestanden terug, tijdens de wiki upgrade actie!

MediaWikiSites

2020-08-30T15:55:17Z

Hans:

== Lijst met Mediawiki sites die wij bijhouden ==

* Hobbynet wiki (https://wiki.hobby.nl/)

== upgrade procedure ==
* maak met tar een backup van de wiki: 
cd /disk/site/wiki
tar -cf wiki-backup-20200405.tar www
bzip2 wiki-backup-20200405.tar

* maak met phpmyadmin een backup van de database 

* download de wiki software upgrade van http://www.mediawiki.org/ 

* volg de instructies zoals beschreven op http://www.mediawiki.org/wiki/Manual:Upgrading 

=== Hobbynet wiki updaten ===
* Volg de instructies om de wiki te updaten
Ons eigen lijstje:

cd /disk/site/wiki
rm -rf www-old
cp -a www www-old
wget https://releases.wikimedia.org/mediawiki/1.34/mediawiki-1.34.2.tar.gz
tar xzf mediawiki-1.34.2.tar.gz
chown wiki-hobby-nl:www-hobby-nl mediawiki-1.34.2 -R
cp -a www-old/LocalSettings.php mediawiki-1.34.2
cp -a www-old/images/* mediawiki-1.34.2/images
cp -a www-old/getip* mediawiki-1.34.2
rm -rf www
mv mediawiki-1.34.2 www
cd www/maintenance
php update.php

Op 2020.08.30 weigerde de update correct te lopen. Bleek dat er geen skins meer waren, en de extensie WikiEditor ontbrak ook.
Pas na het terugzetten van die bestanden uit de oude omgeving wilde het update script draaien
cp -a ../../www-old/skins/MonoBook ../skins/
cp -a ../../www-old/skins/Vector/ ../skins/
cp -a ../../www-old/skins/Timeless/ ../skins/
cp -a ../../www-old/extensions/WikiEditor ../extensions/
php update.php

* Als update.php niet draait, omdat er geen sql modules beschikbaar zouden zijn, selecteer dan eerst de juiste php versie
update-alternatives --config php

* Op de hobbynet wiki staan 2 losse bestanden die geen directe relatie met de wiki software hebben ('''getip.html''' en '''getip.php'''). 
Plaats die bestanden terug, tijdens de wiki upgrade actie!

Main Page

2020-08-18T11:36:31Z

Hans: /* joomla */

===Informatie tbv beheer bit===
[[CRM_omgeving]] - de crm omgeving

===Hobbynet Admin WIKI===
Shortcuts
[http://otrs.hobby.nl/ HobbyNet Ticket systeem] - OTRS
[https://nagios.hobby.nl/nagios Nagios monitoring] -[[Nagios|''' Uitleg''']]
[https://wiki.hobby.nl/getip.html Waar draait een website] - simpel tooltje om te kijken waar een website draait.

===Algemene informatie===
[[HCC!Hobbynet]] - Wat is Hobbynet - een uitleg voor kantoor (zie ook discussie tab)
[[HCC!verenigingsdag]] - Een draaiboek voor de HCC!verenigingsdag
[[Evenementen lan]] - Een draaiboek voor een Evenementen LAN
[[Kadernet]] - Info over Kadernet voorzieningen (website, forum, etc.)
[[Financien]] - Financiële aspecten van Hobbynet
[[inventaris]] - Hobbynet inventaris overzicht t.b.v. hcc kantoor
[[Windows_licenties]] - Hobbynet overzicht van de windows licenties
[[Beheerders]] - Hobbynet beheerders
[[server_certs]] - Hobbynet CAcert certificaten
[[Hobbykeys]] - Info over het hobbykeys script
[[accounts]] - Diverse account gegevens (o.a. knoppix.nl)

===HCC.NL website platform===
hcc.nl [[netwerk]] - Netwerk voor hcc.nl website platform
[[XML-RPC]] - XML-RPC interface t.b.v. LDAP
[[XML-HENZ-PROXY]] - XML-RPC HenZ proxy t.b.v. cronjob toegang tot HenZ
2017.02.02: Moet dringend bijgewerkt worden:
[[www-test-lb*]] - Test servers (loadbalanced)
[[www-prod-lb*]] - Productie servers (loadbalanced)
[[Protocol_onderhoud]] - Afspraken rondom onderhoud en meldingen aan hcc.nl webmasters

===Toegang===
[[Speciale VPN toegang]] - Speciale VPN toegang (verouderde info)
[[KVM over IP]] - Beheer op afstand m.b.v. KVM over IP apparatuur
[[Serial Console Server]] - Serial Console Server voor het beheer van netwerk aparatuur met seriele interface
[[beheerder_accounts]] - Beheerder accounts aanmaken / bijhouden
[[Aanmaken_Gebruiker]] - Aanmaken van een gebruiker
[[Opzeggen_Gebruiker]] - Opzeggen van een gebruiker

===Algemene services===
[[Backup]] - Zo backupen we
[[scp]] - Hobbynet filetransfer omgeving
[[Scp-lb1]] - Direct naar scp-lb1.hobby.nl
[[Scp-lb2]] - Direct naar scp-lb2.hobby.nl
[[EMAIL]] (ook postfixadmin) - Email server documentatie
[[Roundcube Webmail]] - Upgrading Roundcube
[[LDAP]] (server en client) - LDAP setup
[[LDAP login Authenticatie]] - Om op (web)servers login via LDAP te doen
[[LDAP scripting]] - Scripting die op ldap-lb1 draait
[[LDAP Administrative account]] weg! - Hoe te handelen als hetadministrative account opeens weg is
[[LDAP groeperings vlaggen]] - Welke vlaggen zijn er voor een groepering en waar dienen ze voor
[[SFTP server]] - sftp server voor uitwisseling met kantoor en tripolis
[[Speciale groepen in ldap en CRM]] - Speciale groepen in ldap en CRM
[[PXE]] - Hobbynet PXE omgeving
[[Storage cluster 2020]] - Beschrijving van het '''nieuwe''' storage cluster Storage cluster 2020
[[Storage cluster]] - Beschrijving van het oude storage cluster
[[MySQL cluster]] - Beschrijving van het MySQL cluster
[[MySQL settings]] - MySQL instellingen
[[Web cluster]] - Beschrijving van het Web cluster
[[Loadbalancers]] - Beschrijving van de LoadbalancerNG
[[Nagios]] - Beschrijving van Nagios
[[Nagios_upgrade]] - Hoe upgrade ik nagios van uit source
[[Hobbynet repository]] - Informatie over de hobbynet repository
[[Hobbynet repository inhoud]] - Wat zit er in de hobbynet repository
[[Cron jobs]] - Niet standaard cronjobs die lopen bij hobbynet
[[Fail2ban]] - Block possible intruders and bots
[[Groepering_hernoemen]] - Beschrijving van het hernoemen van een groeperingsnaam
[[killdisk]] - Software voor secure wissen van disken
[[Wij jitsi server]] - HCC jitsi server
[[VMware installatie]] - Handige hulpjes bij installatie vmware

=== dns ===
[[DNS]] - DNS instellingen t.b.v. de domeinen
[[ns-master]] - Direct naar ns master (draait op [[domein]])
[[ns1]] - Direct naar ns1.hobby.nl
[[ns2]] - Direct naar ns2.hobby.nl
[[ns3]] - Direct naar ns3.hobby.nl (bij TransIP)
[[Resolv*-int]] - Direct naar resolv nameserver pagina (draait op [[resolv-lb1]] en [[resolv-lb2]])
[[DNSSEC]] - DNSSec
[[DNSSEC ds records publiceren]] - Scripting t.b.v. het publiceren van DNSSEC DS records. Dump van scripts... zinloos
[[DNS scripting]] - Overige DNS scripting
[[DNS Zone updaten]] - een zone updaten
[[Dane]] - Dane records in dns (wat moet je doen bij nieuw ssl cert)

=== Joomla ===

[[Nieuwe joomla site maken]] - Nieuwe Joomla site maken
[[Joomla_xml_server]] - De XML-RPC-server t.b.v. de Joomla template sites
[[Joomla modules]] - Beschrijving van Joomla modules en processen er om heen
[[Joomla Events RSVP Pro]] - RSVP Pro configureren (beperk bijeenkomst tot x personen)

===Uitleg IP space===
[[netwerk]] - Netwerk tekening van Hobbynet
[[IPv4_space|IPv4]] - IPv4 Hobbynet
[[Ipv6_space|IPv6]] - IPv6 Hobbynet

===Kast indeling===
[[kasten]] - Indeling kasten bij BIT ''(pagina heeft onderhoud nodig)''
[[systems]] - Alle systemen van Hobbynet (hardware & netwerk)
[[Powerboot]] - Indeling APC PDU's (feb. 2013)

===Tuning webservers===
[[Hobby-firewall]] - de Hobbynet firewall
[[PHP via fcgi]] - PHP via fcgi en suexec
[[suhosin]] - Suhosin (hardened PHP) op Apache webservers
[[upg_web]] - Door middel van script server upgraden
[[Aanpassingen hcc.nl webservers|hcc.nl aanpassingen]] - aanpassingen, gedaan voor hcc.nl op www-test-lb* www-prod-lb*

[[NFS_settings]] - NFS poort instellingen t.b.v. iptables firewall
[[sync Loadbalanced webservers]] - dit script zorgt dat webserver configs worden gesynct
[[Entropy]] - Hoe zorg ik voor meer Entropy op vmware machine

===VPS voor derden===
[[Ubuntu-nl]] - De Ubuntu-nl virtuele server

=== Hobbynet informatie ===
[[Scripting]] - Een poging om de scripting te beschrijven. WIP!
[[agreements]] - Alle Hobbynet contracten met contract beheerder e.d.
[[ToDo]] - Een wensenlijstje van dingen die we kunnen veranderen/verbeteren
[[Systemlog]] - Log file van relevante wijzigingen aan diverse servers

===Updaten===
[[Joomlasites]] - Joomla sites die wij bijhouden
[[MediaWikiSites]] - MediaWiki sites die wij bijhouden

===Nood gegevens===
[[Medische protocol Bas|Medisch protocol bas]] - Medisch protocol bas

Dit is een "mediawiki" (http://www.mediawiki.org/). 
Uitleg over het editen is te vinden op: 
http://meta.wikimedia.org/wiki/MediaWiki_User%27s_Guide 
http://en.wikipedia.org/wiki/Wikipedia:How_does_one_edit_a_page

LDAP

2020-08-12T09:58:52Z

Hans:

==Introductie==
Om een centrale plaats te hebben om authenticatie te doen voor www.hcc.nl en sub-sites zoals een forum, is gekozen voor het gebruik van een LDAP database/directory. Hierin wordt alles opgeslagen wat nodig is voor het functioneren van de site, inclusief NAW gegevens <strike>die op dit moment alleen opgeslagen worden t.b.v. het PC30 beheerscherm</strike>.

==LDAP server keuze==
De voor de hand liggende keuze is OpenLDAP. Echter zijn er geluiden gehoord dat OpenLDAP niet zou schalen. Alternatieven zijn b.v. 389server maar die is erg slecht gesupport onder Ubuntu. Voorlopig starten we met OpenLDAP.

==Loadbalanced==
Er zijn twee servers (ldap-lb1 en ldap-lb2) die achter een loadbalancer in preferred server mode staan zodat het verkeer altijd naar server1 gestuurd wordt. Beide servers houden elkaar up-to-date. In de gewone situatie zullen alle reads en writes naar server1 gaan en server2 wordt door server1 bijgewerkt. Valt server1 weg, dan zal de loadbalancer overschakelen naar server2 waar vanaf dan de read en writes plaatsvinden. Zodra server1 weer beschikbaar is, wordt die bijgewerkt en zal weer master worden.

==Installatie==
Installatie van OpenLDAP is simpel:
aptitude install slapd ldap-utils
Omdat er gebruikgemaakt wordt van php scripts, is het ook nodig '''php-cli''' en '''php-ldap''' te installeren. De configuratie van OpenLDAP is sinds Karmic Koala iets gecompliceerder geworden. 'cn=config' wordt nog steeds gebruikt maar tijdens installatie wordt alleen een skeleton configuratie geïnstalleerd. Er wordt niet meer gevraagd om een password tijdens de installatie en "dpkg-reconfigure slapd" zet alleen de skeleton configuratie terug. Je moet zelf de database, root dn en acl's opzetten (als root of met sudo). Run '''dpkg-reconfigure slapd''' om terug te gaan naar een lege directory.

UPDATE: in Oneiric Ocelot (11.10) is weer wel de mogelijkheid gegeven bij installatie een database aan te maken. Default wordt echter de fqdn hostname gebruikt. Bij dpkg-reconfigure kan het gewenste domein wel opnieuw gegeven worden. De initiële configuratie staat in /usr/share/slapd/slapd.init.ldif.

UPDATE: bij de upgrade naar 16.04.1 zijn proefondervindelijk nog wat extra handelingen nodig gebleken. 
XML-RPC server updaten naar Ubuntu 16.04. WIP!
<pre>
- apt-get install phpmyadmin
- apt-get install aptitude
- apt-get install php-xmlrpc
- apt-get install php-ldap
- phpenmod xml
- phpenmod mysqli
('php -m' toont de geactiveerde modules)
- apache2ctl restart

phpmyadmin werkt niet:
- apt-get install php-mbstring
- apt-get install php-gettext

ontbrekende pakketten volgens hjv:

apt-get install aptitude
apt-get install phpmyadmin
apt-get install php-mbstring
apt-get install php-gettext
apt-get install php-xmlrpc
apt-get install php-ldap
apt-get install mysql-server
apt-get install ldapscripts
apt-get install php-xml
apt-get install slapd
apt-get install ldap-utils
a2enmod ssl

* Voer de laatste stappen uit, zoals beschreven in de Hobbynet wiki: *

- openldap moet lid zijn van de groep ssl-cert!
apt-get install ssl-cert
adduser openldap ssl-cert
(of vi /etc/group
ssl-cert:x:116:openldap)

- Zorg dat de LDAP daemon bij de certificaten kan komen.
LET OP: op alle hobbynet servers staan de certificaten in /disk/site/etc/ssl/hobby.nl/
chgrp ssl-cert /disk/site/etc/ssl/hobby.nl/hobby.nl.*
chmod 440 /disk/site/etc/ssl/hobby.nl/hobby.nl.key
en dus niet langer
chgrp ssl-cert /etc/ssl/private/hobby.nl.*
chmod 440 /etc/ssl/private/hobby.nl.key

- Vertel LDAP (en PHP) clients welke certificaten toegestaan zijn
(2017-09-23: verouderde info, niet langer in gebruik)
vi /etc/ldap/ldap.conf
TLS_CERT /etc/ssl/private/hobby.nl.crt
TLS_KEY /etc/ssl/private/hobby.nl.key
TLS_REQCERT allow

- mysql laat het bestand ibdata1 ongelimiteerd groeien (InnoDB bestanden)
/etc/mysql/mysql.conf.d/innodb_file_per_table.cnf
[mysql]
innodb_file_per_table

=============
Hobbynet aanpassingen
/etc/bash.bashrc
export http_proxy=http://squid-int.hobby.nl:3128
export https_proxy=http://squid-int.hobby.nl:3128
export ftp_proxy=http://squid-int.hobby.nl:3128
</pre>

===Locatie bestanden===
Om de benodigde bestanden op de server te krijgen zal scp gebruikt moet worden. Upload alles in een privé subdirectory. Copiëer daarna alles naar de juiste plaats en verander de owner in root.

* Alle ldif em tmpl bestanden gaan naar /usr/local/hobbynet/lib
* init_ldap en andere scripts gaan naar /usr/local/hobbynet/bin
* alle data bestanden (dumps) en update ldifs gaan naar /usr/local/hobbynet/data
* etc/ldap/schema/hcc_schema.* gaan naar /etc/ldap/schema
* etc/ldap/schema/ppolicy.ldif gaat naar /etc/ldap/schema

==Initiële database==
Direct na installatie (of na dpkg-reconfigure slapd) staat er een werkende doch lege directory in OpenLDAP. Access is alleen geregeld voor root. Dit heeft te maken met het feit dat vanaf Karmic Koala OpenLDAP alleen het minst noodzakelijke bevat om slapd te starten. Wordt echter init_ldap gebruikt dan wordt een werkende directory gemaakt met alle statische data (in diverse ou's) erin. Alleen zijn er geen leden geladen in de ou=leden en ou=inactieve_leden.
===slapd.init.ldif ===
Bij installatie/reconfiguratie wordt /usr/share/slapd/slapd.init.ldif ingelezen. Zie aldaar indien nodig.

==init_ldap script==
Het lokale script init-ldap doet een reset van de initiële Openldap configuratie. Dit heeft tot gevolg dat de DIT dc=hcc,dc=nl met een rootDN '''cn=admin,dc=hcc,dc=nl''' steeds opnieuw aangemaakt wordt. Alles wat we toegevoegd/gewijzigd willen hebben in de cn=config volgt daarna. Dit wordt afgesloten met een restart van de slapd server. Het script '''restore_ldap''' laadt vervolgens de laatste dump terug. Bij wijzigingen aan het schema is het raadzaam altijd een '''dump_ldap''' te doen zodat een later een actuele dump kan worden teruggeladen.

Het (plain text) password van cn=admin,dc=hcc,dc=nl moet bij het aanroepen van '''init_ldap''' op de commandline worden meegegeven. Tijdens de dpkg-reconfigure moet het password nog 2x gegeven worden. Lees eventueel ook de [http://www.openldap.org/doc/admin/ OpenLDAP Admin Guide].

Het init_ldap script bevat allerlei logica om op meerdere ldap servers gedraaid te kunnen worden. In grote lijnen valt het script in een aantal blokken uiteen:
* voorbereidingen om "dpkg-reconfigure slapd" te draaien
* definities van input files
* check host
* bouwen van het skelet van de nieuwe directory
Zie voor details van de scripts '''init_ldap''', '''dump_ldap''' en '''restore_ldap''' op een van de servers (in /usr/local/hobbynet/bin).

==onderdelen van init_ldap==
Init_ldap is opgezet om stap voor stap de database op te bouwen. Hieronder een beschrijving van de losse ldif bestanden die ingelezen worden. Incidenteel wordt een ldif gewijzigd; kijk altijd in de actuele bestanden!

===add-schema.ldif===
Omdat wij een aantal eigen attributes en Objectclasses hebben toegevoegd aam het schema, moeten deze aan OpenLDAP worden toegevoegd. Het schema moet nog worden omgezet naar ldif format.
* Hiertoe wordt het onderstaande schema in /etc/ldap/schema geplaatst als hcc_schema.schema.
* Vervolgens worden de stappen uitgevoerd zoals beschreven in de [https://help.ubuntu.com/11.10/serverguide/C/openldap-server.html Ubuntu Server guide], onder '''Modifying the slapd Configuration Database'''.
* De resulterende output file '''cn=hcc_schema.ldif''' moet dan nog naar /etc/ldap/schema/hcc_schema.ldif gecopieerd worden.
Als dit proces herhaald moet worden, start dan met een lege output directory en verwijder een eventueel achtergebleven cn=hcc_schema.ldif bestand.

De extra schema's worden middels een '''include''' toegevoegd. '''Ppolicy''' is op gelijke wijze als '''hcc_schema''' tot .ldif geconverteerd. Alle stappen om een nieuwe '''hcc-schema.ldif''' te maken zijn gescript in '''upd_schema'''. In '''init_ldap''' wordt het eigen schema en de password policy geladen:
<pre>
#######################################
## add-schema.ldif ##
#######################################
include: file:///etc/ldap/schema/hcc_schema.ldif
include: file:///etc/ldap/schema/ppolicy.ldif
include: file:///etc/ldap/schema/ldapns.ldif
</pre>

====schema updates====
Soms wordt een attribute toegevoegd of gewijzigd. Hiertoe dient het bestand hcc_schema.schema in /usr/local/hobbynet/etc/ldap/schema, gewijzigd te worden. Daarna dient er een ldif versie van gemaakt te worden. Gebruik hiervoor '''upd_schema.sh''' in dezelfde directory. De resulterende hcc_schema.ldif wordt in dit script naar /etc/ldap/schema gecopieërd. Bij grote wijzigingen is het aan te bevelen door de hele rebuild cycle te gaan (dump, init, restore). Bij triviale aanpassingen zou hcc_schema.ldif ook '''direct''' in de actieve directory geplaatst kunnen worden, gevolgd door slechts een '''service slapd restart'''. Gebruik hiervoor (blijf in de lokale schema directory):
<pre>
cp "ldif_output/cn=config/cn=schema/cn={14}hcc_schema.ldif" "/etc/ldap/slapd.d/cn=config/cn=schema/cn={4}hcc_schema.ldif"
</pre>
LET OP: De nummers tussen accolades zijn bepaald door de volgorde van andere scripts! Zolang geen andere schema's worden toegevoegd zullen ze niet veranderen.
 
Ook kan met de ldap-tools gewerkt worden. Gebruik ldapsearch en ldapmodify, eventueel met de -f optie om een voorbereide serie opdrachten uit te voeren. Gebruik ldapsearch om eerst de structuur te vinden:
<pre>
$ sudo ldapsearch -Q -LLL -Y EXTERNAL -H ldapi:/// -b cn={4}hcc_schema,cn=schema,cn=config
</pre>
Hier een voorbeeld om een objectClass aan te passen:
<pre>
$ cat pas_aan.ldif
dn: cn={4}hcc_schema,cn=schema,cn=config
changetype: modify
delete: olcObjectClasses
olcObjectClasses: {7}( 1.3.6.1.4.1.12795.2.8 NAME 'hccRelatieNaam' \
DESC 'Naam van een klant of partner' SUP top STRUCTURAL MUST ( cn $userPassword )
MAY ( hccXmlIp4 $ hccXmlIp6 $ hccXmlAllow $ description ) )
-
add: olcObjectClasses
olcObjectClasses: {7}( 1.3.6.1.4.1.12795.2.8 NAME 'hccRelatieNaam' \
DESC 'Naam van een klant of partner' SUP top STRUCTURAL MUST ( cn $userPassword )
MAY ( hccXmlIp4 $ hccXmlIp6 $ hccXmlAllow $ description $ hccIg ) )
-

$sudo ldapmodify -Q -Y EXTERNAL -H ldapi:/// -f pas_aan.ldif
</pre>

===modify_config.ldif===
Dit template dient om de SSL/TLS instelling toe te voegen in de ldap configuratie. Toegevoegd worden de certificaat gegevens om met TLS te kunnen werken. Het loglevel wordt op '''STATS''' gezet. Dit geeft niet teveel logging maar is toch goed bruikbaar. Om extra logging te krijgen op b.v. ACL's, verander olcLogLevel dan in "stats ACL".

Dit template wordt tijdens het draaien van het init_ldap script gecopieerd naar modify-config.ldif. Eventueel kan met place holders gewerkt worden (@...@), dit om op alle servers (ook test servers) één en hetzelfde script te kunnen gebruiken. Er zijn nog enkele van deze templates.
<pre>
#######################################
## modify-config.hobbynet ##
#######################################
dn: cn=config
replace: olcLogLevel
olcLogLevel: stats
-
replace: olcTLSCACertificateFile
olcTLSCACertificateFile: /disk/site/etc/ssl/hobby.nl/CA-bundel.crt
-
replace: olcTLSCertificateFile
olcTLSCertificateFile: /disk/site/etc/ssl/hobby.nl/hobby.nl.crt
-
replace: olcTLSCertificateKeyFile
olcTLSCertificateKeyFile: /disk/site/etc/ssl/hobby.nl/hobby.nl.key

</pre>
Om de logging in een apart bestand te krijgen moet in /etc/rsyslog.d een extra bestand '''openldap.conf''' geplaatst worden.
<pre>
local4.* -/var/log/openldap.log
</pre>
Tevens willen we logrotate op dit bestand. Plaats in /etc/logrotate.d het bestand '''openldap''' met de volgende inhoud
<pre>
/var/log/openldap.log
{
rotate 4
weekly
missingok
notifempty
compress
delaycompress
sharedscripts
postrotate
reload rsyslog >/dev/null 2>&1 || true
endscript
}
</pre>

===modify-hdb.ldif===
Hier worden de wijzigingen op de backend db gemaakt. Er worden een aantal attributes ge-indexeerd en de search SizeLimit wordt op '''unlimited''' gezet. De waarden die in DB_CONFIG moeten komen (Berkely DB parameters) staan ook in dit bestand. Deze versie is outdated. De ACL regels zijn drastisch gewijzigd. Raadpleeg altijd de laatste versie op de server zelf.
<pre>
#######################################
## modify-hdb.ldif ##
#######################################
dn: olcDatabase={1}hdb,cn=config
replace: olcAccess
#
# hobbynetlogin heeft lees rechten op ou=users
olcAccess: to attrs=@posixAccount,@posixGroup,@shadowAccount,@hostObject
by dn="cn=hobbynetlogin,ou=applicaties,dc=hcc,dc=nl" read
by * break
#
# drupal/test moet hccOptIn kunnen schrijven vanaf de
# profiel pagina. Overige klanten kunnen hccOptin
# alleen lezen. self mag schrijven
olcAccess: to attrs=hccOptIn
by self write
by dn="cn=drupal-hcc-nl,ou=klanten,dc=hcc,dc=nl" write
by * break
#
# anonieme klanten moeten kunnen inloggen
# en mogen hun eigen password wijzigen
olcAccess: to attrs=userPassword,shadowLastChange
by self write
by anonymous auth
by * break
#
# user mag enkele eigen attr wijzigen
olcAccess: to attrs=hccLogin,hccPseudoniem,hccKaderPassword
by self write
by * break
#
# beheerders hebben schrijfrechten op alles (updateDN)
# klanten hebben alleen lees rechten op alles (readDN)
# self mag lezen
olcAccess: to *
by self read
by dn="cn=xml-hoge-rechten,ou=applicaties,dc=hcc,dc=nl" write
by dn="cn=xml-lage-rechten,ou=applicaties,dc=hcc,dc=nl" read
by dn.one="ou=beheer,dc=hcc,dc=nl" write
by dn.one="ou=klanten,dc=hcc,dc=nl" read
by * break
#
# helpdesk heeft leesrechten op ou=leden
olcAccess: to attrs=@hccOrgPerson,@hccKaderFunctie
by dn.one="ou=helpdesk,dc=hcc,dc=nl" read
by * break
#
# partners mogen een paar attrs lezen
olcAccess: to attrs=hccLidNummer,hccPostcode,hccPostcodeZoekveld
by dn.one="ou=partners,dc=hcc,dc=nl" read
#
# iedereen moet (pseudo attr) entry en objectClass kunnen lezen
olcAccess: to attrs=entry,objectClass
by * read
#
# vangnet: blokkeer alle toegang tot de overige attrs.
olcAccess: to *
by * none
-
replace: olcDbDirectory
olcDbDirectory: /var/lib/ldap
-
replace: olcSizeLimit
olcSizeLimit: 100000
-
replace: olcDbCachesize
olcDbCachesize: 200000
-
replace: olcDbCheckpoint
olcDbCheckpoint: 1024 5
-
replace: olcDbConfig
olcDbConfig: set_cachesize 0 536870912 0
olcDbConfig: set_lk_max_objects 1000
olcDbConfig: set_lk_max_locks 1000
olcDbConfig: set_lk_max_lockers 1000
olcDbConfig: set_flags DB_LOG_AUTOREMOVE
olcDbConfig: set_flags DB_TXN_NOSYNC
-
replace: olcDbIDLcacheSize
olcDbIDLcacheSize: 600000
</pre>

===modify_index.ldif===
Een kale configuratie is heel snel voor wat betreft het opnieuw vullen met gegevens. Bij het aanmaken van een verse LDAP database worden er dan ook zo min mogelijk indexen aangemaakt. 
Zodra de inhoud is ingelezen kunnen de 'echte' indexen aangemaakt worden.
<pre>
#######################################
## modify-index.ldif ##
#######################################
dn: olcDatabase={1}hdb,cn=config
replace: olcDbIndex
olcDbIndex: default pres,eq
olcDbIndex: objectClass,entryUUID,entryCSN eq
olcDbIndex: hccLidNummer,hccLogin,hccForumLogin eq
olcDbIndex: uid,uidNumber,gidNumber,memberUid,member eq
olcDbIndex: cn,host,hccPseudoniem,hccOptin,hccLocatie eq
olcDbIndex: sn,hccPostcodeZoekveld,hccIg,hccRegio eq,subfinal
olcDbIndex: hccRol,hccBezoek eq,pres,subfinal
olcDbIndex: hccBulletins pres
olcDbIndex: aboNummer eq
olcDbIndex: aboPostcodeZoekveld eq,subfinal
olcDbIndex: mail,mailHccnet,hccKaderMail pres,eq
olcDbIndex: hccProfiel pres
</pre>

===ppolicy overlay===
* vanuit LDAP de minimale lengte van een wachtwoord afdwingen
* in LDAP SSHA versleuteling activeren 
(olcPPolicyHashCleartext: TRUE)
<pre>
#######################################
## add-ppolicy.ldif ##
#######################################
dn: cn=module, cn=config
cn: module
objectClass: olcModuleList
objectClass: top
olcModuleLoad: ppolicy
olcmodulepath: /usr/lib/ldap

dn: olcOverlay=ppolicy,olcDatabase={1}hdb,cn=config
objectClass: olcOverlayConfig
objectClass: olcPPolicyConfig
olcOverlay: ppolicy
olcPPolicyDefault: cn=default,ou=policies,dc=hcc,dc=nl
olcPPolicyUseLockout: TRUE
olcPPolicyHashCleartext: TRUE
</pre>
The default ppolicy looks like this:
<pre>
dn: cn=default,ou=policies,dc=hcc,dc=nl
objectClass: pwdPolicy
objectClass: device
cn: default
pwdCheckQuality: 1
pwdMinLength: 8
pwdAttribute: 2.5.4.35
pwdAllowUserChange: TRUE
</pre>

===Syncrepl overlay===
Om twee servers met elkaar in sync te houden is nog wat aanvullende configuratie nodig. In onze situatie zal altijd maar één server bevraagd worden; bij een failover van de loadbancer zal dus de andere server gebruikt worden. Bij het teruggaan naar server 1 zal de directory bijgewerkt worden. Wij gebruiken de z.g. Mirror Mode. Zie de [http://www.openldap.org/doc/admin/ LDAP Admin Guide]. '''Mirror configuratie is specifiek per server!'''
<pre>
#######################################
## add-syncrepl.tmpl ##
#######################################
dn: cn=config
changetype: modify
replace: olcServerID
olcServerID: @SID@

dn: cn=module{0},cn=config
changetype: modify
add: olcModuleLoad
olcModuleLoad: syncprov

dn: olcOverlay=syncprov,olcDatabase={1}hdb,cn=config
changetype: add
objectClass: olcOverlayConfig
objectClass: olcSyncProvConfig
olcOverlay: syncprov
olcSpCheckpoint: 100 5
olcSpSessionlog: 100

dn: olcDatabase={1}hdb,cn=config
changetype: modify
add: olcSyncRepl
olcSyncRepl: rid=@RID@
provider=ldap://@PROVIDER@
binddn="cn=admin,dc=hcc,dc=nl" bindmethod=simple credentials="@PASSWORD@"
searchbase="dc=hcc,dc=nl"
type=refreshAndPersist
interval=00:00:00:10
retry="5 5 300 5"
timeout=1
starttls=yes
-
add: olcMirrorMode
olcMirrorMode: TRUE
</pre>
De andere server krijgt ServerID 2 en de provider is het IP adres van de andere server.

===Unique overlay===
Deze overlay dient er voor te zorgen dat o.a het attribuut hccLogin een unieke waarde bevat.
<pre>
#######################################
## add-unique.ldif ##
#######################################
dn: cn=module,cn=config
cn: module
objectclass: olcModuleList
objectclass: top
olcmoduleload: unique
olcmodulepath: /usr/lib/ldap

dn: olcOverlay=unique,olcDatabase={1}hdb,cn=config
objectClass: olcOverlayConfig
objectClass: olcUniqueConfig
olcOverlay: unique
olcUniqueAttribute: uid uidNumber hccLogin
</pre>

==SSL/TLS beveiliging==
Gebruik de juiste .pem bestanden in /etc/ssl/certs en /etc/ssl/private.

We maken gebruik van een RapidSSL certificaat. Als dit niet standaard in Ubuntu bekend is, zet dan eerst GeoTrust_RapidSSL_-_ca-bundle.pem in de map /etc/ssl/certs neer. Voer nu een '''c_rehash .''' uit in /etc/ssl/certs om de cache te updaten (omdat GeoTrust_RapidSSL_-_ca-bundle.pem nieuw werd toegevoegd).

De ownership is belangrijk. Hiertoe wordt de groep "openldap" toegevoegd aan de groep ssl-cert.
adduser openldap ssl-cert

Als dit fout gaat, doe dan eerst:
apt-get install ssl-cert

Zet het certificaat en de private key in de juiste groep:
chgrp ssl-cert /etc/ssl/private/hobby.nl.*
chmod 440 /etc/ssl/private/hobby.nl.key

Het resultaat is dan als volgt:
root@hcc-ldap-lb1:~# ls -l /etc/ssl/private/hcc*
-rw-r--r-- 1 root ssl-cert 1724 Nov 22 20:47 hobby.nl.crt
-r--r----- 1 root ssl-cert 1679 Nov 22 20:25 hobby.nl.key

root@hcc-ldap-lb1:~# grep openldap /etc/group
ssl-cert:x:114:openldap
openldap:x:118:

Per september 2017 staan de certificaten in /disk/site/etc/ssl/hobby.nl, net als op alle andere servers. Omdat apparmor actief is moet deze directory worden toegevoegd aan /etc/apparmor.d/local/usr.sbin.slapd. Die file ziet er dan als volgt uit:
<pre>
# Site-specific additions and overrides for usr.sbin.slapd.
# For more details, please see /etc/apparmor.d/local/README.
#include <abstractions/ssl_certs>
/disk/site/etc/ssl/hobby.nl/ r,
/disk/site/etc/ssl/hobby.nl/* r,
</pre>
Als Openldap ook op poort 636 benaderd wordt (naast TLS op 389), moet in /etc/default/slapd ldaps:/// opgenomen worden bij de SLAPD_SERVICES. Netstat -a dient dan 636 te laten zien voor zowel IPv4 als IPv6.

Om de cn=config te zien kan je het volgende commando gebruiken:
<pre>
ldapsearch -Y EXTERNAL -H ldapi:/// -b cn=config

of, wat botter maar korter:
cat /etc/ldap/slapd.d/cn\=config.ldif
</pre>

==Backup, initialize, restore==
Om het hele skelet van ldap in één keer te herstellen dient '''init_ldap''' gebruikt te worden. Als argument '''moet''' het admin beheer wachtwoord mee gegeven worden.

===lokaal===
Backups kunnen gemaakt worden terwijl slapd draait maar geadviseerd wordt slapd te stoppen. Voor dumpen moet '''slapcat''' gebruikt worden. Backups kunnen gemaakt worden per database of een filter daarop, naar een ldif bestand.
slapcat -l hcc-dump.ldif -b "dc=hcc,dc=nl"
Dit maakt een dump van alles onder '''dc=hcc,dc=nl''' naar het bestand hcc-dump.ldif. Ook is het mogelijk het database nummer te gebruiken, config is altijd nummer 0, hdb is gewoonlijk 1.

Het '''dump_ldap''' script dumpt alle ou's in aparte .ldif bestanden; het omgekeerde doet '''restore_ldap'''.
Terug inlezen kan alleen in een lege directory, dus direct nadat '''init_ldap''' is gedaan. Gebruik voor het terugplaatsen '''slapadd'''. Aan te bevelen is '''-c''' mee te geven zodat ondanks fouten doorgegaan wordt.

Voor slapadd '''moet''' slapd gestopt zijn. Denk er om alvorens te slapd starten het ownership van de bestanden in /var/lib/ldap recht te zetten! (dit lijkt niet meer nodig te zijn vbs20130526)
/etc/init.d/slapd stop
slapadd -l hcc-dump.ldif -w -c >errors.txt
chown openldap:openldap /var/lib/ldap/*
/etc/init.d/slapd start

===remote===
Er wordt dagelijks een encrypted remote backup gemaakt naar backup2bit. Zie voor meer info [[Encrypted_backup]]. Dit script maakt gebruik van unieke gpg keys. Op elke server is dus een eigen versie nodig van '''backup-encrypted'''. 
Recente lokale backups zijn te vinden in '''/usr/local/hobbynet/tmp'''.

===Verse ldap maken===
Transactie log bij het toevoegen van b.v. een nieuwe ou:

<pre>
Op beide servers:
schema van test server gecopieerd en geactiveerd
dump-ldap gedraaid
systemctl stop slapd.service

Er is nu géén ldap service! Werk dus snel...

op ldap-lb1:
init-ldap.sh <adminpw>
restore-ldap.sh
wacht op indexering (tot slapd uit top verdwijnt)
Slapd service is nu in de lucht op ldap-lb1
systemctl stop slapd.service

op ldap-lb2:
init-ldap.sh <adminpw>
restore-ldap.sh
wacht op indexering (tot slapd uit top verdwijnt)
Slapd service is nu in de lucht op ldap-lb2

op ldap-lb1:
systemctl start slapd.service
Beide slapd servers zijn in de lucht en moeten synchroniseren.

op beide servers:
check replicatie (netstat en functioneel)

root@ldap-lb1:/usr/local/hobbynet/bin# netstat -n | grep 389
tcp 0 0 172.31.8.4:36838 172.31.8.5:389 ESTABLISHED
tcp 0 0 172.31.8.4:36836 172.31.8.5:389 ESTABLISHED
tcp 0 0 172.31.8.4:389 172.31.8.5:58112 ESTABLISHED
tcp 0 0 172.31.8.4:389 172.31.8.5:58114 ESTABLISHED

Functioneel door met ADS op beide servers in te loggen en een willekeurig veld in je eigen entry te wijzigen op lb1. Kijk of het gebeurd is op lb2 en wijzig het daar terug. Check op de andere server of het gebeurd is. Er kan een zekere vertraging in optreden.

Stel er is een nieuwe ou gemaakt: denk aan het bij werken van de dump en restore scripts.

update dump-ldap.sh en restore-ldap.sh met de nieuwe ou

op ldap-lb1:
export tarieven.ldif op test server en import op ldap-lb1
</pre>

==crontab==
# script dat updates ophaalt (maar niet installeert), zodat nagios ze ook detecteert
0 9 * * * /usr/local/hobbynet/bin/upd_srv >/dev/null
0 18 * * * /usr/local/hobbynet/bin/upd_srv >/dev/null

==LDAP Clients==
Er zijn meerdere LDAP clients. De meest populaire zijn Apache Directory Studio ("ADS") en phpLdapAdmin ("PLA"). 
De eerste is veel uitgbreider maar vereist een Java Runtime Environment ("JRE"). Onder Windows is dat JRE(13) of (open)JDK-(13). 
PhpLdapAdmin draait onder apache. Beide clients hebben wat configuratie nodig; Bij ADS gaat alles stapsgewijs in de GUI. Voor PLA moet /etc/phpldapadmin/config.php aangepast worden.

Binnen Hobbynet wordt uitsluitend gebruik gemaakt van ADS.

===StartTLS===
Aanbevolen wordt StartTLS op poort 389 te gebruiken. Alternatief is LDAPS op poort 636 maar dat is deprecated.

Voor beide clients is het belangrijk dat de root certificaten gevonden kunnen worden. Als Apache al een server cert kent zou PLA geen probleem mogen zijn. ADS maakt deel uit van de JRE. JRE moet dus de root certificaten kunnen vinden.

===ADS onder Windows===
2019-10-31 HJV: Oude info, als referentie leuk, maar niet meer relevant 
Onder Windows moet met '''keytool.exe''' gewerkt worden. De uitleg heb ik van [http://www.talkingtree.com/blog/index.cfm?mode=entry&entry=25AA75A4-45A6-2844-7CA3EECD842DB576 hier]. Het komt erop neer dat de .pem of .der certificaten van CAcert in de keystore gezet worden. Kopieer deze certificaat bestanden in C:\Program Files\Java\jre6\lib\security (jre6 kan ondertussen jre7 zijn in Vista of W7). Doe dan in een terminal window:
<pre>
Haal de benodigde bestanden op (op een Linux systeem):
wget http://www.cacert.org/certs/root.der -O root.der
wget http://www.cacert.org/certs/class3.der -O class3.der
copieer de bestanden naar de Windows omgeving in C:\Program Files (x86)\Java\jre6\lib\security.

Open een commandwindow:
cd C:\Program Files (x86)\Java\jre6\lib\security
..\..\bin\keytool -import -trustcacerts -keystore cacerts -storepass changeit -noprompt -alias cacertclass1 -file root.der
..\..\bin\keytool -import -trustcacerts -keystore cacerts -storepass changeit -noprompt -alias cacertclass3 -file class3.der
</pre>
De Windows JRE is ook te managen via het Java applet in het configuratiescherm. Toevoegen van root certificaten lijkt niet mogelijk voor system; wel voor user. Niet verder naar gezocht.

===ADS onder Linux===
Apache Directory Studio laat zich uit een tarball installeren. Dit kan geheel in userspace; er is geen make install o.i.d. nodig. ADS loopt vanuit de lokatie waar het uitgepakt is.

===ADS gebruik===
ADS kan erg handig zijn voor het snel dumpen van hele ou's in .ldif formaat. Zo'n dump kan direct op een andere server worden ingelezen.

===PhpLdapAdmin onder Linux===
Voor ldap clients (phpldapadmin) dient de client configuratie goed te zijn. Deze bevindt zich in /etc/ldap/ldap.conf. Het is voldoende als de directory met de root certificaten bekend is. Deze client configuratie is meer php-ldap gebonden dan alleen voor PLA. Ook de Drupal LDAPauth module werkt met ditzelfde beatand. Zie ook de [http://phpldapadmin.sourceforge.net/wiki/index.php/Server:server:tls phpldapadmin wiki].
<pre>
#
# LDAP Defaults
#

# See ldap.conf(5) for details
# This file should be world readable but not world writable.

#BASE dc=example,dc=com
#URI ldap://ldap.example.com ldap://ldap-master.example.com:666

#SIZELIMIT 12
#TIMELIMIT 15
#DEREF never
TLS_CACERT /etc/ssl/certs/CAcert_org.pem
TLS_CERT /etc/ssl/private/hobby.nl.crt
TLS_KEY /etc/ssl/private/hobby.nl.key
TLS_REQCERT allow
#TLS_REQCERT never
</pre>
Denk er wel aan na wijzigingen Apache te herstarten.
===PAM en NSS via LDAP===
Het inloggen van gebruikers kan ook via een LDAP server en client geschieden. Hiervoor dienen enkele pakketten geïnstalleerd en geconfigureerd te worden. Er zijn wijzigingen nodig in /etc/nsswitch.conf en de /etc/pam.d/common-* bestanden. Beide zijn via dedicated tools aan te passen.

Installeer '''libnss-ldapd''' om de benodigde libraries te verkrijgen. Apt-get zal tevens '''libpam-ldapd''', '''nslcd''' en '''nscd''' binnen brengen.
<pre>
apt-get install libnss-ldapd auth-client-config ldap-utils
The following extra packages will be installed:
libpam-ldapd nscd nslcd
</pre>
Libnss-ldapd is een doorontwikkeling van libnss-ldap en bevat meerdere verbeteringen. Zie: [http://arthurdejong.org/nss-pam-ldapd/ deze site] van de ontwikkelaar. Bij de installatie wordt een user '''nslcd''' aangemaakt; denk erom die in de .tmpl bestanden te zetten!

nsswitch.conf laat zich configureren via '''auth-client-config''' maar lac_ldap is alleen aanwezig als '''ldap-auth-config''' ook is geinstalleerd. Zo niet gebruik dan de tweede regel:
<pre>
auth-client-config -t nss -p lac_ldap
auth-client-config -t nss -p ldap_example
</pre>
Het resultaat is dat nsswitch.conf zowel in files (/etc/passwd etc.) zoekt als in ldap.
<pre>
# /etc/nsswitch.conf
#
# Example configuration of GNU Name Service Switch functionality.
# If you have the `glibc-doc-reference' and `info' packages installed, try:
# `info libc "Name Service Switch"' for information about this file.

# pre_auth-client-config # passwd: compat
passwd: files ldap
# pre_auth-client-config # group: compat
group: files ldap
# pre_auth-client-config # shadow: compat
shadow: files ldap

hosts: files dns
networks: files

protocols: db files
services: db files
ethers: db files
rpc: db files

# pre_auth-client-config # netgroup: nis
netgroup: nis
</pre>
Het aanpassen van de PAM bestanden gaat sinds enige releases met '''pam-auth-update'''. Kies in het menu voor zowel unix als ldap. Default wordt nu ldap authenticatie gebruikt voor uid >= 1000. Bij Hobbynet willen we vanaf 300 ldap gebruiken. Door een licht gemodificeerde versie van /usr/share/pam-configs/ldap te maken (ldap-hobbynet), kan ook voor de hobbynet instelling gekozen worden. Dit is de ldap-hobbynet versie:
<pre>
Name: LDAP Authentication (uid>300)
Default: yes
Priority: 128
Auth-Type: Primary
Auth-Initial:
[success=end default=ignore] pam_ldap.so minimum_uid=300
Auth:
[success=end default=ignore] pam_ldap.so minimum_uid=300 use_first_pass
Account-Type: Additional
Account:
[success=ok new_authtok_reqd=done ignore=ignore user_unknown=ignore authinfo_unavail=ignore default=bad] pam_ldap.so minimum_uid=300
Password-Type: Primary
Password-Initial:
[success=end default=ignore] pam_ldap.so minimum_uid=300
Password:
[success=end default=ignore] pam_ldap.so minimum_uid=300 try_first_pass
Session-Type: Additional
Session:
[success=ok default=ignore] pam_ldap.so minimum_uid=300
</pre>

Dit is in een standaard opzet van LDAP voldoende om zowel lokale gebruikers als gebruikers opgeslagen in LDAP, te laten inloggen en hun password te laten wijzigen. In de Hobbynet setup moet er echter nog meer gebeuren in de ACL's van de LDAP server configuratie. Omdat Hobbynet de laatste ACL regel heeft gewijzigd in een '''deny-all''', is er een helper of proxy account nodig dat read access heeft of een aantal cruciale velden in de posixAccount objectClass. Zie verder de lsiting van nslcd.conf.

Libnss-ldapd en libpam-ldapd hebben een gezamelijke daemon '''nslcd''' die z'n configuratie uit '''/etc/nslcd.conf''' haalt. Hierin is ook een voorziening voor het helper account. Aan het eind vande '''nslcd.conf''' staat de voorziening voor host-based login. Als het attribute '''host''' de fqdn of alleen de host naam bevat, bepaald dat of inloggen op die host mogelijk is. '''*''' staat inloggen op alle hosts toe.

Eventueel kan het daemon proces voor debugging doeleinden ook als command ('''nslcd -d''') gestart worden. Om de bevragingen van de LDAP server wat te verminderen, kan '''nscd''' voor caching zorgen. Deze cache daemon heeft zijn eigen configuratie bestand: '''/etc/nslcd.conf'''. De default instellingen zijn goed; eventueel kan de logging naar een bestand gestuurd worden.

Verbinding met de LDAP server kan met StartTLS beveiligd worden. Hier de inhoud van nslcd.conf:
<pre>
# /etc/nslcd.conf
# nslcd configuration file. See nslcd.conf(5)
# for details.

# The user and group nslcd should run as.
uid nslcd
gid nslcd

# log location and level
#log /var/log/nslcd.log debug

# The location at which the LDAP server(s) should be reachable.
uri ldap://ldap2-int.hobby.nl/

# The search base that will be used for all queries.
base dc=hcc,dc=nl

# Other base mappings
base group ou=groups,dc=hcc,dc=nl
base passwd ou=users,dc=hcc,dc=nl
base shadow ou=users,dc=hcc,dc=nl

# The search scope.
#scope sub

# The LDAP protocol version to use.
ldap_version 3

# The DN to bind with for normal lookups.
#binddn cn=annonymous,dc=example,dc=net
#bindpw secret
binddn cn=hobbynetlogin,ou=applicaties,dc=hcc,dc=nl
bindpw xxxxxxxxxxxxxxxxx

# The DN used for password modifications by root.
#rootpwmoddn cn=admin,dc=example,dc=com

# SSL options
ssl off
ssl start_tls
#tls_reqcert never
tls_cacertfile /etc/ssl/certs/cacert.org.pem
#tls_cert /etc/ssl/private/server.crt
#tls_key /etc/ssl/private/server.key

# The minimum uid
nss_min_uid 300

pam_authz_search (&(objectClass=posixAccount)(uid=$username)(|(host=$hostname)(host=$fqdn)(host=\\*)))
</pre>

===users en groepen toevoegen===
Hiervoor moet '''ldapscripts''' zijn geïnstalleerd. Dit is het geval op de ldap-lb1 server. Dat levert de volgende extra commando's op:
<pre>
ldaprenamemachine
ldapadduser
ldapdeleteuserfromgroup
ldapfinger
ldapid
ldapgid
ldapmodifyuser
ldaprenameuser
lsldap
ldapaddusertogroup
ldapsetpasswd
ldapinit
ldapaddgroup
ldapdeletegroup
ldapmodifygroup
ldapdeletemachine
ldaprenamegroup
ldapaddmachine
ldapmodifymachine
ldapsetprimarygroup
ldapdeleteuser
</pre>
Meest gebruikt zijn '''ldapaddgroup, ldapadduser, ldapsetpasswd'''.
Er zijn manpages maar er is ook uitgebreide uitleg in de [https://help.ubuntu.com/14.04/serverguide/openldap-server.html Ubuntu server guide]. Omdat wij het automatisch maken van de home dir uit hebben staan, moet die met de hand aangemaakt worden en moet de owner goed gezet worden.

===host-based login===
Met een kleine uitbreiding in het schema van de LDAP server, kan host-based login gerealiseerd worden. Ook in de '''nslcd.conf''' is een uitbreiding nodig.

In de LDAP server dient de objectClass '''hostObject''' aan de entries in de ou=users toegevoegd te worden. Deze (auxilary) objectClass brengt slechts één attribute met zich mee: '''host'''. De regel in nslcd.conf checkt of één van de waarden van '''host''' gelijk is aan de naam van de server waarop ingelogd wordt. De waarde '''*''' geldt als wildcard. Zie de regel ''
'pam_authz_search'''' in '''nslcd.conf'''.

===Password aanpassen===
Via LDAP ingelogde gebruikers kunnen net als lokale gebruikers hun wachtwoord met '''passwd''' wijzigen. Wel moet aan de eisen in de LDAP ppolicy module voldaan worden.

==PHP scripting==
Initieel worden alle leden op basis van hun hcc lidnummer ingelezen. Zodra de profielwizard doorlopen is, zal het lidnummer vervangen moeten worden door de gebruikersnaam. Er zijn verschillende php-scripts gemaakt, o.a. om snel alle kaderrollen te verwijderen. Php-scripts staan in de '''/usr/local/hobbynet/bin''' directory.
Voor de php-scripting zijn enkele php7.x pakketten nodig. Installeer deze met apt-get. Het gaat om:
* php-cli
* php-ldap

== Apache authenticatie via LDAP ==
In plaats van .htpassword authenticatie, kan ook LDAP gebruikt worden. Activeer daartoe de Apache module
'authnz_ldap'.
a2enmod authnz_ldap
Denk er om dat dit in een loadbalanced situatie op beide servers gedaan dient te worden!

=== Voorbeeld van een LDAP configuratie in de Apache config ===
(alleen als voorbeeld, niet zo gebruiken!) 

<pre>
# // 1) Hobbynet webmaster
# // 2) Vraagbaak medewerker van een willekeurige groepering
# (|(hccRol=*#VRBK)(hccRol=HN#WM))
<Location "/apps/vraagbaak">
<RequireAll>
Authname "HCC!vraagbaak (gebruik uw hcc.nl gebruikersnaam/wachtwoord)"
AuthType Basic
AuthBasicProvider ldap
AuthLDAPUrl ldap://hcc-ldap-int.hobby.nl/ou=leden,dc=hcc,dc=nl?hccLogin??(|(hccRol=*#VRBK)(hccRol=HN#WM))(hccProfiel=TRUE) TLS
require valid-user
</RequireAll>
</Location>
</pre>

=== Hoe kan LDAP veilig gebruikt worden vanuit Apache===
Zet een script neer in de gebruikersomgeving, en gebruik mod_authz_external. Doe de controle vervolgens via de XML-RPC server. 

'''Zie [[Kadernet]] voor een voorbeeld.'''

== TODO lijst ==
''Dit is een lijst in wording, graag aanvullen''
* 'dun' loadbalancer script maken om te controleren dat LDAP echt luistert

LDAP groeperings vlaggen

2020-06-23T09:21:02Z

Hans:

= doel =
Een overzicht van vlaggen die er zijn voor '''ou=interessegroepen''' in ldap en wat ze doen
= hccTariefGroep =
Deze vlag zorgt er voor dat juiste bedrag wordt getoond in joomla. 

Interessegroepen met een 2-letter code worden beschouwd als een IG waar je lid van kunt worden.
IG's met een langere code worden altijd buiten beschouwing gelaten. 
''' tarief groep ''' Ook groeperingen met '''tarief groep 0''' worden niet op de lid-worden pagina getoond.

= hccToonInJoomla =
Als deze vlag is gezet wordt hij niet in de joomla login module getoond

= hccToonInOverzichten =
Als deze vlag is wordt hij niet opgenomen in statistieken etc etc

= hccToonOpKadernet =
Als deze vlag is gezet wordt hij niet getoond in de kadernetmutatie module, uitgezonderd hobbynet beheerders en LA

= hccFunctionalEmail =
Als deze vlag is gezet worden er geen functionele e-mail adressen aangemaakt of kader e-mail adressen voor kader/kern leden

= hccBulletins =
Als deze vlag is gezet worden er geen nieuwsbrieven voor deze groepering gemaakt

LDAP groeperings vlaggen

2020-06-23T09:10:35Z

Hans:

= doel =
Een overzicht van vlaggen die er zijn voor '''ou=interessegroepen''' in ldap en wat ze doen
= hccTariefGroep =
Deze vlag zorgt er voor dat juiste bedrag wordt getoond in joomla. 
''' tarief groep ''' Groepering met tarief groep 0 worden niet op de aanmeld pagina getoond

= hccToonInJoomla =
Als deze vlag is gezet wordt hij niet in de joomla login module getoond

= hccToonInOverzichten =
Als deze vlag is wordt hij niet opgenomen in statistieken etc etc

= hccToonOpKadernet =
Als deze vlag is gezet wordt hij niet getoond in de kadernetmutatie module, uitgezonderd hobbynet beheerders en LA

= hccFunctionalEmail =
Als deze vlag is gezet worden er geen functionele e-mail adressen aangemaakt of kader e-mail adressen voor kader/kern leden

= hccBulletins =
Als deze vlag is gezet worden er geen nieuwsbrieven voor deze groepering gemaakt

Wij jitsi server

2020-05-28T06:25:36Z

Hans:

= doel =

De server wij.hcc.nl verzorgt een jitsi server voor hcc

= opzet =
[[File:Jitsi diagram.png|thumb]]
[[File:Jitsi diagram.dia]]
De jitsi frontend fungeert als dirigent: hij bepaalt welke sessie op welke videobridge plaats vindt, hij is sessie broker.
Elke videobridge handelt zijn eigen video verkeer af

Het cluster bestaat uit 4 servers 
1. Frontend : deze is zeg maar de sessie broker
2,3,4. Videobridge 1 t/m 3: deze handelen al het video verkeer rechtstreeks af

= update van jitsi =
Nadat updates van jitsi zijn geweest moet het volgende script gedraaid worden
/usr/local/hobbynet/home/jitsi-images/update-jitsi.sh
Dit zorgt er voor dat het hcc logo etc etc wordt teruggezet, samen met nog wat settings.

== update script jitsi-frontend==
Bij apt upgrade/full-upgrade wordt automatisch door middel van een hook bepaalde settings goed gezet na de upgrade, dit gebeurt altijd, ook al is er geen jitsi update.

Het update script vindt je hier: <code>/etc/apt/apt.conf.d/80upgradehook</code> en ziet er als volgt uit:
DPkg::Post-Invoke {"/usr/local/hobbynet/local/jitsi/update-jitsi.sh";};

Het script wat hij aanroep is /usr/local/hobbynet/local/jitsi/update-jitsi.sh
<pre>
#!/bin/bash
echo "Jitsi frontend bijwerken"
echo "plaats watermark"
cp /usr/local/hobbynet/local/jitsi/Logo_hcc_RGB_png.png /usr/share/jitsi-meet/images/watermark.png
echo "plaats favoicoonen"
cp /usr/local/hobbynet/local/jitsi/favicon.ico /usr/share/jitsi-meet/images/favicon.ico
cp /usr/local/hobbynet/local/jitsi/favicon.ico /usr/share/jitsi-meet/favicon.ico
echo "backup oude interface config"
cp /usr/share/jitsi-meet/interface_config.js /usr/local/hobbynet/local/jitsi/interface_config.js.old
echo "vervang nodige variable in interface config, ipv oude config herbruiken"
cat /usr/share/jitsi-meet/interface_config.js |sed "s/'Jitsi Meet'/'Wij HCC'/g"|sed "s/PROVIDER_NAME: 'Jitsi'/PROVIDER_NAME: 'Wij HCC'/g"|sed "s/'Jitsi Meet'/'Wij HCC'/g"|sed "s/DISABLE_JOIN_LEAVE_NOTIFICATIONS: false/DISABLE_JOIN_LEAVE_NOTIFICATIONS: true/g" >/usr/local/hobbynet/local/jitsi/interface_config.js.new
echo "plaats nieuwe interface config"
cp /usr/local/hobbynet/local/jitsi/interface_config.js.new /usr/share/jitsi-meet/interface_config.js
</pre>
Het script plaatst het watermark en favicon op de juiste plek. Daarnaast doet hij de nodige aanpassingen in interface_config.js file met sed. Gebruik sed omdat er nog steeds nieuwe config opties bij komen en op deze manier gaan die niet verloren.

== wanneer kan server herstart worden ==
Er is geen 'nette' manier om te zien hoeveel er van de server gebruik gemaakt wordt.
Maar er is wel een betrouwbare truc: kijk hoeveel sessies er naar TCP poort 443 ESTABLISHED zijn.

#netstat -an|grep ESTABLISHED
tcp 0 0 212.72.229.44:443 80.101.34.193:48418 ESTABLISHED
tcp 0 0 212.72.229.44:443 80.101.34.193:48421 ESTABLISHED
tcp 0 0 127.0.0.1:5347 127.0.0.1:50736 ESTABLISHED
tcp 0 0 127.0.0.1:5222 127.0.0.1:59836 ESTABLISHED
tcp 0 0 172.31.1.44:742 172.31.1.210:2049 ESTABLISHED
tcp 0 0 127.0.0.1:5222 127.0.0.1:59838 ESTABLISHED
tcp 0 0 172.31.1.44:22 172.31.1.34:52706 ESTABLISHED
tcp6 0 0 127.0.0.1:59836 127.0.0.1:5222 ESTABLISHED
tcp6 0 0 127.0.0.1:59838 127.0.0.1:5222 ESTABLISHED
tcp6 0 0 ::1:45414 ::1:5280 ESTABLISHED
tcp6 0 0 ::1:5280 ::1:45414 ESTABLISHED
tcp6 0 0 127.0.0.1:50736 127.0.0.1:5347 ESTABLISHED
In bovenstaand voorbeeld zie je voornamelijk interne IP adressen, dan wel 'eigen' 212.72.229 IP adressen. De server is dus in rust, er zijn geen actieve bijeenkomsten. Maar waarom heeft 80.101.34.193 dan 2 sessies? Waarschijnlijk is dit een presentator, die alvast een kanaal geopend heeft, om later vandaag een presentatie te verzorgen. We weten niet wie het is, we weten niet welk kanaal hij geopend heeft.

Black box dus, niet te beheren.

Wij jitsi server

2020-05-20T09:21:09Z

Hans:

= doel =

De server wij.hcc.nl verzorgt een jitsi server voor hcc

= update van jitsi =
Nadat updates van jitsi zijn geweest moet het volgende script gedraaid worden
/usr/local/hobbynet/home/jitsi-images/update-jitsi.sh

Dit zorgt er voor dat het hcc logo etc etc wordt teruggezet, samen met nog wat settings.

== update script ==
In de root directory op wij-int staat het script 'upd'. Dit zorgt voor het bijwerken van alle software, en sluit af met het updaten van de jitsi omgeving.

root@wij:~# cat upd
apt update
apt full-upgrade -y
apt autoremove -y
/usr/local/hobbynet/home/jitsi-images/update-jitsi.sh

== wanneer kan server herstart worden ==
Er is geen 'nette' manier om te zien hoeveel er van de server gebruik gemaakt wordt.
Maar er is wel een betrouwbare truc: kijk hoeveel sessies er naar TCP poort 443 ESTABLISHED zijn.

#netstat -an|grep ESTABLISHED
tcp 0 0 212.72.229.44:443 80.101.34.193:48418 ESTABLISHED
tcp 0 0 212.72.229.44:443 80.101.34.193:48421 ESTABLISHED
tcp 0 0 127.0.0.1:5347 127.0.0.1:50736 ESTABLISHED
tcp 0 0 127.0.0.1:5222 127.0.0.1:59836 ESTABLISHED
tcp 0 0 172.31.1.44:742 172.31.1.210:2049 ESTABLISHED
tcp 0 0 127.0.0.1:5222 127.0.0.1:59838 ESTABLISHED
tcp 0 0 172.31.1.44:22 172.31.1.34:52706 ESTABLISHED
tcp6 0 0 127.0.0.1:59836 127.0.0.1:5222 ESTABLISHED
tcp6 0 0 127.0.0.1:59838 127.0.0.1:5222 ESTABLISHED
tcp6 0 0 ::1:45414 ::1:5280 ESTABLISHED
tcp6 0 0 ::1:5280 ::1:45414 ESTABLISHED
tcp6 0 0 127.0.0.1:50736 127.0.0.1:5347 ESTABLISHED
In bovenstaand voorbeeld zie je voornamelijk interne IP adressen, dan wel 'eigen' 212.72.229 IP adressen. De server is dus in rust, er zijn geen actieve bijeenkomsten. Maar waarom heeft 80.101.34.193 dan 2 sessies? Waarschijnlijk is dit een presentator, die alvast een kanaal geopend heeft, om later vandaag een presentatie te verzorgen. We weten niet wie het is, we weten niet welk kanaal hij geopend heeft.

Black box dus, niet te beheren.

Wij jitsi server

2020-05-19T11:46:38Z

Hans:

Wij jitsi server

2020-05-18T17:55:44Z

Hans:

Cron jobs

2020-05-14T12:43:30Z

Hans:

= Beschrijving =
Op deze pagina staan de door hobbynet aangemaakte cronjobs, met een korte omschrijving en wanneer het draait zodat je in 1 overzicht kan zien waar wat en wanneer draait.

= servers specifiek=

== scripting ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| scripting
| /usr/local/hobbynet/bin/upd_servers
| root
| Check op updates en download deze, en herstart de firewalls en memcache
| 06:45 18:45
| 2x per dag
|

|-
| scripting
| /usr/local/hobbynet/bin/sync_all
| root
| Update de gecentraliseerde webserver config op loadbalanced servers
| 06:30 23:00
| 2x per dag
|

|-
| scripting
| /usr/local/hobbynet/bin/resetmemcached
| root
| Herstart memcache op niet-loadbalanced webservers
| 02:00 07:00
| 2x per dag
| '''uitgeschakeld'''

|-
| scripting
| /usr/local/hobbynet/bin/sync_fw
| root
| Update en herstart firewall op machines die geen nfs mount hebben
| 00:15 06:15 12:15 18:15
| 4x per dag
|

|-
| scripting
| /usr/local/hobbynet/bin/download_amazonaws-ipranges
| root
| Haal de actuele IP ranges op van amazoneaws. Veel joomla plugin's componenten etc draaien in amazone clouds, daarom halen we die IP ranges op zodat ze zelf kunnen updaten
| 06:25 22:50
| 2x per dag
|

|-
| scripting
| /usr/sbin/nsdc notify
| root
| Verstuur notify naar alle nameservers van het actuele serie nr van alle zones
| 03:33
| 1x per dag
| '''VERHUIZEN NAAR domein'''

|-
| scripting
| /usr/local/hobbynet/opendnssec/ods-dsseen-firstksk
| root
| Activeer nog niet geactiveerde dnssec sleutels voor eerste keer
| *:29
| 24x per dag
| '''VERHUIZEN NAAR domein'''

|-
| scripting
| /usr/local/hobbynet/opendnssec/generate_keys
| root
| Vul vooraad dnssec sleutels aan in key opslag
| 04:45,10:45,16:45,22:45
| 4x per dag
| '''VERHUIZEN NAAR domein'''

|-
| scripting
| /usr/local/hobbynet/opendnssec/update-dnsseczones
| root
| Update alle dnssec zones bij registry's
| 05:00,11:00,17:00,23:00
| 1x per dag
| '''VERHUIZEN NAAR domein'''

|}

== domein ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| domein
| /usr/sbin/nsd-control write
| root
| Schrijf alle slave zones uit geheugen naar file
| ieder uur
| 24x per dag
|

|-
| domein
| /usr/local/hobbynet/opendnssec/ods-dsseen --all
| root
| Activeer nog niet geactiveerde dnssec sleutels
| *:30
| 24x per dag
|

|-
| domein
| /usr/local/hobbynet/opendnssec/ods-dsseen --really-all
| root
| Activeer nog niet geactiveerde dnssec sleutels voor eerste keer en loop echt alle zones na
| 01:20
| 1x per dag
|

|-
| domein
| /usr/local/hobbynet/opendnssec/sidn/update-prod-from-live.php
| root
| Update alle DNS zones op basis gegevens van SIDN
| 22:15
| 1x per dag
|

|-
| domein
| /usr/local/hobbynet/opendnssec/transip/update-prod-from-transip.php
| root
| Update alle DNS zones op basis gegevens van Transip
| 22:15
| 1x per dag
|

|}

== ldap-lb1 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| ldap-lb1
| /usr/local/hobbynet/bin/sync_hobbynetfw_2.sh
| root
| Synchroniseer firewall regels van ldap-lb1 naar ldap-lb2 
''' moet draaien voor de firewall restart '''
| 05:55 11:55 17:55 23:55
| 4 x per dag
|

|-
| ldap-lb1
| /etc/init.d/hobby-firewall restart
| root
| Herstart Firewall 
''' moet draaien na de firewall synchronisatie job '''
| 06:00 12:00 18:00 00:00
| 4 x per dag
|

|-
| ldap-lb1
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y >/dev/null
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/local/backup-encrypted.bash >>/var/log/backup_encrypted.log
| root
| Encrypted backup naar Backup2bit
| 23:45
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/sync_hobbynetbin_2.sh
| root
| Sync bin dir naar ldap-lb2
| 23:50
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/sync_hobbynetetc_2.sh
| root
| Sync etc dir naar ldap-lb2
| 23:51
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/sync_hobbynetlib_2.sh
| root
| Sync lib dir naar ldap-lb2
| 23:52
| 1 x per dag
|

|}

== extra op ldap-lb1 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| ldap-lb1
| /usr/local/hobbynet/bin/cron_joomla.sh
| root
| Draai joomla cron job voor joomla sites met login module zodat er zo min mogelijk lid gegevens in backup zitten
| 00:15
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/LDAP_export_passwords.sh
| root
| Zet de (door LA/de gebruiker) aangepaste wachtwoorden over naar het CRM
| 23:20
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/gen_iplist_partners.sh
| root
| Maak /usr/local/hobbynet/apache2conf/iplists/iplist-partners-24 aan
| 03:07
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/LDAP_cronjob.sh
| root
| Doe alle processing CRM->LDAP
| 03:10
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/run_tripolis_import.sh >/var/log/run_tripolis_import.log
| root
| Haal de opt-outs op van Tripolis
| 03:15
| 1 x per dag
|
|-
| ldap-lb1
| /usr/local/hobbynet/bin/mail_tripolis_import_report.sh
| root
| Haal de handmatige tripolis opt-outs op, en mail die naar de ledenadministratie
| 03:31
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/upd_mailserver.sh >/var/log/upd_mailserver.log
| root
| Ververs postfixadmin op mail-lb1 en mail-lb2
| 03:26
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/mail_upd_mail_report.sh
| root
| Mail resultaat van upd_mailserver naar Egbert
| 03:30
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/upload_leden_csv.sh
| root
| Maak en plaats de ledenlijst voor Kantoor
| 03:35
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/upload_kader_csv.sh
| root
| Maak en plaats de kaderlijst voor Kantoor
| 03:40
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/unblock_joomla.sh
| root
| De-blokkeer actieve users
| 03:45
| 1x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/upload_bezoekersstatistiek.sh
| root
| Haal de aantallen bezoekers, en zet die over naar de Joomla kadersite (en de beta-site)
| 03:47
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/run_tripolis_export.sh >/var/log/run_tripolis_export.log
| root
| Maak overzicht van alle opt-ins voor Tripolis
| 03:50
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/mail_tripolis_export_report.sh
| root
| Mail de resultaten van de Tripolis export run naar Egbert
| 03:52
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/renameusers_joomla.sh
| root
| Hernoem de users die hernoemd zijn in ldap in de joomla sites
| 03:50
| 1x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/statistiek_xml.sh
| root
| Maak en plaats statistiek overzicht van alle HCC groeperingen
| 03:55
| 1 x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/cron_joomla.sh
| root
| Draai voordat update_joomla.php draait nogmaals de cron job, zodat ook in de user backup zo min mogelijk lid gegevens zitten, en dat alle sites zijn bijgewerkt aan de hand van de laatste ldap import
| 03:55
| 1 x per dag
|

|-
| ldap-lb1
| php /usr/local/hobbynet/bin/update_joomla.php
| root
| Voer dagelijkse Joomla onderhoud uit op alle Joomla template sites
| 04:00
| 1x per dag
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/run_maand_rapport.sh
| root
| Doe de Hobbynet maand rapportage
| 04:00
| 1e van de maand
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/tel_unieke_bezoekers-volgens-LDAP.sh
| root
| Bepaal het aantal unieke bezoekers volgens LDAP, mail dat aan VB
| 04:05
| 1e van de maand
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/huisgenoot_lidmaatschappen.sh
| root
| Maak een lijst van onjuiste huisgenoot-lidmaatschappen
| 04:10
| 1e van de maand
|

|-
| ldap-lb1
| /usr/local/hobbynet/bin/schoon_alles_op.sh
| root
| Schoon mySQL en LDAP op
| 04:05
| 2e van de maand
|

|}

== ldap-lb2 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| ldap-lb2
| /etc/init.d/hobby-firewall restart
| root
| Herstart Firewall
| 06:15 12:15 18:15 00:15
| 4 x per dag
|

|-
| ldap-lb2
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|-
| ldap-lb2
| /usr/local/hobbynet/local/backup-encrypted.bash
| root
| Encrypted backup naar Backup2bit
| 23:30
| 1 x per dag
|

|}

== ldap-test ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| ldap-test
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|}

== xml-lb1, xml-lb2 en xml-test ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| xml-lb1
| /etc/init.d/hobby-firewall restart
| root
| Herstart Firewall
| 06:00 12:00 18:00 00:00
| 4 x per dag
|

|-
| xml-lb1
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|-
| xml-lb1
| /usr/local/hobbynet/local/backup-encrypted.bash >>/var/log/backup_encrypted.log
| root
| Encrypted backup naar Backup2bit
| 23:45
| 1 x per dag
|

|-
| xml-lb2
| /usr/local/hobbynet/local/backup-encrypted.bash >>/var/log/backup_encrypted.log
| root
| Encrypted backup naar Backup2bit
| 23:30
| 1 x per dag
|

|-
| xml-lb2
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|-
| xml-test
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|}
== userstore 1 en 2 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| userstore1 of userstore2
| /sbin/defragdisk
| root
| Defragmenteer de /disk partitie op de actieve storage server
| 03:00
| Elke 13e en 28e van de maand
|

|-
| userstore1 en userstore2
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|-
| userstore1
| /bin/bash /root/show_jch.sh >/dev/null
| root
| Controleer het aantal jch bestanden (Joomla cache bestanden)
| 10:55
| 1 x per dag
|

|-
| userstore1
| /usr/local/hobbynet/local/backup2bas
| root
| Backup van /disk naar nas bij Bas 
| 02:01
| Elke dag
|

|-
| userstore1
| /usr/local/hobbynet/local/backup2nas
| root
| Backup van /disk naar nas in het rack 
| 06:01
| Elke dag
|

|}

== nagios-lb1 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| nagios-lb1
| /usr/local/hobbynet/bin/sync_nagios
| root
| Synchroniseer nagios-lb1 naar nagios-lb2
| 00:00 06:00 12:00 18:00
| 6 x per dag
|

|}

== nagios-lb2 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|}

== db01 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| db01
| /usr/local/hobbynet/bin/database-onderhoud >/dev/null
| root
| Database onderhoud
| 02:36
| 1 x per dag
|

|}

== db02 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| db02
| /usr/local/hobbynet/bin/database-onderhoud >/dev/null
| root
| Database onderhoud
| 00:36
| 1 x per dag
|

|}

== hcc-db03 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| hcc-db03
| /usr/local/hobbynet/bin/database-onderhoud >/dev/null
| root
| Database onderhoud
| 02:36
| 1 x per dag
|

|}

== hcc-db04 ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| hcc-db04
| /usr/local/hobbynet/bin/database-onderhoud >/dev/null
| root
| Database onderhoud
| 00:36
| 1 x per dag
|

|}

== backup2bit ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_db01
| root
| Maak database dump en Rsync databases naar backup2bit
| 00:05
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_db02
| root
| Maak database dump en Rsync databases naar backup2bit
| 12:10
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_db03
| root
| Maak database dump en Rsync databases naar backup2bit
| 00:40
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_db04
| root
| Maak database dump en Rsync databases naar backup2bit
| 12:10
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_domein
| root
| Maak database dump en Rsync databases naar backup2bit
| 12:12
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_otrs
| root
| Maak database dump en Rsync databases naar backup2bit
| 00:35
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_mail-lb1
| root
| Maak database dump en Rsync databases naar backup2bit
| 00:40
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_mail-lb2
| root
| Maak database dump en Rsync databases naar backup2bit
| 12:40
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_server_configs
| root
| Backup server configs van alle servers
| 23:01
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/sync_www.hobby.nl
| root
| Sync backup.hcc.nl www.hobby.nl naar ns3
| 06:01 12:01 18:01
| 3x per dag

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_usrlocalhobbynet
| root
| Backup /usr/local/hobbynet naar /disk/backup/hobbynet
| 00:00
| Elke dag
|

|-
| backup2bit
| /usr/local/hobbynet/bin/backup_pxe
| root
| Backup /var/lib/tftpboot (van de PXE server) naar /disk/backup/pxe-int/pxe
| 23:55
| Elke dag
|

|}

== sftp ==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| sftp
| /usr/local/hobbynet/local/backup >>/var/log/backup.log
| root
| Backup server config naar backup2bit-int
| 23:45
| Elke dag
|

|-
| sftp
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|}

==logging==
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| logging
| apt-get clean -y >/dev/null ; apt-get update >/dev/null ;apt-get upgrade -d -y
| root
| Check op updates en download deze alvast ivm Nagios detectie
| 06:00 18:00
| 2 x per dag
|

|-
| logging
| /usr/local/hobbynet/bin/backup_etc
| root
| Trek een backup van de etc map, en zet die over naar backup2bit
| 22:00 
| Elke dag
|

|}

= alle servers =
{| class="wikitable"
| Server:
| '''Crontab entry'''
| '''user'''
| '''doel'''
| '''hoe laat'''
| '''hoe vaak'''
| '''Opmerking'''
|-

|-
| alle servers
| /home/bas/baskeys
| bas
| Update ssh keys voor bas
|
| Elk uur
|

|}

XML-RPC

2020-04-10T11:46:39Z

Hans:

= XML-RPC interface =

De LDAP server kan direct gemuteerd worden via een LDAP koppeling. Zie
de standaard LDAP pagina voor de uitleg welke poorten daarvoor gebruikt
kunnen worden.

Daarnaast is er de wens ontstaan om via een standaard protocol met de
LDAP omgeving te kunnen communiceren. Er is hiertoe een XML-RPC
koppeling ontwikkeld. XML-RPC is een standaard interface, waarmee het
mogelijk is om vanuit diverse omgevingen op een gestandaardiseerde
manier te communiceren.

== Globale functie omschrijving ==
* Algemene aanroepen
** Controleer of een gebruiker bestaat
** Wijzig het wachtwoord ('userPassword')
** Zoek een gebruiker (t.b.v. kantoor en/of LA-akties groeperingssecretaris)
** Maak een gebruiker aan (geef gebruiker een andere hccLogin waarde, maak ook bij HCCnet deze gebruiker aan)
** Controleer of een gebruiker zijn profiel al doorlopen heeft
** Haal de lijst met opgeheven accounts op
** Haal de lijst met bulletins van een hcc lid (OptIn)

* Aanroepen t.b.v. hcc partners
** Controleer of lidnummer/postcode correct is
** Controleer of lidnummer/postcode correct is, en tevens ingeschreven staat bij een specifieke IG

* Joomla template site functies (op basis van JoomlaToken)
** Maak een JoomlaToken
** Ruim een JoomlaToken op
** Pas mijn OptIn (bulletin inschrijving) aan
** Regel alles rondom Onderwerpen en de autorisatie hiervan
** Pas mijn wachtwoord aan

* Joomla kadernet site functies (op basis van JoomlaToken)
** Zoek een hcc kaderlid (t.b.v. de kaderleden zoekpagina)
** Pas mijn kadermail forwarding aan en toon ja/nee mijn GSM nummer
** Pas het kadernet e-mail wachtwoord aan
** Haal de lijst met alle groeperingen op
** Haal de lijst met alle kaderrollen op

* Joomla hcc.nl site (op basis van JoomlaToken)(mijn.hcc.nl vervanging)
** Pas mijn adresgegevens aan
** Pas mijn voorletters, voornaam, pseudoniem, telefoonnummer, GSM nummer etcetera aan
** Schrijf me in of uit op een bulletin
** Toon info over de kosten van een IG lidmaatschap
** Voer een wachtwoord reset uit op basis van een PWResetToken (een variant op JoomlaToken)
** Vraag een nieuwe HCC code aan, en stuur die per SMS

* Joomla hobby.nl site (op basis van JoomlaToken)(t.b.v. IDEAL betaling)
** Haal het aantal hobbyDomains op

* Aanroepen t.b.v. CRM (Microsoft Dynamics Cloud) koppeling
** Haal de dagelijkse synchronisatie bestanden op
** Werk in het CRM dan wel in LDAP de NAW gegevens bij
** Werk in het CRM dan wel in LDAP de IG gegevens van een lid bij

* HenZ
** Haal de lijst met opzeggers op
** Valideer de opzegdatum van een opgegeven gebruiker

=== Authenticatie ===

Alle aanroepen gebeuren op basis van authenticatie vanuit de aanroeper.
Dit valt uiteen in de volgende categorieën:
* gebruikersnaam ('hccLogin') en wachtwoord ('userPassword')
* hcc lidnummer ('hccLidnr'), Joomla token ('JoomlaToken') en website ('siteID')
* hcc lidnummer ('hccLidnr') en hcc code ('hccCode')
* beheerders-DN ('beheerLogin') en beheerders wachtwoord ('beheerPassword')
* partner-DN ('partnerLogin') en partner wachtwoord ('partnerPassword')

=== Aanroepen, gedaan via de bezoekersregistratie-proxy ===
(de bezoekersregistratie proxy is een mislukt project tbv de Android app van René Prins)
(deze proxy bestaat niet meer) 
Diverse aanroepen kunnen ook via de bezoekersregistratie-proxy aangeroepen worden. 
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
* GeefAlleGroeperingen
* GeefAlleKaderRollen
* GeefLocaties
* GeefLocatieNamen
De bezoekersregistratie aanroepen hebben 'JoomlaToken' als extra parameter nodig:
* LidBezoektBijeenkomst
* GeefBezoekersOverzicht
* GeefBezoekersAantallen
De aanroepen die over de proxy uitgevoerd worden dienen voorafgegaan te worden door een aanroep naar
* GeefMijnGegevens (dit geeft na validatie immers 'JoomlaToken' terug)

=== Resultaten ===

Alle aanroepen geven de volgende elementen terug:
* Naam van de uitgevoerde procedure ('Action')
* Resultaat van de uitgevoerde procedure ('Status')
* Een tekstuele vertaling van het resultaat dan wel de foutmelding ('Message')
* Tijdens de ontwikkelfase kan er debug-info teruggeleverd worden ('ExtraInfo')
Daarnaast geven specifieke aanroepen extra resultaten terug

== Technische omschrijving ==
XML-RPC beschrijving van acties in hcc.nl LDAP database

<pre>
2020.04.10 HaVe
XML-RPC Hobbynet versie 64.
</pre>

=== Kort overzicht ===
Dit is een lijst met alle XML-RPC aanroepen. In het volgende hoofdstuk worden ze in detail besproken.
<pre>
echo (partners)
ExpandeerPostcode (Joomla module Bas, tbv verhuizingen)
GebruikerBestaatControle (Joomla sites)
GeefAantalDomeinen (Joomla module Bas)
GeefAlleBulletins (Joomla module Bas)
GeefAlleGroeperingen (kadersite, forum, secr. portal, kantoor portal, hobbynet portal)
GeefAlleKaderRollen (forum, secr. portal, kantoor portal, hobbynet portal, Joomla module Bas)
GeefBezoekersOverzicht (bezoekersregistratie)
GeefBezoekersAantallen (bezoekersregistratie)
GeefhccEindDatum (HenZ)
GeefKadermailGegevens (kantoor portal)
GeefLocatieNamen (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefLocaties (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefMijnGegevens (Joomla inlog module Bas)
GeefMijnLidnummer (beheer.hcc.nl secretaris portal)
GeefOnderwerpen (Joomla template sites)
GeefSSOUrls (Joomla module Bas)
GeefUitgeschrevenLeden (Joomla sites, HenZ)
HaalIGBedragenOp (Joomla module Bas)
HaalOptInKeuzen (kantoor portal)
HaalTariefGroepenOp (kantoor portal)
HCCpartner (Partner aanroep)
HCCpartners (Partner aanroep)
IsDezeNaamNogBeschikbaar (aangeroepen vanuit de CRM omgeving)
IsDezePseudoniemNogBeschikbaar (kantoor portal)
IsHCCLid (vraagbaak aanroep)
IsKaderLid (in veel apps gebruikt)
LidBezoektBijeenkomst (bezoekersregistratie)
MaakGebruikerAan (mijnhcc.nl, maak hccnet account aan en ldap gebruikersnaam)
MaakOnderwerp (Joomla template sites)
MaakPWResetToken (Joomla module Bas)
MuteerGroeperingSamenstelling (Joomla kadernet module Bas)
MuteerOnderwerp (Joomla template sites)
MuteerOnderwerpAutorisatie (Joomla template sites)
NormaliseerTelefoon (Joomla module Bas)
PasHccLoginAan (Joomla module Bas)(enkel Hobbynet)
PasInteressegroepAan (Joomla module Bas)
PasKaderGegevensAan (kadersite, Joomla module Bas)
PasOptInKeuzeAan (Joomla module Bas)
PasPseudoniemAan (Joomla module Bas)
PasUserWachtwoordAan (beheer.hcc.nl Hobbynet gebruikers portal)
PasWachtwoordAan (Joomla module Bas)
RegistreerGast (bezoekersregistratie)
ResetHCCCode (Joomla module Bas)
RuimJoomlaTokenOp (Joomla module Bas)
SchrijfNietlidInOpBulletin (Joomla site bulletin module Bas)
SchrijfNieuwLidIn (Joomla CRM module Bas)
ToonOnderwerpAutorisatie (Joomla template sites)
UpdateMobiel (Joomla module Bas)
UpdateNAW (Joomla module Bas)
Upload_CSV_bestand (CRM webproxy)
ValideerPWResetToken (Joomla module Bas)
ValideerWachtwoordEisen (Joomla module Bas)
Verwerk_JSON_mutatie (CRM webproxy)
VerwijderNietLidRecord (Joomla beheer module Bas)
VerwijderOnderwerp (Joomla template sites)
VraagLidgegevensTokenAan (bezoekersregistratie)
WijzigGebruikersGegevens (kantoor en Joomla template sites, ww aanpassen van gebruiker)
ZoekGroeperingsLid (secr. portal, kantoor portal, hobbynet portal)
ZoekHCCLid (VZ portal)
ZoekKaderLeden (Joomla kadernet module Bas)
</pre>

=== HCC-ldap en/of HCC-net aanroepen ===

<pre>
// ** Joomla sites, www.hcc.nl **
// 1.1 controleer of een gebruiker bestaat - optie 1
// (authenticatie op basis van hccLidnr en hccCode)
// Alleen bedoeld om gebruikers op www.hcc.nl op basis van het lidnr het ww te laten wijzigen
$request = xmlrpc_encode_request(
'GebruikerBestaatControle',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $method,
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd');
if ($hccLidnr != '') { $reply['hccLidnr'] = $hccLidnr; }
if ($hccLogin != '') { $reply['hccLogin'] = $hccLogin; }
if ($hccPseudoniem != '') { $reply['hccPseudoniem'] = $hccPseudoniem; }
if ($cn != '') { $reply['cn'] = $cn; }
if ($sn != '') { $reply['sn'] = $sn; }
if ($mail != '') { $reply['mail'] = $mail; }
if ($mailHccnet != '') { $reply['mailHccnet'] = $mailHccnet; }
if ($hccRegio != '') { $reply['hccRegio'] = $hccRegio; }
if ($hccIG != '') { $reply['hccIG'] = $hccIG; }
if ($hccRol != '') { $reply['hccRol'] = $hccRol; }
if ($ProfielBekend != '') { $reply['ProfielBekend'] = $ProfielBekend; }

// ** Portal mijn.hcc.nl **
// 2.1 wijzig wachtwoord - optie 1
// op basis van hccLidnummer en hccCode
// Essentiele aanroep, gebruikt vanuit mijnhcc.nl (lidnr + hccCode)
// Ook gebruikt t.b.v. wachtwoord-vergeten procedure op de Joomla template sites
// Als de profielpagina nog niet is doorlopen wordt deze aanroep afgekeurd.
//
// Ook gebruikt om gebruiker rechtstreeks vanaf Joomla template sites wachtwoord te
// laten aanpassen (op basis van lidnummer en hcc code)
//
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'WijzigGebruikersGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gewijzigd',
'hccLogin' => $hccLogin,
'cn' => $cn,
'sn' => $sn);

// 2.3 wijzig wachtwoord - optie 3
// (t.b.v. VZ-portal)
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
// * Als hccLidnr gevuld is, dan wordt hccLidnr gebruikt om het juiste record te zoeken
// Als hccLidnr leeg is, dan wordt hccLogin gebruikt om het juiste record te zoeken
// 1 van beide velden MOET aanwezig zijn
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'beheerLogin' => $beheerLogin, // beheerder lidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

// ** t.b.v. ophalen van de opt-in keuzes op de beheer pagina **
// 2.6 Geef de complete lijst met opt-ins van dit lid
// (LET OP: authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'HaalOptInKeuzen',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalOptInKeuzen',
'Status' => 'TRUE',
'Message' => 'OptInLijst opgehaald',
'hccOptIn' => $hccOptIn);
Output negatief:
$reply = array(
'Action' => 'HaalOptInKeuzen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gebruikersnaam, pseudoniem
// en wachtwoord tevens in LDAP op
// (authenticatie op basis van hcc lidnummer en hcc-code)
// ** Deze gegevens worden doorgezet naar hccnet.nl (action=4) **
//
$request = xmlrpc_encode_request(
'MaakGebruikerAan',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_hccLogin' => $nieuw_hccLogin,
'nieuw_userPassword' => $nieuw_userPassword,
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'TRUE',
'Message' => 'Gebruiker aangemaakt',
'mail' => $mail,
'hccPseudoniem' => $hccPseudoniem);
Output negatief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gebruikersnaam bestaat al' |
'Pseudoniem bestaat al' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!');

// H.3 Haal al mijn gegevens
// (wordt gebruikt door de Joomla inlogmodule)
// Voor gebruik over de proxy t.b.v. de Android app kan compact=TRUE meegegeven worden.
// In dat geval worden enkel de meest essentiele gegevens teruggestuurd
// Voor gebruik na MaakGebruikerAan kan deze functie ook op basis van hccLidnr en JoomlaToken
// worden aangeroepen
// De optionele parameter 'PrevSiteID' is bedoeld voor single-sign-on. Op basis van JoomlaToken,
// hccLidnr en PrevSiteID worden dan de credentials gevalideerd. Als die kloppen, geeft deze aanroep
// een 2e JoomlaToken terug, maar dan uitgegeven op basis van SiteID.
// Als PrevSiteID leeg is, dan wordt het token op basis van siteID gevalideerd.
$request = xmlrpc_encode_request(
'GeefMijnGegevens',
array(
['hccLogin' => $hccLogin,
'userPassword' => $userPassword,]
['hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,]
['PrevSiteID' => $PrevSiteID,]
['compact' => $compact,] // leeg of 'TRUE'
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd',
'hccLidnr' => $hccLidnr,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccAutorisatie' => $hccAutorisatie,
'cn' => $cn,
'sn' => $sn,
'JoomlaToken' => $JoomlaToken,
['hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'givenname' => $givenname,
'hccAanhef' => $hccAanhef,
'hccGeslacht' => $hccGeslacht,
'hccTussenVoegsels' => $hccTussenVoegsels,
'hccAchternaam' => $hccAchternaam,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward,
'hccKaderToonMobiel' => $hccKaderToonMobiel,
'hccOptIn' => $hccOptIn,
'ProfielBekend' => $ProfielBekend,
'hccBeginDatum' => $hccBeginDatum,
['kadermail_omvang' => $Formaat, // in Mb
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald;]]);

Output negatief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// ** t.b.v. aanpassen van de opt-in keuzes op een Joomla site **
// H.4 Pas 1 opt-in van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// Als hccLidnummer gevuld is, dan is dat het lidnummer waar de mutatie op moet worden uitgevoerd.
// Dat kan alleen als de aanvrager HCC#LAD of HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasOptInKeuzeAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
['hccLidnummer' => $hccLidnummer,]
'hccOptIn' => $hccOptIn,
'actie' => 'Nieuw' | 'Weg',
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'TRUE',
'Message' => 'OptIn aangepast');
Output negatief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// H.5 Zoek kaderleden NAW (t.b.v. de Joomla kadersite)
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
//
// * Er dient minstens 1 zoekcriterium opgegeven te worden.
// * Als zowel hccRegio als tegelijk ook hccIG opgegeven worden is de uitkomst onvoorspelbaar.
// * Als compact=TRUE worden enkel lidnummer, cn en sn in het antwoord gezet
$request = xmlrpc_encode_request(
'ZoekKaderLeden',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
['hccRegio' => $hccRegio,]
['hccIG' => $hccIG,]
['hccRol' => $hccRol,]
['hccLocatie' => $hccLocatie,]
['achternaam' => $achternaam,]
['compact' => $compact])); // leeg of 'TRUE'

Output positief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'TRUE',
'Message' => 'Kaderleden opgevraagd'
'Kaderleden' => array(
'hccLidNummer' => $hccLidNummer,
'hccRol' => $hccRol,
'hccAanhef' => $hccAanhef,
'givenname' => $givenname,
'cn' => $cn,
'sn' => $sn,
'hccWoonplaats' => $hccWoonplaats,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'hccKaderMail' => $hccKaderMail);

Output negatief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token']);

// H.9 PasKaderGegevensAan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
// Om de kaderleden hun forward in te laten stellen,
// en tegelijkertijd de opt-in / opt-out voor hccToonMobiel te laten regelen
// Kan tevens het kader email wachtwoord aanpassen
$request = xmlrpc_encode_request(
'PasKaderGegevensAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'hccKaderForward' => $hccKaderForward, // '' | $mail | $mailHccNet
'hccKaderToonMobiel' => $hccKaderToonMobiel, // 'TRUE' | 'FALSE' | 'NULL'
['nieuw_kaderPassword' => $nieuw_kaderPassword]));

Output positief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'TRUE',
'Message' => 'kadergegevens aangepast');

Output negatief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token'|'Alleen kaderleden mogen deze aanroep uitvoeren']);

// ** Portal beheer.hcc.nl
// ** H.10 PasUserWachtwoordAan
// ** Betalende Hobbynet gebruikers kunnen hiermee hun wachtwoord aanpassen
// (authenticatie op basis van hccLogin en userpassword)
$request = xmlrpc_encode_request(
'PasUserWachtwoordAan',
array(
'hccLogin' => $username,
'userpassword' => $password,
'hobbynetAccount' => $hobbyname,
'nieuw_wachtwoord' => $nieuw_wachtwoord,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!' |
'account $hobbynetAccount behoort niet bij gebruiker $hccLogin' |
'Kan ww van account $hobbynetAccount niet aanpassen');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.11 Pas het pseudoniem van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasPseudoniemAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccPseudoniem' => $hccPseudoniem,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'TRUE',
'Message' => 'Pseudoniem aangepast');
Output negatief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials' | 'Pseudoniem bestaat al');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.12 Controleer of een opgegeven wachtwoord aan de minimum eisen voldoet
$request = xmlrpc_encode_request(
'ValideerWachtwoordEisen',
array(
'userPassword' => $userPassword,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'TRUE',
'Message' => 'Wachtwoord voldoet aan de minimale eisen');
Output negatief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'FALSE',
'Message' => 'Wachtwoord voldoet niet aan de minimale eisen');

// ** H.13 PasWachtwoordAan
// ** Vanuit een Joomla template site kunnen gebruikers hiermee hun eigen wachtwoord aanpassen
// (authenticatie op basis van JoomlaToken, lidnummer, siteID. Extra controle via userpassword)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'userpassword' => $password,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.13.1 PasWachtwoordAan
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee hun eigen wachtwoord resetten
// (authenticatie op basis van PWResetToken en hccLogin).
// (Als de aanroep geslaagd is, dan is daarna het PWResetToken ongeldig)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.14 MaakPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee een wachtwoord reset aanvragen
// Deze aanroep geeft naast het PWResetToken ook het contact emailadres mee terug,
// zodat Joomla een reset-mail kan sturen
// (acties op basis van gebruikersnaam)
$request = xmlrpc_encode_request(
'MaakPWResetToken',
array(
'hccLogin' => $username,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'TRUE',
'PWResetToken' => $PWResetToken,
'mail' => $mail,
'Message' => 'Password reset token aangemaakt');
Output negatief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');

// ** H.15 ValideerPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers een wachtwoord reset aanvragen
// Controleer dat het hier om een bestaand (en nog niet gebruikt) token gaat
$request = xmlrpc_encode_request(
'ValideerPWResetToken',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'TRUE',
'Message' => 'Password reset token gevonden');
Output negatief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'FALSE',
'Message' => 'hccLogin bestaat niet' | 'PWResetToken bestaat niet');

// H.16 Ruim een bestaand JoomlaToken op
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'RuimJoomlaTokenOp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'SiteID' => $siteID,
['ServerID' => gethostname(),]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'TRUE',
'Message' => 'JoomlaToken opgeruimd');
Output negatief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'FALSE',
'Message' => 'Onjuist JoomlaToken');

// ** Joomla module
// ** H.17 GeefAantalDomeinen
// ** Vraag het aantal domeinen op van een betalende Hobbynet gebruiker (t.b.v. IDEAL betaling)
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'GeefAantalDomeinen',
array(
'JoomlaToken' => $JoomlaToken,
'hccLidnr' => $hccLidnr,
'hobbynetAccount' => $hobbyname,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'TRUE',
'hobbynetAccount' => $hobbyname,
'AantalDomeinen' => $aantalDomeinen,
'Message' => 'aantal domeinen opgevraagd');
Output negatief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'account $hobbynetAccount behoort niet bij deze gebruiker');

// ** Joomla module
// ** H.18 ResetHCCCode
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'beheerLogin' => $beheerLogin, // geheime credentials van de site
'beheerPassword' => $beheerPassword, // geheime credentials van de site
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** Joomla module
// ** H.18.1 ResetHCCCode (hcc kantoor aanroep)
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'JoomlaToken' => $JoomlaToken, // Het Joomla token van de sessie van de kantoor medewerker
'hccLidnr' => $hccLidnr, // Het lidnummer van de kantoor medewerker
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** t.b.v. aanpassen van de hccLogin van een gebruiker (Hobbynet functie op Joomla site) **
// H.19 Pas de hccLogin van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// hccLidnummer is het lidnummer waar de mutatie op moet worden uitgevoerd
// Kan alleen als de aanvrager HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasHccLoginAan',
array(
'hccLidnr' => $hccLidnr, // lidnummer van de aanvrager
'JoomlaToken' => $JoomlaToken, // JoomlaToken van de aanvrager
'hccLidnummer' => $hccLidnummer, // pas de hccLogin van dit lidnummer aan
'hccLogin' => $hccLogin, // dit is de gewenste nieuwe hccLogin
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'TRUE',
'Message' => 'hccLogin aangepast');
Output negatief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' |
'Onjuiste credentials' |
'Gebruikersnaam al in gebruik');

// 3.1 Geef mijn lidnummer
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'GeefMijnLidnummer',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'TRUE',
'Message' => 'Lidnummer opgevraagd',
'hccLidnr' => $hccLidnr);
Output negatief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.2 Controleer of de gebruikersnaam op dit moment bestaat
// (geen authenticatie)
// ** Deze gegevens worden opgevraagd bij hccnet.nl (action=3) **
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezeNaamNogBeschikbaar',
array(
'nieuw_hccLogin' => $nieuw_hccLogin,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Gebruikersnaam is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Gebruikersnaam bestaat al');

// ** Enkel voor gebruik vanaf de kantoor portal **
// ** t.b.v. het hernoemen van accounts in CRM **
// 8.3 Controleer of een Pseudoniem op dit moment bestaat ??? NIET GEBRUIKT ??
// (geen authenticatie)
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezePseudoniemNogBeschikbaar',
array(
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem));
Output positief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Pseudoniem is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Pseudoniem bestaat al');

// ** t.b.v. de verenigingszaken zoekpagina **
// A.1 Zoek alle bij de query passende hcc leden
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
$request = xmlrpc_encode_request(
'ZoekHCCLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Groepering' => $Groepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (eerste deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| emailadres | (eerste deel van) e-mail adres |
| gebruikersnaam | (eerste deel van) de login naam |
| pseudoniem | (eerste deel van) het pseudoniem |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| niet_leden | het volledige niet-lid lidnummer |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'ZoekMethode' => $ZoekMethode,
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' => array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'sn' => $sn,
'givenName' => $givenName,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccHuisToevoeging' => $hcchuisToevoeging,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'ProfielBekend' => 'TRUE' | 'FALSE'])*);
Output negatief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. beheer.hcc.nl **
// A.3 Zoek alle bij de query passende hcc leden van deze groepering
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'ZoekGroeperingsLid',
array(
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Groepering' => $groepering,
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Bijeenkomst' => $Bijeenkomst,] // Alleen voor gebruik op de
// bijeenkomsten aanwezigheidsregistratie pagina
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| nieuwe_leden | YYYYMMDD vanaf waar gezocht moet worden |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| kaderleden | n.v.t. |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' =>
[array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'cn' => $cn,
'sn' => $sn,
'givenName' => $givenName,
'hccAchternaam' => $hccAchternaam,
'hccTussenVoegsels => hccTussenVoegsels,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem)]*));
Output negatief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker(s) niet gevonden' | 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten **
// A.4 Lid bezoekt bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'LidBezoektBijeenkomst',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
'hccLidnr' => $hccLidnr, // lid dat aanwezig gemeld moet worden
['correctie' => $hccLidnr,] // lid dat gecorrigeerd moet worden
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'TRUE',
'Message' => 'Bezoeker weggeschreven',
'Results' => array(
// info van deze bezoeker
'cn' => $cn, // cn (Verbeek, H.J.)
'hccGeslacht' => $hccGeslacht, // hccGeslacht van de bezoeker
'groeperingslid' => $groeperingslid, // TRUE of FALSE: is deze persoon lid van deze groepering
'mijnGroeperingen' => $mijnGroeperingen, // komma-gescheiden lijst (regio, [hccIG]*)
'aantalBezoeken' => $aantalBezoeken, // hoe vaak heeft dit lid deze bijeenkomst bezocht
// info van de bijeenkomst
'AantalBezoekers' => $AantalBezoekers); // aantal bezoekers van deze bijeenkomst
Output negatief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.5 Vraag Lidgegevens token aan (geldig voor dit lid, en deze groepering, op deze datum)
// Als geen datum gegeven is, dan is het token vandaag geldig
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'VraagLidgegevensTokenAan',
array(
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'hccLidnr' => $hccLidnummer, // vraag het token voor dit lid aan
'groepering' => $groepering, // zoek binnen deze groepering
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'TRUE',
'Message' => 'Token opgevraagd',
'groepering' => $Groepering,
'token' => $token,
'sn' => $sn);
Output negatief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.6 Toon bezoekersoverzicht
// (authenticatie op basis van lidnummer en bezoekersregistratie token)
$request = xmlrpc_encode_request(
'GeefBezoekersOverzicht',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'token' => $token,
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'TRUE',
'Message' => 'Bezoekersoverzicht opgevraagd',
'Bezoekers' => $bezoekers,
['Locatie' => $Locatie]);
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// A.7 Geef het array met alle locaties
// (of beperk dit tot de locaties van de groepering $Groepering)
// Desgewenst worden alle resultaten waarbij hccToonInJoomla aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// Desgewenst worden alle resultaten waarbij ToonOpKaderNet aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocaties',
array(
['Groepering' => $hccGroepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']);
Output positief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);
Output negatief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'FALSE',
'Message' => 'Locaties niet beschikbaar',
'ExtraInfo' => 'Geen locaties gevonden voor groepering $hccGroepering',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);

// A.8 Registreer een niet-hcclid als bezoeker tijdens een bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'RegistreerGast',
array(
'AccountNaam' => $lidnr, // credentials
'AccountCode' => $AccountCode, // credentials
'token' => $token, // credentials
'Bijeenkomst' => $groepering,
'geslacht' => $geslacht,
'naam' => $naam,
'mail' => $mail,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'buitenland' => $buitenland,
['nietLidNummer' => $nietLidNummer,]
['instructies' => $instructies,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $aanroep,
'Status' => 'TRUE',
'Message' => 'Niet-lid als bezoeker geregistreerd',
'Result' => $result_array);

// A.9 Geef het array met alle locatienamen
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocatieNamen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']));
['KaderMutatieFilter' => '' | 'TRUE']));

Output positief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));
Output negatief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'FALSE',
'Message' => 'Locatienamen niet beschikbaar',
'ExtraInfo' => 'Geen locatienamen gevonden',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));

// A.10 Schrijf een niet-lid in op een bulletin
// (2019.12.05: wordt actief gebruikt in Joomla module)
// Deze aanroep mag *ook* worden gebruikt om een wel-lid in te schrijven.
// Voorwaarde is dat bewezen is dat er controle bestaat over het opgegeven email adres
$request = xmlrpc_encode_request(
'SchrijfNietlidInOpBulletin',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'hccOptin' => $hccOptin, // bulletin waarop ingeschreven wordt
'hccOptinSource' => $hccOptinSource, // site waar aanmelding vandaan komt
'Email' => $Email, // niet-lid: email adres
'Naam' => $Naam, // niet-lid: naam
['hccLidNummer' => $hccLidNummer,] // optioneel: ik ben lid, dit is mijn lidnummer
['Postcode' => $Postcode,] // optioneel: niet-lid: postcode
['Huisnummer' => $Huisnummer,] // optioneel: niet-lid: huisnummer
['hccGeslacht' => $hccGeslacht,] // optioneel: niet-lid: geslacht (M/V/O)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'TRUE',
'Message' => 'Inschrijving op bulletin gelukt');
Output negatief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist',
'ExtraInfo' => 'Invalid DN syntax' |
'Invalid credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.11 Toon bezoekers aantallen
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'GeefBezoekersAantallen',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'token' => $token,
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersAantallen',
'Status' => 'TRUE',
'Message' => 'BezoekersAantallen opgevraagd',
'Datum' => $datum,
'Bijeenkomst' => $Bijeenkomst,
'Bezoekers' => array(
[HCC!seniorenacademie] => Array(
[Gorinchem] => 15
[Woerden] => 36)
...));
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersAantallen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// ** t.b.v. Joomla module Bas
// A.12 GeefAlleBulletins
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleBulletins',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefAlleBulletins',
'Status' => 'TRUE',
'Message' => 'Bulletins opgevraagd',
'bulletins' => $bulletins);

// ** t.b.v. Joomla module Bas
// A.13 ExpandeerPostcode
// (geen authenticatie)
$request = xmlrpc_encode_request(
'ExpandeerPostcode',
array(
'postcode' => $postcode,
'huisnummer' => $huisnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'ExpandeerPostcode',
'Status' => 'TRUE',
'Message' => 'Postcode opgevraagd',
'detailgegevens' => $detailgegevens);

// ** t.b.v. Joomla module Bas
// A.25 UpdateNAW
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateNAW',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'geslacht' => $geslacht,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'toevoeging' => $toevoeging,
'straat' => $straat,
'woonplaats' => $woonplaats,
'landcode' => $landcode,
'email' => $email,
'voornaam' => $voornaam,
'voorletters' => $voorletters,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateContactGegevens',
'Status' => 'TRUE',
'Message' => 'Contactgegevens bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.18 NormaliseerTelefoon
// (geen authenticatie)
$request = xmlrpc_encode_request(
'NormaliseerTelefoon',
array(
'hccLand' => $hccLand,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'NormaliseerTelefoon',
'Status' => 'TRUE',
'Message' => 'Telefoonnummer genormaliseerd',
'Telefoonnummer' => $Telefoonnummer);

// ** t.b.v. Joomla module Bas
// A.20 UpdateMobiel
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateMobiel',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateMobiel',
'Status' => 'TRUE',
'Message' => 'Mobiel nummer bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.21 HaalIGBedragenOp
// Geef alle IG's waar je zelf lid van kunt worden, inclusief het bijbehorende bedrag
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalIGBedragenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalIGBedragenOp',
'Status' => 'TRUE',
'Message' => 'Interessegroepen en bedragen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.22 HaalTariefGroepenOp
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalTariefGroepenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalTariefGroepenOp',
'Status' => 'TRUE',
'Message' => 'Tariefgroepen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.23 PasInteressegroepAan
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasInteressegroepAan',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
['nieuw' => $IG_lijst_nieuw,]
['weg' => $IG_lijst_weg,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'PasInteressegroepAan',
'Status' => 'TRUE',
'Message' => 'IG keuzen aangepast');

// ** t.b.v. Joomla module Bas
// A.24 GeefSSOUrls
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefSSOUrls',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefSSOUrls',
'Status' => 'TRUE',
'SSO_urls' => $sso_urls,
'Message' => 'Single Sign On URLs opgevraagd');

// ** t.b.v. de verenigingszaken beheer pagina **
// A.26 Verwijder een niet-lid record
$request = xmlrpc_encode_request(
'VerwijderNietLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'hccLidnr' => $hccLidnummer, // het te verwijderen niet-lid nummer
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

Output positief:
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'TRUE',
'Message' => 'Niet-lid record verwijderd',

Output negatief:
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'FALSE',
'Message' => 'Niet-lid record niet gevonden');
$reply = array(
'Action' => 'VerwijderNietLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** HenZ **
// ** t.b.v. daily cron job **
// ** t.b.v. dagelijkse opschoon jobs Joomla template sites **
// C.1 Vraag de lijst met uitgeschreven leden op
// Dit kan beperkt worden tot een bepaalde regio of interessegroep
// Daarnaast kan het tijdvak waarin gezocht wordt vrij gekozen worden
// (gesteld dat de LDAP database nog leden uit die periode bevat)
// Antwoord: lijst met (lidnummer, hccLogin, sn,
// datum einde lidmaatschap (formaat:YYYYMMDD))

==> GeefUitgeschrevenLeden <== (oud: GeefOpgezegdeLeden)

$request = xmlrpc_encode_request(
'GeefUitgeschrevenLeden',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccRegio' => $hccRegio, // of leeg
'hccIg' => $hccIg, // of leeg
'datum_vanaf' => $datum_sinds, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: 3 dagen geleden)
'datum_tot' => $datum_tot, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: vandaag)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'TRUE',
'Message' => 'Uitgeschreven leden',
['hccRegio' => $hccRegio,]
['hccIg' => $hccIg,]
['datum_vanaf' => $datum_vanaf,]
['datum_tot' => $datum_tot,]
['Results' => array(
[array(
'hccLogin' => $hccLogin,
'hccLidNummer' => $hccLidnummer,
'sn' => $sn,
'DatumEindeLidmaatschap' => $DatumEindeLidmaatschap)]*);
Output negatief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');
</pre>

=== HCCpartner aanroepen ===
(interface versie 1) 
(oude interface, niet meer gebruiken!)

<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.1 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartner',
array('ControleerHCCLidmaatschap',
array('partnerLogin', $partnerLogin),
array('partnerPassword', $partnerPassword),
array('hccLidnummer', $hcclidnummer),
array('postcode', $postcode)));
Output positief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'TRUE'));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'));
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'),
array('Message', 'Onjuiste credentials'));

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartner',
array(
'OnbekendeAanroep',
array('parameter', $iets)));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'OnbekendeAanroep'),
array('Status', 'FALSE'),
array('Message', 'Opdracht onbekend'));
</pre>

=== HCCpartners aanroepen ===
(interface versie 2)

<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.2 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'ControleerHCCLidmaatschap',
'partnerLogin' => $partnerLogin,
'partnerPassword' => $partnerPassword,
'hccLidnummer' => $hcclidnummer,
'postcode' => $postcode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'TRUE',
['ExtraInfo' => 'groepering=$groepering']); // als de partner beperkt is tot 1 groepering
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE');
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'OnbekendeAanroep',
'parameter' => $iets));
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'OnbekendeAanroep',
'Status' => 'FALSE',
'Message' => 'Opdracht onbekend');
</pre>

=== HCC-kader aanroepen ===

<pre>
// ** beheer.hcc.nl **
// F.2 Controleer of dit een kaderlid is
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'IsKaderLid',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'TRUE',
'Message' => 'Is kaderlid',
'hccLidnr' => $hccLidnr,
'cn' => $cn,
'sn' => $sn,
'hccRol' => $hccRol,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward);
Output negatief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Is geen kaderlid');

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.4 Vraag alle groeperingen op
// Het is mogelijk om een groepering te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// ToonInOverzichtenFilter : attribuut 'hccToonInOverzichten'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// BulletinsFilter : attribuut 'hccBulletins'
// EmailFilter : attribuut 'hccFunctionalEmail'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleGroeperingen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['ToonInOverzichtenFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['BulletinsFilter' => '' | 'TRUE',]
['EmailFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE'));
Output positief:
$reply = array(
'Action' => 'GeefAlleGroeperingen',
'Status' => 'TRUE',
'Message' => 'Lijst met groeperingen opgevraagd',
'Result' => $groeperingen,
['JoomlaFilter' => 'TRUE',]
['ToonInOverzichtenFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']);

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.5 Vraag alle kaderrollen op
// Het is mogelijk om een kaderrol te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleKaderRollen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']));
Output positief:
$reply = array(
'Action' => 'GeefAlleKaderRollen',
'Status' => 'TRUE',
'Message' => 'Lijst met kaderrollen opgevraagd',
'Result' => $kaderrollen,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']);

// ** t.b.v. de kantoor-beheerpagina **
// F.9 Geef de gevevens van de mailbox van dit kaderlid
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
$request = xmlrpc_encode_request(
'GeefKadermailGegevens',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer));
Output positief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'kadermail_omvang' => $Formaat,
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald);
Output negatief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid'));

// ** t.b.v. de Joomla Kadernet module **
// * F.10 MuteerGroeperingSamenstelling
// (authenticatie op basis van lidnummer, JoomlaToken en siteID en als extra hccCode van de aanvrager)
$request = xmlrpc_encode_request(
'MuteerGroeperingSamenstelling',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccCode' => $hccCode,
'groepering' => $groepering,
'hccLidnummer => $hccLidnummer, // lidnummer van het te muteren hcc lid
'hccRol' => $hccRol, // de nieuwe dan wel op te heffen rol
// de rol 'ALLES_WEG' ruimt alle rollen van dit hcc lid voor deze groepering op
'actie' => 'Nieuw' | 'Weg',
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress,]
Output positief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'TRUE',
'Message' => 'Groepering samenstelling aangepast',
['ExtraInfo' => 'Bedankmail gestuuurd aan ex-kaderlid']);
Output negatief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid' |
'Oude rol niet gevonden' |
'Nieuwe rol kan niet samen met bestaande rol' |
'Alleen voorzitter of secretaris kan kadermutaties uitvoeren']);
</pre>

=== HCC-groepering aanroepen ===

<pre>

// I.2 controleer of een gebruiker bestaat op basis van de combinatie
// lidnummer + postcode + huisnummer
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
// (alternatieve authenticatie mogelijk door lidnummer + hcc-code in te vullen)
//
// Aan de aanroeper worden zekere eisen gesteld:
// * dient een rol te vervullen binnen de groepering 'FOR'(forum)
// * dan wel dient de rol 'VRBK' (vraagbaak) te vervullen binnen een groepering
//
// Er wordt door de gehele leden-database gezocht, waarna terug wordt gegeven
// * of dit hcc lid inderdaad bestaat
// en, als het om een aanvraag van een vraagbaak vrijwilliger gaat,
// * tevens of het gezochte hcc lid deel uitmaakt van zijn groepering

$request = xmlrpc_encode_request(
'IsHCCLid',
array(
'hccLogin' => [$hccLogin | $hccLidnummer],
'userPassword' => [$userPassword | $hccCode],
'zoekhccLidnr' => $zoekhccLidnr,
'zoekhccPostcode' => $zoekhccPostcode,
'zoekhccHuisnr' => $zoekhccHuisnr,
'zoekgroepering' => $zoekgroepering));
Output positief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gecontroleerd',
['Groeperingslid' => $IsGroeperingLid]));
Output negatief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker bestaat niet' |
'Onjuiste credentials' |
'Wel HCC lid, maar geen lid van groepering $groepering' |
'Onvoldoende rechten' |
'Vul alle verplichte velden in!'));
</pre>

=== HenZ aanroepen ===

<pre>

// I.3 Geef de einddatum van een actief dan wel uitgeschreven lid
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'GeefhccEindDatum',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'TRUE',
'hccLidnummer' => $hccLidnummer,
'hccLogin' => $hccLogin,
'hccEindDatum' => $hccEindDatum ('yyyymmdd' | ''));
Output negatief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Invalid credentials' |
'Lidnummer niet gevonden');
</pre>

=== (Forum,vraagbaak) onderwerpen ===

<pre>
// L.1 MaakOnderwerp
$request = xmlrpc_encode_request(
'MaakOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'description' => $description,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp is aangemaakt',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster');

// L.2 VerwijderOnderwerp

$request = xmlrpc_encode_request(
'VerwijderOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'TRUE',
'onderwerp' => $onderwerpID,
'Message' => 'Onderwerp is verwijderd',
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Ruim eerst alle geautoriseerde gebruikers op' |
'Kan onderwerp niet verwijderen');

// L.3 GeefOnderwerpen
// Geef het array met de lijst van onderwerpen voor de betreffende groepering
//
$request = xmlrpc_encode_request(
'GeefOnderwerpen',
array(
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'TRUE',
'Message' => 'Onderwerpen opgevraagd',
'onderwerpen' => $onderwerpen); // het array met onderwerpen
Output negatief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!');

// L.4 MuteerOnderwerp
// Pas de description van een onderwerp aan
//
$request = xmlrpc_encode_request(
'MuteerOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'description' => $description,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp aangepast',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Onderwerp behoort bij andere groepering');

// L.5 MuteerOnderwerpAutorisatie
// Geef kaderlid $kaderLidNr de autorisatie MOD, VRBK of RED bij onderwerp $onderwerp
// (of haal die autorisatie weg)
$request = xmlrpc_encode_request(
'MuteerOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'onderwerp' => $onderwerpID,
'kaderLidNr' => $kaderLidNr,
'hccAutorisatie' => 'MOD' | 'VRBK' | 'RED',
['verwijder' => 'TRUE']));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Onderwerp autorisatie aangepast');
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Geen kaderlid' |
'Onjuiste autorisatie opgegeven' |
'Onderwerp bestaat niet');

// L.6 ToonOnderwerpAutorisatie
$request = xmlrpc_encode_request(
'ToonOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Autorisaties opgehaald',
'onderwerp' => $onderwerpID,
'description' => $description,
'autorisaties' =>
[Array(
'hccLidnummer' => $hccLidnummer
'cn' => $cn
'hccAutorisatie' => {komma-gescheiden autorisaties})]);
Output negatief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet');
</pre>

=== Microsoft Dynamics Cloud (Cayentis) onderwerpen ===

<pre>
// M.1 Upload_CSV_bestand
// De CRM proxy upload de dagelijkse CSV synchronisatie-bestanden naar de XML-RPC server
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Upload_CSV_bestand',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'CSV_bestand_type' => '1' | '2' | '3' , // 1=Contactpersonen/Hoofdlidmaatschappen
// 2=Gremiumlidmaatschap codes
// 3=Gremiumlidmaatschappen
'CSV_bestand' => $CSV_bestand)); // het CSV bestand (base64 encoded)
Output positief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'TRUE',
'Message' => 'Bestand opgeslagen');
Output negatief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.2 SchrijfNieuwLidIn
//
// Maak in het CRM een nieuw HCC lid aan
// De NAW gegevens worden in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'SchrijfNieuwLidIn',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'NAWgegevens' => $NAW_Array,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress);
// $NAW_array = array(
// 'GeboorteDatum' => $geboortedatum,
// 'Geslacht' => $geslacht,
// 'Voornaam' => $voornaam,
// 'Voorletters' => $voorletters,
// 'Tussenvoegsel' => $tussenvoegsel,
// 'Achternaam' => $achternaam,
// 'Straatnaam' => $straatnaam,
// 'Huisnummer' => $huisnummer,
// 'HuisnummerToevoeging' => $huisnummertoevoeging,
// 'Woonplaats' => $woonplaats,
// 'Postcode' => $postcode,
// 'Land' => $land,
// 'Telefoonnummer' => $telefoonnummer,
// 'MobielNummer' => $mobielnummer,
// 'Mail' => $mail,
// 'IBAN' => $IBAN,
// 'Interessegroep' => $IGs, // komma-gescheiden lijst met IG's
// 'Geschenk' => $geschenk,
// 'Actiecode' => $actiecode,
// 'Voorwaarden' => $Akkoord); // 'Akkoord'
)
Output positief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'TRUE',
'Message' => 'nieuw lid ingeschreven',
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode);
Output negatief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.3 Verwerk_JSON_mutatie
// De CRM proxy kan NAW en/of IG mutaties en/of hccCode mutaties live doorgeven
// Deze gegevens worden in JSON in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Verwerk_JSON_mutatie',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'mutatie_type' => '1' | '2', // 1=Contactpersoon/Hoofdlidmaatschap
// 2=Gremiumlidmaatschap
'JSON_mutatie' => $JSON_mutatie)); // de JSON payload
Output positief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'TRUE',
'Message' => 'Mutatie verwerkt');
Output negatief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.4 Vertaal landcode
// Het CRM werkt met numerieke landcodes, wij met cijfers
// Vertaal die
// Er moet in de aanroep 1 veld aanwezig zijn, beide waarden komen in het antwoord terug
$request = xmlrpc_encode_request(
'ISO_landcode',
array(
['ISO_numeriek' => $ISO_numeriek,]
['ISO_code ' => $ISO_code]));
Output positief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'TRUE',
'Message' => 'ISO code lookup geslaagd',
'ISO_numeriek' => $ISO_numeriek,
'ISO_code ' => $ISO_code,
'ISO_benaming' => $ISO_benaming); // de descriptive name van deze ISO code
Output negatief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'FALSE',
'Message' => 'Kan geen bijpassende vertaling vinden'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');
</pre>
// M.5 MuteerAanmeldingsformulier
// Sla een JSON veld op in de XML-RPC server zodat deze weer opgehaald kan worden door de websites
// Authenticatie op basis van hccLidnummer en JoomlaToken
// Deze mutaties mogen alleen door HN#WM of SITE#WM gedaan worden.

$request = xmlrpc_encode_request(
MuteerAanmeldingsformulier,
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
'formulierdata' => $formulierdata, // JSON veld met alle gegevens voor het aanmeld formulier
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress ));
Output positief:
$reply = array(
'Action' => 'MuteerAanmeldingsformulier',
'Status' => 'TRUE',
'Message' => 'aanmeldingsformulier bijgewerkt';

// M.6 HaalAanmeldingsformulier
// (geen authenticatie)
$request = xmlrpc_encode_request(
HaalAanmeldingsformulier,
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalAanmeldingsformulier',
'Status' => 'TRUE',
'formulierdata' => $formulierdata); // JSON veld met alle gegevens voor het aanmeld formulier
</pre>

// M.7 GeefFactuurOverzicht
// (authenticatie op basis van hccLidnummer + JoomlaToken + siteID
$request = xmlrpc_encode_request(
GeefFactuurOverzicht,
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefFactuurOverzicht',
'Status' => 'TRUE',
'FactuurOverzicht' => $FactuurOverzicht);
// $FactuurOverzicht =
// array(
// array(
// 'FactuurID' => 'a5b93460-4536-ea11-a813-000d3a2c53fa',
// 'FactuurNummer' => '200118673J5'
// 'FactuurDatum' => '2020-01-15'
// 'bedrag' => 42.37
// 'BetaalStatus' => 0]));
// )

// M.8 HaalFactuur
// (authenticatie op basis van JoomlaToken of FactuurToken)
$request = xmlrpc_encode_request(
HaalFactuur,
array(
'hccLidnummer' => $hccLidnummer,
['JoomlaToken' => $JoomlaToken,]
['FactuurToken' => $FactuurToken,]
'FactuurNummer' => $FactuurNummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalFactuur',
'Status' => 'TRUE',
'factuur' => $factuurgegevens);
// $factuurgegevens =
// array(
// 'FactuurNummer' => $FactuurNummer,
// 'FactuurDatum' => $FactuurDatum,
// 'FactuurID' => $FactuurID,
// 'Bestandsnaam' => $Bestandsnaam,
// 'PDF' => $PDF) // base64 encoded PDF
</pre>

=== Echo test ===

<pre>

// t.b.v. controle of de verbinding met de XML-RPC server functioneert
// Eenvoudige echo test

$request = xmlrpc_encode_request(
'echo',
array(
'What' => $string,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'echo',
'Status' => 'TRUE',
'Message' => $string);
</pre>

=== HenZ XML-RPC interface ===

Overzicht van XML-RPC procedures die bij HenZ draaien
(worden via de Hobbynet XML-RPC server afgehandeld)

<pre>
- Action=2
wijzig gebruikersnaam en wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=3
controleer of een gebruikersnaam bestaat
(XML-RPC server voert de hccnet XML-call uit, zie 8.2)

- Action=4
creer een nieuwe gebruiker. Per lidnummer is er 1 account. Als er al een
account voor dit lidnummer bestaat wordt het bestaande account hernoemd.
(XML-RPC server voert de hccnet XML-call uit, zie 8.1)

- Action=5
wijzig wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=7
Uitgeschreven lid is weer actief lid geworden
(Wordt aangeroepen vanuit de cronjob)

- Action=8
Lid heeft een nieuwe hcc-code gekregen
(Wordt aangeroepen vanuit de cronjob)
</pre>

=== Release notes ===
<pre>
2012.02.08 Wijzigingen versie 5:
- 4.1 verwijder_hcc_Lidnummer i.p.v. hcc_Lidnummer
- 4.1 optionele extra parameter verwijder_hccLogin
- Optionele parameters aangegeven
- Vanwege de duidelijkheid de beheerLogin en beheerPassword velden
bovenin de betreffende aanroepen gezet
(De volgorde van de parameters is niet relevant, dus dit is geen
interface-aanpassing)
2012.02.16 Wijzigingen versie 6:
- 2.1/2.2/2.3 geef ook cn en sn terug na aanpassen van het wachtwoord
- 3.1 geef cn en sn terug na aanmaken nieuwe gebruiker
2012.02.27 Wijzigingen versie 7:
- Neem de XML-RPC interface van HenZ in deze XML-RPC server op
8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gegevens tevens in LDAP op
- 2.1 wijzig wachtwoord - optie 1
* Nieuw wachtwoord is verplicht, niet optioneel
* wijzigingen worden naar hccnet.nl doorgezet
- 2.2 wijzig wachtwoord, optie 2
* Nieuw wachtwoord is verplicht, niet optioneel
* gebruikersnaam kan niet meer via deze interface aangepast worden
* wijzigingen worden naar hccnet.nl doorgezet
- 2.3 wijzig wachtwoord, optie 3
* wijzigingen worden naar hccnet.nl doorgezet
2012.03.26 Wijzigingen versie 8:
- Breidt de XML-RPC interface van HenZ in deze XML-RPC server uit met
8.2 Controleer of de gebruikersnaam op dit moment bestaat
2012.04.09 Wijzigingen versie 9:
- Vervang alle 'ldap' aanroepen door 'HCCldap' aanroepen
- documentatie van HenZ call action=2 aangepast, action=5 toegevoegd
2012.05.03 Wijzigingen versie 10:
- 1.1 / 1.2 / 1.3 geven nu ook 'ProfielBekend' terug om uniek te bepalen
of deze bezoeker een first-time-login pagina te zien dient te krijgen
- documentatie van 2.1 (wijzig wachtwoord) aangepast:
2.1 kan alleen als profiel is doorlopen
- nieuwe procedure t.b.v. zoekscherm PC30
* A.1 ZoekHCCLid
- hiervoor is de database met diverse velden uitgebreid
(postcode, e-mailadres, huisadres, woonplaats, land, telefoonnummer)
Dit heeft impact op diverse andere procedures (t.b.s.)
- nieuwe procedure t.b.v. 'gewone' profielpagina
* B.1 GeefDBFPersoonID
- nieuwe procedure t.b.v. cron-job
* C.1 GeefOpgezegdeLeden
2012.05.10 Wijzigingen versie 11
- 1.3 GebruikerBestaatControle
* nieuwe parameter: hccPseudoniem
* nieuw veld in antwoord: hccPseudoniem
- 2.3 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 2.4 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 3.1 NieuweGebruiker
* nieuwe parameter: hccPseudoniem
- 8.1 MaakGebruikerAan
* nieuwe parameter: nieuw_hccPseudoniem
* alle parameters zijn verplicht (niet langer optioneel)
* nieuw antwoord: Gegevenscombinatie onjuist
- 8.3 IsDezePseudoniemNogBeschikbaar
* Nieuwe procedure t.b.v. 1e keer doorlopen profielpagina
- A.1 ZoekHCCLid
* 'Zoeklimiet bereikt' wordt als ExtraInfo meegegeven
* nieuwe velden in antwoord: hccPseudoniem en hccLogin
- B.1 GeefDBFPersoonID
* Zoeken kan nu ook op hccLogin en op hccPseudoniem
- C.1 GeefOpgezegdeLeden
* Geef nu ook hccLogin en hccPseudoniem terug
2012.05.14 Wijzigingen versie 12
- 1.x GebruikerBestaatControle
* Geef ook DBFPersoonID terug
- 4.1 Gooi een gebruiker weg.
* Haal ongebruikte parameter hccLogin weg
- 5.1 Wijzig hccIG
* Haal ongebruikte parameter hccLogin weg
- 6.1 Wijzig hccRegio
* Haal ongebruikte parameter hccLogin weg
- 7.1 Wijzig hccRol
* Haal ongebruikte parameter hccLogin weg
2012.05.20 Wijzigingen versie 13
- A.1 ZoekHCCLid
* Geef resultaten gestructureerder formaat
* Geef in ExtraInfo weer hoeveel echte resultaten er gevonden zijn
- C.1 GeefOpgezegdeLeden
* Geef resultaten in gestructureerder formaat
2012.06.03 Wijzigingen versie 14
- 3.1 NieuweGebruiker
* Geef ook DBFPersoonID mee
2012.08.17 Wijzigingen versie 15
- C.1 GeefOpgezegdeLeden
* Geef ook hccLogin in het antwoord terug
- D.1 HCCpartner/ControleerHCCLidmaatschap
* Nieuwe aanroep
2012.09.29 Wijzigingen versie 16
- Alle cron gerelateerde opdrachten verwijderd
* 3.1 NieuweGebruiker
* 4.1 GooiGebruikerWeg
* 5.1 WijzigHccIG
* 6.1 WijzigHccRegio
* 7.1 WijzigHccRol
2012.10.28 Wijzigingen versie 17
- nieuwe procedure t.b.v. PC30 beheerpagina
* A.2 HaalPC30Token
- nieuwe procedure t.b.v. Drupal profielpagina
* 2.4 vervallen
(WijzigGebruikersGegevens op basis van pseudoniem)
* 2.5 WijzigGebruikersGegevens
Nieuwe keuze: wijzig pseudoniem
2012.11.14 Wijzigingen versie 18
- 1.x GebruikerBestaatControle
* Geef ook mail in het antwoord terug
2012.11.30 Wijzigingen versie 19
- E.1 HCCkader/WijzigGebruikersGegevens
* Nieuwe aanroep
- F.1 / F.2 / F.3 ControleerKaderlid
* Nieuwe aanroep
2012.12.18 Wijzigingen versie 20
- Haal DBFPersoonID weg uit alle aanroepen en alle resultaten
* Antwoord van 1.x GebruikerBestaatControle
* B.1 GeefDBFPersoonID opgeheven
- A.1 ZoekHCCLid geeft nu ook hccMobiel terug (t.b.v. PC30 zoekpagina)
- C.1 GeefOpgezegdeLeden verder uitgewerkt:
* Geeft alleen de door Drupal gebruikte velden 'hccLogin' en 'hccEindDatum'
terug in het antwoord
* Geeft nu 'echte' antwoorden i.p.v. dummy resultaten
- F.1 ControleerKaderlid geeft nu ook optioneel 'sn' en 'givenName'
terug (in de beheer-variant)
2013.01.25 Wijzigingen versie 21
- A.1 ZoekHCCLid uitgebreid
* Geeft nu ook hccBeginDatum, hccEindDatum en hccRol terug
2013.02.02 Wijzigingen versie 22
- A.1 ZoekHCCLid
* Interface aangepast
- A.3 ZoekGroeperingsLid
* Nieuwe aanroep
- F.4 GeefAlleGroeperingen
* Nieuwe aanroep
- F.5 GeefAlleKaderRollen
* Nieuwe aanroep
2013.03.01 Wijzigingen versie 23
- A.3 ZoekGroeperingsLid
* Geeft andere resultaten terug
- 2.2 WijzigWachtwoord
* Geeft nu ook hccLogin terug (voor ww-vergeten op de Drupal site)
- HCCenquete implementatie
* G.1 Expandeer NL postcode
* G.2 Haal lidgegevens op
* G.3 Pas lidgegevens aan
2013.03.18 Wijzigingen versie 24
- ZoekGroeperingsLid op basis van token
- A.4 Lid bezoekt bijeenkomst
* nieuwe aanroep
- A.5 VraagLidgegevensTokenAan
* nieuwe aanroep
2013.04.07 Wijzigingen versie 25
- D.1 HCCpartner/ControleerHCCLidmaatschap
Simpeler interface ontwikkeld ('HCCpartners' i.p.v. 'HCCpartner')
- G.3 mag ook Tussenvoegsels aanpassen
2013.04.25 Wijzigingen versie 26
- H.1 HCC-groepering / GebruikerBestaatControle
Nieuwe interface voor validatie vanaf groeperings websites
2013.05.03 Wijzigingen versie 27
- 2.6 HaalOptInKeuzen
* nieuwe aanroep
- 2.7 SchrijfOptInKeuzen
* nieuwe aanroep
- 2.8 HaalOptInLijst
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* nieuwe aanroep
- HCCpartners aanroep nieuwe interface ('Action' => 'ControleerHCCLidmaatschap')
2013.07.05 Wijzigingen versie 28
- 8.1 MaakGebruikerAan
* extra parameters (mail, hccPseudoniem) in het antwoord
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra parameter (mailHccnet)
- A.1 ZoekHCCLid
* extra parameter (mailHccnet)
- A.3 ZoekGroeperingsLid
* extra parameter (mailHccnet)
2013.08.31 Wijzigingen versie 29
- F.1 / F.2 / F.3 HCC-kader / ControleerKaderlid
* extra output parameter (hccKaderMail)
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra output parameter (hccForumLogin)
- H.1 HCC-groepering / GebruikerBestaatControle
* komma-gescheiden lijst met groeperingen mogelijk
* extra output parameter (mailHccnet)
2013.12.26 Wijzigingen versie 30
- 3.1 Geef mijn lidnummer
* nieuwe aanroep
- A.1 ZoekHCCLid
* geef nu ook 'ProfielBekend' terug om aan de PC30 omgeving door te geven
dat het wachtwoord niet veranderd mag worden door PC30
- A.6 GeefBezoekersOverzicht
* geef nu ook 'Locatie' terug indien van toepassing
- A.7 GeefLocaties
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* parameters aangepast
* authenticatie op basis van hccLogin + userPassword of lidnummer + hcc-code
* geen algemene hcc-forum authenticatie meer mogelijk
- F.7 ControleerKaderlidGroep
* Nieuwe aanroep
2014.02.01 Wijzigingen versie 31
- A.8 RegistreerGast
* nieuwe aanroep
- H.2 MatchPostcodeMetRegio
* nieuwe aanroep
- nieuwe interface (losse, unieke aanroepen, niet meer gegroepeerd)
2014.09.27 Wijzigingen versie 32
- C.1 GeefOpgezegdeLeden hernoemd naar GeefUitgeschrevenLeden
- I.3 GeefhccEindDatum
* nieuwe aanroep
- Action=7 en Action=8 toegevoegd aan de HenZ interface
2014.12.12 Wijzigingen versie 33
- F.1 / F.2 / F.3 HCC-kader / IsKaderLid
* extra output parameter (mail, mailHccnet, hccKaderForward)
- F.8 HCC-kader / ZetKaderForward
* nieuwe aanroep
2015.05.06 Wijzigingen versie 34
- GeefMijnGegevens
* nieuwe aanroep
- ValideerPCActiveAbonnee
* vervallen
- 1.4 GebruikerBestaatControle
* extra output parameter (hccKaderForward)
- D.1 HCCpartner/ControleerHCCLidmaatschap
* optionele extra output parameter (ExtraInfo)
2015.09.27 Wijzigingen versie 35
- HeeftForumCredentials
* vervallen
2015.11.20 Wijzigingen versie 36
- SchrijfNietlidInOpBulletin
* nieuwe aanroep
2015.12.13 Wijzigingen versie 37
- serverID als optionele parameter
- SchrijfNietlidInOpBulletin
* Maak velden optioneel
2016.01.05 Wijzigingen versie 38
- A.7 GeefLocaties
* optionele parameter JoomlaFilter
- F.4 GeefAlleGroeperingen
* optionele parameter JoomlaFilter
- F.5 GeefAlleKaderRollen
* optionele parameter JoomlaFilter
2016.01.15 Wijzigingen versie 39
- H.3 GeefMijnGegevens
* geeft nu ook hccOptIn terug
* geeft nu ook JoomlaToken terug
- H.4 PasOptInKeuzeAan
* nieuwe aanroep
- SiteID en RemoteID als optionele parameter
2016.03.17 Wijzigingen versie 40
- H.5 ZoekKaderLeden
* nieuwe aanroep
2016.03.20 Wijzigingen versie 41
- ServerID, SiteID en RemoteID als optionele parameters bij alle aanroepen
- A.7 GeefLocaties
* optionele parameter KadernetFilter
- A.9 GeefLocatieNamen
* optionele parameter KadernetFilter
- F.4 GeefAlleGroeperingen
* optionele parameter KadernetFilter
- F.5 GeefAlleKaderRollen
* optionele parameter KadernetFilter
- F.6 WijzigHccRol
* vervallen
- F.7 IsGroeperingsKaderlid
* vervallen
- 8.3 IsDezePseudoniemNogBeschikbaar
* vervallen
- 2.7 SchrijfOptInKeuzen
* vervallen
- 2.5 WijzigGebruikersGegevens (hccPseudoniem)
* vervallen
- H.2 MatchPostcodeMetRegio
* vervallen
2016.04.02 Wijzigingen versie 42
- H.6 GeefMijnKaderDetails
* nieuwe aanroep
2016.07.03 Wijzigingen versie 43
- Ubuntu 16.04 aanpassingen (PHP versie 7) beschreven
2016.09.01 Wijzigingen versie 44
- H.5 ZoekKaderLeden
* extra parameter 'hccMobiel'
2016.10.13 Wijzigingen versie 45
- H.3 GeefMijnGegevens (dedecated Joomla aanroep)
* hccForumLogin weg als parameter
* Als het om een webmaster gaat, vul dan eventueel hccRegio of hccIG aan
met die groepering, ook als hij geen lid is van die groepering
- I.4 GebruikerBestaatControle
* hccForumLogin weg als parameter
2016.12.01 Wijzigingen versie 46
- 8.3 IsDezePseudoniemNogBeschikbaar teruggezet
2017.05.28 Wijzigingen versie 47
- H.7 GeefMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
- H.8 ZetMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
2017.09.01 Wijzigingen versie 48
- A.10 SchrijfNietlidInOpBulletin nu alleen voor 1 bulletin tegelijk
- 2.2 WijzigGebruikersGegevens (op basis van gebruikersnaam en wachtwoord)
is vervallen (was een oude Drupal aanroep)
- A.3 ZoekGroeperingsLid geeft ook hccKaderToonMobiel terug
- H.7 GeefMinimaleKaderGegevens geeft ook hccKaderToonMobiel terug
2017.11.14 Wijzigingen versie 49
- A.3 ZoekGroeperingsLid geeft geen hccKaderToonMobiel meer terug
- A.3 ZoekGroeperingsLid geeft alleen hccMobiel als hccKaderToonMobiel dat toestaat
2018.02.18 Wijzigingen versie 50
- H.6 GeefMijnKaderDetails geeft ook hccKaderToonMobiel terug
- H.9 PasKaderGegevensAan
* nieuwe aanroep
- H.3 GeefMijnGegevens geeft 3 extra parameters terug (hccKaderMail, hccKaderForward,
hccKaderToonMobiel)
- JoomlaTokens worden gevalideerd op siteID, niet langer op serverID
- diverse aanroepen kunnen nu ook via de bezoekersregistratie-proxy aangeroepen worden.
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
(GeefAlleGroeperingen, GeefAlleKaderRollen, GeefLocaties, GeefLocatieNamen)
De bezoekersregistratie aanroepen hebben enkel JoomlaToken als extra parameter nodig:
(LidBezoektBijeenkomst, GeefBezoekersOverzicht)
2018.02.26 Wijzigingen versie 51
- H.3 GeefMijnGegevens geeft extra parameter hccMobiel terug
- H.9 PasKaderGegevensAan kan nu ook kadermail password aanpassen
- K.1 ValideerToken
* nieuwe aanroep
- K.2 ValideerHCCCode
* nieuwe aanroep
2018.03.17 Wijzigingen versie 52
- H.3 Haal al mijn gegevens
Extra optie 'compact' om alleen essentiele resultaten te verkrijgen
(t.b.v. de Android bezoekersregistratie applicatie)
2018.03.25 Wijzigingen versie 53
- I.2 IsHCCLid
(Oude aanroep teruggezet, wordt nog in vraagbaak module gebruikt)
2018.07.01 Wijzigingen versie 54
* A.1 beheer authenticatie op basis van lidnummer + hccCode (tbv VZ-portal)
* A.2 HaalPC30Token weggehaald
2018.08.22 Wijzigingen versie 55
* 1.2 GebruikerBestaatControle' (op basis van hccLogin en userPassword) weggehaald
* 1.4 GebruikerBestaatControle' (op basis van zoekHccLogin of zoekHccLidnr) weggehaald
* 2.8 HaalOptInLijst weggehaald
* E.1 PasKaderWachtwoordAan weggehaald
* F.1 IsKaderLid (op basis van hccLidnr en hccCode) weggehaald
* F.3 IsKaderLid (op basis van beheerdernaam en beheerderwachtwoord) was al weg
* F.8 ZetKaderForward weggehaald
* H.1 IsGroeperingsLid weggehaald
* H.6 GeefMijnKaderDetails weggehaald
* H.7 GeefMinimaleKaderGegevens weggehaald
* H.8 ZetMinimaleKaderGegevens weggehaald
* K.1 ValideerHCCCode weggehaald
* K.2 ValideerToken weggehaald
* H.3 GeefMijnGegevens geeft omvang kader mailbox mee terug
2018.11.06 Wijzigingen versie 56
Nieuwe aanroepen t.b.v. forum en vraagbaak autorisaties
* L.1 MaakOnderwerp
* L.2 VerwijderOnderwerp
* L.3 GeefOnderwerpen
* L.4 MuteerOnderwerp
* L.5 MuteerOnderwerpAutorisatie
* L.6 ToonOnderwerpAutorisatie
* H.5 ZoekKaderLeden heeft compact optie
2018.11.16 Wijzigingen versie 57
* L.5 MuteerOnderwerpAutorisatie kent nu ook RED(acteur)
2018.12.17 Wijzigingen versie 58
* A.11 GeefBezoekersAantallen (nieuwe aanroep)
* H.10 PasUserWachtwoordAan (nieuwe aanroep)
2019.02.21 Wijzigingen versie 59
* A. 6 GeefBezoekersOverzicht geeft enkel lijst van bezoekers laatste bijeenkomst
2019.10.26 Wijzigingen versie 60
* A.4 Schrijf bezoekers niet meer automatisch in op bulletins
* H.4 PasOptInKeuzeAan kan ook door LA aangeroepen worden
Nieuwe aanroepen t.b.v. eigen implementatie van mijn.hcc.nl in de Joomla modules
* H.11 PasPseudoniemAan
* H.12 ValideerWachtwoordEisen
* H.13 PasWachtwoordAan (1: op JoomlaToken, 2: op PWResetToken)
* H.14 MaakPWResetToken
* H.15 ValideerPWResetToken
* H.16 RuimJoomlaTokenOp
* A.12 GeefAlleBulletins
* A.13 ExpandeerPostcode
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.18 NormaliseerTelefoon
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
* A.21 HaalIGBedragenOp
* A.22 HaalTariefGroepenOp
* A.23 PasInteressegroepAan
* F.10 MuteerGroeperingSamenstelling
* A.24 GeefSSOUrls
Aanpassingen gemaakt aan
8.1 MaakGebruikerAan
F.5 GeefAlleKaderRollen
2020.01.04 Wijzigingen versie 61
Nieuwe aanroepen t.b.v. IDEAL betaling hobbynet abonnees
H.17 GeefAantalDomeinen
2020.01.06 Wijzigingen versie 62
Nieuwe aanroepen t.b.v. Cayentis (CRM webproxy) implementatie
* M.1 Upload_CSV_bestand
* M.2 SchrijfNieuwLidIn
* M.3 Verwerk_JSON_mutatie
* M.4 ISO_landcode
* M.5 MuteerAanmeldingsformulier
* M.6 HaalAanmeldingsformulier
* M.7 GeefFactuurOverzicht
* M.8 HaalFactuur
* A.25 UpdateNAW
Vervallen aanroepen
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
Aangepaste aanroepen
* A.23 PasInteressegroepAan
2020.03.27 Wijzigingen versie 63
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.18 ResetHCCCode
* H.19 PasHccLoginAan
2020.04.10 Wijzigingen versie 64
Nieuwe aanroepen
* A.26 VerwijderNietLid
Aanpassingen gemaakt aan
* A.1 ZoekHCCLid: nieuwe zoekoptie 'niet_leden'
Opnieuw geimplementeerd
* A.20 UpdateMobiel
</pre>

= Aanpassingen aan de Apache omgeving =

== php.ini aanpassingen ==
De XML-RPC server zal 'ergens' een bestand moeten kunnen vinden met de
gebruikersnamen t.b.v. het authenticeren bij de LDAP-server.

Dit bestand wordt geplaatst in de map '/usr/local/hobbynet/etc'. Om dit
vanuit Apache te mogen benaderen, dient een aanpassing aan php.ini
gemaakt te worden:

/etc/php5/apache2/php.ini

include_path = ".:/usr/share/php:/usr/share/pear:/usr/local/hobbynet/etc"

== Apache modules ==
Nieuwe server geschikt maken voor XML-RPC gebruik

=== Apache modules (PHP 7) ===
Ubuntu 16.04 wordt standaard met PHP versie 7.0 uitgeleverd.
De opdrachten om de modules op te halen zijn:
apt-get install php-xmlrpc
apt-get install apache2
apt-get install ldap-utils
apt-get install php-ldap
apt-get install libapache2-mod-php

== Loadbalancer akties niet naar de logbestanden schrijven ==
De loadbalancer haalt zeer frequent een testbestand op (/test.txt), om
te controleren of de xml-server operationeel is. Dat levert extreem veel
logging op in /var/log/apache2/other_vhosts.log.

Pas de apache configuratie zo aan, dat logging van alle opvragingen
vanaf de loadbalancers uitgezet wordt.
/etc/apache2/sites-enabled/xml-server

# Mark requests from loadbalancers
SetEnvIf Remote_Addr "212\.72\.227\.93" dontlog
SetEnvIf Remote_Addr "212\.72\.227\.94" dontlog
SetEnvIf Remote_Addr "172\.31\.1\.249" dontlog
SetEnvIf Remote_Addr "172\.31\.1\.250" dontlog
CustomLog ${APACHE_LOG_DIR}/access.log common env=!dontlog

= Firewall algemeen =
In de file /etc/hobby-firewall/hobby-firewall.local wordt het script
'/usr/local/hobbynet/bin/gen_fw.sh' aangeroepen.
Deze haalt de IP adressen op uit ldap.
(.local omdat we dit ook zo doen op de webservers).

De firewall wordt 4 x per dag herstart en /etc/hobby-firewall wordt
gesynchroniseerd (1-richting van lb1 naar lb2) met de volgende crontab
entries:

Op lb1:
0 0 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 5 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 11 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 17 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 23 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null

Op lb2:
15 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 0 * * * /etc/init.d/hobby-firewall restart >/dev/null

Het encrypted backup script is verplaatst naar '/usr/local/hobbynet/local' en hernoemd naar 'backup-encrypted.bash'.
Dit is omdat deze niet mee mag worden gesynchroniseerd.

Tevens wordt 1x per dag /usr/local/hobbynet/bin gesynchroniseerd (1-richting van hcc-ldap-lb1 naar hcc-ldap-lb2)

== Aanpassingen in de firewall ==
Op de server waar de XML-RPC server staat, moeten enkele firewall aanpassingen gemaakt worden.
* inkomend: sta TCP 443 toe vanaf het interne netwerk (www-prod, www-test), en vanaf eventuele andere plekken die we expliciet toe willen staan.
* inkomend: sta TCP 443 toe vanaf mijn.hcc.nl (XML-RPC aanroepen vanaf de portal)
* inkomend: sta TCP 443 toe vanaf service.hccnet.nl toe (XML-RPC aanroep GeefUitgeschrevenLeden vanuit HenZ)
* uitgaand: sta TCP 443 naar service.hccnet.nl toe (XML-RPC aanroepen naar HenZ)
* uitgaand: sta TCP 990 en 5000-6000 naar Apps.HCC.local (FTPS verkeer naar de HCC server bij Hobbynet)

== Aanpassingen aan AppArmor ==
Alhoewel technisch gezien dit bij slapd behoort, neem ik het toch hier op.

Als het Hobbynet certificaat in de map /disk/site/etc/ssl/hobby.nl/ wordt neergezet, dan zal apparrmor de toegang tot de certificaten blokkeren. Neem daarom in de '''local''' directory van apparmor het volgende op:
# /etc/apparmor.d/local/usr.sbin.slapd
# Site-specific additions and overrides for usr.sbin.slapd.
# For more details, please see /etc/apparmor.d/local/README.
#include <abstractions/ssl_certs>
/disk/site/etc/ssl/hobby.nl/ r,
/disk/site/etc/ssl/hobby.nl/* r,

MediaWikiSites

2020-04-05T15:04:16Z

Hans:

Dane

2020-04-05T11:14:06Z

Hans:

= Doel =
Een DANE record in DNS vertelt welk ssl certificaat gekoppeld is aan een hostnaam. Het is bedoeld om email verkeer te beveiligen.

== Waar staat DANE voor? ==
SMTP Security via Opportunistic '''D'''NS-Based '''A'''uthentication of '''N'''amed '''E'''ntities (DANE)

== Verplicht voor overheids mailservers ==
STARTTLS en DANE moeten in combinatie worden toegepast op ontvangende en verzendende e-mailservers. 
Zie https://www.forumstandaardisatie.nl/standaard/starttls-en-dane

= DNS =
In DNS heet het 'TLSA record' en ziet er als volgt uit:
_443._tcp.www.hcc.nl. IN TLSA 3 1 1 1884aed24d9b18f571e777a95931c78d28c31b86f216efc683ed88f65728d549

= DANE record maken =
Dat gaat heel simpel via deze site https://www.huque.com/bin/gen_tlsa 
Je plakt het publieke deel van het certificaat, laat verder alles default.
Je vult hostnaam, port en protocol in en klikt op ''generate''.

= gen_mx_hcc =
Als het certificaat van hcc.nl wordt vervangen moet je in het gen_mx script de variable veranderen
$TLSAHCC = '3 1 1 1884aed24d9b18f571e777a95931c78d28c31b86f216efc683ed88f65728d549';
want elke subdomein van hcc.nl krijgt automatisch DANE record

= LET op =
Als een ssl certificaat vernieuwd wordt moet je dus ook een nieuw DANE (TLSA) record maken

XML-RPC

2020-03-27T12:09:35Z

Hans: XML-RPC aanpassingen t.b.v. Cayentis omgeving

= XML-RPC interface =

De LDAP server kan direct gemuteerd worden via een LDAP koppeling. Zie
de standaard LDAP pagina voor de uitleg welke poorten daarvoor gebruikt
kunnen worden.

Daarnaast is er de wens ontstaan om via een standaard protocol met de
LDAP omgeving te kunnen communiceren. Er is hiertoe een XML-RPC
koppeling ontwikkeld. XML-RPC is een standaard interface, waarmee het
mogelijk is om vanuit diverse omgevingen op een gestandaardiseerde
manier te communiceren.

== Globale functie omschrijving ==
* Algemene aanroepen
** Controleer of een gebruiker bestaat
** Wijzig het wachtwoord ('userPassword')
** Zoek een gebruiker (t.b.v. kantoor en/of LA-akties groeperingssecretaris)
** Maak een gebruiker aan (geef gebruiker een andere hccLogin waarde, maak ook bij HCCnet deze gebruiker aan)
** Controleer of een gebruiker zijn profiel al doorlopen heeft
** Haal de lijst met opgeheven accounts op
** Haal de lijst met bulletins van een hcc lid (OptIn)

* Aanroepen t.b.v. hcc partners
** Controleer of lidnummer/postcode correct is
** Controleer of lidnummer/postcode correct is, en tevens ingeschreven staat bij een specifieke IG

* Joomla template site functies (op basis van JoomlaToken)
** Maak een JoomlaToken
** Ruim een JoomlaToken op
** Pas mijn OptIn (bulletin inschrijving) aan
** Regel alles rondom Onderwerpen en de autorisatie hiervan
** Pas mijn wachtwoord aan

* Joomla kadernet site functies (op basis van JoomlaToken)
** Zoek een hcc kaderlid (t.b.v. de kaderleden zoekpagina)
** Pas mijn kadermail forwarding aan en toon ja/nee mijn GSM nummer
** Pas het kadernet e-mail wachtwoord aan
** Haal de lijst met alle groeperingen op
** Haal de lijst met alle kaderrollen op

* Joomla hcc.nl site (op basis van JoomlaToken)(mijn.hcc.nl vervanging)
** Pas mijn adresgegevens aan
** Pas mijn voorletters, voornaam, pseudoniem, telefoonnummer, GSM nummer etcetera aan
** Schrijf me in of uit op een bulletin
** Toon info over de kosten van een IG lidmaatschap
** Voer een wachtwoord reset uit op basis van een PWResetToken (een variant op JoomlaToken)
** Vraag een nieuwe HCC code aan, en stuur die per SMS

* Joomla hobby.nl site (op basis van JoomlaToken)(t.b.v. IDEAL betaling)
** Haal het aantal hobbyDomains op

* Aanroepen t.b.v. CRM (Microsoft Dynamics Cloud) koppeling
** Haal de dagelijkse synchronisatie bestanden op
** Werk in het CRM dan wel in LDAP de NAW gegevens bij
** Werk in het CRM dan wel in LDAP de IG gegevens van een lid bij

* HenZ
** Haal de lijst met opzeggers op
** Valideer de opzegdatum van een opgegeven gebruiker

=== Authenticatie ===

Alle aanroepen gebeuren op basis van authenticatie vanuit de aanroeper.
Dit valt uiteen in de volgende categorieën:
* gebruikersnaam ('hccLogin') en wachtwoord ('userPassword')
* hcc lidnummer ('hccLidnr'), Joomla token ('JoomlaToken') en website ('siteID')
* hcc lidnummer ('hccLidnr') en hcc code ('hccCode')
* beheerders-DN ('beheerLogin') en beheerders wachtwoord ('beheerPassword')
* partner-DN ('partnerLogin') en partner wachtwoord ('partnerPassword')

=== Aanroepen, gedaan via de bezoekersregistratie-proxy ===
(de bezoekersregistratie proxy is een mislukt project tbv de Android app van René Prins)
(deze proxy bestaat niet meer) 
Diverse aanroepen kunnen ook via de bezoekersregistratie-proxy aangeroepen worden. 
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
* GeefAlleGroeperingen
* GeefAlleKaderRollen
* GeefLocaties
* GeefLocatieNamen
De bezoekersregistratie aanroepen hebben 'JoomlaToken' als extra parameter nodig:
* LidBezoektBijeenkomst
* GeefBezoekersOverzicht
* GeefBezoekersAantallen
De aanroepen die over de proxy uitgevoerd worden dienen voorafgegaan te worden door een aanroep naar
* GeefMijnGegevens (dit geeft na validatie immers 'JoomlaToken' terug)

=== Resultaten ===

Alle aanroepen geven de volgende elementen terug:
* Naam van de uitgevoerde procedure ('Action')
* Resultaat van de uitgevoerde procedure ('Status')
* Een tekstuele vertaling van het resultaat dan wel de foutmelding ('Message')
* Tijdens de ontwikkelfase kan er debug-info teruggeleverd worden ('ExtraInfo')
Daarnaast geven specifieke aanroepen extra resultaten terug

== Technische omschrijving ==
XML-RPC beschrijving van acties in hcc.nl LDAP database

<pre>
2020.03.27 HaVe
XML-RPC Hobbynet versie 63.
</pre>

=== Kort overzicht ===
Dit is een lijst met alle XML-RPC aanroepen. In het volgende hoofdstuk worden ze in detail besproken.
<pre>
echo (partners)
ExpandeerPostcode (Joomla module Bas, tbv verhuizingen)
GebruikerBestaatControle (Joomla sites)
GeefAantalDomeinen (Joomla module Bas)
GeefAlleBulletins (Joomla module Bas)
GeefAlleGroeperingen (kadersite, forum, secr. portal, kantoor portal, hobbynet portal)
GeefAlleKaderRollen (forum, secr. portal, kantoor portal, hobbynet portal, Joomla module Bas)
GeefBezoekersOverzicht (bezoekersregistratie)
GeefBezoekersAantallen (bezoekersregistratie)
GeefhccEindDatum (HenZ)
GeefKadermailGegevens (kantoor portal)
GeefLocatieNamen (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefLocaties (kadersite, secr. portal, kantoor portal, hobbynet portal)
GeefMijnGegevens (Joomla inlog module Bas)
GeefMijnLidnummer (beheer.hcc.nl secretaris portal)
GeefOnderwerpen (Joomla template sites)
GeefSSOUrls (Joomla module Bas)
GeefUitgeschrevenLeden (Joomla sites, HenZ)
HaalIGBedragenOp (Joomla module Bas)
HaalOptInKeuzen (kantoor portal)
HaalTariefGroepenOp (kantoor portal)
HCCpartner (Partner aanroep)
HCCpartners (Partner aanroep)
IsDezeNaamNogBeschikbaar (aangeroepen vanuit de CRM omgeving)
IsDezePseudoniemNogBeschikbaar (kantoor portal)
IsHCCLid (vraagbaak aanroep)
IsKaderLid (in veel apps gebruikt)
LidBezoektBijeenkomst (bezoekersregistratie)
MaakGebruikerAan (mijnhcc.nl, maak hccnet account aan en ldap gebruikersnaam)
MaakOnderwerp (Joomla template sites)
MaakPWResetToken (Joomla module Bas)
MuteerGroeperingSamenstelling (Joomla kadernet module Bas)
MuteerOnderwerp (Joomla template sites)
MuteerOnderwerpAutorisatie (Joomla template sites)
NormaliseerTelefoon (Joomla module Bas)
PasHccLoginAan (Joomla module Bas)(enkel Hobbynet)
PasInteressegroepAan (Joomla module Bas)
PasKaderGegevensAan (kadersite, Joomla module Bas)
PasOptInKeuzeAan (Joomla module Bas)
PasPseudoniemAan (Joomla module Bas)
PasUserWachtwoordAan (beheer.hcc.nl Hobbynet gebruikers portal)
PasWachtwoordAan (Joomla module Bas)
RegistreerGast (bezoekersregistratie)
ResetHCCCode (Joomla module Bas)
RuimJoomlaTokenOp (Joomla module Bas)
SchrijfNietlidInOpBulletin (Joomla site bulletin module Bas)
SchrijfNieuwLidIn (Joomla CRM module Bas)
ToonOnderwerpAutorisatie (Joomla template sites)
UpdateNAW (Joomla module Bas)
Upload_CSV_bestand (CRM webproxy)
ValideerPWResetToken (Joomla module Bas)
ValideerWachtwoordEisen (Joomla module Bas)
VerwijderOnderwerp (Joomla template sites)
Verwerk_JSON_mutatie (CRM webproxy)
VraagLidgegevensTokenAan (bezoekersregistratie)
WijzigGebruikersGegevens (kantoor en Joomla template sites, ww aanpassen van gebruiker)
ZoekGroeperingsLid (secr. portal, kantoor portal, hobbynet portal)
ZoekHCCLid (VZ portal)
ZoekKaderLeden (Joomla kadernet module Bas)
</pre>

=== HCC-ldap en/of HCC-net aanroepen ===

<pre>
// ** Joomla sites, www.hcc.nl **
// 1.1 controleer of een gebruiker bestaat - optie 1
// (authenticatie op basis van hccLidnr en hccCode)
// Alleen bedoeld om gebruikers op www.hcc.nl op basis van het lidnr het ww te laten wijzigen
$request = xmlrpc_encode_request(
'GebruikerBestaatControle',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $method,
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd');
if ($hccLidnr != '') { $reply['hccLidnr'] = $hccLidnr; }
if ($hccLogin != '') { $reply['hccLogin'] = $hccLogin; }
if ($hccPseudoniem != '') { $reply['hccPseudoniem'] = $hccPseudoniem; }
if ($cn != '') { $reply['cn'] = $cn; }
if ($sn != '') { $reply['sn'] = $sn; }
if ($mail != '') { $reply['mail'] = $mail; }
if ($mailHccnet != '') { $reply['mailHccnet'] = $mailHccnet; }
if ($hccRegio != '') { $reply['hccRegio'] = $hccRegio; }
if ($hccIG != '') { $reply['hccIG'] = $hccIG; }
if ($hccRol != '') { $reply['hccRol'] = $hccRol; }
if ($ProfielBekend != '') { $reply['ProfielBekend'] = $ProfielBekend; }

// ** Portal mijn.hcc.nl **
// 2.1 wijzig wachtwoord - optie 1
// op basis van hccLidnummer en hccCode
// Essentiele aanroep, gebruikt vanuit mijnhcc.nl (lidnr + hccCode)
// Ook gebruikt t.b.v. wachtwoord-vergeten procedure op de Joomla template sites
// Als de profielpagina nog niet is doorlopen wordt deze aanroep afgekeurd.
//
// Ook gebruikt om gebruiker rechtstreeks vanaf Joomla template sites wachtwoord te
// laten aanpassen (op basis van lidnummer en hcc code)
//
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'WijzigGebruikersGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gewijzigd',
'hccLogin' => $hccLogin,
'cn' => $cn,
'sn' => $sn);

// 2.3 wijzig wachtwoord - optie 3
// (t.b.v. VZ-portal)
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
// * Als hccLidnr gevuld is, dan wordt hccLidnr gebruikt om het juiste record te zoeken
// Als hccLidnr leeg is, dan wordt hccLogin gebruikt om het juiste record te zoeken
// 1 van beide velden MOET aanwezig zijn
// ** Deze aanpassingen worden doorgezet naar hccnet.nl (action=2) **
$request = xmlrpc_encode_request(
'WijzigGebruikersGegevens',
array(
'beheerLogin' => $beheerLogin, // beheerder lidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
'nieuw_userPassword' => $nieuw_userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));

// ** t.b.v. ophalen van de opt-in keuzes op de beheer pagina **
// 2.6 Geef de complete lijst met opt-ins van dit lid
// (LET OP: authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'HaalOptInKeuzen',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
['hccLidnr' => $hccLidnr,]
['hccLogin' => $hccLogin,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalOptInKeuzen',
'Status' => 'TRUE',
'Message' => 'OptInLijst opgehaald',
'hccOptIn' => $hccOptIn);
Output negatief:
$reply = array(
'Action' => 'HaalOptInKeuzen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gebruikersnaam, pseudoniem
// en wachtwoord tevens in LDAP op
// (authenticatie op basis van hcc lidnummer en hcc-code)
// ** Deze gegevens worden doorgezet naar hccnet.nl (action=4) **
//
$request = xmlrpc_encode_request(
'MaakGebruikerAan',
array(
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode,
'nieuw_hccLogin' => $nieuw_hccLogin,
'nieuw_userPassword' => $nieuw_userPassword,
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'TRUE',
'Message' => 'Gebruiker aangemaakt',
'mail' => $mail,
'hccPseudoniem' => $hccPseudoniem);
Output negatief:
$reply = array(
'Action' => 'MaakGebruikerAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gebruikersnaam bestaat al' |
'Pseudoniem bestaat al' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!');

// H.3 Haal al mijn gegevens
// (wordt gebruikt door de Joomla inlogmodule)
// Voor gebruik over de proxy t.b.v. de Android app kan compact=TRUE meegegeven worden.
// In dat geval worden enkel de meest essentiele gegevens teruggestuurd
// Voor gebruik na MaakGebruikerAan kan deze functie ook op basis van hccLidnr en JoomlaToken
// worden aangeroepen
// De optionele parameter 'PrevSiteID' is bedoeld voor single-sign-on. Op basis van JoomlaToken,
// hccLidnr en PrevSiteID worden dan de credentials gevalideerd. Als die kloppen, geeft deze aanroep
// een 2e JoomlaToken terug, maar dan uitgegeven op basis van SiteID.
// Als PrevSiteID leeg is, dan wordt het token op basis van siteID gevalideerd.
$request = xmlrpc_encode_request(
'GeefMijnGegevens',
array(
['hccLogin' => $hccLogin,
'userPassword' => $userPassword,]
['hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,]
['PrevSiteID' => $PrevSiteID,]
['compact' => $compact,] // leeg of 'TRUE'
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens opgevraagd',
'hccLidnr' => $hccLidnr,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccAutorisatie' => $hccAutorisatie,
'cn' => $cn,
'sn' => $sn,
'JoomlaToken' => $JoomlaToken,
['hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'givenname' => $givenname,
'hccAanhef' => $hccAanhef,
'hccGeslacht' => $hccGeslacht,
'hccTussenVoegsels' => $hccTussenVoegsels,
'hccAchternaam' => $hccAchternaam,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward,
'hccKaderToonMobiel' => $hccKaderToonMobiel,
'hccOptIn' => $hccOptIn,
'ProfielBekend' => $ProfielBekend,
'hccBeginDatum' => $hccBeginDatum,
['kadermail_omvang' => $Formaat, // in Mb
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald;]]);

Output negatief:
$reply = array(
'Action' => 'GeefMijnGegevens',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// ** t.b.v. aanpassen van de opt-in keuzes op een Joomla site **
// H.4 Pas 1 opt-in van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// Als hccLidnummer gevuld is, dan is dat het lidnummer waar de mutatie op moet worden uitgevoerd.
// Dat kan alleen als de aanvrager HCC#LAD of HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasOptInKeuzeAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
['hccLidnummer' => $hccLidnummer,]
'hccOptIn' => $hccOptIn,
'actie' => 'Nieuw' | 'Weg',
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'TRUE',
'Message' => 'OptIn aangepast');
Output negatief:
$reply = array(
'Action' => 'PasOptInKeuzeAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials');

// H.5 Zoek kaderleden NAW (t.b.v. de Joomla kadersite)
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
//
// * Er dient minstens 1 zoekcriterium opgegeven te worden.
// * Als zowel hccRegio als tegelijk ook hccIG opgegeven worden is de uitkomst onvoorspelbaar.
// * Als compact=TRUE worden enkel lidnummer, cn en sn in het antwoord gezet
$request = xmlrpc_encode_request(
'ZoekKaderLeden',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
['hccRegio' => $hccRegio,]
['hccIG' => $hccIG,]
['hccRol' => $hccRol,]
['hccLocatie' => $hccLocatie,]
['achternaam' => $achternaam,]
['compact' => $compact])); // leeg of 'TRUE'

Output positief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'TRUE',
'Message' => 'Kaderleden opgevraagd'
'Kaderleden' => array(
'hccLidNummer' => $hccLidNummer,
'hccRol' => $hccRol,
'hccAanhef' => $hccAanhef,
'givenname' => $givenname,
'cn' => $cn,
'sn' => $sn,
'hccWoonplaats' => $hccWoonplaats,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'hccKaderMail' => $hccKaderMail);

Output negatief:
$reply = array(
'Action' => 'ZoekKaderLeden',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token']);

// H.9 PasKaderGegevensAan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// (wordt gebruikt door de Joomla kadersite module)
// Om de kaderleden hun forward in te laten stellen,
// en tegelijkertijd de opt-in / opt-out voor hccToonMobiel te laten regelen
// Kan tevens het kader email wachtwoord aanpassen
$request = xmlrpc_encode_request(
'PasKaderGegevensAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'hccKaderForward' => $hccKaderForward, // '' | $mail | $mailHccNet
'hccKaderToonMobiel' => $hccKaderToonMobiel, // 'TRUE' | 'FALSE' | 'NULL'
['nieuw_kaderPassword' => $nieuw_kaderPassword]));

Output positief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'TRUE',
'Message' => 'kadergegevens aangepast');

Output negatief:
$reply = array(
'Action' => 'PasKaderGegevensAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials',
['ExtraInfo' => 'Ongeldig token'|'Alleen kaderleden mogen deze aanroep uitvoeren']);

// ** Portal beheer.hcc.nl
// ** H.10 PasUserWachtwoordAan
// ** Betalende Hobbynet gebruikers kunnen hiermee hun wachtwoord aanpassen
// (authenticatie op basis van hccLogin en userpassword)
$request = xmlrpc_encode_request(
'PasUserWachtwoordAan',
array(
'hccLogin' => $username,
'userpassword' => $password,
'hobbynetAccount' => $hobbyname,
'nieuw_wachtwoord' => $nieuw_wachtwoord,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasUserWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!' |
'account $hobbynetAccount behoort niet bij gebruiker $hccLogin' |
'Kan ww van account $hobbynetAccount niet aanpassen');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.11 Pas het pseudoniem van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasPseudoniemAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccPseudoniem' => $hccPseudoniem,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'TRUE',
'Message' => 'Pseudoniem aangepast');
Output negatief:
$reply = array(
'Action' => 'PasPseudoniemAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' | 'Onjuiste credentials' | 'Pseudoniem bestaat al');

// ** t.b.v. aanpassen van de gebruikersinstellingen op een Joomla site **
// H.12 Controleer of een opgegeven wachtwoord aan de minimum eisen voldoet
$request = xmlrpc_encode_request(
'ValideerWachtwoordEisen',
array(
'userPassword' => $userPassword,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'TRUE',
'Message' => 'Wachtwoord voldoet aan de minimale eisen');
Output negatief:
$reply = array(
'Action' => 'ValideerWachtwoordEisen',
'Status' => 'FALSE',
'Message' => 'Wachtwoord voldoet niet aan de minimale eisen');

// ** H.13 PasWachtwoordAan
// ** Vanuit een Joomla template site kunnen gebruikers hiermee hun eigen wachtwoord aanpassen
// (authenticatie op basis van JoomlaToken, lidnummer, siteID. Extra controle via userpassword)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'userpassword' => $password,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.13.1 PasWachtwoordAan
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee hun eigen wachtwoord resetten
// (authenticatie op basis van PWResetToken en hccLogin).
// (Als de aanroep geslaagd is, dan is daarna het PWResetToken ongeldig)
$request = xmlrpc_encode_request(
'PasWachtwoordAan',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'nieuw_userPassword' => $nieuw_userPassword,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'TRUE',
'Message' => 'wachtwoord aangepast');
Output negatief:
$reply = array(
'Action' => 'PasWachtwoordAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'Het nieuwe wachtwoord voldoet niet aan de minimale eisen!');

// ** H.14 MaakPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers hiermee een wachtwoord reset aanvragen
// Deze aanroep geeft naast het PWResetToken ook het contact emailadres mee terug,
// zodat Joomla een reset-mail kan sturen
// (acties op basis van gebruikersnaam)
$request = xmlrpc_encode_request(
'MaakPWResetToken',
array(
'hccLogin' => $username,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'TRUE',
'PWResetToken' => $PWResetToken,
'mail' => $mail,
'Message' => 'Password reset token aangemaakt');
Output negatief:
$reply = array(
'Action' => 'MaakPWResetToken',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');

// ** H.15 ValideerPWResetToken
// ** Vanuit www.hcc.nl kunnen gebruikers een wachtwoord reset aanvragen
// Controleer dat het hier om een bestaand (en nog niet gebruikt) token gaat
$request = xmlrpc_encode_request(
'ValideerPWResetToken',
array(
'hccLogin' => $hccLogin,
'PWResetToken' => $PWResetToken,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'TRUE',
'Message' => 'Password reset token gevonden');
Output negatief:
$reply = array(
'Action' => 'ValideerPWResetToken',
'Status' => 'FALSE',
'Message' => 'hccLogin bestaat niet' | 'PWResetToken bestaat niet');

// H.16 Ruim een bestaand JoomlaToken op
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'RuimJoomlaTokenOp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'SiteID' => $siteID,
['ServerID' => gethostname(),]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'TRUE',
'Message' => 'JoomlaToken opgeruimd');
Output negatief:
$reply = array(
'Action' => 'RuimJoomlaTokenOp',
'Status' => 'FALSE',
'Message' => 'Onjuist JoomlaToken');

// ** Joomla module
// ** H.17 GeefAantalDomeinen
// ** Vraag het aantal domeinen op van een betalende Hobbynet gebruiker (t.b.v. IDEAL betaling)
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'GeefAantalDomeinen',
array(
'JoomlaToken' => $JoomlaToken,
'hccLidnr' => $hccLidnr,
'hobbynetAccount' => $hobbyname,
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'TRUE',
'hobbynetAccount' => $hobbyname,
'AantalDomeinen' => $aantalDomeinen,
'Message' => 'aantal domeinen opgevraagd');
Output negatief:
$reply = array(
'Action' => 'GeefAantalDomeinen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!' |
'account $hobbynetAccount behoort niet bij deze gebruiker');

// ** Joomla module
// ** H.18 ResetHCCCode
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'beheerLogin' => $beheerLogin, // geheime credentials van de site
'beheerPassword' => $beheerPassword, // geheime credentials van de site
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** Joomla module
// ** H.18.1 ResetHCCCode (hcc kantoor aanroep)
// ** Reset de hcc code van een gebruiker, en stuur vervolgens een SMS naar de 06 van het lid
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'ResetHCCCode',
array(
'JoomlaToken' => $JoomlaToken, // Het Joomla token van de sessie van de kantoor medewerker
'hccLidnr' => $hccLidnr, // Het lidnummer van de kantoor medewerker
'hccLidnummer' => $hccLidnummer, // Het lidnummer van het lid waarvan we de HCCcode aan gaan passen
'ServerID' => gethostname(),
'SiteID' => $serverName,
'RemoteID' => $remoteAddr));
Output positief:
$reply = array(
'Action' => 'ResetHCCCode',
'Status' => 'TRUE',
'Message' => 'Nieuwe HCCcode aangemaakt en verstuurd');

// ** t.b.v. aanpassen van de hccLogin van een gebruiker (Hobbynet functie op Joomla site) **
// H.19 Pas de hccLogin van een lid aan
// (LET OP: authenticatie op basis van lidnummer, JoomlaToken en siteID)
// hccLidnummer is het lidnummer waar de mutatie op moet worden uitgevoerd
// Kan alleen als de aanvrager HN#WM als rol heeft
$request = xmlrpc_encode_request(
'PasHccLoginAan',
array(
'hccLidnr' => $hccLidnr, // lidnummer van de aanvrager
'JoomlaToken' => $JoomlaToken, // JoomlaToken van de aanvrager
'hccLidnummer' => $hccLidnummer, // pas de hccLogin van dit lidnummer aan
'hccLogin' => $hccLogin, // dit is de gewenste nieuwe hccLogin
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'TRUE',
'Message' => 'hccLogin aangepast');
Output negatief:
$reply = array(
'Action' => 'PasHccLoginAan',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist' |
'Onjuiste credentials' |
'Gebruikersnaam al in gebruik');

// 3.1 Geef mijn lidnummer
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'GeefMijnLidnummer',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'TRUE',
'Message' => 'Lidnummer opgevraagd',
'hccLidnr' => $hccLidnr);
Output negatief:
$reply = array(
'Action' => 'GeefMijnLidnummer',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Gegevenscombinatie onjuist');

// ** Portal mijn.hcc.nl **
// ** t.b.v. 1e keer doorlopen van de profielpagina **
// 8.2 Controleer of de gebruikersnaam op dit moment bestaat
// (geen authenticatie)
// ** Deze gegevens worden opgevraagd bij hccnet.nl (action=3) **
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezeNaamNogBeschikbaar',
array(
'nieuw_hccLogin' => $nieuw_hccLogin,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Gebruikersnaam is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezeNaamNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Gebruikersnaam bestaat al');

// ** Enkel voor gebruik vanaf de kantoor portal **
// ** t.b.v. het hernoemen van accounts in CRM **
// 8.3 Controleer of een Pseudoniem op dit moment bestaat ??? NIET GEBRUIKT ??
// (geen authenticatie)
// ** Het betreft een momentopname, de naam wordt niet gereserveerd! **
$request = xmlrpc_encode_request(
'IsDezePseudoniemNogBeschikbaar',
array(
'nieuw_hccPseudoniem' => $nieuw_hccPseudoniem));
Output positief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'TRUE',
'Message' => 'Pseudoniem is nog beschikbaar');
Output negatief:
$reply = array(
'Action' => 'IsDezePseudoniemNogBeschikbaar',
'Status' => 'FALSE',
'Message' => 'Pseudoniem bestaat al');

// ** t.b.v. de verenigingszaken zoekpagina **
// A.1 Zoek alle bij de query passende hcc leden
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
$request = xmlrpc_encode_request(
'ZoekHCCLid',
array(
'beheerLogin' => $beheerLogin, // beheerder hccLidnummer
'beheerPassword' => $beheerPassword, // beheerder hccCode
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Groepering' => $Groepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (eerste deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| emailadres | (eerste deel van) e-mail adres |
| gebruikersnaam | (eerste deel van) de login naam |
| pseudoniem | (eerste deel van) het pseudoniem |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'ZoekMethode' => $ZoekMethode,
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' => array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'sn' => $sn,
'givenName' => $givenName,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer
'hccHuisToevoeging' => $hcchuisToevoeging,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem,
'ProfielBekend' => 'TRUE' | 'FALSE'])*);
Output negatief:
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker niet gevonden');
$reply = array(
'Action' => 'ZoekHCCLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. beheer.hcc.nl **
// A.3 Zoek alle bij de query passende hcc leden van deze groepering
// Het optionele veld ZoekLimiet past maximum aantal antwoorden aan
// (maximaal tot de door de XML-RPC server ingebouwde limiet)
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'ZoekGroeperingsLid',
array(
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Groepering' => $groepering,
'ZoekMethode' => $ZoekMethode,
'ZoekString' => $zoekstring,
['ZoekLimiet' => $ZoekLimiet,]
['Bijeenkomst' => $Bijeenkomst,] // Alleen voor gebruik op de
// bijeenkomsten aanwezigheidsregistratie pagina
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
+---------------------+-----------------------------------------+
| ZoekMethode | ZoekString |
+---------------------+-----------------------------------------+
| achternaam | (deel van) de naam |
| postcode | (eerste deel van) postcode |
| lidnummer | volledig lidnummer |
| nieuwe_leden | YYYYMMDD vanaf waar gezocht moet worden |
| opgezegde_leden | YYYYMMDD tot waar gezocht moet worden |
| uitgeschreven_leden | YYYYMMDD tot waar gezocht moet worden |
| overleden_leden | YYYYMMDD tot waar gezocht moet worden |
| kaderleden | n.v.t. |
+---------------------+-----------------------------------------+

Output positief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
['ExtraInfo' => 'Zoekopdracht afgebroken, Y van Z getoond',]
'Results' =>
[array(
'hccLidnummer' => $hccLidnummer,
'hccBeginDatum' => $hccBeginDatum,
'hccEindDatum' => $hccEindDatum,
'cn' => $cn,
'sn' => $sn,
'givenName' => $givenName,
'hccAchternaam' => $hccAchternaam,
'hccTussenVoegsels => hccTussenVoegsels,
'hccGeslacht' => $hccGeslacht,
'hccStraatnaam' => $hccStraatnaam,
'hccHuisnummer' => $hccHuisnummer,
'hccPostcode' => $hccPostcode,
'hccWoonplaats' => $hccWoonplaats,
'hccLand' => $hccLand,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccRegio' => $hccRegio,
'hccIG' => $hccIG,
'hccRol' => $hccRol,
'hccLogin' => $hccLogin,
'hccPseudoniem' => $hccPseudoniem)]*));
Output negatief:
$reply = array(
'Action' => 'ZoekGroeperingsLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker(s) niet gevonden' | 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten **
// A.4 Lid bezoekt bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'LidBezoektBijeenkomst',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
['AccountCode' => $AccountCode,]
['token' => $token,]
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
'hccLidnr' => $hccLidnr, // lid dat aanwezig gemeld moet worden
['correctie' => $hccLidnr,] // lid dat gecorrigeerd moet worden
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'TRUE',
'Message' => 'Bezoeker weggeschreven',
'Results' => array(
// info van deze bezoeker
'cn' => $cn, // cn (Verbeek, H.J.)
'hccGeslacht' => $hccGeslacht, // hccGeslacht van de bezoeker
'groeperingslid' => $groeperingslid, // TRUE of FALSE: is deze persoon lid van deze groepering
'mijnGroeperingen' => $mijnGroeperingen, // komma-gescheiden lijst (regio, [hccIG]*)
'aantalBezoeken' => $aantalBezoeken, // hoe vaak heeft dit lid deze bijeenkomst bezocht
// info van de bijeenkomst
'AantalBezoekers' => $AantalBezoekers); // aantal bezoekers van deze bijeenkomst
Output negatief:
$reply = array(
'Action' => 'LidBezoektBijeenkomst',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.5 Vraag Lidgegevens token aan (geldig voor dit lid, en deze groepering, op deze datum)
// Als geen datum gegeven is, dan is het token vandaag geldig
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'VraagLidgegevensTokenAan',
array(
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'hccLidnr' => $hccLidnummer, // vraag het token voor dit lid aan
'groepering' => $groepering, // zoek binnen deze groepering
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'TRUE',
'Message' => 'Token opgevraagd',
'groepering' => $Groepering,
'token' => $token,
'sn' => $sn);
Output negatief:
$reply = array(
'Action' => 'VraagLidgegevensTokenAan',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.6 Toon bezoekersoverzicht
// (authenticatie op basis van lidnummer en bezoekersregistratie token)
$request = xmlrpc_encode_request(
'GeefBezoekersOverzicht',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'token' => $token,
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'TRUE',
'Message' => 'Bezoekersoverzicht opgevraagd',
'Bezoekers' => $bezoekers,
['Locatie' => $Locatie]);
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersOverzicht',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// A.7 Geef het array met alle locaties
// (of beperk dit tot de locaties van de groepering $Groepering)
// Desgewenst worden alle resultaten waarbij hccToonInJoomla aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// Desgewenst worden alle resultaten waarbij ToonOpKaderNet aan staat onderdrukt
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocaties',
array(
['Groepering' => $hccGroepering,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']);
Output positief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);
Output negatief:
$reply = array(
'Action' => 'GeefLocaties',
'Status' => 'FALSE',
'Message' => 'Locaties niet beschikbaar',
'ExtraInfo' => 'Geen locaties gevonden voor groepering $hccGroepering',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE']);

// A.8 Registreer een niet-hcclid als bezoeker tijdens een bijeenkomst
// (authenticatie op basis van AccountNaam en AccountCode)
$request = xmlrpc_encode_request(
'RegistreerGast',
array(
'AccountNaam' => $lidnr, // credentials
'AccountCode' => $AccountCode, // credentials
'token' => $token, // credentials
'Bijeenkomst' => $groepering,
'geslacht' => $geslacht,
'naam' => $naam,
'mail' => $mail,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'buitenland' => $buitenland,
['nietLidNummer' => $nietLidNummer,]
['instructies' => $instructies,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => $aanroep,
'Status' => 'TRUE',
'Message' => 'Niet-lid als bezoeker geregistreerd',
'Result' => $result_array);

// A.9 Geef het array met alle locatienamen
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefLocatieNamen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE']));
['KaderMutatieFilter' => '' | 'TRUE']));

Output positief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'TRUE',
'Message' => 'Locaties opgevraagd',
'Locaties' => $locaties,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));
Output negatief:
$reply = array(
'Action' => 'GeefLocatieNamen',
'Status' => 'FALSE',
'Message' => 'Locatienamen niet beschikbaar',
'ExtraInfo' => 'Geen locatienamen gevonden',
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']));

// A.10 Schrijf een niet-lid in op een bulletin
// (2019.12.05: wordt actief gebruikt in Joomla module)
// Deze aanroep mag *ook* worden gebruikt om een wel-lid in te schrijven.
// Voorwaarde is dat bewezen is dat er controle bestaat over het opgegeven email adres
$request = xmlrpc_encode_request(
'SchrijfNietlidInOpBulletin',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'hccOptin' => $hccOptin, // bulletin waarop ingeschreven wordt
'hccOptinSource' => $hccOptinSource, // site waar aanmelding vandaan komt
'Email' => $Email, // niet-lid: email adres
'Naam' => $Naam, // niet-lid: naam
['hccLidNummer' => $hccLidNummer,] // optioneel: ik ben lid, dit is mijn lidnummer
['Postcode' => $Postcode,] // optioneel: niet-lid: postcode
['Huisnummer' => $Huisnummer,] // optioneel: niet-lid: huisnummer
['hccGeslacht' => $hccGeslacht,] // optioneel: niet-lid: geslacht (M/V/O)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'TRUE',
'Message' => 'Inschrijving op bulletin gelukt');
Output negatief:
$reply = array(
'Action' => 'SchrijfNietlidInOpBulletin',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist',
'ExtraInfo' => 'Invalid DN syntax' |
'Invalid credentials');

// ** t.b.v. administreren van bijeenkomsten en opvragen van lidgegevens **
// A.11 Toon bezoekers aantallen
// (authenticatie op basis van AccountNaam en AccountCode of token)
$request = xmlrpc_encode_request(
'GeefBezoekersAantallen',
array(
['JoomlaToken' => $JoomlaToken,]
'AccountNaam' => $lidnr,
'AccountCode' => $AccountCode,
'token' => $token,
['datum' => $datum,] // optioneel: datum YYYY-MM-DD, anders: vandaag
'Bijeenkomst' => $Bijeenkomst, // groepering die deze bijeenkomst organiseert
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefBezoekersAantallen',
'Status' => 'TRUE',
'Message' => 'BezoekersAantallen opgevraagd',
'Datum' => $datum,
'Bijeenkomst' => $Bijeenkomst,
'Bezoekers' => array(
[HCC!seniorenacademie] => Array(
[Gorinchem] => 15
[Woerden] => 36)
...));
Output negatief:
$reply = array(
'Action' => 'GeefBezoekersAantallen',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Geen bijeenkomst gevonden' | 'Geen bezoekers gevonden');

// ** t.b.v. Joomla module Bas
// A.12 GeefAlleBulletins
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleBulletins',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefAlleBulletins',
'Status' => 'TRUE',
'Message' => 'Bulletins opgevraagd',
'bulletins' => $bulletins);

// ** t.b.v. Joomla module Bas
// A.13 ExpandeerPostcode
// (geen authenticatie)
$request = xmlrpc_encode_request(
'ExpandeerPostcode',
array(
'postcode' => $postcode,
'huisnummer' => $huisnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'ExpandeerPostcode',
'Status' => 'TRUE',
'Message' => 'Postcode opgevraagd',
'detailgegevens' => $detailgegevens);

// ** t.b.v. Joomla module Bas
// A.25 UpdateNAW
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'UpdateNAW',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
'geslacht' => $geslacht,
'postcode' => $postcode,
'huisnummer' => $huisnummer,
'toevoeging' => $toevoeging,
'straat' => $straat,
'woonplaats' => $woonplaats,
'landcode' => $landcode,
'email' => $email,
'voornaam' => $voornaam,
'voorletters' => $voorletters,
'hccTelefoon' => $hccTelefoon,
'hccMobiel' => $hccMobiel,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'UpdateContactGegevens',
'Status' => 'TRUE',
'Message' => 'Contactgegevens bijgewerkt');

// ** t.b.v. Joomla module Bas
// A.18 NormaliseerTelefoon
// (geen authenticatie)
$request = xmlrpc_encode_request(
'NormaliseerTelefoon',
array(
'hccLand' => $hccLand,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress));
Output positief:
$reply = array(
'Action' => 'NormaliseerTelefoon',
'Status' => 'TRUE',
'Message' => 'Telefoonnummer genormaliseerd',
'Telefoonnummer' => $Telefoonnummer);

// ** t.b.v. Joomla module Bas
// A.21 HaalIGBedragenOp
// Geef alle IG's waar je zelf lid van kunt worden, inclusief het bijbehorende bedrag
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalIGBedragenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalIGBedragenOp',
'Status' => 'TRUE',
'Message' => 'Interessegroepen en bedragen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.22 HaalTariefGroepenOp
// (geen authenticatie)
$request = xmlrpc_encode_request(
'HaalTariefGroepenOp',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalTariefGroepenOp',
'Status' => 'TRUE',
'Message' => 'Tariefgroepen opgevraagd',
'details' => $details);

// ** t.b.v. Joomla module Bas
// A.23 PasInteressegroepAan
// (authenticatie op basis van lidnummer, JoomlaToken en siteID)
$request = xmlrpc_encode_request(
'PasInteressegroepAan',
array(
'hccLidnr' => $hcclidnr,
'JoomlaToken' => $JoomlaToken,
['nieuw' => $IG_lijst_nieuw,]
['weg' => $IG_lijst_weg,]
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'PasInteressegroepAan',
'Status' => 'TRUE',
'Message' => 'IG keuzen aangepast');

// ** t.b.v. Joomla module Bas
// A.24 GeefSSOUrls
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefSSOUrls',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefSSOUrls',
'Status' => 'TRUE',
'SSO_urls' => $sso_urls,
'Message' => 'Single Sign On URLs opgevraagd');

// ** HenZ **
// ** t.b.v. daily cron job **
// ** t.b.v. dagelijkse opschoon jobs Joomla template sites **
// C.1 Vraag de lijst met uitgeschreven leden op
// Dit kan beperkt worden tot een bepaalde regio of interessegroep
// Daarnaast kan het tijdvak waarin gezocht wordt vrij gekozen worden
// (gesteld dat de LDAP database nog leden uit die periode bevat)
// Antwoord: lijst met (lidnummer, hccLogin, sn,
// datum einde lidmaatschap (formaat:YYYYMMDD))

==> GeefUitgeschrevenLeden <== (oud: GeefOpgezegdeLeden)

$request = xmlrpc_encode_request(
'GeefUitgeschrevenLeden',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccRegio' => $hccRegio, // of leeg
'hccIg' => $hccIg, // of leeg
'datum_vanaf' => $datum_sinds, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: 3 dagen geleden)
'datum_tot' => $datum_tot, // YYYY-MM-DD of YYYYMMDD of leeg (leeg: vandaag)
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'TRUE',
'Message' => 'Uitgeschreven leden',
['hccRegio' => $hccRegio,]
['hccIg' => $hccIg,]
['datum_vanaf' => $datum_vanaf,]
['datum_tot' => $datum_tot,]
['Results' => array(
[array(
'hccLogin' => $hccLogin,
'hccLidNummer' => $hccLidnummer,
'sn' => $sn,
'DatumEindeLidmaatschap' => $DatumEindeLidmaatschap)]*);
Output negatief:
$reply = array(
'Action' => 'GeefUitgeschrevenLeden',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');
</pre>

=== HCCpartner aanroepen ===
(interface versie 1) 
(oude interface, niet meer gebruiken!)

<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.1 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartner',
array('ControleerHCCLidmaatschap',
array('partnerLogin', $partnerLogin),
array('partnerPassword', $partnerPassword),
array('hccLidnummer', $hcclidnummer),
array('postcode', $postcode)));
Output positief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'TRUE'));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'));
$reply = array(
'HCCpartner',
array('Action', 'ControleerHCCLidmaatschap'),
array('Status', 'FALSE'),
array('Message', 'Onjuiste credentials'));

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartner',
array(
'OnbekendeAanroep',
array('parameter', $iets)));
Output negatief:
$reply = array(
'HCCpartner',
array('Action', 'OnbekendeAanroep'),
array('Status', 'FALSE'),
array('Message', 'Opdracht onbekend'));
</pre>

=== HCCpartners aanroepen ===
(interface versie 2)

<pre>
// ** t.b.v. controle op hcc lidmaatschap door hcc partner **
// D.2 Controleer of iemand lid is op basis van lidnummer en postcode
// Antwoord: TRUE of FALSE
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'ControleerHCCLidmaatschap',
'partnerLogin' => $partnerLogin,
'partnerPassword' => $partnerPassword,
'hccLidnummer' => $hcclidnummer,
'postcode' => $postcode,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'TRUE',
['ExtraInfo' => 'groepering=$groepering']); // als de partner beperkt is tot 1 groepering
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE');
$reply = array(
'0' => 'HCCpartners',
'Action' => 'ControleerHCCLidmaatschap',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials');

// onbekende aanroep
$request = xmlrpc_encode_request(
'HCCpartners',
array(
'Action' => 'OnbekendeAanroep',
'parameter' => $iets));
Output negatief:
$reply = array(
'0' => 'HCCpartners',
'Action' => 'OnbekendeAanroep',
'Status' => 'FALSE',
'Message' => 'Opdracht onbekend');
</pre>

=== HCC-kader aanroepen ===

<pre>
// ** beheer.hcc.nl **
// F.2 Controleer of dit een kaderlid is
// (authenticatie op basis van hccLogin en userPassword)
$request = xmlrpc_encode_request(
'IsKaderLid',
array(
'hccLogin' => $hccLogin,
'userPassword' => $userPassword,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'TRUE',
'Message' => 'Is kaderlid',
'hccLidnr' => $hccLidnr,
'cn' => $cn,
'sn' => $sn,
'hccRol' => $hccRol,
'mail' => $mail,
'mailHccnet' => $mailHccnet,
'hccKaderMail' => $hccKaderMail,
'hccKaderForward' => $hccKaderForward);
Output negatief:
$reply = array(
'Action' => 'IsKaderLid',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' | 'Is geen kaderlid');

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.4 Vraag alle groeperingen op
// Het is mogelijk om een groepering te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// ToonInOverzichtenFilter : attribuut 'hccToonInOverzichten'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// BulletinsFilter : attribuut 'hccBulletins'
// EmailFilter : attribuut 'hccFunctionalEmail'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleGroeperingen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['ToonInOverzichtenFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['BulletinsFilter' => '' | 'TRUE',]
['EmailFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE'));
Output positief:
$reply = array(
'Action' => 'GeefAlleGroeperingen',
'Status' => 'TRUE',
'Message' => 'Lijst met groeperingen opgevraagd',
'Result' => $groeperingen,
['JoomlaFilter' => 'TRUE',]
['ToonInOverzichtenFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => 'TRUE']);

// ** t.b.v. lijsten op de kadernet server en de kantoor-beheerpagina **
// F.5 Vraag alle kaderrollen op
// Het is mogelijk om een kaderrol te onderdrukken, als er in LDAP '''een''' waarde in een opgegeven attribuur aanwezig is.
// (iedere waarde anders dan een lege string wordt behandeld alsof 'TRUE' gegeven is)
// JoomlaFilter : attribuut 'hccToonInJoomla'
// KadernetFilter : attribuut 'hccToonOpKaderNet'
// KaderMutatieFilter : attribuut 'hccKaderMutaties'
// (geen authenticatie)
$request = xmlrpc_encode_request(
'GeefAlleKaderRollen',
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress,]
['JoomlaFilter' => '' | 'TRUE',]
['KadernetFilter' => '' | 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']));
Output positief:
$reply = array(
'Action' => 'GeefAlleKaderRollen',
'Status' => 'TRUE',
'Message' => 'Lijst met kaderrollen opgevraagd',
'Result' => $kaderrollen,
['JoomlaFilter' => 'TRUE',]
['KadernetFilter' => 'TRUE',]
['KaderMutatieFilter' => '' | 'TRUE']);

// ** t.b.v. de kantoor-beheerpagina **
// F.9 Geef de gevevens van de mailbox van dit kaderlid
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
$request = xmlrpc_encode_request(
'GeefKadermailGegevens',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer));
Output positief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'TRUE',
'Message' => 'Gebruiker(s) gevonden',
'kadermail_omvang' => $Formaat,
'kadermail_aantal_inbox' => $aantal_inbox,
'kadermail_aantal_nieuw' => $aantal_nieuw,
'kadermail_laatst_opgehaald' => $laatst_opgehaald);
Output negatief:
$reply = array(
'Action' => 'GeefKadermailGegevens',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid'));

// ** t.b.v. de Joomla Kadernet module **
// * F.10 MuteerGroeperingSamenstelling
// (authenticatie op basis van lidnummer, JoomlaToken en siteID en als extra hccCode van de aanvrager)
$request = xmlrpc_encode_request(
'MuteerGroeperingSamenstelling',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'hccCode' => $hccCode,
'groepering' => $groepering,
'hccLidnummer => $hccLidnummer, // lidnummer van het te muteren hcc lid
'hccRol' => $hccRol, // de nieuwe dan wel op te heffen rol
// de rol 'ALLES_WEG' ruimt alle rollen van dit hcc lid voor deze groepering op
'actie' => 'Nieuw' | 'Weg',
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress,]
Output positief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'TRUE',
'Message' => 'Groepering samenstelling aangepast',
['ExtraInfo' => 'Bedankmail gestuuurd aan ex-kaderlid']);
Output negatief:
$reply = array(
'Action' => 'MuteerGroeperingSamenstelling',
'Status' => 'FALSE',
'Message' => 'Onjuiste credentials' |
'Gegevenscombinatie onjuist' |
'Vul alle verplichte velden in!',
['ExtraInfo' => 'Invalid credentials' |
'lidnummer <hccLidnummer> is geen kaderlid' |
'Oude rol niet gevonden' |
'Nieuwe rol kan niet samen met bestaande rol' |
'Alleen voorzitter of secretaris kan kadermutaties uitvoeren']);
</pre>

=== HCC-groepering aanroepen ===

<pre>

// I.2 controleer of een gebruiker bestaat op basis van de combinatie
// lidnummer + postcode + huisnummer
// (authenticatie op basis van beheerder hccLogin en beheerder userPassword)
// (alternatieve authenticatie mogelijk door lidnummer + hcc-code in te vullen)
//
// Aan de aanroeper worden zekere eisen gesteld:
// * dient een rol te vervullen binnen de groepering 'FOR'(forum)
// * dan wel dient de rol 'VRBK' (vraagbaak) te vervullen binnen een groepering
//
// Er wordt door de gehele leden-database gezocht, waarna terug wordt gegeven
// * of dit hcc lid inderdaad bestaat
// en, als het om een aanvraag van een vraagbaak vrijwilliger gaat,
// * tevens of het gezochte hcc lid deel uitmaakt van zijn groepering

$request = xmlrpc_encode_request(
'IsHCCLid',
array(
'hccLogin' => [$hccLogin | $hccLidnummer],
'userPassword' => [$userPassword | $hccCode],
'zoekhccLidnr' => $zoekhccLidnr,
'zoekhccPostcode' => $zoekhccPostcode,
'zoekhccHuisnr' => $zoekhccHuisnr,
'zoekgroepering' => $zoekgroepering));
Output positief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'TRUE',
'Message' => 'Gebruikersgegevens gecontroleerd',
['Groeperingslid' => $IsGroeperingLid]));
Output negatief:
$reply = array(
'Action' => 'IsHCCLid',
'Status' => 'FALSE',
'Message' => 'Gebruiker bestaat niet' |
'Onjuiste credentials' |
'Wel HCC lid, maar geen lid van groepering $groepering' |
'Onvoldoende rechten' |
'Vul alle verplichte velden in!'));
</pre>

=== HenZ aanroepen ===

<pre>

// I.3 Geef de einddatum van een actief dan wel uitgeschreven lid
// (authenticatie op basis van beheerdernaam en beheerderwachtwoord)
$request = xmlrpc_encode_request(
'GeefhccEindDatum',
array(
'beheerLogin' => $beheerLogin,
'beheerPassword' => $beheerPassword,
'hccLidnummer' => $hccLidnummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'TRUE',
'hccLidnummer' => $hccLidnummer,
'hccLogin' => $hccLogin,
'hccEindDatum' => $hccEindDatum ('yyyymmdd' | ''));
Output negatief:
$reply = array(
'Action' => 'GeefhccEindDatum',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Invalid credentials' |
'Lidnummer niet gevonden');
</pre>

=== (Forum,vraagbaak) onderwerpen ===

<pre>
// L.1 MaakOnderwerp
$request = xmlrpc_encode_request(
'MaakOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'description' => $description,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp is aangemaakt',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MaakOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster');

// L.2 VerwijderOnderwerp

$request = xmlrpc_encode_request(
'VerwijderOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'TRUE',
'onderwerp' => $onderwerpID,
'Message' => 'Onderwerp is verwijderd',
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'VerwijderOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Ruim eerst alle geautoriseerde gebruikers op' |
'Kan onderwerp niet verwijderen');

// L.3 GeefOnderwerpen
// Geef het array met de lijst van onderwerpen voor de betreffende groepering
//
$request = xmlrpc_encode_request(
'GeefOnderwerpen',
array(
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering));
Output positief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'TRUE',
'Message' => 'Onderwerpen opgevraagd',
'onderwerpen' => $onderwerpen); // het array met onderwerpen
Output negatief:
$reply = array(
'Action' => 'GeefOnderwerpen',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!');

// L.4 MuteerOnderwerp
// Pas de description van een onderwerp aan
//
$request = xmlrpc_encode_request(
'MuteerOnderwerp',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'description' => $description,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'TRUE',
'Message' => 'Onderwerp aangepast',
'onderwerp' => $onderwerpID,
'description' => $description);
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerp',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet' |
'Onderwerp behoort bij andere groepering');

// L.5 MuteerOnderwerpAutorisatie
// Geef kaderlid $kaderLidNr de autorisatie MOD, VRBK of RED bij onderwerp $onderwerp
// (of haal die autorisatie weg)
$request = xmlrpc_encode_request(
'MuteerOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'groepering' => $groepering,
'onderwerp' => $onderwerpID,
'kaderLidNr' => $kaderLidNr,
'hccAutorisatie' => 'MOD' | 'VRBK' | 'RED',
['verwijder' => 'TRUE']));
Output positief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Onderwerp autorisatie aangepast');
Output negatief:
$reply = array(
'Action' => 'MuteerOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Geen kaderlid' |
'Onjuiste autorisatie opgegeven' |
'Onderwerp bestaat niet');

// L.6 ToonOnderwerpAutorisatie
$request = xmlrpc_encode_request(
'ToonOnderwerpAutorisatie',
array(
'hccLidnr' => $hccLidnr,
'JoomlaToken' => $JoomlaToken,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress,
'onderwerp' => $onderwerpID));
Output positief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'TRUE',
'Message' => 'Autorisaties opgehaald',
'onderwerp' => $onderwerpID,
'description' => $description,
'autorisaties' =>
[Array(
'hccLidnummer' => $hccLidnummer
'cn' => $cn
'hccAutorisatie' => {komma-gescheiden autorisaties})]);
Output negatief:
$reply = array(
'Action' => 'ToonOnderwerpAutorisatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Onjuist JoomlaToken' |
'Geen webmaster' |
'Onderwerp bestaat niet');
</pre>

=== Microsoft Dynamics Cloud (Cayentis) onderwerpen ===

<pre>
// M.1 Upload_CSV_bestand
// De CRM proxy upload de dagelijkse CSV synchronisatie-bestanden naar de XML-RPC server
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Upload_CSV_bestand',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'CSV_bestand_type' => '1' | '2' | '3' , // 1=Contactpersonen/Hoofdlidmaatschappen
// 2=Gremiumlidmaatschap codes
// 3=Gremiumlidmaatschappen
'CSV_bestand' => $CSV_bestand)); // het CSV bestand (base64 encoded)
Output positief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'TRUE',
'Message' => 'Bestand opgeslagen');
Output negatief:
$reply = array(
'Action' => 'Upload_CSV_bestand',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.2 SchrijfNieuwLidIn
//
// Maak in het CRM een nieuw HCC lid aan
// De NAW gegevens worden in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'SchrijfNieuwLidIn',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'NAWgegevens' => $NAW_Array,
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress);
// $NAW_array = array(
// 'GeboorteDatum' => $geboortedatum,
// 'Geslacht' => $geslacht,
// 'Voornaam' => $voornaam,
// 'Voorletters' => $voorletters,
// 'Tussenvoegsel' => $tussenvoegsel,
// 'Achternaam' => $achternaam,
// 'Straatnaam' => $straatnaam,
// 'Huisnummer' => $huisnummer,
// 'HuisnummerToevoeging' => $huisnummertoevoeging,
// 'Woonplaats' => $woonplaats,
// 'Postcode' => $postcode,
// 'Land' => $land,
// 'Telefoonnummer' => $telefoonnummer,
// 'MobielNummer' => $mobielnummer,
// 'Mail' => $mail,
// 'IBAN' => $IBAN,
// 'Interessegroep' => $IGs, // komma-gescheiden lijst met IG's
// 'Geschenk' => $geschenk,
// 'Actiecode' => $actiecode,
// 'Voorwaarden' => $Akkoord); // 'Akkoord'
)
Output positief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'TRUE',
'Message' => 'nieuw lid ingeschreven',
'hccLidnr' => $hccLidnr,
'hccCode' => $hccCode);
Output negatief:
$reply = array(
'Action' => 'SchrijfNieuwLidIn',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.3 Verwerk_JSON_mutatie
// De CRM proxy kan NAW en/of IG mutaties en/of hccCode mutaties live doorgeven
// Deze gegevens worden in JSON in een dedicated formaat aangeleverd
// (authenticatie op basis van beheerLogin en beheerPassword)
$request = xmlrpc_encode_request(
'Verwerk_JSON_mutatie',
array(
'beheerLogin' => $beheerLogin, // xml-rpc user
'beheerPassword' => $beheerPassword, // xml-rpc password
'mutatie_type' => '1' | '2', // 1=Contactpersoon/Hoofdlidmaatschap
// 2=Gremiumlidmaatschap
'JSON_mutatie' => $JSON_mutatie)); // de JSON payload
Output positief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'TRUE',
'Message' => 'Mutatie verwerkt');
Output negatief:
$reply = array(
'Action' => 'Verwerk_JSON_mutatie',
'Status' => 'FALSE',
'Message' => 'Gegevenscombinatie onjuist'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');

// M.4 Vertaal landcode
// Het CRM werkt met numerieke landcodes, wij met cijfers
// Vertaal die
// Er moet in de aanroep 1 veld aanwezig zijn, beide waarden komen in het antwoord terug
$request = xmlrpc_encode_request(
'ISO_landcode',
array(
['ISO_numeriek' => $ISO_numeriek,]
['ISO_code ' => $ISO_code]));
Output positief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'TRUE',
'Message' => 'ISO code lookup geslaagd',
'ISO_numeriek' => $ISO_numeriek,
'ISO_code ' => $ISO_code,
'ISO_benaming' => $ISO_benaming); // de descriptive name van deze ISO code
Output negatief:
$reply = array(
'Action' => 'ISO_landcode',
'Status' => 'FALSE',
'Message' => 'Kan geen bijpassende vertaling vinden'
'ExtraInfo' => 'Vul alle verplichte velden in!' |
'Er is iets mis gegaan');
</pre>
// M.5 MuteerAanmeldingsformulier
// Sla een JSON veld op in de XML-RPC server zodat deze weer opgehaald kan worden door de websites
// Authenticatie op basis van hccLidnummer en JoomlaToken
// Deze mutaties mogen alleen door HN#WM of SITE#WM gedaan worden.

$request = xmlrpc_encode_request(
MuteerAanmeldingsformulier,
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
'formulierdata' => $formulierdata, // JSON veld met alle gegevens voor het aanmeld formulier
'ServerID' => gethostname(),
'SiteID' => $siteID,
'RemoteID' => $remoteIPaddress ));
Output positief:
$reply = array(
'Action' => 'MuteerAanmeldingsformulier',
'Status' => 'TRUE',
'Message' => 'aanmeldingsformulier bijgewerkt';

// M.6 HaalAanmeldingsformulier
// (geen authenticatie)
$request = xmlrpc_encode_request(
HaalAanmeldingsformulier,
array(
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalAanmeldingsformulier',
'Status' => 'TRUE',
'formulierdata' => $formulierdata); // JSON veld met alle gegevens voor het aanmeld formulier
</pre>

// M.7 GeefFactuurOverzicht
// (authenticatie op basis van hccLidnummer + JoomlaToken + siteID
$request = xmlrpc_encode_request(
GeefFactuurOverzicht,
array(
'hccLidnummer' => $hccLidnummer,
'JoomlaToken' => $JoomlaToken,
['ServerID' => gethostname(),]
'SiteID' => $siteID,
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'GeefFactuurOverzicht',
'Status' => 'TRUE',
'FactuurOverzicht' => $FactuurOverzicht);
// $FactuurOverzicht =
// array(
// array(
// 'FactuurID' => 'a5b93460-4536-ea11-a813-000d3a2c53fa',
// 'FactuurNummer' => '200118673J5'
// 'FactuurDatum' => '2020-01-15'
// 'bedrag' => 42.37
// 'BetaalStatus' => 0]));
// )

// M.8 HaalFactuur
// (authenticatie op basis van JoomlaToken of FactuurToken)
$request = xmlrpc_encode_request(
HaalFactuur,
array(
'hccLidnummer' => $hccLidnummer,
['JoomlaToken' => $JoomlaToken,]
['FactuurToken' => $FactuurToken,]
'FactuurNummer' => $FactuurNummer,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'HaalFactuur',
'Status' => 'TRUE',
'factuur' => $factuurgegevens);
// $factuurgegevens =
// array(
// 'FactuurNummer' => $FactuurNummer,
// 'FactuurDatum' => $FactuurDatum,
// 'FactuurID' => $FactuurID,
// 'Bestandsnaam' => $Bestandsnaam,
// 'PDF' => $PDF) // base64 encoded PDF
</pre>

=== Echo test ===

<pre>

// t.b.v. controle of de verbinding met de XML-RPC server functioneert
// Eenvoudige echo test

$request = xmlrpc_encode_request(
'echo',
array(
'What' => $string,
['ServerID' => gethostname(),]
['SiteID' => $siteID,]
['RemoteID' => $remoteIPaddress]));
Output positief:
$reply = array(
'Action' => 'echo',
'Status' => 'TRUE',
'Message' => $string);
</pre>

=== HenZ XML-RPC interface ===

Overzicht van XML-RPC procedures die bij HenZ draaien
(worden via de Hobbynet XML-RPC server afgehandeld)

<pre>
- Action=2
wijzig gebruikersnaam en wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=3
controleer of een gebruikersnaam bestaat
(XML-RPC server voert de hccnet XML-call uit, zie 8.2)

- Action=4
creer een nieuwe gebruiker. Per lidnummer is er 1 account. Als er al een
account voor dit lidnummer bestaat wordt het bestaande account hernoemd.
(XML-RPC server voert de hccnet XML-call uit, zie 8.1)

- Action=5
wijzig wachtwoord op basis van hcclidnummer en de hash van de hcccode.
(geen aparte interface definitie noodzakelijk, bestaat al lokaal in XML-RPC server)
(XML-RPC server voert de hccnet XML-call uit, zie 2.1, 2.2 en 2.3)

- Action=7
Uitgeschreven lid is weer actief lid geworden
(Wordt aangeroepen vanuit de cronjob)

- Action=8
Lid heeft een nieuwe hcc-code gekregen
(Wordt aangeroepen vanuit de cronjob)
</pre>

=== Release notes ===
<pre>
2012.02.08 Wijzigingen versie 5:
- 4.1 verwijder_hcc_Lidnummer i.p.v. hcc_Lidnummer
- 4.1 optionele extra parameter verwijder_hccLogin
- Optionele parameters aangegeven
- Vanwege de duidelijkheid de beheerLogin en beheerPassword velden
bovenin de betreffende aanroepen gezet
(De volgorde van de parameters is niet relevant, dus dit is geen
interface-aanpassing)
2012.02.16 Wijzigingen versie 6:
- 2.1/2.2/2.3 geef ook cn en sn terug na aanpassen van het wachtwoord
- 3.1 geef cn en sn terug na aanmaken nieuwe gebruiker
2012.02.27 Wijzigingen versie 7:
- Neem de XML-RPC interface van HenZ in deze XML-RPC server op
8.1 Maak nieuwe gebruiker bij hccnet.nl, en sla gegevens tevens in LDAP op
- 2.1 wijzig wachtwoord - optie 1
* Nieuw wachtwoord is verplicht, niet optioneel
* wijzigingen worden naar hccnet.nl doorgezet
- 2.2 wijzig wachtwoord, optie 2
* Nieuw wachtwoord is verplicht, niet optioneel
* gebruikersnaam kan niet meer via deze interface aangepast worden
* wijzigingen worden naar hccnet.nl doorgezet
- 2.3 wijzig wachtwoord, optie 3
* wijzigingen worden naar hccnet.nl doorgezet
2012.03.26 Wijzigingen versie 8:
- Breidt de XML-RPC interface van HenZ in deze XML-RPC server uit met
8.2 Controleer of de gebruikersnaam op dit moment bestaat
2012.04.09 Wijzigingen versie 9:
- Vervang alle 'ldap' aanroepen door 'HCCldap' aanroepen
- documentatie van HenZ call action=2 aangepast, action=5 toegevoegd
2012.05.03 Wijzigingen versie 10:
- 1.1 / 1.2 / 1.3 geven nu ook 'ProfielBekend' terug om uniek te bepalen
of deze bezoeker een first-time-login pagina te zien dient te krijgen
- documentatie van 2.1 (wijzig wachtwoord) aangepast:
2.1 kan alleen als profiel is doorlopen
- nieuwe procedure t.b.v. zoekscherm PC30
* A.1 ZoekHCCLid
- hiervoor is de database met diverse velden uitgebreid
(postcode, e-mailadres, huisadres, woonplaats, land, telefoonnummer)
Dit heeft impact op diverse andere procedures (t.b.s.)
- nieuwe procedure t.b.v. 'gewone' profielpagina
* B.1 GeefDBFPersoonID
- nieuwe procedure t.b.v. cron-job
* C.1 GeefOpgezegdeLeden
2012.05.10 Wijzigingen versie 11
- 1.3 GebruikerBestaatControle
* nieuwe parameter: hccPseudoniem
* nieuw veld in antwoord: hccPseudoniem
- 2.3 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 2.4 WijzigGebruikersGegevens
* nieuwe parameter: hccPseudoniem
- 3.1 NieuweGebruiker
* nieuwe parameter: hccPseudoniem
- 8.1 MaakGebruikerAan
* nieuwe parameter: nieuw_hccPseudoniem
* alle parameters zijn verplicht (niet langer optioneel)
* nieuw antwoord: Gegevenscombinatie onjuist
- 8.3 IsDezePseudoniemNogBeschikbaar
* Nieuwe procedure t.b.v. 1e keer doorlopen profielpagina
- A.1 ZoekHCCLid
* 'Zoeklimiet bereikt' wordt als ExtraInfo meegegeven
* nieuwe velden in antwoord: hccPseudoniem en hccLogin
- B.1 GeefDBFPersoonID
* Zoeken kan nu ook op hccLogin en op hccPseudoniem
- C.1 GeefOpgezegdeLeden
* Geef nu ook hccLogin en hccPseudoniem terug
2012.05.14 Wijzigingen versie 12
- 1.x GebruikerBestaatControle
* Geef ook DBFPersoonID terug
- 4.1 Gooi een gebruiker weg.
* Haal ongebruikte parameter hccLogin weg
- 5.1 Wijzig hccIG
* Haal ongebruikte parameter hccLogin weg
- 6.1 Wijzig hccRegio
* Haal ongebruikte parameter hccLogin weg
- 7.1 Wijzig hccRol
* Haal ongebruikte parameter hccLogin weg
2012.05.20 Wijzigingen versie 13
- A.1 ZoekHCCLid
* Geef resultaten gestructureerder formaat
* Geef in ExtraInfo weer hoeveel echte resultaten er gevonden zijn
- C.1 GeefOpgezegdeLeden
* Geef resultaten in gestructureerder formaat
2012.06.03 Wijzigingen versie 14
- 3.1 NieuweGebruiker
* Geef ook DBFPersoonID mee
2012.08.17 Wijzigingen versie 15
- C.1 GeefOpgezegdeLeden
* Geef ook hccLogin in het antwoord terug
- D.1 HCCpartner/ControleerHCCLidmaatschap
* Nieuwe aanroep
2012.09.29 Wijzigingen versie 16
- Alle cron gerelateerde opdrachten verwijderd
* 3.1 NieuweGebruiker
* 4.1 GooiGebruikerWeg
* 5.1 WijzigHccIG
* 6.1 WijzigHccRegio
* 7.1 WijzigHccRol
2012.10.28 Wijzigingen versie 17
- nieuwe procedure t.b.v. PC30 beheerpagina
* A.2 HaalPC30Token
- nieuwe procedure t.b.v. Drupal profielpagina
* 2.4 vervallen
(WijzigGebruikersGegevens op basis van pseudoniem)
* 2.5 WijzigGebruikersGegevens
Nieuwe keuze: wijzig pseudoniem
2012.11.14 Wijzigingen versie 18
- 1.x GebruikerBestaatControle
* Geef ook mail in het antwoord terug
2012.11.30 Wijzigingen versie 19
- E.1 HCCkader/WijzigGebruikersGegevens
* Nieuwe aanroep
- F.1 / F.2 / F.3 ControleerKaderlid
* Nieuwe aanroep
2012.12.18 Wijzigingen versie 20
- Haal DBFPersoonID weg uit alle aanroepen en alle resultaten
* Antwoord van 1.x GebruikerBestaatControle
* B.1 GeefDBFPersoonID opgeheven
- A.1 ZoekHCCLid geeft nu ook hccMobiel terug (t.b.v. PC30 zoekpagina)
- C.1 GeefOpgezegdeLeden verder uitgewerkt:
* Geeft alleen de door Drupal gebruikte velden 'hccLogin' en 'hccEindDatum'
terug in het antwoord
* Geeft nu 'echte' antwoorden i.p.v. dummy resultaten
- F.1 ControleerKaderlid geeft nu ook optioneel 'sn' en 'givenName'
terug (in de beheer-variant)
2013.01.25 Wijzigingen versie 21
- A.1 ZoekHCCLid uitgebreid
* Geeft nu ook hccBeginDatum, hccEindDatum en hccRol terug
2013.02.02 Wijzigingen versie 22
- A.1 ZoekHCCLid
* Interface aangepast
- A.3 ZoekGroeperingsLid
* Nieuwe aanroep
- F.4 GeefAlleGroeperingen
* Nieuwe aanroep
- F.5 GeefAlleKaderRollen
* Nieuwe aanroep
2013.03.01 Wijzigingen versie 23
- A.3 ZoekGroeperingsLid
* Geeft andere resultaten terug
- 2.2 WijzigWachtwoord
* Geeft nu ook hccLogin terug (voor ww-vergeten op de Drupal site)
- HCCenquete implementatie
* G.1 Expandeer NL postcode
* G.2 Haal lidgegevens op
* G.3 Pas lidgegevens aan
2013.03.18 Wijzigingen versie 24
- ZoekGroeperingsLid op basis van token
- A.4 Lid bezoekt bijeenkomst
* nieuwe aanroep
- A.5 VraagLidgegevensTokenAan
* nieuwe aanroep
2013.04.07 Wijzigingen versie 25
- D.1 HCCpartner/ControleerHCCLidmaatschap
Simpeler interface ontwikkeld ('HCCpartners' i.p.v. 'HCCpartner')
- G.3 mag ook Tussenvoegsels aanpassen
2013.04.25 Wijzigingen versie 26
- H.1 HCC-groepering / GebruikerBestaatControle
Nieuwe interface voor validatie vanaf groeperings websites
2013.05.03 Wijzigingen versie 27
- 2.6 HaalOptInKeuzen
* nieuwe aanroep
- 2.7 SchrijfOptInKeuzen
* nieuwe aanroep
- 2.8 HaalOptInLijst
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* nieuwe aanroep
- HCCpartners aanroep nieuwe interface ('Action' => 'ControleerHCCLidmaatschap')
2013.07.05 Wijzigingen versie 28
- 8.1 MaakGebruikerAan
* extra parameters (mail, hccPseudoniem) in het antwoord
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra parameter (mailHccnet)
- A.1 ZoekHCCLid
* extra parameter (mailHccnet)
- A.3 ZoekGroeperingsLid
* extra parameter (mailHccnet)
2013.08.31 Wijzigingen versie 29
- F.1 / F.2 / F.3 HCC-kader / ControleerKaderlid
* extra output parameter (hccKaderMail)
- 1.1/1.2/1.3 GebruikerBestaatControle
* extra output parameter (hccForumLogin)
- H.1 HCC-groepering / GebruikerBestaatControle
* komma-gescheiden lijst met groeperingen mogelijk
* extra output parameter (mailHccnet)
2013.12.26 Wijzigingen versie 30
- 3.1 Geef mijn lidnummer
* nieuwe aanroep
- A.1 ZoekHCCLid
* geef nu ook 'ProfielBekend' terug om aan de PC30 omgeving door te geven
dat het wachtwoord niet veranderd mag worden door PC30
- A.6 GeefBezoekersOverzicht
* geef nu ook 'Locatie' terug indien van toepassing
- A.7 GeefLocaties
* nieuwe aanroep
- I.1 HCC-forum / GebruikerBestaatControle
* parameters aangepast
* authenticatie op basis van hccLogin + userPassword of lidnummer + hcc-code
* geen algemene hcc-forum authenticatie meer mogelijk
- F.7 ControleerKaderlidGroep
* Nieuwe aanroep
2014.02.01 Wijzigingen versie 31
- A.8 RegistreerGast
* nieuwe aanroep
- H.2 MatchPostcodeMetRegio
* nieuwe aanroep
- nieuwe interface (losse, unieke aanroepen, niet meer gegroepeerd)
2014.09.27 Wijzigingen versie 32
- C.1 GeefOpgezegdeLeden hernoemd naar GeefUitgeschrevenLeden
- I.3 GeefhccEindDatum
* nieuwe aanroep
- Action=7 en Action=8 toegevoegd aan de HenZ interface
2014.12.12 Wijzigingen versie 33
- F.1 / F.2 / F.3 HCC-kader / IsKaderLid
* extra output parameter (mail, mailHccnet, hccKaderForward)
- F.8 HCC-kader / ZetKaderForward
* nieuwe aanroep
2015.05.06 Wijzigingen versie 34
- GeefMijnGegevens
* nieuwe aanroep
- ValideerPCActiveAbonnee
* vervallen
- 1.4 GebruikerBestaatControle
* extra output parameter (hccKaderForward)
- D.1 HCCpartner/ControleerHCCLidmaatschap
* optionele extra output parameter (ExtraInfo)
2015.09.27 Wijzigingen versie 35
- HeeftForumCredentials
* vervallen
2015.11.20 Wijzigingen versie 36
- SchrijfNietlidInOpBulletin
* nieuwe aanroep
2015.12.13 Wijzigingen versie 37
- serverID als optionele parameter
- SchrijfNietlidInOpBulletin
* Maak velden optioneel
2016.01.05 Wijzigingen versie 38
- A.7 GeefLocaties
* optionele parameter JoomlaFilter
- F.4 GeefAlleGroeperingen
* optionele parameter JoomlaFilter
- F.5 GeefAlleKaderRollen
* optionele parameter JoomlaFilter
2016.01.15 Wijzigingen versie 39
- H.3 GeefMijnGegevens
* geeft nu ook hccOptIn terug
* geeft nu ook JoomlaToken terug
- H.4 PasOptInKeuzeAan
* nieuwe aanroep
- SiteID en RemoteID als optionele parameter
2016.03.17 Wijzigingen versie 40
- H.5 ZoekKaderLeden
* nieuwe aanroep
2016.03.20 Wijzigingen versie 41
- ServerID, SiteID en RemoteID als optionele parameters bij alle aanroepen
- A.7 GeefLocaties
* optionele parameter KadernetFilter
- A.9 GeefLocatieNamen
* optionele parameter KadernetFilter
- F.4 GeefAlleGroeperingen
* optionele parameter KadernetFilter
- F.5 GeefAlleKaderRollen
* optionele parameter KadernetFilter
- F.6 WijzigHccRol
* vervallen
- F.7 IsGroeperingsKaderlid
* vervallen
- 8.3 IsDezePseudoniemNogBeschikbaar
* vervallen
- 2.7 SchrijfOptInKeuzen
* vervallen
- 2.5 WijzigGebruikersGegevens (hccPseudoniem)
* vervallen
- H.2 MatchPostcodeMetRegio
* vervallen
2016.04.02 Wijzigingen versie 42
- H.6 GeefMijnKaderDetails
* nieuwe aanroep
2016.07.03 Wijzigingen versie 43
- Ubuntu 16.04 aanpassingen (PHP versie 7) beschreven
2016.09.01 Wijzigingen versie 44
- H.5 ZoekKaderLeden
* extra parameter 'hccMobiel'
2016.10.13 Wijzigingen versie 45
- H.3 GeefMijnGegevens (dedecated Joomla aanroep)
* hccForumLogin weg als parameter
* Als het om een webmaster gaat, vul dan eventueel hccRegio of hccIG aan
met die groepering, ook als hij geen lid is van die groepering
- I.4 GebruikerBestaatControle
* hccForumLogin weg als parameter
2016.12.01 Wijzigingen versie 46
- 8.3 IsDezePseudoniemNogBeschikbaar teruggezet
2017.05.28 Wijzigingen versie 47
- H.7 GeefMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
- H.8 ZetMinimaleKaderGegevens (t.b.v. eenmalige kadermailing)
2017.09.01 Wijzigingen versie 48
- A.10 SchrijfNietlidInOpBulletin nu alleen voor 1 bulletin tegelijk
- 2.2 WijzigGebruikersGegevens (op basis van gebruikersnaam en wachtwoord)
is vervallen (was een oude Drupal aanroep)
- A.3 ZoekGroeperingsLid geeft ook hccKaderToonMobiel terug
- H.7 GeefMinimaleKaderGegevens geeft ook hccKaderToonMobiel terug
2017.11.14 Wijzigingen versie 49
- A.3 ZoekGroeperingsLid geeft geen hccKaderToonMobiel meer terug
- A.3 ZoekGroeperingsLid geeft alleen hccMobiel als hccKaderToonMobiel dat toestaat
2018.02.18 Wijzigingen versie 50
- H.6 GeefMijnKaderDetails geeft ook hccKaderToonMobiel terug
- H.9 PasKaderGegevensAan
* nieuwe aanroep
- H.3 GeefMijnGegevens geeft 3 extra parameters terug (hccKaderMail, hccKaderForward,
hccKaderToonMobiel)
- JoomlaTokens worden gevalideerd op siteID, niet langer op serverID
- diverse aanroepen kunnen nu ook via de bezoekersregistratie-proxy aangeroepen worden.
Dan zullen ze hccLidnr en JoomlaToken als extra parameter moeten hebben:
(GeefAlleGroeperingen, GeefAlleKaderRollen, GeefLocaties, GeefLocatieNamen)
De bezoekersregistratie aanroepen hebben enkel JoomlaToken als extra parameter nodig:
(LidBezoektBijeenkomst, GeefBezoekersOverzicht)
2018.02.26 Wijzigingen versie 51
- H.3 GeefMijnGegevens geeft extra parameter hccMobiel terug
- H.9 PasKaderGegevensAan kan nu ook kadermail password aanpassen
- K.1 ValideerToken
* nieuwe aanroep
- K.2 ValideerHCCCode
* nieuwe aanroep
2018.03.17 Wijzigingen versie 52
- H.3 Haal al mijn gegevens
Extra optie 'compact' om alleen essentiele resultaten te verkrijgen
(t.b.v. de Android bezoekersregistratie applicatie)
2018.03.25 Wijzigingen versie 53
- I.2 IsHCCLid
(Oude aanroep teruggezet, wordt nog in vraagbaak module gebruikt)
2018.07.01 Wijzigingen versie 54
* A.1 beheer authenticatie op basis van lidnummer + hccCode (tbv VZ-portal)
* A.2 HaalPC30Token weggehaald
2018.08.22 Wijzigingen versie 55
* 1.2 GebruikerBestaatControle' (op basis van hccLogin en userPassword) weggehaald
* 1.4 GebruikerBestaatControle' (op basis van zoekHccLogin of zoekHccLidnr) weggehaald
* 2.8 HaalOptInLijst weggehaald
* E.1 PasKaderWachtwoordAan weggehaald
* F.1 IsKaderLid (op basis van hccLidnr en hccCode) weggehaald
* F.3 IsKaderLid (op basis van beheerdernaam en beheerderwachtwoord) was al weg
* F.8 ZetKaderForward weggehaald
* H.1 IsGroeperingsLid weggehaald
* H.6 GeefMijnKaderDetails weggehaald
* H.7 GeefMinimaleKaderGegevens weggehaald
* H.8 ZetMinimaleKaderGegevens weggehaald
* K.1 ValideerHCCCode weggehaald
* K.2 ValideerToken weggehaald
* H.3 GeefMijnGegevens geeft omvang kader mailbox mee terug
2018.11.06 Wijzigingen versie 56
Nieuwe aanroepen t.b.v. forum en vraagbaak autorisaties
* L.1 MaakOnderwerp
* L.2 VerwijderOnderwerp
* L.3 GeefOnderwerpen
* L.4 MuteerOnderwerp
* L.5 MuteerOnderwerpAutorisatie
* L.6 ToonOnderwerpAutorisatie
* H.5 ZoekKaderLeden heeft compact optie
2018.11.16 Wijzigingen versie 57
* L.5 MuteerOnderwerpAutorisatie kent nu ook RED(acteur)
2018.12.17 Wijzigingen versie 58
* A.11 GeefBezoekersAantallen (nieuwe aanroep)
* H.10 PasUserWachtwoordAan (nieuwe aanroep)
2019.02.21 Wijzigingen versie 59
* A. 6 GeefBezoekersOverzicht geeft enkel lijst van bezoekers laatste bijeenkomst
2019.10.26 Wijzigingen versie 60
* A.4 Schrijf bezoekers niet meer automatisch in op bulletins
* H.4 PasOptInKeuzeAan kan ook door LA aangeroepen worden
Nieuwe aanroepen t.b.v. eigen implementatie van mijn.hcc.nl in de Joomla modules
* H.11 PasPseudoniemAan
* H.12 ValideerWachtwoordEisen
* H.13 PasWachtwoordAan (1: op JoomlaToken, 2: op PWResetToken)
* H.14 MaakPWResetToken
* H.15 ValideerPWResetToken
* H.16 RuimJoomlaTokenOp
* A.12 GeefAlleBulletins
* A.13 ExpandeerPostcode
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.18 NormaliseerTelefoon
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
* A.21 HaalIGBedragenOp
* A.22 HaalTariefGroepenOp
* A.23 PasInteressegroepAan
* F.10 MuteerGroeperingSamenstelling
* A.24 GeefSSOUrls
Aanpassingen gemaakt aan
8.1 MaakGebruikerAan
F.5 GeefAlleKaderRollen
2020.01.04 Wijzigingen versie 61
Nieuwe aanroepen t.b.v. IDEAL betaling hobbynet abonnees
H.17 GeefAantalDomeinen
2020.01.06 Wijzigingen versie 62
Nieuwe aanroepen t.b.v. Cayentis (CRM webproxy) implementatie
* M.1 Upload_CSV_bestand
* M.2 SchrijfNieuwLidIn
* M.3 Verwerk_JSON_mutatie
* M.4 ISO_landcode
* M.5 MuteerAanmeldingsformulier
* M.6 HaalAanmeldingsformulier
* M.7 GeefFactuurOverzicht
* M.8 HaalFactuur
* A.25 UpdateNAW
Vervallen aanroepen
* A.14 UpdateContactGegevens
* A.15 UpdateContactEmail
* A.16 UpdateVoornaam
* A.17 UpdateVoorletters
* A.19 UpdateTelefoon
* A.20 UpdateMobiel
Aangepaste aanroepen
* A.23 PasInteressegroepAan
2020.03.27 Wijzigingen versie 63
Nieuwe aanroepen t.b.v. Joomla module aanpassingen
* H.18 ResetHCCCode
* H.19 PasHccLoginAan
</pre>

= Aanpassingen aan de Apache omgeving =

== php.ini aanpassingen ==
De XML-RPC server zal 'ergens' een bestand moeten kunnen vinden met de
gebruikersnamen t.b.v. het authenticeren bij de LDAP-server.

Dit bestand wordt geplaatst in de map '/usr/local/hobbynet/etc'. Om dit
vanuit Apache te mogen benaderen, dient een aanpassing aan php.ini
gemaakt te worden:

/etc/php5/apache2/php.ini

include_path = ".:/usr/share/php:/usr/share/pear:/usr/local/hobbynet/etc"

== Apache modules ==
Nieuwe server geschikt maken voor XML-RPC gebruik

=== Apache modules (PHP 7) ===
Ubuntu 16.04 wordt standaard met PHP versie 7.0 uitgeleverd.
De opdrachten om de modules op te halen zijn:
apt-get install php-xmlrpc
apt-get install apache2
apt-get install ldap-utils
apt-get install php-ldap
apt-get install libapache2-mod-php

== Loadbalancer akties niet naar de logbestanden schrijven ==
De loadbalancer haalt zeer frequent een testbestand op (/test.txt), om
te controleren of de xml-server operationeel is. Dat levert extreem veel
logging op in /var/log/apache2/other_vhosts.log.

Pas de apache configuratie zo aan, dat logging van alle opvragingen
vanaf de loadbalancers uitgezet wordt.
/etc/apache2/sites-enabled/xml-server

# Mark requests from loadbalancers
SetEnvIf Remote_Addr "212\.72\.227\.93" dontlog
SetEnvIf Remote_Addr "212\.72\.227\.94" dontlog
SetEnvIf Remote_Addr "172\.31\.1\.249" dontlog
SetEnvIf Remote_Addr "172\.31\.1\.250" dontlog
CustomLog ${APACHE_LOG_DIR}/access.log common env=!dontlog

= Firewall algemeen =
In de file /etc/hobby-firewall/hobby-firewall.local wordt het script
'/usr/local/hobbynet/bin/gen_fw.sh' aangeroepen.
Deze haalt de IP adressen op uit ldap.
(.local omdat we dit ook zo doen op de webservers).

De firewall wordt 4 x per dag herstart en /etc/hobby-firewall wordt
gesynchroniseerd (1-richting van lb1 naar lb2) met de volgende crontab
entries:

Op lb1:
0 0 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 5 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 11 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 17 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null
0 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
55 23 * * * /usr/local/hobbynet/bin/sync_hobbynetfw.sh >/dev/null

Op lb2:
15 6 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 12 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 18 * * * /etc/init.d/hobby-firewall restart >/dev/null
15 0 * * * /etc/init.d/hobby-firewall restart >/dev/null

Het encrypted backup script is verplaatst naar '/usr/local/hobbynet/local' en hernoemd naar 'backup-encrypted.bash'.
Dit is omdat deze niet mee mag worden gesynchroniseerd.

Tevens wordt 1x per dag /usr/local/hobbynet/bin gesynchroniseerd (1-richting van hcc-ldap-lb1 naar hcc-ldap-lb2)

== Aanpassingen in de firewall ==
Op de server waar de XML-RPC server staat, moeten enkele firewall aanpassingen gemaakt worden.
* inkomend: sta TCP 443 toe vanaf het interne netwerk (www-prod, www-test), en vanaf eventuele andere plekken die we expliciet toe willen staan.
* inkomend: sta TCP 443 toe vanaf mijn.hcc.nl (XML-RPC aanroepen vanaf de portal)
* inkomend: sta TCP 443 toe vanaf service.hccnet.nl toe (XML-RPC aanroep GeefUitgeschrevenLeden vanuit HenZ)
* uitgaand: sta TCP 443 naar service.hccnet.nl toe (XML-RPC aanroepen naar HenZ)
* uitgaand: sta TCP 990 en 5000-6000 naar Apps.HCC.local (FTPS verkeer naar de HCC server bij Hobbynet)

== Aanpassingen aan AppArmor ==
Alhoewel technisch gezien dit bij slapd behoort, neem ik het toch hier op.

Als het Hobbynet certificaat in de map /disk/site/etc/ssl/hobby.nl/ wordt neergezet, dan zal apparrmor de toegang tot de certificaten blokkeren. Neem daarom in de '''local''' directory van apparmor het volgende op:
# /etc/apparmor.d/local/usr.sbin.slapd
# Site-specific additions and overrides for usr.sbin.slapd.
# For more details, please see /etc/apparmor.d/local/README.
#include <abstractions/ssl_certs>
/disk/site/etc/ssl/hobby.nl/ r,
/disk/site/etc/ssl/hobby.nl/* r,

Sftp

2019-12-23T15:36:09Z

Hans:

=doel=
Met sftp worden op veilige manier vertrouwelijke bestanden aangeleverd aan kantoor en tripolis.

== Tripolis ==
Het IP adres voor de sftp verbinding van Tripolis is 185.211.248.216

Let op: hier is static route voor op sftp-int (in /etc/netplan/01-netcfg.yaml):

network:
version: 2
ethernets:
ens160:
dhcp6: no
accept-ra: no
addresses:
- 212.72.224.13/24
- 2a02:968:1:2:212:72:224:13/64
nameservers:
search:
- hobby.nl
routes:
- to: 185.211.248.216
via: 212.72.224.1
optional: true

Het Tripolis IP adres is ook in Hobby-firewall vrijgeschakeld
# ssh vanaf tripolis
# nieuw ip OTRS Ticket#2019120994000045
$IPTABLES -A INPUT -p tcp -s 185.211.248.216 --dport 22 -j ACCEPT

Denk er aan het Tripolis IP adres ook in de fail2ban omgeving te whitelisten!
/etc/fail2ban/jail.conf:ignoreip = 127.0.0.1/8 212.72.224.18 212.72.229.18 212.72.224.5 212.72.224.34 185.211.248.216
/etc/fail2ban/jail.local:ignoreip = 127.0.0.1/8 212.72.224.18 212.72.229.18 212.72.224.5 212.72.224.34 185.211.248.216

Ook de firewall in de Hobbynet router zal voor dit Tripolis IP adres opengezet moeten worden (IP adreslijst 'ssh access sftp')

MediaWikiSites

2019-11-10T09:48:12Z

Hans:

== Lijst met Mediawiki sites die wij bijhouden ==

* Hobbynet wiki (https://wiki.hobby.nl/)

''2018.09.23 De kadernet wiki is in rook opgegaan''
* kadersite wiki (https://kadernet.hcc.nl/apps/wiki)

''2017.11.17 Oude meuk, zal waarschijnlijk niet meer bestaan:''
* Gamesbestuur wiki (https://bestuur.hcc-games.nl)

== upgrade procedure ==
* maak met tar een backup van de wiki: 
cd /disk/site/wiki
tar -cf wiki-backup-20191110.tar www
bzip2 wiki-backup-20191110.tar

* maak met phpmyadmin een backup van de database 

* download de wiki software upgrade van http://www.mediawiki.org/ 

* volg de instructies zoals beschreven op http://www.mediawiki.org/wiki/Manual:Upgrading 

=== Hobbynet wiki updaten ===
* Volg de instructies om de wiki te updaten
Ons eigen lijstje:

cd /disk/site/wiki
rm -rf www-old
cp -a www www-old
wget https://releases.wikimedia.org/mediawiki/1.33/mediawiki-1.33.1.tar.gz
tar xzf mediawiki-1.33.1.tar.gz
chown www-hobby-nl:www-hobby-nl mediawiki-1.33.1 -R
cp -a hobby-adm-old/LocalSettings.php mediawiki-1.33.1
cp -a hobby-adm-old/images/* mediawiki-1.33.1/images
cp -a hobby-adm-old/getip* mediawiki-1.33.1
rm -rf www
mv mediawiki-1.33.1 www
cd www/maintenance
php update.php

* Als update.php niet draait, omdat er geen sql modules beschikbaar zouden zijn, selecteer dan eerst de juiste php versie
update-alternatives --config php

* Op de hobbynet wiki staan 2 losse bestanden die geen directe relatie met de wiki software hebben ('''getip.html''' en '''getip.php'''). 
Plaats die bestanden terug, tijdens de wiki upgrade actie!

=== Kadernet wiki updaten (oude meuk) ===
Ons eigen lijstje:

rm -rf wiki-old
cp -a wiki wiki-old
wget https://releases.wikimedia.org/mediawiki/1.29/mediawiki-1.29.2.tar.gz
tar xzf mediawiki-1.29.2.tar.gz
chown kader-file:kader-file mediawiki-1.29.2 -R
cp -a wiki-old/LocalSettings.php mediawiki-1.29.2
cp -a wiki-old/images/* mediawiki-1.29.2/images
rm -rf wiki
mv mediawiki-1.29.2 wiki
cd wiki/maintenance
php update.php

* als na de update de wiki niet wil starten, zet dan als eerste het ownership van de bestanden:
chown www-hobby-nl:www-hobby-nl /disk/site/hobbynet/www/hobby-adm -R

Main Page

2019-11-10T09:47:56Z

Hans:

===Informatie tbv beheer bit===
[[CRM_omgeving]] - de crm omgeving

===Hobbynet Admin WIKI===
Shortcuts
[http://otrs.hobby.nl/ HobbyNet Ticket systeem] - OTRS
[https://nagios.hobby.nl/nagios Nagios monitoring] -[[Nagios|''' Uitleg''']]
[https://wiki.hobby.nl/getip.html Waar draait een website] - simpel tooltje om te kijken waar een website draait.

===Algemene informatie===
[[HCC!Hobbynet]] - Wat is Hobbynet - een uitleg voor kantoor (zie ook discussie tab)
[[HCC!verenigingsdag]] - Een draaiboek voor de HCC!verenigingsdag
[[Evenementen lan]] - Een draaiboek voor een Evenementen LAN
[[Kadernet]] - Info over Kadernet voorzieningen (website, forum, etc.)
[[Financien]] - Financiële aspecten van Hobbynet
[[inventaris]] - Hobbynet inventaris overzicht t.b.v. hcc kantoor
[[Windows_licenties]] - Hobbynet overzicht van de windows licenties
[[Beheerders]] - Hobbynet beheerders
[[server_certs]] - Hobbynet CAcert certificaten
[[Hobbykeys]] - Info over het hobbykeys script
[[accounts]] - Diverse account gegevens (o.a. knoppix.nl)

===HCC.NL website platform===
hcc.nl [[netwerk]] - Netwerk voor hcc.nl website platform
[[XML-RPC]] - XML-RPC interface t.b.v. LDAP
[[XML-HENZ-PROXY]] - XML-RPC HenZ proxy t.b.v. cronjob toegang tot HenZ
2017.02.02: Moet dringend bijgewerkt worden:
[[www-test-lb*]] - Test servers (loadbalanced)
[[www-prod-lb*]] - Productie servers (loadbalanced)
[[Protocol_onderhoud]] - Afspraken rondom onderhoud en meldingen aan hcc.nl webmasters

===Toegang===
[[Speciale VPN toegang]] - Speciale VPN toegang (verouderde info)
[[KVM over IP]] - Beheer op afstand m.b.v. KVM over IP apparatuur
[[Serial Console Server]] - Serial Console Server voor het beheer van netwerk aparatuur met seriele interface
[[beheerder_accounts]] - Beheerder accounts aanmaken / bijhouden
[[Aanmaken_Gebruiker]] - Aanmaken van een gebruiker
[[Opzeggen_Gebruiker]] - Opzeggen van een gebruiker

===Algemene services===
[[Backup]] - Zo backupen we
[[DNS]] - DNS instellingen t.b.v. de domeinen
[[ns-master]] - Direct naar ns master (draait op [[domein]])
[[ns1]] - Direct naar ns1.hobby.nl
[[ns2]] - Direct naar ns2.hobby.nl
[[ns3]] - Direct naar ns3.hobby.nl (bij TransIP)
[[Resolv*-int]] - Direct naar resolv nameserver pagina (draait op [[resolv-lb1]] en [[resolv-lb2]])
[[DNSSEC]] - DNSSec
[[DNSSEC ds records publiceren]] - Scripting t.b.v. het publiceren van DNSSEC DS records. Dump van scripts... zinloos
[[DNS scripting]] - Overige DNS scripting
[[DNS Zone updaten]] - een zone updaten
[[scp]] - Hobbynet filetransfer omgeving
[[Scp-lb1]] - Direct naar scp-lb1.hobby.nl
[[Scp-lb2]] - Direct naar scp-lb2.hobby.nl
[[EMAIL]] (ook postfixadmin) - Email server documentatie
[[Roundcube Webmail]] - Upgrading Roundcube
[[LDAP]] (server en client) - LDAP setup
[[LDAP login Authenticatie]] - Om op (web)servers login via LDAP te doen
[[LDAP scripting]] - Scripting die op ldap-lb1 draait
[[LDAP Administrative account]] weg! - Hoe te handelen als hetadministrative account opeens weg is
[[SFTP server]] - sftp server voor uitwisseling met kantoor en tripolis
[[Speciale groepen in ldap en CRM]] - Speciale groepen in ldap en CRM
[[PXE]] - Hobbynet PXE omgeving
[[Storage cluster]] - Beschrijving van het storage cluster
[[MySQL cluster]] - Beschrijving van het MySQL cluster
[[MySQL settings]] - MySQL instellingen
[[Web cluster]] - Beschrijving van het Web cluster
[[Loadbalancers]] - Beschrijving van de LoadbalancerNG
[[Nagios]] - Beschrijving van Nagios
[[Nagios_upgrade]] - Hoe upgrade ik nagios van uit source
[[Hobbynet repository]] - Informatie over de hobbynet repository
[[Hobbynet repository inhoud]] - Wat zit er in de hobbynet repository
[[Cron jobs]] - Niet standaard cronjobs die lopen bij hobbynet
[[Fail2ban]] - Block possible intruders and bots
[[HCCforums]] - Informatie over HCC!forums
[[Joomla_xml_server]] - De XML-RPC-server t.b.v. de Joomla template sites
[[Groepering_hernoemen]] - Beschrijving van het hernoemen van een groeperingsnaam
[[Joomla modules]] - Beschrijving van Joomla modules en processen er om heen
[[killdisk]] - Software voor secure wissen van disken

===Uitleg IP space===
[[netwerk]] - Netwerk tekening van Hobbynet
[[IPv4_space|IPv4]] - IPv4 Hobbynet
[[Ipv6_space|IPv6]] - IPv6 Hobbynet

===Kast indeling===
[[kasten]] - Indeling kasten bij BIT ''(pagina heeft onderhoud nodig)''
[[systems]] - Alle systemen van Hobbynet (hardware & netwerk)
[[Powerboot]] - Indeling APC PDU's (feb. 2013)

===Tuning webservers===
[[Hobby-firewall]] - de Hobbynet firewall
[[PHP via fcgi]] - PHP via fcgi en suexec
[[suhosin]] - Suhosin (hardened PHP) op Apache webservers
[[upg_web]] - Door middel van script server upgraden
[[Aanpassingen hcc.nl webservers|hcc.nl aanpassingen]] - aanpassingen, gedaan voor hcc.nl op www-test-lb* www-prod-lb*

[[NFS_settings]] - NFS poort instellingen t.b.v. iptables firewall
[[sync Loadbalanced webservers]] - dit script zorgt dat webserver configs worden gesynct
[[Entropy]] - Hoe zorg ik voor meer Entropy op vmware machine

===VPS voor derden===
[[Ubuntu-nl]] - De Ubuntu-nl virtuele server

=== Hobbynet informatie ===
[[Scripting]] - Een poging om de scripting te beschrijven. WIP!
[[agreements]] - Alle Hobbynet contracten met contract beheerder e.d.
[[ToDo]] - Een wensenlijstje van dingen die we kunnen veranderen/verbeteren
[[Systemlog]] - Log file van relevante wijzigingen aan diverse servers

===Updaten===
[[Joomlasites]] - Joomla sites die wij bijhouden
[[MediaWikiSites]] - MediaWiki sites die wij bijhouden

===Nieuwe server===
[[JoomlaKloonMaken| Joomla Clone maken ]] - Stappen om een Joomla Clone aan te maken

===Nood gegevens===
[[Medische protocol Bas|Medisch protocol bas]] - Medisch protocol bas

Dit is een "mediawiki" (http://www.mediawiki.org/). 
Uitleg over het editen is te vinden op: 
http://meta.wikimedia.org/wiki/MediaWiki_User%27s_Guide 
http://en.wikipedia.org/wiki/Wikipedia:How_does_one_edit_a_page

Inventaris

2019-11-01T16:00:22Z

Hans:

Inventaris

2019-11-01T15:36:13Z

Hans: /* Inventaris overzicht. */

== Inventaris overzicht. ==

In dit overzicht behoort tenminste alle apparatuur voor te komen, die maximaal 3 jaar oud is.

De gegevens van deze pagina kunnen gebruikt worden als basis van het jaarlijks in te vullen hardware inventarisatie formulier, zoals dat door de penningmeester ieder jaar aan het hcc kantoor ter hand gesteld dient te worden.

{| border="1" cellpadding="2"
! datum aankoop || artikelomschrijving || serienummer || aankoopprijs || leverancier || verblijfplaats || bruikleenovereenkomst

|-

|30 oktober 2019

|''cisco-sw-01'' 
SG350X-48 48-Port Gigabit Stackable Managed Switch

|DNI2228066K
Factuur: [[Media:f-cisco-switch-2019-10-30.pdf]]

| € 362,81 ex BTW

| Azerty

|Bit, Ede

|n.v.t.

|-

|30 oktober 2019

|''cisco-sw-02'' 
SG350X-48 48-Port Gigabit Stackable Managed Switch

|DNI22280660
Factuur: [[Media:f-cisco-switch-2019-10-30.pdf]]

| € 362,81 ex BTW

| Azerty

|Bit, Ede

|n.v.t.
|-

|3 juli 2018

|''rt-01'' 
MikroTik CCR1016-12S-1S+ router

|6EFD087C1C40
Factuur: [[Media:Mikrotik-CCR1016-12S-1S-router-1.pdf]]

| € 643,80 ex BTW

| KommaGo

|Bit, Ede

|n.v.t.

|-


|10 juli 2018

|''rt-02'' 
MikroTik CCR1016-12S-1S+ router

|6EFD08521BE4
Factuur: [[media:Mikrotik-CCR1016-12S-1S-router-2.pdf]]

| € 643,80 ex BTW

| KommaGo

|Bit, Ede

|n.v.t.

|-


|juni 2013

|''KVM'' 
* KV1416A-R2 
* Blackbox 16 ports KVM 
* [[Media:f-kvm2013.pdf]]

|13022015224 
[[Media:foto-srnr-kvm.jpg]]

| € 1.987 ex BTW

|Blackbox

|Bit, Ede

|n.v.t.

|-


| 22 november 2017

| ''LB1'' 
* PRIMERGY RX1330 M3 
* 1x 8GB DDR4-2400 U ECC 
* Intel(R) Core(TM) i3-7100 CPU @ 3.90GHz 
* 60GB SATAdom 
* 2 x Gbit I210 Gigabit Network interface onboard 
* 4 x Gbit I350 Gigabit Network interface 

|
* Product serienummer : YMDH003824 
* Factuur: [[Media:lb-1-2-bit.pdf]] 

| € 1.396,26 ex BTW

| BIT

| Bit, Ede

| n.v.t.

|-


| 22 november 2017

| ''LB2'' 
* PRIMERGY RX1330 M3 
* 1x 8GB DDR4-2400 U ECC 
* Intel(R) Core(TM) i3-7100 CPU @ 3.90GHz 
* 60GB SATAdom 
* 2 x Gbit I210 Gigabit Network interface onboard 
* 4 x Gbit I350 Gigabit Network interface 

|
* Product serienummer : YMDH003825 
* Factuur: [[Media:lb-1-2-bit.pdf]] 

| € 1.396,26 ex BTW

| BIT

| Bit, Ede

| n.v.t.

|-


| 15 Augustus 2017

| ''vmware1'' 
* Fujitsu Primergy RX2530 M2 
* 4x 32GB DDR4-2400 U ECC (uitbreidbaar naar 12 per socket, upgradebaar naar 64GB per bank) 
* 4 x 900 GB SSD (raid 5) 
* Intel Xeon e5-2620 v4 @ 2.10GHz 8 cores 16 logical procesors 
* 4x1Gb T OC|14000-LOM netwerk interface 
* ILOm

|
* Product serienummer : YM6B011958 
* 3 jaar onsite garantie via BIT binnen 8 uur recovery
* Factuur: [[Media:f-bit-vmwar123.pdf]] 

| € 6.996,21 ex BTW

| Bit, Ede

| Bit, Ede

| n.v.t.

|-


| 15 Augustus 2017

| ''vmware2'' 
* Fujitsu Primergy RX2530 M2 
* 4x 32GB DDR4-2400 U ECC (uitbreidbaar naar 12 per socket, upgradebaar naar 64GB per bank) 
* 4 x 900 GB SSD (raid 5) 
* Intel Xeon e5-2620 v4 @ 2.10GHz 8 cores 16 logical procesors 
* 4x1Gb T OC|14000-LOM netwerk interface 
* ILOm

|
* Product serienummer : YM6B011957 
* 3 jaar onsite garantie via BIT binnen 8 uur recovery
* Factuur: [[Media:f-bit-vmwar123.pdf]] 

| € 6.996,21 ex BTW

| Bit, Ede

| Bit, Ede

| n.v.t.

|-


| 15 Augustus 2017

| ''vmware3'' 
* Fujitsu Primergy RX2530 M2 
* 4x 32GB DDR4-2400 U ECC (uitbreidbaar naar 12 per socket, upgradebaar naar 64GB per bank) 
* 4 x 900 GB SSD (raid 5) 
* Intel Xeon e5-2620 v4 @ 2.10GHz 8 cores 16 logical procesors 
* 4x1Gb T OC|14000-LOM netwerk interface 
* ILOm

|
* Product serienummer : YM6B011956 
* 3 jaar onsite garantie via BIT binnen 8 uur recovery
* Factuur: [[Media:f-bit-vmwar123.pdf]] 

| € 6.996,21 ex BTW

| Bit, Ede

| Bit, Ede

| n.v.t.

|-


| juli 2018

| ''logging'' 
* Fujitsu (type onbekend) 
* 1x 8GB DDR4-2400 U ECC 
* Intel(R) Xeon(R) CPU X3430 @ 2.40GHz 
* 466GB disk 

|

| € 0 ex BTW (gift)

| BIT

| Bit, Ede

| n.v.t.

|-


| 14 februari 2013

| ''Powerboot-1'' 
APC AP8959EU3 
* 24 schakelbare 230V poorten 

| ZA1238010076

| € 755 ex BTW

| Acesdirect

| Bit, Ede

| n.v.t.

|-


| 14 februari 2013

| ''Powerboot-2'' 
APC AP8959EU3 
* 24 schakelbare 230V poorten 

| ZA1238010081

| € 755 ex BTW

| Acesdirect

| Bit, Ede

| n.v.t.
|-
|}

== Afgeschreven apparatuur, niet meer in het rack, niet meer in gebruik ==

{| border="1" cellpadding="2"
! datum aankoop || artikelomschrijving || serienummer || aankoopprijs || leverancier || verblijfplaats || bruikleenovereenkomst

|-

| 15 november 2012

| ''SW-01'' 
HP 5120-24G SI SWITCH

|
* Product serienummer : CN13BZ00YZ 
* Hardware productnummer : JE074A 
* HP Carepaq nr: GEEN (lifetime next day garantie HP) 
* Factuur: [[Media:2012-hp-switches.pdf]] 

| € 700 ex BTW

| Infotheek

| Bit, Ede

| n.v.t.

|-


| 15 november 2012

| ''SW-02'' 
HP 5120-24G SI SWITCH

|
* Product serienummer : CN13BZ00F6 
* Hardware productnummer : JE074A 
* HP Carepaq nr: GEEN (lifetime next day garantie HP) 
* Factuur: [[Media:2012-hp-switches.pdf]] 

| € 700 ex BTW

| Infotheek

| Bit, Ede

| n.v.t.

|-

|-