Skip to content

Add detailed explanations for integration with GitHub, GitLab, Jira, and external entity providers#93

Open
refoo0 wants to merge 1 commit intomainfrom
add-integration-explanations
Open

Add detailed explanations for integration with GitHub, GitLab, Jira, and external entity providers#93
refoo0 wants to merge 1 commit intomainfrom
add-integration-explanations

Conversation

@refoo0
Copy link
Member

@refoo0 refoo0 commented Feb 12, 2026

No description provided.

…and external entity providers

Signed-off-by: rafi <refaei.shikho@hotmail.com>
@seb-kw seb-kw requested a review from Ph4t3 February 13, 2026 08:17
| External Entity | DevGuard Entity |
|-----------------|-----------------|
| GitLab Instance | Organization |
| GitLab Group | Project |
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We are calling it now Group in the frontend.

Suggested change
| GitLab Group | Project |
| GitLab Group | Group |

|-----------------|-----------------|
| GitLab Instance | Organization |
| GitLab Group | Project |
| GitLab Project | Asset |
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| GitLab Project | Asset |
| GitLab Project | Project |


Synchronization occurs automatically when:
- Users authenticate via the external provider
- Users access an organization linked to an external entity
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We are doing this only after a fixed interval. So not all requests to an organization will issue a whole sync.

## Limitations

- **Provider Support**: Currently limited to GitLab
- **Token Validity**: Requires valid OAuth2 tokens for sync
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is another limitation: devguard can never decide if a user just lost access to an repository on Gitlab or if it got deleted. Thus devguard will be never delete any external entity projects and instead just revokes permissions

| Command | Effect |
|---------|--------|
| `/accept <reason>` | Accept the vulnerability risk |
| `/false-positive <reason>` | Mark as false positive |
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please double check. Isn't the user forced to provide the mechanical justification instead like vulnerable code not present?

@timbastin
Copy link
Member

@refoo0 i added some comments

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants