# Installation

Install the app via **Extensions** > **My Extensions**. After installation, specify a **Sales Channel** to enable the app for. The default is All Sales Channels.

There are three aspects to the extension:

* Basic Configuration
* Admin Dashboard
* Configuring an Identity Provider

Follow the steps in the section Basic Configuration first, then refer to the section General Properties.\
After you have finished this, refer to Admin Dashboard and Configuring an Identiy provider

### Basic Configuration

Before you enable the extension, check the settings in this section and ensure they meet your requirements. Make any changes to individual fields as described below by selecting **My extensions** > **Storefront:SSO** > **Configuration**.

<figure><img src="/files/zNhyg1DrZ1wGbcVPFHcl" alt=""><figcaption></figcaption></figure>

### General Properties

The general properties provide basic controls, such as enable/ disable regular shop login or disable whole shop until customer is logged in.

| **Field**                             | **Type** | **Description**                                                                                    |
| ------------------------------------- | -------- | -------------------------------------------------------------------------------------------------- |
| Disable regular login                 | Toggle   | Enable this setting to disable the regular shop login and to force customers to use the SSO login. |
| Disable regular customer registration | Toggle   | Enable this setting when no customers should be allowed to register as a regular shop customer.    |
| Shop only available after login       | Toggle   | If this setting is enable the access to shop is denied until the customer logged in.               |
| Show login with SSO in header menu    | Toggle   | If enabled the availabe SSO services are shown in account menu overlay.                            |

### Properties for external login

The settings in this area are related to the option **Shop only available after login**.

| **Field**                                                                                                           | **Type**   | **Description**                                                             |
| ------------------------------------------------------------------------------------------------------------------- | ---------- | --------------------------------------------------------------------------- |
| External Landing Page URL                                                                                           | Text input | <p>This setting only works if you enable "Shop only available after login". |
| <br>Please note: If you use a login not in Shopware, you need to implement the login button in external system.</p> |            |                                                                             |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.premsoft.de/en/plugins/single-sign-on-sso/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.