> 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/dokumentation/dokumentation/automation/accounts.md).

# Accounts (Verbindungen)

Accounts im Automation-Modul: Verbindungen zu equipme und Drittsystemen anlegen, testen, umbenennen und entfernen – OAuth, API-Key und Sicherheit.

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

Ein **Account** ist eine gespeicherte Verbindung zu einem System – zu equipme selbst, zu Microsoft Entra ID, zu deinem ERP oder Ticketsystem. Du legst ihn einmal an und wählst ihn dann in beliebig vielen Flows und Komponenten aus, ohne dich erneut anzumelden.

## Die Account-Liste

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

Mit „Filter …“ suchst du nach Namen. Die Liste zeigt die Accounts des gewählten Arbeitsbereichs („Persönlich“ oder „Team“, siehe [Automation im Überblick](https://hub.equipme.io/dokumentation/dokumentation/automation.md#personlich-oder-team)).

## Account anlegen

**Aus dem Flow-Designer** (üblicher Weg):

1. Komponente des Systems auf die Arbeitsfläche ziehen, z. B. eine Aktion von Microsoft Entra ID.
2. Im Inspector **„Connect account“** bzw. **„Connect a new account“** klicken.
3. Je nach System anmelden oder Zugangsdaten eingeben (siehe unten).
4. Der neue Account ist in der Komponente ausgewählt und erscheint unter „Accounts“.

Für jede weitere Komponente desselben Systems wählst du den Account einfach aus der Liste („Select account“).

### Anmeldung oder API-Key

| Art                                                    | So läuft es                                                                                                                                                |
| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Anmeldung beim Anbieter** (z. B. Microsoft)          | Es öffnet sich ein Anmeldefenster des Anbieters. Du meldest dich an und bestätigst die angefragten Berechtigungen. Das Passwort sieht equipme dabei nicht. |
| **API-Key oder Zugangsdaten** (z. B. equipme, weclapp) | Du gibst einen Namen („Label“) und den Schlüssel bzw. die Zugangsdaten des Systems ein.                                                                    |

Welche Angaben ein System braucht, steht auf der jeweiligen Seite unter [Connectoren](https://hub.equipme.io/dokumentation/dokumentation/automation/connectors.md).

### Verbindung zu equipme

Für den [equipme Connector](https://hub.equipme.io/dokumentation/dokumentation/automation/connectors/equipme.md) brauchst du einen **API-Key** aus equipme:

1. Unter [Integrationen → „API-Key“](https://hub.equipme.io/dokumentation/dokumentation/settings/integrations-and-sso.md#api-key) einen Schlüssel erzeugen und kopieren.
2. Im Flow-Designer an einer equipme-Komponente „Connect account“ klicken, Label und API Key eintragen.

Details stehen unter [equipme Connector → Verbindung einrichten](https://hub.equipme.io/dokumentation/dokumentation/automation/connectors/equipme.md#verbindung-einrichten).

## Account testen

* **„Test“** an einem Account prüft diese eine Verbindung.
* **„Test all“** oben prüft alle Accounts der Liste.

Steht ein Account auf **„Failed“**, ist die Verbindung gestört – etwa weil der API-Key gelöscht wurde, ein Passwort geändert, die Berechtigung beim Anbieter entzogen oder die Anmeldung abgelaufen ist. Lege die Verbindung dann neu an, wähle sie in den betroffenen Komponenten aus und starte die Flows ggf. neu.

## Account umbenennen

**„Rename“** am Account öffnet „Rename account“. Gib Accounts sprechende Namen, z. B. „Entra ID – Produktion“ oder „equipme – HR-Sync“. Das hilft besonders unter „Team“, wenn mehrere Personen Accounts anlegen.

## Account entfernen

**„Revoke“** entfernt die Verbindung.

{% hint style="danger" %}
Wird ein Account entfernt, **stoppen alle Flows, die ihn verwenden**. Prüfe vorher in der Spalte „Usage“, wo der Account genutzt wird. Danach musst du in diesen Flows einen anderen Account auswählen und sie wieder starten.
{% endhint %}

## „Persönlich“ und „Team“

* Accounts unter **„Team“** stehen allen mit Zugriff auf das Automation-Modul in deinem Unternehmen zur Verfügung. Ein Flow unter „Team“ läuft dann unabhängig davon, wer ihn gebaut hat.
* Accounts unter **„Persönlich“** nutzt nur du.

Ein Flow verwendet Accounts aus seinem eigenen Arbeitsbereich. Für Team-Flows legst du den Account deshalb auch unter „Team“ an.

## Sicherheit

* **Eigene Schlüssel je Zweck:** Lege für das Automation-Modul einen eigenen equipme-API-Key an, statt einen bestehenden mitzubenutzen. So kannst du ihn gezielt sperren.
* **Möglichst wenig Rechte:** Gib bei Drittsystemen nur die Berechtigungen frei, die der Flow braucht, und verwende nach Möglichkeit Dienstkonten statt persönlicher Konten.
* **Team-Accounts bewusst anlegen:** Unter „Team“ können alle mit Automation-Zugriff den Account in ihren Flows verwenden.
* **Aufräumen:** Nicht mehr genutzte Accounts („Not used in any flows.“) entfernen.
* **Wechsel im Team:** Verlässt jemand das Unternehmen, prüfe, ob Flows an seinen persönlichen Zugängen hängen, und stelle sie auf Dienstkonten um.

## Häufige Fragen

**Ich habe den Account angelegt, sehe ihn aber in einer Komponente nicht.**

Prüfe, ob der Account im selben Arbeitsbereich („Persönlich“/„Team“) liegt wie der Flow und ob er zum System der Komponente gehört.

**Kann ich einen Account mehrfach verwenden?**

Ja. Ein Account lässt sich in beliebig vielen Flows und Komponenten auswählen.

**Was passiert, wenn ich den equipme-API-Key lösche?**

Alle Komponenten, die diesen Key nutzen, schlagen fehl; der Account steht beim Test auf „Failed“. Lege einen neuen Key an und verbinde den Account neu.

**Verbindung zu einem Anbieter schlägt fehl – woran liegt es?**

Häufig fehlen beim Anbieter die nötigen Berechtigungen oder die Freigabe durch einen Administrator (z. B. die Administratorzustimmung in Microsoft Entra ID). Hinweise stehen auf der Seite des jeweiligen [Connectors](https://hub.equipme.io/dokumentation/dokumentation/automation/connectors.md).


---

# 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/dokumentation/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.
