Panoramica dell'API Identity and Access Management
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
L'API Identity and Access Management (IAM) utilizza risorse personalizzate di Kubernetes
per gestire il controllo dell'accesso per i provider di identità.
Per utilizzare l'API IAM, utilizza la console GDC. Se
la tua applicazione utilizza le tue librerie per chiamare l'API, adotta l'endpoint di servizio di esempio nella sezione seguente e le
definizioni complete dell'API per creare le tue richieste:
La variabile MANAGEMENT_API_SERVER_ENDPOINT è l'endpoint del server API Management.
Utilizzando il comando kubectl proxy, accedi all'URL nel browser per ottenere il documento di rilevamento per l'API IAM. Il comando kubectl proxy apre
un proxy su 127.0.0.1:8001 al server API Kubernetes sulla tua macchina
locale. Dopo aver eseguito il comando, accedi ai documenti agli URL seguenti:
http://127.0.0.1:8001/apis/iam.gdc.goog/v1
http://127.0.0.1:8001/apis/iam.global.gdc.goog/v1
Risorse di esempio
Di seguito è riportata una risorsa IdentityProviderConfig di esempio:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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-"]]
