O Mac vive pedindo permissão de Screen Recording: as soluções reais

macOSTahoe ·
O Mac vive pedindo permissão de Screen Recording: as soluções reais

Seu Mac vive pedindo permissão de Screen Recording, ou uma permissão já concedida para de funcionar. Entenda como o TCC do macOS funciona de verdade e corrija os dois casos.

Você abre o Zoom, clica em Share Screen e o macOS exibe a mesma caixa de diálogo que já tinha exibido no mês passado, perguntando se o Zoom pode gravar a sua tela. Você já disse que sim. Você abre o System Settings e lá está: Zoom, na lista de Screen & System Audio Recording, com o botão ligado. Nada está quebrado. E mesmo assim a pergunta veio de novo.

Uma semana depois acontece outra coisa. Sua ferramenta de backup não consegue ler a pasta do Mail. Você confere o Full Disk Access e o app está lá na lista, ligado, exatamente como deveria. Mas o app se comporta como se não tivesse permissão nenhuma. Esse não é o mesmo problema, mesmo produzindo a mesma sensação.

Essas duas situações são tratadas como uma só na maior parte dos conselhos que você vai encontrar por aí, e é justamente por isso que boa parte desses conselhos falha. A primeira é deliberada. A Apple embutiu uma reconfirmação periódica na permissão de captura de tela e não existe interruptor para desligá-la. A segunda é uma falha genuína, com uma causa específica e localizável, e quase sempre se resume a uma coisa: o macOS não acredita mais que o app em disco é o mesmo app ao qual você concedeu a permissão.

Este artigo separa as duas, explica o subsistema que está por trás de ambas e dá a correção certa para cada uma. Ele também explica por que o conselho mais comum sobre o tema — mudar permissões de arquivo com chmod ou rodar algum tipo de reparo de permissões — não tem absolutamente nada a ver com o sistema envolvido. Tudo o que é demonstrado abaixo foi testado em um Mac rodando macOS 26.5.2, build 25F84, com System Integrity Protection ativado.

Principais conclusões

  • Dois problemas diferentes usam a mesma máscara — um novo pedido agendado para captura de tela é intencional e não pode ser desativado, enquanto uma permissão concedida-mas-inoperante é uma falha real com uma causa real.
  • O TCC vincula a permissão à identidade de assinatura de código do app, não ao seu caminho — é por isso que uma permissão para de funcionar silenciosamente depois de uma atualização, de uma mudança de lugar, ou quando existem duas cópias do mesmo app em disco.
  • tccutil reset é o único comando que a Apple entrega — não há como conceder uma permissão pelo Terminal, e rodar reset sem um bundle identifier apaga aquela permissão para todos os apps do Mac.
  • Os bancos de dados de privacidade são ilegíveis até para o ls — em um Mac testado com SIP ativado, listar qualquer um dos diretórios do TCC retorna Operation not permitted, que é a prova mais clara possível de que isso não é permissão de arquivo comum.
  • A Apple não publica a lista de nomes de serviço — nomes como ScreenCapture e SystemPolicyAllFiles são conhecimento da comunidade, e qualquer guia que os apresente como documentação oficial está chutando.

O que o TCC é e o que ele não é

O subsistema que decide se um app pode gravar sua tela, ler sua pasta do Mail, usar o microfone ou controlar outros apps se chama TCC. As iniciais significam Transparency, Consent and Control (transparência, consentimento e controle). É a coisa que produz cada caixa de diálogo do tipo "O app gostaria de acessar…" que você já clicou na vida, e é a coisa que preenche cada lista do System Settings em Privacy & Security.

A página de man da Apple para a única ferramenta de linha de comando dessa área a descreve em uma frase. Em NAME, lê-se "tccutil – manage the privacy database", e a DESCRIPTION expande isso para: "O comando tccutil gerencia o banco de dados de privacidade, que armazena as decisões que o usuário tomou sobre se os apps podem acessar dados pessoais."

Leia com atenção, porque a redação é precisa e revela o formato de todo o sistema. O TCC armazena decisões. É um registro de consentimento. Não é uma descrição de um arquivo, é a descrição de uma relação entre um aplicativo e uma categoria de dados protegidos.

O banco de dados de privacidade não é o sistema de arquivos

Esse é o equívoco que desperdiça mais tempo do que qualquer outro, então vale despachá-lo imediatamente.

As permissões de arquivo tradicionais do Unix são atributos guardados no próprio arquivo: um dono, um grupo e bits de leitura/escrita/execução, alterados com chmod e chown. Elas respondem à pergunta "quais contas de usuário podem tocar neste arquivo?"

O TCC responde a uma pergunta completamente diferente: "para qual aplicativo o usuário consentiu em liberar a leitura desta categoria de dados?" A conta de usuário não é o sujeito. O aplicativo é. Howard Oakley, da The Eclectic Light Company, resumiu bem a distinção no seu texto explicativo de novembro de 2025 sobre permissões e privacidade, escrevendo que "a proteção de privacidade opera fora dos atributos de arquivo, usando um sistema baseado em regras aplicado a cada app."

A consequência prática é absoluta. Sua conta de usuário já é dona de ~/Library/Mail, e os bits POSIX já dizem que você pode ler essa pasta. É exatamente por isso que um comando de terminal rodado por você consegue ler e um app gráfico rodado por você não consegue: as permissões de arquivo nunca foram o obstáculo. O TCC era.

Então nenhuma quantidade de chmod vai resolver um problema de TCC. Nem nenhuma rotina de "reparar permissões", um conceito que remonta à era pré-APFS, aplicava-se ao banco de recibos, e que a Apple removeu do Disk Utility anos atrás. Rodar sudo chmod -R 755 na sua pasta pessoal atrás de um aviso de gravação de tela não vai ajudar, e pode danificar sua pasta Library. Não faça isso.

Os bancos que você não consegue ler, nem sequer listar

Existem dois bancos de dados do TCC. O de cada usuário fica em ~/Library/Application Support/com.apple.TCC/ e guarda as decisões que se aplicam à sua conta. O do sistema fica em /Library/Application Support/com.apple.TCC/ e guarda as decisões válidas para a máquina inteira, incluindo aquelas que um administrador ou um perfil de MDM pode definir.

Aqui está a demonstração que encerra a discussão. No Mac de teste, com SIP ativado, os dois comandos abaixo foram tentados:

ls ~/Library/Application\ Support/com.apple.TCC/
ls /Library/Application\ Support/com.apple.TCC/

Ambos retornaram Operation not permitted. Não "permission denied", que é a cara de uma falha POSIX, mas a resposta que o kernel dá quando o System Integrity Protection bloqueia o acesso por completo. O SIP foi confirmado ativo: csrutil status retornou System Integrity Protection status: enabled.

Você não consegue listar esses diretórios, ler os bancos dentro deles nem editá-los. Se um guia mandar você abrir o TCC.db em um navegador de SQLite e inserir uma linha, ele está descrevendo uma máquina com SIP desativado, e desativar o SIP para contornar um aviso de permissão troca uma parte enorme da arquitetura defensiva do seu Mac pela solução de uma caixa de diálogo. Este artigo não vai ensinar como fazer isso.

O que você pode fazer é conceder a permissão pela interface do System Settings, redefinir uma decisão com o tccutil, ou fazer com que um perfil de MDM escreva uma decisão em seu nome. São essas as três portas. Não existe uma quarta.

Por que esse design existe

Se as decisões do TCC vivessem em um arquivo comum e editável, qualquer app com acesso de escrita à sua pasta pessoal poderia se autoconceder silenciosamente gravação de tela, acesso à câmera e passe livre na sua pasta do Mail. A proteção não valeria nada. Então a Apple colocou as decisões atrás do SIP, fez do caminho de escrita suportado uma interação do usuário com uma caixa de diálogo desenhada pelo sistema, e deu à ferramenta de linha de comando exatamente um verbo: reset.

Esse é um design coerente e, do ponto de vista de quem está consertando uma permissão quebrada às 23h, uma caixa de ferramentas bem pequena. A maior parte deste artigo é sobre usá-la bem. Para o contexto mais amplo de como o macOS empilha Gatekeeper, notarização, SIP e TCC, nosso guia completo de segurança e privacidade do macOS Tahoe cobre a arquitetura ao redor.

Os dois problemas diferentes

Agora, a separação da qual depende todo o resto do artigo.

Problema um: o novo pedido deliberado

Durante o ciclo beta do macOS 15 Sequoia, em 2024, a Apple introduziu a reconfirmação periódica para captura de tela e áudio. Qualquer app que capture sua tela passaria a ser obrigado a reconfirmar em uma programação, sem forma de optar por sair.

O comportamento inicial do beta era semanal, e também repetia o pedido depois de cada reinicialização. Isso atraiu críticas públicas substanciais. O MacRumors relatou em agosto de 2024 que "os pop-ups de permissão de gravação de tela vinham aparecendo semanalmente ao longo do processo de testes beta, mas a Apple ajustou a frequência em resposta ao feedback dos usuários", e que o beta tinha migrado para reautorização mensal. O 9to5Mac e o iDownloadBlog relataram a mesma mudança a partir do mesmo beta. O pedido a cada reinicialização foi eliminado ao mesmo tempo. A caixa de diálogo oferece um botão "Allow For One Month" e uma opção de abrir o System Settings, e o MacRumors observou na época que "não parece haver uma forma de os usuários concederem permanentemente o acesso de gravação de tela a funcionalidades de gravação, mas um pop-up mensal é ao menos mais conveniente do que um pop-up semanal."

Agora a parte honesta. Não consegui verificar a cadência atual na geração macOS 26 a partir de nenhuma fonte autoritativa. A própria página de suporte da Apple sobre esse painel, "Allow apps to use screen and audio recording", no Guia do Usuário do Mac para macOS Tahoe 26, descreve como abrir o painel e como responder à caixa de diálogo, e não diz absolutamente nada sobre reaprovação periódica. As fontes secundárias que discutem o macOS 26 se contradizem, algumas descrevendo um novo pedido semanal e outras um mensal, e nenhuma delas cita nada.

Então eis o que se pode dizer com confiança e o que não se pode. Confirmado: o novo pedido periódico foi introduzido no ciclo do Sequoia, se aplica à captura de tela e de áudio do sistema, oferece uma liberação de um mês e não tem interruptor de desligamento voltado ao usuário. Confirmado: a documentação de suporte atual da Apple para o painel não menciona isso em momento algum. Não confirmado: o intervalo exato na geração macOS 26. Se o seu Mac pede de novo mais ou menos uma vez por mês, isso bate com o que a Apple entregou no Sequoia. Se ele pede com uma frequência muito maior, leia o diagnóstico de falhas abaixo, porque pedidos frequentes são outro problema.

A coisa mais útil a saber sobre o Problema Um é que ele não é uma falha e não há nada para consertar. Clicar em Allow leva um segundo, e a própria caixa de diálogo é a reconfirmação, então você não precisa mexer de novo em nenhum botão do System Settings. Todo guia que manda você redefinir, reinstalar ou editar alguma coisa em resposta a um aviso mensal está vendendo cura para paciente saudável.

Existe uma exceção do lado do desenvolvedor. A Apple tem um entitlement chamado com.apple.developer.persistent-content-capture que suprime o pedido recorrente, e o blog de Michael Tsai reuniu a discussão entre desenvolvedores sobre ele em agosto de 2024. É uma capacidade gerenciada voltada a aplicativos de controle remoto e do tipo VNC: os desenvolvedores precisam se candidatar à Apple e receber a concessão. Você não pode habilitá-la como usuário. Isso só explica por que um pequeno número de apps de acesso remoto nunca te importuna.

Problema dois: a concessão que não cola

Esse é uma falha genuína. Ele aparece como um app listado no painel e ligado que se comporta como se não tivesse permissão; um app que some do painel depois de uma atualização; uma permissão que funciona até você sair e reabrir; duas entradas com o mesmo nome de app; uma ferramenta que nunca aparece no painel mesmo depois de você adicioná-la com o +; ou um aviso a cada abertura em vez de uma vez por mês.

Todos esses casos têm causas, e a maioria compartilha uma única causa. É esse o assunto da próxima seção principal.

Uma coisa que não está nessa lista, apesar de parecer que pertence a ela: um Mac que pede repetidamente a senha do seu login keychain. Isso é o subsistema de chaveiro, não o TCC, e nada neste artigo vai resolver. Se esse é o seu sintoma, a correção para o pedido de senha do login keychain cobre o terreno certo.

Qual problema você tem

SintomaQual problemaO que fazer
Aviso de captura de tela mais ou menos uma vez por mês, app funciona depois de clicar em AllowPor designClique em Allow. Não há nada errado.
Aviso a cada aberturaFalhaProblema de identidade de assinatura ou de cópia duplicada. Veja abaixo.
Ligado no painel, app ainda não consegue fazer a tarefaFalhaEntrada obsoleta vinculada a uma identidade antiga. Reconcessão limpa.
App sumiu do painel depois de atualizarFalhaA assinatura mudou. Conceda de novo.
Duas entradas com o mesmo nome no painelFalhaDuas cópias em disco. Localize e remova uma.
Ferramenta de linha de comando funciona mas nunca aparece no painelBug conhecido do macOS 26.1Veja a seção de linha de comando.
O aviso aparece, você clica em Allow, nada aconteceFalhaMuitas vezes o app nunca foi encerrado por completo. Reconcessão limpa.
Botão esmaecido com uma nota sobre perfilMac gerenciadoFale com quem administra o dispositivo.
Permissão que não é de captura pedindo confirmação mensalmenteFalhaSó a captura de tela tem novo pedido agendado.

Onde vive cada permissão na geração macOS 26

Todos esses painéis ficam sob a mesma raiz. Abra o System Settings, clique em Privacy & Security na barra lateral e escolha a categoria. As categorias relevantes para este artigo:

  • Screen & System Audio Recording. Renomeado na geração macOS 26; antes era Screen Recording. A descrição da Apple é uma linha: "Permita que os apps gravem sua tela e áudio, ou apenas o áudio. Os apps listados têm acesso."
  • Full Disk Access. Dados de usuário protegidos em todo o sistema: Mail, Messages, dados do Safari, backups do Time Machine e as pastas de container de outros apps.
  • Accessibility. A capacidade de controlar o seu Mac: mover o ponteiro, clicar, ler o conteúdo das janelas, operar as interfaces de outros aplicativos.
  • Automation. O direito de um app específico enviar Apple events a outro app específico. É o único painel organizado em pares em vez de uma lista plana.
  • Files and Folders. Acesso granular a pastas: Desktop, Documents, Downloads, volumes removíveis e de rede. Um app com Full Disk Access não precisa de nenhuma entrada aqui.
  • Input Monitoring. Permite que um app veja as teclas digitadas mesmo quando não está em primeiro plano.
  • Camera e Microphone. Exatamente o que o nome diz. Se é especificamente o seu microfone que está se comportando mal, a cadeia de permissões de entrada tem suas próprias peculiaridades, cobertas no guia sobre como consertar um microfone do Mac que parou de funcionar no macOS Tahoe 26.5.
  • Local Network. Mais recente, e fonte comum de confusão porque uma permissão de rede local bloqueada produz sintomas que não se parecem nem um pouco com um problema de privacidade. Uma impressora que parou de responder é o exemplo clássico, percorrido em a correção de AirPrint e privacidade de rede local.

Dois fatos estruturais que importam mais adiante. A lista que você vê é uma renderização do banco de dados, e o bug do macOS 26.1 descrito abaixo provou que a renderização pode estar errada enquanto o banco está certo. E remover uma entrada com o botão - apaga a decisão em vez de negar o acesso ao app, então na próxima vez que o app pedir você recebe um aviso novo. Essa distinção é a base da sequência de reconcessão limpa.

Por que uma permissão concedida para de funcionar

Aqui está o mecanismo. Se você entender essa única coisa, a maior parte do comportamento confuso dessa área se torna previsível.

O TCC se vincula à identidade de assinatura de código, não a um caminho ou a um nome

Quando você concede permissão a um app, o macOS não registra "o arquivo em /Applications/Foo.app pode gravar a tela." Ele registra uma decisão atrelada à identidade de assinatura de código do app: seu identificador e o requisito criptográfico que descreve quem o assinou. A nota técnica TN3127 da Apple, "Inside Code Signing: Requirements", é a referência sobre como esses requisitos são construídos.

A consequência é aquilo que ninguém te conta: se a identidade de assinatura muda, o macOS trata o app como um aplicativo diferente ao qual nunca foi concedido nada. A entrada antiga fica no painel, parecendo concedida, descrevendo um app que não existe mais na forma que o banco de dados lembra. Você vê um botão ligado. O sistema vê um estranho.

Você mesmo pode inspecionar a identidade de um app. No Mac de teste:

codesign -dv --verbose=2 /System/Applications/Utilities/Terminal.app

A saída inclui uma linha Identifier, que é o bundle identifier que o sistema usa (com.apple.Terminal para o Terminal), uma cadeia de linhas Authority nomeando os certificados que o assinaram, e uma linha TeamIdentifier. Para os apps que a própria Apple inclui, TeamIdentifier aparece como not set, porque a Apple assina seu software de sistema por uma cadeia de autoridade diferente daquela usada por desenvolvedores terceiros. Para um app de terceiros, você deve ver um team identifier de dez caracteres e uma cadeia de autoridade que inclui um certificado Developer ID.

Esse team identifier é a âncora estável. Um app assinado de forma ad hoc, sem team identifier, é identificado apenas pelo hash do seu código, e um hash de código muda a cada build. Um app assinado com um Developer ID tem uma identidade de time estável que sobrevive a atualizações. É por isso que alguns apps pedem permissão de novo depois de cada atualização e a maioria não pede.

Agora, os casos específicos.

Caso um: o app foi atualizado e assinado de outro jeito

O app lançou uma nova versão. O novo build foi assinado com um certificado diferente, ou o desenvolvedor migrou da assinatura ad hoc para Developer ID, ou o contrário, ou o certificado dele expirou e ele reassinou com um novo.

Como identificar: o momento coincide exatamente com uma atualização, e o app ou sumiu do painel ou ganhou uma segunda entrada.

Correção: remova a entrada obsoleta e conceda de novo. Não há mais nada a fazer; para o TCC, o app é genuinamente um app novo.

Caso dois: duas cópias do mesmo app em disco

Essa é a causa mais comum do sintoma "ligado mas não funciona", e a mais fácil de passar despercebida.

Você baixou um app, rodou uma vez a partir de ~/Downloads, concedeu a permissão e depois o arrastou para /Applications. Ou o Homebrew Cask instalou uma cópia enquanto você já tinha outra. Ou você mantém um build de release em /Applications e um beta em ~/Applications. O painel mostra uma linha com o nome e o ícone do app; ele não diz a qual cópia essa linha se refere. Você está olhando uma concessão para a cópia em ~/Downloads enquanto abre a cópia em /Applications.

Como identificar: procure todas as cópias em disco.

mdfind "kMDItemKind == 'Application'" -name "AppName"

Ou, para uma varredura que inclua cópias que o Spotlight talvez não tenha indexado:

find /Applications ~/Applications ~/Downloads ~/Desktop -maxdepth 3 -name "AppName.app" 2>/dev/null

Se voltar mais de um caminho, essa é a sua resposta.

Correção: apague as cópias que você não quer, fique com exatamente uma e faça uma reconcessão limpa na sobrevivente. Não pule a exclusão; deixar uma segunda cópia em disco significa que você vai estar de volta aqui em um mês.

Caso três: o app foi movido depois de receber a permissão

Relacionado ao caso dois, mas distinto. Existe só uma cópia, mas ela mudou de lugar. Alguns apps sobrevivem a isso sem problemas e outros não, dependendo de como o requisito de assinatura deles é escrito e de se o caminho de um helper embutido está gravado na estrutura do app pai.

Como identificar: o app estava funcionando, você reorganizou sua pasta Applications ou restaurou a partir de uma migração, e ele quebrou.

Correção: reconcessão limpa no novo local. Se ele foi movido para uma subpasta dentro de /Applications, tente primeiro trazê-lo de volta ao nível superior; alguns apps com mecanismo de atualização automática se comportam mal em subpastas.

Caso quatro: uma atualização incompleta invalidou a assinatura

Uma atualização foi interrompida, uma ferramenta de sincronização mexeu no bundle, um antivírus colocou em quarentena e restaurou um arquivo interno, ou uma restauração de backup reconstruiu o bundle de forma imperfeita. A assinatura não valida mais.

Como identificar:

codesign --verify --deep --strict --verbose=2 /Applications/AppName.app

Um bundle saudável produz um relatório curto que termina com uma declaração de que o app é válido em disco e satisfaz o requisito designado. Um bundle danificado nomeia o arquivo específico que falha. Se você vir uma falha aqui, nenhuma quantidade de ajuste de permissões vai ajudar, porque o macOS simplesmente não vai confiar no bundle.

Correção: reinstale a partir do download original do desenvolvedor. Esse é um dos poucos casos em que "reinstale o app" é genuinamente a resposta certa, e não um dar de ombros. Um modo de falha relacionado e mais visível do mesmo dano subjacente é a caixa de diálogo "o app está danificado e não pode ser aberto", que cobrimos em detalhe no guia de correção de Gatekeeper e quarentena.

Caso cinco: autoatualizadores no estilo Sparkle que substituem o próprio bundle

Muitos apps de Mac distribuídos fora da App Store se atualizam sozinhos usando o framework Sparkle ou algo parecido, baixando uma nova versão e trocando o próprio bundle no lugar enquanto rodam.

Quando isso funciona direito, o novo bundle carrega o mesmo team identifier e o TCC continua reconhecendo-o. Quando não funciona — porque a atualização foi assinada de outro jeito, ou a troca deixou um bundle gravado pela metade, ou o app se substituiu em um caminho ligeiramente diferente — você recebe um novo pedido de permissão ou uma falha silenciosa na próxima vez que usar um recurso protegido.

Como identificar: o app se atualiza sozinho fora da App Store, e os problemas de permissão se concentram no momento em que ele se atualiza.

Correção: reconcessão limpa depois que a atualização terminar. Se isso acontece a cada atualização, a configuração de assinatura do desenvolvedor é o problema e vale reportar a ele, porque é resolvível do lado dele.

O diagnóstico geral

Diante de qualquer caso de "concedido mas não funciona", faça três perguntas nesta ordem: quantas cópias desse app existem em disco (mdfind), o bundle é verificado com sucesso (codesign --verify), e ele quebrou logo depois de uma atualização? Essas três respostas apontam para um dos cinco casos acima quase sempre.

Janela do Terminal mostrando a saída do codesign com as linhas Identifier, Authority e TeamIdentifier de um bundle de aplicativo do macOS

As ferramentas de Terminal: o que o tccutil pode e não pode fazer

Existe exatamente uma ferramenta de linha de comando para esse subsistema, e suas capacidades são muito mais estreitas do que a maioria dos guias sugere.

reset é o único comando

Rode tccutil sem argumentos no macOS 26.5.2 e ele imprime a string de uso:

tccutil: Usage: tccutil reset SERVICE [BUNDLE_ID]

É essa a interface inteira. A página de man da Apple é explícita ao dizer que "atualmente há suporte para um comando", e o descreve assim:

reset Redefine todas as decisões para o serviço especificado, fazendo com que os apps peçam de novo na próxima vez que acessarem o serviço. Se um bundle identifier for especificado, o serviço será redefinido apenas para aquele bundle.

Os próprios exemplos da Apple na página de manual são tccutil reset AddressBook e tccutil reset All com.apple.Terminal.

Tire a consequência que a maioria dos guias pula: não existe comando de concessão. Você não pode aprovar uma permissão pelo Terminal. O reset esquece uma decisão para que o app pergunte de novo; ele não diz sim em seu nome. As únicas formas de dizer sim são a interface do System Settings e um perfil de configuração de MDM. Se você encontrar um guia alegando um encantamento de tccutil que concede Full Disk Access, ele está errado.

O aviso sobre o bundle ID que mais importa

Esse é o núcleo prático de toda a seção de Terminal, então merece espaço próprio.

# DANGEROUS - resets screen recording for EVERY app on the Mac
tccutil reset ScreenCapture

# Correct - resets it for one app only
tccutil reset ScreenCapture com.example.appname

O bundle identifier é opcional na sintaxe e obrigatório na prática. Omita-o e você terá mandado o macOS esquecer toda decisão de gravação de tela da máquina. Zoom, Slack, Discord, Teams, sua ferramenta de captura de tela, seu software de gravação, seu cliente de suporte remoto: todos eles vão te perguntar de novo na próxima vez que você usar. Nada fica permanentemente quebrado, mas você criou uma tarde inteira de caixas de diálogo para si mesmo na tentativa de consertar um app.

tccutil reset All sem bundle identifier é ainda pior, esquecendo cada decisão de cada serviço de cada app. Se um guia manda você rodar isso como primeiro passo, feche o guia.

Sempre acrescente o bundle identifier. Toda vez, sem exceção.

A ordem de validação dos argumentos, e por que ela pode esconder um erro de digitação

Isso foi testado diretamente, e o comportamento afeta como você lê os erros. O tccutil valida o bundle identifier antes do nome do serviço. Dê a ele um serviço inexistente e um bundle ID inexistente juntos:

tccutil reset ZZZNotAService com.example.nonexistent.zzz

e ele retorna:

tccutil: No such bundle identifier "com.example.nonexistent.zzz": The operation couldn't be completed. (OSStatus error -10814.)

Ele reclama do bundle, não do nome de serviço obviamente inválido. Dê a ele um serviço inexistente sem nenhum bundle ID:

tccutil reset ZZZNotAService

e ele retorna:

tccutil: Failed to reset ZZZNotAService

A consequência prática: um erro de digitação no bundle identifier sempre te dá um erro claro e específico, o que é bom. Mas um erro de digitação no nome do serviço pode ficar mascarado quando o bundle identifier também está errado, porque a ferramenta nunca chega longe o bastante para reclamar dele. Se você receber o erro -10814, corrija primeiro o bundle identifier, depois rode o comando de novo e veja se o nome do serviço também estava errado.

O corolário é: verifique o bundle identifier antes de montar o comando.

Como descobrir o bundle identifier de um app

Dois métodos confiáveis. O primeiro foi verificado no Mac de teste, onde osascript -e 'id of app "Terminal"' retornou com.apple.Terminal e osascript -e 'id of app "Safari"' retornou com.apple.Safari:

osascript -e 'id of app "AppName"'

Substitua pelo nome do app como ele aparece no Finder. Esse é o método mais rápido, e é o que os leitores de Howard Oakley trouxeram à tona nos comentários de sua visão geral sobre proteção de privacidade, o que ele reconheceu.

O segundo método lê o bundle diretamente, o que é útil quando o app não está em um local padrão ou o AppleScript não consegue resolver o nome:

defaults read /Applications/AppName.app/Contents/Info.plist CFBundleIdentifier

Ou use a visão de assinatura de código, que mostra a autoridade de assinatura ao mesmo tempo, e leia a linha Identifier=:

codesign -dv --verbose=2 /Applications/AppName.app

Use o que preferir, mas use um deles. Não adivinhe o identificador a partir do nome do app. A nomenclatura em DNS reverso é uma convenção, não uma regra, e muitos apps têm identificadores que não guardam a menor semelhança com o que você chutaria.

Os nomes de serviço são conhecimento da comunidade, não documentação da Apple

Aqui é onde a honestidade importa mais do que a completude.

A Apple não publica a lista de nomes de serviço que o tccutil reset aceita. A página de man dá exatamente dois por exemplo: AddressBook e All. É essa a totalidade da documentação da Apple sobre o assunto.

Os nomes em circulação vêm da comunidade. Howard Oakley publicou uma lista em sua visão geral de março de 2025 sobre proteção de privacidade que inclui, entre outros:

Accessibility, AddressBook, All, AppleEvents, AudioCapture, BluetoothAlways, Calendar, Camera, ContactsFull, ContactsLimited, DeveloperTool, FocusStatus, MediaLibrary, Microphone, Motion, Photos, PostEvent, Reminders, RemoteDesktop, ScreenCapture, SpeechRecognition, SystemPolicyAllFiles, SystemPolicyDesktopFolder, SystemPolicyDocumentsFolder, SystemPolicyDownloadsFolder, SystemPolicyNetworkVolumes, SystemPolicyRemovableVolumes.

Dois deles correspondem aos painéis com os quais este artigo mais se preocupa: ScreenCapture para Screen & System Audio Recording, e SystemPolicyAllFiles para Full Disk Access.

Não testei esses nomes por força bruta no Mac de teste, deliberadamente. Um tccutil reset que dá certo apaga as permissões reais da máquina, então a única forma de confirmar que um nome funciona é destruir aquilo que você estava tentando preservar, e testar os que falham não diz nada. A lista acima é conhecimento comunitário bem fundamentado que bate com o que os profissionais usam na prática. Não é documentação da Apple, e prefiro dizer isso a apresentá-la como autoritativa.

Duas coisas decorrem disso. Se um tccutil reset parece não fazer nada, considere que o nome do serviço pode estar errado antes de concluir que o sistema está quebrado. E prefira o caminho do System Settings quando puder, porque o painel nunca tem problema de ortografia.

Binários de linha de comando e ferramentas auxiliares

Essa é a área em que o modelo de "um app, uma entrada em uma lista" mais desmorona, e onde um bug bem documentado do macOS 26 piorou consideravelmente as coisas por um tempo.

Um executável simples não tem bundle identifier

Um .app é um bundle: um diretório com uma estrutura definida contendo um Info.plist que declara, entre outras coisas, um CFBundleIdentifier. Um binário compilado parado em /usr/local/bin não tem nada disso. É só um executável Mach-O.

O modelo do TCC é construído em torno de bundles. Um executável simples ainda pode receber permissão, mas não tem bundle identifier para servir de chave, e é por isso que ele pode não aparecer no painel do jeito que um app aparece, e por isso que tccutil reset Service bundle.id não tem alvo algum para ele.

O bug de exibição do macOS 26.1, e o que ele ensinou a todo mundo

No fim de 2025, um conjunto de tópicos no Apple Developer Forums relatou a mesma coisa em permissões diferentes. Vale percorrer o caso, porque os próprios engenheiros da Apple confirmaram o diagnóstico e o desfecho ensina algo duradouro sobre como o painel se relaciona com o banco de dados.

