tawasuyu

tawasuyu/mirada

Sovereign tiling Wayland compositor + window manager in Rust, on Llimphi.

Rust 50Markdown 30TOML 211282 Definitions

⎇ 3dc85ebdcdd5fda0a1be0db5f8fbce5859266f2e shared/auth/auth-core/LEEME.md Markdown · 52 lines · 1.5 KB History raw

feat: mirada standalone — compositor Wayland + WM sobre Llimphi (build magro) 3dc85ebdc · Sergio · 

1# auth-core
2
3Autenticación del escritorio. Contrato `Authenticator` agnóstico del
4backend, con dos implementaciones.
5
6## Para qué
7
8El greeter de carmen (mirada) necesita verificar la contraseña del
9usuario y, en éxito, saber su `uid/gid/home/shell` para arrancar la
10sesión. Eso es exactamente lo que entrega `Authenticator::authenticate`:
11
12```rust
13use brahman_auth::{Authenticator, PamAuthenticator};
14
15let auth = PamAuthenticator::carmen();
16match auth.authenticate("sergio", &password) {
17    Ok(info) => arrancar_sesion(info),      // info: UserInfo
18    Err(e)   => mostrar_error_en_greeter(e),
19}
20```
21
22## Backends
23
24- **`PamAuthenticator`** — verifica contra PAM (`/etc/pam.d/<servicio>`),
25  el mismo subsistema de `login` y `sudo`. Hereda lo que el
26  administrador configure ahí (2FA, FIDO2, `pam_faillock`…) sin que el
27  crate lo sepa.
28- **`MockAuthenticator`** — credenciales fijas en memoria. Para tests y
29  para iterar el greeter en cajas sin PAM configurado.
30
31`AuthError` es deliberadamente grueso: el greeter sólo distingue
32"reintentá" (`BadCredentials`) de "cuenta vetada" (`AccountUnavailable`),
33y nunca puede saber si un usuario existe.
34
35## Servicio PAM
36
37`data/carmen` es el archivo de servicio. Instalarlo:
38
39```sh
40install -Dm644 data/carmen /etc/pam.d/carmen
41```
42
43Ajustar el `include` a la pila de login de la distribución (ver los
44comentarios del archivo).
45
46## Probar contra PAM en una máquina real
47
48```sh
49cargo run -p auth-core --example auth-probe -- "$USER" login
50```
51
52Pide la contraseña sin eco e informa el `UserInfo` resuelto.

LEEME.md

auth-core

Autenticación del escritorio. Contrato Authenticator agnóstico del backend, con dos implementaciones.

Para qué

El greeter de carmen (mirada) necesita verificar la contraseña del usuario y, en éxito, saber su uid/gid/home/shell para arrancar la sesión. Eso es exactamente lo que entrega Authenticator::authenticate:

use brahman_auth::{Authenticator, PamAuthenticator};

let auth = PamAuthenticator::carmen();
match auth.authenticate("sergio", &password) {
    Ok(info) => arrancar_sesion(info),      // info: UserInfo
    Err(e)   => mostrar_error_en_greeter(e),
}

Backends

AuthError es deliberadamente grueso: el greeter sólo distingue "reintentá" (BadCredentials) de "cuenta vetada" (AccountUnavailable), y nunca puede saber si un usuario existe.

Servicio PAM

data/carmen es el archivo de servicio. Instalarlo:

install -Dm644 data/carmen /etc/pam.d/carmen

Ajustar el include a la pila de login de la distribución (ver los comentarios del archivo).

Probar contra PAM en una máquina real

cargo run -p auth-core --example auth-probe -- "$USER" login

Pide la contraseña sin eco e informa el UserInfo resuelto.