Guía del usuario Cancelar

Crear cuentas técnicas para enviar acuerdos mediante la API

 

Guía de Adobe Acrobat Sign

Novedades

Introducción

Administrar

Enviar, firmar y administrar acuerdos

Capacidades y flujos de trabajo de acuerdos avanzados

Integrar con otros productos

Acrobat Sign Desarrolladores

Soporte y solución de problemas

Cuentas técnicas de Adobe Acrobat Sign

Las cuentas técnicas de Acrobat Sign son un medio para habilitar cuentas de nivel empresarial con la posibilidad de ejecutar las aplicaciones bajo la autoridad de un ID de usuario generado explícitamente para dicho fin (en lugar de usar el ID de usuario personal del administrador).

Las cuentas técnicas están disponibles para los clientes empresariales (a través de la Consola de desarrolladores de Adobe) en el plan de compra de ETLA que administra su cuenta a través de Adobe Admin Console.

La tarjeta del producto para acceder a la cuenta técnica se encuentra en la pestaña Productos de Admin Console debajo del nombre de la oferta Adobe Acrobat Sign Solutions, Empresas (busque el indicador API disponible):

Tarjetas de producto de cuentas técnicas

Nota:

El siguiente proceso describe el uso de las Cuentas técnicas mediante una solución de API. Las organizaciones que desean permitir que los usuarios envíen acuerdos manualmente en nombre de una parte centralizada hacen referencia al documento para configurar cuentas técnicas mediante conexión manual.

Requisitos previos

Para habilitar una cuenta técnica, su cuenta de Acrobat Sign debe tener lo siguiente:

  • El servicio de ETLA de nivel empresarial.
  • Administrar usuarios en Adobe Admin Console*.
  • Activar uso compartido de cuenta avanzada.

*Nota sobre Adobe Admin Console

Adobe Admin Console proporciona un marco de trabajo para la administración de usuarios y la asignación de licencias. La mayoría de los clientes tienen una sola Admin Console.

Sin embargo, algunos clientes con requisitos complejos de usuario/licencia pueden tener varias Admin Console, lo que puede resultar confuso en un proceso como la creación de una cuenta técnica, en el que una Admin Console puede controlar la administración de usuarios federados y otra administra las licencias de Acrobat Sign.

Si sabe que tiene varias cuentas o no está seguro, lea lo siguiente:

Información general

La creación de una cuenta técnica es un proceso de varios pasos que requiere acceso de administrador a Adobe Acrobat Console y autorización de administrador de cuenta en Acrobat Sign.

El proceso requiere que el administrador realice lo siguiente:

  1. Permitir el acceso de administrador o desarrollador al usuario que crea la cuenta técnica.
    • El usuario debe ser administrador o desarrollador para configurar las opciones que crean la cuenta técnica.
  2. Crear un nuevo proyecto en Adobe Developer Console (Adobe.io).
    • El proyecto es el entorno necesario para albergar el par de claves pública y privada y el token de acceso que habilita la funcionalidad de la cuenta técnica.
  3. Crear o cargar un par de claves pública y privada y generar un token de acceso.
    • Al generar el token de acceso, se crea el ID de usuario de cuenta técnica en Adobe Admin Console y se rellena en el sistema Acrobat Sign.
  4. (Opcional) Crear un nuevo grupo en el sistema Acrobat Sign.
    • La creación de un grupo dedicado para el ID de usuario de cuenta técnica permite una configuración muy ajustada de las propiedades del acuerdo, que puede ser demasiado estricta o diferente de otras configuraciones de grupo.
  5. Privilegiar el ID de usuario de la cuenta técnica en Acrobat Sign como administrador de nivel de grupo.
  6. Crear un nuevo usuario federado en la Adobe Admin Console.
    • Se crea un correo electrónico de usuario con su dominio para sustituir el ID de usuario de la cuenta técnica al enviar, proporcionando una dirección de correo electrónico que se atribuye correctamente a su empresa.
  7. Compartir la cuenta del usuario federado con la cuenta técnica.
    • El ID de usuario de la cuenta técnica se genera en la Admin Console de licencias con una dirección de correo electrónico de adobe.com. Al compartir la cuenta del usuario Federada, se concede acceso al ID de usuario de la cuenta técnica para enviarlo en nombre del ID de usuario federado, lo que proporciona un nombre o una dirección de correo electrónico más sencillos para los destinatarios.

    Una vez completada, la API se puede configurar para utilizar la cuenta técnica (mediante el código de acceso) para crear y enviar acuerdos en nombre de un usuario centralizado.

