
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.