Erste Schritte

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Auf dieser Seite werden die ersten Schritte mit der erweiterten API-Sicherheit erläutert.

Erforderliche Rollen

In den folgenden Abschnitten werden die erforderlichen Rollen beschrieben, um Aufgaben mit erweiterter API-Sicherheit auszuführen.

Erforderliche Rollen für Sicherheitsberichte

In der folgenden Tabelle sind die erforderlichen Rollen für Aufgaben im Zusammenhang mit Sicherheitsberichten aufgeführt.

Sicherheitsberichte – Aufgabe	Erforderliche Rollen
Erweiterte API-Sicherheit aktivieren oder deaktivieren	Apigee-Organisationsadministrator (roles/apigee.admin)
Berichte erstellen und abrufen	Apigee-Organisationsadministrator (roles/apigee.admin) Apigee-Sicherheitsadministrator (roles/apigee.securityAdmin)
Berichte ansehen	Apigee-Sicherheitsbetrachter (roles/apigee.securityViewer) Apigee-Sicherheitsadministrator (roles/apigee.securityAdmin)

Erforderliche Rollen für die Risikobewertung

In der folgenden Tabelle sind die erforderlichen Rollen für Aufgaben im Zusammenhang mit der Risikobewertung aufgeführt.

Risikobewertungsaufgabe	Erforderliche Rollen
Benutzerdefiniertes Sicherheitsprofil erstellen, aktualisieren oder löschen	Apigee-Sicherheitsadministrator (roles/apigee.securityAdmin) Apigee-Organisationsadministrator (roles/apigee.admin)
Sicherheitsprofil anhängen oder trennen	Apigee-Sicherheitsadministrator (roles/apigee.securityAdmin) Apigee-Organisationsadministrator (roles/apigee.admin)
Sicherheitspunktzahlen ansehen	Apigee-Sicherheitsadministrator (roles/apigee.securityAdmin) Apigee-Sicherheitsbetrachter (roles/apigee.securityViewer) Apigee-Organisationsadministrator (roles/apigee.admin)
Alle Sicherheitsprofile auflisten oder Profil abrufen	Apigee-Sicherheitsadministrator (roles/apigee.securityAdmin) Apigee-Sicherheitsbetrachter (roles/apigee.securityViewer) Apigee-Organisationsadministrator (roles/apigee.admin)

Erforderliche Rollen für die Missbrauchserkennung

In der folgenden Tabelle sind die erforderlichen Rollen für Aufgaben im Zusammenhang mit der Missbrauchserkennung aufgeführt.

Aufgabe zur Missbrauchserkennung	Erforderliche Rollen
Vorfälle in der Benutzeroberfläche zur Missbrauchserkennung ansehen	Apigee-Sicherheitsadministrator (roles/apigee.securityAdmin) Apigee-Sicherheitsbetrachter (roles/apigee.securityViewer) Apigee-Organisationsadministrator (roles/apigee.admin)

Erforderliche Rollen für Sicherheitsaktionen

In der folgenden Tabelle sind die erforderlichen Rollen für Aufgaben im Zusammenhang mit Sicherheitsaktionen aufgeführt.

Sicherheitsaktion – Aufgabe	Erforderliche Rollen
Sicherheitsaktionen erstellen	Apigee-Sicherheitsadministrator (roles/apigee.securityAdmin) Apigee-Organisationsadministrator (roles/apigee.admin)
Konfiguration der Sicherheitsaktionen aktualisieren	Apigee-Sicherheitsadministrator (roles/apigee.securityAdmin) Apigee-Organisationsadministrator (roles/apigee.admin)
Sicherheitsaktionen ansehen oder auflisten	Apigee-Sicherheitsadministrator (roles/apigee.securityAdmin) Apigee-Sicherheitsbetrachter (roles/apigee.securityViewer) Apigee-Organisationsadministrator (roles/apigee.admin)
Status der Erzwingung prüfen	Apigee-Sicherheitsadministrator (roles/apigee.securityAdmin) Apigee-Sicherheitsbetrachter (roles/apigee.securityViewer) Apigee-Organisationsadministrator (roles/apigee.admin)

Hinweis: Für die in den folgenden Abschnitten beschriebenen API-Aufrufe benötigen Sie ein OAuth 2.0-Zugriffstoken, das mit den Aufrufen übergeben wird.

Erweiterte API-Sicherheit für Abo-Organisationen verwalten

Um Erweiterte API-Sicherheit als Abo-Kunde zu verwenden, müssen Sie das Add-on in Ihrer Organisation aktivieren, wie in den folgenden Abschnitten beschrieben:

• Konfiguration von Apigee-Add-ons abrufen
• Erweiterte API-Sicherheit für Abo-Organisationen aktivieren

Wenn Sie sich nicht sicher sind, ob Sie ein Abo oder eine „Pay as you go“-Apigee-Organisation verwenden, wenden Sie sich an den Administrator Ihrer Apigee-Organisation.

Konfiguration von Apigee-Add-ons abrufen

Um Erweiterte API-Sicherheit für Ihre Abo-Organisation zu aktivieren, müssen Sie zuerst Ihre aktuelle Apigee-Add-on-Konfiguration mithilfe des folgenden API-Aufrufs abrufen. Außerdem erfahren Sie, ob die erweiterte API-Sicherheit bereits aktiviert ist.

curl "https://apigee.googleapis.com/v1/organizations/ORG" \
  -X GET \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer $TOKEN"

Dabei gilt:

• ORG ist der Name Ihrer Organisation.
• $TOKEN ist die Umgebungsvariable für ein OAuth-Zugriffstoken.

