Documentación

CLI/auth

renamed auth

Autenticación OAuth segura. Sus credenciales nunca tocan el historial del shell ni las variables de entorno.

renamed auth <command>

El comando auth gestiona la autenticación usando el flujo de dispositivo OAuth. Abre su navegador para un inicio de sesión seguro — sin claves API para copiar ni secretos que exponer.

Los tokens se almacenan cifrados en el llavero de su sistema (macOS Keychain, Linux libsecret, Windows Credential Manager), no en archivos de texto plano.

Subcomandos

login

Autentíquese con su cuenta renamed.to a través del navegador (flujo de dispositivo OAuth).

token

Almacene un token API manualmente. Útil para entornos CI/CD.

logout

Elimine las credenciales almacenadas del llavero.

whoami

Muestre el usuario autenticado actualmente.

status

Verifique el estado de autenticación y los créditos restantes.

refresh

Actualice manualmente un token expirado.

Ejemplos

Iniciar sesión (abre el navegador):

$ renamed auth login

Abriendo navegador para autenticación...
Esperando aprobación...
✓ Autenticado exitosamente como alex@example.com

Verificar estado y créditos restantes:

$ renamed auth status

Conectado como: alex@example.com
Token expira: 2026-02-08 14:30:00
Créditos restantes: 847

Inicio de sesión sin interfaz gráfica (navegador no disponible):

$ renamed auth login --no-open

Visite esta URL para autenticarse:
https://renamed.to/device?code=ABCD-1234

Almacenar un token manualmente (CI/CD):

$ renamed auth token --token rnt_abc123...

✓ Token almacenado exitosamente

Verificar con quién ha iniciado sesión:

$ renamed auth whoami

alex@example.com

Cerrar sesión:

$ renamed auth logout

✓ Sesión cerrada exitosamente

Opciones de Login

--no-open

No abra el navegador automáticamente. Genera una URL para visitar en otro dispositivo.

--client-id <id>

ID de cliente OAuth personalizado para SSO empresarial.

--client-secret <secret>

Secreto de cliente OAuth personalizado para SSO empresarial.

--scope <scopes>

Lista de alcances OAuth separados por comas para solicitar.

Opciones de Token

-t, --token <token>

El token API a almacenar.

-s, --scheme <scheme>

Esquema de autorización (predeterminado: Bearer).

--non-interactive

No solicite entrada. Salga con error si falta el token.

Almacenamiento de Tokens

macOS — Keychain Access

Linux — libsecret (GNOME Keyring, KWallet)

Windows — Credential Manager

Variables de Entorno

RENAMED_TOKEN — Token API para autenticación (alternativa a auth token)

RENAMED_CLIENT_ID — ID de cliente OAuth personalizado para SSO empresarial

RENAMED_CLIENT_SECRET — Secreto de cliente OAuth personalizado para SSO empresarial

Consejos

Antes de instalar como servicio — Siempre ejecute renamed auth login antes de renamed service install. El servicio necesita credenciales en caché para operar.

Servidores sin interfaz gráfica — Use --no-open en servidores sin pantalla. Copie la URL y autentíquese desde cualquier dispositivo con navegador.

Entornos CI/CD — Use la variable de entorno RENAMED_TOKEN o el comando auth token.

Expiración del token — Los tokens se actualizan automáticamente. Si ve errores de autenticación, ejecute renamed auth refresh o inicie sesión nuevamente.

Ver También

service — implementar como servicio systemd watch — monitorear carpetas para nuevos archivos