As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Configuração básica
## Visão geral do
Para desenvolver com sucesso aplicativos que acessem Serviços da AWS usando o AWS SDK para Kotlin, os seguintes requisitos devem ser atendidos.
+ Você deve conseguir [entrar no portal de acesso da AWS](#setup-awsaccount) disponível em Centro de Identidade do AWS IAM.
+ As [permissões da função do IAM](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html) configurada para o SDK devem permitir o acesso ao Serviços da AWS que seu aplicativo exige. As permissões associadas à política **PowerUserAccess** AWS gerenciada são suficientes para a maioria das necessidades de desenvolvimento.
+ Um ambiente de desenvolvimento com os seguintes elementos:
+ [Arquivos de configuração compartilhados](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) que são configurados de pelo menos uma das seguintes formas:
+ O arquivo `config` contém as [configurações de login único do Centro de Identidade do IAM](#setup-sso-access) para que o SDK possa obter as credenciais da AWS .
+ O arquivo `credentials` contém credenciais temporárias.
+ Uma [instalação do Java 8](#setup-envtools) ou posterior.
+ Uma [ferramenta de automação de compilação](#setup-envtools), como [Maven](https://maven.apache.org/download.cgi) ou [Gradle](https://gradle.org/install/).
+ Um editor de texto para trabalhar com código.
+ [(Opcional, mas recomendado) Um IDE (ambiente de desenvolvimento integrado), como [IntelliJ IDEA](https://www.jetbrains.com/idea/download/#section=windows) ou Eclipse.](https://www.eclipse.org/ide/)
Ao usar um IDE, você também pode integrar AWS Toolkit s para trabalhar com mais facilidade Serviços da AWS. O [AWS Toolkit para 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)são dois kits de ferramentas que você pode usar.
+ Uma sessão ativa do portal de AWS acesso quando você estiver pronto para executar seu aplicativo. Você usa o AWS Command Line Interface para [iniciar o processo de login no portal](#setup-login-sso) de acesso do IAM Identity Center. AWS
**Importante**
As instruções nesta seção de configuração pressupõem que você ou a organização usam o IAM Identity Center. Se sua organização usa um provedor de identidade externo que funciona independentemente do IAM Identity Center, descubra como você pode obter credenciais temporárias para o SDK para Kotlin usar. Siga estas instruções para adicionar credenciais temporárias ao `~/.aws/credentials` arquivo.
Se seu provedor de identidade adicionar credenciais temporárias automaticamente ao arquivo `~/.aws/credentials`, certifique-se de que o nome do perfil seja `[default]` para que você não precise fornecer um nome de perfil ao SDK ou à AWS CLI.
## Capacidade de login no portal de acesso AWS
O portal de AWS acesso é o local da web em que você faz login manualmente no IAM Identity Center. O formato do URL é `d-xxxxxxxxxx.awsapps.com/start` ou`your_subdomain.awsapps.com/start`.
Se você não estiver familiarizado com o portal de AWS acesso, siga as orientações para acesso à conta no tópico de [autenticação do IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html) no Guia de referência de ferramentas AWS SDKs e ferramentas.
## Configurar acesso de logon único para o SDK
Depois de concluir a etapa 2 na [seção de acesso programático](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html#idcGettingStarted) para que o SDK use a autenticação do Centro de Identidade do IAM, o sistema deve conter os elementos a seguir.
+ O AWS CLI, que você usa para iniciar uma [sessão do portal de AWS acesso](#setup-login-sso) antes de executar seu aplicativo.
+ Um arquivo `~/.aws/config` que contém um [perfil padrão](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile). O SDK para Kotlin usa a configuração do provedor de token SSO do perfil para adquirir credenciais antes de enviar solicitações para. AWS O valor `sso_role_name`, que é um perfil do IAM conectado a um conjunto de permissões do Centro de Identidade do IAM, deve permitir o acesso a Serviços da AWS usado na aplicação.
O arquivo `config` de exemplo a seguir mostra um perfil padrão configurado com o provedor de token de SSO. A configuração `sso_session` do perfil se refere à seção chamada `sso-session`. A `sso-session` seção contém configurações para iniciar uma sessão do portal de AWS acesso.
```
[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
```
Para obter mais detalhes sobre as configurações usadas na configuração do provedor de token SSO, consulte Configuração do [provedor de token SSO](https://docs.aws.amazon.com/sdkref/latest/guide/feature-sso-credentials.html#sso-token-config) no Guia de referência AWS SDKs de ferramentas.
Se seu ambiente de desenvolvimento não estiver configurado para acesso programático conforme mostrado anteriormente, siga a [Etapa 2 no Guia de SDKs referência](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html#idcGettingStarted).
## Faça login usando o AWS CLI
Antes de executar um aplicativo que acessa Serviços da AWS, você precisa de uma sessão ativa do portal de AWS acesso para que o SDK use a autenticação do IAM Identity Center para resolver as credenciais. Execute o comando a seguir no AWS CLI para entrar no portal de AWS acesso.
```
aws sso login
```
Como você tem uma configuração de perfil padrão, não precisa chamar o comando com uma `--profile` opção. Se a configuração do seu provedor de token SSO usa um perfil nomeado, o comando é`aws sso login --profile named-profile`.
Para testar se você já tem uma sessão ativa, execute o comando da AWS CLI a seguir.
```
aws sts get-caller-identity
```
A resposta a esse comando deve relatar a conta do Centro de Identidade do IAM e o conjunto de permissões configurados no arquivo compartilhado `config`.
**nota**
Se você já tiver uma sessão ativa do portal de acesso da AWS e executar `aws sso login`, não será necessário fornecer credenciais.
No entanto, você verá uma caixa de diálogo solicitando permissão para que o `botocore` acesse suas informações. O `botocore` é a base para a AWS CLI .
Selecione **Permitir** para autorizar o acesso às suas informações para o AWS CLI e o SDK para Kotlin.
## Instale o Java e uma ferramenta de compilação
Seu ambiente de desenvolvimento necessita do seguinte:
+ JDK 8 ou posterior. AWS SDK para Kotlin [Funciona com o [Oracle Java SE Development Kit](https://www.oracle.com/java/technologies/javase-downloads.html) e com distribuições do Open Java Development Kit (OpenJDK) [Amazon Corretto](https://aws.amazon.com/corretto/), como [Red](https://developers.redhat.com/products/openjdk) Hat OpenJDK e JDK. AdoptOpen](https://adoptopenjdk.net/)
+ Uma ferramenta de compilação ou IDE compatível com o Maven Central, como Apache Maven, Gradle ou IntelliJ.
+ Para obter informações sobre como instalar e usar o Maven, consulte [http://maven.apache.org/](http://maven.apache.org/).
+ Para obter informações sobre como instalar e usar o Gradle, consulte [https://gradle.org/](https://gradle.org/).
+ Para obter informações sobre como instalar e usar o IntelliJ IDEA, consulte. [https://www.jetbrains.com/idea/](https://www.jetbrains.com/idea/)
## Usar credenciais temporárias
Como alternativa à [configuração do acesso de login único do IAM Identity Center](#setup-sso-access) para o SDK, você pode configurar seu ambiente de desenvolvimento com credenciais temporárias.
**Configurar um arquivo de credenciais local para credenciais temporárias**
1. [Criar um arquivo de credenciais compartilhadas](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html)
1. No arquivo de credenciais, cole o seguinte texto de espaço reservado até colar as credenciais temporárias de trabalho:
```
[default]
aws_access_key_id=
aws_secret_access_key=
aws_session_token=
```
1. Salve o arquivo. Agora, o arquivo `~/.aws/credentials` deve existir em seu sistema de desenvolvimento local. Esse arquivo contém o [perfil [padrão]](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) que o SDK para Kotlin usa se um perfil nomeado específico não for especificado.
1. [Faça login no portal de AWS acesso](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosignin.html)
1. Siga essas instruções no título [Atualização manual de credenciais](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html#how-to-get-temp-credentials) para copiar as credenciais da função do IAM do AWS portal de acesso.
1. Na etapa 4 das instruções vinculadas, escolha o nome do perfil do IAM que concede acesso para suas necessidades de desenvolvimento. Essa função geralmente tem um nome como **PowerUserAccess**ou **Desenvolvedor**.
1. Na etapa 7, selecione a opção **Adicionar manualmente um perfil ao seu arquivo de credenciais da AWS ** e copie o conteúdo.
1. Cole as credenciais copiadas em seu arquivo `credentials` local e remova o nome do perfil gerado. Seu arquivo deve se parecer com o seguinte:
```
[default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
```
1. Salve o arquivo `credentials`
O SDK para Kotlin acessará essas credenciais temporárias ao criar um cliente de serviço e usá-las para cada solicitação. As configurações do perfil do IAM escolhidas na etapa 5a determinam [por quanto tempo as credenciais temporárias são válidas](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosessionduration.html). A duração máxima é de doze horas.
Depois que as credenciais temporárias expirarem, repita as etapas de 4 a 7.