Controla quién puede habilitar tu API

Las claves de API están asociadas al proyecto Google Cloud en el que se crearon. Si tu API requiere una clave de API, debes dar a los usuarios de la API una clave del proyecto en el que creaste el servicio de Cloud Endpoints, o puedes permitir que los usuarios habiliten tu API en su propio proyecto de Google Cloudy creen una clave de API. En esta página, se muestra cómo otorgar el permiso que los usuarios necesitan para habilitar la API.

Otorga acceso

Endpoints usa el rol de consumidor de servicios de la administración de identidades y accesos (IAM) para permitir que alguien que no sea miembro de tu proyecto deGoogle Cloud habilite tu API en su propio proyecto de Google Cloud. En esta sección, se muestra cómo otorgar acceso mediante la console de Google Cloud o Google Cloud CLI.

Consola de Google Cloud

  1. En la consola de Google Cloud, ve a la página Endpoints > Servicios de tu proyecto.

    Ir a la página Servicios de Endpoints

  2. Si tienes más de una API, haz clic en el nombre de la API a la que quieras otorgar acceso.
  3. Si el panel lateral Permisos no está abierto, haz clic en Mostrar panel de permisos.
  4. En el campo Agregar principal, ingresa la dirección de correo electrónico de la persona o el Grupo de Google a los que deseas otorgar acceso.
  5. En el menú desplegable Seleccionar una función, selecciona Service Management > Consumidor de servicio.
  6. Haz clic en Guardar.
  7. Continúa agregando miembros y seleccionando funciones según sea necesario.
  8. Contacta a los usuarios o grupos que agregaste para informarles que pueden habilitar la API en sus Google Cloud proyectos. Consulta Habilitar una API en tu Google Cloud proyecto para obtener más información sobre cómo habilitar un servicio en API y servicios.

gcloud

  1. Abre Cloud Shell o, si tienes Google Cloud CLI instalado, abre una ventana de la terminal.
    • Ejecuta el siguiente código para conceder acceso a un usuario individual:
      gcloud endpoints services add-iam-policy-binding [SERVICE-NAME] \
      --member='user:EMAIL-NAME@gmail.com' \
      --role='roles/servicemanagement.serviceConsumer'
    • Ejecuta el siguiente código para otorgar acceso a un Grupo de Google: 
      gcloud endpoints services add-iam-policy-binding [SERVICE-NAME] \
      --member='group:GROUP-NAME@googlegroups.com' \
      --role='roles/servicemanagement.serviceConsumer'
  2. Contacta a los usuarios o grupos que agregaste para informarles que pueden habilitar la API en sus proyectos de Google Cloud . Consulta Habilitar una API en tu Google Cloud proyecto para obtener más información sobre cómo habilitar un servicio en API y servicios.

Revoca acceso

Para revocar el acceso a tu API, quita la función Consumidor de servicio de un usuario o grupo que tenía la función anteriormente. Después de que revocas el acceso de un usuario o grupo, ya no podrán habilitar la API.

En esta sección, se muestra cómo revocar el acceso con la consola de Google Cloud o Google Cloud CLI.

Consola de Google Cloud

  1. En la consola de Google Cloud, ve a la página Endpoints > Servicios de tu Google Cloud proyecto.

    Ir a la página Servicios de Endpoints

  2. Si tienes más de una API, haz clic en el nombre de la API a la que quieras revocar el acceso.
  3. Si el panel lateral Permisos no está abierto, haz clic en Permisos.
  4. Haz clic en la tarjeta Función a la que pertenece el miembro.
  5. Haz clic en Borrar .

gcloud

  • Ejecuta el siguiente código para revocar el acceso a un usuario individual:
    gcloud endpoints services remove-iam-policy-binding [SERVICE-NAME] \
      --member='user:'EMAIL-NAME@gmail.com' --role='roles/servicemanagement.serviceConsumer'
  • Ejecuta el siguiente código para revocar el acceso a un Grupo de Google:
    gcloud endpoints services remove-iam-policy-binding [SERVICE-NAME] \
      --member='group:GROUP-NAME@googlegroups.com' \
      --role='roles/servicemanagement.serviceConsumer'

¿Qué sigue?