Vai al contenuto principale

Fornire credenziali a Devin

Devin può usare le proprie credenziali di accesso per entrare nelle piattaforme che richiedono autenticazione, sia nel suo Browser sia tramite riga di comando. Ti consigliamo di configurare un account dedicato che Devin possa usare (ad es. devin@company.com) su ciascun servizio a cui deve avere accesso. Puoi quindi salvare il nome utente e la password di Devin come segreti sul tuo account, in modo che possa effettuare l’accesso come parte delle tue sessioni future. L’aggiunta dei segreti avviene principalmente tramite la pagina segreti. Questa pagina è particolarmente rilevante per i segreti a livello di organizzazione. Per i segreti specifici di un repository o di una sessione, vedi le sezioni seguenti. Per aggiungere più segreti contemporaneamente, fai clic su Bulk add segreti accanto ad Add segreto, quindi carica un file .env (fino a 2 MB) oppure incolla una coppia KEY=value per riga. I cookie e i codici TOTP vanno aggiunti uno alla volta.
Devin
Quando aggiungi un segreto, puoi includere una nota che spiega il contesto aggiuntivo o le istruzioni per l’uso del segreto. Usa questo campo per fornire informazioni utili sia a Devin sia agli altri membri della tua organizzazione. Esempi di note potrebbero includere:
  • Questa chiave API deve essere usata solo nel nostro ambiente di produzione e mai in staging o dev.
  • Usata per il nostro database AWS RDS in us-west-2
  • Queste credenziali sono previste per essere deprecate dopo il Q3 2025
  • Scade automaticamente ogni 30 giorni - contatta il team SecOps per la rotazione se dovesse iniziare a fallire
  • Questa chiave API è associata all’account utente devin@company.com
In More controls nel modulo New segreto, l’opzione Redact value è attiva per impostazione predefinita. Un valore oscurato non può più essere visualizzato. Per modificarlo, o per disattivare Redact value, apri il segreto, fai clic su Edit e inserisci un nuovo valore.

Segreti globali persistenti

I segreti aggiunti in Settings → Resources → Segreti vengono mantenuti nelle sessioni future e si applicano all’intera organizzazione. Tieni presente che qualsiasi segreto condividi qui sarà utilizzabile da Devin in tutte le future sessioni di Devin all’interno della tua organizzazione. Tutti i segreti sono crittografati a riposo. Tutti i membri della tua organizzazione possono usare i segreti globali nelle proprie sessioni. Per impostazione predefinita possono anche crearli, modificarli ed eliminarli, perché il ruolo predefinito Member include l’autorizzazione Manage segreti. Assicurati di aggiungere solo segreti con ambito specifico per la tua organizzazione e utilizzabili da tutti i suoi membri. In Devin Enterprise, un amministratore Enterprise può rimuovere Manage segreti dal ruolo Member organization-level e concedere invece questa autorizzazione tramite un ruolo personalizzato; consulta Ruoli personalizzati e RBAC.

Segreti personali

Oltre ai segreti globali a livello di organizzazione, puoi creare segreti personali limitati solo alle tue sessioni. I segreti personali non sono condivisi con altri membri della tua organizzazione. Questo è utile per credenziali collegate ai tuoi account personali o per testare segreti che non devono essere esposti al resto del team. Per creare un segreto personale, seleziona l’ambito Personal quando aggiungi un nuovo segreto nella pagina segreti. I segreti personali sono accessibili solo nelle sessioni che crei e non sono visibili agli altri membri dell’organizzazione o agli admin. Sono disponibili alcuni tipi di segreti:
Questo tipo è il più adatto per la maggior parte dei segreti generici con un singolo valore. Nel campo Type, seleziona Key-value. Ogni segreto Name (noto anche come segreto Key) è associato a un singolo segreto Value. Esempi di segreti archiviati qui potrebbero essere:
  • Chiavi API
  • SSH Keys
  • Username o password
  • Token
Se un singolo segreto richiede più valori, crea un segreto distinto per ciascun valore. Ad esempio, puoi archiviare GITHUB_USERNAME e GITHUB_PASSWORD come due Raw segreti. Per un esempio che archivia una chiave API come diversi Raw segreti, consulta Upload iOS builds to TestFlight.
Le time-based one-time password vengono utilizzate per l’autenticazione a due fattori (2FA). Devin può archiviare segreti TOTP che funzionano in modo simile a quelli in Google Authenticator o Authy. Per i dettagli su come aggiungere un segreto TOTP, consulta Adding a New TOTP
In passato Devin supportava segreti che gestivano più chiavi per segreto. Tuttavia, questa funzionalità non è più disponibile.Consigliamo invece di creare semplicemente un segreto Key-value per ciascun campo distinto. Ad esempio, invece di creare un unico segreto per JIRA_LOGIN, puoi creare due segreti: JIRA_USERNAME e JIRA_PASSWORD.

Segreti specifici del Bot

Un Devin Bot può avere segreti propri, usati solo da quel Bot e dalle sue sessioni, oltre ai segreti della tua organizzazione. Puoi aggiungerli nella pagina Segreti delle impostazioni del Bot. Per maggiori dettagli, consulta Connessioni e segreti di Devin Bot.

Segreti specifici per repo

Per limitare l’ambito dei segreti a un repository specifico, aggiungili nell’editor dei blueprint di quel repository:
  1. Vai su Settings > Environment > Blueprints e seleziona il repository. Il repository deve già far parte del tuo ambiente.
  2. Apri la scheda Segreti.
  3. Clicca su Create segreto per aggiungere un singolo segreto oppure su Import segreti per aggiungerne più di uno in una volta sola.
