Trabalhar com credenciais working-with-credentials

Exemplos e exemplos neste documento são somente para AEM Forms no ambiente JEE.

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 que você configura para confiança. O AEM Forms usa certificados e credenciais para várias finalidades:

Você pode interagir programaticamente com o serviço de credenciais usando a API Java do Gerenciador de Confiança. Você pode executar as seguintes tarefas:

NOTE
Também é possível importar e excluir certificados usando o console de administração. (Consulte ajuda administrativa.)

Importando Credenciais usando a API do Gerenciador de Confiança importing-credentials-by-using-the-trust-manager-api

Você pode importar programaticamente uma credencial para o AEM Forms usando a API do Gerenciador de Confiança. Por exemplo, você pode importar uma credencial usada para assinar um documento PDF. (Consulte Assinatura digital de documentos PDF).

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 exibida no console de administração, conforme mostrado na ilustração a seguir. Observe que o alias da credencial é Secure.

ww_ww_truststore

NOTE
Não é possível importar uma credencial para o AEM Forms usando serviços da Web.

Resumo das etapas summary-of-steps

Para importar uma credencial para o AEM Forms, execute as seguintes etapas:

  1. Incluir arquivos de projeto.
  2. Criar um cliente de serviço de credencial.
  3. Referencie a 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 uma aplicação 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 projeto:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-truststore-client.jar
  • adobe-utilities.jar (obrigatório se o AEM Forms for implantado no JBoss)
  • jbossall-client.jar (obrigatório se o AEM Forms for implantado no JBoss)

Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo arquivos da biblioteca Java do AEM Forms.

Criar um cliente de serviço de credencial

Antes de importar programaticamente uma credencial para o AEM Forms, crie um cliente de serviço de credencial. Para obter informações, consulte Definindo propriedades de conexão.

Referenciar a credencial

Referencie 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 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

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Início Rápido da API de Serviço de Credencial

Excluindo Credenciais usando a API do Gerenciador de Confiança

Importar credenciais usando a API Java import-credentials-using-the-java-api

Importe uma credencial para o AEM Forms usando a API do Gerenciador de Confiança (Java):

  1. Incluir arquivos de projeto

    Inclua arquivos JAR do cliente, como adobe-truststore-client.jar, no caminho de classe do projeto Java.

  2. Criar um cliente de serviço de credencial

    • Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
    • Crie um objeto CredentialServiceClient usando seu construtor e transmitindo o objeto ServiceClientFactory.
  3. Referenciar a credencial

    • Crie um objeto java.io.FileInputStream usando seu construtor. Transmita um valor de cadeia de caracteres que especifique o local da credencial.
    • Crie um objeto com.adobe.idp.Document que armazene a credencial usando o construtor com.adobe.idp.Document. Passe o objeto java.io.FileInputStream que contém a credencial para o construtor.
  4. Executar a operação de importação

    • Crie uma matriz de cadeia de caracteres que contenha um elemento. Atribua o valor truststore.usage.type.sign ao elemento.

    • Chame o método importCredential do objeto CredentialServiceClient e passe os seguintes valores:

      • Um valor de cadeia de caracteres que especifica o valor de alias da credencial.
      • A instância com.adobe.idp.Document que armazena a credencial.
      • Um valor de cadeia de caracteres que especifica a senha associada à credencial.
      • A matriz de cadeia de caracteres que contém o valor de uso. Por exemplo, você pode especificar este valor truststore.usage.type.sign. Para importar uma credencial de Extensão de Reader, especifique truststore.usage.type.lcre.

Consulte também

Importando Credenciais usando a API do Gerenciador de Confiança

Início rápido (modo SOAP): importação de credenciais usando a API Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Excluindo Credenciais usando a API do Gerenciador de Confiança deleting-credentials-by-using-the-trust-manager-api

Você pode excluir programaticamente uma credencial 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.

NOTE
Não é possível excluir uma credencial no AEM Forms usando serviços da Web.

Resumo das etapas summary_of_steps-1

Para excluir uma credencial, execute as seguintes etapas:

  1. Incluir arquivos de projeto.
  2. Criar um cliente de serviço de credencial.
  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 uma aplicação cliente usando Java, inclua os arquivos JAR necessários. Os seguintes arquivos JAR devem ser adicionados ao classpath do projeto:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-truststore-client.jar
  • adobe-utilities.jar (obrigatório se o AEM Forms for implantado no JBoss)
  • jbossall-client.jar (obrigatório se o AEM Forms for implantado no JBoss)

Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo arquivos da biblioteca Java do AEM Forms.

Criar um cliente de serviço de credencial

Antes de excluir programaticamente uma credencial, 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 Definindo 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

Importar credenciais usando a API Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Importar credenciais usando a API Java

Exclusão de credenciais usando a API Java deleting-credentials-using-the-java-api

Exclua uma credencial do AEM Forms usando a API do Gerenciador de Confiança (Java):

  1. Incluir arquivos de projeto

    Inclua arquivos JAR do cliente, como adobe-truststore-client.jar, no caminho de classe do projeto Java.

  2. Criar um cliente de serviço de credencial

    • Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
    • Crie um objeto CredentialServiceClient usando seu construtor e transmitindo o objeto ServiceClientFactory.
  3. Executar a operação de exclusão

    Invoque o método deleteCredential do objeto CredentialServiceClient e passe um valor de cadeia de caracteres que especifique o valor do alias.

Consulte também

Excluindo Credenciais usando a API do Gerenciador de Confiança

Início rápido (modo SOAP): exclusão de credenciais usando a API Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2