Permitir a los usuarios acceder a la Consola del desarrollador

Para poder agregar una nueva cuenta técnica, el usuario debe añadirse al perfil del producto Adobe Acrobat Sign Solutions, Enterprise (en su Admin Console con licencia) como Administrador o Desarrollador.

  1. Haga clic en el vínculo Adobe Acrobat Sign Solutions, Enterprise en el lado izquierdo o en los productos.

  2. Seleccione el perfil de producto predeterminado para el servicio de Acrobat Sign.

    Seleccionar perfil de producto

  3. Se abre la página Agregar usuarios a este producto:

    • Seleccione la opción Administrador o Desarrollador.
  4. Escriba la dirección de correo electrónico del usuario al que desea conceder acceso.

  5. Haga clic en Agregar administrador/Desarrollador.

    Agregar desarrollador

  6. Escriba la dirección de correo electrónico del usuario al que desea conceder acceso.

  7. Escriba el nombre y los apellidos.

  8. Haga clic en Guardar cuando haya finalizado.

    Introducir información del desarrollador

Creación de un nuevo proyecto en la consola de Adobe.io

  1. Vaya a https://console.adobe.io

    • Si pertenece a varias instancias de Admin Console, asegúrese de estar conectado a la instancia que se ajuste a su Admin Console con licencia haciendo clic en la tecla de flecha hacia abajo situada en el ángulo superior derecho de la ventana.
    Instancias de Admin Console

  2. Seleccione Crear nuevo proyecto.

    Creación de un proyecto

  3. El nuevo proyecto se muestra en la pestaña Proyectos de la consola.

    Dedique un momento a asignar un nombre a su proyecto haciendo clic en el botón Editar proyecto.

    • Proporcione un nombre que sus compañeros de trabajo comprendan
    • Proporcione una breve descripción
    • Guarde las ediciones
    Editar el proyecto

  4. Seleccione el nuevo proyecto (en la pestaña Proyectos) para abrirlo para su configuración.

    En la página Empezar:

    1. Seleccione Agregar al proyecto
    2. Seleccione API en el menú desplegable
    Añadir una API

  5. En la página Añadir una API:

    1. Seleccione el filtro Document Cloud
    2. Seleccione Acrobat Sign
    3. Haga clic en Siguiente.
    Seleccione Acrobat Sign

Crear un nuevo token web de JSON

Tiene la opción de generar un nuevo par de claves pública/privada o cargar su clave pública. Elija la opción que mejor se adapte a sus necesidades:

Seleccionar el perfil del producto

La página Configurar API se actualiza para mostrar los perfiles de producto disponibles para su cuenta. Es posible que tenga uno o más perfiles según los perfiles disponibles para su cuenta.

  1. Seleccione la casilla de verificación de su Adobe Acrobat Sign Solutions predeterminado, Empresas.
  2. Cuando esté listo, haga clic en Guardar API configurada.
Guardar API configurada

Generar un token de acceso

Una vez guardada, se crea la cuenta técnica y se vuelve a la página principal del proyecto.

En la sección Generar token de acceso, hay un campo de entrada para su clave privada. 

  1. Pegue la clave privada generada o cargada anteriormente en el campo Clave privada.

  2. Seleccione Generar token.

  3. Al cabo de un momento, la Clave privada se actualiza para mostrar el Token de acceso.

  4. Copie y guarde el token de acceso.

    Generar el token de acceso

  5. En la parte inferior de la misma página, tiene acceso a lo siguiente:

    • Id. del cliente
    • Secreto de cliente
    • ID de cuenta técnica
    • Correo electrónico de cuenta técnica
    • Id. de la organización

    Copie y guarde el Correo electrónico de cuenta técnica.

    Guarde el correo electrónico de cuenta técnica

Considerar la posibilidad de generar un grupo único en Acrobat Sign para la aplicación

Los grupos de Acrobat Sign permiten una configuración detallada de los ajustes de seguridad y experiencia del destinatario (así como los flujos de trabajo, las plantillas, los informes, etc.)