Dalla stessa scheda puoi cercare, mostrare, modificare ed eliminare i segreti del repository. Per creare, modificare ed eliminare i segreti del repository è necessaria l’autorizzazione Manage segreti, inclusa nel ruolo predefinito Member. I segreti del repository sono disponibili solo per quel repository: per i passaggi del suo blueprint durante le build dello snapshot e per Devin quando lavora in quel repository durante le sessioni. Vengono memorizzati in forma crittografata e non vengono mai scritti nel tuo blueprint o nello snapshot. Consulta Segreti nel riferimento del blueprint per sapere come vengono iniettati.
Non inserire i valori dei segreti nel YAML del blueprint, nei comandi di setup o nei file .env committati nel repository. Memorizzali invece nella scheda Segreti del repository e richiamali tramite il nome (per esempio, $MY_SECRET).

Segreti specifici della sessione

Mentre Devin lavora, potrebbe chiederti di fornire credenziali (chiavi API, dati di accesso, ecc.) all’interno della conversazione corrente, ad esempio:
Devin
Un segreto inserito in questa scheda vale solo per la sessione corrente, a meno che non sia selezionata l’opzione Save for future sessions. Devin può preselezionare questa opzione, quindi controllala prima di inviare il segreto. In alternativa, puoi impostare tu stesso segreti specifici della sessione:
Devin

Working With Segreti

Devin fornisce ogni segreto ai comandi e agli strumenti specifici che ne hanno bisogno. Nel browser, Devin digita direttamente il valore. Per i comandi shell, associa i segreti come variabili d’ambiente ogni volta che è necessario. Questo vale per i segreti globali a livello di organizzazione, quelli specifici per repo e quelli specifici della sessione. I segreti non vengono esportati in ogni shell, quindi gli script non devono presumere che una variabile come $API_KEY sia già impostata. Se uno script dipende da un segreto, indica a Devin quale variabile d’ambiente legge e Devin la assocerà ai comandi pertinenti. I segreti dell’organizzazione e quelli personali dispongono di un interruttore Require approval before each use in More controls nel modulo New segreto. È disattivato per impostazione predefinita. Devin esegue alcune conversioni di testo per garantire che i tuoi segreti siano variabili ENV valide:
  • Rimuove i caratteri non validi sostituendo qualsiasi cosa che non sia una lettera, una cifra o un underscore con un underscore. Ad esempio, il segreto chiamato Abc%123 diventerebbe la variabile ENV Abc_123
  • Se il nome del tuo segreto inizia con una cifra, Devin aggiunge un underscore all’inizio del nome. Ad esempio, il segreto 123MYVAR diventerebbe la variabile ENV _123MYVAR (i nomi che iniziano già con una lettera o un underscore restano invariati)
  • Se hai due segreti con lo stesso nome, Devin aggiungerà un contatore alla fine. Ad esempio, se hai due segreti chiamati MY_SECRET, otterrai due variabili ENV chiamate MY_SECRET e MY_SECRET_2, e così via.
Per aggiungere un Site Cookie, segui i passaggi seguenti:
  1. Accedi normalmente all’account che desideri condividere con Devin. Questo genererà uno o più cookie.
  2. Aggiungi il cookie esportato a Devin tramite la pagina segreti.
  3. Quando utilizza il cookie per un sito, Devin dovrebbe rilevare che l’accesso è già stato effettuato quando vi accede. Chiedi a Devin di fare una prova!
Se non usi Chrome, seleziona JSON nel modulo New segreto e incolla i cookie in formato JSON. Se codifichi manualmente i cookie, seleziona base64. Devin si aspetta una stringa codificata in base64 contenente oggetti JSON delimitati da ; nel formato standard dei cookie di Chromium.

Aggiunta di un nuovo TOTP

Devin ora può gestire l’autenticazione a due fattori (2FA) utilizzando una time-based password monouso (TOTP). Per farlo, devi fornire a Devin le informazioni disponibili al momento della configurazione della 2FA sull’account Devin per la specifica applicazione:
  1. Accedi all’account Devin per il servizio che richiede la 2FA.
  2. Vai alle impostazioni di sicurezza dell’account e cerca un’opzione per rigenerare o visualizzare il codice QR. Potrebbe chiamarsi “Set up” o “Replace Authenticator”.
  3. Se l’applicazione lo consente, seleziona l’opzione per visualizzare il codice QR.
  4. Una volta che il codice QR viene mostrato sullo schermo, acquisisci uno screenshot.
  5. Vai a Devin’s Segreti, fai clic sul pulsante Add segreto e imposta il campo Type su Password monouso (TOTP). Inserisci un nome descrittivo. Fai clic sulla piccola icona del codice QR nell’angolo in alto a destra del campo “Value” e carica lo screenshot del tuo codice QR. In alternativa, puoi incollare un URI otpauth://totp/.
Fornisci solo codici 2FA associati ad account configurati specificamente per l’uso esclusivo da parte di Devin. Non consigliamo di dare a Devin alcun codice 2FA per i tuoi account personali.

Suggerimenti per i TOTP

  • Alcune applicazioni potrebbero non consentirti di visualizzare il codice QR esistente una volta abilitata l’autenticazione a due fattori. In questi casi, rigenerare il codice QR è l’unica opzione.
  • Salva sempre i nuovi codici di backup forniti durante il processo in un luogo sicuro.