Información general sobre la API Identity and Access Management

La API de gestión de identidades y accesos (IAM) usa recursos personalizados de Kubernetes para gestionar el control de acceso de los proveedores de identidades.

Para usar la API de IAM, utiliza la consola de GDC. Si tu aplicación usa sus propias bibliotecas para llamar a la API, adopta el endpoint de servicio de ejemplo de la siguiente sección y las definiciones completas de la API para crear tus solicitudes:

Endpoint de servicio y documento de descubrimiento

Las APIs de IAM se proporcionan en dos paquetes en función del despliegue zonal o global.

Los endpoints de API para las APIs de IAM zonales y globales son los siguientes, respectivamente:

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

La variable MANAGEMENT_API_SERVER_ENDPOINT es el endpoint del servidor de la API Management.

Con el comando kubectl proxy, accede a la URL en tu navegador para obtener el documento de descubrimiento de la API de IAM. El comando kubectl proxy abre un proxy en 127.0.0.1:8001 para el servidor de la API de Kubernetes en tu máquina local. Una vez que se haya ejecutado el comando, accede a los documentos en las siguientes URLs:

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

Recursos de ejemplo

A continuación, se muestra un ejemplo de recurso IdentityProviderConfig:

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-