Clique no link Adobe Acrobat Sign Solutions - Enterprise no painel à esquerda ou nos produtos.
Última atualização em
01/12/2023
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):
Nota
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:
A dificuldade com vários Admin Console é garantir que você esteja no console correto para as ações que está tentando executar.
Para determinar se você tem vários Admin Consoles:
1. Faça logon no Admin Console.
2. No canto superior direito do console, clique no nome da organização.
Se você tiver um menu suspenso com várias organizações, terá vários Admin Console.
Se você tiver apenas um Admin Console, as operações de criação e licenciamento do usuário ocorrem na mesma organização e você não precisa se preocupar em alternar entre consoles.
Se você tiver vários Admin Consoles, determine qual organização gerencia a criação de usuários federados e qual controla o provisionamento de licenças do Acrobat Sign.
Empresas com vários Admin Consoles podem implantar o Acrobat Sign em mais de um. Você deve identificar o Admin Console correto onde deseja estabelecer a conexão da API e o usuário da conta técnica.
Você deve inspecionar cada organização para determinar qual deve conter a conta técnica.
- Selecione a organização.
- Selecione Produtos no painel superior de opções.
- Procure o cartão de produto Adobe Sign - Enterprise com o sinalizador da API disponível.
Para o propósito deste documento, chamaremos de Admin Console de licenciamento. Esta é a organização onde:
- Você define o usuário administrador ou desenvolvedor que conectará a API.
- O usuário da conta técnica é criado e gerenciado.
As organizações que usam o gerenciamento de usuários federados devem dessincronizar a solução federada para criar um usuário fora do ambiente federado.
Para fazer isso, você deve inspecionar cada organização para descobrir qual controla os domínios que habilitam a relação de confiança federada. Vários Admin Consoles podem Confiar em um domínio, mas apenas um o controla ativamente.
- Selecionar a organização
- Selecione Configurações no painel superior de opções.
- Selecione Identidade no painel esquerdo de opções.
- Se houver diretórios listados com o Tipo como Federated ID e o Status como Confiável, clique na linha em que o diretório está para expor a Organização proprietária.
A Organização proprietária é o Admin Console correto para manipular os controles de sincronização de Federated ID.
- Um email é fornecido para o administrador do console se você não tiver acesso no momento.
Se o Tipo é Federated ID e o Status é Ativo, clique no Nome do diretório para abrir as configurações do diretório.
Na página de configurações, selecione a guia Sincronizar , que abre as informações de sincronização do IDP.
Para o propósito deste documento, chamaremos de Admin Console de sincronização federada.
Nota
Se você não vir a guia Sincronizar, sua conta pode ter um Global Admin Console ao qual você não tem acesso.
Você precisará entrar em contato com os administradores internos da Adobe para obter acesso.
Organizações que
- utilizam a Ferramenta de sincronização de usuário (UST) para sincronizar automaticamente os usuários entre a Adobe e seu Active Diretory
- não permitem que usuários sejam adicionados ou criados manualmente no Acrobat Sign
devem criar um grupo de “exceção” para todas as userIDs de conta técnica. Todas as userIDs de contas técnicas devem ter seu grupo principal definido como o grupo isento para garantir que não sejam desativadas e não tenham suas licenças removidas pela sincronização automática de usuários.
O grupo de exceções deve ser configurado como isento da sincronização na configuração de UST.
Nos casos em que a Adobe hospeda a UST em nome da organização do cliente, o administrador do cliente deve comunicar o Nome do grupo para seu Gerente de sucesso, Gerente de conta técnica ou representante de conta para que possam trabalhar com a equipe do Adobe Customer Solutions para garantir que esse grupo seja isento da sincronização.
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:
- 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.
- 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.
- 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.
- Gerar o token de acesso cria a userID da conta técnica no Adobe Admin Console e a preenche no sistema do Acrobat Sign.
- (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.
- Privilégio da userID da conta técnica no Acrobat Sign como um administrador de nível de grupo.
- 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.
- 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.
- 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.
-
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.
- 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.
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.
- Marque a caixa de seleção do Adobe Acrobat Sign Solutions - Enterprise padrão.
- Salvar API configurada quando estiver pronto.
-
Clonar o seguinte repositório: https://github.com/AdobeDocs/adobeio-auth/tree/stage/JWT/samples/adobe-jwt-java
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:
Nota
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.
-
Procure o novo endereço de email techacct.adobe.com (copiado da home page do projeto).
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 .
-
Faça logon no (Federated Sync) Admin Console como administrador.
-
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.
NotaA edição permanecerá ativada por apenas uma hora, ou até ser desativada manualmente.
-
Faça logon em Licenciamento Admin Console (se você estiver trabalhando com vários Admin Consoles).
-
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.
-
Compartilhe a nova conta do userID com a conta técnica
- Clique no ícone de adição na linha superior direita para abrir a interface do seletor.
- Clique no ícone de três linhas à direita da caixa de pesquisa.
- Expanda o grupo onde a userID da conta técnica está.
- Clique no ícone de adição ao lado da userID da conta técnica para selecioná-la.
- Marque a Permissão adicional para permitir Enviando.
- Clique em Salvar.
Testar sua nova conta técnica
Para testar se o código de acesso está funcionando corretamente:
-
Navegue até os métodos da API: https://secure.na1.adobesign.com/public/docs/restapi/v6
-
Acesse os métodos de API: https://secure.na1.adobesign.com/public/docs/restapi/v6
Testar o envio de um contrato usando a conta técnica em nome da nova userID por meio da API
-
Acesse os métodos de API: https://secure.na1.adobesign.com/public/docs/restapi/v6#!/agreements/createAgreement
-
No campo Autorização:
- Digite a palavra Portador seguida por um espaço
- Colar no Token de acesso
da conta técnica - No campo x-on-behalf-of-user, insira o endereço de email da nova userID
- Complete o restante da AgreementInfo com transientDocumentId, nome do contrato, tipo de assinatura e estado.
- Clique em Experimente!
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.
Simplifique seu trabalho com o Acrobat Sign
Gerencie e assine documentos online de forma rápida e fácil.
