Controllare la configurazione della CLI dosya

Controlla la configurazione della CLI prima di indagare su un account, uno spazio di lavoro o un server inatteso. I comandi sicuri oscurano la chiave API salvata e mostrano indirizzo API, spazio di lavoro predefinito e opzioni di sincronizzazione che influenzano le operazioni successive.

Procedura

dosya config path
dosya config get
dosya config get --json

config path mostra ~/.dosya/config.json, a meno che XDG_CONFIG_HOME non lo reindirizzi a $XDG_CONFIG_HOME/dosya/config.json. config get mostra questi valori supportati:

• api_base: server usato per le richieste REST.
• default_workspace: spazio di lavoro usato dai comandi senza contesto esplicito.
• sync_delta: true abilita il caricamento differenziale facoltativo a livello di blocco per le modifiche di sincronizzazione idonee.
• sync_parallel: trasferimenti di sincronizzazione simultanei, 8 per impostazione predefinita e 16 al massimo.

Senza argomenti e in formato JSON, il comando non stampa mai il token; restituisce api_key: "<redacted>" se esiste una chiave salvata. Un nome sconosciuto produce Unknown config key: NAME. Available keys: api_base, default_workspace, sync_delta, sync_parallel.

Determina indirizzo e credenziale effettivi

L’indirizzo API predefinito è https://api.dosya.dev. La precedenza dell’indirizzo effettivo è:

1. DOSYA_API_BASE nell’ambiente del processo.
2. Il valore api_base salvato.
3. Il valore predefinito di produzione incorporato.

La precedenza delle credenziali è diversa:

1. --key o -k nel comando.
2. DOSYA_API_KEY nell’ambiente.
3. api_key nel file di configurazione.

Verifica se la shell usa impostazioni che prevalgono sui valori salvati senza stamparne il contenuto:

if test -n "${DOSYA_API_KEY+x}"; then echo 'DOSYA_API_KEY is set'; else echo 'DOSYA_API_KEY is not set'; fi
if test -n "${DOSYA_API_BASE+x}"; then printf 'DOSYA_API_BASE=%s\n' "$DOSYA_API_BASE"; else echo 'DOSYA_API_BASE is not set'; fi
dosya whoami

dosya whoami verifica la credenziale effettiva. Mostra l’identità dell’account raggiunto con la chiave e l’indirizzo che prevalgono. Un accesso salvato riuscito non garantisce che una shell successiva con una directory home o un valore XDG_CONFIG_HOME diversi legga quel file.

Controlla la risoluzione dello spazio di lavoro

dosya config get default_workspace
dosya ls

Per i normali riferimenti a percorsi, ws_ID:path prevale su --workspace, che prevale su default_workspace. Il valore predefinito riguarda solo i comandi CLI successivi; non cambia lo spazio di lavoro attivo nel browser. Se non riconosci l’elenco, confronta il suo workspace_id in dosya ls --json con l’ID restituito da dosya workspace list.

Modifica solo i valori supportati

dosya config set default_workspace ws_REPLACE_ME
dosya config set api_base https://api.dosya.dev
dosya config set sync_delta true
dosya config set sync_parallel 12

config set richiede una configurazione esistente; altrimenti restituisce Not authenticated. Run: dosya auth login. I valori vengono scritti come stringhe. Dopo aver cambiato contesto, esegui di nuovo config get KEY e un comando senza effetti. Negli script di distribuzione usa --workspace esplicito quando la destinazione deve restare fissa anche se cambia il valore predefinito della macchina.

Non modificare api_key tramite config set: questa chiave è esclusa intenzionalmente da quelle consentite. Usa dosya auth login per salvare l’autenticazione o DOSYA_API_KEY per fornire un segreto tramite l’ambiente.

Proteggi il file di configurazione

Il file contiene la chiave API salvata in chiaro. Su sistemi di tipo Unix, la procedura di accesso crea il file con modalità 0600 in una directory 0700. Se una copia di sicurezza, una copia o un archivio rende meno restrittivi i permessi del file, la CLI mostra un avviso con il percorso e il comando chmod 600 consigliato. Windows non esegue questo controllo dei permessi.

Non allegare il file non oscurato a una richiesta di assistenza. Usa invece dosya config get --json, dosya whoami --json, la riga di comando senza chiave, il codice di uscita e l’output di errore depurato. I registri di debug non devono mai includere DOSYA_API_KEY o un valore letterale di --key.

Risolvi le discrepanze

config get indica che non esiste una configurazione. Verifica la directory home corrente e XDG_CONFIG_HOME, poi esegui dosya auth login per questo ambiente.

Il valore api_base mostrato è di produzione ma le richieste raggiungono un altro server. Controlla DOSYA_API_BASE, che prevale sul file.

whoami mostra un altro account. Rimuovi la chiave specificata nella riga di comando oppure controlla quale DOSYA_API_KEY ha ereditato il processo.

L’account corretto mostra lo spazio di lavoro sbagliato. Controlla il prefisso ws_ID: del percorso e --workspace prima di cambiare il valore predefinito salvato.

Cambiare api_base compromette l’autenticazione. Le chiavi API appartengono al servizio che le ha emesse. Ripristina https://api.dosya.dev, salvo che un ambiente dosya attendibile ti abbia fornito esplicitamente un altro indirizzo.

Risultato previsto

Il percorso di configurazione è noto, la chiave rimane oscurata e dosya whoami insieme a un elenco in sola lettura conferma indirizzo, account e spazio di lavoro effettivi. Le variabili d’ambiente e le opzioni da riga di comando che prevalgono sono intenzionali oppure vengono rimosse prima dei comandi in produzione.

Guide correlate

• Autenticarsi senza esporre un token
• Scegliere e verificare uno spazio di lavoro
• Caricare e scaricare con la CLI