O tópico 807898, "Issue: Plain Executables Do Not Appear Under 'Screen & System Audio Recording' on macOS 26.1 (Tahoe)", relatou que um executável simples que pedia gravação de tela ainda recebia o aviso normal, ainda capturava a tela corretamente depois de concedida a permissão, mas nunca aparecia na lista do System Settings. O resumo do autor: "o macOS 26.1 (Tahoe) parece exigir app bundles para que um item seja mostrado na interface de privacidade de Screen Recording. Executáveis simples: continuam pedindo e recebendo permissão, continuam funcionando corretamente depois que a permissão é concedida, mas não aparecem na lista do System Settings." O mesmo código empacotado como um bundle .app aparecia normalmente. Quinn "The Eskimo!", engenheiro do DTS na Apple, respondeu confirmando: "Na minha opinião isso é um bug e recomendo que você o reporte como tal."

O tópico 807323, "Background Unix executable not appearing in Screen Recording permissions UI (macOS Tahoe 26.1)", relatou o mesmo sintoma por outro ângulo. Um executável Unix em segundo plano chamando CGRequestScreenCaptureAccess() funcionava no 26.0.1 e parou de aparecer na interface no 26.1. O autor observou que adicionar manualmente o executável com o botão + "concede a permissão internamente, mas o executável ainda não aparece na interface", de modo que os usuários "não conseguem verificar nem revogar permissões." Aquele tópico não recebeu resposta da Apple, só a corroboração de outro desenvolvedor. O tópico 809549 levantou o mesmo problema para Full Disk Access, relatando que binários de linha de comando "não aparecem nos ajustes de FDA, mesmo depois de selecionados"; Quinn redirecionou o caso para o tópico consolidado existente e um moderador o trancou.

Esse tópico consolidado, o 806187, é onde mora a resolução. A descoberta central: as permissões estavam sendo registradas corretamente o tempo todo. O banco de dados estava certo; a lista é que estava errada. Como colocou um participante, "apps de CLI podem ter full disk access ou outras permissões, mas você não consegue ver isso na lista." Um recurso de "Background Security Improvements" adicionado no 26.1 tinha alterado a interface de ajustes para mostrar apenas aplicativos empacotados como bundle.

A solução paliativa era "arrastar o binário do Finder para a lista de full disk access na janela do System Settings. A permissão será dada, mas não vai aparecer na lista." A recomendação duradoura veio de Kevin Elliott, outro engenheiro do DTS: "A solução melhor é embutir essa ferramenta dentro de um app bundle. Não quero dizer 'faça sua ferramenta de linha de comando agir como um app', quero dizer 'pegue sua ferramenta de linha de comando e enfie dentro de um app bundle, e depois use exatamente do jeito que você usava antes'."

Vários participantes confirmaram que o bug de exibição foi corrigido no beta do macOS 26.3, e alguém no tópico 807898 relatou que uma versão paralela do problema em Accessibility, presente no 26.1 e no beta do 26.2, também foi resolvida no 26.3.

Por que isso importa para você mesmo se já passou do 26.1: o painel é uma visão do banco de dados, e visões podem mentir. Se um app ou ferramenta comprovadamente tem uma permissão mas não aparece na lista, não presuma que a permissão está faltando. Teste o comportamento antes de sair redefinindo coisas.

Por que um app aberto pelo Terminal herda as permissões do Terminal

Isso confunde desenvolvedores o tempo todo, e depois que você conhece a regra ela deixa de ser misteriosa.

O TCC não pergunta simplesmente "qual binário está fazendo esta requisição?" Ele percorre o que Howard Oakley descreve como "uma cadeia de atribuição que sobe pela cadeia de chamadas até um app que é responsável pelas configurações de privacidade a serem aplicadas." O sistema procura o processo responsável, que geralmente é o app que o usuário abriu, não o processo mais profundo da cadeia.

Então, quando você roda um programa pelo Terminal, o Terminal costuma ser o processo responsável. A requisição de captura de tela do seu programa vira a requisição de captura de tela do Terminal. Se o Terminal tem a permissão, seu programa funciona; se não tem, o aviso nomeia o Terminal em vez do seu programa. É exatamente o que o autor do tópico 807898 observou: quando aberto por outro app, como o VS Code ou o Terminal, "o app pai aparece na lista em vez disso, não o executável em si."

Três consequências no uso diário. Conceder uma permissão ao seu emulador de terminal significa que toda ferramenta que você roda nele herda essa concessão, o que é conveniente e também uma expansão de privilégios real, digna de reflexão antes de ser feita sem pensar. O mesmo script se comporta de forma diferente quando aberto pelo Terminal, por um LaunchAgent e por um app wrapper de duplo clique, porque o processo responsável difere em cada caso. E trocar de emulador de terminal significa começar do zero, já que iTerm2, Ghostty, Warp, Kitty e Terminal.app são cada um uma identidade separada.

Ferramentas auxiliares, serviços XPC e itens de início de sessão

Um app de Mac moderno é com frequência vários executáveis: o app principal, possivelmente um helper privilegiado em /Library/PrivilegedHelperTools, possivelmente serviços XPC embutidos no bundle, possivelmente um launch agent que roda no login.

Serviços XPC embutidos dentro de um bundle assinado corretamente geralmente operam sob a atribuição do app pai, porque a cadeia se resolve até o app. Helpers e launch daemons instalados separadamente frequentemente não: eles rodam fora da árvore de processos do app com identidade própria, e precisam da própria concessão. É por isso que alguns apps pedem que você aprove uma permissão duas vezes, uma para o app e outra para o helper dele, e por que um helper instalado como root pode precisar de uma entrada no banco de dados do sistema em vez do seu banco por usuário.

Se um app funciona pela metade, com a interface respondendo mas uma função em segundo plano falhando em silêncio, um helper sem permissão é um forte suspeito. A documentação de suporte do próprio app é o caminho mais rápido para saber qual helper precisa do quê, porque você não consegue determinar isso pelo painel.

Diagrama da cadeia de atribuição do TCC mostrando uma ferramenta de linha de comando aberta a partir de um emulador de terminal sendo resolvida para o aplicativo pai

Especificamente sobre Screen Recording

O painel é System Settings → Privacy & Security → Screen & System Audio Recording. A descrição da Apple, literalmente: "Permita que os apps gravem sua tela e áudio, ou apenas o áudio. Os apps listados têm acesso."

Pontos específicos dessa permissão:

É a única permissão com novo pedido agendado. Nenhuma outra categoria do TCC pergunta de novo por cronômetro. Se sua permissão de câmera ou seu Full Disk Access estão te perguntando mensalmente, esse não é o comportamento projetado e você tem uma falha.

Alterná-la geralmente exige reiniciar o app. Muitos apps leem a capacidade de captura uma única vez na abertura. Ligue o botão com o app rodando e ele pode não perceber até ser reaberto. Só isso já explica um monte de relatos de "eu ativei e não aconteceu nada".

Áudio do sistema e tela estão agrupados, mas não são idênticos. O painel cobre os dois. Alguns apps pedem só o áudio. Se um app captura sua tela normalmente mas grava silêncio, veja se ele chegou a pedir a captura de áudio do sistema, e confira as configurações de dispositivo de áudio do próprio app, porque um dispositivo de áudio virtual ausente é um problema completamente separado de um problema de TCC. O guia completo de gravação de tela no Mac percorre o lado do áudio em detalhe.

Um caso difícil do mundo real, relatado com honestidade. Um tópico no Microsoft Q&A documenta o Teams para Mac no macOS Tahoe 26.4, build 25E246, entrando em loop no aviso de permissão de compartilhamento de tela. O administrador que relatou verificou tudo o que uma pessoa é capaz de verificar: um perfil PPPC implantado por MDM mirando com.microsoft.teams2 com um code requirement correto, o registro de TCC no nível do sistema mostrando auth_value=2 para kTCCServiceScreenCapture, o registro no nível do usuário mostrando o mesmo, e o System Settings mostrando o Teams ligado com a nota de que a configuração tinha sido definida por um perfil. Ele tinha limpado caches, removido o identificador legado com.microsoft.teams, reinstalado via MDM, matado e reaberto processos, e reiniciado.

