Adobe Acrobat Sign

Adobe Acrobat Sign Ayuda

Abrir en Web
Centro de ayuda de Adobe
Ayuda de Adobe Acrobat Sign
Centro de ayuda de Adobe
Ayuda de Adobe Acrobat Sign

Crear cuentas técnicas para enviar acuerdos mediante la API

Última actualización el 1 dic 2023

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:

El problema con varias Admin Console es asegurarse de que está en la consola correcta para las acciones que intenta realizar.

Para determinar si tiene varias Admin Console:

1. Inicie sesión en Admin Console.

2. En la esquina superior derecha de la consola, haga clic en el nombre de la organización.

Si tiene un menú desplegable con varias organizaciones, tiene varias Admin Console.

Lista desplegable de la organización de Admin Console

Si solo tiene una Admin Console, las operaciones de creación de usuarios y licencias se realizan en la misma organización y no tiene que preocuparse por cambiar de consola.

Si tiene varias Admin Console, dedique un momento a determinar qué organización gestiona la creación de usuarios federados y cuál es la encargada del aprovisionamiento de licencias de Acrobat Sign.

Las empresas con varias Admin Console pueden implementar Acrobat Sign desde más de una. Debe identificar la Admin Console correcta donde desea establecer la conexión de API y el usuario de la cuenta técnica.

Debe examinar cada organización para determinar cuál debe contener la cuenta técnica.

  1. Seleccione la organización.
  2. Seleccione Productos desde el carril superior de opciones.
  3. Busque la tarjeta de producto Adobe Sign, Empresas con el indicador de la API disponible .

A efectos del presente documento, la denominaremos su Admin Console de licencias. Esta es la organización donde:

  • Define el administrador o usuario desarrollador que conectará la API.
  • Se crea y administra el usuario de su cuenta técnica.
Tarjetas de producto de cuentas técnicas

Las organizaciones que utilicen la administración de usuarios federados deben anular la sincronización de la solución federada para crear un usuario fuera del entorno federado.

Para ello, debe examinar cada organización para averiguar cuál controla los dominios que habilitan la relación de confianza federada. Varias Admin Console pueden Confiar en un dominio, pero solo una lo controla activamente.

  1. Seleccionar la organización
  2. Seleccione Configuración en el carril superior de opciones.
  3. Seleccione Identidad en el carril izquierdo de opciones.
  4. Si hay directorios en la lista con el Tipo Federated ID y el Estado es De confianza, haga clic en la fila en la que se encuentra el directorio para mostrar la organización propietaria.
Vaya a Identidad

La Organización propietaria es Admin Console correcto para manipular los controles de sincronización de Federated ID.

  • Se proporciona un correo electrónico para el administrador de la consola si no tiene acceso actualmente.

Si el Tipo es Federated ID y el Estado ,Activo, haga clic en Nombre del directorio para abrir la configuración del directorio.

Dominio activo

En la página de configuración, seleccione la pestaña Sincronizar , que abre la información de sincronización de IDP.

A efectos del presente documento, la denominaremos la sincronización federada de la Admin Console.  

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

Nota

Si no aparece la pestaña Sincronizar, es posible que su cuenta tenga una Global Admin Console a la que no tenga acceso.

Deberá ponerse en contacto con los administradores de Adobe internos para obtener acceso.

Las organizaciones que

  • usan herramienta de sincronización de usuarios (UST) para sincronizar automáticamente a los usuarios entre Adobe y su Active Directory
  • no permiten que los usuarios se agreguen o creen manualmente en Acrobat Sign, 

deberá crear un grupo de “excepción” para todos los ID de usuario de cuenta técnica. Todos los ID de usuario de cuenta técnica deben tener su grupo principal definido como el grupo exento para garantizar que no se desactiven y que la sincronización automática de usuarios no elimine su licencia.

El grupo de excepciones debe configurarse como exento de la sincronización en la configuración de UST.

En los casos en los que Adobe aloje el UST en representación de la organización del cliente, el administrador del cliente debe comunicar el Nombre del grupo al Success Manager, el administrador de cuentas ténicas o el representante de cuentas para que puedan trabajar con el equipo de soluciones de clientes de Adobe y asegurarse de que este grupo esté exento de la sincronización.

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:

  1. Seleccione Generar un par de claves.

  2. Haga clic en Generar par de claves.

    Generar par de claves

  3. Una vez creado el par de claves, se le pedirá que guarde la clave privada en el sistema local.

    La clave pública se puede copiar desde la interfaz:

    Clave pública

  4. Seleccione Siguiente.

  1. Seleccione Cargar la clave pública.

  2. Arrastre el certificado de clave pública al campo de carga.

  3. Seleccione Siguiente.

    Cargar la clave pública

    La clave pública cargada se muestra en la página Configurar API. Puede copiarla desde aquí.

    Puede cargar claves adicionales o generar nuevas según sea necesario.

  4. Seleccione Siguiente cuando se hayan agregado todas sus claves.

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

  1. Clone el siguiente repositorio: https://github.com/AdobeDocs/adobeio-auth/tree/stage/JWT/samples/adobe-jwt-java

  2. En el archivo config.properties, defina la información de la cuenta técnica:

    • Apikey
    • Technicalaccountid
    • Orgid
    • Secret
    • expirationTime
    • metascopios
    • key_path
    • imshost
    • imsExchange 

  3. Almacene secret.key en el formato DER dentro de la carpeta de destino. 

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ón → Identidad

    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. Vaya a los métodos de API: https://secure.na1.adobesign.com/public/docs/restapi/v6

  2. Seleccione el método GET/usuarios.

  3. 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.

  4. 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

  1. Vaya a los métodos de la API: https://secure.na1.adobesign.com/public/docs/restapi/v6

  2. Seleccione el método POST /users/{userId}/views.

  3. En el campo Autorización:

    1. Escriba la palabra Portador seguida de un espacio.
    2. Pegue el Código de acceso.

  4. En el campo ID de usuario, escriba yo.

  5. Haga clic en el vínculo Esquema de modelo completo.

  6. Haga clic en el campo amarillo para transferir el esquema al campo UserViewInfo.

  7. Edite el campo UserViewInfo:

    • Para el valor de nombre, introduzca ALL. (Todos).
    • Para el valor de autoLoginUser, cámbielo a true.

  8. Haga clic en Probar.

    Configurar API para el token de acceso

    El Cuerpo de respuesta devuelto contiene la dirección URL necesaria para iniciar una sesión como usuario:

    Copiar URL de acceso

  9. Copie la dirección URL y péguela en un explorador.

  10. Se le solicitará que confirme el inicio de sesión.

    Haga clic en Sí.

    Confirme el inicio de sesión.

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. Vaya a los métodos de la API: https://secure.na1.adobesign.com/public/docs/restapi/v6#!/agreements/createAgreement

  3. 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.

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

  5. 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

Logotipo de Adobe Sign

Optimizar tu trabajo con Acrobat Sign
Gestiona y firma documentos online de forma rápida y sencilla.

Abrir la aplicación
Abrir la aplicación

Anterior

Mover un usuario de una organización de Admin Console a otra

Siguiente

Crear cuentas de servicio para enviar acuerdos bajo una entidad funcional

Aprender

card-link-icon

Aprenda con tutoriales en vídeo paso a paso y orientación práctica directamente en la aplicación.

Comunidad

card-link-icon

Participe en debates, encuentre respuestas, aprenda de expertos y comparta sus conocimientos.

Inicio de Adobe

card-link-icon

Acceda a sus aplicaciones y servicios favoritos de Creative Cloud, gestión de archivos y mucho más.