CMS: Overzicht verzamelingsmachtigingen

Machtigingen geven je controle over welke bezoekers toegang hebben tot en interactie hebben met de gegevens in je verzamelingen, en wat ze mogen doen.

Je website kan bijvoorbeeld een feedbackgedeelte hebben waar bezoekers opmerkingen kunnen plaatsen die je in een verzameling opslaat. Mogelijk wil je dat alle bezoekers nieuwe opmerkingen kunnen toevoegen, dat alle bezoekers opmerkingen mogen lezen en dat alleen de beheerder bestaande opmerkingen mag bijwerken of verwijderen.

Machtigingen worden per verzameling gedefinieerd. Je wijst machtigingen toe die bepalen welke gebruikersrollen welke acties kunnen uitvoeren. Zo kun je bijvoorbeeld creatie-machtigingen geven aan websiteleden voor je 'opmerkingen'-verzameling, maar alleen beheerders toestaan om items te creëren in je 'producten'-verzameling.

Let bij het kiezen van voorinstellingen voor verzamelingsmachtigingen goed op de standaardmachtigingen. 

Het model voor verzamelingsmachtigingen bevat een aantal voorinstellingen die automatisch de machtigingen instellen voor veelvoorkomende scenario's. De instelling Openbaar mag bijvoorbeeld alleen worden gebruikt voor niet-gevoelige informatie, zoals verzamelingen zonder gebruikersgegevens. Dit komt omdat de leesmachtiging van die verzameling wordt ingesteld op de Iedereen-rol en alle andere acties zijn beperkt tot alleen de Beheerder-rol:

Een ander voorbeeld is de Formulierinzending-voorinstelling, die de volgende machtigingen definieert:

Wanneer je de instelling Aangepast gebruikt, moet je ervoor zorgen dat de machtigingen die je toewijst, overeenkomen met de bedrijfslogica en de vertrouwelijkheidsclassificatie van de gegevens in de verzameling. Verzamelingen met details over klanten of zakelijke leads moeten bijvoorbeeld anders worden behandeld dan verzamelingen over producten.

Het is belangrijk op te merken dat, afhankelijk van de machtigingen die je toepast, informatie in een verzameling kan worden geopend of gewijzigd, ongeacht de siteflow. Je website kan bijvoorbeeld een verzendknop bevatten om nieuwe opmerkingen in te voegen in de verzameling opmerkingen. Als de verzameling echter zo is geconfigureerd dat iedereen de opmerkingen kan verwijderen, is het mogelijk om dit te doen via een directe gegevensoproep naar de verzameling, zelfs zonder een knop op de pagina.

De volgende machtigingen worden ondersteund.

Rollen worden automatisch toegewezen aan gebruikers op basis van hun activiteit en status op de website. Je kunt alleen aangepaste rollen bewerken of verwijderen die je zelf aanmaakt.

Momenteel worden aangepaste rollen niet ondersteund door het machtigingsmodel voor verzamelingen. Velo-gebruikers kunnen echter een aangepaste rol voor een verzameling implementeren door de verzamelingstoestemming in te stellen op ''Beheerder'' en code te gebruiken om een gegevensoproep te doen vanaf de backend met de suppressAuth-optie. De gegevensoproep moet worden gedaan nadat de aangepaste lidmaatschapsrol is gevalideerd met de wix-users API-functionaliteit in de code.

De Beheerder behoudt altijd machtigingen voor alle acties.

De rol Websitelid auteur verschilt van de andere rollen doordat deze van toepassing is op specifieke items in een verzameling in plaats van op de hele website. De Websitelid auteur is een Sitelid die een specifiek item heeft gemaakt en daarom extra machtigingen voor dat item krijgt die anders niet zouden zijn verleend. 

Wanneer je een voorbeeld van je website bekijkt, doe je dit in de beheerdersrol.Om als een ander type gebruiker te communiceren, publiceer je eerst je website en navigeer je vervolgens naar je live website en log je ofwel in als een andere gebruiker (Sitelid) of helemaal niet (Iedereen). Onthoud dat, als de Sandbox is ingeschakeld op je website, je live website werkt met de live-verzamelingen en niet met de Sandbox-verzamelingen die je ziet in het CMS of wanneer je een voorbeeld van je website bekijkt. 

Bij het instellen van de machtigingen voor je verzameling kun je kiezen uit een lijst met voorinstellingen. De voorinstellingen stellen automatisch de machtigingen in voor een aantal veelvoorkomende scenario's, zoals weergegeven in de onderstaande tabel.
 
Op basis van de voorinstelling die je selecteert, krijgt elke rol machtigingen toegewezen die overeenkomen met de behoeften van het scenario. Je kunt altijd Aangepast selecteren om de aan een rol verleende machtigingen aan te passen.

Bij interactie met je verzamelingen met behulp van de Data API, kun je er in bepaalde gevallen voor kiezen om het machtigingsmodel te omzeilen. Het optionele argument WixDataOptions kan naar de API-functieoproep worden verzonden met de eigenschap suppressAuth ingesteld op 'true'. Hierdoor wordt de functie uitgevoerd zonder te controleren of de huidige gebruiker de juiste machtigingen heeft. Je kunt alleen machtigingen omzeilen bij het maken van API-oproepen vanuit backend-code. Client-side API-oproepen voeren altijd toestemmingscontroles uit, ongeacht welke opties worden omzeilt.

Een verzameling kan zowel opmerkingen als de e-mail van de maker van de opmerking bevatten. Bezoekers moeten de opmerkingen kunnen bekijken, maar alleen de beheerder mag de e-mailadressen bekijken. In zo'n geval moet men de leesmachtigingen voor de opmerkingenverzameling op 'Beheerder' zetten. De machtigingsonderdrukking zal ons helpen de bezoekers toe te staan de opmerkingen te bekijken zonder de bezoekers de toestemming te geven om de opmerkingenverzameling te 'lezen'.

Dit kan worden gedaan door een webmodule in een jsw-bestand in de backend te schrijven die de opmerkingenverzameling oproept met de eigenschap suppressAuth ingesteld op 'true' en vervolgens het antwoord eruit filtert en alleen de gewenste velden (opmerkingen) terugstuurt naar de client zodat de bezoeker deze kan bekijken, zonder de andere velden van de verzameling, met name zonder de e-mailadressen. 

Een ander voorbeeld van het gebruik van suppressAuth is waar je een [aangepaste rol (een specifiek websitelid of een specifieke groep websiteleden) toegang wilt geven tot een verzameling die is ingesteld met beheerdersmachtigingen.

In het tweede voorbeeld moet de webmodule de identiteit of de rol van het websitelid controleren voordat je de gegevens opvraagt. In het eerste voorbeeld moet de webmodule de resultaten uitfilteren voordat de gegevens naar de client worden teruggestuurd.