Aplicativos nativos e desktop
Aplicativos móveis e desktop distribuídos aos usuários são clientes públicos: não conseguem manter um segredo de cliente confidencial. Não embuta client secrets ou chaves privadas nos binários.
Fluxo recomendado
- Registre o cliente como
nativeoudesktop, com métodonone. - Utilize Authorization Code com PKCE S256.
- Gere
state,nonceecode_verifiernovos para cada tentativa e derive ocode_challengeS256 correspondente. - Armazene esses valores de forma segura, vinculados à tentativa de autenticação, para validá-los no retorno.
- Abra a página de autorização no navegador externo do sistema, não em uma WebView incorporada, enviando o
code_challenge,stateenonce. - Receba o callback somente em um Redirect URI HTTPS previamente registrado.
- Troque o código com o
code_verifieroriginal. - Valide o ID Token por meio de uma biblioteca OIDC apropriada à plataforma.
Redirect URI HTTPS
O portal de registro do CM ID exige URLs HTTPS e rejeita esquemas personalizados, curingas, hosts locais e portas explícitas. Portanto, não presuma que esquemas como myapp://callback serão aceitos.
Quando a plataforma suportar associação de links HTTPS ao aplicativo (por exemplo, Universal Links ou Android App Links), configure e valide a associação do domínio conforme a documentação do sistema operacional e registre o endereço HTTPS exato no portal. A associação do domínio ao aplicativo é responsabilidade do desenvolvedor e precisa ser testada em dispositivos reais.
Se a plataforma ou o ambiente não oferecer um mecanismo HTTPS de retorno compatível com as regras do portal, confirme previamente com o mantenedor do serviço qual fluxo é suportado; não contorne a validação com callbacks não registrados.
Armazenamento e segurança
- Proteja tokens no armazenamento seguro do sistema operacional.
- Não grave tokens em logs, backups não protegidos ou preferências compartilhadas.
- Valide o estado da transação no retorno ao aplicativo.
- Trate cancelamento, retorno duplicado, código expirado e troca interrompida.
- Considere que o aplicativo pode ser desinstalado ou que o usuário pode revogar a autorização.