# Notion

> Verbind je Notion-werkruimte met Tidal Control via een interne integratiesleutel, zodat compliancetests uitlezen hoe je pagina's gedeeld zijn. Alleen lezen.

Source: https://tidalcontrol.com/nl/docs/integrations/notion

De Notion-integratie van Tidal Control leest hoe je Notion-werkruimte gedeeld is en wie er lid van is, voor compliancedoeleinden. De verbinding authenticeert met een interne integratiesleutel, en de controles richten zich op de manieren waarop een werkruimte stil informatie prijsgeeft: pagina's die op het web staan, inhoud die in de prullenbak blijft liggen en integraties die van individuen zijn.

## Wat deze integratie monitort

- **Publieke pagina's:** Pagina's die op het web zijn gepubliceerd en leesbaar zijn voor iedereen met de URL
- **Prullenbak:** Pagina's die in de prullenbak liggen in plaats van echt verwijderd te zijn
- **Persoonlijke bot-integraties:** Integraties die eigendom zijn van een individu in plaats van de werkruimte
- **Inline databases:** Databases die inline zijn ingebed, waar rechten makkelijk uit het zicht raken
- **Gebruikers zonder e-mailadres:** Accounts waarvan geen e-mailadres is vastgelegd

## Vereisten

- De rol Super User in Tidal Control
- Eigenaarsrechten op de Notion-werkruimte, om een interne integratie aan te maken
- De mogelijkheid om de pagina's die je wilt dekken met die integratie te delen

## Stappenplan voor de configuratie

We maken een **interne integratie** aan in Notion, koppelen die aan de inhoud die je wilt dekken en voegen daarna de verbinding toe in Tidal Control.

**Configuratiestappen:**

1. **Maak een interne integratie aan**
2. **Geef de integratie toegang tot je inhoud**
3. **Configureer de integratie in Tidal Control**

## Stap 1: Maak een interne integratie aan

- Ga naar [notion.so/my-integrations](https://www.notion.so/my-integrations)
- Klik op **New integration**, geef hem een naam, bijvoorbeeld `Tidal Control`, en koppel hem aan je werkruimte
- Houd de rechten alleen-lezen: **Read content** en **Read user information** zijn voldoende
- Kopieer het **Internal Integration Secret**

## Stap 2: Geef de integratie toegang tot je inhoud

Notion-integraties zien niets totdat inhoud expliciet met ze gedeeld wordt.

- Open een pagina op het hoogste niveau die je wilt dekken
- Ga via het paginamenu naar **Connections** en voeg je integratie `Tidal Control` toe
- Herhaal dit voor elke pagina op het hoogste niveau waarvan je de onderliggende structuur wilt meenemen

> **warning:**

**Notion geeft toegang per pagina, niet per werkruimte.** Een integratiesleutel zonder gekoppelde pagina's authenticeert zonder fout en geeft niets terug, waardoor de controles een lege werkruimte zouden beoordelen. Koppel je pagina's op het hoogste niveau, zodat de resultaten echte inhoud weerspiegelen.

## Stap 3: Configureer de integratie in Tidal Control

- Ga naar **Instellingen → Integraties** in Tidal Control
- Klik op het **plusicoon** naast **Notion**
- Vul de configuratie in:
  - **Naam:** Een beschrijvende naam, bijvoorbeeld `Notion`
  - **API-sleutel:** Het internal integration secret uit stap 1
- Klik op **"Aanmaken"** om de integratie op te slaan

## Configuratievelden uitgelegd

Het configuratievenster vraagt om de volgende waarden:

**Naam:**
- Een beschrijvende naam voor deze verbinding
- Bijvoorbeeld: `Notion`

**API-sleutel:**
- Het internal integration secret uit stap 1
- Verplicht, en wordt als secret opgeslagen

## Verificatie

De integratie werkt wanneer al het volgende waar is:

- Instellingen → Integraties toont Notion onder **Geconfigureerde integraties**
- De Notion-tests zijn beschikbaar in de sectie Tests
- De resultaten tonen echte pagina's en niet een lege werkruimte

## Veelgestelde vragen

**Waarom zien de resultaten leeg uit?**
Bijna altijd omdat er geen pagina's aan de integratie gekoppeld zijn. Notion deelt inhoud per pagina met integraties, dus stap 2 is niet optioneel.

**Leest Tidal Control de inhoud van onze pagina's?**
De integratie leest metadata en de deelstatus van pagina's, en dat is wat de controles nodig hebben. De tekst van pagina's wordt niet doorzocht.

**Wat is een persoonlijke bot-integratie, en waarom is dat belangrijk?**
Een integratie die eigendom is van één persoon in plaats van de werkruimte. Die blijft na een rolwijziging van die persoon werken op je inhoud, en is dus toegang waar niemand naar kijkt.

## Veelvoorkomende problemen

**"API Key is required"**
- Het secret is niet geplakt. Kopieer het opnieuw van de integratiepagina

**Controles leveren geen pagina's op**
- Er is geen inhoud gekoppeld. Voeg de integratie toe onder **Connections** op je pagina's op het hoogste niveau

**Een pagina die je verwachtte ontbreekt**
- De onderliggende structuur is niet met de integratie gedeeld. Koppel de pagina, of een bovenliggende pagina

### Kom je er niet uit?

Stuur een e-mail naar support@tidalcontrol.com, dan nemen we zo snel mogelijk contact met je op.

> **info:**

**Verzamel supportinformatie:** Noteer welke browser je gebruikt, de exacte foutmeldingen en welke stappen je al hebt geprobeerd. Dat versnelt de oplossing aanzienlijk.