Descoberta e endpoints
O CM ID publica metadados padronizados na raiz do issuer. A descoberta é a fonte de verdade para os endpoints e as capacidades disponíveis.
Issuer padrão
text
https://id.centralmacatuba.qzz.ioOpenID Connect Discovery
http
GET /.well-known/openid-configurationURL completa:
text
https://id.centralmacatuba.qzz.io/.well-known/openid-configurationMetadados do servidor de autorização OAuth
http
GET /.well-known/oauth-authorization-serverURL completa:
text
https://id.centralmacatuba.qzz.io/.well-known/oauth-authorization-serverComo consumir
Exemplo com JavaScript:
js
const issuer = "https://id.centralmacatuba.qzz.io";
const response = await fetch(
new URL("/.well-known/openid-configuration", issuer)
);
if (!response.ok) {
throw new Error(`Falha na descoberta OIDC: ${response.status}`);
}
const metadata = await response.json();
console.log({
issuer: metadata.issuer,
authorizationEndpoint: metadata.authorization_endpoint,
tokenEndpoint: metadata.token_endpoint,
jwksUri: metadata.jwks_uri,
});O exemplo apenas lê os metadados. Ele não substitui uma biblioteca OIDC para iniciar o fluxo, trocar códigos ou validar tokens.
JWKS
O endereço do conjunto de chaves públicas deve ser obtido do campo jwks_uri dos metadados. Não construa o endereço manualmente nem armazene chaves públicas indefinidamente.
O endpoint administrativo de consulta de chaves não é uma API pública de integração. Clientes externos devem utilizar exclusivamente o JWKS público indicado pela descoberta.
Regras
- Utilize o issuer sem acrescentar
/api/auth. - Obtenha os endpoints dos metadados, sem fixar endereços que podem mudar.
- Valide se o issuer retornado corresponde exatamente ao issuer esperado.
- Utilize HTTPS.
- Trate falhas de descoberta como falhas de configuração, sem fallback silencioso para endpoints inventados.