aboutsummaryrefslogtreecommitdiffstats
path: root/SoftHSMv2/src/lib/object_store/OSToken.h
diff options
context:
space:
mode:
Diffstat (limited to 'SoftHSMv2/src/lib/object_store/OSToken.h')
-rw-r--r--SoftHSMv2/src/lib/object_store/OSToken.h160
1 files changed, 160 insertions, 0 deletions
diff --git a/SoftHSMv2/src/lib/object_store/OSToken.h b/SoftHSMv2/src/lib/object_store/OSToken.h
new file mode 100644
index 0000000..4ba5b2c
--- /dev/null
+++ b/SoftHSMv2/src/lib/object_store/OSToken.h
@@ -0,0 +1,160 @@
+/*
+ * Copyright (c) 2010 SURFnet bv
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
+ * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+/*****************************************************************************
+ OSToken.h
+
+ The token class; a token is stored in a directory containing several files.
+ Each object is stored in a separate file and a token object is present that
+ has the token specific attributes
+ *****************************************************************************/
+
+#ifndef _SOFTHSM_V2_OSTOKEN_H
+#define _SOFTHSM_V2_OSTOKEN_H
+
+#include "config.h"
+#include "ObjectStoreToken.h"
+#include "OSAttribute.h"
+#include "ObjectFile.h"
+#include "Directory.h"
+#include "Generation.h"
+#include "UUID.h"
+#include "MutexFactory.h"
+#include "cryptoki.h"
+#include <string>
+#include <set>
+#include <map>
+#include <list>
+
+class OSToken : public ObjectStoreToken
+{
+public:
+ // Constructor
+ OSToken(const std::string inTokenPath);
+
+ // Create a new token
+ static OSToken* createToken(const std::string basePath, const std::string tokenDir, const ByteString& label, const ByteString& serial);
+
+ // Access an existing token
+ static OSToken* accessToken(const std::string &basePath, const std::string &tokenDir);
+
+ // Constructor for new tokens
+ OSToken(const std::string tokenPath, const ByteString& label, const ByteString& serialNumber);
+
+ // Set the SO PIN
+ virtual bool setSOPIN(const ByteString& soPINBlob);
+
+ // Get the SO PIN
+ virtual bool getSOPIN(ByteString& soPINBlob);
+
+ // Set the user PIN
+ virtual bool setUserPIN(ByteString userPINBlob);
+
+ // Get the user PIN
+ virtual bool getUserPIN(ByteString& userPINBlob);
+
+ // Get the token flags
+ virtual bool getTokenFlags(CK_ULONG& flags);
+
+ // Set the token flags
+ virtual bool setTokenFlags(const CK_ULONG flags);
+
+ // Retrieve the token label
+ virtual bool getTokenLabel(ByteString& label);
+
+ // Retrieve the token serial
+ virtual bool getTokenSerial(ByteString& serial);
+
+ // Retrieve objects
+ virtual std::set<OSObject*> getObjects();
+
+ // Insert objects into the given set
+ virtual void getObjects(std::set<OSObject*> &inObjects);
+
+ // Create a new object
+ virtual OSObject* createObject();
+
+ // Delete an object
+ virtual bool deleteObject(OSObject* object);
+
+ // Destructor
+ virtual ~OSToken();
+
+ // Checks if the token is consistent
+ virtual bool isValid();
+
+ // Invalidate the token (for instance if it is deleted)
+ virtual void invalidate();
+
+ // Delete the token
+ virtual bool clearToken();
+
+ // Reset the token
+ virtual bool resetToken(const ByteString& label);
+
+private:
+ // ObjectFile instances can call the index() function
+ friend class ObjectFile;
+
+ // Index the token
+ bool index(bool isFirstTime = false);
+
+ // Is the token consistent and valid?
+ bool valid;
+
+ // The token path
+ std::string tokenPath;
+
+ // The current objects of the token
+ std::set<OSObject*> objects;
+
+ // All the objects ever associated with this token
+ //
+ // This set is kept to be able to clean up when the token
+ // instance is discarded; in case the contents of a token
+ // change, some objects may disappear but we cannot simply
+ // delete them since they may still be referenced from an
+ // object outside of this class.
+ std::set<OSObject*> allObjects;
+
+ // The current list of files
+ std::set<std::string> currentFiles;
+
+ // The token object
+ ObjectFile* tokenObject;
+
+ // Generation control
+ Generation* gen;
+
+ // The directory object for this token
+ Directory* tokenDir;
+
+ // For thread safeness
+ Mutex* tokenMutex;
+};
+
+#endif // !_SOFTHSM_V2_OSTOKEN_H
+