> For the complete documentation index, see [llms.txt](https://docs.enginsight.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enginsight.com/docs/manual/administration/einstellungen/sms-gateway.md).

# SMS-Gateway (BETA)

{% hint style="warning" %}
**Bitte beachte**: Diese Ansicht befindet sich im **Beta-Status**. Benutzeroberfläche und Funktionalitäten können sich jederzeit ändern.

<i class="fa-eye">:eye:</i> Diese Ansicht ist nur sichtbar, wenn du die Option **Beta-Funktionalitäten aktivieren** unter Einstellungen → [Benutzerkonto](https://docs.enginsight.com/docs/manual/administration/einstellungen/benutzerkonto.md#erweiterte-einstellungen) aktiviert hast.
{% endhint %}

***

Die Einrichtung eines SMS-Gateways ist notwendig, damit du bspw. SMS-Benachrichtigungen über Alarme oder für die Zwei-Faktor-Authentifizierung erhalten kannst.

***

## Wichtige Hinweise

**Legacy-Konfiguration**

* Wenn du für deine Organisation bereits ein SMS-Gateway in der Enginsight Konfigurationsdatei auf dem Applikationsserver konfiguriert hast, bleibt diese Konfiguration als Fallback-Option bestehen.

{% hint style="success" icon="lightbulb" %}
Mehr Informationen zur Legacy-Funktionalität findest du in unserer Knowledge Base: [Wie konfiguriere ich in Enginsight den Versand von SMS-Benachrichtigungen bei Alarmen (Legacy)?](https://docs.enginsight.com/docs/knowledge-base/alarme/wie-konfiguriere-ich-in-enginsight-den-versand-von-sms-benachrichtigungen-bei-alarmen)
{% endhint %}

**Vererbung von SMS-Gateway-Konfigurationen**

* [Administratororganisationen](https://docs.enginsight.com/docs/manual/administration/organisationsmanagement.md#administratororganisation) können eine SMS-Gateway-Konfiguration als globale Standard-Konfiguration bestimmen. Dies bedeutet, dass die entsprechende Konfiguration global auf alle verwalteten Organisationen angewendet wird.
* Wenn für eine Organisation keine eigene SMS-Gateway-Konfiguration hinterlegt ist, erbt sie grundsätzlich die Einstellungen der übergeordneten Organisation. Ist auch dort keine Konfiguration hinterlegt, wird die globale Standard-Konfiguration verwendet.

***

## Neue SMS-Gateway-Konfiguration erstellen

<i class="fa-compass">:compass:</i> Navigiere zu **Einstellungen** → **SMS-Gateway**, um ein SMS-Gateway für Enginsight zu konfigurieren.

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FQ0jisF2oqgnI6a5kXMXk%2FEnginsight-Einstellungen-SMS%20Gateway-Startseite.jpg?alt=media&amp;token=0a8ee967-e7b1-4882-b13a-42e253819a47" alt=""><figcaption></figcaption></figure>

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Konfiguration hinzufügen**, um ein dediziertes SMS-Gateway für die Organisation, in der du dich gerade befindest, einzurichten.

{% hint style="warning" %}
**Bitte beachte**: Die Einrichtung einer dedizierten SMS-Gateway-Konfiguration überschreibt alle Einstellungen, die für eine übergeordnete Organisation oder global vorgenommen wurden.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Bearbeiten**, wenn du über diese Ansicht bereits einen E-Mail-Server eingerichtet hast und deine Einstellungen bearbeiten möchtest.

Es öffnet sich der [Einstellungsassistent](#einstellungsassistent).

***

## Einstellungsassistent

Die SMS-Gateway-Einstellungen bestehen aus vier Schritten, durch die dich der Einstellungsassistent führt:

{% columns %}
{% column width="33.33333333333333%" %}

<div align="left"><figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FCurMdNwPFn2ckFnMbCMi%2FEnginsight-Einstellungen-Email%20Server-Einstellungsmenu%CC%88.jpg?alt=media&amp;token=0d3b731a-4350-4915-9122-3a24fdb29716" alt=""><figcaption></figcaption></figure></div>
{% endcolumn %}

{% column width="66.66666666666667%" %}

* [Anbieter](#schritt-1-anbieter)
* [Verbindung](#schritt-2-verbindung)
* [Erweiterte Einstellungen](#schritt-3-erweiterte-einstellungen)
* [Übersicht](#schritt-4-ubersicht)
  {% endcolumn %}
  {% endcolumns %}

<i class="fa-compass">:compass:</i> Abschnitte, für die du bereits Einstellungen vorgenommen hast, werden pinkfarben markiert. Du hast die Möglichkeit, zwischen diesen Abschnitten auch mittels der Navigationsleiste am linken Rand hin und her zu springen.

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Abbrechen**, um zurück zur Startseite zu navigieren.

{% hint style="danger" %}
**Bitte beachte**: Verlässt du eine Ansicht ohne zu speichern per Klick auf **Abbrechen**, sind alle vorgenommenen Einstellungen verloren und können nicht wiederhergestellt werden!&#x20;
{% endhint %}

***

## Schritt 1: Anbieter

Hier kannst du einen Anbieter für das Versenden von Textnachrichten auswählen.

{% hint style="info" %}
Aktuell kann ausschließlich **Amazon Simple Notification Service (SNS)** als Anbieter ausgewählt werden.
{% endhint %}

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2F6UNmBZMGLp2a5dqBRGWO%2FEnginsight-Einstellungen-SMS%20Gateway-Anbieter.jpg?alt=media&amp;token=faca536d-1ac6-4915-b583-dcb34c98143a" alt=""><figcaption></figcaption></figure>

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Weiter**, um zum nächsten Einstellungsabschnitt zu navigieren.

***

## Schritt 2: Verbindung

Hier kannst du die Verbindung zum SMS-Gateway im Detail konfigurieren.

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FwDnTmvbDkjSdUQfihCjq%2FEnginsight-Einstellungen-SMS%20Gateway-Verbindung.jpg?alt=media&amp;token=96f93e55-4ec0-44c7-bdb0-0cf3fc319534" alt=""><figcaption></figcaption></figure>

### Voraussetzungen

Um den Amazon SNS-Dienst nutzen zu können, musst du zunächst einen AWS IAM-Benutzer mit den benötigten Zugriffsrechten erstellen. Nimm dazu folgende Schritte vor:

1. Melde dich bei deinem AWS-Account an und navigiere zum IAM (Identity and Access Management).
2. Erstelle einen IAM-Benutzer mit Zugriff auf Amazon SNS. Folge dazu der [offiziellen AWS-Dokumentation](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html).

{% hint style="warning" %}
**Bitte beachte**: Enginsight übernimmt keine Gewähr für die Inhalte und Aktualität der Dokumentation von Drittanbietern.
{% endhint %}

3. Erstelle für den neuen Benutzer einen Zugriffsschlüssel (**Access Key**), der Zugriff auf Drittanbieter-Software gewährt. Diesen Access Key sowie den zugehörigen **Secret Access Key** benötigst du für die Konfiguration des SMS-Gateways.

### Verbindung

Lege die AWS-Region fest, von der aus deine Amazon SNS-Instanz Nachrichten versenden soll. Eine Übersicht über alle verfügbaren AWS-Regionen findest du in der [offiziellen AWS-Dokumentation](https://docs.aws.amazon.com/de_de/general/latest/gr/end-user-messaging.html#end-user-messaging_region).

{% hint style="warning" %}
**Bitte beachte**: Enginsight übernimmt keine Gewähr für die Inhalte und Aktualität der Dokumentation von Drittanbietern.
{% endhint %}

<div align="left"><figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2F7eUYvn12oUvlAOizTh6z%2FEnginsight-Einstellungen-SMS%20Gateway-Verbindung-Region.jpg?alt=media&amp;token=450ba4f9-1f0f-44a6-99f6-058cbfb85523" alt=""><figcaption></figcaption></figure></div>

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Feld **AWS-Region**, um eine Liste aller verfügbaren AWS-Regionen zu öffnen, und wähle eine Region aus. Oder nutze die Freitexteingabe, um Regionen in der Liste schneller zu finden.

{% hint style="info" %}
Die standardmäßig ausgewählte Region ist **eu-central-1**.
{% endhint %}

### Authentifizierung

Hier kannst du festlegen, wie die Anmeldung beim angegebenen SMS-Gateway-Anbieter erfolgen soll.

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FnuuIxt7FGNbHrXqoqPmC%2FEnginsight-Einstellungen-SMS%20Gateway-Verbindung-Authentifizierung.jpg?alt=media&amp;token=a8d8e08c-48a2-4ef7-b648-998378518660" alt=""><figcaption></figcaption></figure>

Folgende Optionen stehen zur Verfügung:

<table><thead><tr><th width="200.1953125">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Access-Key-ID</td><td>Gib den Access Key an, den du für deinen neuen IAM-Benutzer erstellt hast.</td></tr><tr><td>Secret-Access-Key</td><td>Gib den Secret Access Key an, der für deinen neuen IAM-Benutzer erstellt wurde.</td></tr><tr><td>Absenderkennung</td><td>Gib den Absender ein, der auf dem mobilen Endgerät angezeigt wird. Dieser wird von AWS automatisch auf 11 Zeichen gekürzt.</td></tr></tbody></table>

### Verbindung testen

{% hint style="danger" %}
**Bitte beachte**: Für einen erfolgreichen Verbindungstest musst du eine Mobiltelefonnummer in der Enginsight-Plattform unter **Einstellungen** → [Benutzerkonto](https://docs.enginsight.com/docs/manual/administration/einstellungen/benutzerkonto.md) hinterlegt haben.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Verbindung testen**, um zu überprüfen, um mit den angegebenen Verbindungs- und Authentifizierungsdaten eine Verbindung zum SMS-Gateway-Anbieter aufgebaut werden kann. Es öffnet sich das Fenster **Verbindung testen**.

<div align="left"><figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FhXELF7pcdXrWbDGx466r%2FEnginsight-Einstellungen-SMS%20Gateway-Verbindung%20testen.jpg?alt=media&amp;token=4863ba59-3941-4e47-91e5-85738f1dad57" alt=""><figcaption></figcaption></figure></div>

<i class="fa-computer-mouse">:computer-mouse:</i> Setze einen Haken in die Checkbox <i class="fa-square">:square:</i> neben **Tests-SMS senden (optional)**, um eine Tests-SMS an die angegebene Mobiltelefonnummer zu senden. Entferne den Haken aus der Checkbox <i class="fa-square-check">:square-check:</i> um die Verbindung ohne das Senden einer Tests-SMS zu testen.&#x20;

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Verbindung testen**, um den Verbindungstest zu starten und optional eine Tests-SMS zu versenden.&#x20;

{% hint style="warning" %}
**Bitte beachte**: Der Test erfolgt mit den Verbindungs- und Authentifizierungsdaten, die du zuvor angegeben hast, auch wenn du diese noch nicht gespeichert hast. Wenn du Zugangsdaten bei deinem Anbieter neu angelegt hast, kann es mitunter einige Minuten dauern, bis diese greifen. Sollte der Verbindungstest daher fehlschlagen, wiederhole ihn etwas später erneut.
{% endhint %}

Sollte der Verbindungstest fehlschlagen, hast du folgende Möglichkeiten:

* Lies die Informationen, die im Fenster **Details** angezeigt werden, um herauszufinden, warum die Verbindung nicht hergestellt werden konnte.
* <i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Wiederholen**, um den Test mit denselben Einstellungen erneut durchzuführen.
* <i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Zurück**, um die Einstellungen noch einmal zu überprüfen und gegebenenfalls anzupassen.

<i class="fa-computer-mouse">:computer-mouse:</i>  Klicke auf **Weiter**, wenn der Verbindungstest erfolgreich war, um zum nächsten Einstellungsabschnitt zu navigieren.

***

## Schritt 3: Erweiterte Einstellungen

Hier kannst du optional das SMS-Gateway als globale Standardkonfiguration einrichten.

{% hint style="warning" %}
**Bitte beachte**: Nur eine [Administratororganisation](https://docs.enginsight.com/docs/manual/administration/organisationsmanagement.md#administratororganisation) kann eine globale Konfiguration festlegen.
{% endhint %}

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2F5ewN0wSW25iVE2gWbWrs%2FEnginsight-Einstellungen-SMS%20Gateway-Erweiterte%20Einstellungen.jpg?alt=media&amp;token=a542010d-80bb-4b71-b6e5-ebd86859259b" alt=""><figcaption></figcaption></figure>

### Globale Konfiguration

<i class="fa-computer-mouse">:computer-mouse:</i> Setze einen Haken in die Checkbox <i class="fa-square">:square:</i> neben **SMS-Gateway-Konfiguration global verwenden**, um die Option zu aktiveren. Entferne den Haken aus der Checkbox <i class="fa-square-check">:square-check:</i> um die Option zu deaktivieren.

{% hint style="info" %}
Wenn für eine Organisation keine eigene SMS-Gateway-Konfiguration hinterlegt ist, erbt sie grundsätzlich die Einstellungen der übergeordneten Organisation. Ist auch dort keine Konfiguration hinterlegt, wird die globale Konfiguration verwendet.
{% endhint %}

***

## Schritt 4: Übersicht

Hier findest du zusammenfassend eine Übersicht über alle Einstellungen, die du vorgenommen hast. Du kannst alle eingegebenen Daten noch einmal prüfen und deine Einstellungen speichern.

<figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FkpM2Vqvok6sVaZJmN2el%2FEnginsight-Einstellungen-SMS%20Gateway-Uebersicht.jpg?alt=media&amp;token=7e458860-e5a8-4444-9856-6061b079552c" alt=""><figcaption></figcaption></figure>

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Änderungen speichern**, nachdem du alle vorgenommenen Einstellungen überprüft hast, um die SMS-Gateway-Konfiguration zu speichern.&#x20;

{% hint style="danger" %}
**Bitte beachte**: Verlässt du diese Ansicht, ohne zu speichern, sind alle vorgenommenen Einstellungen verloren und können nicht wiederhergestellt werden!
{% endhint %}

***

## Weitere Ressourcen

**Knowledge Base**

* [Wie konfiguriere ich in Enginsight den Versand von SMS-Benachrichtigungen bei Alarmen (Legacy)?](https://docs.enginsight.com/docs/knowledge-base/alarme/wie-konfiguriere-ich-in-enginsight-den-versand-von-sms-benachrichtigungen-bei-alarmen)
* [Wie richte ich in Enginsight eine Hauptorganisation als Administratororganisation ein?](https://docs.enginsight.com/docs/knowledge-base/konfiguration/wie-richte-ich-in-enginsight-eine-hauptorganisation-als-administratororganisation-ein)

***
