Integrating Decipher with Sentry

1

Get your new DSN by creating a project in Decipher

Log in to Decipher with your work email. On the Settings page, choose a project name and click “Create New Project”.

We auto-create a Decipher-only project called “FirstFrontendProject” when your organization registers with Decipher, but that is separate from the Sentry project you’re about to add.

On the following screen, decide where you want to send data. We recommend choosing Decipher only to avoid double charges.

I want to send data to Decipher only

I want to send data to Decipher and Sentry

2

Update your Sentry initialization to use the new DSN and configuration

NextJS

Update your instrumentation-client.ts to use your new dsn and make sure replayIntegration and replaysSessionSampleRate are set.Additionally, update sentry.edge.config.ts, and sentry.server.config.ts files to use your new dsn.

On older @sentry/nextjs versions update your sentry.client.config.ts instead of instrumentation-client.ts.

Sentry.init({
  dsn: "YOUR_DSN_FROM_DECIPHER", // Get this at https://app.getdecipher.com/settings
  integrations: [
      Sentry.replayIntegration({
          maskAllText: false,
          blockAllMedia: false,
          maskAllInputs: true,
          networkDetailAllowUrls: [/^.*$/],
      }),
      // You can optionally specify log levels (see further docs)
      Sentry.captureConsoleIntegration(),
      Sentry.browserTracingIntegration(),
  ],
  replaysOnErrorSampleRate: 1.0,
  replaysSessionSampleRate: 1.0,
});

Other Frameworks

In your codebase, update the line that sets the dsn field of your existing Sentry initialization to use the new value you got from Step 1, and ensure that replayIntegration and replaysSessionSampleRate are set. For example:

    Sentry.init({
    dsn: "YOUR_DSN_FROM_DECIPHER", // Get this at https://app.getdecipher.com/settings
    integrations: [
        Sentry.replayIntegration({
            maskAllText: false,
            blockAllMedia: false,
            maskAllInputs: true,
            networkDetailAllowUrls: [/^.*$/],
        }),
        // You can optionally specify log levels (see further docs)
        Sentry.captureConsoleIntegration(),
        Sentry.browserTracingIntegration(),
    ],
    replaysOnErrorSampleRate: 1.0,
    replaysSessionSampleRate: 1.0,
  });

3

Identify Users

If you aren’t already doing this, make sure to identify users where user information is available in your application frontend, typically after authentication or login.

// Set user information in Decipher via the Sentry TypeScript SDK
Sentry.setUser({
  "email": "jane.doe@example.com",  // Recommended identifier to set
  "id": "your_internal_unique_identifier", // Optional: use if email not available
  "username": "unique_username", // Optional: use if email not available
  "account": "AcmeCo",  // Recommended: Which account/organization is this user a member of?
  "created_at": "2025-04-01T15:30:00Z", // Recommended: date this user signed up.
  // You can add more user information here as key/value pairs.
});

Once you’re done, simply use your website to validate that Decipher is collecting session replay data (and that Sentry is too, if you selected that option).

Introduction

Quickstart

Features

Advanced

Migrations

Integrating Decipher with Sentry