From 076dcabfcca94a094f105429c13c0d453be216d4 Mon Sep 17 00:00:00 2001 From: Mark Kachkaev <37276742+mkachk@users.noreply.github.com> Date: Tue, 3 Jun 2025 11:15:40 -0400 Subject: [PATCH 1/8] Update content.md --- docsource/content.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docsource/content.md b/docsource/content.md index 503e0af..a776cea 100644 --- a/docsource/content.md +++ b/docsource/content.md @@ -15,7 +15,7 @@ Fields listed in `fields.json` that do not already exist in Keyfactor will be cr ## Installation and Usage 1. **Prerequisites** - * .NET 9 runtime. + * .NET 9 or newer runtime. * A valid Sectigo account with API access credentials. * A Keyfactor account with API access credentials. * The following config files filled in within the config sub-directory: From f657ba4bc0af8dbb2627ffe921800a0ddc191fb2 Mon Sep 17 00:00:00 2001 From: Keyfactor Date: Tue, 3 Jun 2025 15:17:42 +0000 Subject: [PATCH 2/8] Update generated docs --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 3064861..7d9f4c4 100644 --- a/README.md +++ b/README.md @@ -46,7 +46,7 @@ Fields listed in `fields.json` that do not already exist in Keyfactor will be cr ## Installation and Usage 1. **Prerequisites** - * .NET 9 runtime. + * .NET 9 or newer runtime. * A valid Sectigo account with API access credentials. * A Keyfactor account with API access credentials. * The following config files filled in within the config sub-directory: From 9bb8e944c64fff7055a903021b61aed33169bce5 Mon Sep 17 00:00:00 2001 From: spbsoluble <1661003+spbsoluble@users.noreply.github.com> Date: Wed, 18 Jun 2025 10:36:13 -0700 Subject: [PATCH 3/8] chore: Update integration-manifest.json to `orchestrator` --- integration-manifest.json | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/integration-manifest.json b/integration-manifest.json index cd5a532..6cc1f20 100644 --- a/integration-manifest.json +++ b/integration-manifest.json @@ -1,13 +1,20 @@ { "$schema": "https://keyfactor.github.io/integration-manifest-schema.json", - "integration_type": "api-client", + "integration_type": "orchestrator", "name": "Sectigo Metadata Sync", - "status": "pilot", + "status": "production", "description": "Sectigo Metadata Sync Application", - "link_github": true, - "update_catalog": true, + "link_github": false, + "update_catalog": false, "support_level": "kf-community", "release_project": "sectigo-metadata-sync/SectigoMetadataSync.csproj", "release_dir": "sectigo-metadata-sync/bin/Release", - "about": {} + "about": { + "orchestrator": { + "keyfactor_platform_version": "N/A", + "UOFramework": "N/A", + "pam_support": false, + "store_types": [] + } + } } \ No newline at end of file From a0b5e1382a75dfc591c8c76c256914d473711403 Mon Sep 17 00:00:00 2001 From: Keyfactor Date: Wed, 18 Jun 2025 17:43:53 +0000 Subject: [PATCH 4/8] Update generated docs --- README.md | 89 +++++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 77 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index 7d9f4c4..ebfd54e 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,10 @@

- Sectigo Metadata Sync + Sectigo Metadata Sync Universal Orchestrator Extension

-Integration Status: pilot +Integration Status: production Release Issues GitHub Downloads (all assets, all releases) @@ -14,23 +14,21 @@ Support - + + · + + Installation + · License · - + Related Integrations

