[apple/security.git] / libsecurity_keychain / lib / IdentityCursor.h

/*
 * Copyright (c) 2002-2008 Apple Inc. All Rights Reserved.
 * 
 * @APPLE_LICENSE_HEADER_START@
 * 
 * This file contains Original Code and/or Modifications of Original Code
 * as defined in and that are subject to the Apple Public Source License
 * Version 2.0 (the 'License'). You may not use this file except in
 * compliance with the License. Please obtain a copy of the License at
 * http://www.opensource.apple.com/apsl/ and read it before using this
 * file.
 * 
 * The Original Code and all software distributed under the License are
 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
 * Please see the License for the specific language governing rights and
 * limitations under the License.
 * 
 * @APPLE_LICENSE_HEADER_END@
 */

//
// IdentityCursor.h - Working with IdentityCursors
//
#ifndef _SECURITY_IDENTITYCURSOR_H_
#define _SECURITY_IDENTITYCURSOR_H_

#include <Security/SecCertificate.h>
#include <Security/SecIdentity.h>
#include <Security/SecIdentitySearch.h>
#include <security_cdsa_client/securestorage.h>
#include <security_keychain/KCCursor.h>
#include <CoreFoundation/CFArray.h>

namespace Security
{

namespace KeychainCore
{

class Identity;
class KeyItem;

class IdentityCursor : public SecCFObject
{
    NOCOPY(IdentityCursor)
public:
	SECCFFUNCTIONS(IdentityCursor, SecIdentitySearchRef, errSecInvalidSearchRef, gTypes().IdentityCursor)

    IdentityCursor(const StorageManager::KeychainList &searchList, CSSM_KEYUSE keyUsage);
	virtual ~IdentityCursor() throw();
	virtual bool next(SecPointer<Identity> &identity);

	CFDataRef pubKeyHashForSystemIdentity(CFStringRef domain);

protected:
	StorageManager::KeychainList mSearchList;

private:
	KCCursor mKeyCursor;
	KCCursor mCertificateCursor;
	SecPointer<KeyItem> mCurrentKey;
	Mutex mMutex;
};

class IdentityCursorPolicyAndID : public IdentityCursor
{
public:
    IdentityCursorPolicyAndID(const StorageManager::KeychainList &searchList, CSSM_KEYUSE keyUsage, CFStringRef idString, SecPolicyRef policy, bool returnOnlyValidIdentities);
	virtual ~IdentityCursorPolicyAndID() throw();
	virtual bool next(SecPointer<Identity> &identity);
	virtual void findPreferredIdentity();

private:
	SecPolicyRef mPolicy;
	CFStringRef mIDString;
	bool mReturnOnlyValidIdentities;
	bool mPreferredIdentityChecked;
	SecPointer<Identity> mPreferredIdentity;
};


} // end namespace KeychainCore

} // end namespace Security

#endif // !_SECURITY_IDENTITYCURSOR_H_
Commit	Line	Data
b1ab9ed8 A	1	/*
	2	* Copyright (c) 2002-2008 Apple Inc. All Rights Reserved.
	3	*
	4	* @APPLE_LICENSE_HEADER_START@
	5	*
	6	* This file contains Original Code and/or Modifications of Original Code
	7	* as defined in and that are subject to the Apple Public Source License
	8	* Version 2.0 (the 'License'). You may not use this file except in
	9	* compliance with the License. Please obtain a copy of the License at
	10	* http://www.opensource.apple.com/apsl/ and read it before using this
	11	* file.
	12	*
	13	* The Original Code and all software distributed under the License are
	14	* distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
	15	* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
	16	* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
	17	* FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
	18	* Please see the License for the specific language governing rights and
	19	* limitations under the License.
	20	*
	21	* @APPLE_LICENSE_HEADER_END@
	22	*/
	23
	24	//
	25	// IdentityCursor.h - Working with IdentityCursors
	26	//
	27	#ifndef _SECURITY_IDENTITYCURSOR_H_
	28	#define _SECURITY_IDENTITYCURSOR_H_
	29
	30	#include <Security/SecCertificate.h>
	31	#include <Security/SecIdentity.h>
	32	#include <Security/SecIdentitySearch.h>
	33	#include <security_cdsa_client/securestorage.h>
	34	#include <security_keychain/KCCursor.h>
	35	#include <CoreFoundation/CFArray.h>
	36
	37	namespace Security
	38	{
	39
	40	namespace KeychainCore
	41	{
	42
	43	class Identity;
	44	class KeyItem;
	45
	46	class IdentityCursor : public SecCFObject
	47	{
	48	NOCOPY(IdentityCursor)
	49	public:
	50	SECCFFUNCTIONS(IdentityCursor, SecIdentitySearchRef, errSecInvalidSearchRef, gTypes().IdentityCursor)
	51
	52	IdentityCursor(const StorageManager::KeychainList &searchList, CSSM_KEYUSE keyUsage);
	53	virtual ~IdentityCursor() throw();
	54	virtual bool next(SecPointer<Identity> &identity);
	55
	56	CFDataRef pubKeyHashForSystemIdentity(CFStringRef domain);
	57
	58	protected:
	59	StorageManager::KeychainList mSearchList;
	60
	61	private:
	62	KCCursor mKeyCursor;
	63	KCCursor mCertificateCursor;
	64	SecPointer<KeyItem> mCurrentKey;
65	Mutex mMutex;
66	};
67
68	class IdentityCursorPolicyAndID : public IdentityCursor
69	{
70	public:
71	IdentityCursorPolicyAndID(const StorageManager::KeychainList &searchList, CSSM_KEYUSE keyUsage, CFStringRef idString, SecPolicyRef policy, bool returnOnlyValidIdentities);
72	virtual ~IdentityCursorPolicyAndID() throw();
73	virtual bool next(SecPointer<Identity> &identity);
74	virtual void findPreferredIdentity();
75
76	private:
77	SecPolicyRef mPolicy;
78	CFStringRef mIDString;
79	bool mReturnOnlyValidIdentities;
80	bool mPreferredIdentityChecked;
81	SecPointer<Identity> mPreferredIdentity;
82	};
83
84
85	} // end namespace KeychainCore
86
87	} // end namespace Security
88
89	#endif // !_SECURITY_IDENTITYCURSOR_H_