# Autenticação e acesso para o AWS Toolkit for JetBrains
Não é necessário realizar a autenticação com a AWS para começar a trabalhar com o AWS Toolkit for JetBrains. No entanto, a maioria dos recursos da AWS são gerenciados por meio de uma conta da AWS. Para acessar todos os serviços e atributos do AWS Toolkit for JetBrains, você precisará de pelo menos de dois tipos de autenticação da conta:
1. Ou a autenticação do **AWS Identity and Access Management (IAM)** ou a do **Centro de Identidade do AWS IAM** para suas contas da AWS. A maioria dos serviços e recursos da AWS é gerenciada por meio do IAM e do Centro de Identidade do IAM.
1. Um **ID do AWS Builder** é opcional para alguns serviços da AWS.
Os tópicos a seguir contêm detalhes adicionais e instruções de configuração para cada tipo de credencial e método de autenticação.
**Topics**
+ [Centro de Identidade do AWS IAM](identity-center.md)
+ [Credenciais do IAM](setup-credentials.md)
+ [ID do AWS Builder](builder-id.md)
# Centro de Identidade do AWS IAM
O Centro de Identidade do AWS IAM é a melhor prática recomendada para gerenciar a autenticação da sua conta AWS.
Para obter instruções detalhadas sobre como configurar o Centro de Identidade do IAM para kits de desenvolvimento de software (SDKs) e o AWS Toolkit for JetBrains, consulte a seção [IAM Identity Center authentication](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html) no *Guia de referência de SDKs e ferramentas da AWS*.
## Como fazer login com o Centro de Identidade do IAM no AWS Toolkit for JetBrains
Conclua as etapas a seguir para efetuar a autenticação com sua conta da AWS usando as credenciais existentes do Centro de Identidade do IAM, no AWS Toolkit for JetBrains.
**nota**
Esse processo inicia o portal do Centro de Identidade do AWS IAM em seu navegador preferencial. Toda vez que suas credenciais expirarem, esse processo deverá ser repetido para renovar a conexão entre sua conta da AWS e o AWS Toolkit for JetBrains.
1. No AWS Toolkit for JetBrains, abra **Configurações de conexão da AWS** escolhendo o ícone **...** (reticências).
1. No menu **Configurações de conexão da AWS**, escolha **Adicionar nova conexão...** para abrir a caixa de diálogo **Kit de ferramentas do AWS: adicionar conexão**.
1. Na caixa de diálogo **Kit de ferramentas da AWS: adicionar conexão**, selecione o botão radial **Conectar usando o Centro de Identidade do AWS IAM**, insira seu URL do portal do Centro de Identidade do IAM no campo de texto **Iniciar URL:** e, em seguida, escolha **Conectar** para continuar.
1. Quando solicitado, confirme que você deseja abrir o portal do Centro de Identidade do IAM em seu navegador preferencial e siga as instruções para concluir o processo de autenticação. Você receberá uma notificação quando o processo de autenticação for concluído e for seguro fechar a janela do navegador.
# AWS Credenciais do IAM
As credenciais de usuário do AWS IAM são autenticadas com sua conta da AWS por meio de chaves de acesso armazenadas localmente.
As seções a seguir descrevem como configurar o AWS Toolkit for JetBrains para se autenticar com sua conta da AWS por meio das credenciais de usuário do IAM.
**Importante**
Antes de configurar as credenciais do IAM para se autenticar com sua conta da AWS, observe que:
Se você já definiu as credenciais do IAM por meio de outro serviço da AWS (como a AWS CLI), então o AWS Toolkit for JetBrains detecta automaticamente essas credenciais e as disponibiliza.
A AWS recomenda usar a autenticação do Centro de Identidade do IAM. Para obter informações adicionais sobre práticas recomendadas no AWS IAM, consulte a seção [Práticas recomendadas de segurança no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) do Guia do usuário do AWS *Identity and Access Management*.
Para evitar riscos de segurança, não use usuários do IAM para autenticação ao desenvolver software com propósito específico ou trabalhar com dados reais. Em vez disso, use federação com um provedor de identidade, como [What is IAM Identity Center?](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html) no *Guia do usuário do Centro de Identidade do AWS IAM*.
## Pré-requisitos
Antes de configurar o AWS Toolkit for JetBrains para se autenticar com as credenciais de usuário do IAM, certifique-se de que os pré-requisitos a seguir sejam atendidos. Se você já configurou as credenciais de usuário do IAM por meio de outro serviço (como a AWS Command Line Interface), então você pode pular as etapas de pré-requisito e prosseguir para as seções posteriores.
1. **Criar um usuário do IAM** Para obter instruções detalhadas sobre como criar um usuário do IAM, consulte [Etapa 1: criar o usuário do IAM](https://docs.aws.amazon.com/sdkref/latest/guide/access-iam-users.html#step1authIamUser) no *Guia de referência de SDKs e ferramentas da AWS*.
1. **Obter as chaves de acesso de usuário do IAM**. Para obter instruções detalhadas sobre como obter suas chaves de acesso de usuário do IAM, consulte [Etapa 2: obter as chaves de acesso](https://docs.aws.amazon.com/sdkref/latest/guide/access-iam-users.html#stepGetKeys) no *Guia de referência de SDKs e ferramentas da AWS*.
1. **Opcional: atualize o arquivo de credenciais compartilhadas**. Para obter instruções detalhadas sobre como atualizar o arquivo de credenciais compartilhadas, consulte [Etapa 3: atualizar o arquivo de credenciais compartilhadas](https://docs.aws.amazon.com/sdkref/latest/guide/access-iam-users.html#stepauthIamUser) no *Guia de referência de SDKs e ferramentas da AWS*.
**nota**
Se o pré-requisito opcional **Etapa 3: atualizar o arquivo de credenciais compartilhadas** estiver concluído, o AWS Toolkit for JetBrains detectará automaticamente suas credenciais durante o procedimento de **Criação de um arquivo de credenciais compartilhadas no AWS Toolkit for JetBrains** descrito na próxima seção.
## Como criar um arquivo de credenciais compartilhadas no AWS Toolkit for JetBrains
Seu *arquivo de configuração compartilhada* e * o arquivo de credenciais compartilhadas* armazenam informações de configuração e credenciais para suas contas da AWS. Para obter mais informações sobre configuração e credenciais compartilhadas, consulte a seção [Onde as definições de configuração são armazenadas?](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html#cli-configure-files-where) no *Guia do usuário da AWS Command Line Interface*.
**Como criar um arquivo de credenciais compartilhadas no AWS Toolkit for JetBrains**
1. No AWS Toolkit for JetBrains, escolha **\$1 adicionar conexão à AWS** para abrir a caixa de diálogo **Kit de ferramentas da AWS: adicionar conexão**.
1. Na caixa de diálogo **Kit de ferramentas da AWS: adicionar conexão**, escolha **Editar arquivos de credenciais da AWS** para abrir a confirmação **Criar arquivo de credencial**.
1. Na confirmação **Criar arquivo de credencial**, escolha **Criar** para fechar a confirmação e criar seu `credential File`.
1. O `credential File` abre automaticamente em seu IDE quando a criação é concluída.
**nota**
Durante o processo de criação do `Credential File`:
No caso de um erro, o JetBrains exibe uma notificação e abre logs de criação contendo detalhes do erro.
Você pode armazenar todos os seus perfis nomeados em um único arquivo. Se você estiver usando arquivos de credenciais e de configuração, as credenciais serão abertas por padrão no IDE.
Se houver credenciais nos dois arquivos para um perfil que compartilhe o mesmo nome, as chaves no arquivo de credenciais terão precedência.
## Como configurar suas credenciais compartilhadas
O procedimento final para autenticar o AWS Toolkit for JetBrains com sua conta da AWS é configurar suas credenciais.
1. No AWS Toolkit for JetBrains, escolha **\$1 adicionar conexão à AWS** para abrir a caixa de diálogo **Kit de ferramentas da AWS: adicionar conexão**.
1. Na caixa de diálogo **Kit de ferramentas daAWS: adicionar conexão**, escolha **Editar arquivos de credencial da AWS** para abrir seu **Arquivo de credencial**.
1. Quando seu `credentials file` abrir no JetBrains, localize a seção rotulada `[default]`.
1. Na seção `[default]`, localize a entrada `#aws_access_key_id =`, remova o `#` e insira sua chave de acesso da AWS. A entrada deve ser semelhante ao seguinte:
**aws\$1access\$1key\$1id = AKIAIOSFODNN7EXAMPLE**
1. Na seção `[default]`, localize a entrada `#aws_secret_access_key =`, remova o `#` e insira sua chave de acesso secreta da AWS. A entrada deve ser semelhante ao seguinte:
**aws\$1secret\$1access\$1key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY**
O versionamento final do seu arquivo de credenciais atualizado é semelhante ao seguinte:
```
[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. Salve suas alterações no arquivo, o AWS Toolkit for JetBrains detecta automaticamente suas credenciais atualizadas e se conecta à sua conta da AWS.
**aws\$1secret\$1access\$1key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY**
# ID do AWS Builder para desenvolvedores
O ID do AWS Builder é uma conta da AWS opcional ou obrigatória para determinados serviços da AWS. Para obter mais informações sobre como configurar o ID do AWS Builder para serviços específicos, consulte a seção [Serviços de ID do AWS Builder](#builder-id-services) deste guia.
As seções a seguir descrevem como criar e autenticar com o ID do AWS Builder no AWS Toolkit for JetBrains.
## Como configurar um ID do AWS Builder
**Como configurar um ID do AWS Builder no AWS Toolkit for JetBrains**
1. No AWSExplorador da ****, escolha **\$1 Adicionar conexão à AWS** para abrir a caixa de diálogo **Kit de ferramentas da AWS: adicionar conexão**.
1. Na caixa de diálogo **Kit de ferramentas da AWS: adicionar conexão**, escolha **Usar um e-mail pessoal para se cadastrar e fazer login com o ID do AWS Builder** para abrir a caixa de diálogo **Fazer login com o ID do AWS Builder**.
1. Na caixa de diálogo **Fazer login com o ID do AWS Builder**, escolha o botão **Abrir e copiar código** para abrir o site **Solicitação de autorização da AWS** no navegador da Web de sua preferência.
1. No navegador, cole o código de confirmação no campo fornecido e escolha **Próximo** para prosseguir para o site Criar **ID do AWS Builder**.
1. Conclua cada uma das etapas em seu navegador para continuar. Você receberá uma notificação de que é seguro fechar o navegador e retornar ao JetBrains quando o processo for concluído.
1. No JetBrains, o menu suspenso **\$1 Adicionar conexão à AWS** é atualizado, indicando que você se conectou com seu ID do AWS Builder.
## Serviços de ID do AWS Builder
Conectar serviços específicos ao seu ID do AWS Builder pode exigir configuração adicional. Os serviços a seguir são compatíveis com o ID do AWS Builder e acessíveis por meio do AWS Toolkit for JetBrains:
+ **Amazon CodeCatalyst**: para obter informações adicionais sobre como configurar o Amazon CodeCatalyst para o ID do AWS Builder, consulte a seção [Setting up Amazon CodeCatalyst](https://docs.aws.amazon.com/codecatalyst/latest/userguide/setting-up-topnode.html) do Guia do usuário do *Amazon CodeCatalyst*.
+ **Amazon CodeWhisperer**: para obter informações adicionais sobre como configurar o Amazon CodeWhisperer para o ID do AWS Builder, consulte a seção [Setting up Amazon CodeWhisperer for individual developers](https://docs.aws.amazon.com/codewhisperer/latest/userguide/whisper-setup-indv-devs.html) do Guia do usuário do *Amazon Code Whisperer*.