HeptacomShopwarePlatformAdminOpenAuth

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

HeptacomShopwarePlatformAdminOpenAuth

(★ 37)

Shopware plugin to allow open auth logins in the administration

HeptacomShopwarePlatformAdminOpenAuth Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SSO login for shopware platform administration
## This is part of HEPTACOM solutions for medium and large enterprise
### Shopware plugin to allow external login provider in the administration

![Packagist Version](https://img.shields.io/packagist/v/heptacom/shopware-platform-admin-open-auth?style=flat-square)
![PHP from Packagist](https://img.shields.io/packagist/php-v/heptacom/shopware-platform-admin-open-auth?style=flat-square)
[![Software License](https://img.shields.io/packagist/l/heptacom/shopware-platform-admin-open-auth?style=flat-square)](https://raw.githubusercontent.com/HEPTACOM/HeptacomShopwarePlatformAdminOpenAuth/main/LICENSE.md)
![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/heptacom/HeptacomShopwarePlatformAdminOpenAuth?style=flat-square)
[![GitHub issues](https://img.shields.io/github/issues/HEPTACOM/HeptacomShopwarePlatformAdminOpenAuth?style=flat-square)](https://github.com/HEPTACOM/HeptacomShopwarePlatformAdminOpenAuth/issues)
[![GitHub forks](https://img.shields.io/github/forks/HEPTACOM/HeptacomShopwarePlatformAdminOpenAuth?style=flat-square)](https://github.com/HEPTACOM/HeptacomShopwarePlatformAdminOpenAuth/network)
[![GitHub stars](https://img.shields.io/github/stars/HEPTACOM/HeptacomShopwarePlatformAdminOpenAuth?style=flat-square)](https://github.com/HEPTACOM/HeptacomShopwarePlatformAdminOpenAuth/stargazers)
![GitHub watchers](https://img.shields.io/github/watchers/heptacom/HeptacomShopwarePlatformAdminOpenAuth?style=flat-square)
![Packagist](https://img.shields.io/packagist/dt/heptacom/shopware-platform-admin-open-auth?style=flat-square)

![GitHub contributors](https://img.shields.io/github/contributors/heptacom/HeptacomShopwarePlatformAdminOpenAuth?style=flat-square)
![GitHub commit activity](https://img.shields.io/github/commit-activity/y/heptacom/HeptacomShopwarePlatformAdminOpenAuth?style=flat-square)

This Shopware 6 plugin allows to add "Login with" functionality into the Shopware administration login page and password confirmation dialogs.

## Features

* login to Shopware 6 administration using an external identity provider (IDP)
* various providers already preconfigured - Microsoft, Google, Okta, Keycloak, ...
* support for third-party IDPs supporting OpenID Connect
  * easy setup using the provider's metadata document (`.well-known/openid-configuration`)
* support for third-party IDPs supporting SAML2
  * easy setup using the provider's metadata xml
* promote users automatically to administrators
* set roles and permissions based on rules
* disable the password login and automatically redirect users to the identity provider
* use pre-authorized HTTP clients for further API requests

## Security

The login to the Shopware administration is a critical part.
Security vulnerabilities in this part allow attackers access to the whole shop.

Therefore, we check our plugin critically for potential risks before merging pull requests.

In addition, our OpenId Connect implementation also checks the signature of JWT tokens, whenever possible.
When using a pre-configured OpenID Connect provider or when providing a OIDC metadata document,
the JWKS keys are automatically fetched from the IDP.

## Supported providers

We support a variety of identity providers out of the box.
If your identity provider is not listed below but offers OpenID Connect support, you can configure it manually using the OpenID Connect provider.
In any other case feel free to create a pull request.

| Provider | supports language sync | supports timezone sync | supports role assignment by roles/groups | more info |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------|:------------------------:|:------------------------:|:----------------------------------------:|--------------------------------------------------------------------------------------------------------------------------------|
| Atlassian Jira <img alt="Atlassian Jira" height="25" src="./src/Resources/app/administration/static/logo/jira_logo.svg"/> | ❌ | ✅ | ❌ | Read more [here](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#enabling-oauth-2-0--3lo-). |
| cidaas <img alt="cidaas" height="25" src="./src/Resources/app/administration/static/logo/cidaas_logo.svg"/> | ❌ | ❌ | ⚠️ | Read more [here](https://docs.cidaas.com/create-application/createapplication.html). |
| Google Cloud <img alt="Google Cloud" height="25" style="margin: 25px 0;" src="./src/Resources/app/administration/static/logo/google_logo.svg"/> | ✅ | ❌ | ⚠️ | Read more [here](https://developers.google.com/identity/protocols/oauth2/openid-connect). |
| JumpCloud | depends on configuration | depends on configuration | ✅ | Read more [here](https://support.jumpcloud.com/support/s/article/single-sign-on-sso-with-saml-20-connector1). |
| [Keycloack](https://www.keycloak.org/) <img alt="Keycloak" height="25" src="./src/Resources/app/administration/static/logo/keycloak_logo.svg"/> | ✅ | depends on configuration | ⚠️ | Read more [here](https://blogs.sap.com/2021/08/23/keyclock-as-an-openid-connect-oidc-provider./). |
| Microsoft Entra ID <img alt="Microsoft Logo" height="25" style="margin: 12px 0;" src="./src/Resources/app/administration/static/logo/microsoft_logo.svg"/> | ❌ | ❌ | ✅ | Read more [here](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app). |
| Okta <img alt="Okta" height="25" src="./src/Resources/app/administration/static/logo/okta_logo.png"/> | ✅ | ✅ | ⚠️ | Read more [here](https://help.okta.com/en-us/Content/Topics/Apps/Apps_App_Integration_Wizard_OIDC.htm). |
| OneLogin <img alt="OneLogin" height="25" src="./src/Resources/app/administration/static/logo/onelogin_logo.svg"/> | ✅ | ❌ | ⚠️ | Read more [here](https://developers.onelogin.com/blog/how-to-use-openid-connect-authentication-with-dotnet-core#heading-menu). |
| OpenID Connect <img alt="OpenID Connect" height="25" src="./src/Resources/app/administration/static/logo/openid_logo.svg"/> | depends on configuration | depends on configuration | ⚠️ | Try any OpenID Connect provider, that we did not explicitly prepare an optimized configuration for. |
| SAML2 <img alt="SAML2" height="25" src="./src/Resources/public/static/logo/saml2_logo.svg"/> | depends on configuration | depends on configuration | ✅ | Try any SAML2 provider, that we did not explicitly prepare an optimized configuration for. |

⚠️ supported using [authorized request rule](#openid-connect---authenticated-request-rule)

### SAML2 - Technical requirements

In case you want to use a SAML2 provider, your IdP must meet the following requirements:
- include AuthnRequest in the SAML response
- sign the returned assertions
- support HTTP-POST binding for the Assertion Consumer Service (ACS)
- return the user's email address as attribute (all other attributes are optional)

### OpenID Connect - Authenticated request rule

When using an OpenID Connect based provider, you can assign roles that depend on an authenticated GET request, done with the user's access token.
This way you can get any further information from the IDP, that is relevant for your specific case.
For some providers a preset for retrieving the user's groups is already available.

In case you want to create more complex rules, you can build your own queries within the rule builder.
The queries get the JSON, returned by the specified endpoint, as input.

#### Authenticated request

Your specified endpoint will be called as follows:
```http request
GET https://my-company.idp.com/api/groups
Authorization: Bearer <access_token>
Accept: application/json
```

The request must be encrypted (HTTPS) and will timeout after 5 seconds. In case of a timeout or a none successful response code, the condition will be evaluated as `false`.
You can change these settings by defining your own HTTP client (see [Using a different HTTP client](#use-a-different-http-client)).

In case you have multiple conditions, depending on the same endpoint, the request will only be done once.
The response is cached in memory for the duration of the rule evaluation.

#### Processing the response

You can then use a [JMESPath](https://jmespath.org/) query to validate if the input JSON matches your rule.

It is recommended that your query results in a boolean.
In case it results in a different type, the condition will be validated as follows:

| Output type | Output value    | Validation result |
|-------------|-----------------|-------------------|
| `boolean`   | `true`          | `true` |
| `boolean`   | `false`         | `false` |
| `string`    | empty           | `false` |
| `string`    | non-empty       | `true` |
| `number`    | `0`             | `false` |
| `number`    | `1` (or grater) | `true` |
| `array`     | empty           | `false` |
| `array`     | non-empty       | `true` |
| `object`    | empty           | `false` |
| `object`    | non-empty       | `true` |
| `null`      | `null`          | `false` |

#### Pagination

In case of larger responses, you might need to paginate through the results.
When using an OData compatible endpoint, you can use the "Authenticated OData request" instead.
If the validation result on the current result page is `false`, the next page will be automatically requested.

### OpenID Connect - ID Token rule

Most OpenID Connect based providers issue an identity token while authentication.
Depending on your use-case, this token might contain data that is relevant for the permission assignment.

You can use the ID Token for rules by running a JMESPath query on the payload.
For details on the JMESPath query evaluation, see the [authenticated request rule documentation](#processing-the-response).

## Adding your own rule actions

In most scenarios you only need to assign roles based on rules.
However, for some use cases you might want to add your own actions.
As a plugin developer you can simply add your own rule actions.
The rules will evaluate while the login process synchronously and the appropriate action will be executed.

### Adding a new rule action

To add a new rule action, you need to create a service that implements `RuleActionInterface`.
The service must be tagged with `heptacom_open_auth.rule_action`.

Thereafter, your action should already be visible in the client configuration.

#### Service

```php
<?php

namespace Heptacom\MyCustomPlugin\HeptacomOpenAuth;

use Heptacom\AdminOpenAuth\Contract\OAuthRuleScope;
use Heptacom\AdminOpenAuth\Contract\RuleActionInterface;
use Heptacom\AdminOpenAuth\Database\ClientRuleEntity;

class CustomRuleAction implements RuleActionInterface
{
    public static function getName(): string
    {
        return 'heptacom_my_custom_action';
    }
    
    public function getActionConfigurationComponent(): string
    {
        return 'heptacom-my-custom-action-config';
    }
    
    public function preResolveUser(ClientRuleEntity $rule, OAuthRuleScope $ruleScope): void {
        // your business logic here
    }
    
    public function postResolveUser(ClientRuleEntity $rule, OAuthRuleScope $ruleScope): void {
        // your business logic here
    }
}
```

#### Administration Snippet

```json
{
    "heptacom-admin-open-auth-client": {
        "actions": {
            "heptacom_my_custom_action": {
                "label": "My custom action"
            }
        }
    }
}
```

### Adding a configurable action to the administration

Now we can already see our action in the client configuration.
Although we can already add rules, we are not able to configure what action should be executed if a rule matches.
To do so, we need to add a new component to the administration.

The component receives the client and the current configuration as props.

In the following example we will simply set a configurable text.

```js
import template from './heptacom-my-custom-action-config.html.twig';

export default {
    template,

props: {
        client: {
            type: Object,
            required: true,
        },
        actionConfig: {
            type: Object,
            required: true,
        },
    }
}
```

```twig
<sw-text-field
 v-model:value="actionConfig.myText"
 label="Enter a text"
 required
></sw-text-field>
```

### Adding the business logic for an action

Now, that your action is configurable, you need to define what should happen if the rule matches.
To do so, you need to implement the `execute` method of your action.

For this example we will only log the configured text.

```php
<?php

namespace Heptacom\MyCustomPlugin\HeptacomOpenAuth;

use Heptacom\AdminOpenAuth\Contract\RuleActionInterface;
use Heptacom\AdminOpenAuth\Contract\OAuthRuleScope;
use Heptacom\AdminOpenAuth\Database\ClientRuleEntity;
use Psr\Log\LoggerInterface;

class CustomRuleAction implements RuleActionInterface
{
    public function __construct(
        private readonly LoggerInterface $logger
    ) {
    }
    
    // ...
    
    public function preResolveUser(ClientRuleEntity $rule, OAuthRuleScope $ruleScope): void {
        $this->logger->info(sprintf(
            'My custom action (preResolveUser) was executed with text: %s',
            $rule->getActionConfig()['myText']
        ));
    }
    
    public function postResolveUser(ClientRuleEntity $rule, OAuthRuleScope $ruleScope): void {
        $this->logger->info(sprintf(
            'My custom action (postResolveUser) was executed with text: %s',
            $rule->getActionConfig()['myText']
        ));
    }
}
```

## Using the pre-authorized HTTP client

In some scenarios, you might want to use the credentials provided by your client for further API requests.

The plugin provides a factory to create a PSR-18 compatible HTTP client, handling the authorization for you.

Depending on your needs, you can either use the user's access token or the client credentials.

### Using the client credentials

In case you use a client implementing the [`StandaloneClientContract`](src/Contract/Client/StandaloneClientContract.php) you'll be able to make requests using the client credentials you already configured.

```php
<?php

use Heptacom\AdminOpenAuth\Service\HttpClient\AuthorizedHttpClientFactory;
use Psr\Http\Client\ClientInterface;
use Shopware\Core\Framework\Context;
use Shopware\Core\System\SystemConfig\SystemConfigService;

class MyService {
    public function __construct(
        private readonly AuthorizedHttpClientFactory $httpClientFactory,
        private readonly SystemConfigService $systemConfigService,
    ) {
    }

// ...

private function getHttpClient(): ClientInterface
    {
        // Get the ID of the SSO client you want to use.
        // For now, we assume you stored it in the plugin configuration.
        $clientId = $this->systemConfigService->getString('MyPlugin.config.clientId');
        
        // Create a pre-authorized HTTP client.
        return $this->httpClientFactory->forClient(
            $clientId,
            Context::createFromDefaults(),
            ['my_scope']
        );
    }
}
```

### Using the user's access token

In case you are using a client implementing the [`RequestAuthorizationContract`](src/Contract/Client/RequestAuthorizationContract.php) you can also use the user's access token.

Please keep in mind that the client must be configured to allow storing the user's token.

```php
<?php

// ...

private function getHttpClient(string $userId): ClientInterface
    {
        // Get the ID of the SSO client you want to use.
        // For now, we assume you stored it in the plugin configuration.
        $clientId = $this->systemConfigService->getString('MyPlugin.config.clientId');
        
        // Create a pre-authorized HTTP client.
        return $this->httpClientFactory->forUser(
            $clientId,
            $userId,
            Context::createFromDefaults(),
        );
    }
}
```

### Use a different HTTP client

The authorized HTTP client uses a PSR-18 compatible client like Guzzle under the hood.

By default, HTTPS usage and certificate validation is enforced.

In case you want to use different settings, you can decorate the `heptacom.admin_open_auth.base_http_client` service to provide your own client.

Please note that some settings of your HTTP client (like adding default headers) could lead to unwanted side effects, as the authorized HTTP client is used by this plugin as well.

## Storefront login

You want to use this plugin to allow your customers to login using SSO?

We are happy to provide you an extension to this plugin, allowing you exactly that.
It is based on this plugin, providing you the same extensibility and features as this plugin.

For more information, please have a look at our website: [www.heptacom.de/en/products](https://www.heptacom.de/en/products/).

## Changes

View the [CHANGELOG](./CHANGELOG.md) file attached to this project.

## Contributing

Thank you for considering contributing to this package! Be sure to sign the [CLA](CLA.md) after creating the pull request. [![CLA assistant](https://cla-assistant.io/readme/badge/HEPTACOM/HeptacomShopwarePlatformAdminOpenAuth)](https://cla-assistant.io/HEPTACOM/HeptacomShopwarePlatformAdminOpenAuth)

## License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this project except in compliance with the License.
You may obtain a copy of the License at [http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0) or see the [local copy](./LICENSE.md).

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and limitations under the License.

## Trademarks and Logos

All logos, available in this project are protected under copyright.
Most of them also are registered trademarks.
Therefore, the usage is only permitted when corresponding trademark/branding guidelines are fulfilled.
You can find an archived link to these guidelines below.

### Atlassian Jira

* [https://atlassian.design/foundations/logos](https://web.archive.org/web/20220826095450/https://atlassian.design/foundations/logos/)
* [https://atlassian.design/license](https://web.archive.org/web/20220826095427/https://atlassian.design/license/)

### cidaas

* [https://www.cidaas.com/branding/](https://web.archive.org/web/20220826173916/https://www.cidaas.com/branding/)

### Google

* [https://developers.google.com/identity/branding-guidelines](https://web.archive.org/web/20220826095610/https://developers.google.com/identity/branding-guidelines)
* [https://about.google/brand-resource-center/brand-elements/](https://web.archive.org/web/20220407015455/https://about.google/brand-resource-center/brand-elements/)
* [https://about.google/brand-resource-center/rules/](https://web.archive.org/web/20220318020455/https://about.google/brand-resource-center/rules/)
* [https://about.google/brand-resource-center/brand-terms/](https://web.archive.org/web/20220403110312/https://about.google/brand-resource-center/brand-terms/)

### Keycloak

* [https://design.jboss.org/keycloak/index.htm](https://design.jboss.org/keycloak/index.htm)
* [https://www.jboss.org/trademarks.html](https://web.archive.org/web/20220826095334/https://www.jboss.org/trademarks.html)

### Microsoft Entra ID

* [https://learn.microsoft.com/de-de/entra/identity-platform/howto-add-branding-in-apps](https://web.archive.org/web/20240510091605/https://learn.microsoft.com/de-de/entra/identity-platform/howto-add-branding-in-apps)

### Okta

* [https://www.okta.com/terms-of-use-for-okta-content/](https://web.archive.org/web/20220826163845/https://www.okta.com/terms-of-use-for-okta-content/)

### OneLogin

The One Identity logo is a registered trademark of One Identity, Inc.

* [https://www.oneidentity.com/docs/one-identity-trademark-usage-guidelines-legal-142035.pdf](https://web.archive.org/web/20220826194021/https://www.oneidentity.com/docs/one-identity-trademark-usage-guidelines-legal-142035.pdf)

### OpenID Connect

* [https://openid.net/ipr/openid-logo-guidelines.pdf](https://web.archive.org/web/20220826095703/https://openid.net/ipr/openid-logo-guidelines.pdf)
* [https://openid.net/wordpress-content/uploads/2017/06/OIDF-Policy-Trademark-Usage-Policy-Final-6-19-2017.pdf](https://web.archive.org/web/20220826100058/https://openid.net/wordpress-content/uploads/2017/06/OIDF-Policy-Trademark-Usage-Policy-Final-6-19-2017.pdf)

HeptacomShopwarePlatformAdminOpenAuth

HeptacomShopwarePlatformAdminOpenAuth Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

HeptacomShopwarePlatformAdminOpenAuth

HeptacomShopwarePlatformAdminOpenAuth Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README