mirror of
https://github.com/TheAnachronism/docspell.git
synced 2024-11-13 02:31:10 +00:00
48 lines
1.2 KiB
Markdown
48 lines
1.2 KiB
Markdown
+++
|
||
title = "Reset Password (⊗)"
|
||
description = "Resets a user password."
|
||
weight = 120
|
||
+++
|
||
|
||
{% infobubble(mode="info", title="⚠ Please note") %}
|
||
This script is now obsolete, you can use the [**CLI tool**](../cli/) instead.
|
||
|
||
Use the `reset-password` admin command, e.g. `dsc admin reset-password
|
||
--account "smith/john"`, where `smith` is the collective id and `john`
|
||
the username.
|
||
{% end %}
|
||
|
||
|
||
This script can be used to reset a user password. This can be done by
|
||
admins, who know the `admin-endpoint.secret` value in the
|
||
[configuration](@/docs/configure/_index.md#admin-endpoint) file.
|
||
|
||
The script is in `/tools/reset-password/reset-password.sh` and it is
|
||
only a wrapper around the admin endpoint `/admin/user/resetPassword`.
|
||
|
||
## Usage
|
||
|
||
It's very simple:
|
||
|
||
``` bash
|
||
reset-password.sh <base-url> <admin-secret> <account>
|
||
```
|
||
|
||
Three arguments are required to specify the docspell base url, the
|
||
admin secret and the account you want to reset the password.
|
||
|
||
After the password has been reset, the user can login using it and
|
||
change it again in the webapp.
|
||
|
||
|
||
## Example
|
||
|
||
``` json
|
||
❯ ./tools/reset-password/reset-password.sh http://localhost:7880 123 eike
|
||
{
|
||
"success": true,
|
||
"newPassword": "HjtpG9BFo9y",
|
||
"message": "Password updated"
|
||
}
|
||
```
|