Documentazione

CLI/auth

renamed auth

Autenticazione OAuth sicura. Le Sue credenziali non toccano mai la cronologia della shell o le variabili d'ambiente.

renamed auth <command>

Il comando auth gestisce l'autenticazione utilizzando il flusso OAuth per dispositivi. Apre il Suo browser per un accesso sicuro — nessuna chiave API da copiare o segreti da esporre.

I token vengono memorizzati criptati nel portachiavi del Suo sistema (macOS Keychain, Linux libsecret, Windows Credential Manager), non in file di testo normale.

Sottocomandi

login

Autenticati con il Suo account renamed.to tramite browser (flusso OAuth per dispositivi).

token

Memorizza un token API manualmente. Utile per ambienti CI/CD.

logout

Rimuovi le credenziali memorizzate dal portachiavi.

whoami

Visualizza l'utente attualmente autenticato.

status

Controlla lo stato dell'autenticazione e i crediti rimanenti.

refresh

Aggiorna manualmente un token scaduto.

Esempi

Accedi (apre il browser):

$ renamed auth login

Apertura del browser per l'autenticazione...
In attesa dell'approvazione...
✓ Autenticato con successo come alex@example.com

Controlla lo stato e i crediti rimanenti:

$ renamed auth status

Connesso come: alex@example.com
Token scade: 2026-02-08 14:30:00
Crediti rimanenti: 847

Accesso senza interfaccia grafica (browser non disponibile):

$ renamed auth login --no-open

Visiti questo URL per l'autenticazione:
https://renamed.to/device?code=ABCD-1234

Memorizza un token manualmente (CI/CD):

$ renamed auth token --token rnt_abc123...

✓ Token memorizzato con successo

Controlla con quale account sei connesso:

$ renamed auth whoami

alex@example.com

Esci:

$ renamed auth logout

✓ Disconnesso con successo

Opzioni di Login

--no-open

Non aprire automaticamente il browser. Visualizza un URL da visitare su un altro dispositivo.

--client-id <id>

ID client OAuth personalizzato per SSO aziendale.

--client-secret <secret>

Secret client OAuth personalizzato per SSO aziendale.

--scope <scopes>

Elenco separato da virgole di scope OAuth da richiedere.

Opzioni Token

-t, --token <token>

Il token API da memorizzare.

-s, --scheme <scheme>

Schema di autorizzazione (predefinito: Bearer).

--non-interactive

Non richiedere input. Esci con errore se il token manca.

Memorizzazione Token

macOS — Keychain Access

Linux — libsecret (GNOME Keyring, KWallet)

Windows — Credential Manager

Variabili d'Ambiente

RENAMED_TOKEN — Token API per l'autenticazione (alternativa a auth token)

RENAMED_CLIENT_ID — ID client OAuth personalizzato per SSO aziendale

RENAMED_CLIENT_SECRET — Secret client OAuth personalizzato per SSO aziendale

Suggerimenti

Prima dell'installazione come servizio — Esegua sempre renamed auth login prima di renamed service install. Il servizio necessita di credenziali memorizzate per funzionare.

Server senza interfaccia grafica — Utilizzi --no-open su server senza display. Copi l'URL e si autentichi da qualsiasi dispositivo con un browser.

Ambienti CI/CD — Utilizzi la variabile d'ambiente RENAMED_TOKEN o il comando auth token.

Scadenza token — I token si aggiornano automaticamente. Se visualizza errori di autenticazione, esegua renamed auth refresh o acceda nuovamente.

Vedi Anche

service — distribuisci come servizio systemd watch — monitora cartelle per nuovi file