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

# Conectando um parceiro de segurança com a Compliance API

> Permita que um parceiro de segurança como a Orca Security analise a postura de segurança do seu workspace da Base44 com a Compliance API. Escolha o que ele vê e corte o acesso quando quiser.

A Compliance API permite que as ferramentas de segurança que sua empresa já usa verifiquem seu workspace da Base44. Elas fazem isso do mesmo jeito que verificam seus outros serviços na nuvem. Seu parceiro de segurança recebe uma visão somente leitura de como o seu workspace está configurado, como apps, membros, SSO e achados de segurança. Assim, sua equipe de segurança vê a Base44 junto com todo o resto. Para conectar um parceiro, você cria uma chave de API do workspace, escolhe o que ela pode ler e envia a chave para ele.

> [!WARNING]
>
> **Antes de conectar um parceiro:**
>
> * Você precisa do [plano Enterprise](https://docs.base44.com/pt-BR/Enterprise/Base44-for-enterprises.md#choosing-business-or-enterprise) para usar a Compliance API. Ela não está incluída no plano Business.
> * Você precisa ser proprietário ou admin do workspace para criar a chave de API.

***

## Parceiros de segurança compatíveis

Você já pode conectar estes parceiros de segurança. O guia de configuração de cada parceiro explica onde inserir sua chave da Base44 no produto dele.

| Parceiro | Tipo de segurança | Guia de configuração |
| - | - | - |
| Orca Security | Segurança na nuvem. A Orca é a parceira de design da Compliance API. | [Conectando a Base44 à Orca](https://docs.orcasecurity.io/docs/connecting-base44) |
| Token Security | Segurança de identidade | [Conectando a Base44 à Token Security](https://docs.token.security/docs/base44) |
| Noma Security | Segurança de IA | Em breve |

Mais parceiros chegam em breve: Upwind (segurança), Pluto (segurança de workspaces de IA) e Zenity (segurança de agentes de IA).

Para ver a lista mais recente de parceiros e seus guias de configuração, consulte a [página da Compliance API em base44.com](https://base44.com/compliance-api).

***

## Escolhendo permissões

Ao criar a chave, você escolhe quais tipos de dados seu parceiro pode ler. Escolha apenas o que seu parceiro precisa.

| Permissão | O que seu parceiro pode ler |
| - | - |
| **Read compliance inventory** | As configurações de segurança, apps, domínios, detalhes das chaves de API, estrutura de dados, funções de backend, nomes de segredos, integrações e agentes do seu workspace. Seu parceiro sempre precisa desta permissão. |
| **Read compliance member directory** | Os membros do seu workspace, incluindo endereços de e-mail, funções, status de MFA e quando estiveram ativos pela última vez. |
| **Read compliance security findings** | Os achados das verificações de segurança dos seus apps, incluindo achados de outros scanners que você conectou, como o Wiz. |

> [!NOTE]
>
> **Como as permissões funcionam:**
>
> * Seu parceiro sempre vê o workspace inteiro, mesmo se você limitar a chave a apps selecionados. Assim, o relatório dele não deixa nada de fora.
> * Se você deixar de fora uma permissão, o relatório do seu parceiro mostra esses dados como não compartilhados, e não como vazios.

***

## Conectando seu parceiro

Crie uma chave de API do workspace com as permissões de conformidade e envie-a para o seu parceiro.

**Para conectar um parceiro de segurança:**

1. Clique no nome do seu workspace no canto inferior esquerdo e clique em **Configurações**.

2. Clique em **Segredos** na barra lateral.

3. Clique em **+ Create API Key**.

4. Digite um nome que diga para quem é a chave, por exemplo `Orca Security`.

5. Em **Permissões**, abra **Workspace** e selecione **Read compliance inventory**, além de qualquer outra permissão de conformidade que você queira compartilhar.

   ![Uma captura de tela do diálogo Create API Key com as 3 permissões de conformidade destacadas](https://mintcdn.com/base44/C9r8Uh2ycZtSXfdp/images/enterprise-secrets-compliance-permissions.png?fit=max\&auto=format\&n=C9r8Uh2ycZtSXfdp\&q=85\&s=7d861b94ed2b5e99ac14008dbac12b40)

   Escolhendo as permissões de conformidade para a chave do seu parceiro

6. Clique em **Criar chave**.

7. Clique no ícone de copiar ao lado da sua chave para copiá-la. Ela só aparece uma vez, então copie antes de clicar em **Concluído**.

   ![Uma captura de tela da janela API Key Created com o botão de copiar destacado ao lado da nova chave](https://mintcdn.com/base44/C9r8Uh2ycZtSXfdp/images/enterprise-secrets-compliance-key-created.png?fit=max\&auto=format\&n=C9r8Uh2ycZtSXfdp\&q=85\&s=37515a7e17de09605b8b0fb35fbd6da9)

   Copiando sua nova chave para enviar ao seu parceiro

8. Envie a chave para o seu parceiro de segurança por um canal seguro. Depois, conclua a configuração no produto dele seguindo o guia de configuração.

***

## O que continua privado

Seu parceiro vê como o seu workspace está configurado, nunca o seu conteúdo ou suas credenciais. Seja qual for a permissão escolhida, a Compliance API nunca compartilha:

* Os dados dos seus apps, como registros e arquivos enviados
* Suas conversas com o chat de IA e as conversas dos seus agentes
* Valores de segredos, chaves de API, tokens e senhas
* O código das suas funções de backend e as instruções dos seus agentes
* As identidades dos usuários dos seus apps
* Detalhes de MFA, como números de telefone e códigos de autenticador

> [!NOTE]
>
> Seu parceiro só pode ler. A Compliance API não pode alterar nem excluir nada no seu workspace.

***

## Vendo as verificações do seu parceiro

As leituras do seu parceiro ficam registradas nos [logs de auditoria](https://docs.base44.com/developers/references/audit-logs-api/get-started/overview.md) do seu workspace como `workspace.compliance_api.read`. Cada registro informa a chave de API usada e o parceiro que fez a chamada. Assim, você vê quando as verificações acontecem e pode investigar se uma chave for usada de forma indevida.

Para manter seus logs de auditoria legíveis, a Base44 registra cada tipo de leitura uma vez por hora, e não cada solicitação. Você vê no máximo um registro por hora para cada chave, parceiro, tipo de dado lido e resultado (sucesso ou falha). Por isso, o número de registros não corresponde ao número de solicitações.

***

## Gerenciando a chave do seu parceiro

Na página **Segredos**, você pode renomear a chave do seu parceiro, pausar o acesso dele ou removê-la de vez. Quando você desativa ou exclui a chave, seu parceiro deixa de ler seu workspace a partir daquele momento.

**Para gerenciar a chave do seu parceiro:**

1. Clique no nome do seu workspace no canto inferior esquerdo e clique em **Configurações**.

2. Clique em **Segredos** na barra lateral.

3. Clique no ícone **Mais ações**  ao lado da chave do seu parceiro.

   ![Uma captura de tela do menu More actions de uma chave aberto na página Secrets, com Edit, Disable key e Delete key](https://mintcdn.com/base44/C9r8Uh2ycZtSXfdp/images/enterprise-secrets-compliance-key-menu.png?fit=max\&auto=format\&n=C9r8Uh2ycZtSXfdp\&q=85\&s=aaca62dd43d165ff9052543403732397)

   Gerenciando a chave do seu parceiro no menu Mais ações

4. Faça uma das seguintes ações:

> [accordion] Editar a chave
>
> Clique em **Editar** para alterar o nome, a descrição ou as permissões da chave. Para mudar o que seu parceiro pode ver, marque ou desmarque as permissões de conformidade e salve. Seu parceiro continua usando a mesma chave, então você não precisa enviar nada para ele.

> [accordion] Desativar a chave
>
> Clique em **Desativar chave** para pausar o acesso do seu parceiro sem remover a chave. As verificações dele param na hora. Para liberar o acesso de novo, clique em **Ativar chave** no mesmo menu.

> [accordion] Excluir a chave
>
> Clique em **Excluir chave** e depois em **Delete Key** para confirmar. O acesso do seu parceiro para na hora, e não é possível desfazer. Para conectar o parceiro de novo, crie uma nova chave e envie-a para ele.

***

## Perguntas frequentes

Clique em uma pergunta abaixo para saber mais sobre como conectar um parceiro de segurança.

> [accordion] Posso conectar mais de um parceiro de segurança?
>
> Sim. Crie uma chave separada para cada parceiro e dê a ela o nome dele. Assim, você pode cortar o acesso de um parceiro sem afetar os outros, e seus logs de auditoria mostram qual parceiro fez cada verificação.

> [accordion] Com que frequência meu parceiro verifica meu workspace?
>
> Seu parceiro decide a frequência, geralmente uma vez por dia. Cada verificação lê a configuração atual do seu workspace, e você pode ver quando as verificações acontecem nos seus logs de auditoria.

> [accordion] O que acontece se meu workspace sair do plano Enterprise?
>
> Seu parceiro deixa de conseguir ler seu workspace, porque a Compliance API só está disponível no plano Enterprise. As verificações voltam a funcionar se o seu workspace voltar para o plano Enterprise, desde que a chave não tenha sido excluída.

> [!NOTE]
>
> Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a [versão em inglês](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.