Conservare le credenziali in un unico posto

Salva chiavi, password e token nel Key Store o collega il vault. Riutilizza credenziali nominate tra job, tieni i segreti fuori dal codice e aggiornali alla fonte.

Credenziali distribuite tra job, script e computer

Ogni copia deve essere protetta e aggiornata. Condividere un job non dovrebbe significare condividerne i segreti.

In Git
Negli script
Sui laptop

Salvare una volta la credenziale e riusarne il riferimento

Conserva la chiave nel Key Store Semaphore o nel vault collegato. Associala alle risorse del job e aggiornala alla fonte.

Usare il Key Store o collegare il vault

Conserva credenziali separate dal codice. Riutilizza chiavi nominate tra repository, inventari e job con la fonte adatta all’infrastruttura.

Key Store integrato

Conserva chiavi SSH, coppie utente/password e segreti testuali nel Key Store cifrato di Semaphore. Riutilizzali per Git, connessioni agli host e password Ansible Vault.

HashiCorp Vault

Risolvi le credenziali dai segreti Vault KV esistenti.

OpenBao

Usa OpenBao come fonte di credenziali riutilizzabili.

AWS Secrets Manager

Collega credenziali gestite in AWS Secrets Manager.

Azure Key Vault

Importa segreti dal vault al Key Store con la sincronizzazione.

Devolutions Server

Usa credenziali gestite in Devolutions Server.

CyberArk

Collega i segreti gestiti in CyberArk all’automazione.

Serve un’altra fonte? Risolvi credenziali da variabili d’ambiente o file server, sincronizza segreti dal vault al Key Store oppure usa valori segreti accanto alla configurazione condivisa nei Variable Groups.

Creare, collegare e riutilizzare le credenziali

Scegliere l’origine delle credenziali dei job

Credenziali nominate referenziate dal modello

Il Key Store contiene i tipi di credenziali necessari: chiavi SSH e accessi host, repository Git privati, password sudo e Ansible Vault. Il modello referenzia la voce: i tecnici usano un nome, mentre il valore resta fuori da repository e modulo. I valori locali sono cifrati nel database se la cifratura delle chiavi di accesso è configurata; configurazione e recupero fanno quindi parte dei backup.

Risolvere un valore dal server durante l’esecuzione

Le fonti d’ambiente e file permettono a una voce Key Store di leggere il valore dal server Semaphore quando serve, invece di conservarne una copia nel database. Usale se un altro processo aggiorna già le credenziali sull’host: ruota la fonte e il task successivo usa il nuovo valore senza modificare modelli. Il server risolve queste fonti anche con runner remoto, quindi il file non deve essere sul runner. Le fonti file seguono la directory dei segreti configurata e il formato JSON documentato; anche le voci SSH o di accesso usano tale struttura anziché un file chiave grezzo.

Usare credenziali Key Store nei Variable Groups

I Variable Groups combinano configurazione e segreti. Referenzia credenziali salvate anziché duplicarle in ogni job. Passa il gruppo ad Ansible, Terraform, OpenTofu o script con i nomi previsti dallo strumento.

Collegare il gestore di segreti esistente

Usa segreti HashiCorp Vault o OpenBao con Pro. Enterprise aggiunge integrazioni supportate come AWS Secrets Manager, CyberArk e Devolutions Server. Mantieni il segreto nel sistema responsabile e rendilo disponibile con la configurazione documentata del provider.

Cosa può ancora stampare l’esecuzione

Conservare bene un valore non controlla cosa ne fa il codice. Un playbook o script può stamparlo tramite debug, argomenti o risposte API e non esiste garanzia che ogni valore sia rimosso dal log. Usa le funzionalità dello strumento, come no_log di Ansible, verifica errori e successi e tratta accesso a log ed esportazioni come accesso a tutto il contenuto.

Usare identità temporanee del task dove supportate

I JWT dei task forniscono un’identità firmata per ogni esecuzione. Un servizio può verificare emittente, destinatario e claim invece di condividere token durevoli con ogni job. Configura la fiducia da entrambe le parti; chiavi SSH, password e riferimenti vault restano per i sistemi che ne hanno bisogno.

FAQ

Cosa va nel Key Store anziché nel repository?

Usa credenziali nominate per repository privati, host e password Ansible Vault. Mantieni codice e configurazione non sensibile in Git e riferimenti nel modello. Il riferimento facilita riuso e rotazione rispetto a valori incorporati. Non elimina la necessità di proteggere chi modifica il codice, perché quel codice gira con gli accessi forniti.

Ansible Vault equivale al deposito segreti HashiCorp Vault?

No. Ansible Vault protegge contenuti Ansible cifrati; un Task Template può usare una password Vault dal Key Store per sbloccarli. HashiCorp Vault è un’opzione esterna Pro separata per i segreti del Key Store. Il controllo registrato in questa pagina mostra il percorso della password Ansible Vault, non un collegamento a HashiCorp Vault. Valuta separatamente quel deposito con una credenziale temporanea prima dell’uso operativo.

Come sono protette le credenziali locali?

I valori locali del Key Store usano il meccanismo configurato di cifratura delle chiavi di accesso per il database. Configuralo e proteggilo correttamente e includi i requisiti di recupero nei backup. La cifratura a riposo è una parte del progetto: l’esecuzione autorizzata deve comunque usare la credenziale. Proteggi server, ambiente, accesso amministrativo e log anziché considerare un valore cifrato inaccessibile a qualunque codice o tecnico.

Quale componente legge segreti da ambiente o file?

Le fonti d’ambiente e file sono risolte dal server quando serve la chiave, anche con runner remoto. I file devono rispettare directory consentita e formato documentato. Un task successivo può usare la fonte ruotata senza cambiare modello. Un file chiave grezzo sul runner non implementa questo meccanismo server.

Posso collegare HashiCorp Vault o OpenBao?

Sì. Pro supporta HashiCorp Vault e OpenBao come fonti. Enterprise aggiunge altri gestori. Configura il provider e riferisci la credenziale dal Key Store senza salvare valori in Git. Segui la guida per autenticazione e percorsi e testa gli accessi previsti.

Cosa cambia ruotando una credenziale?

I modelli referenziano credenziali nominate anziché incorporare chiavi o password in ogni job. Aggiorna la credenziale o fonte, poi controlla repository e inventari collegati. Testa un task rappresentativo dopo la rotazione per rilevare errori prima della prossima esecuzione produttiva.

Semaphore impedisce a ogni segreto di apparire nei log?

Non affidarti a una garanzia universale di mascheramento. Un playbook o script può stampare variabili sensibili, argomenti o risposte API. Scegli deliberatamente cosa registrare, usa le opzioni appropriate dello strumento e verifica output rappresentativi di errore e successo. Limita l’accesso a log ed esportazioni secondo il contenuto. Conservare un valore in modo sicuro non controlla tutto ciò che stampa il codice.

Più job possono riutilizzare la stessa chiave SSH o password Vault?

Sì. Nomina la credenziale nel Key Store e selezionala dove repository, inventario o modello richiedono quel tipo. I job referenziano la voce anziché una copia in Git. Usa credenziali distinte per identità diverse. Vedi i Task Template.