Configure o acesso x-on-behalf-user quando uma Conta Técnica precisar executar operações da API do Analyzer para usuários específicos na mesma organização.
Quando o acesso on-behalf está habilitado, um aplicativo central pode trabalhar com documentos e dados do Analyzer pertencentes ao usuário sem exigir tokens de autenticação individuais.
O que o acesso on-behalf permite
Uma Conta Técnica pode agir em nome de um usuário aprovado para:
- Acessar os documentos do usuário.
- Recuperar valores extraídos dos documentos do usuário.
- Pesquisar os dados do usuário.
- Fazer upload de documentos para o usuário.
- Extrair atributos configurados pelo usuário.
O acesso se aplica apenas a usuários explicitamente aprovados para a Conta Técnica.
Requisitos
Antes de solicitar acesso on-behalf:
- Configure a Conta Técnica para acesso à API do Analyzer.
- Faça pelo menos uma chamada de API do Analyzer bem-sucedida usando a Conta Técnica.
- Certifique-se de que cada usuário pertence à mesma organização que a Conta Técnica.
- Colete o endereço de email exato para cada usuário que requer acesso on-behalf.
A Adobe rejeita solicitações on-behalf para usuários de outra organização ou quando o endereço de email fornecido não corresponde exatamente à conta do usuário.
Identifique a Conta Técnica
Identifique a Conta Técnica que gera o token de acesso OAuth e faz as solicitações de API.
Para encontrar o ID da Conta Técnica:
- Abra o projeto no Adobe Developer Console.
- Abra a credencial servidor para servidor do OAuth usada para o Analyzer.
- Abra a página usada para gerar um token de acesso.
- Localize o ID de conta técnica.
O ID da Conta Técnica termina com @techacct.adobe.com.
Verifique se o ID pertence à Conta Técnica que sua integração usa antes de enviar a solicitação da lista de permissões.
Identificar os usuários
Crie uma lista dos usuários em nome dos quais a Conta Técnica precisa atuar.
Para cada usuário:
- Colete o endereço de email exato da conta Adobe do usuário.
- Verifique se o usuário pertence à mesma organização da conta técnica.
Apenas usuários incluídos na lista de permissões aprovada podem ser acessados por meio de solicitações on-behalf.
Solicitar acesso on-behalf
O Suporte da Adobe gerencia a lista de permissões para cada conta técnica.
O administrador de sistema da organização deve enviar uma solicitação de suporte que inclua:
- O ID da conta técnica terminado em @techacct.adobe.com.
- A lista completa de endereços de email de usuários para incluir na lista de permissões.
- Confirmação da aprovação do administrador de sistema da organização.
A Adobe revisa a solicitação e configura os usuários aprovados para a conta técnica.
A conta técnica deve concluir pelo menos uma chamada de API do Analyzer bem-sucedida antes que a Adobe possa atualizar sua configuração.
Fazer uma solicitação de API em nome de um usuário
Após a Adobe aprovar a lista de permissões, inclua o cabeçalho x-on-behalf-user nas solicitações que devem ser executadas em nome de um usuário aprovado.
Defina o valor do cabeçalho para o endereço de email aprovado do usuário:
x-on-behalf-user: user@example.com
Continue a autenticar a solicitação com o token de portador servidor para servidor OAuth da conta técnica.
A solicitação é executada no contexto do usuário identificado pelo cabeçalho x-on-behalf-user. O usuário deve estar na lista de permissões aprovada da conta técnica.
Experimente o Acrobat na Web
Crie, edite e compartilhe PDF online.
