Ga naar inhoud

Werkinstructie MachForm beheer

Uitgangspunten

Binnen de IT Suite voor non profits is voor MachForm gekozen als WYSIWYG formulieren editor. MachForm kan geheel naar eigen inzicht worden ingericht (met o.a. workflows etc.) maar vereist als onderdeel van de suite 3 basis formulieren (welke niet zonder impact op Club.Redders kunnen worden aangepast;

  • Inschrijfformulier
  • Doorlopende machtiging SEPA
  • Uitschrijfformulier

Optioneel geld dit ook voor het "Administratie formulier YYYY" indien de declaratie module wordt gebruikt.

In dit document is uitgegaan van het volgende;

  • De Office 365 omgeving is ingericht volgens de werkinstructie Office 365 beheer.
  • MachForm is geïnstalleerd en up to date.
  • Het SASL adres uit O365 is vereist voor het verzenden van E-mail berichten vanuit MachForm (noreply@mydomain.org).
  • De vereiste formulieren zijn geconfigureerd volgens dit document.
  • Binnen Office 365 zijn de applicatie groepen aangemaakt volgens dit document.
    • In tegenstelling tot de werkinstructie Office 365 beheer worden voor externe applicaties wél andere groepen aangemaakt dan z.g.n. Office 365 groepen, namelijk security groups. Deze worden aangemaakt vanuit;
      • Het beheercentrum – groepen;
        • Met een naam volgens de volgende naamconventie;
          • App_ als indicatie voor externe rechten groepen.
          • <NaamApplicatie>_ naam van de externe applicatie.
          • <NaamApplicatieRol>_ naam van de rol in de applicatie.
        • Bijvoorbeeld: App_MachForm_Administrator voor de applicatie MachForm en de rol Administrator in die applicatie.
        • Als beschrijving kan worden gekozen om de officiële beschrijving van de rechtengroep toe te voegen uit de documentatie van de betreffende applicatie.
      • Na het aanmaken van de groep kan deze worden voorzien van eigenaren en leden. Zoals gesteld in de werkinstructie Office 365 beheer zijn Verder zijn de eigenaren van de Office 365 groepen zelf verantwoordelijk voor het op en afvoeren van gewijzigde (actieve) leden.
        • Voor de App_ groepen wordt het beheer vooralsnog uitgevoerd door de IT functionarissen. Zij worden tot op heden ingesteld als eigenaar.
        • De leden worden toegevoegd en verwijderd op verzoek van het bestuur. Zie hiervoor ook de standaard toekenning onder gebruikersbeheer.

Gebruikersbeheer

Dit document houd de termen aan zoals gebruikt in de werkinstructie Office 365 beheer.

De volgende situaties zijn mogelijk bij het beheer van gebruikers;

  • Instroom / nieuw lid.
    • Na het aanmaken van een account in O365 kan een lid hiermee inloggen in WordPress. Het account wordt daar automatisch aangemaakt vanuit O365. Standaard krijgt een lid daar de rol subscriber. Hiervoor hoeft de gebruiker niet in de groep App_WordPress_Subscriber te zitten,
  • Doorstroom / lid krijgt, wijzigt of stopt met actieve functie.
    • Lid krijgt actieve functie. Het lid wordt toegevoegd of verwijderd uit de gewenste App_ groep(en). Standaard wordt hiervoor nu gehanteerd;
      • IT: App_MachForm_Administrator
      • X: App_MachForm_Administrator
      • Y: App_MachForm_User
      • Z: App_MachForm_User

Deze wijzigingen worden niet standaard doorgevoerd in WordPress (niet gestest…). Log na de aanpassingen in O365 in op WordPress en _ of _ verwijder de betreffende gebruiker. Deze wordt bij de eerstvolgende aanmelding in WordPress opnieuw aangemaakt met de juiste rechten. _ Of _ zoek de gebruiker op en pas de rechtenwijzigingen ook door in WordPress zelf.

  • Uitstroom / lid meld zich af.
    • Na het disabelen of verwijderen van het account in O365 kan een lid zich niet meer aanmelden in WordPress. Het account blijft (niet getest) wel in WordPress bestaan met de laatst toegekende rechten. Het advies is alle subscriber accounts periodiek te verwijderen. Voor leden die nog toegang nodig hebben wordt dit account automatisch opnieuw aangemaakt zodra zij weer inloggen.

Attribute mapping vanuit Office 365.

De volgende attributen worden vanuit Office 365 overgenomen in MachForm;

  • Login gegevens;
    • DisplayName Name
    • UserPrincipalName Username/Email Address
  • Rollen
    • Alle rollen van de App_MachForm_ groepen waarvan de gebruiker lid is.

SSO with AAD (through Okta) configuratie

Algemeen

LDAP Server OpenLDAP, ApacheDS, etc.
LDAP Hostname mydomain-org.ldap.okta.com
LDAP Port 636
Encryption Method SSL (ldaps://)
Base DN ou=users,dc=mydomain-org,dc=okta,dc=com
Required Group(s)* ?
Use LDAP Exclusively [O] ß Make sure all settings are valid!
*) The groups, if any, that authenticating LDAP users must belong to.

MachForm role to Azure AD group map

WordPress Role O365 Group Name Azure AD Group Object ID

App_MachForm_Administrator ?

App_MachForm_User ?

Okta Configuration

Volg voor de configuratie van deze plugin aan de Okta zijde de handleiding:

https://github.com/psignoret/aad-sso-wordpress/blob/master/README.md

Azure Configuration

Volg voor de configuratie van deze plugin aan de Azure zijde de handleiding:

https://github.com/psignoret/aad-sso-wordpress/blob/master/README.md

NOOT: BIJ VIMEXX HOSTING: ACTIVEER DE OPTIE LDAP BIJ DE PHP MODULES.