Zum Hauptinhalt springen
Zurück zum Konnektorkatalog

Konnektor

HaloPSA

Ein einziger Zugang auf Agenturebene, für das gesamte Portfolio.

Ihre PSA kennt bereits die Liste Ihrer Kunden: Dieser Connector importiert sie und meldet anschließend für jeden das Asset-Inventar, deren Identifikation und den technisch Verantwortlichen. Er schlägt keine ReCyF-Stufe vor. HaloPSA erfasst kein Sicherheitsmaß zu Assets.

01

Was im Werkzeug anzulegen ist

Der Zugang wird in HaloPSA angelegt, nicht in Vigicap. Vigicap fragt nie nach dem Passwort eines Administrators: Es erwartet API-Zugangsdaten, die Sie anlegen, die Sie sehen und die Sie ohne uns widerrufen können.

Wo er erzeugt wird

HaloPSA > Configuration > Integrations > Halo API : créez une application « Client Credentials », puis, sur son onglet « Permissions », cochez uniquement « read:customers » et « read:assets ». Si la même application sert aussi à la remontée de tickets, ajoutez-y « read:tickets » et « edit:tickets ».

Minimale Rolle

Application API « Client Credentials » portant exactement deux permissions, toutes deux en lecture : « read:customers » (GET /Client, la liste des clients) et « read:assets » (GET /Asset, l'inventaire). Aucune permission d'écriture, et pas le scope « all ».

Dem Rollenmodell des Herstellers entnommen und vor der Veröffentlichung geprüft.

02

Was in Vigicap einzutragen ist

Die genauen Felder des Verbindungsformulars, in der Reihenfolge ihres Erscheinens. Als „geheim“ markierte Werte gelangen nie zurück in den Browser: Sie werden verschlüsselt gespeichert und beim Trennen gelöscht.

Das Formular beginnt mit der Adresse der Instanz, getrennt von den Feldern unten eingetragen. Der öffentliche Katalog veröffentlicht bislang nicht, ob dieser Konnektor eine braucht und wie sie aussieht — diese Liste ist also für alles Übrige genau und zu diesem ersten Feld stumm.

  • Client ID
  • Client Secretgeheim
  • URL du serveur d'authentificationoptionalURL

    Uniquement si votre installation sépare l'authentification de l'API. Sinon, laissez vide.

03

Routing pro Kunde

Der Zugang selbst wiederholt sich nicht: ein einziger, einmal auf Agenturebene eingetragen, deckt das gesamte Portfolio ab — der Unterschied, den man bei vierzig Kunden spürt und bei vier nicht.

Diese Felder werden pro Kunde ausgefüllt: Sie sagen, unter welchem PSA-Konto das Ticket landen soll. Ein falscher Wert lässt den Versand nicht scheitern — er lässt ihn bei jemand anderem gelingen, weshalb Vigicap sie bereits beim Eintragen prüft.

  • Halo-Kunden-ID

    Kundenkennung in HaloPSA, unter der Tickets erstellt werden.

    z. B. 42

  • Ticket-Typ-IDoptional

    Optional — Halo-Tickettyp (Standard: Standardtyp der Instanz).

    z. B. 1

04

Was er tut und was er nicht tut

Vorbefüllte ReCyF-Ziele

Dieser Konnektor speist kein ReCyF-Ziel, und das ist keine Lücke: Er misst die Lage eines Kunden nicht.

Nur lesend

Die Lesevorgänge sind rein lesend: Vigicap schreibt beim Lesen nichts in das Werkzeug.

Was zum Werkzeug hinausgeht

Dieser Konnektor SCHREIBT: Er erzeugt aus einer Maßnahme des Plans ein Ticket.

Was zurückkommt

Zurück kommt der Zustand eines bereits erstellten Tickets: Status, Schließdatum, letzte Aktivität. Ein geschlossenes Ticket wird zu einem VORSCHLAG, den eine Beraterin oder ein Berater bestätigt — nie zu einer von selbst geschlossenen Maßnahme. Eine Agentur, die ihr eigenes Ticket schließt, darf sich nicht selbst in dem Dokument benoten, das eine Prüferin liest.

Was gelesen wird, was aufbewahrt wird, wie lange und mit welchen Rechten: dasselbe Verzeichnis, Konnektor für Konnektor, im Datenverzeichnis.

Angeforderte Berechtigungen

Die bei der Autorisierung genau angeforderten Scopes, so benannt, wie der Hersteller sie benennt.

  • read:customers
  • read:assets
  • read:tickets
  • edit:tickets

Überprüfung

Dieser Konnektor wurde durchgängig gegen eine echte Instanz des Werkzeugs ausgeführt, nicht nur gegen eine Simulation getestet.

Die genannten Marken und Logos gehören ihren jeweiligen Inhabern und kennzeichnen die Tools, mit denen Vigicap kompatibel ist — siehe das Impressum.