Skip to main content
Credenciais manuais permitem que a Acrity acesse provedores quando um aplicativo conectado ou conector local não é a melhor opção. Use Console > Credenciais para criar, editar, validar, ressincronizar e remover credenciais do workspace.

​
Quando usar

Use credenciais manuais quando:
  • o provedor não oferece fluxo de aplicativo conectado para o caso de uso;
  • um repositório ou PM exige token específico;
  • a organização precisa separar credenciais por time, projeto ou ambiente;
  • uma integração existente ainda depende de token manual.
Quando disponível, prefira Console > Aplicativos conectados para provedores com autorização gerenciada ou Console > Conectores para VCS privados e self-hosted.

​
Quem pode acessar

Trabalhar com credenciais exige um Admin de workspace. Os perfis são conjuntos fixos de capacidades definidos pela Acrity, portanto outros perfis não veem esse menu.

​
Campos principais

​
Criar uma credencial

1

Abrir credenciais

Acesse Console > Credenciais.
2

Criar nova

Escolha Nova credencial.
3

Selecionar provedor

Escolha o provedor correto. A tela exibirá os campos necessários para esse provedor.
4

Preencher dados

Informe nome e campos solicitados. Use o menor escopo possível no provedor de origem.
5

Validar

Execute a validação quando disponível. Corrija mensagens antes de usar a credencial em repositórios.
6

Salvar

Salve a credencial e associe-a aos repositórios ou integrações necessárias.
Lista de credenciais no Console mostrando as credenciais de provedores cadastradas e seu status de validação

​
Editar uma credencial

Ao editar uma credencial, campos sensíveis podem aparecer vazios ou mascarados. Isso evita expor segredos no Console. Para alterar um segredo:
  1. Acesse Console > Credenciais.
  2. Abra a credencial.
  3. Escolha editar.
  4. Preencha o campo sensível que será trocado.
  5. Salve e valide.
Se não quiser trocar um segredo, mantenha o campo conforme a orientação da tela.

​
Validar e ressincronizar

Use validação quando:
  • a credencial acabou de ser criada;
  • o provedor trocou permissões;
  • uma revisão ou conexão falhou;
  • o Console exibe alerta de credencial inválida;
  • o token foi rotacionado no provedor.
Use ressincronização quando a credencial está válida, mas metadados, permissões ou objetos do provedor precisam ser atualizados.

​
Associar credenciais a repositórios

Credenciais podem ser escolhidas ao conectar ou editar repositórios. Fluxo recomendado:
  1. Crie e valide a credencial em Console > Credenciais.
  2. Acesse Console > Repositórios.
  3. Conecte ou abra um repositório.
  4. Selecione a credencial apropriada para VCS ou PM.
  5. Salve e confira o status do repositório.

​
Boas práticas

  • Use um nome que indique provedor, time e finalidade.
  • Evite credenciais pessoais quando a organização puder usar conta de serviço.
  • Aplique o menor conjunto de permissões no provedor.
  • Defina processo de rotação periódica.
  • Remova credenciais não usadas.
  • Prefira aplicativos conectados ou conectores locais quando eles atenderem ao caso de uso.

​
Segurança

Campos sensíveis não são exibidos em texto puro após o cadastro. O armazenamento e a proteção de credenciais são descritos em Segurança > Credenciais e tokens.
Não cole tokens em descrições, nomes de credenciais, nomes de repositórios, templates de webhook ou outros campos não destinados a segredo.

​
Problemas comuns