> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/fi/kayttaja-ja-projektinhallinta/user-management.md).

# Käyttäjien hallinta

## Ylläpitäjäkäyttäjän luominen

Overleaf Toolkit -asennukset:

{% code title="Overleaf Toolkit" overflow="wrap" %}

```bash
$ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user --admin --email=joe@example.com"
```

{% endcode %}

Perinteinen docker-compose.yml -asennukset:

{% code title="Perinteinen docker-compose" overflow="wrap" %}

```bash
$ docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user --admin --email=joe@example.com"
```

{% endcode %}

Komento luo käyttäjän annetulla sähköpostiosoitteella, jos sellaista ei vielä ole olemassa, ja tekee hänestä ylläpitäjän. Komennon tuloste sisältää URL-osoitteen, jossa voit asettaa tämän käyttäjän salasanan ja kirjautua sisään ensimmäistä kertaa.

{% hint style="info" %}
Ohjelmallisessa lähestymistavassa voit käyttää samaa skriptiä tavallisten käyttäjien sekä ylläpitäjien luomiseen. Tavallisia käyttäjiä varten jätä --admin-lippu pois.
{% endhint %}

Jos käytät tunnistautumiseen sisäisiä tilejä ja sinun täytyy korottaa olemassa oleva käyttäjä instanssin ylläpitäjäksi tai peruuttaa ylläpitäjäoikeudet, toimi seuraavasti:

{% stepper %}
{% step %}

### Ylläpitoliittymän kautta

* Kirjaudu sisään olemassa olevana ylläpitäjänä.
* Napsauta Ylläpito -> Hallitse käyttäjiä.
* Etsi käyttäjä ja napsauta hänen sähköpostiosoitettaan.
* Vieritä alas Sivuston ylläpitäjä -osioon ja napsauta (näytä) -linkkiä.
* Valitse ruutu On sivuston ylläpitäjä.
* Viimeistele napsauttamalla Tallenna.
  {% endstep %}
  {% endstepper %}

***

## Käyttäjien poistaminen

