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. A AEM Forms usa certificados e credenciais para vários fins:
Você pode interagir programaticamente com o serviço de Credenciais usando a API Java do Trust Manager. É possível executar as seguintes tarefas:
Também é possível importar e excluir certificados usando o console de administração. (Consulte ajuda administrativa.)
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 é Secure.
Não é possível importar uma credencial para o AEM Forms usando serviços da Web.
Para importar uma credencial para o AEM Forms, execute as seguintes etapas:
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:
Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo os arquivos da biblioteca Java da 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 start 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
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Start rápidos da API do serviço de credenciais
Excluindo credenciais usando a API do Gerenciador de Confiança
Importe uma credencial para o AEM Forms usando a API do Trust Manager (Java):
Incluir arquivos de projeto
Inclua arquivos JAR do cliente, como adobe-truststore-client.jar, no caminho de classe do seu projeto Java.
Criar um cliente de serviço de credenciais
ServiceClientFactory
que contenha propriedades de conexão.CredentialServiceClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Referência à credencial
java.io.FileInputStream
usando seu construtor. Passe um valor de string que especifica o local da credencial.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.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 CredentialServiceClient
do objeto importCredential
e passe os seguintes valores:
com.adobe.idp.Document
que armazena a credencial.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
Start rápido (modo SOAP): Importando credenciais usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
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.
Para excluir uma credencial, execute as seguintes etapas:
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:
Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo os arquivos da biblioteca Java da 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:
Importar credenciais usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Importar credenciais usando a API Java
Exclua uma credencial da AEM Forms usando a API do Trust Manager (Java):
Incluir arquivos de projeto
Inclua arquivos JAR do cliente, como adobe-truststore-client.jar, no caminho de classe do seu projeto Java.
Criar um cliente de serviço de credenciais
ServiceClientFactory
que contenha propriedades de conexão.CredentialServiceClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Executar a operação de exclusão
Chame o método CredentialServiceClient
do objeto deleteCredential
e passe um valor de string que especifique o valor alias.
Consulte também:
Excluindo credenciais usando a API do Gerenciador de Confiança
Start rápido (modo SOAP): Excluindo credenciais usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão