> ## Documentation Index > Fetch the complete documentation index at: https://docs.nuwacom.ai/llms.txt > Use this file to discover all available pages before exploring further. # Verbindungen ## **Überblick** Eine Verbindung ist eine gespeicherte Anbindung zwischen nuwacom und einem externen Tool. Beim Verbinden eines Tools wie Google Calendar, HubSpot oder Slack entsteht eine Verbindung, die den für die Zusammenarbeit mit diesem Dienst nötigen Zugriff speichert. Jede Verbindung gehört der Person, die sie erstellt hat. Standardmäßig ist sie privat: Nur der Eigentümer sieht und nutzt sie, und Aktionen laufen mit den Zugriffsrechten des Eigentümers im externen Dienst. *** ## **Authentifizierungstypen** Die Art der Verbindung hängt vom jeweiligen Konnektor ab. | **Authentifizierungstyp** | **Funktionsweise** | | :- | :- | | **OAuth** | Anmeldung beim Dienst und Freigabe der Berechtigung für nuwacom. | | **API-Schlüssel / Token** | Ein API-Schlüssel oder Token aus dem Dienst wird in nuwacom eingefügt. | | **Keine** | Keine Authentifizierung erforderlich. | ### **OAuth** Die meisten gängigen Konnektoren nutzen OAuth, das branchenübliche Protokoll für sichere Autorisierung: 1. nuwacom leitet zur Anmeldeseite des Dienstes weiter, etwa Google oder Microsoft. 2. Mit dem eigenen Konto anmelden. 3. Die angeforderten Berechtigungen bestätigen. 4. nuwacom speichert den Zugriff sicher. Die Verbindung handelt in deinem Namen. Lässt sich ein Kalender in Google nicht öffnen, kann auch ein Agent über deine Verbindung ihn nicht öffnen. ### **API-Schlüssel / Token** Manche Konnektoren, besonders eigene, werden mit einem API-Schlüssel oder Token eingerichtet. Dieser wird aus den Einstellungen des Dienstes kopiert und beim Verbinden in nuwacom eingefügt. *** ## **Verbindung erneuern** Ist eine Verbindung abgelaufen oder widerrufen, zeigt das zugehörige Konto ein Warnsymbol mit dem Hinweis *Verbindungsproblem*. Durch erneutes Verbinden des Kontos wird der Zugriff wiederhergestellt. *** ## **Wer eine Verbindung nutzen kann** ### **Standardmäßig privat** Eine neue Verbindung wird als *Privates Konto* angezeigt: 1. Nur der Eigentümer sieht und nutzt sie. 2. Aktionen laufen mit den Zugriffsrechten des Eigentümers. 3. Zugangsdaten werden anderen Nutzern nie angezeigt. ### **Konto teilen** Der Eigentümer kann ein Konto über *Einstellungen → Konnektoren* teilen: 1. Das Konto in der Liste suchen. 2. Das Teilen-Symbol daneben auswählen (*\{Kontoname} teilen*). 3. Den Zugriff festlegen: bestimmte Nutzer, Nutzergruppen oder alle Workspace-Nutzer. Geteilte Konten sind als *Geteiltes Konto* gekennzeichnet. Das Teilen mit dem gesamten Workspace steht zur Verfügung, sofern die eigene Rolle das Teilen mit dem Workspace erlaubt. Ein Konto sollte nur mit Personen geteilt werden, denen das Handeln über dieses Konto anvertraut werden kann. Alle mit Zugriff arbeiten mit den Berechtigungen des Eigentümers im externen Dienst. *** ## **Standardkonto in einem Agent nutzen** Über ein Standardkonto führen andere Personen eine Konnektor-Aktion mit einem bestimmten Konto aus, ohne dass das Konto selbst geteilt wird. Die Nutzung ist ausschließlich über den Agent möglich, die Zugangsdaten bleiben dabei verborgen. ### **Einrichten** 1. In der Seitenleiste *Agenten* öffnen und einen Agent öffnen oder erstellen. 2. Unter *Aktionen* die Option *Aktion hinzufügen* wählen und die Konnektor-Aktion auswählen. 3. *Standardkonto auswählen* wählen. 4. Das Konto auswählen und *Aktion hinzufügen* wählen. 5. Den Agent veröffentlichen und mit den vorgesehenen Personen teilen. ### **Die zwei Modi** 1. **Standardkonto auswählen:** Ein Konto wird für alle verwendet, die die Aktion ausführen. Unabhängig von den eigenen Konten der Nutzer läuft die Aktion mit dem Zugriff dieses Kontos. 2. **Jeder Benutzer muss seinen eigenen Account verwenden (Erweitert):** Jede Person nutzt ihr eigenes Konto. Wer noch nicht verbunden ist, wird zur Verbindung aufgefordert. ### **Beispiele** 1. **Standardkonto:** Ein „Team Kalendar Agent" nutzt einen gemeinsamen Teamkalender. Nutzt ihn ein Kollege, landet der Termin im Teamkalender. 2. **Eigenen Account:** Ein „Persönlicher E-Mail-Agent" versendet Mails aus dem Postfach des jeweiligen Nutzers über dessen eigene Verbindung. Ist für eine Aktion kein Konto ausgewählt, verbindet jeder Nutzer bei der Verwendung des Agenten sein eigenes Konto. *** ## **Apps** Apps werden immer mit den verbundenen Konten der Person ausgeführt, die sie öffnet. Die eigenen verbundenen Konten bleiben privat und werden nie von Personen genutzt, mit denen eine App geteilt wird. *** ## **Den richtigen Ansatz wählen** | **Szenario** | **Empfohlener Ansatz** | | :- | :- | | Team benötigt einen gemeinsamen Kalender oder ein CRM-Konto | Aktion einem Agent mit Standardkonto hinzufügen | | Alle sollen das eigene Postfach oder den eigenen Kalender nutzen | Agent mit *Jeder Nutzer muss sein eigenes Konto verwenden* | | Kollegen sollen das Konto selbst sehen und nutzen | Konto über *Einstellungen → Konnektoren* teilen | | Persönlicher Workflow | Eigene Verbindung im eigenen Agent nutzen | ## FAQ Die Verbindung gehört der Person, die sie erstellt hat. Sie bleibt privat, bis sie mit anderen Nutzern oder dem Workspace geteilt wird. Prüfe, ob das verbundene Konto mit dem Kollegen geteilt wurde oder ob im Agent ein Standardkonto ausgewählt ist. Trifft beides nicht zu, muss der Kollege sein eigenes Konto verbinden. Die Verbindung ist möglicherweise abgelaufen oder wurde widerrufen. Das Konto kann unter *Einstellungen → Konnektoren* erneut verbunden werden. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.