Control de acceso

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Es común que varios miembros del equipo colaboren en la compilación de un agente. Mediante el uso de funciones, puedes controlar el acceso y los permisos otorgados a los miembros del equipo.

Si estás utilizando la API, es posible que una o más aplicaciones también envíen solicitudes a un agente. En este caso, puedes controlar el acceso con las cuentas de servicio.

Puedes controlar el acceso mediante la administración de identidades y accesos (IAM) o la consola de Dialogflow. Hay algunas situaciones en las que debes usar Google Cloud Console:

  • La consola de Dialogflow proporciona la función de administrador de agente (propietario del proyecto de IAM) al usuario que creó el agente. Si deseas cambiar el administrador, agregar varios administradores para un agente o quitar administradores de un agente, debes usar Google Cloud Console.
  • Si tienes integraciones con otros recursos de Google Cloud, como Cloud Functions, y no deseas otorgar acceso completo al proyecto a una aplicación, debes asignar las funciones de la API de Dialogflow (Administrador, Cliente o Lector) en Google Cloud Console para IAM.
  • Un subconjunto de funciones de IAM tiene las funciones de la consola de Dialogflow correspondientes. Si deseas otorgar una función que no existe en la consola de Dialogflow, debes usar Google Cloud Console.

Roles

En la siguiente tabla, se enumeran todas las funciones relevantes de Dialogflow. En los resúmenes de permisos de la tabla, se usan los siguientes términos:

  • Acceso completo: permiso para modificar el acceso, crear, borrar, editar y leer un recurso.
  • Acceso de edición: permiso para crear, borrar, editar y leer un recurso.
  • Acceso de lectura: permiso para leer un recurso.
Función de la consola de Dialogflow Función de IAM Resumen de los permisos Detalles de los permisos
Administrador Proyecto >
Propietario
Se otorga a los propietarios de proyectos que necesitan acceso completo a todos los recursos de Google Cloud y Dialogflow:
  • Acceso total a todos los recursos del proyecto de Google Cloud mediante Google Cloud Console o las API
  • Acceso completo a los agentes mediante la consola de Dialogflow.
  • Permite detectar el intent mediante la API.
  • Puede cambiar la edición del agente en la consola de Dialogflow o mediante la API.
Consulta las definiciones de funciones básicas de IAM.
Programador Proyecto >
Editor
Se otorga a los editores de proyectos que necesitan acceso de edición a todos los recursos de Google Cloud y Dialogflow:
  • Acceso de edición a todos los recursos del proyecto de Cloud mediante Google Cloud Console o las API.
  • Acceso de edición a los agentes mediante la consola de Dialogflow.
  • Permite detectar el intent mediante la API.
Consulta las definiciones de funciones básicas de IAM.
Revisor Proyecto >
Visualizador
Se otorga a los visualizadores de proyectos que necesitan acceso de lectura a todos los recursos de Google Cloud y Dialogflow:
  • Acceso de lectura a todos los recursos del proyecto de Cloud mediante Google Cloud Console o las API.
  • Acceso de lectura a los agentes mediante la consola de Dialogflow.
  • No permite detectar el intent mediante la API.
Consulta las definiciones de funciones básicas de IAM.
No disponible Proyecto >
Navegador
Se otorga a los navegadores de proyectos que necesitan acceso de lectura para explorar la jerarquía de un proyecto, incluida la carpeta, la organización y la política de IAM:
  • Acceso de lectura a la jerarquía de proyectos de Cloud.
  • No permite el acceso a los agentes mediante la consola de Dialogflow.
  • No permite detectar el intent mediante la API.
Consulta las definiciones de funciones del proyecto de IAM.
No disponible Dialogflow >
Administrador de la API de Dialogflow
Se otorga a los administradores de la API de Dialogflow que necesitan acceso completo a los recursos específicos de Dialogflow:
  • Tiene acceso completo a todos los recursos de Dialogflow mediante Google Cloud Console o las API.
  • Acceso de lectura a los agentes mediante la consola de Dialogflow.
  • Permite detectar el intent mediante la API.
Consulta las definiciones de funciones de IAM de Dialogflow.
No disponible Dialogflow >
Cliente de la API de Dialogflow
Se otorga a los clientes de la API de Dialogflow que realizan ediciones específicas de Dialogflow y detectan llamadas de intent mediante la API:
  • Acceso de edición a todos los recursos de Dialogflow mediante Google Cloud Console o las API.
  • No permite el acceso a los agentes mediante la consola de Dialogflow.
  • Permite detectar el intent mediante la API.
Consulta las definiciones de funciones de IAM de Dialogflow.
No disponible Dialogflow >
Editor del agente de la consola de Dialogflow
Se otorga a los editores de la consola de Dialogflow que editan agentes existentes:
  • Acceso completo a todos los recursos de Dialogflow con Google Cloud Console.
  • Acceso de edición a la mayoría de los datos de agentes mediante la consola de Dialogflow. No permite acceder al editor intercalado para la integración de Cloud Functions o Asistente de Google.
  • Permite detectar el intent mediante la API.
Consulta las definiciones de funciones de IAM de Dialogflow.
No disponible Dialogflow >
Lector de la API de Dialogflow
Se otorga a los clientes de la API de Dialogflow que realizan llamadas de solo lectura específicas de Dialogflow mediante la API:
  • Acceso de lectura a todos los recursos de Dialogflow con Google Cloud Console o las API.
  • Acceso de lectura a los agentes mediante la consola de Dialogflow.
  • No permite detectar el intent mediante la API.
Consulta las definiciones de funciones de IAM de Dialogflow.

Controla el acceso con Google Cloud Console

