Document360 laat je de Knowledge Base-widget beperken tot specifieke domeinen. Zodra een domein aan de widgetbeveiligingslijst is toegevoegd, wordt de widget alleen geladen op die opgegeven domeinen — elke poging om het in een niet-vermeld domein in te bedden wordt geblokkeerd.
Als er geen domeinen aan de lijst worden toegevoegd, kan de kennisbank-widget zonder beperking worden ingebed in elke SaaS-applicatie of openbare website.
Wanneer domeinbeperking te configureren
- Direct na het installeren van de widget op een publieke productielocatie.
- Wanneer je meerdere omgevingen hebt en de widget beperkt wilt zijn tot specifieke domeinen per omgeving.
- Wanneer je ongeautoriseerde embedding wilt voorkomen — is de widget-API-sleutel zichtbaar in platte tekst in de JavaScript-code en kan niet worden versleuteld. Beperken tot vertrouwde domeinen is de enige manier om te voorkomen dat de sleutel misbruikt kan worden op ongeautoriseerde sites.
Hoe beperk je de kennisbankwidget tot een specifiek domein
- Navigeer naar Connections () > Knowledge base-widget in de linker navigatiebalk.
- Beweeg je muis over de gewenste widget en klik op het pictogram Bewerken ().
- Vouw in het tabblad Configure & connect de Widget security accordion uit. Je kunt de lijst vinden van eerder toegevoegde domeinen (indien aanwezig).
- Voer het domein in waar je wilt dat de widget mag laden.
- Klik op Toevoegen en vervolgens op Opslaan om toe te passen.
Regels voor domeinformaat
- Voer alleen in wat na de
www.in je URL komt. Voorbeeld:document360.com - Wildcard-notatie wordt niet ondersteund. Je kunt niet alle
*.domain.comsubdomeinen tegelijk toestaan. - URL-paden worden niet ondersteund. Vermeldingen zoals
domain.com/path/pagezijn niet geldig. - Het toevoegen van het ouderdomein is voldoende. Als je toevoegt
group.docuware.cloud, zijn alle subdomeinen eronder (bijv.team1.group.docuware.cloud) automatisch toegestaan. - Een lege lijst betekent onbeperkt — de widget kan op elk domein of subdomein laden.
Best practices
- Voeg zowel je productie- als stagingdomeinen toe aan de lijst zodat beide omgevingen correct functioneren.
- Bekijk en schet de domeinlijst bij het buiten gebruik stellen van oude omgevingen.
- Combineer domeinbeperking met JWT-authenticatie voor private kennisbanken om de veiligheid te maximaliseren.
FAQ
Hoe beperk ik de kennisbankwidget tot een specifiek domein?
Navigeer naar Connections > Knowledge Base-widget > Bewerken > Configureren en verbinden > Widgetbeveiliging. Voer het domein in (zonder www.), klik op Toevoegen en vervolgens op Opslaan. De widget laadt alleen op domeinen in deze lijst.
OPMERKING
Het configureren van domeinbeperking wordt ook aanbevolen als beveiligingsmaatregel omdat de widget-API-sleutel zichtbaar is in platte tekst in de JavaScript-code. Het beperken van de widget tot vertrouwde domeinen zorgt ervoor dat de API-sleutel niet kan worden misbruikt op ongeautoriseerde websites, zelfs als deze in de code wordt blootgesteld.
Waarom zou ik domeinbeperking configureren als de API-sleutel al in het script staat?
De widget API-sleutel is zichtbaar in platte tekst in de JavaScript-code van de widget en kan niet worden versleuteld. Zonder domeinbeperking kan iedereen die het script kopieert je widget op zijn eigen site inbedden, waarbij je mogelijk je kennisbankinhoud misbruikt wordt. Het beperken van de widget tot vertrouwde domeinen zorgt ervoor dat de API-sleutel niet misbruikt kan worden op ongeautoriseerde websites, zelfs als deze wordt blootgesteld.