Limitare una chiave API a una cartella dello spazio di lavoro

La cartella di ancoraggio diventa la radice visibile della credenziale, insieme al suo contenuto. La restrizione si applica ai gateway WebDAV e S3, non a REST o SFTP.

Combinazione supportata

Apri Profilo → Chiavi API, scegli Crea una chiave API, poi espandi Restrizioni e scadenza. In Quale ambito di accesso ha?, scegli uno spazio di lavoro e usa Scegli cartella…. Il titolo del selettore è Limita la chiave a una cartella e la conferma è Seleziona cartella.

Scegli WebDAV o Gateway S3 in Protocolli. Il ruolo nello spazio di lavoro deve includere access_webdav per WebDAV o access_s3 per S3. REST risponde in JSON con This API key is anchored at a folder and can only be used over WebDAV or the S3 gateway; un client SFTP segnala invece un errore di autenticazione o della richiesta al gateway.

Passaggi

1. Crea una struttura di prova nello spazio di lavoro, con un file nella cartella di ancoraggio desiderata e un altro in una cartella allo stesso livello.
2. Nella finestra della chiave, scegli il permesso operativo necessario, limita l’accesso allo spazio di lavoro, scegli la cartella di ancoraggio tramite Scegli cartella… e consenti WebDAV o S3.
3. Genera il segreto dos_… per WebDAV. Per S3, espandi la chiave salvata, scegli Attiva in Credenziali S3 e copia ID chiave di accesso, Chiave di accesso segreta, Indirizzo del servizio e Regione mostrati una sola volta.
4. Verifica che il ruolo del membro abbia il permesso per il protocollo corrispondente, poi monta WebDAV o accedi allo spazio di lavoro S3 e verifica che la radice sia la cartella scelta.
5. Leggi o scrivi l’elemento di prova nella struttura, secondo il permesso della chiave.
6. Richiedi il percorso parallelo e verifica che l’accesso sia negato, poi revoca la chiave di prova dopo aver registrato il limite verificato.

Ciclo di vita dell’ancoraggio

Ambito, protocollo, ruolo attuale del membro, blocchi e altre condizioni della chiave continuano ad applicarsi. WebDAV restituisce messaggi come This API key is not permitted to use WebDAV o This role is not permitted to use WebDAV. S3 restituisce una risposta XML AccessDenied con il messaggio equivalente del gateway o del ruolo. La limitazione del membro a una cartella può restringere ulteriormente la credenziale; se le limitazioni sono incompatibili, viene restituito This API key is anchored outside your permitted folder.

Se sposti la cartella di ancoraggio nel cestino, WebDAV e S3 rispondono con This API key's anchor folder is no longer available. Se la ripristini, il suo ID può tornare utilizzabile. Se elimini definitivamente la cartella o una struttura che la contiene, vengono eliminate tutte le chiavi ancorate nella parte eliminata e svuotate le relative cache di autenticazione REST/S3; la rimozione delle chiavi è irreversibile.

Se sposti o rinomini una cartella di ancoraggio attiva, l’ID salvato resta invariato: i client vedono la stessa struttura nella nuova posizione o con il nuovo nome, senza ricevere una credenziale con un nuovo ambito.

Risultato previsto

La radice del protocollo mostra la cartella scelta e il suo contenuto; i dati paralleli sono irraggiungibili. Se la cartella è nel cestino o è stata eliminata definitivamente, l’accesso viene negato senza ampliarne l’ambito.

Guide correlate

• Creare e gestire una chiave API
• Scegliere il permesso della chiave
• Limitare un membro a una cartella