Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Configurazione di base
## Panoramica di
Per sviluppare correttamente applicazioni che consentano l'accesso Servizi AWS tramite AWS SDK per Kotlin, è necessario soddisfare i seguenti requisiti.
+ È necessario essere in grado di [AWS accedere al portale di accesso](#setup-awsaccount) disponibile in AWS IAM Identity Center.
+ Le [autorizzazioni del ruolo IAM](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html) configurato per l'SDK devono consentire l'accesso a Servizi AWS ciò che l'applicazione richiede. Le autorizzazioni associate alla policy **PowerUserAccess** AWS gestita sono sufficienti per la maggior parte delle esigenze di sviluppo.
+ Un ambiente di sviluppo con i seguenti elementi:
+ [File di configurazione condivisi](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) configurati in almeno uno dei seguenti modi:
+ Il `config` file contiene le [impostazioni Single Sign-On di IAM Identity Center in](#setup-sso-access) modo che l'SDK possa ottenere le credenziali. AWS
+ Il `credentials` file contiene credenziali temporanee.
+ Un'[installazione di Java 8 o versione successiva](#setup-envtools).
+ [Uno [strumento di automazione delle build](#setup-envtools) come [Maven o Gradle](https://maven.apache.org/download.cgi).](https://gradle.org/install/)
+ Un editor di testo per lavorare con il codice.
+ [(Facoltativo, ma consigliato) Un IDE (ambiente di sviluppo integrato) come [IntelliJ IDEA](https://www.jetbrains.com/idea/download/#section=windows) o Eclipse.](https://www.eclipse.org/ide/)
Quando usi un IDE, puoi anche integrarlo con Kit di strumenti AWS s per lavorare più facilmente. Servizi AWS I [Kit di strumenti AWS per IntelliJ](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/welcome.html)e [AWS Toolkit for Eclipse](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/welcome.html)sono due toolkit che puoi usare.
+ Una sessione attiva del portale di AWS accesso quando si è pronti per eseguire l'applicazione. La usi AWS Command Line Interface per [avviare la procedura di accesso al portale di accesso](#setup-login-sso) di IAM Identity Center. AWS
**Importante**
Le istruzioni in questa sezione di configurazione presuppongono che tu o l'organizzazione utilizzi IAM Identity Center. Se la tua organizzazione utilizza un provider di identità esterno che funziona indipendentemente da IAM Identity Center, scopri come ottenere credenziali temporanee da utilizzare nell'SDK per Kotlin. Segui queste istruzioni per aggiungere credenziali temporanee al file. `~/.aws/credentials`
Se il tuo provider di identità aggiunge automaticamente credenziali temporanee al `~/.aws/credentials` file, assicurati che il nome del profilo sia `[default]` tale da non dover fornire un nome di profilo all'SDK o. AWS CLI
## Capacità di accesso al portale di accesso AWS
Il portale di AWS accesso è il luogo web in cui è possibile accedere manualmente allo IAM Identity Center. Il formato dell'URL è `d-xxxxxxxxxx.awsapps.com/start` o`your_subdomain.awsapps.com/start`.
Se non conosci il portale di AWS accesso, segui le linee guida per l'accesso all'account nell'argomento sull'[autenticazione di IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html) nella AWS SDKs and Tools Reference Guide.
## Configura l'accesso Single Sign-On per l'SDK
Dopo aver completato il passaggio 2 della [sezione sull'accesso programmatico](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html#idcGettingStarted) affinché l'SDK utilizzi l'autenticazione IAM Identity Center, il sistema deve contenere i seguenti elementi.
+ Il AWS CLI, che viene utilizzato per avviare una [sessione del portale di AWS accesso](#setup-login-sso) prima di eseguire l'applicazione.
+ Un `~/.aws/config` file che contiene un [profilo predefinito](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile). L'SDK per Kotlin utilizza la configurazione del provider di token SSO del profilo per acquisire le credenziali prima di inviare richieste a. AWS Il valore `sso_role_name`, che è un ruolo IAM connesso a un set di autorizzazioni di IAM Identity Center, dovrebbe consentire l'accesso ai Servizi AWS utilizzati nell'applicazione.
Il seguente `config` file di esempio mostra un profilo predefinito impostato con la configurazione del provider di token SSO. L'impostazione `sso_session` del profilo si riferisce alla sezione `sso-session` denominata. La `sso-session` sezione contiene le impostazioni per avviare una sessione del portale di AWS accesso.
```
[default]
sso_session = my-sso
sso_account_id = 111122223333
sso_role_name = SampleRole
region = us-east-1
output = json
[sso-session my-sso]
sso_region = us-east-1
sso_start_url = https://provided-domain.awsapps.com/start
sso_registration_scopes = sso:account:access
```
Per maggiori dettagli sulle impostazioni utilizzate nella configurazione del provider di token SSO, consulta Configurazione del provider di [token SSO nella AWS SDKs and Tools Reference](https://docs.aws.amazon.com/sdkref/latest/guide/feature-sso-credentials.html#sso-token-config) Guide.
Se l'ambiente di sviluppo non è configurato per l'accesso programmatico come mostrato in precedenza, segui il [passaggio 2 della SDKs Guida di riferimento](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html#idcGettingStarted).
## Effettuate l'accesso utilizzando il AWS CLI
Prima di eseguire un'applicazione che consente l'accesso Servizi AWS, è necessaria una sessione attiva del portale di AWS accesso affinché l'SDK utilizzi l'autenticazione IAM Identity Center per risolvere le credenziali. Esegui il seguente comando in AWS CLI per accedere al portale di accesso. AWS
```
aws sso login
```
Poiché si dispone di una configurazione predefinita del profilo, non è necessario chiamare il comando con un'`--profile`opzione. Se la configurazione del provider di token SSO utilizza un profilo denominato, il comando è`aws sso login --profile named-profile`.
Per verificare se hai già una sessione attiva, esegui il seguente comando AWS CLI .
```
aws sts get-caller-identity
```
La risposta a questo comando dovrebbe restituire l'account IAM Identity Center e il set di autorizzazioni configurati nel file `config` condiviso.
**Nota**
Se hai già una sessione attiva del portale di accesso AWS e hai già eseguito `aws sso login`, non ti verrà richiesto di fornire credenziali.
Tuttavia, verrà visualizzata una finestra di dialogo che richiede l'autorizzazione per accedere `botocore` alle informazioni. `botocore`è la base per AWS CLI .
Seleziona **Consenti** per autorizzare l'accesso alle tue informazioni per AWS CLI e SDK per Kotlin.
## Installa Java e uno strumento di compilazione
Il tuo ambiente di sviluppo richiede quanto segue:
+ JDK 8 o versione successiva. AWS SDK per Kotlin [Funziona con l'[Oracle Java SE Development Kit](https://www.oracle.com/java/technologies/javase-downloads.html) e con le distribuzioni di Open Java Development Kit (OpenJDK) come [Amazon Corretto](https://aws.amazon.com/corretto/)[Red](https://developers.redhat.com/products/openjdk) Hat OpenJDK e JDK. AdoptOpen](https://adoptopenjdk.net/)
+ Uno strumento di compilazione o IDE che supporta Maven Central come Apache Maven, Gradle o IntelliJ.
+ [Per informazioni su come installare e utilizzare Maven, consulta http://maven.apache.org/.](http://maven.apache.org/)
+ [Per informazioni su come installare e usare Gradle, vedi https://gradle.org/.](https://gradle.org/)
+ Per informazioni su come installare e utilizzare IntelliJ IDEA, vedere. [https://www.jetbrains.com/idea/](https://www.jetbrains.com/idea/)
## Utilizzo di credenziali temporanee
In alternativa alla [configurazione dell'accesso Single Sign-On di IAM Identity Center per l'](#setup-sso-access)SDK, puoi configurare il tuo ambiente di sviluppo con credenziali temporanee.
**Configura un file di credenziali locale per credenziali temporanee**
1. [Crea un file di credenziali condiviso](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html)
1. Nel file delle credenziali, incolla il seguente testo segnaposto finché non incolli le credenziali temporanee funzionanti:
```
[default]
aws_access_key_id=
aws_secret_access_key=
aws_session_token=
```
1. Salvare il file. Il file `~/.aws/credentials` dovrebbe ora esistere sul tuo sistema di sviluppo locale. Questo file contiene il [profilo [predefinito]](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) che l'SDK per Kotlin utilizza se non viene specificato un profilo denominato specifico.
1. [Accedi al portale di accesso AWS](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosignin.html)
1. Segui queste istruzioni sotto l'intestazione [Aggiornamento manuale delle credenziali](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html#how-to-get-temp-credentials) per copiare le credenziali del ruolo IAM dal AWS portale di accesso.
1. Per la fase 4 delle istruzioni collegate, scegli il nome del ruolo IAM che concede l'accesso per le tue esigenze di sviluppo. Questo ruolo in genere ha un nome simile **PowerUserAccess**a **Developer**.
1. Per il passaggio 7, seleziona l'opzione **Aggiungi manualmente un profilo al file delle AWS credenziali** e copia il contenuto.
1. Incolla le credenziali copiate nel `credentials` file locale e rimuovi il nome del profilo generato. Il file dovrebbe essere simile al seguente:
```
[default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
```
1. Salva il file `credentials`
L'SDK per Kotlin accederà a queste credenziali temporanee quando creerà un client di servizio e le utilizzerà per ogni richiesta. Le impostazioni per il ruolo IAM scelto nella fase 5a determinano per [quanto tempo sono valide le](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosessionduration.html) credenziali temporanee. La durata massima è di dodici ore.
Dopo la scadenza delle credenziali temporanee, ripeti i passaggi da 4 a 7.