-## Support -The Sectigo Metadata Sync is open source and there is **no SLA**. Keyfactor will address issues as resources become available. Keyfactor customers may request escalation by opening up a support ticket through their Keyfactor representative. - -> To report a problem or suggest a new feature, use the **[Issues](../../issues)** tab. If you want to contribute actual bug fixes or proposed enhancements, use the **[Pull requests](../../pulls)** tab. - - ## Overview This tool automates the synchronization of metadata fields between Sectigo and Keyfactor. It performs two primary operations: @@ -43,6 +41,74 @@ Fields listed in `fields.json` that do not already exist in Keyfactor will be cr --- + + +## Compatibility + +This integration is compatible with Keyfactor Universal Orchestrator version N/A and later. + +## Support +The Sectigo Metadata Sync Universal Orchestrator extension If you have a support issue, please open a support ticket by either contacting your Keyfactor representative or via the Keyfactor Support Portal at https://support.keyfactor.com. + +> To report a problem or suggest a new feature, use the **[Issues](../../issues)** tab. If you want to contribute actual bug fixes or proposed enhancements, use the **[Pull requests](../../pulls)** tab. + +## Requirements & Prerequisites + +Before installing the Sectigo Metadata Sync Universal Orchestrator extension, we recommend that you install [kfutil](https://github.com/Keyfactor/kfutil). Kfutil is a command-line tool that simplifies the process of creating store types, installing extensions, and instantiating certificate stores in Keyfactor Command. + + + +## Certificate Store Type + +To use the Sectigo Metadata Sync Universal Orchestrator extension, you **must** create the Certificate Store Type. This only needs to happen _once_ per Keyfactor Command instance. + + + +## Installation + +1. **Download the latest Sectigo Metadata Sync Universal Orchestrator extension from GitHub.** + + Navigate to the [Sectigo Metadata Sync Universal Orchestrator extension GitHub version page](https://github.com/Keyfactor/sectigo-metadata-sync/releases/latest). Refer to the compatibility matrix below to determine whether the `net6.0` or `net8.0` asset should be downloaded. Then, click the corresponding asset to download the zip archive. + + | Universal Orchestrator Version | Latest .NET version installed on the Universal Orchestrator server | `rollForward` condition in `Orchestrator.runtimeconfig.json` | `sectigo-metadata-sync` .NET version to download | + | --------- | ----------- | ----------- | ----------- | + | Older than `11.0.0` | | | `net6.0` | + | Between `11.0.0` and `11.5.1` (inclusive) | `net6.0` | | `net6.0` | + | Between `11.0.0` and `11.5.1` (inclusive) | `net8.0` | `Disable` | `net6.0` | + | Between `11.0.0` and `11.5.1` (inclusive) | `net8.0` | `LatestMajor` | `net8.0` | + | `11.6` _and_ newer | `net8.0` | | `net8.0` | + + Unzip the archive containing extension assemblies to a known location. + + > **Note** If you don't see an asset with a corresponding .NET version, you should always assume that it was compiled for `net6.0`. + +2. **Locate the Universal Orchestrator extensions directory.** + + * **Default on Windows** - `C:\Program Files\Keyfactor\Keyfactor Orchestrator\extensions` + * **Default on Linux** - `/opt/keyfactor/orchestrator/extensions` + +3. **Create a new directory for the Sectigo Metadata Sync Universal Orchestrator extension inside the extensions directory.** + + Create a new directory called `sectigo-metadata-sync`. + > The directory name does not need to match any names used elsewhere; it just has to be unique within the extensions directory. + +4. **Copy the contents of the downloaded and unzipped assemblies from __step 2__ to the `sectigo-metadata-sync` directory.** + +5. **Restart the Universal Orchestrator service.** + + Refer to [Starting/Restarting the Universal Orchestrator service](https://software.keyfactor.com/Core-OnPrem/Current/Content/InstallingAgents/NetCoreOrchestrator/StarttheService.htm). + + + +> The above installation steps can be supplemented by the [official Command documentation](https://software.keyfactor.com/Core-OnPrem/Current/Content/InstallingAgents/NetCoreOrchestrator/CustomExtensions.htm?Highlight=extensions). + + + +## Defining Certificate Stores + + + + ## Installation and Usage 1. **Prerequisites** @@ -382,11 +448,10 @@ Always restart the tool after modifying `NLog.config` to ensure changes take eff --- - ## License Apache License 2.0, see [LICENSE](LICENSE). ## Related Integrations -See all [Keyfactor integrations](https://github.com/topics/keyfactor-integration). \ No newline at end of file +See all [Keyfactor Universal Orchestrator extensions](https://github.com/orgs/Keyfactor/repositories?q=orchestrator). \ No newline at end of file From 911ec8e03a70ca387e32e68342dcbd5b7938a285 Mon Sep 17 00:00:00 2001 From: Macey <11599974+doebrowsk@users.noreply.github.com> Date: Mon, 23 Jun 2025 20:27:02 +0000 Subject: [PATCH 5/8] chore(build): declare as api-client, use dev-3.3 starter-workflow --- .github/workflows/keyfactor-starter-workflow.yml | 2 +- integration-manifest.json | 14 +++----------- 2 files changed, 4 insertions(+), 12 deletions(-) diff --git a/.github/workflows/keyfactor-starter-workflow.yml b/.github/workflows/keyfactor-starter-workflow.yml index 042ba5a..2146165 100644 --- a/.github/workflows/keyfactor-starter-workflow.yml +++ b/.github/workflows/keyfactor-starter-workflow.yml @@ -11,7 +11,7 @@ on: jobs: call-starter-workflow: - uses: keyfactor/actions/.github/workflows/starter.yml@v3.1.2 + uses: keyfactor/actions/.github/workflows/starter.yml@dev-3.3 secrets: token: ${{ secrets.V2BUILDTOKEN}} APPROVE_README_PUSH: ${{ secrets.APPROVE_README_PUSH}} diff --git a/integration-manifest.json b/integration-manifest.json index 6cc1f20..88f52f9 100644 --- a/integration-manifest.json +++ b/integration-manifest.json @@ -1,6 +1,6 @@ { - "$schema": "https://keyfactor.github.io/integration-manifest-schema.json", - "integration_type": "orchestrator", + "$schema": "https://keyfactor.github.io/v2/integration-manifest-schema.json", + "integration_type": "api-client", "name": "Sectigo Metadata Sync", "status": "production", "description": "Sectigo Metadata Sync Application", @@ -8,13 +8,5 @@ "update_catalog": false, "support_level": "kf-community", "release_project": "sectigo-metadata-sync/SectigoMetadataSync.csproj", - "release_dir": "sectigo-metadata-sync/bin/Release", - "about": { - "orchestrator": { - "keyfactor_platform_version": "N/A", - "UOFramework": "N/A", - "pam_support": false, - "store_types": [] - } - } + "release_dir": "sectigo-metadata-sync/bin/Release" } \ No newline at end of file From 76f20dfd9010736f9cdc00d0d5bb92f93cd9c6c7 Mon Sep 17 00:00:00 2001 From: Keyfactor Date: Mon, 23 Jun 2025 20:29:37 +0000 Subject: [PATCH 6/8] Update generated docs --- README.md | 87 +++++++------------------------------------------------ 1 file changed, 11 insertions(+), 76 deletions(-) diff --git a/README.md b/README.md index ebfd54e..eeb2b98 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@

