From 88bcf9c9f90a3ac5e4f0ebb3d0ecb95d7dfa2301 Mon Sep 17 00:00:00 2001 From: Renaud Hager Date: Fri, 27 Mar 2026 17:17:10 +0000 Subject: [PATCH 1/3] feat: add documentation for Plugin Store Authentication --- .../plugins-store-authentication.md | 50 +++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 products/paas/shopware/fundamentals/plugins-store-authentication.md diff --git a/products/paas/shopware/fundamentals/plugins-store-authentication.md b/products/paas/shopware/fundamentals/plugins-store-authentication.md new file mode 100644 index 0000000000..2a677dce5c --- /dev/null +++ b/products/paas/shopware/fundamentals/plugins-store-authentication.md @@ -0,0 +1,50 @@ + +--- +nav: + title: Plugin Store Authentication + position: 100 +--- + +# Plugin Store Authentication +The build process might needs to authentication against plugins stores (Shopware official and any other one), this document explain how configure this authentication. + +We rely on `composer` to fecth plugin during build time configured with two environment variables: `SHOPWARE_PACKAGES_TOKEN` and `COMPOSER_AUTH`. + +## Shopware plugin store +Under normal circumstances, during the provisioning of your organisation we automatically create the secret `SHOPWARE_PACKAGES_TOKEN`. +This secret contains the token to authenticate against the official Shopware plugin store. + +If this secret is not present you can recreate it: +``` +sw-paas vault create --type buildenv --key SHOPWARE_PACKAGES_TOKEN +``` +Then just put the token provided by Shopware. + +## Third party plugin store +To authenticate against third party plugin store or plugin repository you need to create a secret named `COMPOSER_AUTH`. +The content need to be the json string required for the store/repository, run the following command: +``` +sw-paas vault create --type buildenv --key COMPOSER_AUTH +``` + +The content of the secret needs to be a json string compatible with composer, for instance: +- basic auth string: +```json +{ + "http-basic": { + "git.mycompany.com": { + "password": "mypassword", + "username": "myuser" + } + } +} +``` + +- a bearer token: +```json +{ + "bearer": { + "git.mycompany.com": "mytoken" + } +} +``` \ No newline at end of file From 6d553b642dddb5f35e4ccac3cbee5a5edceb5936 Mon Sep 17 00:00:00 2001 From: Renaud Hager Date: Mon, 30 Mar 2026 12:38:43 +0100 Subject: [PATCH 2/3] Update products/paas/shopware/fundamentals/plugins-store-authentication.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .../paas/shopware/fundamentals/plugins-store-authentication.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/products/paas/shopware/fundamentals/plugins-store-authentication.md b/products/paas/shopware/fundamentals/plugins-store-authentication.md index 2a677dce5c..71f3e93edd 100644 --- a/products/paas/shopware/fundamentals/plugins-store-authentication.md +++ b/products/paas/shopware/fundamentals/plugins-store-authentication.md @@ -11,7 +11,7 @@ The build process might needs to authentication against plugins stores (Shopware We rely on `composer` to fecth plugin during build time configured with two environment variables: `SHOPWARE_PACKAGES_TOKEN` and `COMPOSER_AUTH`. ## Shopware plugin store -Under normal circumstances, during the provisioning of your organisation we automatically create the secret `SHOPWARE_PACKAGES_TOKEN`. +Under normal circumstances, during the provisioning of your organization we automatically create the secret `SHOPWARE_PACKAGES_TOKEN`. This secret contains the token to authenticate against the official Shopware plugin store. If this secret is not present you can recreate it: From 702d634c4e924f6d201dd6388ec31825ac8452c6 Mon Sep 17 00:00:00 2001 From: Renaud Hager Date: Mon, 30 Mar 2026 12:39:11 +0100 Subject: [PATCH 3/3] Update products/paas/shopware/fundamentals/plugins-store-authentication.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .../paas/shopware/fundamentals/plugins-store-authentication.md | 1 - 1 file changed, 1 deletion(-) diff --git a/products/paas/shopware/fundamentals/plugins-store-authentication.md b/products/paas/shopware/fundamentals/plugins-store-authentication.md index 71f3e93edd..85a26d7ca8 100644 --- a/products/paas/shopware/fundamentals/plugins-store-authentication.md +++ b/products/paas/shopware/fundamentals/plugins-store-authentication.md @@ -1,4 +1,3 @@ - --- nav: title: Plugin Store Authentication