Dienstkonto für eine Integration erstellen

Ein Dienstkonto weist einer Integration eine eigene Identität innerhalb eines KORONA Event-Kontos zu. Es verfügt über einen Namen, eine Rolle und optional einen Standard-Verkaufspunkt. Es nutzt API-Schlüssel und verfügt weder über eine E-Mail-Adresse noch über eine Browser-Anmeldung. Verwenden Sie für jede Integration oder jeden Standort, der unterschiedliche Berechtigungen oder einen anderen Standard-Verkaufspunkt benötigt, ein separates Dienstkonto.

Erstellen Sie das Konto

Kontoinhaber und Plattformadministratoren können Dienstkonten anlegen und verwalten.

1. Öffnen Sie Verwaltung > Benutzer und wählen Sie Dienstkonto erstellen aus.
2. Geben Sie einen Kontonamen ein, der dessen Zweck verdeutlicht, beispielsweise „BookingKit – Berlin“.
3. Wählen Sie eine Rolle mit den für Ihre Integration erforderlichen Berechtigungen aus. Klären Sie die erforderlichen Berechtigungen mit dem Anbieter des Konnektors ab.
4. Wählen Sie optional einen Standard-Verkaufspunkt aus. Dieser wird verwendet, wenn die Integration KORONA Event auffordert, automatisch einen Verkaufspunkt auszuwählen. Abweichende Einstellungen oder Vorgaben eines passenden Bestellkanals können Vorrang haben. Ein von der Integration explizit angegebener Verkaufspunkt hat Vorrang vor der automatischen Auswahl.
5. Wählen Sie „Dienstkonto erstellen“ aus. Die Detailseite wird mit der Bezeichnung „Dienstkonto“ geöffnet.
6. Wählen Sie unter API-Schlüssel die Option API-Schlüssel erstellen aus. Kopieren Sie den neuen Schlüssel umgehend in Ihren Secret Manager und konfigurieren Sie die Integration. Der vollständige Schlüssel wird nur einmal angezeigt.

Es ist weder eine Einladung noch die Einrichtung eines Passworts erforderlich. Dienstkonten werden in der normalen Benutzerliste angezeigt und können bei der Zuweisung eines Integrationsbenutzers zu einem Bestellkanal ausgewählt werden.

Unter API-Zugriff erhalten finden Sie den API-Endpunkt sowie Beispiele für den Account-Header und die Authentifizierung. Durch die Erstellung eines Dienstkontos wird weder der externe Konnektor aktiviert noch werden dessen Artikel, Kanäle oder Abrechnungszuordnungen für Wiederverkäufer konfiguriert. Informationen zu BookingKit finden Sie unter Arbeiten mit BookingKit-Buchungen.

Zugriff aufrechterhalten

Öffnen Sie das Dienstkonto unter Verwaltung > Benutzer, um dessen Standard-Verkaufspunkt zu ändern oder dessen API-Schlüssel zu verwalten. Die Bearbeitung von Rollen ist möglich, wenn die Rollenverwaltung für Ihr Konto aktiviert ist. Änderungen an der Rolle wirken sich auf die Berechtigungen der zugehörigen API-Schlüssel aus.

Um einen Schlüssel zu ersetzen, erstellen Sie einen neuen, konfigurieren Sie die Integration so, dass dieser verwendet wird, und entziehen Sie anschließend den alten Schlüssel. Sollte der neue Schlüssel verloren gegangen sein, bevor er gespeichert wurde, erstellen Sie einen weiteren; der maskierte Wert kann ihn nicht erneut offenlegen.

Um eine Zugangsberechtigung zu sperren, wählen Sie neben dieser die Option API-Schlüssel widerrufen aus. Um den Zugriff des Dienstkontos auf das Konto zu entfernen, wählen Sie auf dessen Detailseite die Option Löschen aus; dadurch wird die Mitgliedschaft des Dienstkontos aufgehoben und seine Schlüssel für das Konto entzogen. In bestehenden Bestellungen bleibt das Dienstkonto als Ersteller erhalten.

Dienstkonten können keine E-Mails zur Passwortzurücksetzung erhalten, keine Einladungen zu einem anderen Konto annehmen und nicht zur Anmeldung im Backoffice verwendet werden. Sie erhalten keine Benutzer-Newsletter oder E-Mails zu Produktänderungen. Für bestehende Integrationsbenutzer ändert sich nichts; stimmen Sie eine etwaige Migration bitte mit dem Verantwortlichen für den Konnektor ab, damit die aktuelle Verbindung weiterhin funktioniert.