Gerenciar configurações OAuth
As configurações OAuth gerenciam o acesso de toda a empresa ao servidor MCP da Braze, controlam quais URIs de redirecionamento de clientes MCP personalizados podem se conectar à Braze e permitem revogar todos os tokens OAuth MCP da sua empresa.
As configurações OAuth se aplicam a toda a sua empresa. As permissões atribuídas a cada usuário determinam quais espaços de trabalho e recursos eles podem acessar por meio do servidor MCP.
Requisitos
| Requisito | Descrição |
|---|---|
| Permissão “Admin” | Você deve ter a permissão “Admin” no nível da empresa para visualizar as configurações OAuth, ativar ou desativar o acesso MCP OAuth, gerenciar URIs de redirecionamento ou revogar tokens MCP OAuth. |
| Permissão “Use MCP Server” | Os usuários devem ter essa permissão para cada espaço de trabalho que desejam acessar por meio do servidor MCP. Essa permissão é separada da permissão “Admin” usada para gerenciar as configurações OAuth. |
Para saber mais sobre como atribuir permissões, consulte Permissões de usuário.
Como o acesso OAuth funciona
As configurações de OAuth e as permissões de usuário funcionam juntas:
- As configurações de OAuth em toda a empresa determinam se os usuários podem conectar clientes MCP à Braze.
- A permissão “Use MCP Server” determina se um usuário individual pode usar o servidor MCP em um espaço de trabalho.
- As permissões existentes do usuário no dashboard determinam quais dados e recursos da Braze um cliente MCP pode acessar.
- Uma conexão OAuth pode acessar apenas os espaços de trabalho que o usuário está autorizado a acessar.
Ativar o acesso MCP OAuth não concede aos usuários novas permissões de espaço de trabalho. Da mesma forma, remover uma permissão do dashboard remove essa capacidade do cliente MCP conectado do usuário.
Controles da empresa e do espaço de trabalho
A política de OAuth é armazenada no nível da empresa. Administradores de espaço de trabalho não podem substituir o acesso MCP OAuth nem os status de URI de redirecionamento para um único espaço de trabalho.
| Controle | Onde você configura | Escopo |
|---|---|---|
| Acesso MCP OAuth | Configurações > Configuração de administrador > OAuth | Empresa inteira. Quando está desativado, o MCP OAuth é negado em todos os espaços de trabalho. |
| URIs de redirecionamento aprovadas | Configurações > Configuração de administrador > OAuth | Empresa inteira. URIs aprovadas e bloqueadas se aplicam a todos os espaços de trabalho. |
| Revogar tokens MCP OAuth | Configurações > Configuração de administrador > OAuth | Empresa inteira. A revogação se aplica a todos os tokens MCP OAuth em todos os espaços de trabalho. |
| Permissão “Use MCP Server” | Configurações > Gerenciamento de usuários | Por espaço de trabalho. Os usuários precisam dessa permissão em cada espaço de trabalho que acessam pelo servidor MCP. |
Somente usuários com a permissão “Admin” podem alterar o acesso MCP OAuth, alterar os status de URI de redirecionamento ou revogar tokens MCP OAuth. Para saber como as permissões do espaço de trabalho interagem com essas configurações da empresa, consulte OAuth e acesso MCP.
Ativar ou desativar o acesso MCP OAuth
Para atualizar o acesso MCP OAuth da sua empresa:
- Acesse Configurações > Configuração de administrador > OAuth.
- Em Controles de acesso global, ative ou desative o Acesso MCP OAuth.
Quando o Acesso MCP OAuth está ativado, os usuários com a permissão “Use MCP Server” podem autorizar clientes MCP aprovados. Quando está desativado, o acesso OAuth ao servidor MCP é negado para todos os usuários e espaços de trabalho da sua empresa.
Desativar o Acesso MCP OAuth não remove nem bloqueia as URIs de redirecionamento configuradas. A Braze revoga os tokens MCP OAuth existentes da sua empresa, fazendo com que os clientes MCP conectados percam o acesso. A seção URIs de redirecionamento aprovadas fica oculta enquanto o acesso MCP OAuth está desativado; ative-o novamente para gerenciar a mesma lista de URIs.
Se a Braze desativou o servidor MCP remoto para o seu ambiente, o botão de alternância Acesso MCP OAuth fica desabilitado e uma mensagem explica que a configuração da empresa não tem efeito até que o servidor MCP remoto seja ativado novamente.
Gerenciar URIs de redirecionamento aprovados
Depois de ativar o MCP OAuth access, a seção Approved redirect URIs lista os URIs de redirecionamento que clientes MCP personalizados podem usar durante a autenticação. Para orientações de formatação, consulte Formatos de URI de redirecionamento.
A tabela Approved redirect URIs mostra as seguintes informações:
| Coluna | Descrição |
|---|---|
| Redirect URI | O endereço exato que a Braze compara com o retorno de chamada do cliente, incluindo o caminho. |
| Added by | O usuário do dashboard que adicionou ou atualizou o URI por último. |
| Date added | Quando o URI foi adicionado ou atualizado pela última vez. |
| Status | Se o URI está como Approved ou Blocked. |
| Actions | Block ou Unblock, dependendo do status atual. |
Formatos de URI de redirecionamento
| Tipo de URI | Formato a usar ao adicionar |
|---|---|
| Local (endereço de loopback) | Começa com http://localhost ou http://127.0.0.1. Omita a porta (os dois-pontos e números após o host) para que qualquer porta local possa corresponder. Por exemplo, se o cliente exibir http://localhost:33491/oauth/callback, insira http://localhost/oauth/callback. Se você mantiver uma porta no URI adicionado (como :33491), a Braze fará correspondência apenas com essa porta. |
| Endereço remoto | Insira o endereço completo exatamente como o cliente exibe, por exemplo https://app.example.com/callback. |
| Esquema personalizado | Começa com um esquema de URI personalizado (não http:// ou https://), como cursor://. Insira exatamente como exibido. Alguns apps de desktop usam esses endereços. |
Adicionar um URI de redirecionamento
Para permitir um cliente MCP personalizado que ainda não está listado:
- Selecione Add redirect URI.
- Insira o URI de redirecionamento completo com o protocolo de retorno de chamada das configurações de OAuth ou integração do cliente. Use a tabela Formatos de URI de redirecionamento se precisar de ajuda para corresponder ao retorno de chamada do cliente.
- Selecione Save.
Para clientes locais, use 127.0.0.1 e omita o número da porta no URI de redirecionamento que você adicionar.
Somente URIs de redirecionamento com status Approved podem concluir uma nova autorização OAuth. Se um URI não estiver na lista e não for um cliente verificado pela Braze, a Braze negará a solicitação de autorização.
Bloquear um URI de redirecionamento
Para impedir novas autorizações OAuth de um URI de redirecionamento, selecione Block na linha correspondente e confirme a ação. A Braze mantém o registro do URI e altera o status para Blocked.
Bloquear um URI de redirecionamento não revoga tokens de usuários que já estão conectados a esse cliente MCP. Selecione Revoke MCP OAuth tokens para encerrar essas sessões. Bloquear o URI é uma ação separada que impede novas autorizações com esse retorno de chamada.
Como alternativa, remova a permissão “Use MCP Server” de um usuário para impedir apenas esse usuário de usar o servidor MCP. As conexões MCP de outros usuários permanecem ativas até que você selecione Revoke MCP OAuth tokens.
Desbloquear um URI de redirecionamento
Para recuperar o acesso de um URI de redirecionamento bloqueado, selecione Unblock na linha correspondente e confirme a ação. A Braze atualiza o registro existente para Approved em vez de criar uma duplicata.
Usuários que estavam conectados anteriormente a esse cliente MCP precisarão se autenticar novamente.
Revogar tokens OAuth do MCP
Revogar tokens invalida todos os tokens OAuth do MCP da sua empresa de uma só vez. Use essa opção se você achar que um token foi vazado ou usado indevidamente.
Para revogar os tokens OAuth do MCP da sua empresa:
- Acesse Configurações > Configuração de administrador > OAuth.
- Em Revogar tokens OAuth do MCP, selecione Revogar tokens OAuth do MCP.
- Revise a caixa de diálogo de confirmação e selecione Revogar tokens.
A Braze revoga os tokens em segundo plano e exibe uma mensagem de confirmação quando a revogação é concluída. Para empresas com muitas conexões, isso pode levar alguns minutos. Mantenha a página OAuth aberta até que a confirmação apareça.
A revogação de tokens não pode ser desfeita. Todos os clientes MCP conectados perdem o acesso à Braze, e cada usuário precisa fazer login e conectar seu cliente MCP novamente.
O que a revogação altera
| Item | Resultado |
|---|---|
| Tokens de acesso | Revogados. Os clientes MCP conectados param de funcionar até que o usuário reconecte. |
| Tokens de atualização | Revogados. Os clientes MCP não conseguem reconectar por conta própria em segundo plano. Os usuários precisam reconectar manualmente. |
| Acesso OAuth do MCP | Inalterado. Se estava ativado, os usuários podem reconectar imediatamente. |
| URIs de redirecionamento aprovados | Inalterados. URIs aprovados e bloqueados permanecem como estão. |
| Permissão “Use MCP Server” | Inalterada. Os usuários mantêm a permissão e podem reconectar. |
| Novas conexões | Não afetadas. Conexões feitas após o início da revogação continuam funcionando. |
Requisições que já estavam em andamento quando você revogou não são canceladas. Para interromper todo o acesso MCP em vez de apenas encerrar as sessões atuais, desative o Acesso OAuth do MCP (isso também revoga os tokens OAuth do MCP). Para remover o acesso MCP de um único usuário, remova a permissão “Use MCP Server” desse usuário.
Se a revogação não for concluída, a Braze exibe uma mensagem de erro. Alguns tokens podem já ter sido revogados, então entre em contato com o suporte antes de tentar novamente.
Auditar atividade OAuth
A Braze registra conexões OAuth com o servidor MCP no relatório de eventos de segurança. Use esse relatório para auditar quando os usuários se conectam por meio de OAuth.
Para revogar o acesso MCP de um usuário, remova a permissão “Use MCP Server” desse usuário. Para revogar todos os tokens OAuth MCP da sua empresa, consulte Revogar tokens OAuth MCP. Para orientações de configuração e solução de problemas, consulte Configuração do servidor MCP da Braze.