Definir o escopo do que um token pode fazer
Limite o acesso apenas às ferramentas e aos dados corretos.
Definir o escopo do que um token pode fazer é uma aula grátis de MCP Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de MCP Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de MCP Academy inclui 4 aulas no total.
Um token não dá acesso a tudo
Um token válido não deve desbloquear tudo. Os escopos permitem que um token carregue apenas as permissões específicas de que seu titular realmente precisa. 🎯
O que é um escopo
Um escopo é uma permissão nomeada, como leitura ou gravação. Os tokens são emitidos com um conjunto de escopos que descreve o que eles podem fazer.
Privilégio mínimo
Siga o princípio do privilégio mínimo: conceda o menor conjunto de escopos que permita concluir a tarefa, sem nada além disso.
Os escopos acompanham o token
Quando o OAuth emite um token, os escopos concedidos são registrados com ele. O servidor pode lê-los para decidir o que permitir.
{
"access_token": "eyJ...",
"scope": "tools:read tools:run"
}Verifique o escopo por ferramenta
Antes de executar uma ferramenta sensível, confirme se o token inclui o escopo necessário. Se ele estiver ausente, recuse a chamada.
if "tools:run" not in token_scopes:
raise HTTPException(status_code=403)Leitura versus gravação
Separe um escopo de leitura de um escopo de gravação, para que um token destinado apenas a consultar dados não possa modificá-los silenciosamente.
Permissões por ferramenta
Você pode definir o escopo do acesso ferramenta por ferramenta, disponibilizando uma calculadora segura para todos e protegendo uma ferramenta de exclusão com um escopo mais rigoroso.
Limite os dados também
Os escopos podem limitar quais recursos um token pode ver, como uma única pasta de projeto, em vez de todos os arquivos que o servidor consegue acessar.
Escopo ausente significa 403
Uma solicitação com um token válido, mas com o escopo incorreto, está autenticada, porém não é permitida; portanto, a resposta correta é 403 Forbidden.
Audite o que você concedeu
Mantenha um registro de quais tokens possuem quais escopos. Uma trilha de auditoria deixa claro quem poderia fazer o quê se algo desse errado.
Aperte as permissões com o tempo
Revise os escopos regularmente e revogue os que não forem mais necessários. Restringir as permissões reduz continuamente sua superfície de ataque.
Verificação rápida
Escolha a opção de design mais segura.
Recapitulação: acesso apenas ao necessário
Os escopos transformam um token em uma chave precisa. Conceda o mínimo necessário, verifique por ferramenta e responda 403 quando faltar um escopo. 🗝️
Aprenda Python com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 30
- Aulas
- 120
Perguntas Frequentes
A aula “Definir o escopo do que um token pode fazer” é grátis?
Sim — o texto completo de “Definir o escopo do que um token pode fazer” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de MCP Academy, atualize para CoddyKit PRO. O curso de MCP Academy inclui 4 aulas no total.
O que vou aprender em “Definir o escopo do que um token pode fazer”?
Limite o acesso apenas às ferramentas e aos dados corretos. Você pratica MCP Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar MCP Academy?
Nenhuma experiência prévia é necessária. MCP Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.
Quanto tempo leva a aula “Definir o escopo do que um token pode fazer”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de MCP Academy?
Sim. Cada aula de MCP Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Por que servidores remotos precisam de autenticação
- Tokens de portador e cabeçalhos
- O fluxo OAuth no MCP
- Definir o escopo do que um token pode fazer