Controla quién puede habilitar tu API

Las claves de API están asociadas al proyecto de Google Cloud en el que se crearon. Si en tu API se 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 Cloud y 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 la función consumidor de servicios de la administración de identidades y accesos para permitir que alguien que no sea miembro de tu proyecto de Google Cloud habilite la API en su propio proyecto de Google Cloud. En esta sección, se muestra cómo otorgar acceso mediante Google Cloud Console o la herramienta de línea de comandos de gcloud.

Cloud Console

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

    Ir a la página de 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 Permisos.
  4. En el campo Agregar miembros, 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 Agregar.
  7. Continúa agregando miembros y seleccionando funciones según sea necesario.
  8. Contacta a los usuarios o los grupos que agregaste para informarles que pueden habilitar la API en sus proyectos de Google Cloud. En la página API y servicios, consulta cómo habilitar una API en tu proyecto de Google Cloud para obtener información acerca de la habilitación de un servicio.

gcloud

  1. Abre Cloud Shell. Si tienes el SDK de Cloud 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 los grupos que agregaste para informarles que pueden habilitar la API en sus proyectos de Google Cloud. En la página API y servicios, consulta cómo habilitar una API en tu proyecto de Google Cloud para obtener información acerca de la habilitación de un servicio.

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 Cloud Console o la herramienta de línea de comandos de gcloud.

Cloud Console

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

    Ir a la página de 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'
    

Próximos pasos