From be2a1c0c501160477872a52cebc92bf5bfe3453b Mon Sep 17 00:00:00 2001 From: Lars Date: Mon, 10 Nov 2025 15:48:40 +0100 Subject: [PATCH 1/4] init commit, added keypoints --- src/pages/feature-guides/_meta.ts | 3 ++ .../organization-wide-search.mdx | 32 +++++++++++++++++++ 2 files changed, 35 insertions(+) create mode 100644 src/pages/feature-guides/organization-wide-search.mdx diff --git a/src/pages/feature-guides/_meta.ts b/src/pages/feature-guides/_meta.ts index 7768c73..41e4256 100644 --- a/src/pages/feature-guides/_meta.ts +++ b/src/pages/feature-guides/_meta.ts @@ -9,4 +9,7 @@ export default { 'several-assets-and-artifacts-to-devguard-monorepos': { title: 'Mapping Several Assets and Artifacts (e.g., Monorepos)', }, + 'organization-wide-search': { + title: 'Searching specific Packages in Organization', + }, } diff --git a/src/pages/feature-guides/organization-wide-search.mdx b/src/pages/feature-guides/organization-wide-search.mdx new file mode 100644 index 0000000..c0bbb91 --- /dev/null +++ b/src/pages/feature-guides/organization-wide-search.mdx @@ -0,0 +1,32 @@ +# Searching for specific Package in Organization + +- It is now possible to search for a specific Package in each Repository in an Organization. + - Only Admin & Owner Roles can search for this Package. + - This Feature is useful, when you want to quickly check weither a certain Package is used in any Repository (e.g xz-util) and what version it is on. + - Additionally it is shown in which artifacts the Package is. + - It is found on the organization Page, in the Tabs Area, next to the Settings. + - The search feature is case insensitive. + +# How it works + +- It recursively looks for the specific Package name with a like statement, it will only find direct Dependencies. +- There is a new +- one new endpoint will be available: + - `api/v1/organizations/{organizationName}/dependency-components?search={packageName}` + - These endpoints will provide certain information: + - componentDependencyId + - dependencyPurl + - organizationId + - organizationName + - projectId + - projectName + - projectSlug + - assetId + - assetName + - assetSlug + - assetVersionName + - componentPurl + - componentVersion + - artifactName + - artifactAssetVersion + From 4d33afe06a36d54add81bca00a67df65edd9903b Mon Sep 17 00:00:00 2001 From: Lars Date: Mon, 10 Nov 2025 16:59:09 +0100 Subject: [PATCH 2/4] documention ofr organization-wide-search --- src/pages/feature-guides/organization-wide-search.mdx | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/src/pages/feature-guides/organization-wide-search.mdx b/src/pages/feature-guides/organization-wide-search.mdx index c0bbb91..fbfa502 100644 --- a/src/pages/feature-guides/organization-wide-search.mdx +++ b/src/pages/feature-guides/organization-wide-search.mdx @@ -2,15 +2,16 @@ - It is now possible to search for a specific Package in each Repository in an Organization. - Only Admin & Owner Roles can search for this Package. - - This Feature is useful, when you want to quickly check weither a certain Package is used in any Repository (e.g xz-util) and what version it is on. + - This Feature is useful, when you want to quickly check whether a certain Package is used in any Repository (e.g xz-util) and what version it is on. - Additionally it is shown in which artifacts the Package is. - - It is found on the organization Page, in the Tabs Area, next to the Settings. - - The search feature is case insensitive. + - It is found on the organization Page, in the Tabs Area, next to the Settings (you need the correct Permission to see the tab). # How it works -- It recursively looks for the specific Package name with a like statement, it will only find direct Dependencies. -- There is a new +- It recursively looks for the specific Package name with an ILIKE statement, in each Repository in your Organization, + it will only find direct Dependencies (First Party Dependencies). + - The search feature is case insensitive. + - one new endpoint will be available: - `api/v1/organizations/{organizationName}/dependency-components?search={packageName}` - These endpoints will provide certain information: From 13b8be626e147617119b20e28928b13f2745306c Mon Sep 17 00:00:00 2001 From: Lars Date: Mon, 10 Nov 2025 17:42:44 +0100 Subject: [PATCH 3/4] case insensitive part is not up to date --- src/pages/feature-guides/organization-wide-search.mdx | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/src/pages/feature-guides/organization-wide-search.mdx b/src/pages/feature-guides/organization-wide-search.mdx index fbfa502..0064745 100644 --- a/src/pages/feature-guides/organization-wide-search.mdx +++ b/src/pages/feature-guides/organization-wide-search.mdx @@ -8,9 +8,8 @@ # How it works -- It recursively looks for the specific Package name with an ILIKE statement, in each Repository in your Organization, +- It recursively looks for the specific Package name with an LIKE statement, in each Repository in your Organization, it will only find direct Dependencies (First Party Dependencies). - - The search feature is case insensitive. - one new endpoint will be available: - `api/v1/organizations/{organizationName}/dependency-components?search={packageName}` From 0c9f29a9ec48a954ddf80d95ae9ee8dcc8d4fe70 Mon Sep 17 00:00:00 2001 From: Lars Date: Wed, 19 Nov 2025 13:32:55 +0100 Subject: [PATCH 4/4] big commit --- src/pages/feature-guides/organization-wide-search.mdx | 2 +- src/pages/getting-started/index.mdx | 3 ++- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/src/pages/feature-guides/organization-wide-search.mdx b/src/pages/feature-guides/organization-wide-search.mdx index 0064745..bd85960 100644 --- a/src/pages/feature-guides/organization-wide-search.mdx +++ b/src/pages/feature-guides/organization-wide-search.mdx @@ -29,4 +29,4 @@ - componentVersion - artifactName - artifactAssetVersion - + - added information for paging diff --git a/src/pages/getting-started/index.mdx b/src/pages/getting-started/index.mdx index b0c2490..7d3ae80 100644 --- a/src/pages/getting-started/index.mdx +++ b/src/pages/getting-started/index.mdx @@ -1,7 +1,8 @@ import { Tabs } from 'nextra/components' import { Callout } from 'nextra/components' -# Getting Started with DevGuard 🚀 +### Getting Started with DevGuard 🚀 + We are currently working on the set-up flows for DevGuard - some steps might currently not work as expected.