> 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/magento2_en_us/configuration/connection-and-authentication.md).

# Connection and Authentication

A green connection is the first milestone. However, what matters is that **every read and write process used later** works with the technical user.

{% columns %}
{% column width="50%" %}
**Username & Password**

The connector requests an admin token via `/integration/admin/token`. This method is the reliably verified standard in version 27.10.0.16.
{% endcolumn %}

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

Consumer Key/Secret and Access Token/Secret are available. However, the current signature generation works with static values.
{% endcolumn %}
{% endcolumns %}

{% hint style="danger" %}
Do not use OAuth in production until the signature generation has been technically corrected and successfully tested for all required processes.
{% endhint %}

### Setting Up the Connection

{% stepper %}
{% step %}
**Verify the URL**

Enter the Magento base URL without a trailing slash; the default path is `/rest/all/V1`.
{% endstep %}

{% step %}
**Choose the default mode**

Disable **Use API Integration** and enter User Name and User Password.
{% endstep %}

{% step %}
**Run Test Connection**

Check Connection Status, timestamp, and Last Error.
{% endstep %}

{% step %}
**Add a read and write test**

Download initial data and then upload a harmless test record. Only then are permissions and endpoints sufficiently verified.
{% endstep %}
{% endstepper %}

### Typical Error Patterns

| Symptom | Probable Cause                   | Next Step                                    |
| ------- | -------------------------------- | -------------------------------------------- |
| 401     | User, password, or token invalid | Re-check credentials and request a new token |
| 403     | API permission missing           | Check the Magento role of the technical user |
| 404     | Base URL or API path incorrect   | Verify the URL and `/rest/all/V1`            |
| Timeout | Network, WAF, proxy, or load     | Check reachability and server logs           |
| 5xx     | Magento or upstream service      | Save the response in the API log             |

<details>

<summary><strong>Connection green, but upload still red?</strong></summary>

The connection test confirms token retrieval and basic reachability. Uploads may require additional ACL permissions, mandatory fields, mappings, or Magento modules. Enable Developer Logging only for the affected area and repeat exactly one test record.

</details>

{% hint style="warning" %}
Credentials are integration secrets. Do not include them in screenshots, tickets, exports, or public documentation.
{% 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/magento2_en_us/configuration/connection-and-authentication.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.