As respostas oferecidas foram a remediação padrão: "encerre o Teams por completo, remova e adicione de novo ou desligue e ligue a entrada do Teams em Screen Recording, depois reinicie o Teams e tente compartilhar de novo para que o macOS possa perguntar novamente e revincular a permissão", e, em caso de falha, escalar para o suporte da Microsoft com os logs do cliente. Três semanas depois, o autor disse que nenhuma solução funcional tinha sido fornecida e que ele estava usando o app web. Às vezes a permissão realmente está concedida em todas as camadas e o culpado é um bug do lado do aplicativo. Saber a hora de parar faz parte da habilidade.

Especificamente sobre Full Disk Access

O Full Disk Access é a permissão mais ampla do sistema. É o que ferramentas de backup, utilitários de migração, softwares de segurança e emuladores de terminal usados para administração precisam.

Ele não é a mesma coisa que as entradas de Files and Folders. Files and Folders concede uma pasta específica. Full Disk Access concede dados protegidos por toda a máquina: Mail, Messages, dados de navegação do Safari, backups do Time Machine e diretórios de container de outros aplicativos. Um app com Full Disk Access não precisa de nada em Files and Folders.

Ele quase sempre exige reiniciar o app. Mais do que qualquer outra permissão, o Full Disk Access tende a ser avaliado na inicialização do processo. Conceda e depois encerre e reabra o app. Muitos apps mostram uma caixa de diálogo dizendo para fazer exatamente isso; acredite neles.

Ele não pode ser solicitado por um aviso. Um app não consegue exibir uma caixa de diálogo que conceda Full Disk Access na aprovação; ele só consegue te mandar para o painel. É por isso que apps que precisam dele mostram instruções em vez de uma caixa de diálogo do sistema, e por que "cliquei em Allow e mesmo assim não funciona" é um relato comum: não havia Allow nenhum para clicar.

Para um emulador de terminal, a concessão é ampla. Dar Full Disk Access ao Terminal ou ao iTerm2 significa que todo comando que você rodar neles tem esse alcance, através da cadeia de atribuição descrita antes. Muitas vezes é exatamente o que um administrador quer. Entenda que é isso que você está fazendo.

Ferramentas de linha de comando foram afetadas pelo bug de exibição do 26.1 descrito acima, com a correção chegando no beta do 26.3. Se você está no 26.1 ou no 26.2 e uma ferramenta de CLI se recusa a aparecer na lista depois que você a adiciona, esse é o bug conhecido e a ferramenta pode muito bem ter a permissão mesmo assim. Teste o comportamento em vez de confiar na lista.

Especificamente sobre Accessibility e Automation

Esses dois estão agrupados porque produzem uma classe parecida de confusão.

Accessibility concede a um app a capacidade de controlar o seu Mac. Gerenciadores de janelas, expansores de texto, gerenciadores de área de transferência, remapeadores de teclado, ferramentas de automação e softwares de suporte remoto todos precisam disso, e o macOS trata a permissão com o peso que ela tem.

Seu comportamento distintivo: muitos apps precisam de um encerramento completo e reabertura, e alguns precisam que o botão seja desligado e ligado de novo, antes que a mudança seja registrada. Se um app dependente de Accessibility para de funcionar depois de uma atualização, confira primeiro os casos de identidade de assinatura de código vistos antes. Accessibility também foi um dos painéis afetados pelo bug de exibição do macOS 26.1, com um relato no tópico 807898 dizendo que a variante de Accessibility "agora foi corrigida no Beta do 26.3."

Automation é estruturalmente diferente de todos os outros painéis. Não é uma lista de apps, mas uma lista de pares: "O App A gostaria de controlar o App B", cada par uma decisão separada. Se o seu script controla três aplicativos, você tem três decisões e três entradas.

Duas coisas decorrem disso. Uma permissão de Automation quebrada muitas vezes significa que um par entre vários está faltando, e o painel é o único lugar onde você consegue ver qual. E redefinir Automation com tccutil reset AppleEvents com.example.controller limpa todos os pareamentos daquele controlador de uma vez, então você vai reaprovar cada alvo na próxima vez que seu script encostar nele. Isso costuma ser a saída mais rápida de um estado travado de Automation, mas prepare-se para a sequência de avisos.

Uma armadilha que vale nomear: rode um AppleScript pelo Terminal e a concessão registrada é o Terminal controlando o app alvo, não o seu script controlando. Mova o script para outro emulador de terminal, ou empacote-o em um app, e você vai aprová-lo de novo. É a cadeia de atribuição funcionando como projetada, o que não a torna menos surpreendente na primeira vez.

A sequência de reconcessão limpa

Quando você identificou uma falha genuína, esta é a sequência. Siga na ordem. Cada passo existe por um motivo e pular um é a forma como as pessoas concluem que o exercício inteiro não funciona.

1. Encerre o app por completo.

Não é só fechar a janela. Encerre com Cmd-Q e depois confirme que não sobrou nada:

pgrep -fl "AppName"

Se ainda houver processos, eles estão segurando o estado antigo de permissão e tudo o que você fizer em seguida será avaliado contra uma decisão obsoleta em memória.

Por quê: um processo em execução guarda em cache o estado de permissão dele. Redefinir o banco de dados debaixo de um processo vivo produz comportamento inconsistente que vai te fazer perseguir um fantasma.

2. Verifique que existe exatamente uma cópia do app em disco.

mdfind "kMDItemKind == 'Application'" -name "AppName"

Apague qualquer cópia que você não esteja usando.

Por quê: se existem duas cópias, você pode reconceder a permissão à errada e acabar exatamente onde começou. Esse é o passo que as pessoas pulam e a razão pela qual a sequência falha para elas.

3. Confirme o bundle identifier.

osascript -e 'id of app "AppName"'

Por quê: um identificador errado te dá o erro -10814 na melhor das hipóteses e, na pior, te tenta a tirar o identificador do comando de reset por completo, que é o caminho destrutivo.

4. Remova a entrada do app do painel.

Abra System Settings → Privacy & Security → o painel relevante, selecione o app e clique em -. Se pedirem autenticação de administrador, forneça.

Por quê: isso apaga a decisão obsoleta pela interface suportada. Não é a mesma coisa que desligar o botão, o que registra uma negação em vez de remover a decisão. Uma negação significa que o app não terá permissão de te perguntar de novo.

5. Redefina o serviço para aquele bundle identifier.

tccutil reset ScreenCapture com.example.appname

Substitua pelo nome de serviço e identificador corretos. SystemPolicyAllFiles para Full Disk Access, Accessibility para Accessibility, AppleEvents para Automation.

Por quê: o painel e o banco de dados podem discordar, como o bug do 26.1 demonstrou de forma conclusiva. Fazer tanto a remoção pela interface quanto o reset te cobre independentemente de qual dos dois o sistema esteja de fato consultando. O bundle identifier não é opcional aqui.

6. Reabra o app.

Por quê: um processo novo, sem decisão em cache e sem resíduo da execução anterior.

7. Dispare a ação que exige a permissão.

Inicie um compartilhamento de tela. Abra a pasta. Envie o Apple event. Não volte ao System Settings para pré-ligar o botão.

Por quê: o aviso é o mecanismo que vincula a identidade de assinatura atual à decisão. Esse vínculo é o objetivo inteiro do exercício. Pré-ligar um botão no painel às vezes grava uma decisão que não fica devidamente vinculada, e é por isso que as pessoas relatam um botão ligado e um app que não funciona.

8. Aprove no aviso.

Clique em Allow, ou em Open System Settings e habilite lá se o app for de uma das categorias que não podem perguntar diretamente, como Full Disk Access.

9. Encerre e reabra o app mais uma vez.

