Zugriff auf Ihre Observability-Instanz steuern

Observability ist ein Service, der über das Internet verfügbar ist und somit grundsätzlich für jeden erreichbar ist.
Wenn Sie den Zugriff auf eine Observability-Instanz auf bestimmte Adressbereiche beschränken möchten, können Sie hierfür eine Zugriffskontrollliste (Access Control List, ACL) hinterlegen.

Anschließend verhindert ein IP-Filter den Zugriff von anderen Internetadressen auf Ihre Observability-Instanz. Der Zugriff wird für die folgenden Endpunkte geregelt:

• Grafana
• Metriken
• Logs
• Traces

Ein unbeabsichtigtes Aussperren ist nicht möglich.

Diese ACL filtert den Zugriff ausschließlich für diese spezifische Instanz. Wenn Sie mit mehreren Instanzen arbeiten, müssen Sie die ACL für jede Instanz individuell konfigurieren.

Aktuelle IP-Adresse ermitteln

Wenn Sie den Zugriff für Ihren lokalen Computer erlauben möchten, können Sie Ihre aktuelle öffentliche IPv4-Adresse mit dem Cloudflare Trace Tool ermitteln.

Kopieren Sie den nach ip= angezeigten Wert, ergänzen Sie /32 (was für eine einzelne IP-Adresse steht) und fügen Sie ihn zu Ihrer ACL-Konfiguration hinzu.

ACL über das Portal konfigurieren

Sie können Ihre ACL direkt im STACKIT Portal verwalten:

1. Navigieren Sie zu Ihrer Observability Instanz im STACKIT Portal.
2. Navigieren Sie im Tab Übersicht zum Abschnitt Zugriffssteuerung (ACL-IP-Bereiche).
3. Wählen Sie Bearbeiten.
4. Wählen Sie IP-Bereich hinzufügen.
5. Geben Sie Ihre IPv4-Adresse oder einen CIDR-Netzwerkbereich ein (z. B. 203.0.113.15/32).
6. Wählen Sie Speichern.

ACL über die API konfigurieren

Eine vollständige Liste aller verfügbaren Endpunkte, Parameter und Schemas finden Sie in der STACKIT Observability ACL API Spezifikation.

Um die folgenden Befehle auszuführen, müssen Sie Ihre PROJECT_ID und INSTANCE_ID als Umgebungsvariablen setzen.

Um zu erfahren, wie Sie sich authentifizieren und den Wrapper stackit curl verwenden, lesen Sie unseren zentralen Leitfaden: Interaktion mit der Observability-API.

CIDR-Format

Adressbereiche werden im Classless-Inter-Domain-Routing-(CIDR-)Format angegeben. Standardmäßig ist die CIDR 0.0.0.0/0, was den vollständigen Zugriff von überall erlaubt.

Aktuelle ACL abrufen

Sie können die aktuelle ACL-Konfiguration Ihrer Instanz ausgeben:

Befehl:

stackit curl -X GET "[https://argus.api.eu01.stackit.cloud/v1/projects/$PROJECT_ID/instances/$INSTANCE_ID/acl](https://argus.api.eu01.stackit.cloud/v1/projects/$PROJECT_ID/instances/$INSTANCE_ID/acl)" \
  -H "accept: application/json"

Antwort:

{
  "message": "Successfully got acl",
  "acl": []
}

Neue ACL erstellen und ändern

Die ACL muss immer vollständig neu geschrieben (ersetzt) werden, selbst wenn Sie nur einen einzelnen Wert ändern oder hinzufügen möchten:

Befehl:

stackit curl -X PUT "[https://argus.api.eu01.stackit.cloud/v1/projects/$PROJECT_ID/instances/$INSTANCE_ID/acl](https://argus.api.eu01.stackit.cloud/v1/projects/$PROJECT_ID/instances/$INSTANCE_ID/acl)" \
  -H "accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
  "acl": [
    "192.168.1.0/24",
    "193.248.122.0/24",
    "193.218.22.0/28"
  ]
}'

Antwort:

{
  "message": "Successfully updated acl"
}

ACL löschen

Um die ACL zu löschen und den standardmäßigen vollen Zugriff wiederherzustellen, senden Sie eine PUT-Anfrage mit einem leeren Array:

Befehl:

stackit curl -X PUT "[https://argus.api.eu01.stackit.cloud/v1/projects/$PROJECT_ID/instances/$INSTANCE_ID/acl](https://argus.api.eu01.stackit.cloud/v1/projects/$PROJECT_ID/instances/$INSTANCE_ID/acl)" \
  -H "accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
  "acl": []
}'

Antwort:

{
  "message": "Successfully updated acl"
}