Qual a diferença entre chave de Organização e de Projeto?

Entenda a diferença entre os tipos de chaves de integração na Stark Infra

Ao configurar uma integração na Stark Infra, a autenticação entre os sistemas é realizada por meio de um par de chaves criptográficas. Existem dois tipos de chaves disponíveis, cada uma com diferentes níveis de permissão e finalidades específicas:

Chave de Projeto (Chave Comum)

A Chave de Projeto é utilizada para autenticar uma integração em um escopo delimitado.

• Acesso: Permite que a integração opere exclusivamente dentro das funcionalidades do projeto em que foi configurada.
• Isolamento: As ações realizadas não afetam outros projetos ou Workspaces da conta.
• Permissão: Qualquer membro com perfil de Administrador possui autonomia para criar e gerenciar um par de chaves de projeto.
• Quantidade de chaves: é possível manter mais de uma chave pública (public key) ativa simultaneamente para o mesmo projeto.

Chave de Organização (Chave Mestra)

Esta chave oferece um nível de acesso elevado, sendo voltada para operações que abrangem toda a estrutura da conta.

• Acesso: Permite gerenciar múltiplos projetos e, inclusive, criar novos Workspaces de forma automatizada.
• Abrangência: É recomendada para integrações centralizadas que precisam de visibilidade total sobre a organização.
• Permissão: Por questões de segurança, apenas representantes legais da organização podem registrar uma chave de organização.
• Quantidade de chaves: não é possível manter mais de uma chave pública (public key) ativa simultaneamente para a mesma organização.

Atenção: Como o nível de organização permite apenas uma chave ativa por vez, ao cadastrar uma nova public key nesta tela, ela substituirá automaticamente a chave anterior.

Para detalhes mais aprofundados e especificações técnicas sobre a autenticação e criptografia, recomendamos a leitura da nossa Documentação da API - Security