//

//  MYIdentity.h

//  MYCrypto

//

//  Created by Jens Alfke on 4/9/09.

//  Copyright 2009 Jens Alfke. All rights reserved.

//

#import "MYCertificate.h"

@class MYPrivateKey;

/** An Identity represents a certificate with an associated private key. */

@interface MYIdentity : MYCertificate

{

    @private

    SecIdentityRef _identityRef;

}

/** Creates a MYIdentity object for an existing Keychain identity reference. */

+ (MYIdentity*) identityWithIdentityRef: (SecIdentityRef)identityRef;

/** The underlying SecIdentityRef. */

@property (readonly) SecIdentityRef identityRef;

/** The identity's associated private key. */

@property (readonly) MYPrivateKey *privateKey;

/** @name Mac-Only

 *  Functionality not available on iPhone. 

 */

//@{

#if !TARGET_OS_IPHONE

/** Returns the identity that's been set as the preferred one for the given name, or nil. */

+ (MYIdentity*) preferredIdentityForName: (NSString*)name;

/** Registers this identity as the preferred one for the given name,

    for later lookup using +preferredIdentityForName:. */

- (BOOL) makePreferredIdentityForName: (NSString*)name;

#endif

//@}

/** @name Expert

 *  Advanced methods. 

 */

//@{

/** Initializes a MYIdentity given an existing SecIdentityRef. */

- (id) initWithIdentityRef: (SecIdentityRef)identityRef;

//@}

@end