# So verbinden und koppeln Sie Salto GT7-Terminals mit Salto XS4 Face
> Verbinden Sie Salto GT7-Terminals mit einem XS4 Face-Standort, koppeln Sie jedes Terminal mit dem XS4 Face Server im Gantner-Portal und registrieren Sie GT7-User für die Gesichtserkennung.


Verwenden Sie die GT7-Integration, um Salto GT7-Terminals zu einem XS4 Face-Standort hinzuzufügen.
Jedes GT7-Terminal ist mit dem XS4 Face Server gekoppelt und dient als Kontrollpunkt, der Gesichtserkennung verwendet.
Sie aktivieren die Integration in der XS4 Face Console und konfigurieren jedes Terminal im Gantner-Portal.

**Voraussetzungen**:

- Ein XS4 Face Server am Standort, der online ist.
- Ein GT7-Terminal in Ihrem Projekt im Gantner-Portal und die Berechtigung, dessen Device-Konfiguration zu ändern.
- Eine Netzwerkroute vom GT7-Terminal zum XS4 Face Server.
  Wenn sich das GT7-Terminal in einem anderen Netzwerk als der XS4 Face Server befindet, zum Beispiel im Unternehmensnetzwerk, fügen Sie eine Route hinzu, damit das Terminal den Server erreichen kann.

## GT7-Integration aktivieren {#enable-the-gt7-integration}

1. Wählen Sie in der XS4 Face Console den Standort aus und klicken Sie im linken Bereich auf **Features**.
2. Schalten Sie auf der Kachel **GT7** den Schalter ein.

## GT7-Terminal koppeln {#pair-a-gt7-terminal}

Koppeln Sie alle GT7-Terminals mit dem XS4 Face Server.
Sie müssen die XS4 Face Console und das Gantner-Portal gleichzeitig geöffnet haben.

1. Klicken Sie in der XS4 Face Console auf der **GT7**-Kachel auf das Einstellungssymbol.
   Die GT7-Einstellungen öffnen sich auf der rechts auf der Seite.

2. Klicken Sie auf **Gerät hinzufügen**.
   Es erscheint eine neue Zeile mit dem Status **Commissioning** und einem **Access Token**.

    ![GT7-Einstellungen mit Add Device und dem Access Token eines in der Inbetriebnahme befindlichen Devices](images/xs4face_gt7_add_device.png)
    {.border}

3. Notieren Sie sich das **Access Token** und die oben in den GT7-Einstellungen angezeigte **Server-IP-Adresse (IPv4)**.

4. Öffnen Sie im Gantner-Portal Ihr Projekt, wählen Sie **Devices** und dann das GT7-Terminal.

5. Wählen Sie in den Device-Informationen unter **Device configuration** die Option **XS4 Face**.

    ![Device-Konfiguration im Gantner-Portal mit der XS4 Face-Option](images/xs4face_gt7_gantner_device_configuration.png)
    {.border}

6. Wählen Sie **Gesichtserkennung aktivieren**.

7. Geben Sie unter **Server address** die **Server-IP-Adresse (IPv4)** aus der XS4 Face Console ein.

8. Geben Sie unter **Kopplungscode** das **Access Token** aus der XS4 Face Console ein.

9. Klicken Sie auf **Erzeuge Schlüssel**.

    ![XS4 Face-Einstellungen im Gantner-Portal mit Enable facial recognition, Server address und Pairing code](images/xs4face_gt7_gantner_xs4face_settings.png)
    {.border}

10. Überprüfen Sie in der XS4 Face Console, ob in den GT7-Einstellungen die MAC-Adresse des Terminals mit dem Status **Ready** angezeigt wird.

    ![GT7-Einstellungen mit einem gekoppelten Terminal im Status Ready](images/xs4face_gt7_device_ready.png)
     {.border}

Jedes **Access Token** funktioniert für ein Terminal.
Um ein weiteres GT7-Terminal zu koppeln, klicken Sie erneut auf **Add Device** und wiederholen Sie diese Schritte.
Um ein Terminal aus XS4 Face zu entfernen, klicken Sie in seiner Zeile auf **Löschen**.

## GT7 Benutzer anlernen (Enrollment) {#enroll-gt7-users}

Wenn die GT7-Integration aktiviert ist, verfügt die **Enrollments**-Seite über einen **GT7 Enrollments**-Tab.

1. Klicken Sie im linken Bereich auf **Enrollments** und wählen Sie dann den **GT7 Enrollments**-Tab aus.
2. Klicken Sie auf **Enroll User**.
3. Gib die **E-Mail-Adresse** des Benutzers ein.
   Geben Sie optional die **User-ID** des Users im GT7-System mit bis zu 8 Hexadezimalzeichen ein.
4. Klicken Sie auf **Senden**.

Wenn **Send enrolment emails** aktiviert ist, sendet XS4 Face dem User eine E-Mail mit einem Link zur Registrierung seines Gesichts im XS4 Face Enrollment Service.

Wenn die Standortlizenz abgelaufen ist oder der Standort sein **User-Limit** erreicht hat, zeigt die XS4 Face Console **Error enrolling user: License Error** an und registriert den User nicht.
Informationen zur Verlängerung der Lizenz oder Erhöhung des User-Limits finden Sie unter [Licensing](/xs4face/user-guide/systems-admin/licensing).

