WebDAV sync support, access tokens, REST control endpoints #10
@@ -45,7 +45,7 @@ The server remembers its settings in the config folder (default `~/.local/share/
|
|||||||
|
|
||||||
## Authentication
|
## Authentication
|
||||||
|
|
||||||
Cista supports two authenticatioon mode, each of which supporting ordinary and privileged users. Either one can be combined with the public mode.
|
Cista supports two authentication modes, each supporting ordinary and privileged users. Either one can be combined with the public mode.
|
||||||
|
|
||||||
### Public Mode
|
### Public Mode
|
||||||
|
|
||||||
@@ -83,6 +83,28 @@ In Paskia mode:
|
|||||||
- Users with `cista:login` permission can access files
|
- Users with `cista:login` permission can access files
|
||||||
- Users with `cista:admin` permission get privileged access (Admin Settings)
|
- Users with `cista:admin` permission get privileged access (Admin Settings)
|
||||||
|
|
||||||
|
## WebDAV Access
|
||||||
|
|
||||||
|
Cista supports WebDAV, so you can mount it as a network drive or browse it directly from your operating system's file manager.
|
||||||
|
|
||||||
|
Connect to `http://cista.example.com/files/` (or `https://...`).
|
||||||
|
|
||||||
|
### Authentication
|
||||||
|
|
||||||
|
- **Standard users:** Use your username and password with Basic auth.
|
||||||
|
- **API tokens:** For scripts, backup tools, or when your client requires NTLM (e.g. Windows File Explorer), create a token in the web interface via **🔑 API Tokens**. Authenticate with username `token` and the token secret as the password.
|
||||||
|
|
||||||
|
### Supported clients
|
||||||
|
|
||||||
|
| Client | Setup |
|
||||||
|
|--------|-------|
|
||||||
|
| **Windows File Explorer** | Map Network Drive → `http://cista.example.com/files/` (or Add a network location). Windows may try NTLM first; API tokens are recommended. |
|
||||||
|
| **macOS Finder** | Go → Connect to Server (⌘K) → `http://cista.example.com/files/` |
|
||||||
|
| **Linux (GNOME/KDE)** | Enter `dav://cista.example.com/files/` or `webdav://cista.example.com/files/` in the location bar |
|
||||||
|
| **Cyberduck, WinSCP, rclone** | Standard WebDAV profile with Basic auth |
|
||||||
|
|
||||||
|
**Note on Windows NTLM:** Windows WebDAV clients often require NTLM authentication, which is incompatible with Cista's Argon2 password hashes. API tokens solve this — Cista uses the token secret as the NTLM password.
|
||||||
|
|
||||||
### Internet Access
|
### Internet Access
|
||||||
|
|
||||||
Most admins find the [Caddy](https://caddyserver.com/) web server convenient for its auto TLS certificates and all. A proxy also allows running multiple web services or Cista instances on the same IP address but different (sub)domains.
|
Most admins find the [Caddy](https://caddyserver.com/) web server convenient for its auto TLS certificates and all. A proxy also allows running multiple web services or Cista instances on the same IP address but different (sub)domains.
|
||||||
|
|||||||
Reference in New Issue
Block a user