Guia do Usuário Cancelar

Criação de contas técnicas para enviar contratos por meio da API

 

Guia do Adobe Acrobat Sign

Novidades

Introdução

Administrar

Enviar, assinar e gerenciar contratos

Recursos e fluxos de trabalho avançados de contratos

Integrar a outros produtos

Acrobat Sign Developer

Suporte e solução de problemas

Contas técnicas do Adobe Acrobat Sign

As contas técnicas do Acrobat Sign são um meio de ativar as contas de nível corporativo com a capacidade de executar seus aplicativos sob a autoridade de uma userID gerada explicitamente para essa finalidade (em vez de usar a userID pessoal do administrador).

As contas técnicas estão disponíveis para clientes corporativos (por meio do Adobe Developers Console) no plano de compra ETLA que gerencia sua conta por meio do Adobe Admin Console.

O cartão do produto para acesso técnico à conta pode ser encontrado na guia Produtos do Admin Console sob o nome da oferta Adobe Acrobat Sign Solutions - Enterprise (Procure o sinalizador da API disponível):

Cartões de produto de conta técnica

Observação:

O processo abaixo descreve o uso de Contas técnicas por meio de uma solução de API. As organizações que desejam permitir que os usuários enviem contratos manualmente em nome de uma parte centralizada devem consultar o documento para a configuração de contas técnicas por conexão manual.

Pré-requisitos

Para ativar uma conta técnica, a conta do Acrobat Sign deve:

  • Ter um serviço ETLA de nível corporativo
  • Gerenciar usuários no Adobe Admin Console*
  • Ter o Compartilhamento de conta avançado ativado

* Uma observação sobre o Adobe Admin Console

O Adobe Admin Console fornece uma estrutura para gerenciamento de usuários e alocação de licenças. A maioria dos clientes tem apenas um Admin Console.

No entanto, alguns clientes com requisitos complexos de usuário/licenciamento podem ter vários Admin Consoles, o que pode se tornar confuso em um processo como a criação de conta técnica, em que um Admin Console pode controlar o gerenciamento de usuários federados e outro gerencia o licenciamento do Acrobat Sign.

Se você sabe que tem várias contas ou não tem certeza, leia o seguinte:

Visão geral

A criação de uma conta técnica é um processo de várias etapas que requer acesso de nível de administrador ao Console do Adobe Acrobat e autoridade de administrador de nível de conta no Acrobat Sign.

O processo exige que o administrador:

  1. Ative o acesso de administrador ou desenvolvedor para o usuário que criará a conta técnica.
    • O usuário deve ser um administrador ou desenvolvedor para definir as configurações que criam a conta técnica.
  2. Crie um novo projeto no Adobe Developer Console (Adobe.io).
    • O projeto é o ambiente necessário para manter o par de chaves pública/privada e o token de acesso que permite a funcionalidade da conta técnica.
  3. Crie ou faça upload de um par de chaves pública/privada e gerar um token de acesso.
    • Gerar o token de acesso cria a userID da conta técnica no Adobe Admin Console e a preenche no sistema do Acrobat Sign.
  4. (Opcional) Criar um novo grupo no sistema do Acrobat Sign.
    • A criação de um grupo dedicado para a userID da conta técnica permite uma configuração muito restrita das propriedades do contrato que podem ser muito rígidas ou diferentes de outras configurações de grupo.
  5. Privilégio da userID da conta técnica no Acrobat Sign como um administrador de nível de grupo.
  6. Crie um novo usuário federado no Adobe Admin Console.
    • Isso cria um email de usuário com seu domínio para proxy da useID da conta técnica no envio, fornecendo um endereço de email devidamente atribuído à sua empresa.
  7. Compartilhe a conta do usuário federado com a conta técnica.
    • A userID da conta técnica é gerada no Admin Console de licenciamento com um endereço de email adobe.com. Ao compartilhar a conta do usuário federado, você concede acesso à userID da conta técnica para enviar em nome da userID federada, fornecendo um nome/endereço de email mais amigável para os destinatários.

    Quando concluída, a API pode ser configurada para usar a conta técnica (por meio do código de acesso) para criar e enviar contratos em nome de um usuário centralizado.

Permita que os usuários acessem o Console para desenvolvedores

Antes de poder adicionar uma nova conta técnica, o usuário deve primeiro ser adicionado ao perfil de produto Adobe Acrobat Sign Solutions - Enterprise (no Admin Console de licenciamento) como Administrador ou Desenvolvedor.

  1. Clique no link Adobe Acrobat Sign Solutions - Enterprise no painel à esquerda ou nos produtos.

  2. Selecione o perfil de produto padrão para o serviço do Acrobat Sign.

    Selecionar perfil de produto

  3. A página Adicionar usuários a este produto abre:

    • Clique na guia Administrador ou Desenvolvedor.
  4. Insira o endereço de email do usuário ao qual você deseja conceder acesso.

  5. Clique em Adicionar administrador/desenvolvedor.

    Adicionar desenvolvedor

  6. Insira o endereço de email do usuário ao qual você deseja conceder acesso.

  7. Insira o nome e o sobrenome.

  8. Selecione Salvar ao concluir.

    Inserir informações do desenvolvedor