Kuten on selitetty oppaassamme [lisenssin käytön ymmärtämisestä](broken://pages/1e737f2974ac66de69b7aecb637b208a5b70bb9d), on yleensä suositeltavaa olla poistamatta tilejä, ellei niitä enää tarvita. Tilin poistaminen poistaa tilin ja estää yhteistyökumppaneita pääsemästä projekteihin. Tiliä ei tällä hetkellä voi poistaa käytöstä — joko se on olemassa ja sen tiedot säilytetään, tai se poistetaan.

Oletusarvoisesti tilit poistetaan pehmeästi. Tietoja käyttäjien pysyvästä poistamisesta instanssistasi on kohdassa `ENABLE_CRON_RESOURCE_DELETION` tiedostossa [Ympäristömuuttujat](broken://pages/21973f574b41e6ba323df98d218222a9b2512364) opas.

{% hint style="info" %}
Tilit poistetaan oletusarvoisesti pehmeästi. Katso `ENABLE_CRON_RESOURCE_DELETION` pysyvän poiston käytöstä.
{% endhint %}

### Ylläpito -> Hallitse käyttäjiä

{% stepper %}
{% step %}

* Kirjaudu sisään ylläpitäjänä.
* Napsauta Ylläpito -> Hallitse käyttäjiä.
* Etsi käyttäjä ja valitse heidän sähköpostiosoitteensa vieressä oleva valintaruutu.
* Napsauta roskakorikuvaketta.
* Vahvista napsauttamalla Poista.
  {% endstep %}
  {% endstepper %}

### Komentorivin kautta

Käyttäjätilit (ja niiden projektit) voidaan poistaa seuraavilla komennoilla.

Overleaf Toolkit -asennukset:

{% code title="Overleaf Toolkit" %}

```bash
$ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/delete-user.mjs --email=joe@example.com"
```

{% endcode %}

Perinteinen docker-compose.yml -asennukset:

{% code title="Perinteinen docker-compose" %}

```bash
$ docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/delete-user.mjs --email=joe@example.com"
```

{% endcode %}

{% hint style="danger" %}
Poistoskripti käyttää kovakoodattua force-valitsinta, joka varmistaa, että poisto etenee, vaikka tilin poistamiseen liittyvän sähköpostin lähettäminen epäonnistuu (esim. kun käyttäjän sähköpostiosoite ei ole enää käytössä).
{% endhint %}

{% hint style="info" %}
Versiosta 5.5.0 alkaen --skip-email-valitsinta voidaan käyttää estämään informatiivisen sähköpostin lähettäminen poistetulle käyttäjälle.
{% endhint %}

***

## Pehmeästi poistettujen käyttäjien palauttaminen

Jos käyttäjä on poistettu vain pehmeästi, voit palauttaa hänen tilinsä ja projektinsa.

{% stepper %}
{% step %}

* Kirjaudu sisään ylläpitäjänä.
* Napsauta Ylläpito -> Hallitse käyttäjiä.
* Etsi käyttäjä, jonka haluat palauttaa.
* Napsauta Näytä poistetut käyttäjät -painiketta.
* Napsauta poistetun käyttäjän sähköpostiosoitetta.
* Napsauta Palauta tämä tili.
* Vahvista napsauttamalla Palauta.
  {% endstep %}
  {% endstepper %}

{% hint style="danger" %}
Kun ENABLE\_CRON\_RESOURCE\_DELETION on asetettu arvoon true, pehmeästi poistetut tilit voidaan palauttaa 90 päivän ajan. 90 päivän jälkeen tilin palauttaminen ei ole mahdollista.
{% endhint %}

***

## Käyttäjien laskeminen

Voit saada käyttäjämäärät ylläpitoliittymän kautta osoitteessa <https://you-instance-url/admin/user#license>. Ohjelmallisiin tarkistuksiin ja vientiin seuraavat esimerkit voivat olla hyödyksi.

Käyttäjien kokonaismäärä:

{% code title="Käyttäjien kokonaismäärä" %}

```bash
echo 'db.users.countDocuments()' | docker exec -i mongo mongosh --quiet localhost/sharelatex
# overleaf [direct: primary] sharelatex> 16
```

{% endcode %}

Metriikka-päätepisteen kautta laskettujen käyttäjien kokonaismäärä:

{% code title="Aktiivisten käyttäjien määrä metriikoista" %}

```bash
docker exec sharelatex curl http://127.0.0.1:3000/metrics | grep num_active_users
# # HELP num_active_users num_active_users
# # TYPE num_active_users gauge
# num_active_users{app="web-api",host="b3ae4ff549d8"} 16
```

{% endcode %}

Aktiivisten käyttäjien kokonaismäärä (esimerkki: viimeisten 365 päivän aikana aktiiviset käyttäjät):

{% code title="Aktiivisten käyttäjien kokonaismäärä" %}

```bash
echo 'db.users.countDocuments({ lastActive: { $gte: new Date(new Date().getTime() - (365 * 24 * 60 * 60 * 1000)) } })' | docker exec -i mongo mongosh --quiet localhost/sharelatex
# overleaf [direct: primary] sharelatex> 10
```

{% endcode %}

***

## Käyttäjätilin tietojen päivittäminen

Tilipäivitysten tekemistapa riippuu siitä, onko SSO käytössä.

* Jos SSO:ta ei käytetä:
  * Ylläpitäjät voivat muokata käyttäjätilin tietoja Ylläpito -> Hallitse käyttäjiä -kohdassa (sähköposti, etunimi, sukunimi ja salasanan nollauslinkin luonti).
  * Tavalliset käyttäjät voivat päivittää omia tietojaan Kohdassa Tili -> Tiliasetukset (mukaan lukien salasanan vaihtaminen ja Git-tunnistautumistunnusten luonti).
* Jos SSO:ta käytetään:
  * Server Pro voidaan määrittää päivittämään käyttäjän etu- ja sukunimi kirjautumisen aikana tunnistautumisjärjestelmän perusteella.
  * Kun OVERLEAF\_SAML\_UPDATE\_USER\_DETAILS\_ON\_LOGIN tai OVERLEAF\_LDAP\_UPDATE\_USER\_DETAILS\_ON\_LOGIN on asetettu arvoon true, käyttäjätietolomake osoitteessa <https://your-instance-url/user/settings> on poistettu käytöstä, ja etu-/sukunimi voidaan asettaa vain identiteetinhallintajärjestelmässäsi.

Lisätietoja on kohdassa:

* SAML 2.0 -määritys: <https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/saml-2.0>
* LDAP-määritys: <https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/ldap>

***

Päivitetty viimeksi 4 kuukautta sitten

Tämä dokumentaatiosivu sisältää linkkejä ulkoisiin oppaisiin ja määrityssivuille. Kaikki linkit ja kyselyparametrit säilytetään alkuperäisen sisällön mukaisina.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/fi/kayttaja-ja-projektinhallinta/user-management.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.