> For the complete documentation index, see [llms.txt](https://help.starkbank.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.starkbank.com/integracao-e-apis/qual-a-diferenca-entre-chave-de-organizacao-e-de-projeto.md).

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

Entenda a diferença entre os tipos de chaves de integração no Stark Bank

Ao configurar uma integração no Stark Bank, 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.

{% hint style="warning" %}
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.
{% endhint %}

#### Informações adicionais

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](https://starkbank.com/docs/api#security)

{% content-ref url="/pages/o4skrDMUsqkcHZcqVbwD" %}
[Como obter as credenciais de API?](/integracao-e-apis/como-obter-as-credenciais-de-api.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.starkbank.com/integracao-e-apis/qual-a-diferenca-entre-chave-de-organizacao-e-de-projeto.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.