Class

CBIdentity

A CBIdentity object is used for accessing the attributes of an identity stored in an identity authority. You can use an identity object for finding identities, and storing them in an access control list (ACL). If you need to edit these attributes, take advantage of the CSIdentity class in Core Services.

Declaration

@interface CBIdentity : NSObject

Overview

You can obtain a CBIdentity object from one of the following class factory methods: identityWithName:authority:, identityWithUUIDString:authority:, identityWithPersistentReference:, or identityWithCSIdentity:.

A CBIdentity object has methods to support for interoperability with the Core Services Identity API. Send CSIdentity to your CBIdentity object to return an opaque object for use in the Core Services Identity API. Similarly, call identityWithCSIdentity: to use an Core Services Identity opaque object in the Collaboration framework.

There are two subclasses of CBIdentity: CBGroupIdentity and CBUserIdentity. If you are working specifically with a group identity, use CBGroupIdentity. Similarly, if you are working with a user identity, use CBUserIdentity.

Topics

Finding Identities

+ identityWithCSIdentity:

Returns an identity object created from the specified Core Services Identity opaque object.

+ identityWithName:authority:

Returns the identity object with the given name from the specified identity authority.

+ identityWithPersistentReference:

Returns the identity object matching the persistent reference data.

+ identityWithUUIDString:authority:

Returns the identity object with the given UUID from the specified identity authority.

Deprecated

Getting Identity Attributes

aliases

Returns an array of aliases (alternate names) for the identity.

authority

Returns the identity authority where the identity is stored.

emailAddress

Returns the email address of an identity.

fullName

Returns the full name of the identity.

image

Returns the image associated with an identity.

- isHidden

Returns a Boolean value indicating the state of the identity’s hidden property.

- isMemberOfGroup:

Returns a Boolean value indicating whether the identity is a member of the specified group.

posixName

Returns the POSIX name of the identity.

UUIDString

Returns the UUID of the identity as a string.

Deprecated

Storing Identities

- CSIdentity

Returns an opaque object for use with the Core Services Identity API.

persistentReference

Returns a persistent reference to store a reference to an identity.

Relationships

Inherits From

Conforms To