> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Vertrouwen en beveiliging

> Inzicht in gegevensverwerking, buildlevering en beveiligingsverantwoordelijkheden.

Ayakaleaf Pro draait in uw infrastructuur. U beheert de gegevens, de toegang en de netwerkgrenzen. Deze pagina legt het standaardbeveiligingsmodel uit en geeft aan welke operationele verantwoordelijkheden bij u liggen.

### Is Ayakaleaf Pro betrouwbaar en veilig?

Ayakaleaf Pro is een zelfgehoste uitbreiding van Overleaf Pro, en onze broncode is beschikbaar op [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro). Uw implementatie bepaalt waar services draaien en waar gegevens zich bevinden.

Beveiliging hangt af van uw configuratie en beheer. Bescherm de beheerderstoegang, schakel HTTPS in en onderhoud back-ups.

Dank aan OpenAI voor hun vriendelijke ondersteuning. We gebruiken regelmatig [Codex Security](https://chatgpt.com/codex/cloud/security/findings) om onze repository op beveiligingsproblemen te scannen en delen de resultaten van kwetsbaarheidsoplossingen openbaar.

### Waar gaan mijn gegevens naartoe?

Standaard blijven de applicatiegegevens binnen uw implementatie:

* MongoDB slaat gebruikers- en projectgegevens op.
* Redis slaat cache- en realtime-samenwerkingsgegevens op.
* Lokale volumes of S3-compatibele opslag bevatten projectbestanden.

Standaard is alleen de webservice extern bereikbaar. Interne services communiceren via het Docker-netwerk.

### Worden mijn gegevens naar derden verzonden of van derden opgehaald?

Er verlaat niets uw implementatie, tenzij u een functie inschakelt die dat vereist. Ayakaleaf Pro verstuurt *geen telemetrie, geen gebruiksanalyses en geen crashrapporten*. Foutrapportage en analyses zijn uitgeschakeld in de standaardconfiguratie.

Verschillende functies doen helemaal geen externe verzoeken. Sjablonen worden opgeslagen en aangeboden vanuit uw eigen implementatie. De Python-scriptrunner draait in de browser van de gebruiker via WebAssembly, en de runtime ervan wordt aangeboden door uw eigen webservice in plaats van een openbaar CDN, zodat scriptcode en uitvoer het netwerk nooit bereiken. Git Bridge is alleen bereikbaar via het interne Docker-netwerk. Zoeken in het volledige project, het symboolpalet, wijzigingen bijhouden, de projectgeschiedenis en het beheerpaneel zijn volledig lokaal. Sandbox-compilatiecontainers worden aangemaakt met uitgeschakeld netwerk.

De verzoeken van de overige functies gaan naar de volgende bestemmingen. Elk verzoek komt van de webservice:

<Accordion title="AI-assistenten en zoeken">
  AI-functies zijn standaard uitgeschakeld. Wanneer ze zijn ingeschakeld, sturen chat en suggesties voor LaTeX-fouten prompts en relevante projectcontext naar het modelendpoint dat is geconfigureerd met `AI_BASE_URL`. Optioneel zoeken op het web stuurt zoekopdrachten naar de geconfigureerde Tavily-compatibele service, en zoeken in de documentatie stuurt zoekopdrachten naar `DOCS_MCP_URL` (standaard: `https://docs.overleaf.com/~gitbook/mcp`). Zoekresultaten kunnen worden meegestuurd in verzoeken aan de modelaanbieder. Zie [AI-integratie](/nl/on-premises/configuration/overleaf-toolkit/ai-integration "mention") voor configuratie en gebruikersinstellingen.
</Accordion>

<Accordion title="GitHub-integratie">
  **GitHub-integratie** maakt contact met `github.com` en `api.github.com`. Ze wordt per gebruiker ingeschakeld door een GitHub-account te koppelen, en de autorisatie vraagt de scopes `read:org`, `repo` en `workflow` aan. Bij een push wordt de volledige inhoud van de projectbestanden geüpload als Git-blobs, die vervolgens worden samengesteld tot trees en commits. Er worden ook branch-, reference-, compare- en merge-bewerkingen uitgevoerd, en het profiel, de organisatielidmaatschappen en de repositorylijst van het gekoppelde account worden gelezen. Projectinhoud verlaat uw implementatie in beide richtingen — beschouw een gekoppeld GitHub-account als een exportpad voor elk project dat eraan is gekoppeld.
</Accordion>

<Accordion title="Zotero-integratie">
  **Zotero-integratie** maakt contact met `www.zotero.org` voor autorisatie en met `api.zotero.org` voor bibliotheekgegevens. Ze wordt per gebruiker ingeschakeld door een Zotero-account te koppelen. De OAuth-handshake en de API-sleutel van de gebruiker worden verzonden. Het lezen gebeurt in één richting: referentiebibliotheken worden als BibTeX binnengehaald en er wordt geen projectinhoud geüpload.
</Accordion>

<Accordion title="Mendeley-integratie">
  **Mendeley-integratie** maakt contact met `api.mendeley.com` voor zowel autorisatie als bibliotheekgegevens. Ze wordt per gebruiker ingeschakeld door een Mendeley-account te koppelen. De OAuth-handshake vraagt de scope `all` van Mendeley aan — de enige scope die de API aanbiedt — maar Ayakaleaf voert uitsluitend leesbewerkingen uit: referentiebibliotheken en groepsbibliotheken worden als BibTeX binnengehaald en er wordt geen projectinhoud geüpload. Toegangstokens worden automatisch vernieuwd; wanneer Mendeley een toestemming intrekt, wordt de opgeslagen referentie verwijderd en wordt de gebruiker gevraagd het account opnieuw te koppelen.
</Accordion>

<Accordion title="Documentatiepagina's">
  **Documentatiepagina's** worden opgehaald van `https://learnwiki.overleaf.com`, configureerbaar met `WIKI_URL`. De verzoeken worden gedaan door de webservice, niet door de browser van de gebruiker, zodat de upstream-wiki uw server ziet en nooit de adressen van uw gebruikers. Alleen de titel van de opgevraagde pagina wordt verzonden, en de antwoorden worden op schijf gecachet. Laat `WIKI_URL` naar uw eigen mirror verwijzen of blokkeer de bestemming als uitgaand documentatieverkeer niet acceptabel is.
</Accordion>

<Accordion title="E-mailbezorging">
  **E-mailbezorging** maakt contact met de SMTP-server of mail-API die u configureert; er is geen standaardwaarde. Ontvangeradressen en berichtinhoud verlaten uw implementatie, inclusief links voor het opnieuw instellen van wachtwoorden en uitnodigingslinks.
</Accordion>

<Accordion title="Twee optionele controles (PWD/reCAPTCHA)">
  <strong>Twee optionele controles zijn standaard uitgeschakeld.</strong> De controle op gelekte wachtwoorden is inactief tenzij `HAVE_I_BEEN_PWNED_ENABLED` is ingesteld; wanneer ingeschakeld, stuurt deze de eerste tekens van een SHA-1-hash van het wachtwoord naar `api.pwnedpasswords.com`, nooit het wachtwoord zelf. CAPTCHA-verificatie is inactief tenzij een reCAPTCHA-sitesleutel is geconfigureerd, en maakt contact met `www.google.com` wanneer ze actief is.
</Accordion>

<Accordion title="Single sign-on (OAuth/LDAP/SAML)">
  **Single sign-on** maakt alleen contact met de identiteitsprovider die u opgeeft, en wat daarheen gaat, hangt af van het protocol. Bij LDAP maakt de webservice rechtstreeks verbinding met uw directory: deze bindt met het serviceaccount dat u configureert, zoekt binnen de base, het filter en de attributenlijst die u definieert, en verifieert het op het inlogformulier ingevoerde wachtwoord tegen uw directory, zodat de gebruikersnaam en het wachtwoord de directoryserver bereiken. Het inschakelen van contacten op basis van de directory leidt tot een extra zoekopdracht om de contactlijst te vullen. Bij OIDC wisselt de webservice de autorisatiecode in bij uw tokenendpoint en roept vervolgens uw user-info-endpoint aan, waarbij standaard de scopes `openid profile email` worden aangevraagd; dit is configureerbaar met `OVERLEAF_OIDC_SCOPE`. Bij SAML gaat het authenticatieverzoek via de browser van de gebruiker naar de identiteitsprovider in plaats van via een directe serververbinding. In alle drie de gevallen worden de naam en het e-mailadres van de gebruiker van de provider ontvangen in plaats van ernaartoe gestuurd, en vervolgens opgeslagen in het lokale gebruikersrecord.
</Accordion>

<Accordion title="Referenties van derden">
  **Referenties van derden** — OAuth-tokens en API-sleutels — worden in MongoDB bewaard in het gebruikersrecord, versleuteld met AES-256-CTR met een salt en initialisatievector per record. Ze worden nooit in platte tekst opgeslagen en nooit naar logs geschreven. De versleutelingssleutel komt uit `${PROVIDER}_CIPHER_PASSWORD` als die is ingesteld (zoals bij Zotero en Mendeley); anders wordt er bij het eerste gebruik een gegenereerd en in uw datavolume opgeslagen met rechten die alleen voor de eigenaar gelden. Maak een back-up van die sleutel samen met uw datavolume: als deze verloren gaat, kunnen opgeslagen referenties niet worden ontsleuteld en moet elke gebruiker zijn accounts opnieuw koppelen.
</Accordion>

<Accordion title="Bestanden gekoppeld via een URL">
  **Bestanden gekoppeld via een URL** worden namens de gebruiker door uw implementatie opgehaald, dus de bestemming is het adres dat de gebruiker opgeeft. Via een URL gekoppelde bestanden zijn uitgeschakeld tenzij u `url` toevoegt aan `ENABLED_LINKED_FILE_TYPES`, en de standaardconfiguratie bevat dit niet. Externe ZIP- en TeX-imports via de Open in Overleaf API gebruiken ook dezelfde component `linked-url-proxy`. Directe verzoeken resolven de doelhostnaam en weigeren beperkte netwerkbereiken, met inachtneming van geconfigureerde uitzonderingen voor toegestane resources. Als `OVERLEAF_LINKED_URL_OUTBOUND_PROXY` is geconfigureerd, resolvet de uitgaande proxy de hostnamen, dus moet die zelf de beperkingen voor het interne netwerk afdwingen; de netwerkcontroles van de applicatie gelden alleen voor URL's die IP-adressen bevatten. Zie [Externe URL — Uitgaande proxy](/nl/on-premises/configuration/overleaf-toolkit/external-url#outbound-proxy "mention") voor details. Deze verzoeken halen de opgegeven URL op in plaats van projectbestanden te uploaden.
</Accordion>

Als uw beleid een allowlist voor uitgaand verkeer vereist, sta dan alleen de hosts toe van de functies die u hebt ingeschakeld — `github.com` en `api.github.com` voor GitHub, `www.zotero.org` en `api.zotero.org` voor Zotero, `api.mendeley.com` voor Mendeley, `learnwiki.overleaf.com` of uw eigen `WIKI_URL` voor documentatie, `api.pwnedpasswords.com` voor de wachtwoordcontrole, `www.google.com` voor CAPTCHA, plus uw eigen mailserver en identiteitsprovider. Als AI-functies of zoeken zijn ingeschakeld, sta dan ook de geconfigureerde endpoints voor het model, het zoeken op het web en de documentatie-MCP toe. Weiger bestemmingen die niet nodig zijn voor uw ingeschakelde functies. Waar uitgaand verkeer centraal moet worden geïnspecteerd of gelogd, kunnen de GitHub-, Zotero- en Mendeley-integraties elk via een HTTP-proxy worden geleid door `GITHUB_SYNC_PROXY_URL`, `MENDELEY_PROXY_URL` en `ZOTERO_PROXY_URL` in te stellen. Het ophalen van gekoppelde URL's en externe imports kunnen `OVERLEAF_LINKED_URL_OUTBOUND_PROXY` gebruiken. Bestanden die via een URL zijn gekoppeld, kunnen niet tot een lijst van hosts worden beperkt, omdat de gebruiker de bestemming kiest op het moment van het verzoek; beperk die functie via de eigen instelling voor toegestane resources van de proxycomponent, of laat haar uitgeschakeld.

<Warning>
  Als u Ayakaleaf Pro implementeert met [s3.md](/nl/on-premises/configuration/overleaf-toolkit/s3 "mention")-opslag ingeschakeld, worden de in S3 opgeslagen gegevens dan versleuteld?

  *<strong>Nee.</strong>* De gegevens worden niet versleuteld. Alle history-chunks, sjabloonbestanden, pdf's en andere bestanden worden in platte tekst opgeslagen. Als u een externe S3-opslagprovider van derden gebruikt, let dan goed op gegevensbeveiliging en privacy.
</Warning>

### Zijn projectcompilaties geïsoleerd?

Ayakaleaf Pro ondersteunt gesandboxte compilaties. Elke compilatie draait in een aparte container. Sandboxcontainers hebben standaard geen netwerktoegang. Dat beperkt de blootstelling aan interne netwerkbronnen.

Gesandboxte compilaties vereisen toegang tot de Docker-socket van de host. Beperk het beheer van de host tot vertrouwde beheerders.

### Kan ik CI-builds en container-images vertrouwen?

GitHub Actions bouwt en publiceert de container-images van Ayakaleaf Pro. De images zijn beschikbaar via de openbare GitHub Container Registry.

De images ondersteunen `amd64` en `arm64`. Docker kiest bij het pullen van een image automatisch de passende architectuur.

Gebruik de tag `latest` niet in productie. Pin een expliciete versie vast, bij voorkeur een image-digest.

Test elke upgrade in een niet-productieomgeving. Controleer de image, de configuratie en de integraties voordat u uitrolt.

### Is de code open source?

Ayakaleaf Pro en de bijbehorende functierepository's zijn openbaar beschikbaar. Zo kunnen gebruikers wijzigingen beoordelen en upstream-bronnen traceren.

Openbare broncode maakt onafhankelijke beoordeling mogelijk. Op zichzelf garandeert dat echter geen reproduceerbare release-builds.

Controleer vóór het upgraden:

* De releasetag of commit.
* De imageversie of digest.
* Afhankelijkheden van derden en licentievereisten.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.