Show Menu
TÓPICOS×

Trabalhar com credenciais

Sobre o serviço de credenciais
Uma credencial contém suas informações de chave privada necessárias para assinar ou identificar documentos. Um certificado é uma informação de chave pública configurada para confiança. O AEM Forms usa certificados e credenciais para vários fins:
  • As extensões do Acrobat Reader DC usam uma credencial para habilitar os direitos de uso do Adobe Reader em documentos PDF. (Consulte Aplicar direitos de uso a documentos PDF.)
  • O serviço de assinatura acessa certificados e credenciais enquanto executa operações como assinar digitalmente documentos PDF. (Consulte Assinatura digital de documentos PDF.)
Você pode interagir programaticamente com o serviço de Credenciais usando a API Java do Trust Manager. Você pode executar as seguintes tarefas:
Também é possível importar e excluir certificados usando o console de administração. (Consulte a ajuda administrativa. )

Importando credenciais usando a API do Gerenciador de Confiança

Você pode importar uma credencial para o AEM Forms de forma programática usando a API do Trust Manager. Por exemplo, é possível importar uma credencial usada para assinar um documento PDF. (Consulte Assinando documentos PDF digitalmente).
Ao importar uma credencial, especifique um alias para a credencial. O alias é usado para executar uma operação do Forms que requer uma credencial. Depois de importada, uma credencial pode ser visualizada no console de administração, como mostrado na ilustração a seguir. Observe que o alias da credencial é Seguro .
Não é possível importar uma credencial para o AEM Forms usando serviços da Web.

Resumo das etapas

Para importar uma credencial para o AEM Forms, execute as seguintes etapas:
  1. Incluir arquivos de projeto.
  2. Crie um cliente de serviço de credenciais.
  3. Faça referência à credencial.
  4. Execute a operação de importação.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Os seguintes arquivos JAR devem ser adicionados ao classpath do seu projeto:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-truststore-client.jar
  • adobe-utilities.jar (obrigatório se o AEM Forms for implantado em JBoss)
  • jbossall-client.jar (obrigatório se o AEM Forms for implantado em JBoss)
Para obter informações sobre a localização desses arquivos JAR, consulte Inclusão de arquivos da biblioteca Java do AEM Forms.
Criar um cliente de serviço de credenciais
Antes de poder importar programaticamente uma credencial para o AEM Forms, crie um cliente de serviço de credenciais. Para obter informações, consulte Configuração de propriedades de conexão.
Referência à credencial
Faça referência a uma credencial que você deseja importar para o AEM Forms. O início rápido associado a esta seção faz referência a um arquivo P12 localizado no sistema de arquivos.
Executar a operação de importação
Depois de referenciar a credencial, importe-a para o AEM Forms. Se a credencial não for importada com êxito, uma exceção será lançada. Ao importar uma credencial, especifique um alias para a credencial.
Consulte também:

Importar credenciais usando a API Java

Importe uma credencial para o AEM Forms usando a API do Trust Manager (Java):
  1. Incluir arquivos de projeto
    Inclua arquivos JAR do cliente, como adobe-truststore-client.jar, no caminho de classe do seu projeto Java.
  2. Criar um cliente de serviço de credenciais
    • Crie um ServiceClientFactory objeto que contenha propriedades de conexão.
    • Crie um CredentialServiceClient objeto usando seu construtor e transmitindo o ServiceClientFactory objeto.
  3. Referência à credencial
    • Crie um java.io.FileInputStream objeto usando seu construtor. Passe um valor de string que especifica o local da credencial.
    • Crie um com.adobe.idp.Document objeto que armazene a credencial usando o com.adobe.idp.Document construtor. Passe o java.io.FileInputStream objeto que contém a credencial para o construtor.
  4. Executar a operação de importação
    • Crie uma matriz de string que armazena um elemento. Atribua o valor truststore.usage.type.sign ao elemento.
    • Chame o método do CredentialServiceClient objeto importCredential e passe os seguintes valores:
      • Um valor de string que especifica o valor alias da credencial.
      • A com.adobe.idp.Document instância que armazena a credencial.
      • Um valor de string que especifica a senha associada à credencial.
      • A matriz de string que contém o valor de uso. Por exemplo, você pode especificar esse valor truststore.usage.type.sign . Para importar uma credencial do Reader Extension, especifique truststore.usage.type.lcre .
Consulte também:

Excluindo credenciais usando a API do Gerenciador de confiança

Você pode excluir uma credencial por programação usando a API do Gerenciador de confiança. Ao excluir uma credencial, especifique um alias que corresponda à credencial. Depois de excluída, uma credencial não pode ser usada para executar uma operação.
Não é possível excluir uma credencial no AEM Forms usando serviços da Web.

Resumo das etapas

Para excluir uma credencial, execute as seguintes etapas:
  1. Incluir arquivos de projeto.
  2. Crie um cliente de serviço de credenciais.
  3. Execute a operação de exclusão.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Os seguintes arquivos JAR devem ser adicionados ao classpath do seu projeto:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-truststore-client.jar
  • adobe-utilities.jar (obrigatório se o AEM Forms for implantado em JBoss)
  • jbossall-client.jar (obrigatório se o AEM Forms for implantado em JBoss)
Para obter informações sobre a localização desses arquivos JAR, consulte Inclusão de arquivos da biblioteca Java do AEM Forms.
Criar um cliente de serviço de credenciais
Antes de poder excluir uma credencial programaticamente, crie um cliente de serviço de Integração de dados. Ao criar um cliente de serviço, você define as configurações de conexão necessárias para chamar um serviço. Para obter informações, consulte Configuração de propriedades de conexão.
Executar a operação de exclusão
Para excluir uma credencial, especifique o alias que corresponde à credencial. Se você especificar um alias que não existe, uma exceção será lançada.
Consulte também:

Excluindo credenciais usando a API Java

Exclua uma credencial do AEM Forms usando a API do Trust Manager (Java):
  1. Incluir arquivos de projeto
    Inclua arquivos JAR do cliente, como adobe-truststore-client.jar, no caminho de classe do seu projeto Java.
  2. Criar um cliente de serviço de credenciais
    • Crie um ServiceClientFactory objeto que contenha propriedades de conexão.
    • Crie um CredentialServiceClient objeto usando seu construtor e transmitindo o ServiceClientFactory objeto.
  3. Executar a operação de exclusão
    Chame o método do CredentialServiceClient objeto deleteCredential e passe um valor de string que especifique o valor alias.
Consulte também: