> 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/magento-2-api-connector/konfiguration/verbindung-und-authentifizierung.md).

# Verbindung und Authentifizierung

Eine grüne Verbindung ist der erste Meilenstein. Entscheidend ist jedoch, dass **jeder später genutzte Lese- und Schreibprozess** mit dem technischen Benutzer funktioniert.

{% columns %}
{% column width="50%" %}
**Benutzername & Passwort**

Der Connector fordert unter `/integration/admin/token` ein Admin-Token an. Dieser Weg ist in Version 27.10.0.16 der verlässlich nachweisbare Standard.
{% endcolumn %}

{% column width="50%" %}
**OAuth-Integration**

Consumer Key/Secret und Access Token/Secret sind vorhanden. Die aktuelle Signaturerzeugung arbeitet jedoch mit statischen Werten.
{% endcolumn %}
{% endcolumns %}

{% hint style="danger" %}
OAuth nicht produktiv verwenden, solange die Signaturerzeugung nicht technisch korrigiert und für alle benötigten Prozesse erfolgreich getestet wurde.
{% endhint %}

### Verbindung einrichten

{% stepper %}
{% step %}
**URL prüfen**

Magento-Basis-URL ohne abschließenden Slash erfassen; Standardpfad ist `/rest/all/V1`.
{% endstep %}

{% step %}
**Standardmodus wählen**

**Use API Integration** deaktivieren und User Name sowie User Password pflegen.
{% endstep %}

{% step %}
**Test Connection ausführen**

Connection Status, Zeitpunkt und Last Error kontrollieren.
{% endstep %}

{% step %}
**Einen Lese- und Schreibtest ergänzen**

Initialdaten laden und anschließend einen ungefährlichen Testdatensatz hochladen. Erst dann sind Rechte und Endpunkte ausreichend geprüft.
{% endstep %}
{% endstepper %}

### Typische Fehlerbilder

| Symptom | Wahrscheinliche Ursache                | Nächster Schritt                               |
| ------- | -------------------------------------- | ---------------------------------------------- |
| 401     | Benutzer, Passwort oder Token ungültig | Zugang neu prüfen und Token erneut anfordern   |
| 403     | API-Berechtigung fehlt                 | Magento-Rolle des technischen Benutzers prüfen |
| 404     | Basis-URL oder API-Pfad falsch         | URL und `/rest/all/V1` kontrollieren           |
| Timeout | Netzwerk, WAF, Proxy oder Last         | Erreichbarkeit und Serverprotokolle prüfen     |
| 5xx     | Magento oder vorgeschalteter Dienst    | Response im API Log sichern                    |

<details>

<summary><strong>Verbindung grün, Upload trotzdem rot?</strong></summary>

Der Verbindungstest bestätigt Tokenabruf und grundlegende Erreichbarkeit. Uploads können zusätzliche ACL-Rechte, Pflichtfelder, Mappings oder Magento-Module benötigen. Aktivieren Sie Developer Logging nur für den betroffenen Bereich und wiederholen Sie genau einen Testdatensatz.

</details>

{% hint style="warning" %}
Zugangsdaten sind Integrationsgeheimnisse. Nicht in Screenshots, Tickets, Exporte oder öffentliche Dokumentation übernehmen.
{% endhint %}


---

# 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/magento-2-api-connector/konfiguration/verbindung-und-authentifizierung.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.