# Feature OP-18545 - Capture external links in user-provided contents

Project: OpenProject
Status: closed
URL: https://community.openproject.org/work_packages/OP-18545

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | High |
| Target versions | 17.1.0 |
| Sprint | 17.1.0 |
| Backlog bucket |  |
| Votes |  |
| List | Security initiatives |
| Roadmap |  |
| Relevance |  |

## OPEN POINTS / FEEDBACK

| ID | Subject | Status | Decision |
| --- | --- | --- | --- |
| OP-18820 | Capitalization in the enterprise add-on banner for "Capture external links" | new |  |

## Features and Chunks

_No work packages_

## Bugs and other work packages

| ID | Type | Subject | Status | Assignee | Target versions | Spent time | Module |
| --- | --- | --- | --- | --- | --- | --- | --- |
| OP-18721 | Bug | External link warning page cut off on mobile | closed |  | 17.1.0 |  |  |
| OP-18882 | Bug | External links with encoded space in path lead to OpenProject home page | closed |  | 17.1.1 |  | DevSecOps / Security |
| OP-18878 | Bug | External links in notification emails not captured | closed |  | 17.1.1 |  | Modules and project features / Email notifications |
| COMMS-620 | Bug | External link capture not working in documents | closed |  | 17.4.0 |  | Modules and project features / Text editor, Modules and project features / Text editor / Real time collaboration |

## Technical Details

| Attribute | Value |
| --- | --- |
| Module | DevSecOps / Security |
| Feature Flag |  |
| Requires doc change | Yes |
| Enterprise plan | Enterprise / Premium (PRE) |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups |  |
| Accessibility | No |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable |  |
| Product manager |  |
| Feature Lead |  |
| Developers | Oliver Günther |
| Designer |  |
| Ordered by | Markus Kahl |
| Signed off by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| PD (min) |  |
| PD (max) |  |
| Work | 5d 0h · Σ 5d 0h |
| Labor costs |  |

## Description

**As** an administrator  
**I want to** be able to capture external links and warn users when they leave the application  
**so that** I can reduce phishing or other social engineering attacks

**Acceptance criteria**

<br>

*   Allow setting this under Administration &gt; System settings using a new &quot;External links&quot; tabs
    
*   Add a filter step to the HTML pipeline at the end, which detects all non-relative links that are not starting with the Setting.protocol and Setting.host\_name, and redirect them
    
*   Add an internal route to catch them, warning users about the link
    
    *   showing the link
        
    *   having buttons &quot;Continue to external website&quot; and &quot;Cancel&quot;
        

<br>

<figure class="image op-uc-figure"><div class="op-uc-figure--content"><img class="op-uc-image" src="https://community.openproject.org/api/v3/attachments/918232/content"></div></figure>

<br>

<br>

**Technical notes**

*   Add a setting `capture_external_links` which is on by default
    

**Permissions and visibility considerations**

*   _To whom is this feature visible?_
    
*   _When is it not visible?_
    

**Translation considerations**

*   _Key terms and phrases in the key languages_&nbsp;
    

**Out of scope**

*   <br>
    

_Set the_ **To be informed/consulted teams** _field to include all teams necessary to be informed of the changes._