Criar um novo projeto no Console do Adobe.io

  1. Navegue até https://console.adobe.io

    • Se você pertencer a várias instâncias do Admin Console, verifique se está conectado à instância que se alinha com o Admin Console de licenciamento clicando na seta para baixo no canto superior direito da janela.
    Instâncias do Admin Console

  2. Selecione Criar novo projeto.

    Criar um novo projeto

  3. O novo projeto é exibido na guia Projetos do console.

    Nomeie o projeto clicando no botão Editar projeto.

    • Forneça um nome que seus colegas entenderão
    • Forneça uma breve descrição
    • Salvar as edições
    Editar o projeto

  4. Selecione o novo projeto (na guia Projetos) para abri-lo para configuração.

    Na página Introdução:

    1. Selecionar Adicionar ao projeto
    2. Selecionar API na lista suspensa
    Adicionar API

  5. Na página Adicionar uma API:

    1. Selecione o filtro Document Cloud
    2. Selecione Acrobat Sign
    3. Clique em Avançar.
    Selecione Acrobat Sign

Criar um novo token da Web JSON

Você tem a opção de gerar um novo par de chaves pública/privada ou fazer upload da sua chave pública. Escolha a opção mais adequada às suas necessidades:

Selecionar o perfil de produto

A página Configurar API é atualizada para mostrar os perfis de produto disponíveis para sua conta. Você pode ter um ou mais, dependendo dos perfis disponíveis para sua conta.

  1. Marque a caixa de seleção do Adobe Acrobat Sign Solutions - Enterprise padrão.
  2. Salvar API configurada quando estiver pronto.
Salvar API configurada

Gerar um token de acesso

Depois de salva, a conta técnica é criada e você retornará à página inicial do projeto.

Na seção Gerar token de acesso, há um campo de entrada para sua chave privada.

  1. Cole a chave privada gerada/carregada anteriormente no campo Chave privada.

  2. Selecione Gerar token.

  3. Depois de um momento, o campo Chave privada é atualizado para exibir o Token de acesso.

  4. Copie e salve o token de acesso.

    Gerar o token de acesso

  5. Na parte inferior da mesma página, você tem acesso ao:

    • ID do cliente
    • Segredo do cliente
    • ID da conta técnica
    • Email da conta técnica
    • ID da organização

    Copie e salve o Email da conta técnica.

    Salvar o email da conta técnica

Considere gerar um grupo exclusivo no Acrobat Sign para o aplicativo

Os grupos do Acrobat Sign permitem a configuração granular das configurações de segurança e experiência para o recipient (bem como workflows, modelos, relatórios etc.)

Se quiser isolar a userID da conta técnica em seu próprio grupo:

  1. Faça logon no Acrobat Sign como administrador em nível de conta.

  2. Navegue até a guia Grupos no menu do administrador.

  3. Clique no sinal de mais para criar um novo grupo.

  4. Insira um nome intuitivo para o grupo (talvez o mesmo nome que o Projeto).

  5. Salve o grupo.

  6. (Opcional) Abra o novo grupo e defina as configurações necessárias para o aplicativo.

    Criar um grupo

Observação:

Se sua organização

  • está usando a Ferramenta de sincronização de usuários (UST) para sincronizar automaticamente os usuários entre a Adobe e o Active Diretory
  • não permite que usuários sejam adicionados ou criados manualmente no Acrobat Sign

você deve criar um grupo de exceções para ser o grupo principal de todas as userIDs de conta técnica.

O nome do grupo é adicionado à configuração da UST para garantir que o processo de sincronização não afete as userIDs, fazendo com que elas sejam desativadas ou que seus direitos sejam removidos.

Privilégio da userID da conta técnica como administrador de grupo no Acrobat Sign

Aguarde alguns minutos para que o usuário techacct.adobe.com recém-criado seja gerado no sistema do Acrobat Sign.

  1. Faça logon na sua conta do Acrobat Sign como administrador no nível da conta.

  2. Navegue até a guia Usuários do menu do administrador.

  3. Procure o novo endereço de email techacct.adobe.com (copiado da home page do projeto).

  4. Clique no usuário e selecione Editar detalhes do usuário.

    Editar detalhes de usuário

  5. Clique no ícone de mais na seção Associação de grupo e adicione o grupo do aplicativo ao perfil do usuário.

  6. Selecione o grupo do aplicativo e clique em Marcar como link principal.

  7. Marque a caixa para sinalizar a userID como um Administrador de grupo.

  8. (Opcional) Remova a conta técnica do grupo Padrão.

  9. Clique em Salvar ao concluir.

    Salvar as configurações do usuário

Criar um usuário/email Responder para

O envio de contratos usando a userID/email vinculada à conta técnica é problemático porque o email não está no domínio da sua empresa.

Para solucionar esse problema:

  • Uma nova userID federada deve ser criada no Admin Console de licenciamento.
  • A userID da conta técnica deve ser compartilhada com a nova userID federada (por meio do compartilhamento de conta avançado).

