Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Die Identity and Access Management (IAM) API verwendet benutzerdefinierte Kubernetes-Ressourcen, um den Zugriff für Identitätsanbieter zu verwalten.
Wenn Sie die IAM API verwenden möchten, nutzen Sie die GDC Console. Wenn Ihre Anwendung Ihre eigenen 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:
Die Variable MANAGEMENT_API_SERVER_ENDPOINT ist der Endpunkt des Management API-Servers.
Rufen Sie mit dem Befehl kubectl proxy die URL in Ihrem Browser auf, um das Discovery-Dokument für die IAM API abzurufen. Mit dem Befehl kubectl proxy wird ein Proxy auf 127.0.0.1:8001 zum Kubernetes API-Server auf Ihrem lokalen Computer geöffnet. 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 eine Beispielressource für IdentityProviderConfig:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-04 (UTC)."],[[["\u003cp\u003eThe Identity and Access Management (IAM) API uses Kubernetes custom resources to manage access for identity providers.\u003c/p\u003e\n"],["\u003cp\u003eThe IAM API can be accessed through the GDC console or by using application-specific libraries, utilizing provided API endpoints and definitions.\u003c/p\u003e\n"],["\u003cp\u003eIAM APIs are available in zonal and global deployments, each with distinct API endpoint URLs, using the format \u003ccode\u003ehttps://MANAGEMENT_API_SERVER_ENDPOINT/apis/iam.gdc.goog/v1\u003c/code\u003e for zonal and \u003ccode\u003ehttps://MANAGEMENT_API_SERVER_ENDPOINT/apis/iam.global.gdc.goog/v1\u003c/code\u003e for global.\u003c/p\u003e\n"],["\u003cp\u003eThe discovery document for the IAM API can be obtained by using \u003ccode\u003ekubectl proxy\u003c/code\u003e which will allow accessing the API on \u003ccode\u003e127.0.0.1:8001\u003c/code\u003e from your local machine.\u003c/p\u003e\n"],["\u003cp\u003eA sample \u003ccode\u003eIdentityProviderConfig\u003c/code\u003e resource is provided, demonstrating the configuration for an identity provider with fields such as \u003ccode\u003eclientID\u003c/code\u003e, \u003ccode\u003eissuerURI\u003c/code\u003e, and \u003ccode\u003escopes\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Identity and Access Management API overview\n\nThe Identity and Access Management (IAM) API uses Kubernetes custom resources\nto manage the control access for identity providers.\n\nTo use the IAM API, use the GDC console. If\nyour application uses your own libraries to call the API, adopt the example\nservice endpoint in the following section, and the\nfull API definitions to build your requests:\n\n- [iam.gdc.goog](/distributed-cloud/hosted/docs/latest/gdch/apis/service/identity/v1/identity-v1)\n- [iam.global.gdc.goog](/distributed-cloud/hosted/docs/latest/gdch/apis/service/identity/v1/global-identity-v1)\n\nService endpoint and discovery document\n---------------------------------------\n\nThe IAM APIs are provided in two packages depending on zonal deployment or\nglobal deployment.\n\nThe API endpoints for the zonal and global IAM APIs are the following,\nrespectively:\n\n- `https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/iam.gdc.goog/v1`\n- `https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/iam.global.gdc.goog/v1`\n\nThe \u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e variable is the\nendpoint of the Management API server.\n\nUsing the `kubectl proxy` command, access the URL in your browser to\nobtain the discovery document for the IAM API. The `kubectl proxy` command opens\nup a proxy on `127.0.0.1:8001` to the Kubernetes API server on your local\nmachine. After that command is running, access the documents at the\nfollowing URLs:\n\n- `http://127.0.0.1:8001/apis/iam.gdc.goog/v1`\n- `http://127.0.0.1:8001/apis/iam.global.gdc.goog/v1`\n\nExample resources\n-----------------\n\nThe following is a sample `IdentityProviderConfig` resource: \n\n apiVersion: iam.gdc.goog/v1\n kind: IdentityProviderConfig\n metadata:\n name: example-provider\n namespace: platform\n spec:\n - oidc:\n clientID: clientID\n clientSecret: clientSecret\n groupPrefix: example-\n groupsClaim: groups\n issuerURI: https://test-oidc-provider.example.com\n scopes: openid email profile\n userClaim: user-email@example.com\n userPrefix: example-"]]