Si desea aislar el ID de usuario de cuenta técnica en su propio grupo:

  1. Inicie sesión en Acrobat Sign como administrador de nivel de cuenta.

  2. Vaya a la pestaña Grupos en el menú de administración.

  3. Haga clic en el icono de signo “más” para crear un grupo nuevo.

  4. Introduzca un nombre intuitivo para el grupo (quizás el mismo nombre que el Proyecto).

  5. Guarde el grupo.

  6. (Opcional) Abra el nuevo grupo y configure los ajustes necesarios para la aplicación.

    Creación de un grupo

Nota:

Si su organización

  • usa la herramienta de sincronización de usuarios (User Sync Tool, UST) para sincronizar a los usuarios automáticamente entre Adobe y Active Directory
  • no permite que los usuarios se agreguen o creen manualmente en Acrobat Sign,

deberá crear un grupo de excepciones para que sea el grupo principal de todos los ID de usuario de la cuenta técnica.

El nombre del grupo se agrega a la configuración de UST para garantizar que el proceso de sincronización no afecte a los ID de usuario, lo que provoca que se desactiven o se eliminen sus derechos.

Privilegiar el ID de usuario de la cuenta técnica como administrador de grupos en Acrobat Sign

Deje transcurrir unos minutos hasta que el usuario recién creado techacct.adobe.com se genere en el sistema de Acrobat Sign.

  1. Inicie sesión en su cuenta de Acrobat Sign como administrador de nivel de cuenta.

  2. Vaya a la pestaña Usuarios del menú de administración.

  3. Busque la nueva dirección de correo electrónico de techacct.adobe.com (copiada de la página principal del proyecto).

  4. Haga clic en el usuario y seleccione Editar detalles de usuarios.

    Editar datos usuarios

  5. Haga clic en el icono de signo más en la sección  Miembros del grupo y añada el grupo de la aplicación al perfil del usuario.

  6. Seleccione el grupo de la aplicación y haga clic en Marcar como vínculo principal.

  7. Marque la casilla para marcar el ID de usuario como Administrador del grupo.

  8. (Opcional) Elimine la cuenta técnica del grupo Predeterminado.

  9. Haga clic en Guardar cuando haya finalizado.

    Guarde los ajustes del perfil.

Crear un usuario/correo electrónico Responder a

El envío de acuerdos mediante el ID de usuario/correo electrónico asociado a la cuenta técnica es problemático debido a que el correo electrónico no está dentro del dominio de su empresa.

Para resolver este problema:

  • Debe crear un nuevo ID de usuario federado en la Admin Console con licencia.
  • El ID de usuario de la cuenta técnica debe compartirse con el nuevo ID de usuario federado (mediante el uso compartido avanzado de la cuenta).

Una vez configuradas, las llamadas de API deben configurarse para utilizar el token de la cuenta técnica como el valor Autorización y el ID de usuario o el correo electrónico del ID de usuario compartido como el valorx-en-nombre-del-usuario .

Crear un nuevo ID de usuario federado

Antes de crear el nuevo ID de usuario, debe identificar una dirección de correo electrónico que se pueda utilizar para las respuestas o preguntas entrantes de los destinatarios.

