

# Autenticazione e accesso per il AWS Toolkit for JetBrains
<a name="auth-access"></a>

Non è necessario eseguire l'autenticazione con AWS per iniziare a lavorare con il AWS Toolkit for JetBrains. Tuttavia, la maggior parte delle risorse AWS viene gestita tramite un account AWS. Per accedere a tutti i servizi e le funzionalità di AWS Toolkit for JetBrains, avrai bisogno di almeno due tipi di autenticazione dell'account:

1. Autenticazione **AWS Identity and Access Management (IAM)** o **AWS IAM Identity Center** per gli account AWS. La maggior dei servizi e delle risorse AWS viene gestita tramite IAM e Centro identità IAM.

1. Un **ID Builder AWS** è facoltativo oppure obbligatorio per alcuni servizi AWS.

I seguenti argomenti contengono dettagli aggiuntivi e istruzioni di configurazione per ogni tipo di credenziale e metodo di autenticazione.

**Topics**
+ [Centro identità AWS IAM](identity-center.md)
+ [Credenziali IAM](setup-credentials.md)
+ [ID Builder AWS](builder-id.md)

# Centro identità AWS IAM
<a name="identity-center"></a>

AWS IAM Identity Center è la procedura consigliata per la gestione dell'autenticazione dell'account AWS.

Per istruzioni dettagliate su come configurare Centro identità IAM per i Software Development Kit (SDK) e il AWS Toolkit for JetBrains, consulta la sezione [IAM Identity Center authentication](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html) della *Guida di riferimento agli SDK e agli strumenti AWS*.

## Accesso con Centro identità IAM dal AWS Toolkit for JetBrains
<a name="identity-center-authenticate"></a>

Completa la procedura seguente per eseguire l'autenticazione con l'account AWS utilizzando le credenziali Centro identità IAM esistenti dal AWS Toolkit for JetBrains.

**Nota**  
Questo processo avvia il portale Centro identità AWS IAM nel tuo browser Web preferito. Ogni volta che le credenziali scadono, è necessario ripetere questo processo per rinnovare la connessione tra l'account AWS e il AWS Toolkit for JetBrains.

1. Dal AWS Toolkit for JetBrains, apri il menu **Impostazioni di connessione ad AWS** selezionando l'icona **...** (puntini di sospensione).

1. Dal menu **Impostazioni di connessione di AWS**, scegli **Aggiungi nuova connessione...** per aprire la finestra di dialogo **Kit di strumenti AWS: aggiungi connessione**.

1. Dalla finestra di dialogo **Kit di strumenti AWS: aggiungi connessione**, seleziona il pulsante di opzione **Connettiti utilizzando Centro identità AWS IAM**, inserisci l'URL del tuo portale Centro identità IAM nel campo di testo **URL di avvio:**, quindi scegli **Connettiti** per continuare.

1. Quando richiesto, conferma di voler aprire il portale Centro identità IAM nel tuo browser Web preferito e segui le istruzioni per completare il processo di autenticazione. Riceverai una notifica quando il processo di autenticazione sarà completo e potrai chiudere la finestra del browser in tutta sicurezza.

# Credenziali AWS IAM
<a name="setup-credentials"></a>

Le credenziali utente AWS IAM si autenticano con l'account AWS tramite chiavi di accesso memorizzate localmente.

Nelle seguenti sezioni viene descritto come configurare il AWS Toolkit for JetBrains per autenticarti con il tuo account AWS tramite le credenziali utente IAM.

**Importante**  
Prima di configurare le credenziali IAM per l'autenticazione con l'account AWS, tieni presente che:  
Se hai già impostato le credenziali IAM tramite un altro servizio AWS (come la AWS CLI), il AWS Toolkit for JetBrains rileva automaticamente tali credenziali e le rende disponibili.
AWS consiglia di utilizzare l'autenticazione del Centro identità IAM. Per ulteriori informazioni sulle best practice di AWS IAM, consulta la sezione [Security best practice in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) della Guida per l'utente di AWS *Identity and Access Management*.
Per evitare rischi per la sicurezza, non utilizzare gli utenti IAM per l'autenticazione quando sviluppi software creato ad hoc o lavori con dati reali. Utilizza invece la federazione con un provider di identità come [Che cos'è Centro identità IAM?](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html) nella *Guida per l'utente di AWS IAM Identity Center*.

