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
• 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

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.