Questa pagina è stata tradotta dall'API Cloud Translation.

Configurare l'autenticazione per Go

L'autenticazione in Artifact Registry è diversa per il caricamento e il download dei moduli Go pacchettizzati. Durante la pacchettizzazione e il caricamento di un modulo Go Artifact Registry, lo strumento gcloud CLI cerca le credenziali dell'ambiente di impostare l'autenticazione nel seguente ordine, a meno che --json_key viene passato per utilizzare una chiave dell'account di servizio.

Credenziali predefinite dell'applicazione (ADC), una strategia che cerca le credenziali nel seguente ordine:
1. Credenziali definite nella variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS.
2. Le credenziali dell'account di servizio predefinito per Compute Engine, Funzioni di Google Kubernetes Engine, Cloud Run, App Engine o Cloud Run fornisce.
Le credenziali fornite da Google Cloud CLI, incluse le credenziali utente del comando gcloud auth application-default login.

La variabile GOOGLE_APPLICATION_CREDENTIALS rende esplicito l'account per l'autenticazione, semplificando la risoluzione dei problemi. Se non utilizzi la variabile, verifica che tutti gli account che ADC potrebbe utilizzare abbiano le autorizzazioni richieste. Ad esempio, l'account di servizio predefinito per le VM Compute Engine, i nodi Google Kubernetes Engine e le revisioni Cloud Run ha accesso in sola lettura ai repository. Se vuoi caricare contenuti da questi ambienti usando l'account di servizio predefinito, devi modificare le autorizzazioni.

Durante il download di moduli Go pacchettizzati da utilizzare come dipendenze Artifact Registry, il programma binario Go utilizza le credenziali del file netrc per l'autenticazione in Artifact Registry. Per semplificare l'autenticazione, puoi utilizzare l'assistente per le credenziali Go per aggiornare i token netrc per l'autenticazione in Artifact Registry.

La posizione del file netrc può essere impostata con la variabile di ambiente netrc. Se la variabile NETRC non è impostata, il comando go leggerà $HOME/.netrc su piattaforme simili a UNIX o %USERPROFILE%\_netrc su Windows.

Artifact Registry supporta i seguenti metodi di autenticazione quando utilizzi credenziali nel file netrc:

Credenziali di breve durata (opzione consigliata): Utilizzare lo strumento di supporto delle credenziali Go di Artifact Registry per aggiornare i token di autenticazione nel file netrc utilizzando credenziali nel tuo ambiente o aggiungi manualmente Artifact Registry e le credenziali al file netrc.
Utilizzare una chiave dell'account di servizio: Utilizza questa opzione quando non puoi utilizzare le credenziali nel tuo ambiente per autenticazione. Puoi utilizzare lo strumento di assistenza per le credenziali Go di Artifact Registry per aggiungere la chiave dell'account di servizio non criptata al file netrc o aggiungerla manualmente al file.

Prima di iniziare

Installa Go 1.15 o versioni successive.
Installa il componente aggiuntivo gcloud CLI package-go-module:
```
gcloud components install package-go-module
```

configura l'ambiente Go

Chiedi a Go di scaricare i moduli da Artifact Registry, dal proxy del modulo Go pubblico e poi dall'origine in questo ordine:
```
  export GOPROXY=https://LOCATION-go.pkg.dev/PROJECT/REPOSITORY,https://proxy.golang.org,direct
```
Sostituisci quanto segue:
- LOCATION è la posizione regionale o multiregionale del repository.
- PROJECT è il tuo account Google Cloud ID progetto.
- REPOSITORY è il nome del repository in cui è memorizzato il pacchetto.
Escludi il modulo dal controllo utilizzando il database di checksum pubblico:
```
  export GONOSUMDB=MODULE_PATH_REGEX
```
Sostituisci MODULE_PATH_REGEX con il percorso del modulo o con un'espressione regolare se vuoi escludere più moduli.

Ad esempio, per escludere il modulo example.com/foo dai controlli utilizzando nel database di checksum pubblico, esegui questo comando:
```
  export GONOSUMDB=example.com/foo
```
Il seguente comando impedisce il controllo di tutti i moduli con percorsi che iniziano conexample.com utilizzando il database di checksum pubblico:
```
  export GONOSUMDB=example.com/*
```

Aggiungi le credenziali di Artifact Registry al file netrc

Esegui il comando seguente per aggiungere le credenziali di Artifact Registry al file netrc con lo strumento di assistenza per le credenziali Go:
```
  GOPROXY=proxy.golang.org \
      go run github.com/GoogleCloudPlatform/artifact-registry-go-tools/cmd/auth@v0.1.0 \
      add-locations --locations=LOCATION \
      --json_key=PATH_TO_JSON_KEY
```
Dove:
- LOCATION è la posizione regionale o multiregionale del tuo repository. Per aggiungere più località, inseriscile come virgole. elenco separato.
- PATH_TO_JSON_KEY Facoltativo. Il percorso dell'account di servizio chiave.
  
  L'assistente per le credenziali di Go aggiunge impostazioni al tuo file netrc per l'autenticazione in Artifact Registry. Se passi il flag --json_key, la chiave viene aggiunta al tuo file netrc per l'autenticazione della password.
