credentials.h

Go to the documentation of this file.

/* Copyright (C) 2017-2023 Chris Piker <chris-piker@uiowa.edu>
 *
 * This file is part of das2C, the Core Das2 C Library.
 * 
 * das2C is free software; you can redistribute it and/or modify it under
 * the terms of the GNU Lesser General Public License version 2.1 as published
 * by the Free Software Foundation.
 *
 * das2C is distributed in the hope that it will be useful, but WITHOUT ANY
 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for
 * more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * version 2.1 along with das2C; if not, see <http://www.gnu.org/licenses/>. 
 */
 
#ifndef _das_credmngr_h_
#define _das_credmngr_h_
 
#include <stdio.h>
 
#include <das3/array.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef bool (*das_prompt)(
   const char* sServer, const char* sRealm, const char* sDataset, 
   const char* sMessage, char* sUser, char* sPassword
);
 
#define DASCRED_SRV_SZ    128
#define DASCRED_REALM_SZ  128
#define DASCRED_DSET_SZ   128
#define DASCRED_HASH_SZ   256
 
typedef struct das_credential_t{
   bool bValid;
   char sServer[DASCRED_SRV_SZ];
   char sRealm[DASCRED_REALM_SZ];
   char sDataset[DASCRED_DSET_SZ];
   char sHash[DASCRED_HASH_SZ];
} das_credential;
 
 
DAS_API bool das_cred_init(
   das_credential* pCred, const char* sServer, const char* sRealm, 
   const char* sDataset, const char* sHash
);
 
#define DASCMGR_FILE_SZ 128
#define DASCMGR_MSG_SZ  1024
 
typedef struct das_credmngr{
   DasAry* pCreds;
   das_prompt prompt;
   char sKeyFile[DASCMGR_FILE_SZ];
   char sLastAuthMsg[DASCMGR_MSG_SZ];
} DasCredMngr;
 
DAS_API DasCredMngr* new_CredMngr(const char* sKeyStore);
 
DAS_API void del_CredMngr(DasCredMngr* pThis);
 
DAS_API int CredMngr_addCred(DasCredMngr* pThis, const das_credential* pCred);
 
 
DAS_API das_credential* CredMngr_getCred(
   DasCredMngr* pThis, const char* sServer, const char* sRealm, 
   const char* sDataset, bool bValidOnly
);
 
DAS_API int CredMngr_addUserPass(
   DasCredMngr* pThis, const char* sServer, const char* sRealm, 
   const char* sDataset, const char* sUser, const char* sPass
);
 
DAS_API const char* CredMngr_getHttpAuth(
   DasCredMngr* pThis, const char* sServer, const char* sRealm, const char* sDataset
);
 
DAS_API void CredMngr_authFailed(
   DasCredMngr* pThis, const char* sServer, const char* sRealm, 
   const char* sDataset, const char* sMsg
);
 
 
DAS_API das_prompt CredMngr_setPrompt(DasCredMngr* pThis, das_prompt new_prompt);
 
DAS_API int CredMngr_save(DasCredMngr* pThis, const char* sSymKey, const char* sFile);
 
DAS_API int CredMngr_load(DasCredMngr* pThis, const char* sSymKey, const char* sFile);
 
 
#ifdef __cplusplus
}
#endif
 
#endif /* _das_credmngr_h_ */