skeep_new_split_recover.c

Ejemplo de creación, división y recuperación de secretos utilizando el módulo de custodia.

Véase la nota sobre ejemplos.

/* skeep_new_split_recover.c
*
* Ejemplo que demuestra cómo crear un secreto, dividirlo en acciones y
* recupéralo de las partes M.
*
* Crear un secreto
* Dividir el secreto en N partes donde M partes son necesarias para
* recuperar el secreto. Opcionalmente: generar la suma de comprobación para cada parte.
* 3. recuperar el secreto de M partes
*/
 
#include <stdio.h>
#include <string.h>
#include <stdlib.h>
 
#include "dinamo.h" /* Dinamo  header */
 
#define HOST_ADDR "127.0.0.1"
#define USER_ID "maestro"
#define USER_PWD "12345678"
 
static int OpenSession(HSESSIONCTX *hSession, const char *cszIp, const char *cszUser,
                       const char *cszContraseña)
{
    struct AUTH_PWD authPwd;
 
    /* Inicializa la estructura de conexión con el HSM */
    strncpy(authPwd. szAddr, HOST_ADDR, sizeof(authPwd.szAddr));
    authPwd. nPort = DEFAULT_PORT;
    strncpy(authPwd.szUserId, USER_ID, sizeof(authPwd.szUserId));
    strncpy(authPwd. szContraseña, USER_PWD, sizeof(authPwd.szContraseña));
 
    return DOpenSession(hSession, SS_USER_PWD,(BYTE *)&authPwd, sizeof(authPwd), ENCRYPTED_CONN);
}
 
static void PrintError(const char *cszFunction, int nRet)
{
    printf("Fallo de función: %s \nCódigo de error: %d\n", cszFunción, nRet);
}
 
int main()
{
    int nRet = 0;
    HSESSIONCTX hSession = NULL;
 
#define M (2) /* Número mínimo de acciones para recuperar el secreto */
#define N (3) /* Número total de acciones */
 
    const char *szId = "secreto";
    BYTE bSecLevel = DN_SKEEP_SEC_LEVEL_160b; /* Nivel de seguridad secreto */
    WORD wAuthType = DN_SKEEP_TYPE_NMIND; /* Tipo de autenticación para el secreto. En esta prueba, no es el usuario y contraseña por defecto. */
    int i = 0;
 
    SKeepShare shares[N] = {0};           /* Vetor de partes */
    SKeepRecoverInfo stRecoverInfo = {0}; /* Estrutura para recuperar o segredo */
 
    Dinamo /* Inicializa las bibliotecas de */
    nRet =  DInitialize(0);
    si (nRet)
    {
        PrintError("DInitialise", nRet);
        ir a limpiar;
    }
 
    printf("Bibliotecas inicializadas.\n");
 
    /* Abrir sesión con HSM */
    nRet = OpenSession(&hSession, HOST_ADDR, USER_ID, USER_PWD);
    si (nRet)
    {
        PrintError("DOpenSession", nRet);
        ir a limpiar;
    }
 
    printf("Sesión con Dinamo establecida.\n");
 
    /*
        1. Crear un secreto
    */
    nRet = DSKeepNewSecret(hSession, szId, bSecLevel, wAuthType, 0);
    if(nRet)
    {
        PrintError("DSKeepNewSecret", nRet);
        ir a limpiar;
    }
 
    printf("Secreto creado con éxito.\n");
 
    /*
        2. Divide el secreto en partes.
        El secreto se divide en N partes, de las cuales M son necesarias
        para recuperar el secreto.
    */
    nRet = DSKeepSplitSecret(hSession, szId, bSecLevel, wAuthType, M, N, shares, 0);
    si (nRet)
    {
        PrintError("DSKeepSplitSecret", nRet);
        ir a limpiar;
    }
 
    printf("Secreto dividir con éxito.\n");
 
    /*
        Opcional: Calcular la suma de comprobación de cada parte.
        La suma de comprobación se utiliza para verificar que la pieza se ha introducido correctamente en el
        aplicación de la ceremonia.
        Lo ideal es guardarlo junto con la pieza y comprobarlo previamente
        para recuperar el secreto.
    */
    for (i = 0; i < N; i++)
    {
        char szShareCks[DN_SKEEP_SHARE_CKS_LEN + 1] = {0};
        nRet = DSKeepCalcShareCks(DN_SKEEP_GEN_SHARE_CKS, shares[i].szShare, szShareCks);
        si (nRet)
        {
            PrintError("DSKeepSplitSecret", nRet);
            ir a limpiar;
        }
 
        printf("Acción %d: %s [%s]\n", i, acciones[i].szCompartir, szCompartirCks);
    }
 
    /*
        3. Recuperar el secreto de M partes
    */
    nRet = DSKeepRecoverSecret(hSession, szId, shares, M, &stRecoverInfo, 0);
    si (nRet)
    {
        PrintError("DSKeepRecoverSecret", nRet);
        ir a limpiar;
    }
 
    printf("Secreto recuperado con éxito.\n");
    printf("Secreto: %s\n", stRecoverInfo. szSecret);
 
    /* Eliminar el secreto */
    nRet = DSKeepRemoveSecret(hSession, szId, bSecLevel, wAuthType, 0);
    si (nRet)
    {
        PrintError("DSKeepRemoveSecret", nRet);
        ir a limpiar;
    }
 
    printf("Secreto eliminado con éxito.\n");
 
    limpia:
 
    DCloseSession(&hSession, 0);
    printf("Sesión cerrada.\n");
 
    DFinalise();
    printf("Bibliotecas finalizadas.\n");
 
    devolver nRet;
}