Gestión del ciclo de vida de las claves criptográficas en HSM.
Véase Documentación técnica de HSM.
Funciones | |
| IntPtr | GenerateKey (cadena KeyId, DinamoClient.KEY_ALG Alg, bool Exportable) |
| Genera una clave permanente en el HSM. | |
| IntPtr | GenerateKey (cadena KeyId, DinamoClient.KEY_ALG Alg, bool Exportable, bool Temporal) |
| Generar llave. | |
| IntPtr | GetUserKey (cadena KeyId) |
| Devuelve el Handler de una clave (DestroyUserKey debe ser llamado después de la asignación). | |
| void | DestroyKey (IntPtr hKey) |
| Suelte la palanca de la llave. | |
| int | GetKeyAlgId (cadena strKeyId) |
| Devuelve el algoritmo de una clave. | |
| int | GetKeyAlgId (IntPtr hKey) |
| Devuelve el tipo de una clave. | |
| int | GetKeyPadding (IntPtr hKey) |
| Devuelve el tipo de relleno de una clave. | |
| int | GetUserKeyLen (cadena KeyId) |
| Devuelve el tamaño de una clave. | |
| int | GetUserKeyLen (IntPtr hKey) |
| Devuelve el tamaño de una clave. | |
| bool | IsKeyExist (cadena KeyId) |
| bool | HasObject (cadena Id) |
| Verifica la existencia de un objeto. | |
| void | GetMapInfo (cadena ObjectId, cadena Obj1Id, cadena Obj2Id) |
| Recupera información cartográfica (compatibilidad con versiones anteriores) | |
| void | GetMapInfo (cadena ObjectId, cadena Obj1Id, int Obj1TypeId, cadena Obj2Id, int Obj2TypeId) |
| Recupera información cartográfica. | |
| List< CertAssociation > | ListCertAssociations (bool onlyWithAssociation=false) |
| Lista los certificados y sus claves privadas asociadas. | |
| bool | IsKeyReadLock (cadena KeyId) |
| Comprueba si la clave es exportable. | |
| bool | IsKeyReadLock (IntPtr hKey) |
| Comprueba si la clave es exportable. | |
| bool | IsKeyEncrypted (cadena KeyId) |
| Comprueba que la clave está encriptada. | |
| bool | IsKeyEncrypted (IntPtr hKey) |
| Comprueba que la clave está encriptada. | |
| void | BlockObject (cadena szObjectName, bool bBlock) |
| Cambia el estado de bloqueo de un objeto. | |
| bool | IsObjectBlocked (cadena szObjectName) |
| Recupera el estado bloqueado de un objeto. | |
| void | GenerateMap (cadena MapId, cadena Obj1Id, ALG Obj1Type, cadena Obj2Id, ALG Obj2Type) |
| void | RemoveObject (cadena ObjectId) |
| Elimina un objeto del HSM. | |
| void | RemoveObjectIfExists (cadena ObjectId) |
| Elimina un objeto del HSM, si existe. | |
| cadena[] | ListObjects () |
| Enumera los objetos del usuario HSM actual. | |
| Int32 | ListCallback (cadena szName, ref DinamoApi.DBLOB pParam, Int32 bFinal) |
| cadena[] | ListObjects( tipoALG ) |
| byte[] | ReadFile (cadena FileId) |
| Int32 | WriteLocalFileCallback (IntPtr pbData, Int32 cbData, ref DinamoApi.DBLOB_FILE pParam, Int32 bFinal) |
| void | WriteFile (cadena FileId, byte[] byFileData) |
| Importa objetos en el HSM. Certificados, PKCS#7, Claves. | |
| Int32 | ReadLocalFileCallback (IntPtr pbData, ref Int32 pcbData, IntPtr pParam, out Int32 pbFinal) |
| byte[] | ExportKey (IntPtr hKey, IntPtr hKeyEncryptionKey, BLOB_TYPE BlobType) |
| IntPtr | ImportKey (string KeyId, IntPtr hKeyEncryptionKey, byte[] byKeyBlob, BLOB_TYPE BlobType, KEY_ALG AlgId) |
| IntPtr | ImportKey (string KeyId, IntPtr hKeyEncryptionKey, byte[] byKeyBlob, BLOB_TYPE BlobType, KEY_ALG AlgId, bool Exportable, bool Temporary) |
| void | ImportPKCS12File (cadena FilePath, cadena Password, cadena KeyId, cadena CertId, bool Exportable) |
| Importa una clave/certificado desde un archivo en formato PKCS#12 al HSM. | |
| Int32 | ImportPKCS12 (cadena FilePath, cadena Password, cadena KeyId, cadena CertId, bool Exportable) |
| void | ImportPKCS12 (byte[] Pkcs12, cadena Contraseña, cadena KeyId, cadena CertId, bool Exportable) |
| Importa una clave/certificado desde un búfer en formato PKCS#12 al HSM. | |
| void | ImportPKCS12 (byte[] Pkcs12, cadena Contraseña, cadena KeyId, Int32 KeyAttr, cadena CertId, cadena PubKeyId, Int32 Reservado) |
| Importa una clave/certificado desde un búfer en formato PKCS#12 al HSM. | |
| byte[] | PKCS8ExportKey (cadena szKeyId, cadena szSecret) |
| byte[] | SPBExportPKCS12 (cadena szISPB, cadena szSecret) |
| byte[] | ExportPKCS12 (cadena KeyId, cadena CertId, cadena Secret) |
| Exporta una clave y un certificado HSM en formato PKCS#12. | |
| byte[] | ExportPKCS12 (cadena KeyId, cadena CertId, cadena Secret, Int32 Flags) |
| Exporta una clave y un certificado HSM en formato PKCS#12. | |
| void | PKCS8ImportKey (cadena szKeyId, cadena szSecret, int dwKeyAlg, int dwAttrib, byte[] bKeyEnvelope) |
| void | SPBImportPKCS12 (cadena szKeyId, cadena szSecret, cadena szDomain, int dwKeyAlg, int dwAttrib, cadena file) |
|
inline |
Genera una clave permanente en el HSM.
| KeyId | Identificador de la clave. Este identificador no debe contener espacios ni caracteres especiales. Los caracteres en mayúsculas y minúsculas distinguen entre mayúsculas y minúsculas. Un identificador de objeto en HSM puede tener una longitud máxima, en caracteres, de DinamoApi.MAX_OBJ_NAME_LEN. Al crear claves en la partición de otro usuario (se requiere permiso), el nombre debe estar completamente cualificado con un FQN(Full Qualified Name: partition_id/obj_id); la longitud máxima de un FQN es DinamoApi.MAX_OBJ_ID_FQN_LEN-1. |
| Alg | DinamoAlgoritmo que debe utilizarse. .Hsm.DinamoClient.KEY_ALG |
| Exportable | Bandera que indica la generación de una clave exportable. |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Generar llave.
| KeyId | Identificador de la clave. Este identificador no debe contener espacios ni caracteres especiales. Los caracteres en mayúsculas y minúsculas distinguen entre mayúsculas y minúsculas. Un identificador de objeto en HSM puede tener una longitud máxima, en caracteres, de DinamoApi.MAX_OBJ_NAME_LEN. Al crear claves en la partición de otro usuario (se requiere permiso), el nombre debe estar completamente cualificado con un FQN(Full Qualified Name: partition_id/obj_id); la longitud máxima de un FQN es DinamoApi.MAX_OBJ_ID_FQN_LEN-1. |
| Alg | DinamoAlgoritmo de clave. .Hsm.DinamoClient.KEY_ALG |
| Exportable | Bandera para generar la clave exportable. |
| Temporary | Bandera para generar una clave temporal. Esta clave tiene un ciclo de vida para la duración de la sesión. |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Devuelve el Handler de una clave (DestroyUserKey debe ser llamado después de la asignación).
| KeyId | Identificador clave |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Suelte la palanca de la llave.
| hKey | Mango de llave. |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Devuelve el algoritmo de una clave.
| strKeyId | Nombre de usuario |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Devuelve el tipo de una clave.
| hKey | Tirador de llave |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Devuelve el tipo de relleno de una clave.
| hKey | Tirador de llave |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Devuelve el tamaño de una clave.
| KeyId | Identificación de claves |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Devuelve el tamaño de una clave.
| hKey | Tirador de llave |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
|
inline |
Verifica la existencia de un objeto.
| Id | Identificador del objeto en el HSM. |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Recupera información cartográfica (compatibilidad con versiones anteriores)
| ObjectId | Nombre del mapa |
| Obj1Id | Nombre del objeto en la primera ranura |
| Obj2Id | Nombre del objeto en la segunda ranura |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Recupera información cartográfica.
| ObjectId | Nombre del mapa |
| Obj1Id | Nombre del objeto en la primera ranura |
| Obj1TypeId | Tipo de objeto en la primera ranura |
| Obj2Id | Nombre del objeto en la segunda ranura |
| Obj2TypeId | Tipo de objeto en la segunda ranura |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Lista los certificados y sus claves privadas asociadas.
| onlyWithAssociation | Verdadero si sólo desea certificados con claves asociadas |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Comprueba si la clave es exportable.
| KeyId | Nombre clave |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Comprueba si la clave es exportable.
| hKey | Tirador de llave |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Comprueba que la clave está encriptada.
| KeyId | Nombre clave |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Comprueba que la clave está encriptada.
| hKey | Tirador de llave |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Cambia el estado de bloqueo de un objeto.
| szObjectName | Nombre del objeto |
| bBlock | true para bloqueado y false para desbloqueado |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Recupera el estado bloqueado de un objeto.
| szObjectName | Nombre del objeto |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Elimina un objeto del HSM.
| ObjectId | Nombre del objeto |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Elimina un objeto del HSM, si existe.
| ObjectId | Nombre del objeto |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Enumera los objetos del usuario HSM actual.
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
|
inline |
|
inline |
|
inline |
|
inline |
Importa objetos en el HSM. Certificados, PKCS#7, Claves.
| FileId | Identificador de la clave. Este identificador no debe contener espacios ni caracteres especiales. Los caracteres en mayúsculas y minúsculas distinguen entre mayúsculas y minúsculas. Un identificador de objeto en HSM puede tener una longitud máxima, en caracteres, de DinamoApi.MAX_OBJ_NAME_LEN. Al crear claves en la partición de otro usuario (se requiere permiso), el nombre debe estar completamente cualificado con un FQN(Full Qualified Name: partition_id/obj_id); la longitud máxima de un FQN es DinamoApi.MAX_OBJ_ID_FQN_LEN-1. |
| byFileData | en el |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
|
inline |
|
inline |
|
inline |
Importa una clave/certificado desde un archivo en formato PKCS#12 al HSM.
| FilePath | Ubicación del archivo PFX físico que se va a importar. |
| Password | Contraseña para abrir el archivo PFX. |
| KeyId | Nombre que tendrá la clave importada dentro del HSM. Este identificador no debe contener espacios ni caracteres especiales. Los caracteres en mayúsculas y minúsculas distinguen entre mayúsculas y minúsculas. Un identificador de objeto en el HSM puede tener una longitud máxima, en caracteres, de DinamoApi.MAX_OBJ_NAME_LEN. Al crear claves en la partición de otro usuario (se requiere permiso), el nombre debe estar completamente cualificado con un FQN(Full Qualified Name: partition_id/obj_id); la longitud máxima de un FQN es DinamoApi.MAX_OBJ_ID_FQN_LEN-1. |
| CertId | Nombre que tendrá el certificado importado dentro del HSM. Este identificador no debe contener espacios ni caracteres especiales. Los caracteres en mayúsculas y minúsculas distinguen entre mayúsculas y minúsculas. Un identificador de objeto en el HSM puede tener una longitud máxima, en caracteres, de DinamoApi.MAX_OBJ_NAME_LEN. Al crear claves en la partición de otro usuario (se requiere permiso), el nombre debe estar completamente cualificado con un FQN(Full Qualified Name: partition_id/obj_id); la longitud máxima de un FQN es DinamoApi.MAX_OBJ_ID_FQN_LEN-1. |
| Exportable | Importa la clave en formato exportable. |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
|
inline |
Importa una clave/certificado desde un búfer en formato PKCS#12 al HSM.
| Pkcs12 | PKCS#12. |
| Password | Contraseña para PKCS#12. |
| KeyId | Nombre que tendrá la clave importada dentro del HSM. Este identificador no debe contener espacios ni caracteres especiales. Los caracteres en mayúsculas y minúsculas distinguen entre mayúsculas y minúsculas. Un identificador de objeto en el HSM puede tener una longitud máxima, en caracteres, de DinamoApi.MAX_OBJ_NAME_LEN. Al crear claves en la partición de otro usuario (se requiere permiso), el nombre debe estar completamente cualificado con un FQN(Full Qualified Name: partition_id/obj_id); la longitud máxima de un FQN es DinamoApi.MAX_OBJ_ID_FQN_LEN-1. |
| CertId | Nombre que tendrá el certificado importado dentro del HSM. Este identificador no debe contener espacios ni caracteres especiales. Los caracteres en mayúsculas y minúsculas distinguen entre mayúsculas y minúsculas. Un identificador de objeto en el HSM puede tener una longitud máxima, en caracteres, de DinamoApi.MAX_OBJ_NAME_LEN. Al crear claves en la partición de otro usuario (se requiere permiso), el nombre debe estar completamente cualificado con un FQN(Full Qualified Name: partition_id/obj_id); la longitud máxima de un FQN es DinamoApi.MAX_OBJ_ID_FQN_LEN-1. |
| Exportable | Importa la clave en formato exportable. |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Importa una clave/certificado desde un búfer en formato PKCS#12 al HSM.
| Pkcs12 | PKCS#12. | ||||
| Password | Contraseña para PKCS#12. | ||||
| KeyId | Nombre que tendrá la clave importada dentro del HSM. Este identificador no debe contener espacios ni caracteres especiales. Los caracteres en mayúsculas y minúsculas distinguen entre mayúsculas y minúsculas. Un identificador de objeto en el HSM puede tener una longitud máxima, en caracteres, de DinamoApi.MAX_OBJ_NAME_LEN. Al crear claves en la partición de otro usuario (se requiere permiso), el nombre debe estar completamente cualificado con un FQN(Full Qualified Name: partition_id/obj_id); la longitud máxima de un FQN es DinamoApi.MAX_OBJ_ID_FQN_LEN-1. | ||||
| KeyAttr | Atributos de la clave que se va a importar en el HSM. Parámetros adicionales de la clave.
| ||||
| CertId | Nombre que tendrá el certificado importado dentro del HSM. Este identificador no debe contener espacios ni caracteres especiales. Los caracteres en mayúsculas y minúsculas distinguen entre mayúsculas y minúsculas. Un identificador de objeto en el HSM puede tener una longitud máxima, en caracteres, de DinamoApi.MAX_OBJ_NAME_LEN. Al crear claves en la partición de otro usuario (se requiere permiso), el nombre debe estar completamente cualificado con un FQN(Full Qualified Name: partition_id/obj_id); la longitud máxima de un FQN es DinamoApi.MAX_OBJ_ID_FQN_LEN-1. | ||||
| PubKeyId | Nombre que tendrá la clave pública importada dentro del HSM. Puede ser null para no importar el objeto de clave pública. | ||||
| Reserved | Reservado para uso futuro. Debe ser 0. |
| DinamoException |
|
inline |
|
inline |
|
inline |
Exporta una clave y un certificado HSM en formato PKCS#12.
| KeyId | Nombre de la clave a exportar. |
| CertId | Nombre del certificado a exportar. |
| Secret | Protección por contraseña para PKCS#12. |
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
Exporta una clave y un certificado HSM en formato PKCS#12.
| KeyId | Nombre de la clave a exportar. | ||||
| CertId | Nombre del certificado a exportar. | ||||
| Secret | Protección por contraseña para PKCS#12. | ||||
| Flags | Pase 0 o una de las opciones de la tabla siguiente.
|
| DinamoException | Lanza una excepción en caso de error. |
|
inline |
|
inline |