Beschreibung:

In dieser Anleitung wird beschrieben, wie Du die servereye Cevisio-Anbindung mit einem API-Key und einem Bucket durchführst.


INHALTSVERZEICHNIS



Hauptfunktionsübersicht

Folgende Hauptfunktionen sind vorhanden:

  • Abgleich von IT-Inventardaten
    • Hinterlegen von pcvisit- und TeamViewer-IDs an den Geräten in cevisio sofern verfügbar (deaktivierbar) → Optimal in Verbindung mit TeamViewer und/oder pcvisit Schnittstelle
  • Abgleich von Softwareliste zusätzlich zu den IT-Inventardaten (deaktivierbar)
  • Automatische Erstellung von Tickets anhand von Alerts (deaktivierbar)
  • Automatische Erstellung von Tickets und abrechenbaren Leistungen für "Self-Healing" Sensoren (Dienst Neustart) (deaktivierbar)
  • Aufrufen von Sensorhubs direkt aus dem cevisio IT-Inventar



Anlegen von User, API-Key und Bucket bei servereye

In Abhängigkeit der gewünschten Features müssen unterschiedliche Konfigurationen getätigt werden.



Benutzeranlage

Grundlegend muss immer ein separater servereye-Benutzer angelegt werden:


  1. Erstelle einen entsprechend neuen Benutzer, orientiere Dich dazu an folgender Anleitung: Dokumentation - Benutzerverwaltung
  2. Der Benutzer sollte folgende Rollen zugewiesen bekommen:
    Hinweis:
    Sofern die Ticketerstellung nicht genutzt werden soll, kann der Haken bei Rolle "Supporter" entfernt werden.
  3. Unter "Sicherheit" noch eine E-Mail-Adresse (fiktive Mail genügt) und ein Passwort für den User vergeben. Das ist notwendig, da wir unter dieser Benutzeranmeldung einen API-Key erstellen wollen. Dessen Berechtigungen leiten sich von den Berechtigungen des Benutzers ab. Sofern gewünscht kann natürlich gerne 2FA aktiviert werden. 
  4. Unter "Verwaltete Kunden" sollten nun noch alle gewünschten Kunden hinterlegt werden. Das ist ebenso zu berücksichtigen, sofern neue Kunden angelegt werden!



API-Key-Erstellung

  1. Log Dich mit dem gerade erstellen Benutzer in einer zusätzlichen OCC Session ein.
  2. Erstelle jetzt einen API-Key mit diesem Benutzer. Orientiere Dich dazu an folgender Anleitung: Dokumentation - API Keys
  3. Nenne den API-Key bspw. "cevisioapi".



Bucket-Erstellung

Falls automatisch Tickets erstellt werden sollen, muss ein Bucket angelegt werden. Dies sollte unter dem administrativen Benutzer erfolgen, welcher sich zu Beginn dieses Prozesses eingeloggt hat, um den User zu erstellen.


  1. Wie Buckets erstellt werden, kannst Du hier nachlesen: Best Practice - Buckets
  2. Nenne den Bucket bspw. "cevisio".
  3. Füge dem Bucket den zuvor erstellten OCC Benutzer hinzu!
  4. Die schlussendlich angezeigte Bucket ID muss dann an cevisio übermittelt werden.



Mapping/Zuordnungsdaten hinterlegen  

Damit eine Zuordnung zwischen den servereye-Kunden und den cevisio-Kunden hergestellt werden kann, MUSS ein benutzerdefiniertes Feld an jedem Kunden in servereye hinterlegt werden.


Dieses benutzerdefinierte Feld (Schlüssel) lautet stets: "cevisioCustomerNumber" und muss als Wert die Kundennummer des Kunden aus cevisio enthalten!


Sofern ein neuer Kunde angelegt wird, muss dies ebenso stets berücksichtigt werden!


Beachte:
Sobald eine ungültige Kundennummer hinterlegt ist, wird dieser Kunde übersprungen. Leere Felder oder Felder mit Buchstaben werden automatisch ignoriert.


  1. Wechsle in die Kundeneinstellungen innerhalb der Systemhauseinstellungen. Wähle hier "Editieren":
  2. Wähle jetzt "Benutzerdefinierte Felder" und gebe Schlüssel und Wert wie o.s. an:



Weitere Features

Sofern die jeweilige Funktionalität gewünscht ist, können folgende weitere Features eingerichtet werden.



Anlegen von Tag für Self-Healing "Dienst Neustart"

  1. Erstelle einen neuen Tag anhand folgender Anleitung: Dokumentation - Tags
  2. Nenne den Tag bspw. "cevisioSelfHealingTicket".
  3. Sobald das Tag besteht, kann es an Sensorhubs mit angelegtem "Dienst Neustart" Sensor hinterlegt werden.


Diese Möglichkeit wird zum einen aus Performancegründen und zum anderen aus Steuerungsgründen gegeben.

So werden nämlich nicht standardmäßig alle Dienst Neustart-Sensoren berücksichtigt, obwohl nur für ganz bestimmte Systeme mit diesen Sensoren ein Ticket und entsprechende Leistungen generiert werden sollen.


Anlegen von Alarmierungen zur Ticketerstellung

Alarmierungen können in servereye pro Sensorhub und Sensor hinterlegt werden. Sie können auch in Templates hinterlegt und per Massenanpassung hinzugefügt werden. So kann genau in servereye gesteuert werden, aus welchen Alarmen Tickets erzeugt werden.


Im Bearbeitungsmenü eines Sensors oder eines Systems/Sensorhubs muss eine Alarmierung dann wie folgt hinterlegt werden: