Come scegliere un nome per la chiave API che indichi responsabile e scopo

Scegli un nome facile da cercare, entro 64 caratteri, che identifichi il client e lo scopo. Se devi cambiarlo, sostituisci la credenziale in sicurezza.

Ultima revisione

Gli screenshot mostrano l’interfaccia in inglese.

Il nome di una chiave API è un’etichetta ricercabile salvata accanto alla credenziale. dosya non lo suddivide in campi per responsabile, ambiente o scopo e consente nomi duplicati.

Quattro pannelli mostrano come scegliere una convenzione basata su client e scopo, inserire un nome entro 64 caratteri, cercare la riga mascherata e sostituire la chiave se il nome non è più corretto.
Quattro pannelli mostrano come scegliere una convenzione basata su client e scopo, inserire un nome entro 64 caratteri, cercare la riga mascherata e sostituire la chiave se il nome non è più corretto. Apri lo screenshot a dimensione intera.

Scegli una convenzione utile

In Profilo → Chiavi API, la finestra Crea una chiave API chiede A cosa serve? e suggerisce e.g. rclone backup. Puoi usare una convenzione come client-environment-owner o client-purpose, per esempio rclone-prod-ops. È una scelta organizzativa, non un formato imposto dal server.

Passaggi

  1. Identifica l’applicazione, l’ambiente e il team o la persona responsabile della credenziale.
  2. Componi un nome breve con gli elementi distintivi, evitando di includere il segreto, dati dei clienti o numeri di ticket temporanei.
  3. Inseriscilo in A cosa serve? e rimani entro il limite di 64 caratteri.
  4. Scegli permessi e restrizioni, premi Genera la chiave e conserva separatamente dal nome il valore dos_…, che viene mostrato una sola volta.
  5. Torna alla tabella delle chiavi API e usa Cerca nome o prefisso per verificare che la nuova riga sia individuabile senza ambiguità.
  6. Se il nome non è più corretto, crea una chiave sostitutiva con le stesse impostazioni e il nome corretto, migra il client e revoca la vecchia chiave.

Convalida e identità

Gli errori API esatti sono Name is required e Name must be 64 characters or less. Nell’interfaccia web compare il testo di aiuto Solo un’etichetta per riconoscerla in seguito. Il nome non è un valore di autenticazione e non è necessario che sia univoco.

L’elenco mostra un’impronta mascherata e permette di cercare per nome o prefisso salvato. Non puoi modificare direttamente i nomi esistenti. La chiave sostitutiva ha un segreto diverso: attendi che il client sia aggiornato prima di revocare la vecchia chiave.

L’account può avere al massimo 20 chiavi API; il piano gratuito ne consente 3. Le chiavi scadute contano ancora finché non vengono eliminate.

Risultato previsto

Puoi riconoscere la riga dal nome e dall’impronta mascherata senza esporre la credenziale e risalire al client prima di sostituire o revocare la chiave.

Pagina REST API di dosya, con i link Get API Key e View SDKs, come riferimento per scegliere un nome che indichi il responsabile e lo scopo della chiave API.
Pagina REST API di dosya, con i link Get API Key e View SDKs, come riferimento per scegliere un nome che indichi il responsabile e lo scopo della chiave API. Apri lo screenshot a dimensione intera.

Guide correlate

Ti è stata utile?

Caricamento delle valutazioni…

Quando voti, salviamo un cookie tecnico per un massimo di 180 giorni, così puoi cambiare la tua risposta.

Domande e risposte

Fai una domanda sui passaggi di questa guida. Le domande vengono revisionate prima della pubblicazione.

Non inserire dati dell’account, credenziali o file privati nelle domande pubbliche. Usa l’assistenza privata in questi casi.

Caricamento delle domande…

    Accedi al tuo account dosya per fare una domanda.

    Controlla il risultato prima di riprovare

    Usa questi controlli quando devi verificare il risultato di un’attività.