> For the complete documentation index, see [llms.txt](https://hub.equipme.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.equipme.io/pro/dokumentation/automation/accounts.md).

# Accounts (Verbindungen)

Accounts im Automation-Modul von Equipme Pro: Verbindungen zu Pro, ERP, PSA und Kunden-Tenants anlegen, testen, umbenennen und entfernen – sicher und im richtigen Bereich.

**Pfad:** „Automation“ → „Accounts“

Ein **Account** ist eine gespeicherte Verbindung zu einem System – zu Equipme Pro selbst, zu deinem ERP, zu Autotask oder zum Microsoft-Tenant eines Kunden. Du legst ihn einmal an und wählst ihn danach in jeder passenden Komponente aus, ohne dich erneut anzumelden.

## Die Account-Liste

Die Liste zeigt je Account:

| Spalte        | Inhalt                                                                                     |
| ------------- | ------------------------------------------------------------------------------------------ |
| **„Name“**    | Bezeichnung des Accounts                                                                   |
| **„Service“** | Das verbundene System, z. B. Equipme, weclapp oder Microsoft                               |
| **„Usage“**   | In wie vielen Flows der Account verwendet wird, z. B. „Used in 3 flows.“                   |
| **„Status“**  | Ergebnis des letzten Tests: „Tested“ (in Ordnung), „Failed“ (fehlerhaft) oder „Not tested“ |

Über „Filter …“ suchst du nach Namen. Die Liste zeigt die Accounts des gewählten Bereichs „Persönlich“ oder „Team“.

## Einen Account anlegen

Accounts legst du im [Flow-Designer](https://hub.equipme.io/pro/dokumentation/automation/flow-designer.md) an, sobald eine Komponente eine Verbindung braucht:

1. Komponente auf die Arbeitsfläche ziehen und auswählen.
2. Im Inspector **„Connect account“** bzw. **„Connect a new account“** klicken.
3. Anmelden oder Zugangsdaten eingeben (siehe unten). Der Account wird geprüft und gespeichert.
4. Danach erscheint er unter „Accounts“ und steht in allen Komponenten desselben Systems zur Auswahl.

Je nach System gibt es zwei Arten der Anmeldung:

* **Anmeldung beim Anbieter:** Es öffnet sich das Anmeldefenster des Systems, z. B. von Microsoft. Du meldest dich an und bestätigst die angeforderten Berechtigungen. Dein Passwort gibst du dabei nur beim Anbieter ein.
* **API-Key oder Zugangsdaten:** Du trägst einen Schlüssel ein, den du im jeweiligen System erzeugt hast, z. B. bei weclapp oder Autotask.

### Verbindung zu Equipme Pro

Für die Komponenten des equipme Connectors brauchst du einen **API-Key aus Pro**:

1. Unter [„Administration“ → „Integrationen“ → „API-Key“](https://hub.equipme.io/pro/dokumentation/administration/integrations.md#api-key) einen API-Key erzeugen. Dort siehst du auch deine Tenant-ID.
2. Im Flow-Designer eine Komponente des Moduls „Equipme Pro“ einfügen, „Connect account“ klicken und den API-Key eintragen.

Details: [equipme Connector – Pro-Module](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md#verbindung-einrichten).

### Accounts je Kunden-Tenant

Für [Microsoft Intune](https://hub.equipme.io/pro/dokumentation/automation/connectors/microsoft-intune.md) und [Microsoft Entra ID](https://hub.equipme.io/pro/dokumentation/automation/connectors/microsoft-entra-id.md) gilt ein Account immer für **genau einen Tenant**. Lege daher **je Kunde einen eigenen Account** an – angemeldet mit einem Konto im Tenant dieses Kunden – und nenne ihn eindeutig, z. B. „Intune – Kunde Muster GmbH“.

## Accounts verwalten

| Aktion         | Wirkung                                                                  |
| -------------- | ------------------------------------------------------------------------ |
| **„Test“**     | Prüft die Verbindung eines Accounts.                                     |
| **„Test all“** | Prüft alle Accounts auf einmal.                                          |
| **„Rename“**   | Gibt dem Account einen verständlichen Namen.                             |
| **„Revoke“**   | Entfernt den Account und entzieht Automation den Zugriff auf das System. |

{% hint style="warning" %}
**Entfernen stoppt Flows.** Alle Flows, die einen entfernten Account verwenden, werden angehalten. Prüfe vorher unter „Usage“, welche Flows betroffen sind. Danach wählst du in diesen Flows einen anderen Account aus und startest sie neu.
{% endhint %}

## „Persönlich“ oder „Team“

Accounts gehören wie Flows zu einem Bereich (siehe [Automation im Überblick](https://hub.equipme.io/pro/dokumentation/automation.md#bereich-wahlen-personlich-oder-team)):

* **„Team“:** Alle mit Automation-Zugriff können den Account in ihren Flows verwenden. Richtig für produktive Verbindungen wie ERP, PSA oder Pro.
* **„Persönlich“:** Nur du nutzt den Account. Richtig für Tests oder Verbindungen mit deinem persönlichen Konto.

Lege einen Flow und seine Accounts im selben Bereich an.

## Sicherheit

* **Dienstkonten statt persönlicher Konten:** Verbinde produktive Flows mit einem eigenen Dienstkonto oder API-Benutzer. So laufen die Flows weiter, wenn eine Person das Unternehmen verlässt, und Änderungen sind im Fremdsystem klar zuzuordnen.
* **So wenig Rechte wie nötig:** Gib dem verbundenen Konto nur die Berechtigungen, die der Flow braucht.
* **API-Keys wie Passwörter behandeln:** Nicht per E-Mail oder Chat weitergeben. Nicht mehr benötigte Keys in Pro löschen.
* **Regelmäßig prüfen:** Mit „Test all“ fehlerhafte Accounts erkennen; ungenutzte Accounts entfernen.

## Häufige Fragen

**Ein Account steht auf „Failed“.**

Die Anmeldung ist abgelaufen, das Passwort wurde geändert oder Berechtigungen wurden entzogen. Verbinde den Account im Flow-Designer neu (oder lege einen neuen an) und wähle ihn in den betroffenen Flows aus.

**Ich sehe einen Account nicht, den mein Kollege angelegt hat.**

Er liegt vermutlich in seinem Bereich „Persönlich“. Gemeinsam genutzte Accounts gehören in den Bereich „Team“.

**Kann ich mit einem Microsoft-Account mehrere Kunden-Tenants verwalten?**

Nein. Ein Account gilt für genau einen Tenant. Lege je Kunde einen eigenen Account an.

**Welche Rechte hat ein Flow mit meinem Pro-API-Key?**

Die Rechte des API-Keys auf Provider-Ebene – also Zugriff auf die Daten aller deiner Kunden. Bewahre den Key entsprechend sicher auf.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://hub.equipme.io/pro/dokumentation/automation/accounts.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