Para crear el nuevo ID de usuario:

  1. Inicie sesión en su (Sync de directorio federado) Admin Console como administrador.

  2. Vaya a ConfiguraciónIdentidad

    Seleccione un directorio para crear el nuevo usuario.

    Dominio activo

  3. Seleccione la pestaña Sincronizar.

  4. Seleccione Ir a Configuración y haga clic en Habilitar edición.

    Cuando la edición está activada, Adobe Admin Console solo permite editar los datos del usuario en la Admin Console. El IdP no se actualiza con las ediciones.

    Configuración de directorio: pestaña de sincronización

    Nota:

    La edición permanecerá habilitada solo durante una hora o hasta que se desactive manualmente.

    Cuenta técnica

  5. Inicie sesión en su Admin Console de Licencias (si está trabajando con varias Admin Console).

  6. Vaya a: Usuarios → Agregar usuario.

  7. Configure su nuevo ID de usuario con:

    • Correo electrónico o nombre de usuario: utilice la dirección de correo electrónico en la que desea capturar los correos electrónicos de respuesta de los destinatarios.
    • Tipo de ID: Federated ID
    • Nombre/apellido: este valor se utiliza en el sistema Acrobat Sign y se refleja en el informe de auditoría. Utilice un valor que proporcione contexto. Por ejemplo: Recursos Humanos
    • Nombre de usuario de SSO: utilice el mismo valor de correo electrónico.
    • País/región: seleccione el país o la región adecuados para su empresa.
    • Seleccione el producto/perfil de Acrobat Sign al que está asociado el ID de usuario técnico.
    • Establezca la función de usuarios en Usuario.

    Haga clic en Guardar cuando haya finalizado.

    Cuenta técnica

  8. Vuelva a iniciar sesión en Sync de directorio federado de la Admin Console para habilitar la sincronización de sus datos de IdP.

  9. Vuelva a Configuración → Identidad → {Directorio} → Sincronizar → Ir a Configuración.

    Haga clic en Deshabilitar edición para volver a habilitar la sincronización de datos con su IdP.

  10. El nuevo ID de usuario se generará automáticamente en el sistema de Acrobat Sign.

Compartir la cuenta técnica con el nuevo ID de usuario federado

Para tener acceso al contenido de un ID de usuario en el que puede iniciar sesión,

  1. Inicie sesión en Acrobat Sign como administrador de nivel de cuenta.

  2. Vaya a la pestaña Usuarios en el menú de administración.

  3. Haga clic una vez en el nuevo usuario y edite los detalles de usuario.

  4. Seleccione Estado de uso compartido en el menú de la izquierda.

    Asegúrese de que la Cuenta de usuarios compartida con está seleccionada.

  5. Seleccione la pestaña Compartida con usuario en la parte superior de la página Estado de uso compartido página.

  6. Comparta la nueva cuenta del ID de usuario con la cuenta técnica

    1. Haga clic en el icono más en la fila superior derecha para abrir la interfaz del selector.
    2. Haga clic en el icono de tres líneas situado a la derecha del cuadro de búsqueda.
    3. Expanda el grupo en el que reside el ID de usuario de la cuenta técnica.
    4. Haga clic en el icono “más” situado junto al ID de usuario de la cuenta técnica para seleccionarlo.
    5. Compruebe el Permiso adicional para permitir el Envío.
    6. Haga clic en Guardar.
    Cuenta técnica

Probar la nueva cuenta técnica

Para comprobar que el código de acceso funciona correctamente, haga lo siguiente:

  1. Seleccione el método GET/usuarios.

  2. En el campo Autorización:

    1. Escriba la palabra Bearer seguido de un espacio
    2. Pegue el Código de acceso
    3. Haga clic en Probar.
    Pruébelo.

  3. El cuerpo de la respuesta devolverá una lista de los usuarios de la cuenta y un Código de respuesta de 200:

    Cuerpo de respuesta

Pruebe el envío de un acuerdo mediante la cuenta técnica en nombre del nuevo ID de usuario mediante la API

  1. Obtenga un transientDocumentId o tenga preparado otro método para adjuntar un archivo que ya está listo.

  2. En el campo Autorización:

    1. Escriba la palabra Bearer seguida de un espacio
    2. Péguelo en el token de acceso
      de la cuenta técnica
    3. En el campo x-en-nombre-del-usuario, escriba la dirección de correo electrónico del nuevo ID de usuario
    4. Complete el resto de AgreementInfo con el transientDocumentId, el nombre del acuerdo, el tipo de firma y el estado.
    5. Haga clic en Probar.
    Pruébelo.

  3. Inicie sesión en Acrobat Sign con el nuevo ID de usuario y vaya a la pestaña Administrar .

  4. Al revisar el registro de auditoría del acuerdo, verá que la cuenta técnica envió el acuerdo en nombre del nuevo ID de usuario.

Revisar el contenido generado en nombre del nuevo ID de usuario mediante la interfaz de Acrobat Sign

Cuando la cuenta técnica crea un acuerdo en nombre del ID de usuario federado, el acuerdo se publica en la página Administrar del ID de usuario federado.

Está en la página Administrar de los ID de usuario que puede ver y en la que puede administrar el acuerdo.

Acuerdo enviado en nombre del usuario

Obtén ayuda de forma más rápida y sencilla

¿Nuevo usuario?