## Enrollment-E-Mails {#gt7-enrollment-emails}

Standardmäßig sendet XS4 Face eine Registrierungs-E-Mail an jeden User, den Sie für GT7 registrieren.
Um den Versand dieser E-Mails zu stoppen, schalten Sie **Send enrolment emails** in den **Feature Details** der GT7-Einstellungen aus und bestätigen Sie dies.

![GT7 Feature Details mit der Einstellung Send enrolment emails](images/xs4face_features_gt7_details.png)
{.border}

## Benutzer-Enrollment durch Dritte {#third-party-user-enrollment}

GT7-Standorte verwenden häufig ein Mitgliedschaftsverwaltungssystem (MMS) von einem Drittanbieter-Integrator, wie etwa ein Fitnessstudio- oder Spa-Managementsystem, um ihre Mitglieder zu verwalten.
Zugelassene Integratoren können ihr MMS mit XS4 Face verbinden, sodass das MMS verwaltet, welche Mitglieder die Gesichtserkennung verwenden können, anstatt dass Sie jeden User in der XS4 Face Console registrieren.
Gantner verwaltet diese Integrationen.

### Funktionsweise {#how-third-party-enrollment-works}

1. Das MMS fügt dem XS4 Face-Standort ein Mitglied mit der E-Mail-Adresse des Mitglieds und der User-ID hinzu, die das GT7 für dieses Mitglied verwendet.
2. Das Mitglied registriert sein Gesicht, akzeptiert die Nutzungsbedingungen und erteilt die Zustimmung für den Standort.
3. XS4 Face leitet die Registrierung des Mitglieds an den XS4 Face Server am Standort weiter.
4. Wenn das Mitglied sein Gesicht einem XS4 Face Device präsentiert, sendet das Device die User-ID des Mitglieds an das GT7-Terminal, mit dem das Device gekoppelt ist.
5. Das GT7-Terminal sendet eine Zugriffsanfrage für diese User-ID an das MMS, das den Zugriff gewährt oder verweigert.
6. Wenn eine Mitgliedschaft endet, entfernt das MMS das Mitglied aus XS4 Face und das Mitglied wird nicht mehr erkannt.

Das MMS kann auch den Registrierungsstatus jedes Mitglieds anzeigen, beispielsweise ob es noch ein Bild einreichen oder die Zustimmung erteilen muss.
Mitglieder können ihre Zustimmung jederzeit widerrufen, wodurch sie aus XS4 Face entfernt werden.

### Integrationsstufen {#integration-levels}

Es gibt zwei Integrationsstufen:

| Stufe                                                 | Was der Integrator bereitstellt                                                                                                       | Wie Mitglieder sich anlernen (Enrollment)                                                                                                                                                            |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Level 1**: \*\*Benutzerverwaltung                   | Das MMS fügt Mitglieder in XS4 Face hinzu, aktualisiert, fragt ab und entfernt sie.                                                   | Mitglieder erhalten eine Registrierungs-E-Mail und registrieren sich beim XS4 Face Enrollment Service.                                                                                               |
| **Level 2**: Registrierung in der App des Integrators | Wie Level 1, plus die eigene App des Integrators führt Mitglieder durch die Registrierung, versehen mit dem Branding des Integrators. | Mitglieder registrieren sich in der App des Integrators, die die Annahme der Nutzungsbedingungen, ein Live-Bild und ihre Zustimmung erfasst. XS4 Face überprüft weiterhin die Qualität jedes Bildes. |

### Eine Anlage für einen Integrator einrichten {#set-up-a-site-for-an-integrator}

Einrichtung einer Anlage, die einen zugelassenen Integrator verwendet:

1. Geben Sie den **Firmennamen** und die **Datenschutzrichtlinie** für die Anlage ein.
   Mitglieder sehen diese, wenn sie ihre Zustimmung erteilen.
   Weitere Informationen finden Sie unter [XS4 Face Enrollment Service](/xs4face/user-guide/systems-admin/features/enrollment-service).
2. [Aktivieren Sie die GT7-Integration](#enable-the-gt7-integration), [koppeln Sie jedes GT7-Terminal](#pair-a-gt7-terminal) und koppeln Sie jedes XS4 Face Device mit dem GT7-Terminal an derselben Tür als Kontrollpunkt.
3. Kopieren Sie in den **Feature Details** der GT7-Einstellungen die **Feature ID** und geben Sie diese an den Integrator weiter.
   Das MMS verwendet die Feature-ID, um die Mitglieder dieser Anlage zu verwalten.
4. Schalten Sie für eine Level-2-Integration [**Send enrolment emails**](#gt7-enrollment-emails) aus, damit sich Mitglieder in der App des Integrators registrieren, anstatt eine E-Mail zu erhalten.

### Integrator werden {#become-an-integrator}

Wenn Sie ein Mitgliedschaftsverwaltungssystem entwickeln und es in XS4 Face integrieren möchten, wenden Sie sich an das Gantner-Integrationsteam unter `integrations@gantner.com`.
Gantner stellt Entwicklungsanmeldeinformationen, eine Testumgebung sowie die Integrationsdokumentation bereit und genehmigt jede Integration, bevor sie an Kundestandorten verwendet werden kann.

