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

# Entwicklungswerkzeuge einrichten

## Empfohlene Entwicklungswerkzeuge

Diese optionalen Dienste sind für den Betrieb von Overleaf nicht erforderlich, werden aber für Entwicklung, Debugging und Analyse während der lokalen Entwicklung dringend empfohlen.

* **Hoppscotch** ist ein schlankes API-Testwerkzeug ähnlich wie Postman, jedoch browserbasiert und für die Entwicklung sehr praktisch.
  * Frontend: [http://localhost:3000](http://localhost:3000/)
  * Proxy (zur Umgehung von CORS): [http://localhost:9159](http://localhost:9159/)
* **RedisInsight** bietet eine grafische Oberfläche zur Untersuchung von Redis-Daten. Die Oberfläche ist erreichbar unter: [http://localhost:5540](http://localhost:5540/)
* **Mongo Express** ist eine webbasierte Oberfläche für MongoDB. Sie können [http://localhost:8081](http://localhost:8081/) mit den **Zugangsdaten** `admin:pass` aufrufen.

Bitte fügen Sie Folgendes zu Ihrer `docker-compose.yml` hinzu:

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

#### API-Anfragen über einen Proxy

Um Hoppscotch einzurichten, rufen Sie [http://localhost:3000](http://localhost:3000/) auf und wechseln Sie zum Tab „Settings“. Setzen Sie `Proxy` auf [http://localhost:9159](http://localhost:9159/), damit Ihre Debugging-Werkzeuge mit den internen Netzwerken der Container kommunizieren können.

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

Jetzt können Sie mit [http://web:3000/status](http://web:3000/status) testen, ob der web-Dienst läuft:

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

<Warning>
  Wenn Sie mit Postman oder anderen Debugging-Werkzeugen eine **POST**-Anfrage erzeugen, stellen Sie möglicherweise fest, dass die Anmeldung **verweigert** wird, und zwar mit einem 401-Fehler. Das liegt daran, dass Overleaf durch eine **CSRF**-Prüfung geschützt ist.
</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 Ihrer Konsole sehen Sie möglicherweise:

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

Um dies bei Ihrer Overleaf-Entwicklung zu lösen, müssen Sie Ihr CSRF-Token einrichten. Hier ist die ausführliche Anleitung.

<Steps>
  <Step title="Pre-Request hinzufügen">
    Fügen Sie den folgenden Code als Pre-Request hinzu

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

    Das Skript lautet wie folgt:

    ```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-Header hinzufügen">
    Sie müssen die folgenden Header hinzufügen:

    | Header-Name | Header-Wert |
    | - | - |
    | 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="Mit API-Werkzeugen anmelden">
    Jetzt können Sie sich mit Ihrem Benutzernamen und Passwort anmelden.

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

    So sieht die Antwort aus, wenn Sie einen falschen Benutzernamen oder ein falsches Passwort eingeben.

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