csbase.server.keystore

Class CSKeyStore

java.lang.Object

csbase.server.keystore.CSKeyStore

public final class CSKeyStore
extends Object

Representa um repositório de chaves.

Author:

Tecgraf/PUC-Rio

Method Summary

Modifier and Type	Method and Description
boolean	addCertificate(String alias, Certificate cert) Adiciona um certificado.
boolean	containsAlias(String alias) Verifica se uma determinada entidade existe no repositório.
static void	createInstance(String pathName) Cria a instância única do repositório de chaves.
static void	createInstance(String pathName, String password) Cria a instância única do repositório de chaves.
Certificate	getCertificate(String alias) Obtém um certificado de uma determinada entidade.
static CSKeyStore	getInstance() Obtém a instância única do repositório de chaves.
void	removeCertificate(String alias) Remove o certificado de uma entidade
byte[]	sign(String alias, String privateKeyPassword, String data) Assina um dado em nome de uma entidade.
boolean	verify(String alias, String data, byte[] signedData) Verifica se a assinatura de um determinado dado foi feita pela entidade.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

sign

public byte[] sign(String alias,
                   String privateKeyPassword,
                   String data)
            throws csbase.exception.OperationFailureException

Assina um dado em nome de uma entidade.

Parameters:

alias - O nome da entidade.

privateKeyPassword - A senha da chave privada da entidade.

data - O dado que será assinado.

Returns:

o dado assinado ou null, caso a entidade não esteja cadastrada no repositório de chaves.

Throws:

csbase.exception.OperationFailureException - Caso ocorra alguma falha na operação.

IllegalArgumentException - Caso algum dos parâmetros recebidos seja nulo.

verify

public boolean verify(String alias,
                      String data,
                      byte[] signedData)
               throws csbase.exception.OperationFailureException

Verifica se a assinatura de um determinado dado foi feita pela entidade.

Parameters:

alias - O nome da entidade.

data - O dado que foi assinado.

signedData - A assinatura do dado.

Returns:

true, caso a assinatura seja válida, ou false, caso contrário.

Throws:

csbase.exception.OperationFailureException - Caso ocorra alguma falha na operação.

containsAlias

public boolean containsAlias(String alias)
                      throws csbase.exception.OperationFailureException

Verifica se uma determinada entidade existe no repositório.

Parameters:

alias - O nome da entidade.

Returns:

true, caso a entidade exista, ou false,caso contrário.

Throws:

csbase.exception.OperationFailureException - Caso ocorra alguma falha na operação.

getCertificate

public Certificate getCertificate(String alias)
                           throws csbase.exception.OperationFailureException

Obtém um certificado de uma determinada entidade.

Parameters:

alias - O nome da entidade.

Returns:

O certificado ou null, caso não exista.

Throws:

csbase.exception.OperationFailureException - Caso ocorra alguma falha na operação.

createInstance

public static void createInstance(String pathName)

Cria a instância única do repositório de chaves.

Parameters:

pathName - A localização do arquivo que contém o repositório de chaves.

Throws:

IllegalStateException - Caso já exista uma instância criada.

See Also:

getInstance()

createInstance

public static void createInstance(String pathName,
                                  String password)

Cria a instância única do repositório de chaves.

Parameters:

pathName - A localização do arquivo que contém o repositório de chaves.

password - A senha do repositório de chaves.

Throws:

IllegalArgumentException - Caso a senha seja nula.

IllegalStateException - Caso já exista uma instância criada.

See Also:

getInstance()

getInstance

public static CSKeyStore getInstance()

Obtém a instância única do repositório de chaves.

Returns:

A instância única ou null, caso esta ainda não tenha sido criada.

See Also:

createInstance(String), createInstance(String, String)

addCertificate

public boolean addCertificate(String alias,
                              Certificate cert)

Adiciona um certificado. Se a entidade já possuir um certificado o mesmo será sobreescrito.

Parameters:

alias - O nome da entidade

cert - A instância do certificado

Returns:

indicativo de sucesso.

removeCertificate

public void removeCertificate(String alias)

Remove o certificado de uma entidade

Parameters:

alias - O nome da entidade