# Integrationen (https://docs.akollo.com/de/modules/integrations)



Das Modul Integrationen verbindet Akollo mit den externen Systemen, die Ihre Organisation bereits nutzt, etwa Jira, Microsoft Teams, Slack, Mail und Kalender, Verzeichnisdienste, CRM-Werkzeuge und BI-Werkzeuge. Hier verwalten Administratoren auch API-Schlüssel, Webhooks und Datenexporte. Integrationen sind ein eigener Bereich: Öffnen Sie **Integrations** (Integrationen) in der Seitenleiste. Den Link sehen Personen, die Verbindungen lesen dürfen.

Ältere Lesezeichen auf die Integrationseinstellungen funktionieren weiter: Sie öffnen den Bereich Integrations. Ein Lesezeichen auf den CRM-Abschnitt öffnet den **Catalogue** (Katalog) mit ausgewählter CRM-Kategorie.

## Wer es nutzt [#wer-es-nutzt]

| Rolle                                                | Was sie hier tut                                                                                                                                  |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| Administration                                       | Lässt Connectoren zu, richtet Verbindungen ein und verwaltet API-Schlüssel, Webhooks und Datenexporte.                                            |
| Verantwortliche und Stellvertretung einer Verbindung | Stehen für eine Verbindung ein: ihre Zugangsdaten, Synchronisierungen und Probleme. Jede Verbindung hat beide, und es sind verschiedene Personen. |
| Integrationsoperator                                 | Eine eigene Rolle, die Verbindungen lesen und testen, Synchronisierungen starten und deren Probleme lösen darf, ohne Verbindungen zu verwalten.   |
| Berichtsadministration                               | Richtet den BI-Zugriff auf Berichtsdatensätze ein.                                                                                                |
| Entwicklung eines anderen Systems                    | Ruft die öffentliche API mit einem Schlüssel auf und liest die Referenz unter **Developer**.                                                      |
| Support-Sitzung                                      | Kann jede Seite ansehen, aber keine Verbindung, keinen Schlüssel, keine Richtlinie und keine Allowlist eines Connectors ändern.                   |

## Wichtige Ansichten [#wichtige-ansichten]

| Reiter                                              | Inhalt                                                                                                                                                                                          |
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Overview** (Übersicht)                            | Verbindungen nach Status, offene Probleme, bald ablaufende Schlüssel, Zustand der Synchronisierungen der letzten 14 Tage und die jüngsten Synchronisierungen.                                   |
| **Catalogue** (Katalog)                             | Alle Connectoren, filterbar nach Kategorie, Status, Support und Richtlinie. Die Seite eines Connectors zeigt seine Versionen mit Testnachweis, die Allowlist, erreichbare Hosts und die Lizenz. |
| **Connections** (Verbindungen)                      | Die Verbindungen der Organisation mit Status und letztem Test. Eine Verbindungsseite hat die Reiter **Overview**, **Tests** und **Syncs**.                                                      |
| **Issues** (Probleme)                               | Datensätze, die eine Synchronisierung nicht verarbeiten konnte, nach Ursache gruppiert, mit Wiederholen, Überspringen und Konfliktlösung.                                                       |
| **API keys** (API-Schlüssel)                        | Schlüssel für andere Programme mit Scopes, Ablauf, letzter Nutzung und Zustand.                                                                                                                 |
| **Developer** (Entwickler)                          | Die Referenz der öffentlichen API: jede Route der gewählten Version, ihr Scope und eine Beispielanfrage.                                                                                        |
| **Inbound** (Eingehend)                             | Endpunkte, an die ein anderes System Webhooks an Akollo senden kann.                                                                                                                            |
| **Webhooks**                                        | Endpunkte, an die Akollo die Ereignisse dieser Organisation sendet.                                                                                                                             |
| **Data out** (Datenexport)                          | Exportziele wie Azure Blob, Power BI und Analytics SQL.                                                                                                                                         |
| **Analytics SQL access** (SQL-Zugriff für Analysen) | Eine Karte je genehmigtem SQL-Zugriff für BI-Werkzeuge.                                                                                                                                         |

<Screenshot src="/screens/en/integrations.webp" alt="Übersicht der Integrationen mit Zählern für aktive Verbindungen, Verbindungen mit Handlungsbedarf, offene Probleme und bald ablaufende Schlüssel" caption="Overview: Verbindungszahlen, offene Probleme und bald ablaufende Schlüssel." />

