aboutsummaryrefslogtreecommitdiffstats
path: root/SoftHSMv2/src/lib/data_mgr/SecureAllocator.h
blob: 71dc80c7bbe225b61a30c96ead5530377c7a73b7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
/*
 * 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.
 */

/*****************************************************************************
 SecureAllocator.h

 Implements a template class for a secure C++ allocator. The allocator will
 zero all the memory it allocates before releasing it to ensure that the
 data stored in the memory is destroyed properly to minimise the risk of
 obtaining sensitive data from memory
 *****************************************************************************/

#ifndef _SOFTHSM_V2_SECUREALLOCATOR_H
#define _SOFTHSM_V2_SECUREALLOCATOR_H

#include <limits>
#include <stdlib.h>
#include <string.h>
#if defined(SENSITIVE_NON_PAGED) && !defined(_WIN32)
#include <sys/mman.h>
#endif // SENSITIVE_NON_PAGED
#include "config.h"
#include "log.h"
#include "SecureMemoryRegistry.h"

template<class T> class SecureAllocator
{
public:
	// Member types
	typedef T 		value_type;
	typedef T* 		pointer;
	typedef T& 		reference;
	typedef const T*	const_pointer;
	typedef const T&	const_reference;
	typedef size_t		size_type;
	typedef ptrdiff_t	difference_type;

	// Rebind to another type
	template<class U> struct rebind
	{
		typedef SecureAllocator<U> other;
	};

	// Constructor
	inline SecureAllocator() { }

	inline SecureAllocator(const SecureAllocator&) { }

	template<class U> SecureAllocator(const SecureAllocator<U>&) { }

	// Destructor
	inline virtual ~SecureAllocator() { }

	// Return the maximum allocation size
	size_type max_size() const
	{
		return std::numeric_limits<std::size_t>::max() / sizeof(T);
	}

	// Return the address of values
	inline pointer address(reference value) const
	{
		return &value;
	}

	inline const_pointer address(const_reference value) const
	{
		return &value;
	}

	// Allocate n elements of type T
	inline pointer allocate(size_type n, const void* = NULL)
	{
#ifdef SENSITIVE_NON_PAGED
		// Allocate memory on a page boundary
#ifndef _WIN32
		pointer r = (pointer) valloc(n * sizeof(T));
#else
		pointer r = (pointer) VirtualAlloc(NULL, n * sizeof(T), MEM_COMMIT | MEM_RESERVE, PAGE_READWRITE);
#endif

		if (r == NULL)
		{
			ERROR_MSG("Out of memory");

			return NULL;
		}

		// Lock the memory so it doesn't get swapped out
#ifndef _WIN32
		if (mlock((const void*) r, n * sizeof(T)) != 0)
#else
		if (VirtualLock((const void*) r, n * sizeof(T)) == 0)
#endif
		{
			ERROR_MSG("Could not allocate non-paged memory for secure storage");

			// Hmmm... best to not return any allocated space in this case
#ifndef _WIN32
			free(r);
#else
			VirtualFree((const void*) r, MEM_RELEASE);
#endif

			return NULL;
		}

		// Register the memory in the secure memory registry
		SecureMemoryRegistry::i()->add(r, n * sizeof(T));

		return r;
#else
		pointer r = (pointer)(::operator new(n * sizeof(T)));

		if (r == NULL)
		{
			ERROR_MSG("Out of memory");

			return NULL;
		}

		// Register the memory in the secure memory registry
		SecureMemoryRegistry::i()->add(r, n * sizeof(T));

		return r;
#endif // SENSITIVE_NON_PAGED
	}

	// Deallocate n elements of type T
	inline void deallocate(pointer p, size_type n)
	{
#ifdef PARANOID
		// First toggle all bits on
		memset(p, 0xFF, n * sizeof(T));
#endif // PARANOID

		// Toggle all bits off
		memset(p, 0x00, n * sizeof(T));

		// Unregister the memory from the secure memory registry
		SecureMemoryRegistry::i()->remove(p);

#ifdef SENSITIVE_NON_PAGED
#ifndef _WIN32
		munlock((const void*) p, n * sizeof(T));
#else
		VirtualUnlock((const void*) p, n * sizeof(T));
#endif

#ifndef _WIN32
		free(p);
#else
		VirtualFree((const void*) r, MEM_RELEASE);
#endif
#else
		// Release the memory
		::operator delete((void*) p);
#endif // SENSITIVE_NON_PAGED
	}

	// Initialise allocate storage with a value
	void construct(pointer p, const T& value)
	{
		new((void*) p)T(value);
	}

	// Destroy elements of initialised storage
	void destroy(pointer p)
	{
		// Call destructor
		p->~T();
	}

	// Comparison operators
	inline bool operator==(SecureAllocator const&) const { return true; }
	inline bool operator!=(SecureAllocator const&) const { return false; }
};

#endif // !_SOFTHSM_V2_SECUREALLOCATOR_H