Usare i file protetti

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Questo articolo descrive i file sicuri e come usarli in Azure Pipelines. I file sicuri sono un modo per archiviare i file che è possibile usare nelle pipeline senza doverli eseguire il commit nel repository.

È possibile usare la libreria di file protetti per archiviare file come:

• Firma dei certificati.
• Profili di provisioning Apple.
• File dell'archivio chiavi Android.
• Chiavi SSH.

Il limite di dimensioni per ogni file protetto è di 10 MB.

I file sicuri vengono archiviati nel server in formato crittografato e possono essere utilizzati solo da un'attività della pipeline. I file protetti sono una risorsa protetta. È possibile usare le approvazioni, i controlli e le autorizzazioni della pipeline per limitare l'accesso ai file. I file protetti usano anche ruoli del modello di sicurezza della libreria.

Prerequisiti

• Un progetto Azure DevOps in cui si dispone delle autorizzazioni per creare pipeline e aggiungere elementi di libreria.
• Un certificato, un archivio chiavi o un file di provisioning che si vuole usare in modo sicuro nella pipeline.

Aggiungere un file sicuro

1. Nel progetto Azure DevOps passare a Libreria pipeline>e selezionare la scheda File protetti.

   

2. Per caricare un file sicuro, selezionare + Secure file (+ Secure file), quindi cercare di caricare o trascinare il file.

   

3. Seleziona OK. Dopo aver caricato il file, è possibile eliminarlo ma non sostituirlo.

Definire ruoli e autorizzazioni di sicurezza

È possibile definire restrizioni e autorizzazioni dei ruoli di sicurezza per tutti gli elementi di una raccolta o per singoli elementi.

• Per assegnare ruoli di sicurezza per tutti gli elementi di una raccolta, selezionare Sicurezza nella pagina Raccolta .

• Per definire le autorizzazioni per un singolo file:

  1. Selezionare il file dall'elenco File protetti .
  2. Nella parte superiore della pagina Secure file (Secure file) selezionare:
     • Sicurezza per impostare utenti e ruoli di sicurezza che possono accedere al file.
     • Autorizzazioni della pipeline per selezionare le pipeline YAML che possono accedere al file.
     • Approvazioni e controlli per impostare responsabili approvazione e altri controlli per l'uso del file. Per altre informazioni, vedere Approvazioni e controlli.

  

Autorizzare una pipeline YAML a usare un file sicuro

Per usare un file sicuro nelle pipeline YAML, è necessario autorizzare la pipeline a usare il file. Tutte le pipeline classiche possono accedere a file protetti.

Per autorizzare una pipeline o tutte le pipeline a usare un file sicuro:

1. Nella parte superiore della pagina per il file protetto selezionare Autorizzazioni pipeline.
2. Nella schermata Autorizzazioni pipeline selezionare +e quindi selezionare una pipeline di progetto da autorizzare. In alternativa, per autorizzare tutte le pipeline a usare il file, selezionare l'icona Altre azioni, selezionare Apri accesso e selezionare di nuovo Apri accesso per confermare.

Usare un file sicuro in una pipeline

Per utilizzare file protetti in una pipeline, usare l'attività Scarica file protetti . L'agente della pipeline deve eseguire la versione 2.182.1 o successiva. Per altre informazioni, vedere Versione e aggiornamenti dell'agente.

La pipeline YAML di esempio seguente scarica un file di certificato sicuro e lo installa in un ambiente Linux.

- task: DownloadSecureFile@1
  name: caCertificate
  displayName: 'Download CA certificate'
  inputs:
    secureFile: 'myCACertificate.pem'

- script: |
    echo Installing $(caCertificate.secureFilePath) to the trusted CA directory...
    sudo chown root:root $(caCertificate.secureFilePath)
    sudo chmod a+r $(caCertificate.secureFilePath)
    sudo ln -s -t /etc/ssl/certs/ $(caCertificate.secureFilePath)

Contenuto correlato

• Per creare un'attività personalizzata che usa file protetti, usare gli input con il tipo secureFile nel task.json. Per altre informazioni, vedere Informazioni su come creare un'attività personalizzata.

• L'attività Installa profilo di provisioning Apple è un semplice esempio che usa un file sicuro. Per il codice sorgente, vedere InstallAppleProvisioningProfileV1.

• Per gestire i file protetti durante le attività di compilazione o rilascio, vedere il modulo Comune per le attività.