Risolvere problemi di autenticazione e accesso S3 di dosya

Conserva codice e messaggio completi dell’errore S3, stato HTTP e ora della richiesta prima di modificare il profilo del client. L’autenticazione è valutata prima di permesso del protocollo, vincolo allo spazio di lavoro, appartenenza, ancoraggio della cartella, ruolo e criteri di caricamento; correggere un livello può quindi mostrare un altro rifiuto.

Passaggi

Copia i valori attuali da Integrazioni → S3 e dalla riga della chiave API corrispondente:

Campo del client	Valore richiesto
Endpoint	https://api.dosya.dev/s3
Regione	us-east-1
Firma	AWS Signature Version 4
Indirizzamento	Path; forcePathStyle: true nell’SDK AWS per JavaScript
Chiave di accesso	L’ID generato che inizia con DOSYA, non la chiave API dos_…
Chiave segreta	Il segreto S3 di 40 caratteri associato a quell’ID di accesso
Bucket	L’ID esatto dello spazio di lavoro, ad esempio ws_example, non il suo nome

Non inserire il bucket nel nome host. Una chiave limitata a una cartella mantiene l’ID dello spazio di lavoro come bucket e interpreta le chiavi degli oggetti relativamente alla cartella di ancoraggio. Se l’ancoraggio è Projects, la chiave dell’oggetto checks/a.txt raggiunge Projects/checks/a.txt; aggiungere di nuovo Projects/ cerca nel percorso annidato sbagliato.

Il segreto S3 non può essere recuperato in seguito. Se il segreto salvato nel client è perso, una riga che mostra La chiave segreta non può essere recuperata. Per sostituirla, revoca e ricrea la chiave. richiede una nuova chiave e coppia di credenziali. Aggiorna i client dipendenti, verifica la sostituta e revoca la vecchia chiave. La revoca è permanente ma non elimina i file.

Individuare la risposta esatta

Risultato S3	Possibile causa	Soluzione
InvalidAccessKeyId / The access key ID does not exist	ID di accesso errato, chiave revocata o scaduta oppure chiave dos_… incollata	Copia l’ID di accesso DOSYA… dalla riga corretta. Crea una coppia sostitutiva se la riga non è più attiva.
SignatureDoesNotMatch / The request signature does not match	Il segreto non corrisponde all’ID di accesso oppure il client ha firmato endpoint, percorso o query diversi	Reinserisci segreto associato, endpoint, regione e opzione path; scarta la richiesta fallita e lascia che l’SDK ne firmi una nuova.
AccessDenied / This API key is not permitted to use the S3 gateway	La restrizione dei protocolli della chiave esclude S3	Crea o sostituisci la chiave scegliendo Gateway S3 in Protocolli.
This API key is pinned to a different workspace	Il bucket non corrisponde allo spazio di lavoro vincolato alla chiave	Usa l’ID del bucket mostrato per lo spazio di lavoro vincolato oppure crea una chiave diversa con un vincolo ristretto.
This role is not permitted to use the S3 gateway	Il ruolo del membro non ha il permesso di accesso S3	Chiedi al proprietario o amministratore dello spazio di lavoro di concedere il permesso S3 al ruolo. Una chiave più ampia non può superare il ruolo.
NoSuchBucket, oggetto mancante o elenco inatteso vuoto	ID dello spazio di lavoro errato, percorso relativo alla cartella, limitazione del membro, stato nascosto o bloccato oppure cestino	Elenca il bucket o la radice consentiti e costruisci il percorso dai nomi restituiti. Confronta con File di dosya nell’account del proprietario della chiave.
Upload not allowed, Creating folders is not allowed o Object is locked	Permessi della chiave o del ruolo negano l’operazione oppure la destinazione è bloccata	Scegli un’operazione o destinazione consentita; non ampliare la chiave prima di aver verificato il ruolo dell’utente.
EntityTooLarge	L’oggetto supera un criterio di dimensione dei file o un limite attivo di chiave o ruolo	Leggi il messaggio restituito, usa un file accettato oppure chiedi a un amministratore autorizzato di cambiare il limite effettivo.
QuotaExceeded	Lo spazio di lavoro non ha spazio di archiviazione disponibile sufficiente	Libera spazio o aumenta la quota prima di avviare un altro caricamento multipart.
429 XML SlowDown	Una regola esplicita su richieste, trasferimenti o byte ha rifiutato l’operazione	Rispetta Retry-After se presente. Riduci i trasferimenti paralleli per i limiti di concorrenza; le quote di byte richiedono il ripristino o la modifica autorizzata del limite.
429 JSON Too many requests	Il limite all’ingresso di 600 richieste/minuto per utente o 1.200/minuto per IP è stato raggiunto	Attendi Retry-After, riduci la frequenza di interrogazione o elenco e scagliona i client che condividono identità o indirizzo.

Per una richiesta prefirmata, X-Amz-Expires deve essere un intero da 1 a 604.800 secondi. Request has expired indica che la durata firmata è terminata; genera un nuovo URL invece di modificare la query, perché cambiare un parametro firmato invalida la firma.

Risultato previsto

1. Elenca il bucket esatto dello spazio di lavoro o il prefisso consentito. Trovare un bucket dimostra la visibilità, non il permesso di caricare o eliminare.
2. Scarica un oggetto noto e innocuo in un nuovo percorso locale e confronta dimensione o SHA-256 con l’origine.
3. Se chiave e ruolo consentono il caricamento, invia byte di prova dal nome univoco a un prefisso temporaneo autorizzato. Attendi HTTP 200, aggiorna File e scarica l’oggetto per confrontarlo.
4. Interrompi tramite il client ogni caricamento multipart fallito. Un annullamento locale può lasciare parti incomplete.

L’elenco restituisce al massimo 1.000 voci per pagina, quindi il client deve seguire i token di continuazione. I numeri delle parti multipart vanno da 1 a 10.000 e una parte del protocollo può essere al massimo di 5 GiB, ma i limiti effettivi di oggetto, archiviazione, credenziale e ruolo possono essere molto inferiori.

Capire le modifiche inattese riuscite

Caricare su un percorso dosya esistente crea una nuova versione del file. Non è un ID di versione AWS e continuano a valere le regole della cronologia e della conservazione. Eliminare un oggetto idoneo lo sposta nel cestino, ne revoca i link di condivisione e può restituire 204 anche se era già assente. Il cestino continua a occupare spazio di archiviazione fino alla pulizia; l’eliminazione definitiva è irreversibile.

Il gateway non offre amministrazione AWS IAM/ACL, regole del ciclo di vita, replica, versionamento S3 o Object Lock/blocco legale. Le scritture di configurazione per funzioni non supportate restituiscono NotImplemented. Se uno strumento richiede queste garanzie, cambiare credenziali non renderà compatibile quel carico di lavoro.

Richiedere assistenza senza esporre credenziali

Se un elenco minimo continua a fallire, fornisci client e versione, endpoint, regione, modalità di indirizzamento, ID del bucket, metodo, prefisso dell’oggetto, stato HTTP, codice e messaggio S3, ora e fuso approssimativi e se la chiave è limitata a spazio di lavoro o cartella. Oscura l’ID di accesso se richiesto dalle tue regole e non inviare mai chiave segreta, intestazione Authorization, query prefirmata o percorso privato completo dell’oggetto.

Guide correlate

• Connettere S3
• Limitare i permessi S3