Correggere endpoint o regione S3 non corrispondenti

Il gateway S3 di dosya si trova sotto l’host API. La configurazione client rilasciata usa l’endpoint https://api.dosya.dev/s3, la regione pubblicata us-east-1, l’indirizzamento path e un nome di bucket uguale all’ID dello spazio di lavoro, ad esempio wks_…. La regione soddisfa un campo obbligatorio del client; il gateway non impone una sola regione di firma.

Prima di iniziare

Usa una credenziale S3 la cui chiave API principale consenta il Gateway S3. L’utente deve ancora appartenere allo spazio di lavoro del bucket e il suo ruolo deve consentire l’accesso S3; per elencare gli oggetti serve anche l’accesso ai file.

La regione del firmatario è una configurazione del protocollo, non la posizione fisica in cui sono salvati i byte caricati. dosya salva i nuovi oggetti nella regione configurata per lo spazio di lavoro. Le istruzioni per il client e la risposta di compatibilità indicano us-east-1, mentre la verifica della firma deriva la chiave di firma dalla regione e dal servizio riportati nell’ambito delle credenziali di ogni richiesta.

Passaggi

1. Apri il profilo del client senza esporne il segreto e confronta l’endpoint carattere per carattere con https://api.dosya.dev/s3.
2. Usa us-east-1 per la configurazione client pubblicata e verificata in produzione. Una regione diversa non è di per sé un errore se il client usa lo stesso valore in modo coerente nell’ambito delle credenziali e nella chiave di firma.
3. Attiva l’indirizzamento path affinché la richiesta abbia la forma /s3/{workspace-id}/{key} invece di un sottodominio dello spazio di lavoro.
4. Imposta come bucket l’ID esatto dello spazio di lavoro restituito da dosya, non il nome visualizzato, lo slug o il nome di una cartella.
5. Riprova con un elenco limitato della radice o una richiesta HEAD. Per SignatureDoesNotMatch, controlla insieme segreto, percorso canonico, query, intestazioni firmate, hash del corpo, data, regione e servizio; cambiare solo la regione non corregge un altro errore di firma.
6. Se la richiesta riesce, elenca un prefisso di prova consentito e verifica i nomi delle chiavi restituite prima di riprendere il normale carico di lavoro del client.

Risultato previsto

Il client firma il percorso reale della richiesta /s3 e raggiunge il bucket dello spazio di lavoro previsto. Un elenco valido restituisce solo spazi di lavoro e oggetti consentiti da chiave API, ruolo del membro ed eventuale cartella di ancoraggio.

InvalidAccessKeyId indica un ID di accesso S3 sconosciuto o revocato. SignatureDoesNotMatch indica che client e gateway hanno calcolato richieste canoniche o chiavi di firma diverse; non prova che il problema sia causato da una regione diversa da us-east-1. NoSuchBucket indica che l’ID dello spazio di lavoro è errato o non disponibile per questo utente.

Guide correlate

• Connettersi con strumenti compatibili con S3
• Risolvere i problemi di accesso S3