API-Konfiguration: Aktivieren Sie die XML API und konfigurieren Sie benutzerdefinierte Felder

Verwaltung > API-Konfiguration

API :: Konfiguration

XML-API aktivieren

Sie können die Bomgar XML API aktivieren, sodass Sie Berichte ausführen und Befehle ausgeben können, wie z. B. Start oder Übertragung von Sitzungen von externen Anwendungen aus, sowie die automatische Sicherung Ihrer Softwarekonfiguration.

HTTP-Zugriff auf XML-API zulassen

Hinweis: Diese Funktion ist derzeit nur für Kunden verfügbar, die ein Bomgar-Gerät an ihrem Standort betreiben. Bomgar Cloud-Kunden haben keinen Zugriff auf dieses Feature.

Standardmäßig ist der Zugriff auf die API SSL-verschlüsselt. Sie können jedoch auch einen unverschlüsselten HTTP-Zugang zulassen. Es wird als bewährte Sicherheitsmethode dringend empfohlen, den HTTP-Zugriff nicht zuzulassen.

Hinweis: Diese Option wurde mit 16.1 außer Kraft gesetzt und ist für neue Benutzer nicht verfügbar. Für Benutzer, die von einer älteren Version als 16.1 aktualisieren, ist die Option weiterhin verfügbar, wenn Sie die deaktivierte API-Authentifizierungsmethode mit Benutzerkonto verwenden. Wenn Sie zur bevorzugten Methode der Authentifizierung mit einem API-Konto wechseln, muss der gesamte API-Verkehr über HTTPS erfolgen.

API :: Konten

Ein API-Konto speichert alle Authentifizierungs- und Autorisierungseinstellungen für den API-Klienten. Mindestens ein API-Konto ist erforderlich, um die API zu verwenden, entweder zusammen mit dem Integrations-Client, mit einer Drittanbieter-App oder mit Ihrer intern entwickelten Software.

Hinweis: Vor 16.1 wurde ein Benutzerkonto zur Authentifizierung der API verwendet. Diese Methode wurde außer Kraft gesetzt, obwohl sie zur Abwärtskompatibilität noch immer für Benutzer verfügbar ist, die diese Methode bereits verwenden.

Neues API-Konto erstellen, bearbeiten, löschen

Erstellen Sie ein neues Konto, bearbeiten Sie ein bestehendes Konto oder entfernen Sie ein bestehendes Konto.

API :: Konto :: Hinzufügen oder Bearbeiten

Name

Erstellen Sie einen eindeutigen Namen, um dieses Konto leichter zu identifizieren.

Kommentare

Fügen Sie Kommentare hinzu, die den Zweck dieses Objekts deutlich machen.

Aktiviert

Falls aktiviert, ist dieses Konto zur API-Authentifizierung berechtigt. Wenn ein Konto deaktiviert ist, werden alle mit dem Konto verknüpften OAuth-Tokens sofort deaktiviert.

Berechtigungen

Wählen Sie die API-Bereiche, die dieses Konto verwenden können soll. Wählen Sie für die Befehls-API, ob der Zugriff verweigert, nur schreibgeschützt oder vollständig gewährt werden soll. Legen Sie ebenfalls fest, ob dieses Konto die Berichts-API, die Sicherungs-API und/oder die Endpunkt-Anmeldedaten-Manager-API verwenden kann.

Netzwerkbeschränkungen

Listet Netzwerkadresspräfixe auf, über die sich dieses Konto authentifizieren kann.

Hinweis: API-Konten sind nicht durch die unter /login > Verwaltung > Sicherheit konfigurierten Präfixe beschränkt. Sie sind nur durch die für das API-Konto konfigurierten Netzwerkpräfixe beschränkt.

Authentifizierungseinstellungen

Die OAuth Client-ID und das Client-Secret werden zur Erstellung von OAuth-Tokens verwendet, die für die API-Authentifizierung benötigt werden. Weitere Informationen finden Sie im API-Handbuch.

Oauth-Client-ID

Die OAuth Client-ID ist eine eindeutige ID, die vom Gerät generiert wird. Sie kann nicht geändert werden. Die Client-ID wird als öffentliche Information erachtet und kann daher frei weitergegeben werden, ohne die Integrationssicherheit zu gefährden.

OAuth-Client-Secret

Das OAuth-Client-Secret wird vom Gerät mithilfe eines kryptografisch sicheren, pseudo-zufälligen Zahlengenerators generiert.

Hinweis: Das Client-Secret kann nicht modifiziert werden. Sie können es auf der Seite Bearbeiten jedoch neu erzeugen. Wird ein Client-Secret neu erzeugt und das Konto dann gespeichert, werden sofort sämtliche mit dem Konto verknüpften OAuth-Tokens ungültig. Sämtliche API-Aufrufe unter Verwendung dieser Tokens können nicht mehr auf die API zugreifen.

API :: Benutzerdefinierte Felder

Erstellen Sie benutzerdefinierte API-Felder, um Informationen über Ihren Kunden zu sammeln. So können Sie Bomgar tiefer mit ihren bestehenden Programmen integrieren. Benutzerdefinierte Felder müssen zusammen mit der Bomgar API verwendet werden. Weitere Informationen finden Sie im API-Handbuch.

Neues Feld erstellen, bearbeiten, löschen

Erstellen Sie ein neues Feld, modifizieren Sie ein bestehendes Feld oder entfernen Sie ein bestehendes Feld.

API :: Benutzerdefinierte Felder :: Hinzufügen oder Bearbeiten

Anzeigename

Erstellen Sie einen eindeutigen Namen, um dieses benutzerdefinierte Feld leichter zu identifizieren. Dieser Name wird in der Zugriffskonsole als Teil der Sitzungsdetails angezeigt.

Codename

Legen Sie einen Codenamen zu Integrationszwecken fest. Wenn Sie keinen Codenamen festlegen, wird automatisch einer erstellt.

In Zugriffskonsole anzeigen

Wenn Sie In Zugriffskonsole anzeigen aktivieren, werden dieses Feld und seine Werte sichtbar, wo immer benutzerdefinierte Sitzungsdetails in der Zugriffskonsole angezeigt werden.