Thema
Dieser Artikel erklärt, wie man HaloPSA mit NinjaOne SaaS Backup verbindet.
Umgebung
- NinjaOne SaaS Backup:
- HaloPSA
Beschreibung
In diesem Artikel finden Sie die folgenden Anleitungen für die Verbindung mit HaloPSA:
- Vollständige Partnereinrichtung in HaloPSA
- Verbinden Sie sich mit HaloPSA auf dem NinjaOne SaaS Backup Partner Portal
- Erstellen Sie eine neue Organisation, die mit HaloPSA synchronisiert ist
- Vorhandene Organisation mit HaloPSA bearbeiten
- Erstellen eines Agenten mit minimalen Berechtigungen auf HaloPSA
- HaloPSA-Integration widerrufen
Vollständige Partnereinrichtung in HaloPSA
Rollen Erstellung in HaloPSA
- Starten Sie HaloPSA URL. Beachten Sie, dass dies von Partner zu Partner unterschiedlich ist. Für NinjaOne SaaS Backup lautet die URL: https://dropsuite.halopsa.com/
- Melden Sie sich mit Ihren gültigen Anmeldedaten an.
- Navigieren Sie zu Konfiguration > Teams & Agenten > Rollen. Um eine neue Rolle zu erstellen, wählen Sie Neu.
- Vervollständigen Sie die Rolleninformationen
Auf der Registerkarte Details:
- Rollenname: NinjaOne SaaS Backup API Rolle
- Wählen Sie Speichern und dann Bearbeiten.
Auf der Registerkarte Berechtigungen:
- Abschnitt Feature Access:
- Zugriffslevel für Tickets: Wählen Sie Lesen und Ändern.
- Kunden-Zugriffslevel: Wählen Sie Nur Lesen.
- Zugriffslevel für Lieferanten: Wählen Sie Lesen und Ändern.
- Zugriffslevel für Softwarelizenzen: Wählen Sie Lesen und Ändern.
- Abschnitt Fahrkartenberechtigungen:
- Kann neue Tickets hinzufügen: Wählen Sie Ja.
- Können Tickets bearbeiten, die ihnen nicht zugewiesen sind: Wählen Sie Ja.
- Abschnitt Ticket-Typ-Einschränkungen:
- Erlauben Sie die Verwendung aller Tickettypen: Wählen Sie Ja.
- Abschnitt Kundeneinschränkungen:
- Erlauben Sie die Nutzung aller Kunden: Wählen Sie der Einfachheit halber Ja. Wenn Sie den Zugriff nur für bestimmte Kunden, die mit der NinjaOne SaaS Backup-Integration verwendet werden, kontrollieren möchten, wählen Sie Nein. Wählen Sie dann die entsprechenden Kunden in der Dropdown-Liste " Zugängliche Kunden" aus.
- Wählen Sie Speichern.
Erstellung eines Agenten in HaloPSA
- Navigieren Sie zu Konfiguration > Teams & Agenten > Agenten.
- Wählen Sie Neu, um einen neuen Agenten anzulegen.
- Füllen Sie die folgenden Details für den Agenten aus:
Auf der Registerkarte Details:
- Abschnitt Kontodetails:
- Benutzername: Geben Sie NinjaOne SaaS Backup API Agent ein.
- Rollen: Wählen Sie die NinjaOne SaaS Backup API Rolle.
- Wählen Sie Konto aktiv.
- Wählen Sie Ist ein reiner API-Agent.
- Abschnitt Agentendetails:
- Standard-Team: Wählen Sie Kein Standardteam.
- Arbeitszeiten: Wählen Sie Standardarbeitszeiten.
- Abschnitt Genehmigungseinstellungen:
- Clear Kann Rechnungen genehmigen.
- Wählen Sie Speichern.
Einrichtung der Anwendung in HaloPSA
- Navigieren Sie zu Konfiguration > Integrationen > HaloPSA API.
- Wählen Sie Anwendungen anzeigen.
- Wählen Sie Neu, um eine neue Anwendung zu erstellen.
- Geben Sie einen aussagekräftigen Anwendungsnamen ein und stellen Sie sicher, dass das Kontrollkästchen Aktiv aktiviert ist.
- Setzen Sie die Authentifizierungsmethode auf Client-ID und Geheimnis (Dienste).
- Kopieren Sie das Kundengeheimnis und speichern Sie es für spätere Zwecke.
- Setzen Sie den Login-Typ auf Agent.
- Wählen Sie den in den vorherigen Schritten erstellten Agenten aus.
- Wählen Sie auf der Registerkarte Berechtigungen den Berechtigungstyp all:standard.
- Klicken Sie auf " Speichern" und kopieren Sie die Kunden-ID für spätere Zwecke.
Verbinden Sie sich mit HaloPSA auf dem NinjaOne SaaS Backup Partner Portal
- Loggen Sie sich in das NinjaOne SaaS Backup Partner Portal ein.
- Navigieren Sie zum Menü Integration in der linken Navigationsleiste.
Das Integrationsmenü ist für alle Arten von Partnern verfügbar: Distributoren, direkte Wiederverkäufer und Sub-Reseller.
- Wählen Sie Connect auf der HaloPSA-Karte.
- Füllen Sie das Formular mit den korrekten Anmeldedaten aus und wählen Sie dann Nächster Schritt.
- Website-URL: Sie ist zu finden unter Konfiguration > Integrationen > HaloPSO API > API Details (Entfernen Sie /API aus der URL des Ressourcenservers
- Client-ID
- Geheimnis des Kunden
- Nach erfolgreicher Verbindung wird ein Erfolgsbanner angezeigt, und Sie werden zum Formular für die Integrationskonfiguration weitergeleitet. Wenn Sie zur Integrationsseite zurückkehren, wird neben HaloPSA ein Verbunden-Badge angezeigt.
- Füllen Sie alle erforderlichen Felder im Integrationskonfigurationsformular aus, und wählen Sie dann Nächster Schritt. Sie können diesen Schritt überspringen und später zurückkehren, um die Konfiguration abzuschließen
- Möchten Sie die Sitzplatzanzahl mit PSA synchronisieren?
- Ticket-Typ für die Erstellung von Service-Tickets auswählen
- Wählen Sie Ticket-SLA für die Erstellung von Service-Tickets
- Wählen Sie Ticketpriorität für die Erstellung von Service-Tickets
- Nach erfolgreicher Konfiguration der Integration wird der Abschluss durch ein Banner bestätigt. Sie können mit der Organisationszuordnung fortfahren.
Anmerkung: Wählen Sie Integrationskonfiguration zurücksetzen , um das Integrationskonfigurationsformular zu löschen, ohne Ihre HaloPSA-Verbindung zu beeinträchtigen.
Erstellen Sie eine neue Organisation, die mit HaloPSA synchronisiert ist
- Folgen Sie dem Standardverfahren zum Anlegen einer neuen Organisation.
- Nach dem Anlegen der Organisation werden in einem Pop-up alle angeschlossenen Integrationen angezeigt. Wählen Sie im HaloPSA-Abschnitt Verwalten
- Das System leitet Sie zur Seite "Verbindung verwalten" weiter. Wählen Sie Kunden- und Softwarelizenz und wählen Sie dann Verbinden. Die Verbindung wird deaktiviert, wenn die erforderlichen Felder leer sind.
- Nach erfolgreicher Zuordnung erscheint ein grünes Häkchen, und die Schaltfläche Unlink ist zugänglich.
Vorhandene Organisation mit HaloPSA bearbeiten
Sie können die Zuordnung entweder auf der Seite Organisation oder Integration bearbeiten:
Auf der Seite Organisation:
- Wählen Sie die Organisation aus, und wählen Sie dann Integration anzeigen unter der Schaltfläche Kebab.
- Wählen Sie Verwalten im Abschnitt HaloPSA.
- Das System leitet Sie auf die Seite Verbindung verwalten weiter; wählen Sie den Kunden und die Softwarelizenz aus und wählen Sie dann Verbinden.
Auf der Seite Integration:
- Wählen Sie Verbindung verwalten unter der Option HaloPSA.
- Das System leitet Sie zur Seite "Verbindung verwalten" weiter. Wählen Sie den Kunden und die Softwarelizenz aus, und wählen Sie dann Verbinden.
HaloPSA-Integration widerrufen
- Melden Sie sich im NinjaOne SaaS Backup Partner Portal an.
- Navigieren Sie zur Integrationsseite.
- Wählen Sie Option und wählen Sie dann Verbindung widerrufen auf der HaloPSA-Karte.
- Nach erfolgreichem Widerruf zeigt das System dieselbe Seite an, auf der die Schaltfläche Verbinden aktiv ist.
FAQ
Was bedeuten die Fehlerbeschreibungen im Service-Ticket?
Es gibt mehrere Arten von Fehlerbeschreibungen. In der folgenden Tabelle sind die einzelnen Typen mit einer kurzen Erläuterung aufgeführt.
| Fehlerbeschreibung | Erläuterung |
| Die E-Mail-Sicherung ist fehlgeschlagen |
Dieser Fehler deckt die verschiedenen E-Mail-Backup-Fehler, einschließlich:
|
| OneDrive-Sicherung fehlgeschlagen. Verbindung zum Mailserver nicht möglich | Fehlgeschlagener Download oder Anfrage an Microsoft Graph mit Statuscode 404 (Datei nicht gefunden), 429 (Drosselung), 503 (Microsoft-Dienst ist ausgefallen), Verbindungsrücksetzung durch Peer oder Timeout (bezogen auf unseren Rechner oder unser Netzwerk). |
| OneDrive-Sicherung fehlgeschlagen. Authentifizierungsfehler | Fehlerhaftes Download-Element oder Anforderung an Microsoft Graph mit Statuscode 400 (fehlende Parameter/Daten in der Anforderung), 401 (Berechtigung in Bezug auf Benutzer/Konto), 403 (kein Zugriff auf Datei, Bereiche oder Berechtigung in Bezug auf Datei). |
| Hauptanwendung (Global Admin) Token-Autorisierungsfehler wurde erkannt | Dies geschieht, wenn die Hauptkonfiguration der Anwendung aus irgendeinem Grund nicht autorisiert werden kann; sie könnte gelöscht oder die Berechtigung widerrufen worden sein. |
| Hauptanwendung (Global Admin) Token-Autorisierungsfehler ist behoben | Dies geschieht, wenn die Hauptanwendung ihr Problem gelöst und das Autorisierungs-Token zur Fortsetzung des Prozesses erfolgreich generiert hat. |
| Geräte-Token-Autorisierungsfehler wurde entdeckt |
Das Programm hat versucht, den Zugriff mit einem Geräte-Token zu authentifizieren oder zu autorisieren, aber dieser Token war entweder:
Dieses Gerätetoken ist der erste Schritt von OAuth-Flows für jede Anmeldung. |
| Delegated Token Autorisierungsfehler wurde entdeckt |
In Systemen wie Microsoft Graph API oder OAuth 2.0 wird ein delegiertes Token verwendet, wenn:
Dieser Fehler tritt auf, wenn die Erlaubnis nicht erteilt wird, wenn der Benutzer versucht, seine Zustimmung für eine erbetene Erlaubnis zu geben. |
| Sicherungsaufgaben schlagen fehl. Verbindung zum Mailserver nicht möglich | Dieser Fehler tritt auf, wenn das System nicht in der Lage ist, eine Verbindung mit dem Mailserver herzustellen, um alle Aufgaben des Benutzers abzurufen. |
| Sicherungsaufgaben schlagen fehl. Verbindung zur GWS-API aufgrund von Tagesdrosselung nicht möglich | Die Drosselungsgrenze tritt ein, wenn die Google-Aufgaben gesichert werden. Für die NinjaOne SaaS Backup App gibt es ein Limit für den Aufruf der API von Google Task. |
| Sicherungsaufgaben schlagen fehl. Authentifizierungsfehler | Die Aufgabensicherung ist aufgrund einer falschen Kombination von Benutzerdaten fehlgeschlagen. Möglicherweise ist der UPN ungültig, die Kombination der Anmeldedaten ist falsch oder die Berechtigung zur Anmeldung wurde widerrufen. |
| Kontakte sichern schlägt fehl. Verbindung zum Mailserver nicht möglich | Dieser Fehler tritt auf, wenn es ein Problem mit dem System gibt, das versucht, eine Verbindung zum Mailserver herzustellen, um alle Kontakte des Benutzers abzurufen. |
| Kontakte sichern schlägt fehl. Authentifizierungsfehler | Der Fehler bei der Kontaktsicherung ist auf eine falsche Kombination von Benutzerdaten zurückzuführen. Möglicherweise ist der UPN ungültig, die Kombination der Anmeldedaten ist falsch oder die Berechtigung zur Anmeldung wurde widerrufen. |
| Backup-Kalender schlagen fehl. Verbindung zum Mailserver nicht möglich | Dieser Fehler tritt auf, wenn das System nicht in der Lage ist, eine Verbindung zum Mailserver herzustellen, um alle Kalender des Benutzers abzurufen. |
| Backup-Kalender schlagen fehl. Authentifizierungsfehler | Der Kalender-Backup-Fehler tritt aufgrund einer falschen Kombination von Benutzerdaten auf. Möglicherweise ist der UPN ungültig, die Kombination der Anmeldedaten ist falsch oder die Berechtigung zur Anmeldung wurde widerrufen. |
| Archiv scheitert. Authentifizierungsfehler | |
| Backup-Kalender schlagen fehl. GWS-API-Verbindungsfehler | Dieser Fehler tritt auf, wenn die E-Mail, die den Kalender besitzt, inaktiv ist oder die Kalenderfunktion in der Google Workspace Admin-Konsole deaktiviert ist. |
| Kontakte sichern schlägt fehl. GWS-API-Verbindungsfehler | Dieser Fehler tritt auf, wenn die E-Mail, die den Kontakt besitzt, inaktiv ist oder die Kontaktfunktion in der Google Workspace Admin-Konsole deaktiviert ist. |