Agregar o editar un usuario de API

SEGURIDAD  Nivel de seguridad con permiso de Admin. para configurar Recursos/Usuarios (Recursos humanos). Consulte Configuraciones de seguridad de Admin..

NAVEGACIÓN > Admin > Extensiones e integraciones > Otras extensiones y herramientas > Centro de integraciones > seleccione un proveedor de integración > menú contextual > Agregar usuario de API.

NAVEGACIÓN > Admin. > Configuración de empresas y usuarios > Recursos/Usuarios (Recursos humanos) > Recursos/Usuarios (Recursos humanos) > Recursos/Usuarios > Nuevo > Nuevo usuario de API

Las integraciones externas que aparecen en la página del centro de integraciones requieren una cuenta de usuario de la API para comunicarse de forma segura con la aplicación. Recomendamos crear un usuario de API único para cada integración, para que así usted pueda fácilmente realizar un seguimiento de problemas de bloqueo y monitorizar actividad de la aplicación.

Un usuario de la API es un tipo especial de cuenta necesaria para la comunicación con la API de Autotask. Estas cuentas son gratuitas, pero no brindan acceso a la interfaz de usuario de Autotask. Los usuarios de la API no pueden asignarse como recursos a contenido como oportunidades o tickets, pero sí pueden seleccionarse como filtro en campos y en widgets de fecha, hora o auditoría.

EJEMPLO  En los campos de auditoría del sistema Creado por o Última actividad por, se incluyen usuarios de API en sus opciones de filtro.

Una buena práctica es configurar una cuenta de usuario de API separada, e incluso un nivel de seguridad Usuario de API (de sistema) (sólo API) o Usuario de API (de sistema) no puede leer los costos, para cada integración con la que trabajen sus programadores. Esto le permite adaptar los permisos de seguridad a las áreas requeridas por cada integración.

Para integraciones asociadas que aparezcan en la página Centro de integraciones, debe agregar usuarios de API directamente desde la página. Consulte Centro de integraciones.

Hay dos niveles de seguridad de sistema predeterminados que son similares pero diferentes, y están disponibles para cuentas de usuario de la API. Antes de crear su usuario de API, es importante entender el nivel de acceso que recibirán sus recursos y socios de integración con cada uno.

Usuario de la API (sistema) (sólo para la API): Utilice este nivel de seguridad de sistema para los recursos y socios de integraciones que trabajarán con las integraciones a través de la API y no necesitan acceder a Autotask a través de la interfaz de usuario. El nivel de seguridad de usuario de la API (sistema) concede acceso completo a todos los datos de Autotask, incluidos los costos internos, para las funciones a los que pertenecen.

Usuario de la API (de sistema) No puede leer los costos (sólo API): Si necesita otorgar acceso de usuario de la API a un socio de integración, pero prefiere que no tenga la capacidad de ver sus datos de costos internos, seleccione este nivel de seguridad. La función No puede leer costos de un Usuario de la API (de sistema) tiene acceso a todos los datos de las funciones a las que pertenece, pero las llamadas a consulta no devolverán datos de los campos de costos. La API también ignorará llamadas a Actualizar para campos de costos.

IMPORTANTE  Un usuario de la API tiene prohibido crear recursos (usuarios). También se le prohíbe modificar su propia configuración de seguridad o actualizar las configuraciones de autenticación multifactor (MFA).

Crear un usuario de API

Para crear una cuenta de usuario de API, haga lo siguiente:

  1. Para abrir la página, use la(s) ruta(s) de acceso en la sección Seguridad y navegación más arriba.
  2. Rellene o edite los siguientes campos:
Campo Descripción

Nombre de pila/Apellido

Campos de nombre

Nombre de pila y Segundo nombrey Apellido se utilizan en muchas otras entidades, a menudo en combinación con una función que la persona realice en este contexto o una acción que esté ejecutando.

Ingrese el nombre de pila, el apellido y, como opción, el segundo nombre del individuo.

Dirección de correo electrónico

 Esta dirección de correo electrónico se utilizará para las notificaciones en caso de que haya un problema con la integración. Introduzca la dirección de correo electrónico de una persona que podrá actuar si se produce un error.

Activo

Este valor es verdadero de manera predeterminada.

Bloqueado

Si un usuario de API ha sido bloqueado debido a repetidos intentos infructuosos por iniciar sesión, y ese recurso no puede desbloquear la cuenta desde la página de inicio de sesión, desmarque la casilla para desbloquear la cuenta.
El número de intentos fallidos consecutivos luego de los cuales se bloquea la cuenta del usuario está determinado por una configuración del sistema. Consulte Configuraciones del sistema de la configuración del sitio.

Nivel de seguridad

La lista de niveles de seguridad solo incluye niveles de seguridad solamente de la API (en orden alfabético ascendente), más el nivel actualmente asignado, si está ahora inactivo. Seleccione un nivel de seguridad de API.

Formato de fecha

El formato de fecha es de manera predeterminada el formato de fecha de la ubicación predeterminada. El selector desplegable contiene todos los formatos de fecha disponibles.

Formato de hora

El formato de hora es de manera predeterminada el formato de hora de la ubicación predeterminada. El selector desplegable contiene todos los formatos de hora disponibles.

Formato de número

El formato de número es de manera predeterminada el formato de número de la ubicación predeterminada. El selector desplegable contiene todos los formatos de número disponibles.

Ubicación interna principal

La ubicación interna principal determina la zona horaria asociada con el usuario de API.
Campo Descripción

Generar clave

Haga clic en este botón para generar automáticamente un nombre de usuario (clave) de 15 dígitos.

Se rellenará el campo Nombre de usuario (clave).

Nombre de usuario (Clave)

Este campo se rellena automáticamente cuando se hace clic en el botón Generar clave arriba del campo.

Usted puede sobrescribir el nombre de usuario generado automáticamente si cumple con los siguientes requisitos:

  • Debe contener letras y números
  • Puede contener caracteres especiales (pero no se permiten los siguientes caracteres especiales: @ ( ) ; : [ ] | \ ")
  • Debe ser único para su instancia de Autotask (incluidos los recursos inactivos)

Generar secreto

Haga clic en este botón para generar automáticamente una contraseña de 25 dígitos (secreto).

Se rellenará el campo Contraseña (Secreto).

Contraseña (Secreto)

Este campo se rellena automáticamente cuando se hace clic en el botón Generar secreto sobre el campo. La contraseña coincidirá con la Requisitos de contraseña configurada en las configuraciones del sistema de Configuración del sitio. Si su aplicación fijada como objetivo no permite contraseñas de 25 caracteres, puede acortar o sobrescribir la contraseña generada automáticamente.

En modo de edición, la contraseña no se muestra. Si necesita ver la contraseña, necesitará hacer clic en Generar secreto para generar o entrar una nueva contraseña.

Comenzando con la versión de API de SOAP 1.6 y todas las versiones de la API de REST, todas las llamadas, con excepción de getZoneInfo(), requieren un Id. de seguimiento que identifique al usuario de API y, por lo tanto, al proveedor de integraciones que generó la llamada. El identificador de seguimiento nos permite desactivar selectivamente las integraciones y los proveedores que están causando problemas, sin afectar el acceso a la API para todos los demás.

Un botón de radio presenta las siguientes opciones:

Opción de botón de radio Descripción

Botones de radio
Proveedor de integración Esta es la opción predeterminada. Debe usarse si su proveedor ha creado una integración con Autotask que aparezca en esta página: Centro de integraciones.
Personalizado (Integración interna) Seleccione esta opción si ha creado su propia integración personalizada con Autotask PSA usando nuestra API. Un Id. de seguimiento se genera automáticamente y el campo Nombre interno de la integración aparece y es requerido.

Ingrese un nombre único para su integración interna.

Usted puede usar este Id. de seguimiento para acceder a la versión 1.6+ de la API de SOAP y todas las versiones de la API de REST para la base de datos de su empresa solamente.Una vez que se guarda el usuario de API, el identificador de seguimiento no puede modificarse.

IMPORTANTE  Las integraciones de proveedores existentes no funcionarán con un identificador de seguimiento personalizado. Debe usar el Id. del proveedor, que puede encontrar en el Centro de integraciones. Si su proveedor no aparece, comuníquese con el proveedor.

Campos adicionales
Proveedor de integración (solo si el botón de radio Proveedor de integración está seleccionado) Si crea un usuario de la API desde el menú contextual de un proveedor de integración en la página del Centro de integraciones, ese proveedor se seleccionará en el campo Proveedor de integración. Los botones de radio y el control desplegable se desactivarán.

Si crea el usuario de la API desde la página Recursos, haga clic en el control desplegable del campo Proveedor de integración y seleccione su proveedor.
Aplicación (sólo aparece si el proveedor de integración seleccionado es un proveedor de middleware que ofrece múltiples integraciones) Ingrese el nombre de la aplicación de middleware.
Nombre de la integración interna (sólo si se selecciona el botón de opción Personalizado (integración interna)) Ingrese un nombre para su integración personalizada con Autotask.
Identificador de seguimiento (sólo si se selecciona el botón de radio Personalizado (Integración interna)) Este es el identificador de seguimiento que autenticará llamadas a la API desde esta cuenta de usuario a Autotask. Debe copiarse en el encabezado SOAP. Consulte El identificador de seguimiento de la API.

Todos los emparejamientos disponibles de División > Línea de negocios aparecen en el panel No asociado. Puede asociar un usuario de la API con una línea de negocio, pero tenga en cuenta que cualquier error no será visible para el usuario. A menos que su empresa esté estrictamente separada por línea de negocio, desaconsejamos las asociaciones de líneas de negocios.

EJEMPLO  Si un usuario de la API no está asignado a la línea de negocios a la que están asignados los elementos de facturación de una factura, la factura no se transferirá a QuickBooks.

Para asociar el usuario de la API con una o más líneas de negocio, haga lo siguiente:

  1. Seleccione uno o más emparejamientos División > Línea de negocios y haga clic en la flecha hacia la derecha. Los emparejamientos se mueven a la pestaña Asociado. Si es necesario, haga clic en la flecha de la izquierda para eliminar un emparejamiento.
  2. Para permitir que el usuario de API vea tales elementos, seleccione El recurso puede ver elementos sin ninguna línea de negocios asignada.
  3. Haga clic en Guardar y cerrar.

Consulte Asociar un usuario con una línea de negocios en la página Recurso.

  1. Haga clic en Guardar y cerrar.
  2. Actualice su integración con las nuevas credenciales de usuario de la API. La aplicación debería poder ahora autenticarse en Autotask.