Trabalhando com credenciais working-with-credentials
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 são informações de chave pública configuradas para confiança. A AEM Forms usa certificados e credenciais para várias finalidades:
- As extensões do Acrobat Reader DC usam uma credencial para habilitar os direitos de uso do Adobe Reader em documentos do PDF. (Consulte Aplicação de direitos de uso a documentos do PDF.)
- O serviço de assinatura acessa certificados e credenciais ao executar operações como assinar digitalmente documentos PDF. (Consulte Assinar documentos do PDF digitalmente.)
Você pode interagir programaticamente com o serviço de Credencial usando a API Java do Gerenciador de Confiança. Você pode executar as seguintes tarefas:
Importando credenciais usando a API do Gerenciador de Confiança importing-credentials-by-using-the-trust-manager-api
Você pode importar uma credencial para o AEM Forms por programação usando a API do Gerenciador de Confiança. Por exemplo, você pode importar uma credencial usada para assinar um documento PDF. (Consulte Assinar documentos do 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, conforme mostrado na ilustração a seguir. Observe que o alias da credencial é Seguro.
Resumo das etapas summary-of-steps
Para importar uma credencial para o AEM Forms, execute as seguintes etapas:
- Inclua arquivos de projeto.
- Crie um cliente do serviço de credenciais.
- Referencie a credencial.
- 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 estiver 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 Inclusão de arquivos da biblioteca Java do AEM Forms.
Criar um cliente de serviço de credencial
Antes de poder importar uma credencial programaticamente para o AEM Forms, crie um cliente de serviço de credenciais. Para obter mais informações, consulte Configuração das propriedades de conexão.
Referência da 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 fazer referência à credencial, importe a credencial 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 do Java
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Início rápido da API do Serviço de Credenciais
Excluindo Credenciais usando a API do Gerenciador de Confiança
Importar credenciais usando a API do Java import-credentials-using-the-java-api
Importe uma credencial para o AEM Forms usando a API do Gerenciador de Confiança (Java):
-
Incluir arquivos de projeto
Inclua arquivos JAR do cliente, como adobe-truststore-client.jar, no caminho da classe do seu projeto Java.
-
Criar um cliente de serviço de credencial
- Crie um
ServiceClientFactory
objeto que contém propriedades de conexão. - Crie um
CredentialServiceClient
usando seu construtor e passando oServiceClientFactory
objeto.
- Crie um
-
Referência da credencial
- Crie um
java.io.FileInputStream
usando seu construtor. Passe um valor de string que especifica o local da credencial. - Crie um
com.adobe.idp.Document
que armazena a credencial usando ocom.adobe.idp.Document
construtor. Passe ojava.io.FileInputStream
objeto que contém a credencial para o construtor.
- Crie um
-
Executar a operação de importação
-
Crie uma matriz de sequência de caracteres que contenha um elemento. Atribua o valor
truststore.usage.type.sign
ao elemento . -
Chame o
CredentialServiceClient
do objetoimportCredential
e transmita os seguintes valores:- Um valor de string que especifica o valor do alias para a credencial.
- O
com.adobe.idp.Document
que armazena a credencial. - Um valor da string que especifica a senha associada à credencial.
- A matriz da string que contém o valor de uso. Por exemplo, é possível especificar esse valor
truststore.usage.type.sign
. Para importar uma credencial de Extensão do Reader, especifiquetruststore.usage.type.lcre
.
-
Consulte também
Importando credenciais usando a API do Gerenciador de Confiança
Início rápido (modo SOAP): Como importar credenciais usando a API do Java
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das 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 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.
Resumo das etapas summary_of_steps-1
Para excluir uma credencial, execute as seguintes etapas:
- Inclua arquivos de projeto.
- Crie um cliente do serviço de credenciais.
- 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 estiver 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 Inclusão de arquivos da biblioteca Java do AEM Forms.
Criar um cliente de serviço de credencial
Antes de excluir uma credencial por programação, crie um cliente do 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 mais informações, consulte Configuração das 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 é lançada.
Consulte também
Importar credenciais usando a API do Java
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Importar credenciais usando a API do Java
Exclusão de credenciais usando a API do Java deleting-credentials-using-the-java-api
Exclua uma credencial do AEM Forms usando a API do Gerenciador de confiança (Java):
-
Incluir arquivos de projeto
Inclua arquivos JAR do cliente, como adobe-truststore-client.jar, no caminho da classe do seu projeto Java.
-
Criar um cliente de serviço de credencial
- Crie um
ServiceClientFactory
objeto que contém propriedades de conexão. - Crie um
CredentialServiceClient
usando seu construtor e passando oServiceClientFactory
objeto.
- Crie um
-
Executar a operação de exclusão
Chame o
CredentialServiceClient
do objetodeleteCredential
e transmita um valor de string que especifica 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 do Java
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão