# Aareon Connect Direct

## Überblick

Connect Direct ermöglicht Partnern einen sicheren API-Zugriff auf Yuneo-Daten.

Das Onboarding umfasst vier Schritte:

1. Keycloak aktivieren
2. API-Benutzer anlegen
3. Backend konfigurieren
4. Zugangsdaten bereitstellen

{% hint style="info" %}
Pro Partner wird ein eigener API-Benutzer benötigt.
{% endhint %}

### Ablauf

{% stepper %}
{% step %}

### 1. Keycloak aktivieren

**Verantwortlich:** Kunde / Aareon

Die Nutzung von Aareon Connect Direct setzt **Keycloak** voraus. 

#### SaaS-Kunden

* Die Umstellung erfolgt durch den Kunden selbst direkt im System.
* Navigation: **Optionen → Allgemein → Multifaktorauthentifizierung**
* Planen Sie etwa 14 Tage Vorlauf ein.
* Die Umstellung kann auch vor Vertragsunterzeichnung erfolgen.

#### On-Premise-Kunden

* Die Umstellung erfolgt durch Aareon IT Infrastruktur oder Aareon Consultants.
* Erstellen Sie dafür ein Zendesk-Ticket an **IT Infrastruktur**.

Verwenden Sie dabei diesen Text:

> Bitte um Umstellung auf das aktuelle Keycloak-Authentifizierungsverfahren für unser In-House-System. Die Umstellung ist Voraussetzung für die Connect Direct Anbindung an **\[Partnername]**.

{% hint style="info" %}
Keycloak ist eine zentrale Authentifizierungs- und Autorisierungslösung, die von Aareon eingesetzt wird. Sie ermöglicht eine sichere Anmeldung (z. B. über OAuth2/OpenID Connect) und bildet die Grundlage für den API-Zugriff bei Aareon Connect Direct.

Die Nutzung von Aareon Connect Direct setzt Keycloak zwingend voraus. **Alle Kunden (SaaS und On-Premise) müssen Keycloak aktivieren**, bevor die Anbindung erfolgen kann.
{% endhint %}
{% endstep %}

{% step %}

### 2. Yuneo-Benutzer für Schnittstelle anlegen

**Verantwortlich:** Kunde

Der Kunde legt nach der Keycloak-Umstellung einen Yuneo Benutzer an, welcher für den Zugriff auf die API genutzt werden kann. Folgende Schritte müssen genau befolgt werden:

#### Benutzerdaten

* Neuen Benutzer hinzufügen
* Benutzername / E-Mail: `svc_<partner_name>@aareon.com`
* Nachname: Partnername
* Option **Alle Mandanten** aktivieren
* Partnerspezifische Benutzerrolle zuweisen

{% hint style="info" %}
Die Benutzerrolle richten Sie in Yuneo unter **„Benutzerrollen“** ein. Anschließend weisen Sie diese Rolle dem entsprechenden Yuneo-Benutzer zu.

Sobald der Benutzer angelegt wurde, informieren Sie uns bitte per E-Mail. Eine kurze Nachricht an **<connect@aareon-dach.zendesk.com>** mit dem Benutzernamen sowie dem Hinweis, dass der Benutzer erfolgreich erstellt wurde, ist hierfür ausreichend.
{% endhint %}
{% endstep %}

{% step %}

### 3. Backend konfigurieren

**Verantwortlich:** Aareon / Yuneo

* Dieser Schritt erfolgt vollständig durch Aareon, nachdem Sie Schritt 2 erledigt haben.
* Einrichtung im API Gateway
* Verknüpfung von Kunde, Benutzer und Partner

Wenn Schritt 1 und 2 abgeschlossen sind, ist hier keine Aktion des Kunden nötig.
{% endstep %}

{% step %}

### 4. Zugangsdaten bereitstellen

**Verantwortlich:** Aareon

Nach Abschluss aller Schritte erstellt Aareon die API-Zugangsdaten je Kunde und Partner.

Die Zugangsdaten werden anschließend an den jeweiligen Partner übermittelt.
{% endstep %}
{% endstepper %}

### Checkliste

Die Anbindung ist abgeschlossen, wenn diese Punkte erfüllt sind:

* Keycloak ist aktiviert.
* Der API-Benutzer ist je Partner angelegt.
* Das Backend ist durch Aareon konfiguriert.
* Die Zugangsdaten wurden bereitgestellt.


---

# 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://connect-docs-de.locoia.com/aareon-connect-direct.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.