# `spwd` — La base de datos de contraseñas ocultas

Deprecated since version 3.11, will be removed in version 3.13: El módulo `spwd` está obsoleto (consulte PEP 594 para más detalles y alternativas).

Este módulo proporciona acceso a la base de datos de contraseñas ocultas de Unix. Está disponible en varias versiones de Unix.

Availability: not Emscripten, not WASI.

Este módulo no funciona o no está disponible en las plataformas WebAssembly `wasm32-emscripten` y `wasm32-wasi`. Consulte Plataformas WebAssembly para más información.

Debe tener suficientes privilegios para acceder a la base de datos de contraseñas ocultas (esto generalmente significa que debe ser root).

Las entradas de la base de datos de contraseñas ocultas se informan como un objeto similar a una tupla, cuyos atributos corresponden a los miembros de la estructura `spwd` (campo de atributo a continuación, consulte `<shadow.h>`):

Índice | Atributo | Significado
--- | --- | ---
0 | `sp_namp` | Nombre de inicio de sesión
1 | `sp_pwdp` | Contraseña encriptada
2 | `sp_lstchg` | Fecha del último cambio
3 | `sp_min` | Número mínimo de días entre cambios
4 | `sp_max` | Número máximo de días entre cambios
5 | `sp_warn` | Número de días antes de que expire la contraseña para advertir al usuario sobre ello
6 | `sp_inact` | Número de días desde que caduca la contraseña hasta que se deshabilita la cuenta
7 | `sp_expire` | Número de días desde 1970-01-01 cuando expira la cuenta
8 | `sp_flag` | Reservado

Los elementos sp_namp y sp_pwdp son cadenas, todos los demás son números enteros. Se lanza `KeyError` si no se puede encontrar la entrada solicitada.

Se definen las siguientes funciones:

spwd.getspnam(name)

  Retorna la entrada de la base de datos de contraseñas ocultas para el nombre de usuario especificado.

  Distinto en la versión 3.6: Lanza un `PermissionError` en vez de `KeyError` si el usuario no tiene privilegios.

spwd.getspall()

  Retorna una lista de todas las entradas de la base de datos de contraseñas ocultas disponibles, en orden arbitrario.

Ver también

Módulo `grp`

  Una interfaz para la base de datos del grupo, similar a esta.

Módulo `pwd`

  Una interfaz para la base de datos de contraseñas normal, similar a esta.