## Prerequisiti
<a name="prereqs"></a>

Prima di poter configurare il AWS Toolkit for JetBrains per l'autenticazione con le credenziali utente IAM, verifica che siano stati soddisfatti i prerequisiti seguenti. Se hai già configurato le credenziali utente IAM tramite un altro servizio (come la AWS Command Line Interface), puoi saltare i passaggi relativi ai prerequisiti e passare alle sezioni successive.

1. **Crea un utente IAM.** Per istruzioni dettagliate su come ottenere le chiavi di accesso di utente IAM, consulta la sezione [Step 1: Create your IAM user](https://docs.aws.amazon.com/sdkref/latest/guide/access-iam-users.html#step1authIamUser) della *Guida di riferimento agli SDK e agli strumenti AWS*.

1. **Ottieni le chiavi di accesso utente IAM**. Per istruzioni dettagliate su come ottenere le chiavi di accesso di utente IAM, consulta la sezione [Step 2: Get your access keys](https://docs.aws.amazon.com/sdkref/latest/guide/access-iam-users.html#stepGetKeys) della *Guida di riferimento agli SDK e agli strumenti AWS*.

1. **Facoltativo: aggiorna il file delle credenziali condivise**. Per istruzioni dettagliate su come aggiornare il file delle credenziali condivise, consulta la sezione [Step 3: Update the shared credentials file](https://docs.aws.amazon.com/sdkref/latest/guide/access-iam-users.html#stepauthIamUser) della *Guida di riferimento agli SDK e agli strumenti AWS*.
**Nota**  
Se il prerequisito facoltativo **Passaggio 3: aggiornamento del file di credenziali condivise** è stato completato, il AWS Toolkit for JetBrains rileva automaticamente le tue credenziali durante la procedura di **Creazione di un file di credenziali condiviso dal AWS Toolkit for JetBrains** descritta nella sezione seguente.

## Creazione di un file delle credenziali condiviso dal AWS Toolkit for JetBrains
<a name="setup-credentials-first-connect"></a>

Il *file di configurazione condiviso* e il *file di credenziali condivise* memorizzano le informazioni di configurazione e le credenziali per gli account AWS. Per ulteriori informazioni sulla configurazione e le credenziali condivise, consulta la sezione [Where are configuration settings stored?](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html#cli-configure-files-where) della *Guida per l'utente di AWS Command Line Interface*.

**Creazione di un file delle credenziali condiviso dal AWS Toolkit for JetBrains**

1. Dal AWS Toolkit for JetBrains, scegli **\$1 Aggiungi connessione ad AWS** per aprire la finestra di dialogo **Kit di strumenti AWS: aggiungi connessione**.

1. Dalla finestra di dialogo **Kit di strumenti AWS: aggiungi connessione**, scegli **Modifica file di credenziali AWS** per aprire la finestra di dialogo di conferma **Crea file di credenziali**.

1. Dalla finestra di dialogo di conferma **Crea file di credenziali**, scegli **Crea** per chiudere la finestra e creare il `credential File`.

1. Il `credential File` si apre automaticamente nell'IDE al termine della creazione.
**Nota**  
Durante il processo di creazione del `Credential File`:  
In caso di errore, JetBrains visualizza una notifica e apre i log di creazione contenenti i dettagli dell'errore. 
È possibile archiviare tutti i profili denominati in un unico file. Se utilizzi sia le credenziali sia i file di configurazione, le credenziali vengono aperte per impostazione predefinita nell'IDE.
Se in entrambi i file sono presenti credenziali per un profilo che condivide lo stesso nome, le chiavi nel file delle credenziali hanno la precedenza.

## Configurazione delle credenziali condivise
<a name="setup-credentials-first-configure"></a>

La procedura finale per autenticare il AWS Toolkit for JetBrains con l'account AWS serve per configurare le credenziali.

1. Dal AWS Toolkit for JetBrains, scegli **\$1 Aggiungi connessione ad AWS** per aprire la finestra di dialogo **Kit di strumenti AWS: aggiungi connessione**.

1. Dalla finestra di dialogo **Kit di strumenti AWS: aggiungi connessione**, scegli **Modifica file di credenziali AWS** per aprire il **File di credenziali**.

1. Quando il `credentials file` si apre in JetBrains, individua la sezione etichettata `[default]`.

1. Dalla sezione `[default]`, individua la voce `#aws_access_key_id =`, rimuovi il `#` e inserisci la chiave di accesso AWS. La voce dovrebbe essere simile alla seguente:

   **aws\$1access\$1key\$1id = AKIAIOSFODNN7EXAMPLE**

1. Dalla sezione `[default]`, individua la voce `#aws_secret_access_key =`, rimuovi il `#` e inserisci la chiave di accesso segreta AWS. La voce dovrebbe essere simile alla seguente:

   **aws\$1secret\$1access\$1key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY**

   La versione finale del file di credenziali aggiornato è simile alla seguente:

   ```
   [default]
   # The access key and secret key pair identify your account and grant access to AWS.
   # Treat your secret key like a password. Never share your secret key with anyone. Do
   # not post it in online forums, or store it in a source control system. If your secret
   # key is ever disclosed, immediately use IAM to delete the access key and secret key
   # and create a new key pair. Then, update this file with the replacement key details.
   aws_access_key_id = AKIAIOSFODNN7EXAMPLE
   aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
   ```

1. Salva le modifiche al file: il AWS Toolkit for JetBrains rileva automaticamente le credenziali aggiornate e si connette all'account AWS.

   **aws\$1secret\$1access\$1key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY**

# ID Builder AWS per sviluppatori
<a name="builder-id"></a>

ID Builder AWS è un account AWS che è facoltativo o obbligatorio per alcuni servizi AWS. Per ulteriori informazioni su come configurare l'ID Builder AWS per servizi specifici, consulta la sezione [Servizi di ID Builder AWS](#builder-id-services) di questa guida.

Le seguenti sezioni descrivono come creare ed eseguire l'autenticazione con l'ID Builder AWS dal AWS Toolkit for JetBrains. 

## Configurazione di un ID Builder AWS
<a name="builder-id-setup"></a>

**Configurazione di un ID Builder AWS dal AWS Toolkit for JetBrains**

1. Dall'**Esploratore** AWS, scegli **\$1 Aggiungi connessione ad AWS** per aprire la finestra di dialogo **Kit di strumenti AWS: aggiungi connessione**.

1. Dalla finestra di dialogo **Kit di strumenti AWS: aggiungi connessione**, scegli **Utilizza un indirizzo e-mail personale per registrarti e accedere con ID Builder AWS** per aprire la finestra di dialogo **Accedi con ID Builder AWS**.

1. Dalla finestra di dialogo **Accedi con un ID Builder AWS**, seleziona il pulsante **Apri e copia il codice** per aprire il sito **Richiesta di autorizzazione AWS** in un browser Web.

1. Dal browser Web, incolla il codice di conferma nel campo apposito e scegli **Successivo** per procedere alla Creazione del sito **ID Builder AWS**.

1. Completa tutti i passaggi del tuo browser Web per continuare. Una volta completato il processo, riceverai una notifica che è sicuro chiudere il browser e tornare a JetBrains.

1. In JetBrains, il menu a discesa **\$1 Aggiungi connessione ad AWS** viene aggiornato, indicando che sei connesso con l'ID Builder AWS.

## Servizi di ID Builder AWS
<a name="builder-id-services"></a>

La connessione di servizi specifici all'ID Builder AWS potrebbe richiedere una configurazione aggiuntiva. I seguenti servizi compatibili con ID Builder AWS sono accessibili tramite il AWS Toolkit for JetBrains:
+ **Amazon CodeCatalyst**: per ulteriori informazioni su come configurare Amazon CodeCatalyst per Builder ID AWS, consulta la sezione [Setting up Amazon CodeCatalyst](https://docs.aws.amazon.com/codecatalyst/latest/userguide/setting-up-topnode.html) della Guida per l'utente di *Amazon CodeCatalyst*.
+ **Amazon CodeWhisperer**: per ulteriori informazioni su come configurare Amazon CodeWhisperer per Builder ID AWS, consulta la sezione [Setting up Amazon CodeWhisperer](https://docs.aws.amazon.com/codewhisperer/latest/userguide/whisper-setup-indv-devs.html) della Guida per l'utente di *Amazon CodeWhisperer*.