Files
Warp/server/cmd/warp/createaccount.go
T
tajniak81andClaude Opus 5 6004bb01de
CI / Test (ubuntu-latest) (push) Canceled after 0s
CI / Test (windows-latest) (push) Canceled after 0s
CI / Storage tests on PostgreSQL (push) Canceled after 0s
CI / Complement (federation off) (push) Canceled after 0s
CI / golangci-lint (push) Canceled after 0s
CI / Smoke test the binary (push) Canceled after 0s
Phase 1: accounts and sessions
Implements PLAN.md Phase 1. A client can now register, log in, manage its
devices and set its profile; an operator can create accounts and flip the
runtime switches. There are still no rooms and no real /sync.

userapi: accounts, argon2id passwords in PHC format, devices, access and
refresh tokens stored as SHA-256 hashes, account data and the admin flag.
Its storage interface is storage.UserStore, implemented once in sqlstore
with `?` placeholders; the postgres driver supplies a rebind function and
unique-violation recognition rather than keeping a second copy of thirty
statements. Timestamps in these tables are int64 milliseconds, the unit the
Client-Server API uses on the wire.

Client-Server API: register (user-interactive auth with m.login.dummy and
optional registration tokens), register/available, token validity, login
with m.login.password, logout, logout/all, refresh, account/whoami,
capabilities, devices/* with password-gated deletion, profile/*, global and
per-room account data.

GET /sync is a deliberate placeholder: it answers a valid token with an
empty but well-formed response and refuses a revoked one. Phase 1 has no
rooms, so that is the whole truth, and it is what makes session revocation
observable. Phase 4 replaces it with the syncapi.

Auth middleware resolves a bearer token (header or the legacy query
parameter) to a device and user, answering an expired token with the soft
logout the spec asks for. Rate limiting is a token bucket per endpoint class
keyed on the client address, returning M_LIMIT_EXCEEDED with retry_after_ms.

adminapi v1 under /_warp/admin/v1: admin-only auth via a normal Matrix
token, GET/PUT /federation and /registration driving internal/settings and
reporting a config-pinned switch as a 409, GET/POST /users, GET /stats.

warp create-account [--admin] creates the first account straight in the
database, so a new install with registration off has a way in.

Complement is wired up for the federation=off profile: an image meeting its
contract, an entrypoint that configures Warp entirely from WARP_*
variables, and a runner that builds, clones and executes the target set
(TestRegistration, TestLogin, TestDeviceManagement). It has not been run
yet -- there is no container runtime on the development machine -- so the
three tests' assertions were read from the Complement sources and pinned as
httptest tests instead, and CI gained a job that runs the real thing.

Also fixes a .gitignore bug from Phase 0: the unanchored `warp` pattern,
meant for the built binary, also matched the directory server/cmd/warp and
silently excluded the entire command package from the repository. The
binary patterns are now anchored to the repository root, and cmd/warp is
committed for the first time.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-10-15 18:18:37 +02:00

176 lines
5.2 KiB
Go

package main
import (
"bufio"
"context"
"errors"
"fmt"
"log/slog"
"os"
"strings"
"golang.org/x/term"
"github.com/dariuszjaniak/warp/server/internal/config"
"github.com/dariuszjaniak/warp/server/internal/storage"
"github.com/dariuszjaniak/warp/server/internal/userapi"
)
// runCreateAccount implements `warp create-account`.
//
// It talks to the database directly rather than to a running server, so the
// first account on a fresh install can be made before anything is listening
// and without turning registration on. That is the whole point of it: a
// private homeserver with registration off still needs a first admin.
func runCreateAccount(ctx context.Context, args []string) error {
fs := newFlagSet("create-account")
loadConfig := addConfigFlag(fs)
username := fs.String("username", "", "localpart of the new user, e.g. alice")
password := fs.String("password", "", "password (prompted for if omitted)")
passwordFile := fs.String("password-file", "", "read the password from this file instead of prompting")
displayName := fs.String("display-name", "", "profile display name (default: none)")
admin := fs.Bool("admin", false, "give the account the server administrator flag")
if err := fs.Parse(args); err != nil {
return err
}
if *username == "" {
return errors.New("create-account: --username is required")
}
if *password != "" && *passwordFile != "" {
return errors.New("create-account: pass either --password or --password-file, not both")
}
cfg, err := loadConfig()
if err != nil {
return err
}
log, err := newLogger(cfg)
if err != nil {
return err
}
slog.SetDefault(log)
secret, err := resolvePassword(*password, *passwordFile)
if err != nil {
return err
}
db, err := openDatabase(ctx, cfg, log)
if err != nil {
return err
}
defer func() { _ = db.Close() }()
// The schema has to be there before an account can be written. Running
// the migrations here rather than erroring out means the documented
// first-run sequence works whatever order the operator does it in.
if err := db.Migrate(ctx); err != nil {
return fmt.Errorf("migrate database: %w", err)
}
users, err := userapi.New(userapi.Options{
ServerName: cfg.Global.ServerName,
Store: db.Users(),
Logger: log,
})
if err != nil {
return err
}
account, err := users.CreateAccount(ctx, userapi.NewAccountRequest{
Localpart: *username,
Password: secret,
DisplayName: *displayName,
Admin: *admin,
})
switch {
case errors.Is(err, userapi.ErrUserExists):
return fmt.Errorf("%s already exists", users.UserID(userapi.NormaliseLocalpart(*username)))
case err != nil:
return err
}
fmt.Printf("created %s\n", users.UserID(account.Localpart))
if account.Admin {
fmt.Println(" server administrator: yes")
}
if secret == "" {
fmt.Println(" no password set: this account cannot log in until one is")
}
return nil
}
// openDatabase opens the storage driver named in the config.
func openDatabase(ctx context.Context, cfg *config.Config, log *slog.Logger) (storage.Database, error) {
return storage.Open(ctx, storage.Config{
Driver: cfg.Database.Driver,
ConnectionString: cfg.Database.ConnectionString,
MaxOpenConns: cfg.Database.MaxOpenConns,
MaxIdleConns: cfg.Database.MaxIdleConns,
ConnMaxLifetime: cfg.Database.ConnMaxLifetime,
}, log)
}
// resolvePassword settles where the password comes from.
//
// An interactive prompt is the default because a password on the command
// line is a password in the shell history and in the process list of every
// other user on the machine. --password is kept for scripts that have
// already dealt with that, and --password-file for the ones that have not.
func resolvePassword(flagValue, file string) (string, error) {
if flagValue != "" {
return flagValue, nil
}
if file != "" {
data, err := os.ReadFile(file)
if err != nil {
return "", fmt.Errorf("read password file: %w", err)
}
secret := strings.TrimRight(string(data), "\r\n")
if secret == "" {
return "", fmt.Errorf("password file %s is empty", file)
}
return secret, nil
}
return promptForPassword()
}
// promptForPassword reads a password twice without echoing it.
//
// When stdin is not a terminal — a pipe in a container entrypoint, say —
// one line is read instead, with no confirmation, because there is nobody
// there to mistype it.
func promptForPassword() (string, error) {
if !term.IsTerminal(int(os.Stdin.Fd())) {
line, err := bufio.NewReader(os.Stdin).ReadString('\n')
if err != nil && line == "" {
return "", fmt.Errorf("read password from standard input: %w", err)
}
secret := strings.TrimRight(line, "\r\n")
if secret == "" {
return "", errors.New("no password given on standard input")
}
return secret, nil
}
fmt.Print("Password: ")
first, err := term.ReadPassword(int(os.Stdin.Fd()))
fmt.Println()
if err != nil {
return "", fmt.Errorf("read password: %w", err)
}
fmt.Print("Confirm: ")
second, err := term.ReadPassword(int(os.Stdin.Fd()))
fmt.Println()
if err != nil {
return "", fmt.Errorf("read password: %w", err)
}
if string(first) != string(second) {
return "", errors.New("the passwords do not match")
}
if len(first) == 0 {
return "", errors.New("the password must not be empty")
}
return string(first), nil
}