Skip to content

fix(browser): Ensure IP address is only inferred by Relay if sendDefaultPii is true #17364

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Aug 11, 2025
Merged
Show file tree
Hide file tree
Changes from 7 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,9 @@ sentryTest('should capture feedback with custom button', async ({ getLocalTestUr
version: expect.any(String),
name: 'sentry.javascript.browser',
packages: expect.anything(),
settings: {
infer_ip: 'never',
},
},
request: {
url: `${TEST_HOST}/index.html`,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,9 @@ sentryTest('should capture feedback', async ({ getLocalTestUrl, page }) => {
version: expect.any(String),
name: 'sentry.javascript.browser',
packages: expect.anything(),
settings: {
infer_ip: 'never',
},
},
request: {
url: `${TEST_HOST}/index.html`,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -95,6 +95,9 @@ sentryTest('should capture feedback', async ({ forceFlushReplay, getLocalTestUrl
version: expect.any(String),
name: 'sentry.javascript.browser',
packages: expect.anything(),
settings: {
infer_ip: 'never',
},
},
request: {
url: `${TEST_HOST}/index.html`,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,9 @@ sentryTest('should capture feedback', async ({ getLocalTestUrl, page }) => {
version: expect.any(String),
name: 'sentry.javascript.browser',
packages: expect.anything(),
settings: {
infer_ip: 'never',
},
},
request: {
url: `${TEST_HOST}/index.html`,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,9 @@ sentryTest('allows to setup a client manually & capture exceptions', async ({ ge
name: 'sentry.javascript.browser',
version: expect.any(String),
packages: [{ name: expect.any(String), version: expect.any(String) }],
settings: {
infer_ip: 'never',
},
},
contexts: {
trace: { trace_id: expect.stringMatching(/[a-f0-9]{32}/), span_id: expect.stringMatching(/[a-f0-9]{16}/) },
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,5 +39,8 @@ sentryTest('should capture correct SDK metadata', async ({ getLocalTestUrl, page
version: SDK_VERSION,
},
],
settings: {
infer_ip: 'never',
},
});
});
Original file line number Diff line number Diff line change
@@ -1,10 +1,12 @@
import { expect } from '@playwright/test';
import type { Event } from '@sentry/core';
import { sentryTest } from '../../../../utils/fixtures';
import { getFirstSentryEnvelopeRequest } from '../../../../utils/helpers';
import { envelopeRequestParser, waitForErrorRequestOnUrl } from '../../../../utils/helpers';

sentryTest('should default user to {{auto}} on errors when sendDefaultPii: true', async ({ getLocalTestUrl, page }) => {
const url = await getLocalTestUrl({ testDir: __dirname });
const eventData = await getFirstSentryEnvelopeRequest<Event>(page, url);
expect(eventData.user?.ip_address).toBe('{{auto}}');
});
sentryTest(
'sets sdk.settings.infer_ip to "auto" on errors when sendDefaultPii: true',
async ({ getLocalTestUrl, page }) => {
const url = await getLocalTestUrl({ testDir: __dirname });
const eventData = await envelopeRequestParser(await waitForErrorRequestOnUrl(page, url));
expect(eventData.sdk?.settings?.infer_ip).toBe('auto');
},
);
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ import {
} from '../../../../utils/helpers';

sentryTest(
'should default user to {{auto}} on transactions when sendDefaultPii: true',
'sets user.ip_address to "auto" on transactions when sendDefaultPii: true',
async ({ getLocalTestUrl, page }) => {
if (shouldSkipTracingTest()) {
sentryTest.skip();
Expand All @@ -16,6 +16,6 @@ sentryTest(
const url = await getLocalTestUrl({ testDir: __dirname });
const req = await waitForTransactionRequestOnUrl(page, url);
const transaction = envelopeRequestParser(req);
expect(transaction.user?.ip_address).toBe('{{auto}}');
expect(transaction.sdk?.settings?.infer_ip).toBe('auto');
},
);
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ import { sentryTest } from '../../../../utils/fixtures';
import { getReplayEvent, shouldSkipReplayTest, waitForReplayRequest } from '../../../../utils/replayHelpers';

sentryTest(
'replay recording should contain default performance spans',
'sets sdk.settings.infer_ip to "auto" on replay events when sendDefaultPii: true',
async ({ getLocalTestUrl, page, browserName }) => {
// We only test this against the NPM package and replay bundles
// and only on chromium as most performance entries are only available in chromium
Expand All @@ -18,6 +18,6 @@ sentryTest(
await page.goto(url);
const replayEvent = getReplayEvent(await reqPromise0);

expect(replayEvent.user?.ip_address).toBe('{{auto}}');
expect(replayEvent.sdk?.settings?.infer_ip).toBe('auto');
},
);
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ import { sentryTest } from '../../../../utils/fixtures';
import { getFirstSentryEnvelopeRequest } from '../../../../utils/helpers';

sentryTest(
'should default user to {{auto}} on sessions when sendDefaultPii: true',
'sets attrs.ip_address user to {{auto}} on sessions when sendDefaultPii: true',
async ({ getLocalTestUrl, page }) => {
const url = await getLocalTestUrl({ testDir: __dirname });
const session = await getFirstSentryEnvelopeRequest(page, url);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ sentryTest('should unset user', async ({ getLocalTestUrl, page }) => {
expect(eventData[0].message).toBe('no_user');

// because sendDefaultPii: true
expect(eventData[0].user).toEqual({ ip_address: '{{auto}}' });
expect(eventData[0].sdk?.settings?.infer_ip).toBe('auto');

expect(eventData[1].message).toBe('user');
expect(eventData[1].user).toEqual({
Expand All @@ -23,7 +23,5 @@ sentryTest('should unset user', async ({ getLocalTestUrl, page }) => {
expect(eventData[2].message).toBe('unset_user');

// because sendDefaultPii: true
expect(eventData[2].user).toEqual({
ip_address: '{{auto}}',
});
expect(eventData[2].sdk?.settings?.infer_ip).toBe('auto');
});
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,11 @@ sentryTest('should update user', async ({ getLocalTestUrl, page }) => {
id: 'foo',
ip_address: 'bar',
});
expect(eventData[0].sdk?.settings?.infer_ip).toBe('auto');

expect(eventData[1].message).toBe('second_user');
expect(eventData[1].user).toEqual({
id: 'baz',
ip_address: '{{auto}}',
});
expect(eventData[1].sdk?.settings?.infer_ip).toBe('auto');
});
Original file line number Diff line number Diff line change
Expand Up @@ -11,34 +11,28 @@ sentryTest('should allow nested scoping', async ({ getLocalTestUrl, page }) => {
expect(eventData[0].message).toBe('root_before');
expect(eventData[0].user).toEqual({
id: 'qux',
ip_address: '{{auto}}', // because sendDefaultPii: true
});
expect(eventData[0].tags).toBeUndefined();

expect(eventData[1].message).toBe('outer_before');
expect(eventData[1].user).toEqual({
id: 'qux',
ip_address: '{{auto}}', // because sendDefaultPii: true
});
expect(eventData[1].tags).toMatchObject({ foo: false });

expect(eventData[2].message).toBe('inner');
expect(eventData[2].user).toEqual({
ip_address: '{{auto}}', // because sendDefaultPii: true
});
expect(eventData[2].user).toEqual({});
expect(eventData[2].tags).toMatchObject({ foo: false, bar: 10 });

expect(eventData[3].message).toBe('outer_after');
expect(eventData[3].user).toEqual({
id: 'baz',
ip_address: '{{auto}}', // because sendDefaultPii: true
});
expect(eventData[3].tags).toMatchObject({ foo: false });

expect(eventData[4].message).toBe('root_after');
expect(eventData[4].user).toEqual({
id: 'qux',
ip_address: '{{auto}}', // because sendDefaultPii: true
});
expect(eventData[4].tags).toBeUndefined();
});
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,9 @@ sentryTest('should capture replays (@sentry/browser export)', async ({ getLocalT
]),
version: SDK_VERSION,
name: 'sentry.javascript.browser',
settings: {
infer_ip: 'never',
},
},
request: {
url: `${TEST_HOST}/index.html`,
Expand Down Expand Up @@ -85,6 +88,9 @@ sentryTest('should capture replays (@sentry/browser export)', async ({ getLocalT
]),
version: SDK_VERSION,
name: 'sentry.javascript.browser',
settings: {
infer_ip: 'never',
},
},
request: {
url: `${TEST_HOST}/index.html`,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,9 @@ sentryTest('should capture replays (@sentry-internal/replay export)', async ({ g
]),
version: SDK_VERSION,
name: 'sentry.javascript.browser',
settings: {
infer_ip: 'never',
},
},
request: {
url: `${TEST_HOST}/index.html`,
Expand Down Expand Up @@ -85,6 +88,9 @@ sentryTest('should capture replays (@sentry-internal/replay export)', async ({ g
]),
version: SDK_VERSION,
name: 'sentry.javascript.browser',
settings: {
infer_ip: 'never',
},
},
request: {
url: `${TEST_HOST}/index.html`,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,9 @@ const DEFAULT_REPLAY_EVENT = {
]),
version: SDK_VERSION,
name: 'sentry.javascript.browser',
settings: {
infer_ip: 'never',
},
},
request: {
url: expect.stringContaining('/index.html'),
Expand Down
3 changes: 3 additions & 0 deletions packages/astro/test/client/sdk.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,9 @@ describe('Sentry client SDK', () => {
{ name: 'npm:@sentry/astro', version: SDK_VERSION },
{ name: 'npm:@sentry/browser', version: SDK_VERSION },
],
settings: {
infer_ip: 'never',
},
},
},
}),
Expand Down
11 changes: 9 additions & 2 deletions packages/browser/src/client.ts
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,6 @@ import type {
import {
_INTERNAL_flushLogsBuffer,
addAutoIpAddressToSession,
addAutoIpAddressToUser,
applySdkMetadata,
Client,
getSDKSource,
Expand Down Expand Up @@ -83,6 +82,15 @@ export class BrowserClient extends Client<BrowserClientOptions> {
const sdkSource = WINDOW.SENTRY_SDK_SOURCE || getSDKSource();
applySdkMetadata(opts, 'browser', ['browser'], sdkSource);

// Only allow IP inferral by Relay if sendDefaultPii is true
if (opts._metadata?.sdk) {
opts._metadata.sdk.settings = {
infer_ip: opts.sendDefaultPii ? 'auto' : 'never',
// purposefully allowing already passed settings to override the default
...opts._metadata.sdk.settings,
};
}

super(opts);

const { sendDefaultPii, sendClientReports, enableLogs } = this._options;
Expand Down Expand Up @@ -117,7 +125,6 @@ export class BrowserClient extends Client<BrowserClientOptions> {
}

if (sendDefaultPii) {
this.on('postprocessEvent', addAutoIpAddressToUser);
this.on('beforeSendSession', addAutoIpAddressToSession);
}
}
Expand Down
90 changes: 90 additions & 0 deletions packages/browser/test/client.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -184,3 +184,93 @@ describe('applyDefaultOptions', () => {
WINDOW.SENTRY_RELEASE = releaseBefore;
});
});

describe('SDK metadata', () => {
describe('sdk.settings', () => {
it('sets infer_ipto "never" by default', () => {
const options = getDefaultBrowserClientOptions({});
const client = new BrowserClient(options);

expect(client.getOptions()._metadata?.sdk?.settings?.infer_ip).toBe('never');
});

it('sets infer_ip to "never" if sendDefaultPii is false', () => {
const options = getDefaultBrowserClientOptions({
sendDefaultPii: false,
});
const client = new BrowserClient(options);

expect(client.getOptions()._metadata?.sdk?.settings?.infer_ip).toBe('never');
});

it('sets infer_ip to "auto" if sendDefaultPii is true', () => {
const options = getDefaultBrowserClientOptions({
sendDefaultPii: true,
});
const client = new BrowserClient(options);

expect(client.getOptions()._metadata?.sdk?.settings?.infer_ip).toBe('auto');
});

it("doesn't override already set sdk metadata settings", () => {
const options = getDefaultBrowserClientOptions({
sendDefaultPii: true,
_metadata: {
sdk: {
settings: {
infer_ip: 'never',
// @ts-expect-error -- not typed but let's test anyway
other_random_setting: 'some value',
},
},
},
});
const client = new BrowserClient(options);

expect(client.getOptions()._metadata?.sdk?.settings).toEqual({
infer_ip: 'never',
other_random_setting: 'some value',
});
});

it('still sets infer_ip if other SDK metadata was already passed in', () => {
const options = getDefaultBrowserClientOptions({
_metadata: {
sdk: {
name: 'sentry.javascript.angular',
},
},
});
const client = new BrowserClient(options);

expect(client.getOptions()._metadata?.sdk).toEqual({
name: 'sentry.javascript.angular',
settings: {
infer_ip: 'never',
},
});
});
});

describe('sdk data', () => {
it('sets sdk.name to "sentry.javascript.browser" by default', () => {
const options = getDefaultBrowserClientOptions({});
const client = new BrowserClient(options);

expect(client.getOptions()._metadata?.sdk?.name).toBe('sentry.javascript.browser');
});

it("doesn't override already set sdk metadata", () => {
const options = getDefaultBrowserClientOptions({
_metadata: {
sdk: {
name: 'sentry.javascript.angular',
},
},
});
const client = new BrowserClient(options);

expect(client.getOptions()._metadata?.sdk?.name).toBe('sentry.javascript.angular');
});
});
});
Loading