Identity and Access Management API – Übersicht

Die Identity and Access Management (IAM) API verwendet benutzerdefinierte Kubernetes-Ressourcen, um den Zugriff für Identitätsanbieter zu verwalten.

Verwenden Sie die GDC-Konsole, um die IAM API zu verwenden. Wenn Ihre Anwendung eigene Bibliotheken verwendet, um die API aufzurufen, übernehmen Sie den Beispiel-Dienstendpunkt im folgenden Abschnitt und die vollständigen API-Definitionen, um Ihre Anfragen zu erstellen:

Dienstendpunkt und Discovery-Dokument

Die IAM APIs werden in zwei Paketen bereitgestellt, je nach zonenbasierter oder globaler Bereitstellung.

Die API-Endpunkte für die zonenbasierte und globale IAM API sind jeweils die folgenden:

  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/iam.gdc.goog/v1
  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/iam.global.gdc.goog/v1

Die Variable MANAGEMENT_API_SERVER_ENDPOINT ist der Endpunkt des Management API-Servers.

Greifen Sie mit dem Befehl kubectl proxy in Ihrem Browser auf die URL zu, um das Discovery-Dokument für die IAM API abzurufen. Der Befehl kubectl proxy öffnet einen Proxy auf 127.0.0.1:8001 zum Kubernetes API-Server auf Ihrem lokalen Computer. Nachdem der Befehl ausgeführt wurde, können Sie über die folgenden URLs auf die Dokumente zugreifen:

  • http://127.0.0.1:8001/apis/iam.gdc.goog/v1
  • http://127.0.0.1:8001/apis/iam.global.gdc.goog/v1

Beispielressourcen

Hier ist ein Beispiel für eine IdentityProviderConfig-Ressource:

apiVersion: iam.gdc.goog/v1
kind: IdentityProviderConfig
metadata:
  name: example-provider
  namespace: platform
spec:
  - oidc:
    clientID: clientID
    clientSecret: clientSecret
    groupPrefix: example-
    groupsClaim: groups
    issuerURI: https://test-oidc-provider.example.com
    scopes: openid,email,profile
    userClaim: user-email@example.com
    userPrefix: example-