Depois de configuradas, as chamadas de API devem ser configuradas para usar o token de conta técnica como o valor Autorização e a userId ou o email da userID compartilhada como o valor x-on-behalf-of-user .

Criar uma nova userID federada

Antes de criar a nova userID, você deve identificar um endereço de email que possa ser usado para respostas/perguntas de entrada de seus destinatários.

Para criar a nova userId:

  1. Faça logon no (Federated Sync) Admin Console como administrador.

  2. Navegue até: Configurações → Identidade

    Selecione um diretório para criar o novo usuário.

    Domínio ativo

  3. Selecione a guia Sincronizar.

  4. Selecione Ir para Configurações e clique em Ativar edição.

    Quando a edição estiver ativada, seu Adobe Admin Console permitirá edições nos dados do usuário somente no admin console. Seu IdP não está atualizado com as edições.

    Configurações do diretório - guia Sincronização

    Observação:

    A edição permanecerá ativada por apenas uma hora, ou até ser desativada manualmente.

    Conta técnica

  5. Faça logon em Licenciamento Admin Console (se você estiver trabalhando com vários Admin Consoles).

  6. Navegue até: Usuários → Adicionar usuário.

  7. Configure sua nova userID com:

    • Email ou nome de usuário: Use o endereço de email que desejar para capturar qualquer resposta aos emails dos destinatários.
    • Tipo de ID: Federated ID
    • Nome/Sobrenome: esse valor é usado no sistema Acrobat Sign e é refletido no relatório de auditoria. Use um valor que forneça contexto. por exemplo: Recursos Humanos
    • Nome de usuário do SSO: Use o mesmo valor de email.
    • País/Região: Selecione o país ou a região apropriada para sua empresa.
    • Selecione o produto/perfil da Acrobat Sign ao qual a userID técnica está associada.
    • Defina a função de usuários como Usuário.

    Clique em Salvar ao concluir.

    Conta técnica

  8. Faça logon novamente no Federated Sync Admin Console para ativar a sincronização dos dados do IdP.

  9. Navegue de volta para Configurações → Identidade → {Diretório} → Sincronizar → Ir para Configurações.

    Clique em Desativar edição para reativar a sincronização de dados com seu IdP.

  10. Sua nova userID será gerada automaticamente no sistema Acrobat Sign.

Compartilhe a conta técnica com a nova userID federada

Para obter acesso ao conteúdo de uma userID na qual você pode fazer login, o

  1. Faça logon no Acrobat Sign como administrador da conta.

  2. Navegue até a guia Usuários no menu do administrador.

  3. Clique uma vez no novo usuário e Editar Detalhes do Usuário.

  4. Selecione Status do Compartilhamento no menu à esquerda.

    Verifique se a guia Conta de usuários compartilhada com está selecionada.

  5. Selecione a guia Compartilhado com usuário na parte superior da página Status do compartilhamento.

  6. Compartilhe a nova conta do userID com a conta técnica

    1. Clique no ícone de adição na linha superior direita para abrir a interface do seletor.
    2. Clique no ícone de três linhas à direita da caixa de pesquisa.
    3. Expanda o grupo onde a userID da conta técnica está.
    4. Clique no ícone de adição ao lado da userID da conta técnica para selecioná-la.
    5. Marque a Permissão adicional para permitir Enviando.
    6. Clique em Salvar.
    Conta técnica

Testar sua nova conta técnica

Para testar se o código de acesso está funcionando corretamente:

  1. Selecione o método GET /users.

  2. No campo Autorização:

    1. Digite a palavra Portador , seguido por um espaço
    2. Cole no Código de acesso
    3. Clique em Experimente!
    Experimente!

  3. O corpo da resposta retornará com uma lista dos usuários na conta e um Código de resposta de 200:

    Corpo da resposta

Testar o envio de um contrato usando a conta técnica em nome da nova userID por meio da API

  1. Obtenha uma transientDocumentId ou tenha outro método para anexar um arquivo pronto.

  2. No campo Autorização:

    1. Digite a palavra Portador seguida por um espaço
    2. Colar no Token de acesso
      da conta técnica
    3. No campo x-on-behalf-of-user, insira o endereço de email da nova userID
    4. Complete o restante da AgreementInfo com transientDocumentId, nome do contrato, tipo de assinatura e estado.
    5. Clique em Experimente!
    Experimente!

  3. Faça logon no Acrobat Sign como a nova userID e navegue até a guia Gerenciar .

  4. Ao revisar o registro de auditoria do contrato, você verá que o contrato foi enviado pela conta técnica em nome da nova userID.

Revise o conteúdo gerado em nome da nova userID por meio da interface do Acrobat Sign

Quando a conta técnica cria um contrato em nome da Federated userID, o contrato é publicado na página Gerenciar da Federated userID.

Está na página Gerenciar das Federated UserIDs que você pode visualizar e gerenciar o contrato.

Contrato enviado em nome do usuário

Receba ajuda com mais rapidez e facilidade

Novo usuário?