Creare una credenziale dosya in n8n

Il nodo community dosya ha un solo campo obbligatorio per la credenziale: API Key. Memorizza un token dosya dos_… come password, lo invia come Authorization: Bearer solo a https://api.dosya.dev e lo verifica con GET /api/me.

Prima di creare la credenziale

• Installa o scegli prima il nodo community n8n-nodes-dosya. La versione del pacchetto nel repository è 0.1.1, compilata e testata con n8n 2.42 (n8n-workflow 2.42.4) e Node.js 22.
• Usa una chiave separata con un nome che identifichi n8n, così la rotazione non interrompe un altro strumento. Il piano gratuito consente 3 chiavi API per utente; tutti gli account hanno un limite massimo di 20 e le chiavi scadute continuano a contare finché non vengono revocate.
• Prepara l’archivio crittografato delle credenziali n8n prima di generare il token. dosya mostra la chiave API completa una sola volta.
• Il nodo attuale richiede Accesso completo per tutte le sue operazioni. Una chiave in sola lettura può autenticarsi ma non supera la verifica della credenziale; una chiave per il solo caricamento non supera il test dell’account né può eseguire operazioni di lettura.

Passaggi

1. In dosya apri il menu dell’account, scegli Profilo, poi Chiavi API e Crea una chiave API.
2. Inserisci un valore identificativo in A cosa serve?, per esempio n8n production uploads. Il nome della chiave può contenere al massimo 64 caratteri.
3. In Cosa può fare? scegli Accesso completo. In Restrizioni e scadenza imposta Protocolli su Solo quelli che scelgo e seleziona API REST.
4. Se vuoi, scegli uno Spazio di lavoro a cui vincolare la credenziale. Lascia vuoto l’ancoraggio alla cartella: le chiavi ancorate a una cartella sono accettate solo da WebDAV e S3, quindi il nodo REST n8n le rifiuta.
5. Imposta una scadenza ed eventuali controlli su IP, orari attivi o utilizzo che l’host n8n possa rispettare. Il vincolo a uno spazio di lavoro restringe la chiave; non concede al proprietario permessi superiori al suo ruolo in quello spazio.
6. Scegli Genera la chiave, copia il token completo dalla finestra che conferma che la chiave è pronta e conservalo in modo riservato prima di scegliere Fatto.
7. In n8n crea una credenziale di tipo dosya.dev API. Incolla il token in API Key. Non inserire mai la password dell’account dosya in questo campo.
8. Salva la credenziale ed esegui il test di n8n. Il test chiama subito https://api.dosya.dev/api/me e invia la versione del nodo nel suo User-Agent.

Risultato previsto

n8n segnala che la verifica della credenziale è riuscita e la credenziale salvata è disponibile per i nodi dosya. Il test conferma che la chiave è accettata e ha accesso completo; non garantisce che ogni spazio di lavoro o cartella scelti, limite del piano o ruolo del membro consentano un’azione successiva.

In dosya la riga della chiave mostra nome, Accesso completo, API REST, ambito di accesso, scadenza e ultimo utilizzo. n8n conserva il segreto; dosya mantiene solo un identificatore parziale e non può più mostrare il token completo.

Errori specifici e risoluzione

Risultato	Cosa cambiare
This key is read-only. Uploads, folders and share links need a key with Full access scope.	Crea una chiave sostitutiva con accesso completo; modificare n8n non può ampliare quella esistente.
dosya.dev did not accept the API key	Controlla se il token è incompleto, revocato o scaduto. Generane uno sostitutivo se hai perso il valore mostrato una sola volta.
This API key is anchored at a folder and can only be used over WebDAV or the S3 gateway	Ricrea la chiave senza ancoraggio alla cartella. Un vincolo a uno spazio di lavoro è compatibile con questo nodo.
The free plan allows 3 API keys. Delete one or upgrade for more.	Revoca una chiave inutilizzata o scaduta prima di generarne un’altra.
Maximum of 20 API keys reached	Rimuovi una credenziale obsoleta dall’elenco a livello di account.
Name must be 64 characters or less	Abbrevia A cosa serve? e invia di nuovo.

La revoca della chiave è irreversibile. Una verifica riuscita della chiave API può restare nella cache fino a 5 minuti, incluso un livello di memoria nell’isolato di 30 secondi. Crea e verifica prima la chiave sostitutiva, aggiorna i flussi interessati, revoca la vecchia riga e riprova dopo cinque minuti. Se un token compare in log, screenshot o dati del flusso, ruotalo invece di affidarti all’eliminazione della copia esposta.

Guide correlate

• Connettere Zapier
• Connettere n8n