Referência de escopos OAuth

• Pesquisa unificada entre provedores: pesquise todos os sete principais provedores OAuth simultaneamente. Digite qualquer nome de escopo, palavra-chave de descrição ou nome de categoria e veja instantaneamente os escopos correspondentes do Google, GitHub, Microsoft, Facebook, Twitter/X, Slack e Stripe. Os resultados são agrupados por provedor para que você possa comparar as convenções de nomenclatura de escopo e a disponibilidade entre plataformas.
• Referência abrangente de escopo: procure mais de 300 escopos OAuth2 organizados por provedor e categoria. Cada escopo inclui sua string exata, uma descrição em inglês simples do que ele concede acesso e um indicador sensível/privilegiado para escopos que acessam dados pessoais ou executam ações administrativas. A referência abrange todos os principais provedores de OAuth2 e suas principais APIs.
• Conscientização do escopo confidencial: escopos confidenciais que acessam dados pessoais, executam operações destrutivas ou concedem privilégios administrativos são claramente marcados com um emblema de aviso. A referência de escopos OAuth ajuda os desenvolvedores a tomar decisões informadas sobre quais escopos seu aplicativo realmente precisa, seguindo o princípio do menor privilégio.
• Gratuito e sem necessidade de inscrição: procure escopos OAuth2 para provedores ilimitados, sem inscrição, sem chave de API e sem limites de uso. Todos os dados são incorporados diretamente na página - sem necessidade de solicitações de rede. Não armazenamos, registramos ou processamos quaisquer dados em nossos servidores. Completamente grátis, para sempre.

• Planejamento de integração OAuth: os desenvolvedores que planejam uma integração OAuth2 podem usar a Referência de escopos OAuth para determinar quais escopos são necessários para seu aplicativo. Pesquise entre provedores para encontrar as sequências de escopo exatas para recursos como leitura de e-mail, acesso a arquivos, gerenciamento de calendários ou postagem em mídias sociais. A referência ajuda a evitar a solicitação de escopos desnecessários.
• Auditorias de segurança e privacidade: os engenheiros de segurança que analisam as permissões do aplicativo podem usar a referência de escopos OAuth para identificar escopos confidenciais que devem ser sinalizados durante a revisão do código. Os indicadores sensíveis de escopo ajudam os auditores a identificar rapidamente escopos que acessam dados pessoais, realizam operações destrutivas ou concedem privilégios administrativos que podem violar os princípios de privilégio mínimo.
• Configuração do cliente API: ao configurar clientes API ou SDKs para provedores OAuth2, os desenvolvedores precisam das strings de escopo exatas. A referência de escopos OAuth fornece valores de escopo precisos para cada provedor, organizados por categoria de API. Basta encontrar o escopo necessário e copiá-lo diretamente na configuração do OAuth.
• Aprendizagem e educação do OAuth2: estudantes e desenvolvedores que estão aprendendo o OAuth2 podem explorar a referência de escopo para entender como diferentes provedores lidam com a autorização. Compare as convenções de nomenclatura de escopo entre provedores, veja como os escopos confidenciais são categorizados e saiba quais permissões são necessárias para operações comuns de API.
• Desenvolvimento de aplicativos multiprovedores: aplicativos que se integram a vários provedores (por exemplo, fazer login no Google ou GitHub, acessar calendários, gerenciar mídias sociais) precisam coletar escopos de cada provedor. A referência de escopos OAuth facilita a navegação e a cópia dos escopos corretos para cada integração, tudo em um só lugar.
• Diagnóstico de bug relacionado ao escopo: quando uma integração do OAuth falha com um erro de permissões insuficientes, os desenvolvedores podem usar a referência de escopos do OAuth para verificar se estão solicitando o escopo correto. Verifique se a cadeia de caracteres do escopo está correta, se um escopo mais específico está disponível e se o escopo concede o nível de acesso que o aplicativo precisa.

Os escopos OAuth2 são tokens de permissão que definem quais recursos um aplicativo pode acessar em nome de um usuário. Quando um usuário autoriza um aplicativo via OAuth2, ele concede escopos específicos que limitam o que o aplicativo pode fazer. Por exemplo, um escopo como user:email permite a leitura do endereço de email do usuário, enquanto repo concede acesso total aos repositórios. Os escopos seguem o princípio do menor privilégio – os aplicativos devem solicitar apenas os escopos de que realmente precisam. A especificação OAuth2 não define escopos padrão; cada provedor define suas próprias strings de escopo e significados.

1. Determine os recursos necessários: identifique o que seu aplicativo precisa fazer – ler o perfil do usuário, enviar e-mails, fazer upload de arquivos, gerenciar calendários, etc. Cada recurso é mapeado para um ou mais escopos OAuth.
2. Encontre as strings de escopo corretas: use a Referência de escopos OAuth para encontrar a string de escopo exata para cada recurso do seu provedor de destino. As strings de escopo diferenciam maiúsculas de minúsculas e são específicas do provedor.
3. Escopos de solicitação durante a autorização: inclua o parâmetro de escopo no URL de solicitação de autorização do OAuth2 com os escopos solicitados separados por espaços (ou sinais de mais nas strings de consulta).
4. Lidar com alterações de escopo: os usuários podem revogar escopos individuais das configurações de sua conta. Seu aplicativo deve lidar com casos em que alguns escopos, mas não todos, são concedidos.

• Privilégio mínimo: solicite apenas os escopos que seu aplicativo realmente precisa. Evite solicitar escopos amplos, como repo ou drive, quando escopos mais específicos, como public_repo ou drive.file, forem suficientes.
• Sinalizadores de escopo confidenciais: muitos provedores marcam determinados escopos como confidenciais ou restritos. Normalmente, eles exigem verificação adicional do provedor (revisão do aplicativo, verificação comercial) e acesso a dados pessoais, informações financeiras ou funções administrativas.
• Granularidade do escopo: as implementações modernas do OAuth2 oferecem escopos cada vez mais granulares. Por exemplo, em vez de um único escopo de “calendário”, o Google oferece escopos separados de leitura e gravação. Prefira escopos refinados aos amplos.
• Escopos versus chaves de API: os escopos do OAuth2 são específicos do usuário e temporários. As chaves de API são permanentes e abrangem todo o aplicativo. Sempre use o OAuth2 com escopos para operações que precisam de autorização do usuário.

A referência de escopos OAuth processa todos os dados inteiramente em seu navegador. Nenhuma consulta de pesquisa, seleção de provedor ou dados de escopo são carregados, armazenados ou transmitidos para qualquer servidor. Todas as informações de escopo são incorporadas diretamente na página. Isso significa que você pode navegar pelas informações do escopo do OAuth com total privacidade, e a ferramenta funciona mesmo quando você está offline após o carregamento inicial da página. Não há limites de uso nem chaves de API necessárias.