> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/shopware/konfiguration/authentifizierungsmethoden-im-detail.md).

# Authentifizierungsmethoden im Detail

Der Connector authentifiziert sich über **OAuth** an der Shopware-Admin-API und erhält ein **Bearer-Token**, das für alle weiteren Aufrufe verwendet wird. Es gibt zwei Verfahren, umgeschaltet über den Schalter **Shopware Integrationszugang**.

**Verfahren im Vergleich**

{% tabs %}
{% tab title="Integrationszugang (empfohlen)" %}
**Schalter *****Integrationszugang***** = aktiv.**

* Sie hinterlegen **Access Key ID** und **Secret Access Key** aus einer Shopware-Integration.
* Technisch: `grant_type = client_credentials`.
* Vorteil: nicht an einen persönlichen Benutzer gebunden, ideal für automatisierte Prozesse.

**So legen Sie eine Integration in Shopware an:** Administration → Einstellungen → System → Integrationen → *Integration hinzufügen*. Kopieren Sie *Access key ID* und *Secret access key*.
{% endtab %}

{% tab title="Passwort-Grant" %}
**Schalter *****Integrationszugang***** = inaktiv.**

* Sie hinterlegen **Benutzername** und **Passwort** eines Shopware-Administrators.
* Technisch: `grant_type = password`, `client_id = administration`.
* Vorteil: schnell eingerichtet. Nachteil: an einen Benutzer und dessen Passwort gebunden.
  {% endtab %}
  {% endtabs %}

{% hint style="success" %}
**Empfehlung:** Nutzen Sie für den produktiven, automatisierten Betrieb den **Integrationszugang**. Er ist stabiler und unabhängig von Benutzer-Passwortänderungen.
{% endhint %}

**Felder in der Konfiguration**

| Feld                   | Bei Integrationszugang | Bei Passwort-Grant |
| ---------------------- | ---------------------- | ------------------ |
| Shopware User Name     | Access Key ID          | Benutzername       |
| Shopware User Password | Secret Access Key      | Passwort           |
| Integrationszugang     | aktiv                  | inaktiv            |

**Sicherheit**

* Zugangsdaten werden **maskiert** gespeichert.
* Das Token wird bei Bedarf automatisch neu abgerufen.
* Vergeben Sie der Integration in Shopware nur die **erforderlichen Rechte** (Schreibzugriff auf die relevanten Bereiche).

{% hint style="warning" %}
Wenn Sie das Passwort des Administrationsbenutzers ändern, schlägt der Passwort-Grant fehl, bis Sie das neue Passwort hinterlegen. Der Integrationszugang ist davon nicht betroffen.
{% endhint %}

### Häufige Fragen

#### Welchen Endpunkt und welchen Grant-Type nutzt der Connector für die Anmeldung?

Die Anmeldung erfolgt am Endpunkt `oauth/token`. Beim Integrationszugang verwendet der Connector `grant_type=client_credentials` mit Client ID und Client Secret; beim Admin-Benutzer `grant_type=password` mit `client_id=administration`, Benutzername und Passwort. Das zurückgegebene Bearer-Token wird bei allen weiteren Aufrufen im Header `Authorization: Bearer {token}` mitgesendet und bei Ablauf automatisch erneuert.

#### Was prüft die Aktion „Test Connection“ genau?

„Test Connection“ ruft intern die Token-Anmeldung (`GetToken`) auf. Gelingt der Token-Abruf, ist die Kombination aus Website-URL, API-Modulpfad und Zugangsdaten korrekt. Schlägt er fehl, protokolliert der Connector bei aktivem „Developer Log“ die genaue Serverantwort im API Call Log.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.solutioo.de/shopware/konfiguration/authentifizierungsmethoden-im-detail.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.