Drata | cside docs

Verbind cside met Drata om de domeinen die cside monitort naar je Drata-workspace te sturen. cside maakt een custom connection met de naam cside en vult die met één record per gemonitord domein, zodat je auditors zien welke sites gemonitord worden, waar scriptblokkering aanstaat en welke domeinen CSP-rapportage hebben.

Geleidelijke uitrol

De Drata-integratie wordt geleidelijk uitgerold. Zie je Connect Drata nog niet onder Compliance in je integratie-instellingen, neem dan contact op met support@cside.dev om het voor je team in te schakelen. Domeinrecords worden nog niet volgens een schema gesynchroniseerd, dus vraag support om de synchronisatie te draaien zodra je verbonden bent.

Wat cside synchroniseert

Elk gemonitord domein wordt een record in de cside custom connection:

Veld	Betekenis
`domain`	Het gemonitorde domein, in Drata gebruikt als weergavenaam van het record
`team`	Het cside-team dat eigenaar is van het domein
`monitoring`	`MONITORED` voor actieve domeinen, `SUSPENDED` voor gepauzeerde
`scriptBlockingEnabled`	Of cside niet-goedgekeurde scripts blokkeert op dit domein
`paymentPagesConfigured`	Of checkout-paden zijn ingesteld, wat PCI DSS 4.0.1 vereist
`cspOnboardingCompleted`	Of CSP-rapportage is ingericht
`addedAt`	Wanneer het domein aan cside is toegevoegd
`externalUrl`	Een link naar het domein in je cside-dashboard

Een synchronisatie vervangt de volledige set records, dus domeinen die je in cside verwijdert, verdwijnen bij de volgende synchronisatie uit Drata.

Vereisten

Je hebt nodig:

Een cside-account met organisatiebeheerdersrechten, of een cside-team waarin je de rol editor hebt
Een Drata-beheerdersaccount, want alleen beheerders maken API-sleutels aan
Je Drata-regio: Verenigde Staten, Europa of Azië-Pacific

Een Drata API-sleutel aanmaken

Drata biedt geen OAuth-apps voor de publieke API, dus cside verbindt met een API-sleutel die jij aanmaakt.

Ga in Drata naar Settings > API Keys
Maak een sleutel met lees- en schrijftoegang tot Custom Connections en leestoegang tot Workspaces
Kopieer de sleutel, Drata toont die maar één keer

Bekijk de handleiding van Drata over API-sleutels voor alle stappen.

Sleutels zijn regiogebonden

Drata draait aparte deployments per regio. Een sleutel uit de Europese deployment werkt niet op die van de Verenigde Staten. Weigert cside een sleutel die er geldig uitziet, controleer dan eerst de regio voordat je een nieuwe aanmaakt.

Drata verbinden

Open het dashboard en ga naar Team Settings > Integrations
Klik onder Compliance op Connect Drata
Plak je API-sleutel en kies je Drata-regio
Klik op Connect Drata

cside valideert de sleutel meteen. Gaat dat mis, dan zijn de twee gebruikelijke oorzaken een sleutel uit een andere regio en een sleutel zonder toegang tot custom connections.

Na het verbinden maakt cside de custom connection cside aan in Drata als die nog niet bestaat, en koppelt die aan elke workspace in je account. Opnieuw verbinden hergebruikt dezelfde connection in plaats van een tweede aan te maken.

Bij het verbinden worden de connection en het recordschema aangemaakt. De domeinrecords zelf komen met de eerste synchronisatie mee.

Je data terugvinden in Drata

Ga in Drata naar Connections > All Connections en open de cside-kaart onder Active. De connectionpagina toont het recordschema, en het tabblad Manage toont één record per gemonitord domein, met de domeinnaam als label.

Zolang cside je eerste synchronisatie niet heeft gedraaid, blijft het tabblad Manage leeg, ook al staat de connection goed ingesteld. Zodra er records zijn, toont elk record een Last updated-tijd waarmee je controleert hoe actueel het is.

Een test bouwen op je cside-data

Open het tabblad Monitoring van de connection en kies voor het aanmaken van een test. Drata vult de provider en resource alvast in, en elk cside-veld is beschikbaar als voorwaarde. Zo kun je eisen dat elk cside-record monitoring op MONITORED heeft staan.

Drata loskoppelen

Ga naar Team Settings > Integrations en klik op Disconnect Drata. cside verwijdert je API-sleutel en stopt met het versturen van data naar Drata.

De custom connection blijft in Drata staan met de laatst gesynchroniseerde data, dus historisch bewijs blijft bewaard. Verwijder die in Drata als je de records kwijt wilt. Verbind je later opnieuw, dan pakt cside dezelfde connection weer op in plaats van een nieuwe te starten.