- Sectigo Metadata Sync Universal Orchestrator Extension + Sectigo Metadata Sync

@@ -14,21 +14,23 @@ Support - - · - - Installation - + · License · - + Related Integrations

+## Support +The Sectigo Metadata Sync is open source and there is **no SLA**. Keyfactor will address issues as resources become available. Keyfactor customers may request escalation by opening up a support ticket through their Keyfactor representative. + +> To report a problem or suggest a new feature, use the **[Issues](../../issues)** tab. If you want to contribute actual bug fixes or proposed enhancements, use the **[Pull requests](../../pulls)** tab. + + ## Overview This tool automates the synchronization of metadata fields between Sectigo and Keyfactor. It performs two primary operations: @@ -41,74 +43,6 @@ Fields listed in `fields.json` that do not already exist in Keyfactor will be cr --- - - -## Compatibility - -This integration is compatible with Keyfactor Universal Orchestrator version N/A and later. - -## Support -The Sectigo Metadata Sync Universal Orchestrator extension If you have a support issue, please open a support ticket by either contacting your Keyfactor representative or via the Keyfactor Support Portal at https://support.keyfactor.com. - -> To report a problem or suggest a new feature, use the **[Issues](../../issues)** tab. If you want to contribute actual bug fixes or proposed enhancements, use the **[Pull requests](../../pulls)** tab. - -## Requirements & Prerequisites - -Before installing the Sectigo Metadata Sync Universal Orchestrator extension, we recommend that you install [kfutil](https://github.com/Keyfactor/kfutil). Kfutil is a command-line tool that simplifies the process of creating store types, installing extensions, and instantiating certificate stores in Keyfactor Command. - - - -## Certificate Store Type - -To use the Sectigo Metadata Sync Universal Orchestrator extension, you **must** create the Certificate Store Type. This only needs to happen _once_ per Keyfactor Command instance. - - - -## Installation - -1. **Download the latest Sectigo Metadata Sync Universal Orchestrator extension from GitHub.** - - Navigate to the [Sectigo Metadata Sync Universal Orchestrator extension GitHub version page](https://github.com/Keyfactor/sectigo-metadata-sync/releases/latest). Refer to the compatibility matrix below to determine whether the `net6.0` or `net8.0` asset should be downloaded. Then, click the corresponding asset to download the zip archive. - - | Universal Orchestrator Version | Latest .NET version installed on the Universal Orchestrator server | `rollForward` condition in `Orchestrator.runtimeconfig.json` | `sectigo-metadata-sync` .NET version to download | - | --------- | ----------- | ----------- | ----------- | - | Older than `11.0.0` | | | `net6.0` | - | Between `11.0.0` and `11.5.1` (inclusive) | `net6.0` | | `net6.0` | - | Between `11.0.0` and `11.5.1` (inclusive) | `net8.0` | `Disable` | `net6.0` | - | Between `11.0.0` and `11.5.1` (inclusive) | `net8.0` | `LatestMajor` | `net8.0` | - | `11.6` _and_ newer | `net8.0` | | `net8.0` | - - Unzip the archive containing extension assemblies to a known location. - - > **Note** If you don't see an asset with a corresponding .NET version, you should always assume that it was compiled for `net6.0`. - -2. **Locate the Universal Orchestrator extensions directory.** - - * **Default on Windows** - `C:\Program Files\Keyfactor\Keyfactor Orchestrator\extensions` - * **Default on Linux** - `/opt/keyfactor/orchestrator/extensions` - -3. **Create a new directory for the Sectigo Metadata Sync Universal Orchestrator extension inside the extensions directory.** - - Create a new directory called `sectigo-metadata-sync`. - > The directory name does not need to match any names used elsewhere; it just has to be unique within the extensions directory. - -4. **Copy the contents of the downloaded and unzipped assemblies from __step 2__ to the `sectigo-metadata-sync` directory.** - -5. **Restart the Universal Orchestrator service.** - - Refer to [Starting/Restarting the Universal Orchestrator service](https://software.keyfactor.com/Core-OnPrem/Current/Content/InstallingAgents/NetCoreOrchestrator/StarttheService.htm). - - - -> The above installation steps can be supplemented by the [official Command documentation](https://software.keyfactor.com/Core-OnPrem/Current/Content/InstallingAgents/NetCoreOrchestrator/CustomExtensions.htm?Highlight=extensions). - - - -## Defining Certificate Stores - - - - ## Installation and Usage 1. **Prerequisites** @@ -448,10 +382,11 @@ Always restart the tool after modifying `NLog.config` to ensure changes take eff --- + ## License Apache License 2.0, see [LICENSE](LICENSE). ## Related Integrations -See all [Keyfactor Universal Orchestrator extensions](https://github.com/orgs/Keyfactor/repositories?q=orchestrator). \ No newline at end of file +See all [Keyfactor integrations](https://github.com/topics/keyfactor-integration). \ No newline at end of file From 2b0bc091f9c55bc946fc076d73817e6fbd7a3e9f Mon Sep 17 00:00:00 2001 From: Macey <11599974+doebrowsk@users.noreply.github.com> Date: Mon, 23 Jun 2025 21:26:11 +0000 Subject: [PATCH 7/8] chore(build): use tagged v3 starter.yml --- .github/workflows/keyfactor-starter-workflow.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/keyfactor-starter-workflow.yml b/.github/workflows/keyfactor-starter-workflow.yml index 2146165..64919a4 100644 --- a/.github/workflows/keyfactor-starter-workflow.yml +++ b/.github/workflows/keyfactor-starter-workflow.yml @@ -11,7 +11,7 @@ on: jobs: call-starter-workflow: - uses: keyfactor/actions/.github/workflows/starter.yml@dev-3.3 + uses: keyfactor/actions/.github/workflows/starter.yml@v3 secrets: token: ${{ secrets.V2BUILDTOKEN}} APPROVE_README_PUSH: ${{ secrets.APPROVE_README_PUSH}} From 94216aa53b2428cec4e6e32b19baf034ddbd732c Mon Sep 17 00:00:00 2001 From: Macey <11599974+doebrowsk@users.noreply.github.com> Date: Mon, 23 Jun 2025 16:38:36 -0500 Subject: [PATCH 8/8] chore(build): touch file to trigger rebuild --- .github/workflows/keyfactor-starter-workflow.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/keyfactor-starter-workflow.yml b/.github/workflows/keyfactor-starter-workflow.yml index 64919a4..07fe0be 100644 --- a/.github/workflows/keyfactor-starter-workflow.yml +++ b/.github/workflows/keyfactor-starter-workflow.yml @@ -11,7 +11,7 @@ on: jobs: call-starter-workflow: - uses: keyfactor/actions/.github/workflows/starter.yml@v3 + uses: keyfactor/actions/.github/workflows/starter.yml@v3 secrets: token: ${{ secrets.V2BUILDTOKEN}} APPROVE_README_PUSH: ${{ secrets.APPROVE_README_PUSH}}