USC/Api-Keys: Unterschied zwischen den Versionen

← Zum vorherigen Versionsunterschied Zum nächsten Versionsunterschied →

Version vom 25. Juli 2023, 16:48 Uhr

API Keys für UTM Monitoring nutzen

Neuer Artikel zur Version: 1.15

notempty

Dieser Artikel bezieht sich auf eine Beta-Version

Funktionsumfang

API Keys ermöglichen für andere Anwendungen eine Authentifizierung im USC Portal.
Dabei haben die API Keys einen festgelegten Geltungsbereich der z.Zt. ausschließlich Metriken für ein Monitoring umfasst.

API Key hinzufügen

Beschriftung	Wert	Beschreibung
		Aussagekräftiger Name für den API-Key
Mandanten		Mandanten, für die die API Werte ausgibt. Wird kein Mandant angegeben, werden Werte für sämtliche Mandanten und den Reseller selbst ausgegeben! Dieses Feld kann nachträglich nicht geändert werden
Geltungsbereich		Geltungsbereich für den API-Key. Z.Zt. ausschließlich Metrics verfügbar Dieses Feld kann nachträglich nicht geändert werden
Ablaufdatum	Wählen Sie ein Datum	Es muss ein Ablaufdatum gewählt werden. Soll die Geltungsdauer später geändert werden, ist es lediglich möglich, den API-Key zu löschen. Dieses Feld kann nachträglich nicht geändert werden
Kommentar		Freies Textfeld
Speichern	Legt den API-Key an und schließt den Dialog. Die Werte für Mandanten, Geltungsbereich und Ablaufdatum können anschließend nicht mehr geändert werden.

In Zwischenablage kopieren Kopiert den API Key in die Zwischenablage. Von hier kann er in andere Anwendungen eingefügt werden.

Anwendungsbeispiel

Hinweis

Dieser Artikel beinhaltet Beschreibungen der Software von Drittanbietern und basiert auf dem Stand zum Zeitpunkt der Erstellung dieser Seite.
Änderungen an der Benutzeroberfläche durch den Hersteller sind jederzeit möglich und müssen in der Durchführung entsprechend berücksichtigt werden.
Alle Angaben ohne Gewähr.

Das folgende Beispiel setzt eine funktionsfähige Installation folgender Produkte voraus:

Linux VM
Prometheus (Opensource Monitoring)
Grafana (Open-Source-Anwendung zur grafischen Darstellung von Daten)
ngninx (Webserver)

Keine Unterstützung durch unseren Support für Fremdprodukte
Wir leisten keinerlei Support für diese Anwendungen und können keine Unterstützung für Installation oder Konfiguration geben.
Es werden hier lediglich Anwendungs-Szenarien für API Keys gezeigt.

Prometheus Konfiguration bearbeiten

Öffnen der Konfigurationsdatei von Prometheus z. B. mit Editor nano sudo nano /etc/prometheus/prometheus.yml

Abschnitt scrape_configs: scrape_configs: # The job name is added as a label `job=<job_name>` to any timeseries scraped from this config. - job_name: 'securepoint_cloud_metrics' scrape_interval: 30s # Do not edit scrape_timeout: 10s metrics_path: /sms-mgt-api/api/2.0/metrics scheme: https bearer_token: 'eyJhbGciOiJIUzI1NiIsInR5...' static_configs: - targets: - portal.securepoint.cloud

Anschließend Konfiguration speichern und den Dienst neu starten. sudo systemctl restart prometheus

Der Befehl sudo systemctl status prometheus.service zeigt, ob der Dienst korrekt starten konnte.

verlassen der Ergebnis-Anzeige mit Taste q

Ein Aufruf der Prometheus-Seite im Menü Status / Targets im Browser sollte ein Ergebnis ähnlich dem nebenstehend gezeigten bieten.

Grafana Konfiguration

Datenquelle hinzufügen

Aufruf von Grafana im Webbrowser
Im Seitenmenü: Connections
In älteren Versionen Burger Menü oben links
Menüpunkt Data soures
Schaltfläche: Add new data source
Prometheus wählen
URL des Prometheus-Servers mit Port angeben, z.B.: http://localhost:9090
Speichern mit Save & test

Grafana Dashboard konfigurieren

Beispiel 1

in der Menüleiste
Schaltfläche Import

Schaltfläche Load
Datenquelle wählen: Select a Prometheus data source
Schaltfläche Import

Beispiel 2

in der Menüleiste
Schaltfläche Import

Schaltfläche Load
Datenquelle wählen: Select a Prometheus data source
Schaltfläche Import

@@ Zeile 56: / Zeile 56: @@
 <div class="Einrücken">
 {{#var:Prometheus Konfiguration bearbeiten--desc}}
-<span class="code fs-initial" style="max-height: 15em; max-width: 75%;"><nowiki>scrape_configs:
+<span class="code fs-initial block" style="max-height: 15em; max-width: 75%;"><nowiki>scrape_configs:
     # The job name is added as a label `job=<job_name>` to any timeseries scraped from this config.
     - job_name: 'securepoint_cloud_metrics'
@@ Zeile 68: / Zeile 68: @@
         - portal.securepoint.cloud
 </nowiki></span><br clear=all>
-{{#var:Bearer-Token--desc}}
+<li class="ist--element__alert list--element__hint"><{{#var:Bearer-Token--desc}}/li>
 <br clear=all>
@@ Zeile 82: / Zeile 82: @@
 <div class="Einrücken">{{#var:Datenquelle hinzufügen--desc}}</div>
 ===== {{#var:Grafana Dashboard konfigurieren}} =====
+====== {{#var:Beispiel}} 1 ======
+{{Bild|{{#var:Grafana Dashboard--Bild}}|{{#var:Grafana Dashboard--desc}}|class=width-xxl right }}
 <div class="Einrücken">{{#var:Grafana Konfiguration--desc}}</div>
-<span class="code fs-initial" style="max-height: 15em; xmax-width: 75%;">{{#var:Grafana Dashboard code}}</span>
+<span class="code fs-initial block Einrücken2" style="max-height: 15em; xmax-width: 75%;">{{#var:Grafana Dashboard1 code}}</span>
 {{#var:JSON Import}}
 </div>
+----
+====== {{#var:Beispiel}} 2 ======
+{{Bild|{{#var:Grafana Dashboard2--Bild}}|{{#var:Grafana Dashboard2--desc}}|class=width-xxl right }}
+<div class="Einrücken">{{#var:Grafana Konfiguration--desc}}</div>
+<span class="code fs-initial block Einrücken2" style="max-height: 15em; xmax-width: 75%;">{{#var:Grafana Dashboard2 code}}</span>
+{{#var:JSON Import}}
+</div>
+<!--
 ==== {{#var:Grafana Dashboard}} ====
 <div class="Einrücken">
@@ Zeile 93: / Zeile 108: @@
 {{Bild | {{#var:Grafana Dashboard--Bild}} | {{#var:Grafana Dashboard--cap}} }}
 </div>
+-->
 </div>