Introduction

This document provides the step-by-step procedure to configure Sentry in SAFE.

SAFE integrates with Sentry and fetches the security misconfiguration of the Sentry account in SAFE.

Prerequisites

• Access required in SAFE:
  • SAFE Admin Access
• Access required in Sentry:
  • Sentry Admin Access
• Required User Inputs:
  • API URL
  • Organization Slug
  • Token
• Required Scope:
  • Organization - Read
  • Member - Read

Generate Connection Details

• How to generate API Token:
  1. Log in to your Sentry account as Admin.
  2. Click on Settings.
  3. Click on Custom Integrations under Developer Settings.

  4. Click on Create New Integration.

• 5. Select Internal Integration.

  6. Click on the Next button.

• 7. Enter the Name and click on Save Changes.

  8. Select the following permissions:

     • Organization - Read

     • Member - Read

  
  

• 9. Scroll down to the page, Under Tokens click on the New Token button.
  10. Copy and save the API Token to use it while configuring Sentry in SAFE.

  11. It's important to regularly update the API Token in SAFE according to its expiration date.

• How to get Organization Slug:
  1. Log in to your Sentry account as owner.
  2. Click on Settings.
  3. Click on General Settings under Organization.

  4. Copy and save the Organization Slug to use it while configuring Sentry in SAFE.

• How to get API URL:
  1. Access the Sentry API documentation by clicking on the provided link.
  2. Upon reaching the Sentry API documentation page, locate the section titled "Requests".

  3. In the exhibit provided, find the base URL highlighted as 3. Copy and save this API Base URL to use it while configuring Sentry in SAFE.

Configure Sentry in SAFE

1. Log in to your SAFE account as Admin.
2. Click on the Integrations option from the left navigation.

3. Scroll to find the Sentry integration card or Search for Sentry in the search bar.

4. Hover on the Sentry card and click on the Configure button.

5. Enter the following parameters:

   • API URL
   • Organization Slug
   • Token
6. Enter the Auto Sync Frequency.
7. Click on the Test Connection button.

8. Once the connection is verified, click on the Save button.

9. Click on the Sync Now button to trigger an on-demand sync.

10. Upon a successful sync, the system pulls the Sentry assets and their findings into SAFE. You can track the status of the sync in the History table.

View Results

Scroll down to the metric views available directly on the integration management dashboard:

• Finding View: This tab displays all the findings details pulled from Sentry.

• Asset View: This tab displays all the assets pulled from Sentry.

To check sync status and errors for this integration, see Integration History.

Did this article help?

Let us know by leaving a star rating at the top of this article.