fix: validate OAuth discovery endpoints against SSRF
This commit is contained in:
@@ -1,6 +1,23 @@
|
|||||||
import { describe, it, expect, vi, beforeEach } from 'vitest';
|
import { describe, it, expect, vi, beforeEach } from 'vitest';
|
||||||
import type { OAuthMetadata } from '../oauth/discovery';
|
import type { OAuthMetadata } from '../oauth/discovery';
|
||||||
|
|
||||||
|
vi.mock('../security/url-guard', () => ({
|
||||||
|
isPublicHttpUrl: vi.fn(async (urlString: string) => {
|
||||||
|
try {
|
||||||
|
const url = new URL(urlString);
|
||||||
|
if (url.protocol !== 'http:' && url.protocol !== 'https:') return false;
|
||||||
|
if (url.username || url.password) return false;
|
||||||
|
const host = url.hostname.toLowerCase();
|
||||||
|
if (host === 'localhost' || host.endsWith('.local') || host.endsWith('.internal')) return false;
|
||||||
|
if (/^(127\.|169\.254\.|10\.|192\.168\.)/.test(host)) return false;
|
||||||
|
if (host === '::1' || host === '0.0.0.0') return false;
|
||||||
|
return true;
|
||||||
|
} catch {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}),
|
||||||
|
}));
|
||||||
|
|
||||||
const VALID_METADATA: OAuthMetadata = {
|
const VALID_METADATA: OAuthMetadata = {
|
||||||
issuer: 'https://auth.example.com',
|
issuer: 'https://auth.example.com',
|
||||||
authorization_endpoint: 'https://auth.example.com/authorize',
|
authorization_endpoint: 'https://auth.example.com/authorize',
|
||||||
@@ -92,6 +109,45 @@ describe('oauth/discovery', () => {
|
|||||||
expect(consoleSpy).toHaveBeenCalled();
|
expect(consoleSpy).toHaveBeenCalled();
|
||||||
});
|
});
|
||||||
|
|
||||||
|
it('rejects metadata pointing at loopback / link-local hosts (SSRF guard)', async () => {
|
||||||
|
const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
|
||||||
|
vi.stubGlobal('fetch', vi.fn()
|
||||||
|
.mockResolvedValueOnce({
|
||||||
|
ok: true,
|
||||||
|
json: () => Promise.resolve({
|
||||||
|
issuer: 'https://evil.example.com',
|
||||||
|
authorization_endpoint: 'https://evil.example.com/authorize',
|
||||||
|
token_endpoint: 'http://169.254.169.254/latest/meta-data/iam/security-credentials/',
|
||||||
|
}),
|
||||||
|
})
|
||||||
|
.mockResolvedValueOnce({ ok: false, status: 404 }));
|
||||||
|
|
||||||
|
const result = await discoverOAuth('https://evil.example.com');
|
||||||
|
|
||||||
|
expect(result).toBeNull();
|
||||||
|
expect(consoleSpy).toHaveBeenCalled();
|
||||||
|
});
|
||||||
|
|
||||||
|
it('rejects metadata pointing at private RFC1918 hosts (SSRF guard)', async () => {
|
||||||
|
const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
|
||||||
|
vi.stubGlobal('fetch', vi.fn()
|
||||||
|
.mockResolvedValueOnce({
|
||||||
|
ok: true,
|
||||||
|
json: () => Promise.resolve({
|
||||||
|
issuer: 'https://evil.example.com',
|
||||||
|
authorization_endpoint: 'https://evil.example.com/authorize',
|
||||||
|
token_endpoint: 'https://evil.example.com/token',
|
||||||
|
revocation_endpoint: 'http://127.0.0.1:9200/_cluster/state',
|
||||||
|
}),
|
||||||
|
})
|
||||||
|
.mockResolvedValueOnce({ ok: false, status: 404 }));
|
||||||
|
|
||||||
|
const result = await discoverOAuth('https://private-revoke.example.com');
|
||||||
|
|
||||||
|
expect(result).toBeNull();
|
||||||
|
expect(consoleSpy).toHaveBeenCalled();
|
||||||
|
});
|
||||||
|
|
||||||
it('caches results - second call for same server URL does not re-fetch', async () => {
|
it('caches results - second call for same server URL does not re-fetch', async () => {
|
||||||
vi.stubGlobal('fetch', vi.fn().mockResolvedValueOnce({
|
vi.stubGlobal('fetch', vi.fn().mockResolvedValueOnce({
|
||||||
ok: true,
|
ok: true,
|
||||||
|
|||||||
@@ -1,3 +1,5 @@
|
|||||||
|
import { isPublicHttpUrl } from '../security/url-guard';
|
||||||
|
|
||||||
export interface OAuthMetadata {
|
export interface OAuthMetadata {
|
||||||
issuer: string;
|
issuer: string;
|
||||||
authorization_endpoint: string;
|
authorization_endpoint: string;
|
||||||
@@ -22,6 +24,20 @@ function rememberMetadata(serverUrl: string, metadata: OAuthMetadata): void {
|
|||||||
metadataCache.set(serverUrl, { metadata, expiresAt: Date.now() + CACHE_TTL_MS });
|
metadataCache.set(serverUrl, { metadata, expiresAt: Date.now() + CACHE_TTL_MS });
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Endpoints come from an attacker-controllable JSON document when callers pass
|
||||||
|
// a user-supplied serverUrl (e.g. /api/auth/totp-token-exchange under
|
||||||
|
// allowCustomJmapEndpoint). Without this gate, a malicious metadata document
|
||||||
|
// could point token_endpoint at 169.254.169.254 or 127.0.0.1:* and turn the
|
||||||
|
// downstream fetch() into an SSRF with response-body reflection.
|
||||||
|
async function endpointsArePublic(endpoints: Array<string | undefined>): Promise<boolean> {
|
||||||
|
for (const endpoint of endpoints) {
|
||||||
|
if (endpoint === undefined) continue;
|
||||||
|
if (typeof endpoint !== 'string') return false;
|
||||||
|
if (!(await isPublicHttpUrl(endpoint))) return false;
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
export async function discoverOAuth(serverUrl: string): Promise<OAuthMetadata | null> {
|
export async function discoverOAuth(serverUrl: string): Promise<OAuthMetadata | null> {
|
||||||
const cached = metadataCache.get(serverUrl);
|
const cached = metadataCache.get(serverUrl);
|
||||||
if (cached && cached.expiresAt > Date.now()) return cached.metadata;
|
if (cached && cached.expiresAt > Date.now()) return cached.metadata;
|
||||||
@@ -44,6 +60,16 @@ export async function discoverOAuth(serverUrl: string): Promise<OAuthMetadata |
|
|||||||
|
|
||||||
const data = await response.json();
|
const data = await response.json();
|
||||||
if (data.authorization_endpoint && data.token_endpoint) {
|
if (data.authorization_endpoint && data.token_endpoint) {
|
||||||
|
const allPublic = await endpointsArePublic([
|
||||||
|
data.authorization_endpoint,
|
||||||
|
data.token_endpoint,
|
||||||
|
data.revocation_endpoint,
|
||||||
|
data.end_session_endpoint,
|
||||||
|
]);
|
||||||
|
if (!allPublic) {
|
||||||
|
errors.push(`${url} returned non-public or invalid endpoint URL`);
|
||||||
|
continue;
|
||||||
|
}
|
||||||
const metadata: OAuthMetadata = {
|
const metadata: OAuthMetadata = {
|
||||||
issuer: data.issuer,
|
issuer: data.issuer,
|
||||||
authorization_endpoint: data.authorization_endpoint,
|
authorization_endpoint: data.authorization_endpoint,
|
||||||
|
|||||||
Reference in New Issue
Block a user