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

# Kehitystyökalujen käyttöönotto

## Suositellut kehitystyökalut

Nämä valinnaiset palvelut eivät ole välttämättömiä Overleafin ajamiseen, mutta niitä suositellaan vahvasti kehitykseen, virheenjäljitykseen ja tarkasteluun paikallisen kehityksen aikana.

* **Hoppscotch** on kevyt, Postmanin kaltainen API-testaustyökalu, joka toimii selaimessa ja on erittäin kätevä kehityksessä.
  * Käyttöliittymä: [http://localhost:3000](http://localhost:3000/)
  * Välityspalvelin (CORS-rajoitusten ohittamiseen): [http://localhost:9159](http://localhost:9159/)
* **RedisInsight** tarjoaa visuaalisen käyttöliittymän Redis-datan tarkasteluun. Käyttöliittymä on saatavilla osoitteessa: [http://localhost:5540](http://localhost:5540/)
* **Mongo Express** on verkkopohjainen käyttöliittymä MongoDB:lle. Voit käyttää sitä osoitteessa [http://localhost:8081](http://localhost:8081/) **tunnuksilla**: `admin:pass`

Lisää seuraava tiedostoon `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>

### Hoppscotchin käyttöönotto

#### API-pyyntöjen välitys

Ota Hoppscotch käyttöön avaamalla [http://localhost:3000](http://localhost:3000/) ja siirtymällä asetusvälilehdelle. Aseta `Proxy`-arvoksi [http://localhost:9159](http://localhost:9159/), jotta virheenjäljitystyökalusi voivat kommunikoida konttien sisäisten verkkojen kanssa.

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

Nyt voit testata osoitteella [http://web:3000/status](http://web:3000/status), onko web-palvelu käynnissä:

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

<Warning>
  Jos luot **POST**-pyynnön Postmanilla tai muulla virheenjäljitystyökalulla, saatat huomata, että kirjautuminen on **estetty** ja syynä on 401-virhe. Tämä johtuu siitä, että Overleaf on suojattu **CSRF**-tarkistuksella.
</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>

Konsolissa saatat nähdä:

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

Jotta voit käsitellä tämän Overleaf-kehityksessä, sinun on määritettävä CSRF-tunniste. Tässä on yksityiskohtainen ohje.

<Steps>
  <Step title="Lisää esipyyntö">
    Lisää seuraava koodi kohtaan 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>

    Skripti on seuraava:

    ```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="Lisää pyyntöotsakkeet">
    Sinun on lisättävä seuraavat otsakkeet:

    | Otsakkeen nimi | Otsakkeen arvo |
    | - | - |
    | 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="Kirjaudu sisään API-työkaluilla">
    Nyt voit kirjautua sisään käyttäjänimelläsi ja salasanallasi.

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

    Alla on vastaus, kun syötät väärän käyttäjänimen tai salasanan.

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