Puedes controlar el acceso con la configuración de IAM. Consulta la guía de inicio rápido de IAM para obtener instrucciones detalladas sobre cómo agregar, editar y quitar permisos.

Para acceder a la configuración a continuación, abre la página IAM en Google Cloud Console.

Agrega un usuario o miembro de cuenta de servicio al proyecto

Para otorgar permisos a usuarios o cuentas de servicio, otórgales funciones en tu proyecto de Cloud. Los usuarios se agregan mediante el ingreso de la dirección de correo electrónico. Las cuentas de servicio también se agregan mediante el ingreso de la dirección de correo electrónico asociada. Los miembros de la cuenta de servicio se deben agregar cuando deseas usar una cuenta de servicio para múltiples proyectos y agentes. Para encontrar la dirección de correo electrónico asociada con tu cuenta de servicio, consulta la página Cuentas de servicio de IAM en Google Cloud Console.

Para agregar un miembro, sigue estos pasos:

  1. Haz clic en el botón Agregar  en la parte superior de la página.
  2. Ingresa la dirección de correo electrónico del miembro.
  3. Selecciona una función.
  4. Haz clic en Guardar.

Cambia permisos

  1. Haz clic en el botón Editar  del miembro.
  2. Selecciona una función diferente.
  3. Haz clic en Guardar.

Quita un miembro

  1. Haz clic en el botón Borrar  del miembro.

Controla el acceso con la consola de Dialogflow

Las opciones para compartir se encuentran en la configuración del agente. Para abrir la configuración de uso compartido del agente, sigue estos pasos:

  1. Ve a la consola de Dialogflow ES.
  2. Selecciona tu agente cerca de la parte superior del menú de la barra lateral izquierda.
  3. Haz clic en el botón de configuración junto al nombre del agente.
  4. Haz clic en la pestaña Compartir (Share). Si no ves la pestaña Compartir, es porque no tienes la función de Administrador de agente necesaria.

Pestaña Compartir que muestra a los usuarios con sus niveles de acceso

Agregar un usuario

  1. Ingresa la dirección de correo electrónico del usuario en Invitar personas nuevas.
  2. Selecciona una función.
  3. Haga clic en Agregar.
  4. Haz clic en Guardar.

Cambia permisos

  1. Encuentra el usuario en la lista.
  2. Selecciona una función diferente.
  3. Haz clic en Guardar.

Quita un usuario

  1. Encuentra el usuario en la lista.

  2. Haz clic en el botón Borrar del usuario.

  3. Haz clic en Guardar.

Cuentas de servicio creadas de forma automática

Cuando creas y trabajas con tu agente, Dialogflow crea algunas cuentas de servicio administradas por Google de forma automática.

Para ver estas cuentas de servicio, habilita la opción Incluir asignaciones de funciones proporcionadas por Google en la página de IAM.

No debes borrar, editar ni descargar claves para ninguna de estas cuentas de servicio, ni debes usar estas cuentas de servicio a fin de realizar llamadas directas a la API. Solo el servicio de Dialogflow las usa para conectarse a una variedad de servicios de Google Cloud que usa tu agente. Es posible que debas consultar estas cuentas de servicio por correo electrónico cuando configures ciertas características de Dialogflow.

En la siguiente tabla, se describen algunas de estas cuentas de servicio:

Formulario de correo electrónico de IAM Objetivo
service-project-number
@gcp-sa-dialogflow.iam.gserviceaccount.com
Se usa para conectar a tu agente con los servicios que manejan el tráfico de integración.
firebase-adminsdk-alphanum
@project-id.iam.gserviceaccount.com
Se usa para conectar tu agente a los servicios que controlan el tráfico de la integración del Asistente de Google.
project-id
@appspot.gserviceaccount.com
Se usa para conectar tu agente a los servicios que controlan el tráfico de la integración de Asistente de Google.

Función de administrador de transferencia

Para transferir la función de administrador de un agente, el administrador existente debe seguir los pasos anteriores a fin de agregar un administrador nuevo. Una vez que el administrador nuevo acepta la función otorgada, es seguro quitar al administrador anterior.

Si el administrador existente ya no trabaja en tu organización y necesitas que la función de administrador se transfiera a otro empleado, tienes dos opciones:

  • Un administrador de la organización asociada con el proyecto del agente tiene permisos para modificar el administrador del agente.
  • Si tienes permisos de lectura para el agente, puedes exportarlo y, luego, importarlo a uno en el que el empleado deseado sea el administrador. Esto puede crear tiempo de inactividad para un agente de producción en vivo, mientras se migra el agente y se actualizan las integraciones.

OAuth

Si usas bibliotecas cliente de Google para acceder a Dialogflow, no necesitas usar OAuth directamente, ya que estas bibliotecas controlan la implementación por ti. Sin embargo, si implementas tu propio cliente, es posible que debas implementar tu propio flujo de OAuth. Para acceder a la API de Dialogflow, se requiere uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/cloud-platform (acceso a todos los recursos del proyecto)
  • https://www.googleapis.com/auth/dialogflow (acceso a los recursos de Dialogflow)

Solicitudes que implican acceso a Cloud Storage

Algunas solicitudes de Dialogflow acceden a objetos en Cloud Storage para leer o escribir datos. Cuando llamas a una de estas solicitudes, Dialogflow accede a los datos de Cloud Storage en nombre del emisor. Esto significa que la autenticación de tu solicitud debe tener permisos para acceder a Dialogflow y a los objetos de Cloud Storage.

Cuando uses una biblioteca cliente de Google y las funciones de IAM, consulta la Guía de control de acceso de Cloud Storage para obtener información sobre las funciones de Cloud Storage.

Cuando implementas tu propio cliente y usas OAuth, debes utilizar el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/cloud-platform (acceso a todos los recursos del proyecto)