Category Instance for Access Control List

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Unified Communications Client API exposes a strongly typed category instance interface and events to encapsulate ACL container related category instances that are defined and used by Office Communicator and custom clients that interoperate with Office Communicator without requiring detailed knowledge of the proprietary category schemas. The Unified Communications Client API application uses this interface as the access control list (ACL) model in the application.

Communicator-Defined Container Category Instance

An Office Communications Server client user can assign individual subscribing users to an ACL container. These ACL assignments determine the quantity and type of presence category data that a subscribing user can receive. To make these assignments, the local user must have a SIP URI for each remote user subscribing to local user enhanced presence categories. The list is provided with the subscribers category that must be locally subscribed to in order to receive this list. For information about this strongly typed category, see IUccSubscriber. The subscriber interface provides the SIP URI of the subscribing user.

When a subscription request is received by a local client, the user should be notified by the local client of the request. The subscription notification can be a good place for the local user to change the default access control level of the subscribing user if necessary. The existing rules defined in a set of ACL containers are likely to apply to the new subscribing user without addition. In some cases, the local user might want to make an exception to the ACL rules for the new subscriber.

For example, the subscriber might be a federated user rather than a user in the same organization. The default rule applied to federated users prohibits access to most local user presence information. The local user can add the URI of the federated user to the private container. This action gives the subscriber access to additional presence information. The container interface provides properties and methods to add presence categories and subscriber membership data to the container.

See Also

Concepts

Category
Category Instances
Category Instances for Presence
Category Instances for Contacts and Groups
Category Instance for Access Control List
Category Instances for Configuration
Programming Patterns with Category Instances