1. Start
  2. /
  3. Docs
  4. /
  5. Amagno App
  6. /
  7. Erste Schritte
  8. /
  9. Anmelden und Abmelden
  10. /
  11. Verbindung zu einem Amagn...

Verbindung zu einem Amagno Server

Die Verbindung mit einem anderen Amagno Service bedarf klarer Voraussetzungen. Dieser Artikel informiert und hilft bei einer Fehleranalyse.

Die App wird derzeit nicht auf einem On Premise-System mit ausgeliefert und muss über das Internet auf den App Server zugreifen.

Die App verfügt über die Möglichkeit, sich mit einem Amagno Server zu verbinden, der den Voraussetzungen entsprechend. 

Wichtig: Die App erfordert immer die aktuellste verfügbare On Premise-Version, da die App zentral im Internet bereitgestellt wird und diese die aktuellste Rest-API erfordert. Wenn Sie die App für Ihren On Premise-Server benutzen möchten, müssen zwangsläufig die aktuellsten Updates der On Premise-Version installiert sein (Updatevertrag vorausgesetzt).

Klicken Sie unten auf die Verbindungslasche (A). Es erscheint der Dialog Verbindungen.

Geben Sie in die Eingabezeile Hinzufügen (B) die aus dem Internet erreichbare Serveradresse an, die auf die Instanz des IIS (Internet Information Server) des Amagno Servers verweist. Darüber muss die API des Amagno Servers gemäß einer Standardinstallation erreichbar sein (Siehe Serverdokumentation).

Beispiel:

Im Unternehmen ist die notwendige API auf dem Amagno Server mit einer internen IP xxx.xxx.xxx.xxx erreichbar unter https://xxx.xxx.xxx.xxx/amagnome/api/internal. Für den Zugriff aus dem Internet muss der Server derzeit über eine externe IP Adresse (ggf. ein Domain) erreichbar sein.

Nur die interne IP xxx.xxx.xxx.xxx ist damit die Verbindungs-URL, die in das Eingabefeld von Hinzufügen (B) eingetragen wird. Der Rest der URL wird von der App automatisch zusammengesetzt. Drücken Sie danach die Enter/Return-Taste und Amagno startet den Verbindungsaufbau.

Prüfen Sie zuerst von außerhalb des Unternehmens, ob die URL mit der externen URL/Domain über einen Browser erreichbar ist, also https://xxx.xxx.xxx.xxx/amagnome/api/internal. Hier sollte die API Dokumentation via Swagger erscheinen. Ist der Aufruf erfolglos, wenden Sie sich bitte an Ihren Systembetreuer, denn die Ursachen können zahlreich sein und liegen außerhalb eines Supports durch Amagno oder einen Amagno Partner.

Die Verbindung wird nach einer erfolgreichen Anmeldung auf dem aktuellen Gerät in Auswählen (C) gespeichert. Die Verbindung kann in der Verbindungsübersicht (C) gewechselt oder gelöscht werden.

Voraussetzungen

Diese Voraussetzungen sind alle für eine erfolgreiche Verbindung zu einem Amagno Server notwendig:

  • Die Anmeldung als Benutzer erfordert aktuell einen Nicht-AD Benutzer. Eine Unterstützung von Azure Active Directory Usern ist geplant
  • Die aktuellste Amagno On Premise Version (Siehe Server-Download)
  • Die aktuellste Amagno.App Version (Siehe https://amagno.de/apps)
  • Der Amagno Server ist gem. Serverdokumentation im Standard installiert (so dass /amagnome/api/internal via Browser erreichbar ist)
  • Der Server ist aus dem Internet erreichbar
  • Die Verbindung zum Server aus dem Internet ist via HTTPS verschlüsselt

Die App unterscheidet zwischen einer nicht erzeugbaren Verbindung und der Prüfung einer kompatiblen Version. Ist die Verbindung erfolgreich, aber die Version nicht aktuell oder passend, wird eine entsprechende Meldung zur unpassenden Version angezeigt.

Problembehandlung

Ursachen für einen nicht erfolgreichen Verbindungsaufbau können sein:

  • Mindestens eine der genannten Voraussetzungen ist nicht erfüllt
  • Firewall oder Router blockieren die Verbindung
  • Der Amagno Server ist nicht im Standard installiert und konfiguriert, so dass die App eine abweichende URL nicht zusammensetzen kann
  • Die API ist vom Systembetreuer entfernt worden

Sollte die Lösung so nicht erfolgreich sein, kann der Amagno Support im Rahmen einer kostenpflichtigen Dienstleistungen unterstützen und dies analysieren. Starten Sie dazu bitte ein Serviceticket im Amagno Service Desk.

Amagno nimmt grundsätzlich nur solche Supportanfragen zu Verbindungsschwierigkeiten an, bei denen die genannten Voraussetzungen erfüllt sind.