Se utilizzi credenziali a vita breve per l'autenticazione in Artifact Registry, dovrai aggiornare il token OAuth eseguendo il seguente comando prima di utilizzare il modulo come dipendenza:
```
  GOPROXY=proxy.golang.org \
  go run github.com/GoogleCloudPlatform/artifact-registry-go-tools/cmd/auth@v0.1.0 refresh
```

Autenticazione con una chiave dell'account di servizio

Utilizza questo approccio quando è richiesta l'autenticazione con nome utente e password.

Le chiavi dell'account di servizio sono credenziali di lunga durata. Usa le linee guida seguenti per limitare l'accesso ai tuoi repository:

Valuta la possibilità di utilizzare un account di servizio dedicato per interagire con i repository.
Concedi il ruolo minimo di Artifact Registry richiesta dall'account di servizio. Ad esempio, assegna Artifact Registry Lettore a un account di servizio che scarica solo gli artefatti.
Se i gruppi della tua organizzazione richiedono livelli di accesso diversi a specifici possono concedere l'accesso a livello di repository anziché di progetto livello.
Segui le best practice per la gestione delle credenziali.

Per configurare l'autenticazione:

Crea un account di servizio per agire per conto della tua applicazione o scegli un account di servizio esistente che utilizzi per l'automazione.

Per configurare l'autenticazione con Artifact Registry, devi conoscere la posizione del file della chiave dell'account di servizio. Nel caso di account esistenti, puoi visualizzare le chiavi e crearne di nuove nella pagina Account di servizio.

Vai alla pagina Account di servizio

Nota: Se non vengono gestite correttamente, le chiavi degli account di servizio comportano un rischio per la sicurezza. Dovresti Scegliere un'alternativa più sicura alle chiavi degli account di servizio ove possibile. Se devi autenticarti con una chiave dell'account di servizio, sei responsabile della chiave privata e per le altre operazioni descritte Best practice per la gestione delle chiavi degli account di servizio. Se non riesci a creare una chiave del service account, la creazione di chiavi del service account potrebbe essere disabilitata per la tua organizzazione. Per ulteriori informazioni, vedi Gestione delle risorse dell'organizzazione sicure per impostazione predefinita.
Concedi la licenza appropriata Artifact Registry per l'account di servizio per fornire il repository l'accesso.
Esegui il seguente comando per aggiungere le credenziali dell'account di servizio al file netrc con lo strumento di assistenza per le credenziali Go:
```
  GOPROXY=proxy.golang.org \
      go run github.com/GoogleCloudPlatform/artifact-registry-go-tools/cmd/auth@v0.1.0 \
      add-locations --locations=LOCATION \
      --json_key=PATH_TO_JSON_KEY
```
Dove:
- LOCATION indica una o più regioni località del tuo repository. Per aggiungere più località, inseriscile come virgole. elenco separato.
- PATH_TO_JSON_KEY è il percorso del file JSON dell'account di servizio file della chiave.
  
  Lo strumento di assistenza per le credenziali Go aggiunge la chiave dell'account di servizio al file netrc per l'autenticazione tramite password.

È anche possibile aggiungere manualmente la chiave dell'account di servizio al file netrc nel seguente formato:

machine LOCATION.pkg.dev
login _json_key_base64
password KEY

Sostituisci quanto segue:

LOCATION con la posizione regionale o multiregionale del tuo repository.
KEY con la chiave con codifica base64 nel file della chiave dell'account di servizio.

Aggiungi l'assistente per le credenziali Go a `GONOPROXY`

Prima di utilizzare l'assistente per le credenziali di Go, devi aggiungerlo all'elenco GONOPROXY per forzare Go a scaricarlo direttamente da GitHub. Se hai altri moduli che vuoi scaricare direttamente dall'origine, puoi aggiungerli in un elenco separato da virgole, come mostrato nell'esempio seguente:

  export GONOPROXY=MODULE_PATH1, MODULE_PATH2

Dove MODULE_PATH1 e MODULE_PATH2 sono percorsi dei moduli da scaricare dall'origine.

Per aggiungere lo strumento di assistenza per le credenziali di Go al tuo elenco GONOPROXY ed eseguirlo per configurare le tue credenziali:

Aggiungi lo strumento di assistenza per le credenziali Go a GONOPROXY

  export GONOPROXY=github.com/GoogleCloudPlatform/artifact-registry-go-tools

Esegui il comando seguente per aggiungere le credenziali di Artifact Registry al file netrc con lo strumento di pacchettizzazione del modulo Go:
```
  GOPROXY=proxy.golang.org \
      go run github.com/GoogleCloudPlatform/artifact-registry-go-tools/cmd/auth@v0.1.0 \
      add-locations --locations=LOCATION \
      [--json_key=path/to/service/account/key.json]
```
dove LOCATION è la località regionale o multiregionale del tuo repository. Per aggiungere più località, inseriscile come elenco separato da virgole.

L'assistente per le credenziali di Go aggiunge impostazioni al tuo file netrc per l'autenticazione in Artifact Registry. Se passi il flag --json_key, la chiave viene aggiunta al file netrc per l'autenticazione tramite password.

Passaggi successivi

Prova la guida rapida.
Gestisci i moduli Go.