Werkinstructie WordPress beheer¶

Uitgangspunten¶

Binnen de IT Suite voor non profits is voor WordPress gekozen als website/CMS. WordPress kan geheel naar eigen inzicht worden ingericht maar gebruikt als onderdeel van de suite 2 plugins;

• SSO with AAD (for WordPress) voor het opzetten van SSO vanuit Office 365.
• Club.Redders-WP voor het integreren van de Mijn omgeving uit Club.Redders in WordPress. Deze plugin is alleen nodig indien je niet alle eindgebruikers wilt doorverwijzen naar de tool.

In dit document is uitgegaan van het volgende;

• De Office 365 omgeving is ingericht volgens de werkinstructie Office 365 beheer.
• WordPress is geïnstalleerd en up to date.
• Beide plugins zijn geïnstalleerd en up to date.
• De SSO with AAD plugin is 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_WordPress_Administrator voor de applicatie WordPress 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.

• Het SASL adres uit O365 kan indien gewenst worden ingesteld voor het verzenden van E-mail berichten vanuit WordPress (noreply@mydomain.org).

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.
  • Standaard krijgt een lid geen rechten binnen WordPress.
• 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;
    • X: App_WordPress_Editor
    • Y: App_WordPress_Contributor
    • Z: App_WordPress_Contributor
    • IT: App_WordPress_Administrator

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 om de IT functionarissen te verzoeken een WordPress account dat niet meer nodig is te laten verwijderen. Indien een gebruiker content heeft toegevoegd/bewerkt dient het eigenaarschap hiervan toegekend te worden aan een andere gebruiker. Kies hierbij bij voor de voorzitter van dezelfde eenheid (werkgroep/commissie/bestuur). Indien niet mogelijk kies dan de secretaris. Indien dat ook niet mogelijk is, kies dan de voorzitter van het bestuur.

Attribute mapping vanuit Office 365.¶

De volgende attributen worden vanuit Office 365 overgenomen in WordPress;

• Login gegevens;
  • GivenName First Name
  • Surname Last Name
  • DisplayName Display name publicly as
  • UserPrincipalName Username/Nickname/Email
• Rollen
  • Alle rollen van de App_WordPress_ groepen waarvan de gebruiker lid is.

SSO with AAD (for WordPress) configuratie¶

Algemeen¶

WordPress role to Azure AD group map¶

Advanced¶

OpenID Connect configuration endpoint : https://login.microsoftonline.com/common/.well-known/openid-configuration

Configuratie in Azure¶

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

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

Club.Rescue-WP configuratie¶

Algemeen¶

Club.Rescue role to Azure AD group map¶

Advanced¶

Shortcodes¶

De actuele uitleg van de beschikbare shortcodes is beschikbaar op de configuratie pagina:

https://mydomain.org/wp-admin/options-general.php?page=cr-wp

De volgende shortcodes zijn (enkel) beschikbaar binnen de pagina's welke zijn toegevoegd onder de configuratie 'My Club.Rescue pages'; [crwp_mycr] geeft de standard submodule en dataset weer uit Mijn Club.Redders zoals geconfigureerd in de configuratie 'Default source' en 'Default variable'. Deze shortcode heeft drie attributen die kunnen worden gebruikt om de opgevraagde data te wijzigen:

[crwp_mycr otap="clubredders" source="mycr-attributes" table="lidTable"] otap bepaalt de folder van de Club.Redders installatie die gebruikt wordt. Handig om de installatie te White labelen of data uit een test installatie op te vragen. source bepaalt de Mijn C.R submodule die wordt ingevoegd. table bepaalt de dataset uit de submodule die teruggegeven wordt.