> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticação

> Faça login no AppSignal CLI com OAuth e gerencie onde suas credenciais são armazenadas.

Antes que a CLI possa acessar seus dados, você precisa fazer login. Ela usa OAuth, um login baseado em navegador, então você nunca precisa copiar ou armazenar um token manualmente.

Você pode verificar se está autenticado a qualquer momento com `appsignal-cli auth status`.

## Fazer login

Execute:

```sh Shell theme={null}
appsignal-cli auth login
```

Isso abre seu navegador para autorizar a CLI com sua conta do AppSignal, depois devolve o controle através de um callback local em `http://127.0.0.1:9789/callback`. Uma vez aprovado, a CLI armazena os tokens e os renova para você, então você não precisará fazer login novamente.

<Note>
  O fluxo do navegador precisa de um navegador na mesma máquina da CLI.
</Note>

## Definir uma organização padrão

Se você pertence a mais de uma organização, defina um padrão enquanto faz login, para não precisar passá-lo em cada comando:

```sh Shell theme={null}
appsignal-cli auth login --org <YOUR_ORG_SLUG>
```

O slug da sua organização é o nome curto na sua URL do AppSignal: `appsignal.com/<org-slug>`. Executar `appsignal-cli apps list` depois de fazer login também salva a organização da sua conta como o padrão.

## Verificar seu status

Para ver se você está autenticado e qual configuração a CLI está lendo, execute:

```sh Shell theme={null}
appsignal-cli auth status
```

`appsignal-cli about` mostra o mesmo status de autenticação junto com sua versão, endpoint e organização padrão.

## Fazer logout

Para remover suas credenciais armazenadas:

```sh Shell theme={null}
appsignal-cli auth logout
```

## Onde suas credenciais ficam

A CLI armazena suas credenciais em um arquivo de configuração global, no diretório de configuração padrão do seu sistema operacional. A localização exata varia por SO, então execute `appsignal-cli auth status` para ver o caminho que a CLI está usando.

### Configuração local do projeto

Você também pode manter a configuração junto com um projeto, em um arquivo `.appsignal.toml` no diretório do projeto. Crie um com:

```sh Shell theme={null}
appsignal-cli project init
```

Uma configuração local do projeto é útil para fixar um repositório a uma organização específica. Para definir a organização padrão para o projeto ao criá-lo:

```sh Shell theme={null}
appsignal-cli project init --org <YOUR_ORG_SLUG>
```

Quando um `.appsignal.toml` local de projeto está presente, a CLI usa o mais próximo como a única configuração para comandos executados nesse diretório ou em seus subdiretórios. Para a lista completa de chaves de configuração e como elas se resolvem, veja [Configuração](/cli/configuration).

<Note>
  `project init` não copia suas credenciais OAuth globais para a configuração do projeto. Após criá-la, execute `appsignal-cli auth login` novamente dentro do projeto para configurar credenciais específicas do projeto.
</Note>

## Próximos passos

Você está autenticado. Em seguida, [liste suas aplicações](/cli/apps) para encontrar as aplicações que você consultará.