Dieser Aufruf gibt grundlegende Informationen zu Ihrer Organisation zurück, einschließlich eines Abschnitts für Ihre Apigee-Add-on-Konfiguration, der mit der folgenden Zeile beginnt:

"addonsConfig": {

Prüfen Sie, ob dieser Abschnitt den folgenden Eintrag enthält:

"apiSecurityConfig": {
          "enabled": true
      }

In diesem Fall ist die erweiterte API-Sicherheit bereits in der Organisation aktiviert. Andernfalls müssen Sie sie wie unten beschrieben aktivieren.

Erweiterte API-Sicherheit für Abo-Organisationen aktivieren

Zum Aktivieren der erweiterten API-Sicherheit in einer Abo-Organisation mit der Standardkonfiguration senden Sie eine POST-Anfrage, wie unten gezeigt.

Achtung: Dieser API-Aufruf überschreibt die aktuelle Add-on-Konfiguration. Sie müssen die aktuelle Konfiguration für alle Add-ons in der unten gezeigten Anfrage einschließen, um zu verhindern, dass sie überschrieben werden.

Notes:

• Wenn Sie nach der Aktivierung der erweiterten API-Sicherheit eine neue Umgebung erstellen, müssen Sie den folgenden Befehl noch einmal ausführen, um die erweiterte API-Sicherheit für die neue Umgebung zu aktivieren. Beachten Sie, dass Sie die erweiterte API-Sicherheit nicht deaktivieren müssen, bevor Sie den Befehl noch einmal ausführen.
• Wenn Sie einfach eine Umgebung trennen, in der die erweiterte API-Sicherheit für eine Instanz aktiviert ist, und sie später wieder anhängen, müssen Sie den Befehl unten nicht noch einmal ausführen.

curl "https://apigee.googleapis.com/v1/organizations/ORG:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "apiSecurityConfig": {
          "enabled": true
      }
      <Other entries of your current add-ons configuration>
    }
  }'

Dabei gilt:

• ORG ist der Name Ihrer Organisation.
• $TOKEN ist die Umgebungsvariable für ein OAuth-Zugriffstoken.
• <Other entries of your current add-ons configuration> besteht aus allen anderen Einträgen Ihrer aktuellen Apigee-Add-on-Konfiguration.

Hinweis: Der obige API-Aufruf startet einen Vorgang mit langer Ausführungszeit, der einige Zeit in Anspruch nehmen kann.

Wenn die aktuelle Add-on-Konfiguration beispielsweise

"addonsConfig": {
  "integrationConfig": {
      "enabled":true
  },
  "monetizationConfig": {
      "enabled":true
  }
},

ist, wäre der Befehl zur Aktivierung der erweiterten API-Sicherheit

curl "https://apigee.googleapis.com/v1/organizations/ORG:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "apiSecurityConfig": {
          "enabled": true
      },
      "integrationConfig": {
          "enabled": true
      },
      "monetizationConfig": {
          "enabled": true
      }
    }
  }'

Nachdem Sie die Anfrage gesendet haben, wird eine Antwort wie diese angezeigt:

{
  "name": "organizations/apigee-docs-d/operations/0718a945-76e0-4393-a456-f9929603b32c",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/apigee-docs-d",
    "state": "IN_PROGRESS"
  }
}

Hinweis: Wenn Sie Advanced API Security in einer Organisation aktivieren, kann es bis zu einem Tag dauern, bis die Punktzahlen für vorhandene Proxys und Ziele in einer Umgebung angezeigt werden.

Erweiterte API-Sicherheit für Abo-Organisationen deaktivieren

Wenn Sie die erweiterte API-Sicherheit für Ihre Abo-Organisation deaktivieren müssen, können Sie dazu eine POST-Anfrage senden und die Add-on-Konfiguration im Anfragetext übergeben, wie unten gezeigt.

Achtung: Die Add-on-Konfiguration, die Sie im Anfragetext übergeben, überschreibt die aktuelle Add-on-Konfiguration. Rufen Sie die vorhandene Add-on-Konfiguration im Apigee-Organisationsprofil auf und achten Sie darauf, dass Sie sie in die Anfragenutzlast einfügen.

Hinweis: Der folgende API-Aufruf startet einen Vorgang mit langer Ausführungszeit, der einige Zeit in Anspruch nehmen kann.

curl "https://apigee.googleapis.com/v1/organizations/$ORG:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "apiSecurityConfig": {
          "enabled": false
      }
     <Include current add-ons configuration>
    }
  }'

Das folgende Beispiel enthält eine Antwort, die zeigt, dass der Vorgang läuft:

{
  "name": "organizations/$ORG/operations/06274ffb-8940-41da-836d-781cba190437",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/$ORG",
    "state": "IN_PROGRESS"
  }
}

Weitere Informationen finden Sie unter Organization Add-ons API konfigurieren.

Erweiterte API-Sicherheit für „Pay as you go“-Organisationen verwalten

Wenn Sie Pay-as-you-go sind, können Sie Erweiterte API-Sicherheit von Apigee als kostenpflichtiges Add-on aktivieren. Weitere Informationen zum Aktivieren des Add-ons Erweiterte API-Sicherheit für Ihre Zwischenumgebungen oder umfassenden Umgebungen von Apigee finden Sie unter Add-on Erweiterte API-Sicherheits verwalten.

Wenn Sie sich nicht sicher sind, ob Sie ein Abo oder eine „Pay as you go“-Apigee-Organisation verwenden, wenden Sie sich an den Administrator Ihrer Apigee-Organisation.

Nächste Schritte

Nachdem Sie die erweiterte API-Sicherheit aktiviert haben, sollten Sie sich die folgenden Abschnitte ansehen:

• Sicherheitsberichte
• Risikobewertung
• Missbrauchserkennung
• Sicherheitsaktionen