Por quê: muitos apps leem seu conjunto de capacidades apenas na abertura. Esse passo converte "concedido" em "de fato utilizável" e elimina o falso negativo mais comum de todo o procedimento.

Se o app ainda falhar depois do passo nove, o problema não é a permissão. Vá para a próxima seção.

Quando nada funciona

Teste com uma conta de usuário nova

Crie uma nova conta de administrador em System Settings → Users & Groups, faça login nela, instale ou abra o app e conceda a permissão ali.

Esse único teste divide o espaço do problema de forma limpa:

  • Funciona na conta nova: a falha está no estado da sua conta de usuário, muito provavelmente no banco de dados TCC por usuário, em uma preferência obsoleta ou em um item de início de sessão interferindo. O app e o sistema estão bem.
  • Falha também na conta nova: a falha é do sistema inteiro ou do próprio app. Sua conta não é o problema, e boa parte dos conselhos de "apague suas preferências" que você estava prestes a tentar teria desperdiçado sua noite.

Leva cinco minutos e vale mais do que uma hora de chute.

Quando uma reinstalação completa é genuinamente a resposta

Reinstalar é a resposta reflexa para tudo e normalmente está errada. Ela é genuinamente certa em três situações:

  1. codesign --verify relata que o bundle está danificado. A assinatura não valida; nada a jusante disso pode ser consertado. Reinstale a partir do download original do desenvolvedor, não de um backup, porque o backup pode ser a origem do dano.
  2. O app foi instalado a partir de uma fonte que o modificou. Instaladores reempacotados, ferramentas que aplicam patch em app bundles e alguns mecanismos corporativos de implantação deixam um bundle cuja assinatura não bate mais com a do desenvolvedor. Pegue uma cópia limpa direto do desenvolvedor.
  3. A documentação de suporte do próprio app manda fazer isso para o sintoma específico que você tem. Alguns apps têm problemas conhecidos de estado de permissão com procedimentos de reinstalação documentados, incluindo passos para limpar os próprios diretórios de estado.

Fora dessas três, uma reinstalação em geral reproduz o mesmo bundle que você já tem e, se a identidade de assinatura não mudou, a situação de permissão também não mudará.

Reinicie, mas pelo motivo certo

Uma reinicialização limpa o estado dos processos, recarrega os launch daemons e zera caches em memória. Ela genuinamente resolve uma classe de estados de permissão travados, especialmente os que envolvem helpers em segundo plano que não recarregam direito. Ela não resolve uma incompatibilidade de assinatura de código, uma cópia duplicada em disco, um bundle danificado ou um bug do aplicativo. Reinicie uma vez, cedo, e depois volte ao diagnóstico.

O que não fazer

Para deixar explícito, porque essas coisas aparecem o tempo todo nos resultados de busca: não desative o SIP, o que remove proteções do sistema inteiro para contornar uma caixa de diálogo. Não edite nem apague o TCC.db, o que você não consegue fazer com o SIP ativado e não deveria querer fazer com ele desativado. Não faça chmod -R na sua pasta pessoal, o que não encosta nesse subsistema e pode quebrar sua pasta Library. E não rode tccutil reset All sem bundle identifier, a não ser que você queira passar o resto do dia clicando em Allow.

Macs gerenciados

Se o seu Mac é administrado por um empregador ou por uma escola, as regras mudam, e vale saber se esse é o seu caso antes de gastar uma hora brigando com um botão que você nunca teve chance de vencer.

Como saber se o seu Mac é gerenciado

Três verificações. Primeiro, olhe em System Settings → General → Device Management. Se há um perfil instalado, ele aparece lá. Segundo, procure a nota no próprio painel de privacidade: uma entrada gerenciada exibe um texto dizendo que a configuração foi definida por um perfil, e seu botão costuma estar esmaecido. Terceiro, pelo Terminal:

profiles status -type enrollment

No Mac de teste, não gerenciado, isso retornou:

Enrolled via DEP: No
MDM enrollment: No

Um Mac gerenciado reporta a inscrição aqui.

O que um perfil pode e não pode fazer

O MDM concede permissões através de um payload Privacy Preferences Policy Control, normalmente chamado de perfil PPPC. Ele escreve decisões diretamente no banco de dados TCC do sistema, e é por isso que um Mac gerenciado pode ter permissões que apareceram sem ninguém clicar em nada.

Há limites, e a captura de tela é um deles. A Kandji, uma fornecedora de MDM cujo artigo sobre mudanças no PPPC é amplamente citado entre administradores de Mac, descreve o mecanismo: para captura de tela e input monitoring, "a TI pode usar MDM para pré-autorizar que certos apps sejam aprovados até por usuários padrão, habilitando captura de tela ou input monitoring." Isso usa um valor de autorização que delega a aprovação ao usuário em vez de conceder silenciosamente. Ou seja, um perfil pode negar a captura de tela por completo e pode permitir que um usuário padrão a aprove, mas o comportamento documentado é que ele não a concede silenciosamente como faz com Full Disk Access ou Accessibility.

Segure essa nuance com leveza, porque o caso do Microsoft Q&A citado acima envolveu um administrador relatando um registro de TCC em nível de sistema para kTCCServiceScreenCapture com um motivo de autorização indicando política de MDM. Esses dois relatos não se encaixam com elegância, e estou reportando os dois em vez de escolher o mais arrumadinho.

Se você usa um Mac gerenciado

Não tente contornar um botão esmaecido. Você não vai conseguir e, em muitas implantações, a tentativa é registrada em log. Um tccutil reset contra uma entrada gerenciada por perfil ou vai falhar ou será reaplicado no próximo check-in de gerenciamento. Fale com quem administra a sua frota; a correção é uma mudança de perfil do lado deles e leva um minuto.

Se você administra um Mac gerenciado

Faça o code requirement do payload PPPC bater com o que o codesign de fato reporta para a versão implantada do app. O caso do Teams acima é instrutivo justamente porque o administrador verificou isso e mesmo assim bateu num muro: um perfil correto é necessário mas nem sempre suficiente. Quando um app muda o bundle identifier entre versões, como o Teams fez, remova o identificador legado do perfil em vez de deixar os dois lá.

Solucionando problemas comuns

O app está listado e ligado mas ainda não consegue gravar

Problema: O painel mostra o app habilitado. O app se comporta como se não tivesse permissão.

Solução: A entrada está vinculada a uma identidade de assinatura que não corresponde mais ao app em disco. Rode mdfind "kMDItemKind == 'Application'" -name "AppName" primeiro para checar se há uma segunda cópia, a causa mais comum, e apague as extras. Depois rode a sequência completa de reconcessão limpa, incluindo tanto a remoção pelo painel quanto o tccutil reset com o bundle identifier. Não se limite a desligar e ligar o botão; isso registra uma negação seguida de uma aprovação sem vínculo, que é como você chegou até aqui.

O app sumiu da lista depois de atualizar

Problema: Um app que ontem estava no painel hoje não está, e a única coisa que mudou foi uma atualização.

Solução: O novo build foi assinado de outra forma, então o macOS enxerga um aplicativo novo sem histórico. Não há nada para reparar: abra o app, dispare a ação protegida, aprove o novo aviso. Se o app usa Full Disk Access, que não pode gerar aviso, adicione-o com o botão +. Se isso se repete a cada atualização, a configuração de assinatura do desenvolvedor é instável e vale reportar a ele.

Cada abertura gera um aviso, não uma vez por mês

Problema: A caixa de diálogo de captura de tela aparece toda vez que você abre o app, em vez de na programação esperada.

Solução: Isso é uma falha, não o novo pedido projetado. As causas prováveis são um app assinado de forma ad hoc cujo hash de código muda a cada build, um autoatualizador substituindo o bundle repetidamente, ou um caminho de abertura que muda a cada vez. Rode codesign -dv --verbose=2 no app e olhe a linha TeamIdentifier. Se ela diz not set em um app de terceiros, esse app não está assinado com um Developer ID e permissão estável não é alcançável até que o desenvolvedor conserte a assinatura.