<Screenshot src="/screens/en/integrations-catalogue.webp" alt="Connector-Katalog mit Filtern für Kategorie, Status, Support und Richtlinie sowie Connector-Karten mit Statusabzeichen" caption="Catalogue: Connectoren filtern und Status und Support-Stufe sehen." />

<Screenshot src="/screens/en/integrations-connections.webp" alt="Verbindungsliste mit Namen, einem Statusabzeichen wie Draft, Active oder Disabled und dem letzten Test" caption="Connections: Status und letzter Test jeder Verbindung." />

## Wie Daten fließen [#wie-daten-fließen]

<Mermaid
  title="Wie Akollo Daten mit anderen Systemen austauscht"
  chart="`flowchart LR
A[Anderes System] -->|Verbindung und Synchronisierung| B[Akollo]
A -->|Eingehender Webhook| B
C[Programm mit API-Schlüssel] -->|Öffentliche API| B
B -->|Ausgehender Webhook| D[Empfangendes System]
B -->|Datenexport und SQL-Zugriff| E[BI-Werkzeug]`"
/>

## Wichtige Aufgaben [#wichtige-aufgaben]

### Eine Verbindung einrichten [#eine-verbindung-einrichten]

<Steps>
  <Step>
    ### Connector wählen [#connector-wählen]

    Wählen Sie unter **Connections** die Schaltfläche **New connection** und dann einen Connector. Angeboten werden nur Connectoren, die installiert und für Ihre Organisation zugelassen sind.
  </Step>

  <Step>
    ### Zugangsdaten und Verantwortliche eintragen [#zugangsdaten-und-verantwortliche-eintragen]

    Benennen Sie die Verbindung, wählen Sie eine verantwortliche Person und eine andere Person als Stellvertretung und geben Sie die Zugangsdaten ein, die der Connector verlangt. Sie werden verschlüsselt gespeichert und nie wieder angezeigt.
  </Step>

  <Step>
    ### Richtung wählen [#richtung-wählen]

    Wählen Sie **Read**, **Write** oder **Read and write**. Die Datenklassen und Hosts, die die Connector-Richtlinie erlaubt, werden zur Information angezeigt.
  </Step>

  <Step>
    ### Testen, dann aktivieren [#testen-dann-aktivieren]

    Führen Sie **Test** aus, dann **Activate** (Aktivieren). Die Verbindung bleibt ein Entwurf, bis ein Test bestanden ist.
  </Step>
</Steps>

<Callout type="info" title="Hinweis">
  In dieser Version ist die Connector-Ausführung abgeschaltet. Der Testschritt wird daher nicht angeboten, und neue Verbindungen bleiben Entwürfe. Siehe [Verbundene Systeme](/de/connections).
</Callout>

### Einem anderen Programm API-Zugriff geben [#einem-anderen-programm-api-zugriff-geben]

<Steps>
  <Step>
    ### Schlüssel anlegen [#schlüssel-anlegen]

    Legen Sie unter **API keys** einen Schlüssel an, benennen Sie ihn nach dem System, das ihn nutzt, und wählen Sie den **Service account** (Dienstkonto), für den er handelt.
  </Step>

  <Step>
    ### Einschränken [#einschränken]

    Setzen Sie nur die nötigen Scopes, ein Ablaufdatum (höchstens ein Jahr) und nach Möglichkeit **Allowed IP ranges** (erlaubte IP-Bereiche).
  </Step>

  <Step>
    ### Sicher ablegen [#sicher-ablegen]

    Wählen Sie **Create key** und kopieren Sie den Schlüssel. Er wird nur einmal angezeigt. Ein Schlüssel, der Datensätze ändern kann, wartet, bis eine andere Administratorin oder ein anderer Administrator ihn genehmigt.
  </Step>
</Steps>

### Zurückgestellte Datensätze einer Synchronisierung bearbeiten [#zurückgestellte-datensätze-einer-synchronisierung-bearbeiten]

<Steps>
  <Step>
    ### Issues öffnen [#issues-öffnen]

    Öffnen Sie **Issues**. Die Datensätze sind nach Ursache gruppiert, mit Anzahl und dem ersten und letzten Auftreten.
  </Step>

  <Step>
    ### Ursache beheben [#ursache-beheben]

    Korrigieren Sie zum Beispiel die Feldzuordnung des Sync-Streams.
  </Step>

  <Step>
    ### Wiederholen, überspringen oder lösen [#wiederholen-überspringen-oder-lösen]

    Wiederholen Sie die Datensätze (eine Wiederholung liest sie erneut aus der Quelle), überspringen Sie sie mit Begründung oder lösen Sie einen Konflikt, indem Sie den Akollo-Wert, den externen Wert oder einen neuen Wert wählen.
  </Step>
</Steps>

### Ereignisse an ein anderes System senden [#ereignisse-an-ein-anderes-system-senden]

<Steps>
  <Step>
    ### Endpunkt anlegen [#endpunkt-anlegen]

    Geben Sie unter **Webhooks** eine https-Adresse, die Ereignistypen und an, ob der vollständige Datensatz oder nur ein Verweis gesendet wird.
  </Step>

  <Step>
    ### Signaturgeheimnis ablegen [#signaturgeheimnis-ablegen]

    Das Geheimnis wird nur einmal angezeigt, direkt nach dem Anlegen.
  </Step>

  <Step>
    ### Zustellungen beobachten [#zustellungen-beobachten]

    Die Liste zeigt Zustand und Zustellerfolg jedes Endpunkts in den letzten 24 Stunden. Die Seite eines Endpunkts zeigt sein Nachrichtenprotokoll und jeden Zustellversuch.
  </Step>
</Steps>

<Callout type="info" title="Hinweis">
  In dieser Version ist die ausgehende Zustellung noch nicht eingeschaltet; die Seite bietet das Anlegen eines Endpunkts daher nicht an. Siehe [Webhooks](/de/connections/webhooks).
</Callout>

### Ein BI-Werkzeug versorgen [#ein-bi-werkzeug-versorgen]

<Steps>
  <Step>
    ### Weg wählen [#weg-wählen]

    Lesen Sie Berichtsdatensätze mit einem Nur-Lese-Schlüssel über die API, oder richten Sie für Live-Abfragen einen SQL-Zugriff ein.
  </Step>

  <Step>
    ### Anleitung folgen [#anleitung-folgen]

    Für Power BI, Tableau und Looker Studio siehe [BI-Datensätze](/de/connections/bi-datasets), für SQL [BI-Werkzeug per SQL anbinden](/de/connections/bi-sql-access).
  </Step>
</Steps>

<Screenshot src="/screens/en/data-out.webp" alt="Reiter Data out mit den Exportzielen Azure Blob, Power BI und Analytics SQL und ausgeschaltetem Azure-Blob-Export" caption="Data out: Exportziele neben dem Datensatz-Feed." />

## Bestimmte Systeme [#bestimmte-systeme]

| System                            | Was es leistet                                                                                                                                                        | Seite                                                         |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| Jira Cloud und Jira Data Center   | Parallelbetrieb mit Jira oder Übernahme ausgewählter Arbeit von Jira nach Akollo mit geprüfter Übergabe.                                                              | [Jira: Parallelbetrieb und Umstieg](/de/connections/jira)     |
| Zoom                              | Liest beendete Meetings: Beginn, Ende, Dauer, Teilnehmerzahl und Host. Ändert keine Meetings und liest keine Namen.                                                   | [Zoom-Meetings](/de/connections/zoom)                         |
| LDAP, Entra ID, Outlook-Mail      | Verzeichnis- und Mail-Verbindungen mit **Provider settings** (Anbietereinstellungen) im Reiter Overview der Verbindung. Verzeichnis-Connectoren lesen und listen nur. | [Verbundene Systeme](/de/connections)                         |
| Power BI, Tableau, Looker Studio  | Lesen Berichtsdatensätze über die API.                                                                                                                                | [BI-Datensätze](/de/connections/bi-datasets)                  |
| Power BI, Tableau, Excel über SQL | Lesen genehmigte Datensätze live mit einem Nur-Lese-Login.                                                                                                            | [BI-Werkzeug per SQL anbinden](/de/connections/bi-sql-access) |

Die Übernahme von Daten aus einem anderen System wird je System geplant: Vereinbaren Sie für jede Verbindung Zweck, zu teilende Datensätze, Richtung der Aktualisierungen und die verantwortliche Person. Eine Verbindung bringt nicht automatisch jede Funktion oder jeden historischen Datensatz des anderen Produkts mit. Prüfen Sie vor der Annahme einer Übergabe die Abdeckung der vereinbarten Datensätze und klären Sie offene Ausnahmen.

## Berechtigungen [#berechtigungen]

* **Inhaber und Administratoren** können in diesem Bereich standardmäßig alles lesen und ändern. Eine eigene Rolle Integrationsoperator kann Verbindungen lesen und testen, Synchronisierungen starten und Probleme lösen.
* **Zugangsdaten** werden nach dem Speichern niemandem mehr angezeigt. Zugangsdaten zu erneuern ist eine eigene Berechtigung; die bisherigen funktionieren noch 24 Stunden.
* **Zwei Personen** sind bei heiklen Änderungen nötig: Einen API-Schlüssel mit Schreibrechten genehmigt jemand anderes als die Person, die ihn angelegt hat, und eine Feldzuordnung, die ein geschütztes Feld für das externe System öffnet, braucht eine zweite Administratorin oder einen zweiten Administrator.
* **API-Schlüssel** können nie mehr als die Rolle des Dienstkontos, für das sie handeln.
* **Verantwortliche**: Die verantwortliche Person einer Verbindung kann nicht zugleich ihre Stellvertretung sein.
* **Support-Sitzungen** dürfen auf jeder Seite nur lesen; die Allowlist eines Connectors können sie nicht ändern.

## Was die KI hier tun kann [#was-die-ki-hier-tun-kann]

Integrationen haben keine eigenen KI-Funktionen. Einen eigenen KI-Anbieter oder Modellserver anzubinden ist eine separate Einstellung; siehe [KI-Verbindungen](/de/ai/connections). Der [KI-Assistent](/de/ai/assistant) ändert keine Verbindungen, Schlüssel oder Webhooks.

## Häufige Fragen [#häufige-fragen]

<Accordions type="single">
  <Accordion title="Warum ist ein Connector im Katalog ausgegraut?">
    Er ist in dieser Installation nicht installiert. Connectoren werden mit einem Release installiert. Gesperrte Connectoren sind mit dem Grund gekennzeichnet.
  </Accordion>

  <Accordion title="Warum bleibt meine neue Verbindung ein Entwurf?">
    Eine Verbindung bleibt ein Entwurf, bis ein Test bestanden ist. In dieser Version ist die Connector-Ausführung abgeschaltet, daher wird der Testschritt nicht angeboten.
  </Accordion>

  <Accordion title="Kann ich einen Schlüssel oder ein Geheimnis später noch einmal sehen?">
    Nein. API-Schlüssel, Signaturgeheimnisse und Zugangsdaten werden nur einmal angezeigt. Geht etwas verloren, rollen Sie den Schlüssel bzw. erneuern Sie das Geheimnis oder die Zugangsdaten.
  </Accordion>

  <Accordion title="Wo sind die Integrationseinstellungen geblieben?">
    Integrationen sind jetzt ein eigener Bereich in der Seitenleiste. Alte Einstellungslinks öffnen ihn, und ein CRM-Lesezeichen öffnet den Katalog mit ausgewählter CRM-Kategorie.
  </Accordion>

  <Accordion title="Zeigt eine fehlgeschlagene Synchronisierung Werte von Datensätzen?">
    Nein. Issues zeigt nur Feldnamen, Typen und bei nicht geschützten Feldern die Länge. Gespeicherte Kopien fehlgeschlagener Datensätze sind verschlüsselt und werden nach 30 Tagen gelöscht.
  </Accordion>

  <Accordion title="Warum kann eine Support-Sitzung nichts ändern?">
    Support-Sitzungen dürfen im gesamten Bereich Integrations nur lesen. Sie können sich alles ansehen, aber keine Verbindung, keinen Schlüssel, keine Richtlinie und keine Allowlist eines Connectors ändern.
  </Accordion>
</Accordions>

## Verwandte Seiten [#verwandte-seiten]

* [Verbundene Systeme](/de/connections)
* [Synchronisierung im Detail](/de/connections/sync-details)
* [API und Schlüssel](/de/connections/api)
* [Webhooks](/de/connections/webhooks)
* [BI-Datensätze](/de/connections/bi-datasets)
* [BI-Werkzeug per SQL anbinden](/de/connections/bi-sql-access)
* [Jira: Parallelbetrieb und Umstieg](/de/connections/jira)
* [Zoom-Meetings](/de/connections/zoom)