GitHub

De GitHub integratie stelt Tidal Control in staat om automatisch compliance tests uit te voeren op je GitHub omgeving via de Tidal Control GitHub app.

Vereisten

• Super User rol in Tidal Control
• GitHub organisatie admin rechten
• Toegang tot GitHub organisatie waar monitoring gewenst is

Configuratie stappenplan

We installeren de Tidal Control GitHub app in je GitHub organisatie(s). Deze app krijgt read-only toegang tot repository configuraties voor security compliance monitoring.

Configuratie stappen:

1. Tidal integratie starten
2. GitHub authenticatie
3. Repository toegang configureren
4. App installatie voltooien
5. Aanvullende organisaties

Benodigde machtigingen

Wanneer je de Tidal Control GitHub app installeert, toont GitHub een overzicht van de machtigingen die de app vraagt. Alle toegang is read-only. Tidal Control schrijft, wijzigt of verwijdert nooit iets in je GitHub omgeving.

Momenteel actief gebruikt

Machtiging	Waarvoor wij deze gebruiken
Administration	Leest branch protection rules en rulesets. Gebruikt voor: is force push naar de default branch uitgeschakeld, is een PR-review verplicht voor het mergen, en is code owner goedkeuring vereist.
Pull requests	Controleert of recentelijk gemergte pull requests zijn goedgekeurd vóór het mergen.
Metadata	Basis repository-informatie: naam, zichtbaarheid (public/private), fork-status en de naam van de default branch.

Aanwezig voor toekomstige tests

De volgende machtigingen zijn aanwezig in de app maar worden nog niet actief gebruikt. Ze zijn opgenomen voor aanvullende compliance-checks die wij van plan zijn te bouwen:

Machtiging	Gepland gebruik
Code	Controleren of een CODEOWNERS-bestand aanwezig en correct geconfigureerd is, of dat een SECURITY.md (responsible disclosure policy) bestaat. Wij lezen uitsluitend metadatabestanden, niet je bedrijfslogica of intellectueel eigendom.
Dependabot alerts	Verifiëren of Dependabot actief is en of er geen openstaande kritieke kwetsbaarheden zijn in dependencies.
Secret scanning alerts	Controleren of secret scanning ingeschakeld is en of er geen openstaande meldingen zijn van gelekte credentials.
Checks	Verifiëren of verplichte CI-checks geconfigureerd zijn als voorwaarde voor het mergen van pull requests.
Security events, repository advisories, deployments, issues	Gereserveerd voor toekomstige compliance-checks.

Stap 1: Tidal integratie starten

• Ga naar Instellingen → Integraties in Tidal Control
• Klik op het plus-icoon naast GitHub
• Klik "Click here to get started"
• Je wordt automatisch doorgestuurd naar GitHub

Stap 2: GitHub authenticatie

• Voer je GitHub inloggegevens in
• Klik "Sign in"
• Selecteer de organisatie waar je de app wilt installeren
• Als app al geïnstalleerd: klik "Configure" voor instellingen

Stap 3: Repository toegang configureren

• Kies toegangsniveau:
  • Alle repositories - Complete organisatie monitoring
  • Specifieke repositories - Selectieve compliance monitoring
• Selecteer gewenste repositories indien specifiek gekozen

Stap 4: App installatie voltooien

• Review de machtigingen die Tidal Control vraagt
• Klik "Install" voor directe installatie
• Of klik "Request" als organisatie approval vereist
• Wacht op goedkeuring van organisatie eigenaar (indien van toepassing)

Stap 5: Aanvullende organisaties

• Herhaal stap 1-4 voor elke extra organisatie
• Elke organisatie heeft eigen app installatie nodig
• Configureer per organisatie welke repositories gemonitord worden

Verificatie

De integratie werkt wanneer het volgende allemaal klopt:

• Instellingen → Integraties toont GitHub onder Geconfigureerde integraties
• Test refresh levert repository data zonder (permission) errors

Troubleshooting

Maakt de integratie geen verbinding, controleer dan het volgende:

• Verifieer GitHub app installatie in organisatie settings
• Controleer repository permissions voor Tidal Control app
• Vraag na of de organisatie admin de app heeft goedgekeurd
• Verifieer of er geen conflicterende security policies in GitHub zijn

Kom je er nog niet uit?

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