Duas entradas com o mesmo nome de app

Problema: O painel mostra o mesmo app duas vezes, às vezes com ícones idênticos.

Solução: Existem duas cópias em disco com identidades de assinatura diferentes ou caminhos diferentes. Encontre todas com find /Applications ~/Applications ~/Downloads ~/Desktop -maxdepth 3 -name "AppName.app" 2>/dev/null. Fique com uma, apague o resto, remova as duas entradas do painel e depois conceda de novo à sobrevivente. Se você mantém um canal beta ao lado de um build de release deliberadamente, espere e aceite duas entradas.

Uma ferramenta de linha de comando não aparece na lista

Problema: Você adiciona um binário com o botão + e ele não aparece.

Solução: No macOS 26.1 e 26.2 esse é o bug de exibição confirmado discutido acima, reconhecido pelos engenheiros do DTS da Apple e relatado como corrigido no beta do 26.3. É bem provável que a permissão esteja sendo registrada mesmo que a lista não mostre, então teste o comportamento real antes de investigar mais. Em qualquer versão, executáveis simples não têm bundle identifier e nunca foram cidadãos de primeira classe nessa interface. A resposta duradoura, nas palavras de Kevin Elliott no tópico 806187, é colocar a ferramenta dentro de um app bundle e continuar usando exatamente como antes.

O aviso nomeia o aplicativo errado

Problema: Você roda um script e a caixa de diálogo de permissão nomeia o Terminal, ou o VS Code, ou o Script Editor, em vez do seu script.

Solução: É a cadeia de atribuição funcionando corretamente. O processo responsável é o app que você abriu, e a permissão se prende a ele. Ou conceda a permissão a esse aplicativo hospedeiro e aceite que tudo o que você rodar dentro dele herda a concessão, ou empacote sua ferramenta como um app bundle próprio para que ela se torne o processo responsável. Esteja ciente de que trocar de emulador de terminal significa conceder de novo, porque cada um é uma identidade separada.

O botão está esmaecido

Problema: Você não consegue mudar o interruptor, e pode haver uma nota sobre um perfil.

Solução: A decisão é definida por um perfil de configuração. Confirme com profiles status -type enrollment e confira System Settings → General → Device Management. Em um Mac gerenciado, fale com seu administrador; a mudança tem que acontecer no perfil. Em um Mac pessoal exibindo um perfil inesperado, revise o que está instalado lá, porque um perfil que você não instalou conscientemente merece escrutínio.

A permissão funciona, depois para após o sono ou uma sessão longa

Problema: O compartilhamento de tela funciona quando você começa o dia e falha depois que o Mac dormiu.

Solução: Verifique primeiro se o que você está vendo é a caixa de diálogo de reconfirmação periódica aparecendo atrás de outra janela, já que um aviso que você nunca viu se parece exatamente com uma falha silenciosa. Traga todas as janelas para frente e olhe. Se não houver aviso, encerre o app por completo, confirme com pgrep -fl "AppName" e reabra, já que um processo helper que não recarregou depois do despertar é o culpado de sempre. Reinicie o Mac uma vez se persistir. Se acontece diariamente, o app tem um bug de tratamento de despertar e isso pertence a um relatório ao desenvolvedor dele.

Perguntas frequentes

Posso desligar o aviso periódico de gravação de tela?

Não. A Apple não oferece nenhuma configuração voltada ao usuário para desativá-lo, e não há comando suportado que o suprima. O único mecanismo que o remove é o entitlement com.apple.developer.persistent-content-capture, que é uma capacidade gerenciada à qual os desenvolvedores precisam se candidatar junto à Apple, voltada a aplicativos de controle remoto. Não é algo que um usuário possa habilitar.

Com que frequência o macOS pede de novo a permissão de gravação de tela?

A Apple nunca documentou o intervalo. O comportamento começou no ciclo do Sequoia como semanal, e a Apple o mudou para mensal durante aquele beta depois das críticas, como MacRumors e 9to5Mac relataram em agosto de 2024. A página de suporte atual da Apple não menciona novos pedidos em momento algum, e não consegui verificar a cadência do macOS 26 a partir de nenhuma fonte autoritativa.

Redefinir as permissões vai apagar meus dados?

Não. O tccutil reset apaga decisões de consentimento registradas, nada além disso. Nenhum arquivo, ajuste ou dado de app é tocado. O custo é o incômodo: cada app afetado vai perguntar de novo na próxima vez que precisar da permissão. Esse custo escala com a amplitude do seu reset, que é exatamente o motivo pelo qual você deve sempre incluir um bundle identifier.

Por que meu app funciona no Terminal mas não sozinho?

Porque o TCC atribui a requisição ao processo responsável, que para um programa aberto pelo Terminal costuma ser o próprio Terminal. Seu programa está pegando emprestada a concessão do Terminal. Sozinho, ele não tem permissão e, se for um executável simples em vez de um app bundle, pode nem aparecer no painel para receber uma.

É perigoso conceder Full Disk Access?

É a permissão mais ampla que o macOS oferece, cobrindo Mail, Messages, dados do Safari, backups do Time Machine e containers de outros apps. Conceda apenas a softwares em que você confiaria com tudo isso, e note que concedê-la a um emulador de terminal estende o alcance a todo comando que você rodar ali.

Preciso reiniciar meu Mac depois de mudar uma permissão?

Normalmente não. Encerrar e reabrir o app afetado quase sempre basta, e é um passo obrigatório porque muitos apps leem suas capacidades apenas na abertura. Uma reinicialização completa ajuda no caso mais estreito de um helper em segundo plano ou de um launch daemon que não recarrega direito. Reinicie uma vez e depois volte ao diagnóstico.

Conclusão

A maior parte da frustração nessa área vem de tratar um rótulo, "permissões", como uma coisa só. São pelo menos três: permissões de arquivo POSIX, que o chmod governa e que não têm nada a ver com nada disso; decisões de privacidade do TCC, vinculadas à identidade de assinatura de código de um app e guardadas em bancos de dados que você não consegue ler; e, em Macs gerenciados, política escrita por perfil que sobrepõe o que você pode mudar localmente.

Uma vez separadas, a árvore de decisão é curta. Um aviso de captura de tela chegando em uma programação é deliberado, não tem interruptor de desligamento, e a resposta correta é clicar em Allow e seguir o seu dia. Todo o resto é falha, e falhas têm causas: uma segunda cópia do app em disco, uma assinatura que mudou em uma atualização, um bundle que não valida mais, um helper que precisa da própria concessão, ou uma cadeia de atribuição apontando para o seu emulador de terminal em vez do seu script.

O ferramental é genuinamente magro. O tccutil tem um verbo, a Apple não publica os nomes de serviço que ele aceita, e o painel é uma visão do banco de dados que já esteve comprovadamente errada, como mostrou o bug de exibição do macOS 26.1 quando os próprios engenheiros da Apple confirmaram que as permissões estavam sendo registradas corretamente enquanto a lista se recusava a mostrá-las. Trabalhe dentro disso: verifique o bundle identifier antes de montar um comando, sempre anexe-o ao reset, siga a sequência de reconcessão limpa na ordem, e teste com uma conta de usuário nova quando estiver travado. E saiba a hora de parar. Quando você já verificou a concessão, verificou a assinatura, eliminou duplicatas e testou em uma conta limpa, como fez quem reportou o caso do Teams no macOS Tahoe 26.4, o problema restante não é seu para resolver. Reporte-o e use uma solução paliativa enquanto espera.

Leitura relacionada: Microfone do Mac não funciona no macOS Tahoe 26.5 · Segurança e privacidade no macOS Tahoe: o guia completo