Chapter 4. Aliases
Prev | Part I. API Documentation | Next

## Chapter 4. Aliases

Collections may be accessed via well known aliases. For example an alias called `default` tells applications which is the default collection to store secrets.

The aliased collections will be available at a well-known DBus object path.

If an application needs to create a collection with a given alias, this can be done in a race free fashion by specifying the alias parameter of the CreateCollection() method on the service interface. If a collection with that alias already exists, then it will be returned instead of creating a new one.

For applications like password managers it can be useful to allow the user to configure which collection is associated with which well known alias. To alias or unalias a collection use the SetAlias() method on the service interface. Use the ReadAlias() method on the service interface to discover which collection is associated with a given alias.

Prev | Up | Next
Chapter 3. Collection and Items | Home | Chapter 5. Lookup Attributes