

A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).

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 e login no CodeCatalyst
<a name="setting-up-topnode"></a>

Há dois tipos de espaço que você pode configurar no CodeCatalyst: espaços compatíveis com usuários do ID do builder AWS e criar um espaço compatível com a federação de identidades, onde usuários e grupos de SSO são gerenciados no Centro de Identidade do IAM. Os usuários em um espaço do ID do builder AWS entram no CodeCatalyst com seu ID do builder AWS, e os usuários em um espaço configurado para federação de identidades fazem login no CodeCatalyst usando o portal SSO da empresa associada ao espaço.

**nota**  
Os nomes de usuário do CodeCatalyst têm um comprimento mínimo de 3 e máximo de 100 caracteres. Nomes de usuário com mais de 100 caracteres fornecidos ficarão truncados. Isso pode resultar em um nome de usuário que parece ser uma duplicata de outro nome de usuário de 100 caracteres. Para obter mais informações, consulte [Não consigo acessar meu espaço BID como um novo usuário ou não posso ser adicionado como um novo usuário de SSO devido ao nome de usuário truncado](troubleshooting.md#troubleshoot-username-truncated).

As etapas para configurar e administrar um espaço de ID do builder AWS são fornecidas neste guia. Para trabalhar com um espaço de ID do builder AWS do CodeCatalyst, configure o CodeCatalyst usando as configurações do usuário e o ID do builder AWS que você usa para entrar no CodeCatalyst. 

As etapas para configurar e administrar um espaço compatível com a federação de identidades são fornecidas no *Guia do administrador do CodeCatalyst*. Para trabalhar com espaços configurados para federação de identidades, consulte [Configuração e administração de espaços do CodeCatalyst](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/what-is.html) no Guia do administrador do Amazon CodeCatalyst.

Esta seção fornece dois caminhos comuns para configurar o trabalho no Amazon CodeCatalyst com um espaço de ID do builder AWS: criar um espaço e um projeto como primeiro usuário e aceitar um convite para um espaço ou projeto existente. Esses fluxos de trabalho de configuração são necessariamente bem diferentes. O diagrama a seguir mostra os dois processos de inscrição da seguinte forma: 

1. No primeiro caso, você cria e configura um espaço para sua empresa, equipe ou grupo e cria um projeto antes de convidar outras pessoas para esses recursos. Uma Conta da AWS deve ser fornecida para fins de faturamento, onde você ainda pode usar o nível gratuito como padrão.

1. No segundo caso, se você entrar no CodeCatalyst aceitando um convite para um projeto, outra pessoa já criou um espaço e um projeto para você. No entanto, você ainda desejará configurar seu perfil para estar pronto para começar a trabalhar com outras pessoas.

![\[Inscrição e criação de um espaço no qual você possa convidar membros para participar\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/sign-up-types.png)


**dica**  
O CodeCatalyst usa espaços para agrupar projetos e recursos. Ao se inscrever pela primeira vez no CodeCatalyst, você será solicitado a criar um espaço e um projeto.

Se você se inscrever para criar um espaço e um projeto ou se inscrever como parte da aceitação de um convite, você cria um ID do builder AWS que usará para fazer login no CodeCatalyst. Para criar um ID do builder AWS, você fornece o nome completo, a senha e o endereço de e-mail usado para entrar nas aplicações da AWS. Use o e-mail e a senha para entrar no CodeCatalyst após esse ponto. Você também pode usar esse ID do builder AWS para fazer login em outras aplicações que usam as credenciais do ID do builder AWS.

No CodeCatalyst e no ID do builder AWS, um *perfil* é gerado com base nas suas informações de login. Seu perfil contém suas preferências do CodeCatalyst para configurações de idioma e notificação em seus projetos do CodeCatalyst.

**dica**  
Se você encontrar algum problema ao se inscrever no perfil do Amazon CodeCatalyst, siga as etapas fornecidas nesta página. Se precisar de mais ajuda, consulte [Problemas de inscrição](ipa-troubleshooting.md#id-troubleshooting-sign-up).

**Topics**
+ [Criar um espaço e perfil de desenvolvimento (começando sem um convite)](sign-up-create-resources.md)
+ [Aceitando um convite e criando um AWS Builder ID](sign-up-sign-in.md)
+ [Login com um ID do builder AWS](id-how-to-sign-in.md)
+ [Fazer login com SSO](sign-in-sso.md)
+ [Visualização de todos os espaços e projetos de um usuário](home.md)
+ [Visualizando e gerenciando CodeCatalyst perfis](view-profiles.md)
+ [Configurando para usar o AWS CLI com CodeCatalyst](set-up-cli.md)

# Criar um espaço e perfil de desenvolvimento (começando sem um convite)
<a name="sign-up-create-resources"></a>

Você pode se inscrever na Amazon CodeCatalyst sem um convite para um espaço ou projeto existente. Ao fazer isso, você criará um espaço e um projeto depois de criar seu ID de AWS construtor. Como parte da criação de um espaço, você precisará adicionar um Conta da AWS para fins de cobrança.

**dica**  
Se você encontrar algum problema ao se inscrever no seu CodeCatalyst perfil da Amazon, siga as etapas fornecidas nessa página. Se precisar de mais ajuda, consulte [Problemas de inscrição](ipa-troubleshooting.md#id-troubleshooting-sign-up).

Aqui está um fluxo possível para um usuário que está começando CodeCatalyst sem um convite para um projeto ou espaço.

Mary Major é uma desenvolvedora que está interessada CodeCatalyst e decide experimentá-lo. Ela navega até o CodeCatalyst console e escolhe a opção de se inscrever e criar uma ID de AWS construtor. Mary fornece um endereço de e-mail e uma senha para criar sua ID de AWS construtor. Ela poderá usar seu AWS Builder ID para fazer login em CodeCatalyst outros aplicativos. Quando solicitada a escolher um alias, ela especifica `MaryMajor` como o nome de CodeCatalyst usuário que será exibido CodeCatalyst e que outros membros do projeto usarão para @mention Mary.

Depois, Mary é automaticamente direcionada para criar um espaço. Como parte desse fluxo, Mary é convidada a associar an Conta da AWS ao espaço que ela está criando para que ela possa ver o código de amostra em seu primeiro projeto de criação e implantação. Ela adiciona essas informações e cria o espaço, onde escolhe a opção de criar um perfil de desenvolvimento de pré-visualização que pode ser usado para projetos no novo espaço. Mary opta por criar um projeto e, depois, visualiza uma lista de esquemas para projetos. Depois de analisar as informações dos esquemas disponíveis, ela decide experimentar o esquema de **aplicação web moderna de três níveis** para o primeiro projeto. Ela preenche os campos obrigatórios e cria o projeto. Assim que o projeto estiver pronto, ela será direcionada para uma página de resumo do projeto que inclui atividades recentes, bem como links para o código do projeto e o fluxo de trabalho que compila e implanta automaticamente esse código. Ela explora o código e o fluxo de trabalho, inclusive a visualização da aplicação web de exemplo implantada. Gostando do que vê, ela decide convidar alguns de seus colegas de trabalho para o projeto para começar a explorar. CodeCatalyst

Quando ela tem um momento, Mary configura seu AWS Builder ID para fazer login CodeCatalyst com autenticação multifator (MFA). Com o MFA configurado, Mary pode fazer login CodeCatalyst usando uma combinação de sua CodeCatalyst senha e uma senha ou token de um aplicativo de autenticação de terceiros aprovado.

## Criar um espaço e perfis do IAM
<a name="sign-up-first"></a>

Siga estas etapas para se inscrever no seu CodeCatalyst perfil da Amazon, criar um espaço e adicionar uma conta, uma função de suporte e uma função de desenvolvedor ao seu espaço.

O procedimento final cria e adiciona o perfil de desenvolvedor. A função de desenvolvedor é uma função AWS do IAM que permite que seus CodeCatalyst fluxos de trabalho acessem AWS recursos. A função de desenvolvedor é uma função de serviço usada para gerenciar Serviços da AWS e será criada na conta que está conectada. O perfil de serviço é um [perfil do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) que um serviço assume para executar ações em seu nome. Um administrador do IAM pode criar, modificar e excluir um perfil de serviço do IAM. O perfil terá um nome `CodeCatalystWorkflowDevelopmentRole-spaceName`. Para ter mais informações sobre o perfil e a política de perfis, consulte [Noções básicas sobre o perfil de serviço **CodeCatalystWorkflowDevelopmentRole-*spaceName***](ipa-iam-roles.md#ipa-iam-roles-service-role).

**nota**  
Como prática recomendada de segurança, atribua acesso administrativo somente aos usuários administrativos e desenvolvedores que precisam gerenciar o acesso aos AWS recursos no espaço.

Antes de começar, você deve estar pronto para fornecer uma Conta da AWS ID para uma conta na qual tenha privilégios administrativos. Tenha seu Conta da AWS ID de 12 dígitos em mãos. Para obter informações sobre como encontrar seu Conta da AWS ID, consulte [Seu Conta da AWS ID e seu alias](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html).

**Como inscrever um novo usuário**

1. Antes de começar no CodeCatalyst console, abra o Console de gerenciamento da AWS e verifique se você está conectado com o mesmo Conta da AWS que deseja usar para criar seu espaço.

1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Na página de boas-vindas, selecione **Cadastrar-se**. A página **Criar seu ID do builder AWS ** é exibida. Seu AWS Builder ID é uma identidade que você cria para fazer login. Não é o mesmo que um Conta da AWS.

1. Em **Seu endereço de e-mail**, insira o endereço de e-mail ao qual você deseja se associar CodeCatalyst. Escolha **Próximo**.

1. Em **Seu nome**, forneça o nome e o sobrenome que você deseja exibir nos aplicativos em que você usa seu ID do AWS Builder. Espaços são permitidos. Esse será o nome do seu perfil AWS Builder ID, como **Mary Major**. Você pode alterar esse nome depois.

   Escolha **Próximo**. A página **Verificação de e-mail** é exibida. 

1. Um código de verificação será enviado para o e-mail que você especificou. Insira este código em **Código de verificação** e selecione **Verificar**. Se você não receber o código após cinco minutos e não conseguir encontrá-lo nas pastas de spam ou de lixo eletrônico, selecione **Reenviar código**.

1. Depois de verificarmos seu código, insira uma senha que atenda aos requisitos em **Senha** e **Confirmar senha**.

   Marque a caixa de seleção confirmando sua concordância com o Contrato do AWS Cliente e os Termos de AWS Serviço e, em seguida, escolha **Criar ID do AWS Construtor**.

1. Na página **Criar seu CodeCatalyst alias**, insira um alias que você deseja usar como seu identificador de usuário exclusivo. CodeCatalyst Escolha uma versão abreviada do seu nome sem espaços, como **MaryMajor**. Outros CodeCatalyst usuários usarão isso para @mention você em comentários e pull requests. Seu CodeCatalyst perfil conterá seu nome completo do seu ID do AWS Construtor e seu CodeCatalyst alias. Você não pode alterar seu CodeCatalyst alias posteriormente.

   Seu nome completo e seu alias serão exibidos em diferentes áreas em CodeCatalyst. Por exemplo, o nome do seu perfil é exibido para a sua atividade listada no feed de atividades, mas os membros do projeto usarão seu alias para @mencionar você.

   Escolha **Próximo**. A página é atualizada para mostrar a seção **Crie seu CodeCatalyst espaço**.

1. Em **Nome do espaço**, insira o nome do seu espaço. Não é possível alterar essa opção mais tarde.
**nota**  
Os nomes dos espaços devem ser exclusivos em todos os lados CodeCatalyst. Você não pode reutilizar nomes de espaços excluídos.

1. No menu suspenso **Região da AWS**, selecione a região onde você deseja armazenar o espaço e os dados do projeto. Não é possível alterar essa opção mais tarde.

1. Escolha **Próximo**. A página é atualizada para mostrar a página para adicionar uma Conta da AWS. Essa conta será usada como a conta de faturamento do espaço.

1. Em **ID da Conta da AWS **, insira o ID de 12 dígitos da conta que você deseja conectar ao seu espaço.

   Em **Token de verificação da conta da AWS **, copie o ID do token gerado. O token é copiado automaticamente, mas talvez você queira armazená-lo enquanto aprova a solicitação de conexão da AWS .

1. Escolha **Ir para o AWS console para verificar**.

1. A página **Verify Amazon CodeCatalyst Space** é aberta no Console de gerenciamento da AWS. Esta é a página do **Amazon CodeCatalyst Spaces**. Talvez seja necessário fazer login para acessá-la.

   No Console de gerenciamento da AWS, certifique-se de escolher o mesmo Região da AWS local em que deseja criar seu espaço.

   Para acessar diretamente a página, faça login no Amazon CodeCatalyst Spaces Console de gerenciamento da AWS em https://console.aws.amazon.com/codecatalyst/ home/.

   O campo do token de verificação no Console de gerenciamento da AWS é preenchido automaticamente com o token gerado em CodeCatalyst.

1. (Opcional) Em **Níveis pagos autorizados**, selecione **Autorizar níveis pagos (Standard, Enterprise)** para ativar os níveis pagos na conta de faturamento.
**nota**  
Isso não eleva o nível de faturamento para um nível pago. No entanto, isso configura o Conta da AWS para que você possa alterar o nível de cobrança do seu espaço a qualquer momento. CodeCatalyst É possível ativar os níveis pagos a qualquer momento. Sem essa alteração, o espaço só pode usar o nível gratuito.

1. Escolha **Verificar espaço**.

   Uma mensagem de sucesso da **conta verificada** é exibida para mostrar que a conta foi adicionada ao espaço.

1. Permaneça na página **Verify Amazon CodeCatalyst Space**. Selecione o seguinte link: **Para adicionar perfis do IAM para esse espaço, visualizar os detalhes do espaço.**

   A página de conexões com **detalhes do CodeCatalyst espaço** é aberta no Console de gerenciamento da AWS. Esta é a página do **Amazon CodeCatalyst Spaces**. Talvez seja necessário fazer login para acessá-la.

1. Volte para a CodeCatalyst página e escolha **Avançar**. 

1. Uma mensagem de status é exibida enquanto seu espaço está sendo criado. Quando o espaço é criado, CodeCatalyst a seguinte mensagem é exibida: **Seu espaço está pronto. Sua última etapa é criar um projeto.** Você pode executar uma das seguintes ações:
   + Selecione **Ignorar por enquanto**.
   + Selecione **Criar seu primeiro projeto** para seu espaço. Para ver um tutorial que mostra como criar um projeto com um esquema, consulte [Tutorial: Criar um projeto com o esquema de aplicação web moderna de três níveis](getting-started-template-project.md)
**nota**  
Se um erro de permissão ou um banner for exibido, atualize a página e tente visualizá-la novamente.

**Para criar e adicionar o CodeCatalyst **CodeCatalystWorkflowDevelopmentRole-*spaceName*****

1. Antes de começar no CodeCatalyst console, abra o e Console de gerenciamento da AWS, em seguida, verifique se você está logado com o mesmo Conta da AWS em seu espaço.

1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navegue até seu CodeCatalyst espaço. Escolha **Settings (Configurações)** e **Contas da AWS**.

1. Escolha o link para Conta da AWS onde você deseja criar a função. A página **Detalhes da Conta da AWS ** é exibida.

1. Escolha **Gerenciar funções em Console de gerenciamento da AWS**. 

   A página **Adicionar função do IAM ao CodeCatalyst espaço da Amazon** é aberta no Console de gerenciamento da AWS. Esta é a página do **Amazon CodeCatalyst Spaces**. Talvez seja necessário fazer login para acessá-la.

1. Escolha **Criar função CodeCatalyst de administrador de desenvolvimento no IAM**. Essa opção cria um perfil de serviço que contém a política de permissões e a política de confiança para o perfil de desenvolvimento. O perfil terá um nome `CodeCatalystWorkflowDevelopmentRole-spaceName`. Para ter mais informações sobre o perfil e a política de perfis, consulte [Noções básicas sobre o perfil de serviço **CodeCatalystWorkflowDevelopmentRole-*spaceName***](ipa-iam-roles.md#ipa-iam-roles-service-role).
**nota**  
Essa função só é recomendada para uso com contas de desenvolvedor e usa a política `AdministratorAccess` AWS gerenciada, dando a ela acesso total para criar novas políticas e recursos nela Conta da AWS.

1. Selecione **Criar perfil de desenvolvimento**.

1. Na página de conexões, em **Funções do IAM disponíveis para CodeCatalyst**, veja a `CodeCatalystWorkflowDevelopmentRole-spaceName` função na lista de funções do IAM adicionadas à sua conta.

1. Para retornar ao seu espaço, escolha **Go to Amazon CodeCatalyst**.

**Para criar e adicionar o CodeCatalyst **AWSRoleForCodeCatalystSupport****

1. Antes de começar no CodeCatalyst console, abra o e Console de gerenciamento da AWS, em seguida, verifique se você está logado com o mesmo Conta da AWS em seu espaço.

1. Navegue até seu CodeCatalyst espaço. Escolha **Settings (Configurações)** e **Contas da AWS**.

1. Escolha o link para Conta da AWS onde você deseja criar a função. A página **Detalhes da Conta da AWS ** é exibida.

1. Escolha **Gerenciar funções em Console de gerenciamento da AWS**. 

   A página **Adicionar função do IAM ao CodeCatalyst espaço da Amazon** é aberta no Console de gerenciamento da AWS. Esta é a página do **Amazon CodeCatalyst Spaces**. Talvez seja necessário fazer login para acessá-la.

1. Em **detalhes do CodeCatalyst espaço**, escolha **Adicionar função de CodeCatalyst Support**. Essa opção cria um perfil de serviço que contém a política de permissões e a política de confiança para o perfil de desenvolvimento de demonstração. O perfil terá um nome **AWSRoleForCodeCatalystSupport** com um identificador exclusivo anexado. Para ter mais informações sobre o perfil e a política de perfis, consulte [Noções básicas sobre o perfil de serviço **AWSRoleForCodeCatalystSupport**](ipa-iam-roles.md#ipa-iam-roles-support-role).

1. Na página **Adicionar função para CodeCatalyst Support**, deixe o padrão selecionado e escolha **Criar função**.

1. Em **Funções do IAM disponíveis para CodeCatalyst**, veja a `CodeCatalystWorkflowDevelopmentRole-spaceName` função na lista de funções do IAM adicionadas à sua conta.

1. Para retornar ao seu espaço, escolha **Go to Amazon CodeCatalyst**.

Depois de criar seu AWS Builder ID, criar seu primeiro espaço e adicionar uma conta, você poderá criar um projeto. Para obter mais informações, consulte [Como criar um projeto](projects-create.md). Se esta é a primeira vez que você usa CodeCatalyst, sugerimos começar com[Tutorial: Criar um projeto com o esquema de aplicação web moderna de três níveis](getting-started-template-project.md).

# Aceitando um convite e criando um AWS Builder ID
<a name="sign-up-sign-in"></a>

Você pode se inscrever na Amazon CodeCatalyst como parte da aceitação de um convite para um projeto ou espaço. Como parte da aceitação do convite, você será solicitado a criar uma ID do AWS construtor. Você usará seu AWS Builder ID para acessar recursos em CodeCatalyst.

**dica**  
Se precisar de mais ajuda, consulte [Problemas de inscrição](ipa-troubleshooting.md#id-troubleshooting-sign-up).

Aqui está um fluxo possível para um usuário que está começando CodeCatalyst com um convite para um projeto ou espaço.

Saanvi Sarkar é uma desenvolvedora que recebeu um convite para participar de um CodeCatalyst projeto como administradora de projetos. Saanvi aceita o convite, que abre a página de login do. CodeCatalyst Ela opta por se inscrever e fornece um endereço de e-mail e uma senha para criar o ID do builder AWS . Saanvi poderá usar seu AWS Builder ID para fazer login em outros CodeCatalyst aplicativos. Posteriormente, ela pode editar o perfil para alterar o endereço de e-mail ou a senha de login. Quando solicitado a escolher um alias, Saanvi especifica `SaanviSarkar` como o CodeCatalyst alias que será exibido em CodeCatalyst e que outros membros do projeto usarão para @mention Saanvi. Depois de se inscrever, Saanvi também poderá usar suas credenciais de login para outros aplicativos que usam as credenciais do Builder ID. AWS 

Ao concluir a inscrição, a Saanvi se junta automaticamente ao CodeCatalyst projeto e ao espaço especificados no convite. O convite também fornece permissões predeterminadas para os perfis no projeto e no espaço. Nas configurações do projeto, o alias de Saanvi aparece na lista de membros com o perfil atribuído ao projeto. Para trabalhar com repositórios de origem CodeCatalyst, a Saanvi dedica um momento para criar um token de acesso pessoal (PAT). O PAT será usado CodeCatalyst para autenticação ao fazer alterações na fonte ou ações que precisem de um token de autenticação.

Quando Saanvi trabalha em um projeto, seu alias será listado no log de atividades de trabalho do projeto. As edições e comentários de Saanvi mostrarão o alias, e outros membros do projeto poderão usá-lo para @mencioná-la nas respostas. Para @mention, outro membro do projeto, Saanvi procura seu alias em seu perfil. CodeCatalyst 

Quando ela tem um momento, Saanvi configura seu AWS Builder ID para fazer login CodeCatalyst com autenticação multifator (MFA). Com o MFA configurado, Saanvi pode fazer login CodeCatalyst usando uma combinação de sua CodeCatalyst senha e uma senha ou token de um aplicativo de autenticação de terceiros aprovado.

## Aceitando um convite e criando um AWS Builder ID
<a name="id-how-to"></a>

Ao ser convidado para um projeto ou espaço na Amazon CodeCatalyst, você receberá um e-mail de notify@codecatalyst.aws solicitando que você aceite o convite. Se você já tiver uma ID do AWS Builder e estiver conectado CodeCatalyst, escolher **Aceitar convite** abrirá automaticamente o projeto ou o espaço em uma guia do navegador. Se você não estiver conectado ao console, mas tiver um AWS Builder ID, você será direcionado para a página de login. Para obter mais informações, consulte [Login com um ID do builder AWS](id-how-to-sign-in.md).

Se você não tiver um AWS Builder ID, ao escolher **Aceitar convite**, você será direcionado para a página de login, onde deverá escolher a opção de criar seu AWS Builder ID. 

**Importante**  
Ao aceitar um convite e abrir repositórios em ambientes de desenvolvimento, os scripts podem ser executados com acesso às suas CodeCatalyst credenciais. Certifique-se de confiar na fonte antes de continuar.

**Para aceitar um convite e criar uma ID do AWS construtor**

1. No e-mail de convite, selecione **Aceitar convite**.

1. Na página de login, selecione **Não está inscrito? Crie seu ID de AWS construtor**.
**dica**  
Seu AWS Builder ID é uma identidade que você cria para fazer login. Não é o mesmo que uma Conta da AWS.

1. Na página **Criar sua ID do AWS Construtor**, em **Endereço de e-mail**, insira o endereço de e-mail que você deseja usar para sua ID do AWS Construtor. 

   Em **Seu nome**, forneça o nome e o sobrenome que você deseja exibir nos aplicativos em que você usa seu ID do AWS Builder. Espaços são permitidos. Esse será o nome do seu perfil AWS Builder ID, como **Mary Major**. Você pode alterar esse nome depois.

   Escolha **Próximo**.

   Um código de verificação será enviado para o e-mail que você especificou. Insira este código em **Código de verificação** e selecione **Verificar**. Se você não receber o código após cinco minutos e não conseguir encontrá-lo nas pastas de spam ou de lixo eletrônico, selecione **Reenviar código**.

1. Depois que o código for verificado, insira uma senha que atenda aos requisitos em **Senha** e **Confirmar senha**.

1. Escolha **Criar ID do AWS Construtor**.

1. Na página **Criar seu alias**, insira um alias que você deseja usar como seu identificador de usuário exclusivo. CodeCatalyst Escolha uma versão abreviada do seu nome sem espaços, como **MaryMajor**. Outros CodeCatalyst usuários usarão isso para @mention você em comentários e pull requests. Seu CodeCatalyst perfil conterá seu nome completo do seu ID do AWS Construtor e seu CodeCatalyst alias. Você não pode alterar seu CodeCatalyst alias.

   Seu nome completo e seu alias serão exibidos em diferentes áreas em CodeCatalyst. Por exemplo, o nome do perfil é exibido para a sua atividade listada no feed de atividades, mas os membros do projeto usarão seu alias para @mencionar você.

   Escolha **Criar alias**. Você será direcionado para o projeto ou o espaço para o qual foi convidado.

# Login com um ID do builder AWS
<a name="id-how-to-sign-in"></a>

Siga estas etapas para fazer login no seu perfil do Amazon CodeCatalyst.

**nota**  
Você já registrou um dispositivo para autenticação multifator (MFA)? É altamente recomendável configurar a MFA no Amazon CodeCatalyst para aumentar sua segurança. Para obter mais informações, consulte [Como registrar um dispositivo para uso com autenticação multifator](mfa.md#id-how-to-register).

**Para fazer login com o ID do builder AWS**

1. Abra o console do CodeCatalyst em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Digite seu **Endereço de e-mail**. Se desejar, selecione **Salvar meu endereço de e-mail** se quiser salvar seu endereço de e-mail para futuros logins. Escolha **Continuar**.

1. Insira a **Senha**. Escolha **Logon**. Caso não se lembre da sua senha, siga as etapas em [Esqueci minha senha](troubleshooting.md#id-forgot-password).

## Dispositivos confiáveis
<a name="id-trusted-device"></a>

Depois que você escolhe a opção **Este é um dispositivo confiável** na página de login, o Amazon CodeCatalyst considera todos os logins futuros desse dispositivo como autorizados. O Amazon CodeCatalyst não apresentará a opção de inserir um código de MFA enquanto você estiver usando esse dispositivo confiável. Algumas exceções incluem fazer login em um novo navegador ou quando seu dispositivo recebe um endereço IP desconhecido.

# Fazer login com SSO
<a name="sign-in-sso"></a>

Siga estas etapas para usar o SSO para fazer login no Amazon CodeCatalyst.

Para fazer login com seu ID do builder AWS, consulte [Login com um ID do builder AWS](id-how-to-sign-in.md).

**Como fazer login com SSO**

1. Abra o console do CodeCatalyst em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Em **Selecionar uma opção de login**, selecione **Usar autenticação única (SSO)**.

1. Em **Nome da aplicação do Centro de Identidade da AWS**, insira o nome da aplicação fornecida pelo administrador da federação de identidades.

1. Selecione **Continuar com o Centro de Identidade do IAM**.

# Visualização de todos os espaços e projetos de um usuário
<a name="home"></a>

Você pode ver uma lista de seus espaços e projetos na página inicial do usuário. A página inicial do usuário mostra uma lista de cada espaço ao qual o usuário pertence, o perfil do usuário nesse espaço, como **Administrador do espaço**, e os projetos em cada espaço de que o usuário é membro.

1. Abra o console do CodeCatalyst em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. No navegador, digite o seguinte endereço: [https://codecatalyst.aws/home](https://codecatalyst.aws/home)   
![\[A página inicial do usuário lista todos os espaços e projetos nos quais você é membro\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/user_home.png)

1. Escolha o espaço ou projeto que você deseja abrir. Se você não encontrar um espaço ou projeto que esperava ver, talvez seja necessário fazer login como um usuário diferente.

# Visualizando e gerenciando CodeCatalyst perfis
<a name="view-profiles"></a>

Você pode visualizar perfis de usuário na Amazon CodeCatalyst para obter informações como endereços de e-mail e CodeCatalyst aliases. Você também pode atualizar seu perfil e seu ID do AWS Construtor. Se você esquecer sua senha, poderá solicitar uma redefinição de senha.

## Visualizando seu CodeCatalyst perfil
<a name="view-your-profile"></a>

Você fornece informações no momento da inscrição que serão usadas como suas credenciais para fazer login na Amazon CodeCatalyst e que serão gerenciadas em seu perfil. Isso inclui seu **nome**, **apelido** e o **endereço de e-mail** que você usa para fazer CodeCatalyst login.

**nota**  
O **apelido** do AWS Builder ID não é seu CodeCatalyst alias. Você selecionou seu CodeCatalyst alias na inscrição.

**Para ver seu CodeCatalyst perfil**

1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. No canto superior direito, selecione a seta ao lado do ícone com sua primeira inicial e, depois, selecione **Minhas configurações**. A página CodeCatalyst **Minhas configurações** é aberta.

1. Para atualizar seu endereço de e-mail ou senha do AWS Builder ID, ou para configurar o MFA, escolha **Gerenciar ID do AWS Builder**. A página AWS Builder ID é aberta.

## Visualizando o CodeCatalyst perfil de outro usuário
<a name="view-another-user-profile"></a>

**Para ver o CodeCatalyst perfil de outro usuário**

1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. No painel de navegação lateral, selecione **Configurações do projeto**. Escolha a guia **Membros**. Veja a lista de membros do seu CodeCatalyst projeto.

1. Selecione o nome do membro que deseja pesquisar ou @mencione. A página **Minhas configurações** mostra o alias, o endereço de e-mail e o nome completo do usuário. Use o CodeCatalyst alias para os membros do projeto @mention.
**nota**  
O **apelido** do AWS Builder ID de um usuário não é seu CodeCatalyst alias. Eles selecionaram seu CodeCatalyst alias no momento da inscrição.

   Para visualizar o perfil de outro usuário em seu projeto, selecione o nome dele na lista. 

# Atualização de um perfil
<a name="your-profile"></a>

Em CodeCatalyst, seu perfil consiste em informações  pessoais gerenciadas pelo **AWS Builder ID** e configurações gerenciadas em CodeCatalyst.
+ O nome completo, endereço de e-mail e senha do seu perfil são gerenciados pelo **ID do builder AWS **. Você inseriu essas informações ao se inscrever. **Quando você configura o MFA para usar um aplicativo autenticador para login no aplicativo, você acessa a página CodeCatalyst Builder ID.AWS **
+ CodeCatalyst as configurações do seu token de acesso pessoal (PAT), CodeCatalyst notificações e preferências de idioma são gerenciadas na página **Minhas configurações** em CodeCatalyst. Para obter mais informações, consulte [Conceder aos usuários acesso ao repositório com tokens de acesso pessoal](ipa-tokens-keys.md).

**nota**  
Você pode atualizar seu nome completo do AWS Builder ID (nome de CodeCatalyst exibição) e primeiro nome. No entanto, você não pode alterar seu CodeCatalyst alias.

## Atualização de uma ID ou endereço de e-mail do AWS Builder
<a name="id-update-profile"></a>

**Para atualizar seu endereço ID do builder AWS ou endereço de e-mail**

1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. No canto superior direito, selecione a seta ao lado do ícone com sua primeira inicial e, depois, selecione **Minhas configurações**. A página CodeCatalyst **Minhas configurações** é aberta.

1. Na página de perfil, escolha **Gerenciar ID do AWS Builder**. A página **ID do builder AWS ** é aberta.

1. No lado esquerdo da página, selecione **Meus detalhes**.

1. Em **Informações do perfil**, selecione **Editar** para atualizar seu **Nome** ou **Apelido**. Se você não especificou um apelido, o campo **Apelido** será preenchido com o primeiro nome no nome completo. Não é seu CodeCatalyst pseudônimo.
**nota**  
Isso atualiza o nome completo e o primeiro nome do AWS Builder ID. Isso não atualiza seu CodeCatalyst alias.

   Em **Informações de contato**, selecione **Editar** para atualizar seu **Endereço de e-mail**. 
**nota**  
Isso atualiza o endereço de e-mail que você usará para fazer login CodeCatalyst.

# Alteração de uma senha do CodeCatalyst associada a um ID do builder AWS
<a name="id-change-password"></a>

Use as instruções a seguir para alterar a senha do Amazon CodeCatalyst associada ao ID do builder AWS.

**nota**  
Se você estiver usando o SSO para entrar no CodeCatalyst, entre em contato com o administrador sobre como alterar sua senha.

**Para alterar sua senha do CodeCatalyst**

1. Abra o console do CodeCatalyst em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. No canto superior direito, escolha a seta ao lado do ícone com sua primeira inicial e, depois, selecione **Perfil do usuário**. A página **Minhas configurações** do CodeCatalyst é aberta.

1. Na página de perfil, selecione **Gerenciar ID do builder AWS**. A página ID do builder AWS é aberta.

1. No lado esquerdo da página, selecione **Segurança**.

1. Selecione **Alterar senha** e siga as instruções.

# Configurando para usar o AWS CLI com CodeCatalyst
<a name="set-up-cli"></a>

O CodeCatalyst console da Amazon é onde você trabalhará na maioria das suas tarefas diárias. No entanto, talvez você queira configurar e configurar o AWS CLI quando estiver trabalhando com ambientes de desenvolvimento, tokens de acesso pessoal ou registros de eventos em CodeCatalyst. Você deve instalar AWS CLI e configurar um perfil antes de poder usá-lo com CodeCatalyst.<a name="how-to-set-up-cli"></a>

# Para configurar o AWS CLI para CodeCatalyst
<a name="how-to-set-up-cli"></a>

1. Instale a versão mais recente do AWS CLI. Se você já tiver uma versão do AWS CLI instalado, verifique se ela é recente e inclui comandos para CodeCatalyst, e atualize-a se necessário. Para verificar se você tem uma versão instalada que inclui CodeCatalyst comandos, abra um prompt de comando e execute o seguinte comando:

   ```
   aws codecatalyst help
   ```

   Se você ver uma lista de CodeCatalyst comandos, você tem uma versão compatível CodeCatalyst. Se o comando não for reconhecido, atualize sua versão do AWS CLI para a versão mais recente. Para obter mais informações, consulte [Instalando ou atualizando a versão mais recente do AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) no Guia AWS Command Line Interface do Usuário.

1. Execute o **aws configure** comando para criar um perfil se você não tiver um ou se quiser usar um perfil nomeado especificamente para CodeCatalyst. Recomendamos criar um perfil nomeado para usar especificamente CodeCatalyst, mas você também pode usar o perfil padrão. Para obter mais informações, consulte [Noções básicas de configuração](https://docs.aws.amazon.com//cli/latest/userguide/cli-configure-quickstart.html).

1. Edite o `config` arquivo do perfil para adicionar uma seção à qual se conectar da CodeCatalyst seguinte maneira. O arquivo `config` está localizado em `~/.aws/config` no Linux ou MacOS ou em `C:\Users\USERNAME\.aws\config` no Windows.

   ```
   [profile codecatalyst]
   region = us-west-2
   sso_session = codecatalyst
   
   [sso-session codecatalyst]
   sso_region = us-east-1
   sso_start_url = https://view.awsapps.com/start
   sso_registration_scopes = codecatalyst:read_write
   ```

1. Salve o arquivo.

1. Antes de tentar executar qualquer CodeCatalyst comando, abra um novo terminal ou prompt de comando e execute o comando a seguir para solicitar e recuperar credenciais para executar comandos. `aws codecatalyst` Substitua `codecatalyst` pelo nome do seu perfil, se necessário.

   ```
   aws sso login --profile codecatalyst
   ```

Para ver exemplos de comandos **codecatalyst**, consulte os seguintes tópicos:
+ [Conceder aos usuários acesso ao repositório com tokens de acesso pessoal](ipa-tokens-keys.md)
+ [Acesso a eventos de logs usando o registro de eventos](ipa-logs.md)