> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/on-premises/fi/kayttajien-ja-projektien-hallinta/user-management.md).

# Käyttäjähallinta

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

Overleaf Toolkitin käyttöönotot:

{% 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 %}

Perinteiset docker-compose.yml-käyttöönotot:

{% 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 sitä ei vielä ole olemassa, ja tekee hänestä ylläpitäjän. Komennon tuloste sisältää URL-osoitteen, jossa voit asettaa tälle käyttäjälle salasanan ja kirjautua ensimmäistä kertaa sisään.

{% hint style="info" %}
Ohjelmallista lähestymistapaa varten voit käyttää samaa skriptiä sekä tavallisten käyttäjien että ylläpitäjien luomiseen. Tavallisilta käyttäjiltä jätä --admin-lippu pois.
{% endhint %}

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

{% stepper %}
{% step %}

### Hallintakäyttöliittymän kautta

* Kirjaudu sisään olemassa olevana ylläpitäjänä.
* Napsauta Admin -> Manage Users.
* Etsi käyttäjä ja napsauta hänen sähköpostiosoitettaan.
* Vieritä alas Site Admin -osioon ja napsauta (show)-linkkiä.
* Valitse valintaruutu Is Site Admin.
* Viimeistele napsauttamalla Save.
  {% endstep %}
  {% endstepper %}

***

## Käyttäjien poistaminen

Kuten selitetään 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 aiheuttaa sen, että yhteistyökumppanit menettävät pääsyn projekteihin. Tiliä ei tällä hetkellä voi deaktivoida — se joko on olemassa ja sen tiedot säilytetään, tai se poistetaan.

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

{% hint style="info" %}
Tilit poistetaan oletuksena pehmeästi. Katso `ENABLE_CRON_RESOURCE_DELETION` pysyvän poistamisen toimintaa.
{% endhint %}

### Admin -> Manage Users -kohdan kautta

{% stepper %}
{% step %}

* Kirjaudu sisään ylläpitäjänä.
* Napsauta Admin -> Manage Users.
* Etsi käyttäjä ja valitse heidän sähköpostiosoitteensa vieressä oleva valintaruutu.
* Napsauta roskakorikuvaketta.
* Vahvista napsauttamalla Delete.
  {% endstep %}
  {% endstepper %}

### Komentorivin kautta

Käyttäjätilit (ja heidän projektinsa) voidaan poistaa seuraavilla komennoilla.

Overleaf Toolkitin käyttöönotot:

{% 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 %}

Perinteiset docker-compose.yml-käyttöönotot:

{% 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ä poistaminen jatkuu, vaikka tilin poistamista koskevan sähköpostin lähetys epäonnistuisi (esim. kun käyttäjän sähköposti ei ole enää käytössä).
{% endhint %}

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

***

## Pehmeästi poistetun käyttäjän 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 Admin -> Manage Users.
* Etsi käyttäjä, jonka haluat palauttaa.
* Napsauta Display deleted users -painiketta.
* Napsauta poistetun käyttäjän sähköpostiosoitetta.
* Napsauta Recover This Account.
* Vahvista napsauttamalla Recover.
  {% endstep %}
  {% endstepper %}

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

***

## Käyttäjien määrän laskeminen

Voit tarkastella käyttäjien määriä hallintakäyttöliittymässä osoitteessa <https://you-instance-url/admin/user#license>. Ohjelmallisiin tarkistuksiin ja vientiin seuraavat esimerkit voivat auttaa.

Käyttäjiä yhteensä:

{% 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 %}

Käyttäjien kokonaismäärä metrics-päätepisteen avulla:

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

```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: käyttäjät, jotka ovat olleet aktiivisia viimeisen 365 päivän aikana):

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

Se, miten tilin päivitykset tehdään, riippuu siitä, onko SSO käytössä.

* Jos SSO:ta ei käytetä:
  * Ylläpitäjät voivat muokata käyttäjätilin tietoja Admin -> Manage Users -kohdan kautta (sähköposti, etunimi, sukunimi ja salasanan palautuslinkin luonti).
  * Tavalliset käyttäjät voivat päivittää omia tietojaan Account -> Account Settings -kohdassa (mukaan lukien salasanan vaihtaminen ja Git-todennustunnusten luonti).
* Jos SSO:ta käytetään:
  * Server Pro voidaan määrittää päivittämään käyttäjän etu- ja sukunimi kirjautumisen yhteydessä todennusjä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:

* 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äärityssivuihin. 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://overleaf-pro.ayaka.space/on-premises/fi/kayttajien-ja-projektien-hallinta/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.