> ## 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.

# Ontwikkeltools instellen

## Aanbevolen ontwikkeltools&#x20;

Deze optionele services zijn niet nodig om Overleaf te draaien, maar worden sterk aanbevolen voor ontwikkeling, debugging en inspectie tijdens lokale ontwikkeling.

* **Hoppscotch** is een lichtgewicht tool voor het testen van API's, vergelijkbaar met Postman, maar browsergebaseerd en zeer handig tijdens de ontwikkeling.
  * Frontend: [http://localhost:3000](http://localhost:3000/)
  * Proxy (om CORS te omzeilen): [http://localhost:9159](http://localhost:9159/)
* **RedisInsight** biedt een visuele interface om Redis-gegevens te inspecteren. De UI is beschikbaar op: [http://localhost:5540](http://localhost:5540/)
* **Mongo Express** is een webgebaseerde UI voor MongoDB. Je kunt [http://localhost:8081](http://localhost:8081/) bezoeken met de **inloggegevens**: `admin:pass`

Voeg het volgende toe aan je `docker-compose.yml`:

<Accordion title="develop/docker-compose.yml">
  ```yml title="develop/docker-compose.yml" theme={null}
  # services: 
    # Overleaf Dev Containers
    # ...
    
    # Add those for your development
    # API debug
    hoppscotch-frontend:
      image: hoppscotch/hoppscotch-frontend:latest
      ports:
        - "3000:3000"

    hoppscotch-proxy:
      image: hoppscotch/proxyscotch:latest
      environment:
        - PORT=9159
      ports:
        - "9159:9159"

    # Redis-insight
    redis-insight:
      image: redislabs/redisinsight:latest
      ports:
        - "5540:5540"
      depends_on:
        - redis
      volumes:
        - ./data/redis-insight:/data

    # mongo-express
    # basicAuth credentials are "admin:pass"
    mongo-express:
      image: mongo-express
      ports:
        - "8081:8081"
      environment:
        ME_CONFIG_MONGODB_SERVER: mongo
  ```
</Accordion>

### Hoppscotch instellen

#### API-verzoeken via proxy

Om Hoppscotch in te stellen, ga je naar [http://localhost:3000](http://localhost:3000/) en open je het tabblad Instellingen. Stel `Proxy` in op [http://localhost:9159](http://localhost:9159/), zodat je debugtools kunnen communiceren met de interne netwerken van de containers.

<Frame>
  <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/dev/image-6.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=10eae686404ed9da3a1c722ee536e2bb" alt="" width="2210" height="1446" data-path="images/dev/image-6.png" />
</Frame>

Nu kun je met [http://web:3000/status](http://web:3000/status) testen of web actief is:

<Frame>
  <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/dev/image-7.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=7acf8612db25a86a3cbe85cb7732ae04" alt="" width="2126" height="1449" data-path="images/dev/image-7.png" />
</Frame>

#### CSRF-problemen

<Warning>
  Als je Postman of andere debugtools gebruikt om een **POST**-verzoek te versturen, kan het gebeuren dat het inloggen **geweigerd** wordt, met een 401-fout als gevolg. Dat komt doordat Overleaf beveiligd is met **CSRF**-verificatie.
</Warning>

<Frame>
  <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/dev/image-9.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=19d2f0be555349d1b1c0e95839afb8e4" alt="" width="1695" height="1200" data-path="images/dev/image-9.png" />
</Frame>

In je console zie je mogelijk:

<Frame>
  <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/dev/image-10.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=65b38b322d5e940eaa171564dcdb0384" alt="" width="1614" height="551" data-path="images/dev/image-10.png" />
</Frame>

Om dit tijdens je Overleaf-ontwikkeling op te lossen, moet je je CSRF-token instellen. Hieronder volgt een gedetailleerde handleiding.

<Steps>
  <Step title="Pre-request toevoegen">
    Voeg de volgende code toe aan Pre-Request

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/dev/image-11.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=dfc09ccaec771328ed3b1026f951bd0b" alt="" width="1123" height="704" data-path="images/dev/image-11.png" />
    </Frame>

    Het script ziet er als volgt uit:

    ```js wrap theme={null}
    pm.sendRequest("http://web:3000/dev/csrf", function (err, res) {
        if (err) {
            console.log(err);
            return;
        }

        // 1) Save CSRF token (/dev/csrf)
        const token = res.text().trim();
        pw.env.set("csrftoken", token);
        console.log("csrftoken =", token);

        const setCookieHeader = (res.headers || []).find(h => h.key?.toLowerCase() === "set-cookie")?.value;
        console.log("set-cookie =", setCookieHeader);

        if (!setCookieHeader) return;

        const cookiePair = setCookieHeader.split(";")[0].trim(); // overleaf.sid=...
        pw.env.set("cookie_header", cookiePair);
        console.log("cookie_header =", cookiePair);
    });
    ```
  </Step>

  <Step title="Request-headers toevoegen">
    Je moet de volgende headers toevoegen:

    | Headernaam | Headerwaarde |
    | - | - |
    | Content-Type | `application/json` |
    | X-Csrf-Token | `<<csrftoken>>` |
    | Cookie | `<<cookie_header>>` |

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/dev/image-12.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=0e62c9be402f8caab1844a7b102eeb29" alt="" width="1018" height="479" data-path="images/dev/image-12.png" />
    </Frame>
  </Step>

  <Step title="Inloggen met API-tools">
    Nu kun je inloggen met je gebruikersnaam en wachtwoord.

    ```json5 theme={null}
    {
      "_csrf": "<<csrftoken>>",
      "email": "admin@overleaf.com",
      "password": "xxxxxx"
    }
    ```

    Hieronder zie je het antwoord wanneer je een verkeerde gebruikersnaam of een verkeerd wachtwoord invoert.

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/dev/image-13.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=cf570827c538094c795c3de8874ba13c" alt="" width="1050" height="830" data-path="images/dev/image-13.png" />
    </Frame>
  </Step>
</Steps>


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