![]() |
Diffusion Apple API 6.11.5
Unified Client Library for iOS, tvOS and OS X / macOS
|
Permissions protecting access-controlled operations that are evaluated for a specific topic path.
Class Methods | |
(instancetype) | + readTopic |
(instancetype) | + updateTopic |
(instancetype) | + modifyTopic |
(instancetype) | + sendToMessageHandler |
(instancetype) | + sendToSession |
(instancetype) | + selectTopic |
(instancetype) | + queryObsoleteTimeSeriesEvents |
(instancetype) | + editTimeSeriesEvents |
(instancetype) | + editOwnTimeSeriesEvents |
(instancetype) | + acquireLock |
(instancetype) | + unknownTopicPermission |
(instancetype) | + exposeBranch |
![]() | |
(NSSet< PTDiffusionEnumeration * > *) | + elements |
Additional Inherited Members | |
![]() | |
(BOOL) | - isEqualToEnumeration: |
+ (instancetype) acquireLock |
Acquire a session lock.
+ (instancetype) editOwnTimeSeriesEvents |
Submit edits to time series path events which have an author which is the same as the principal of the calling session.
This permission is a more restrictive alternative to editTimeSeriesEvents.
The updateTopic permission is required to update a time series path. This permission is additionally required to submit edits to a time series path where the event author is the same as the principal of the calling session.
+ (instancetype) editTimeSeriesEvents |
Submit edits to time series topic events.
The updateTopic permission is required to update a time series path. This permission is additionally required to submit edits to a time series path.
+ (instancetype) exposeBranch |
Expose a branch of the topic tree as a virtual session tree.
The EXPOSE_BRANCH
path permission is powerful since it allows a session to expose a whole branch of the topic tree under a different set of path permissions.
A session granted EXPOSE_BRANCH
for a particular path effectively has the permission for all descendant paths. From a security perspective, if a role grants EXPOSE_BRANCH
at branch X
it is ineffectual for it also to deny EXPOSE_BRANCH
at a child branch X/Y
because a branch mapping to X
can still expose paths below X/Y
.
+ (instancetype) modifyTopic |
Add a topic or remove a topic.
+ (instancetype) queryObsoleteTimeSeriesEvents |
Evaluate queries that return a non-current view of a time series path.
The readTopic permission is required to evaluate any type of query for a time series path. This permission is additionally required for queries that potentially return a non-current view of all or part of a time series. Such queries include value range queries that specify an edit range, and all types of edit range query.
+ (instancetype) readTopic |
Required to receive information from a topic.
If a session does not have read_topic permission for a path, the path will be excluded from the results of subscription or fetch operations for the session, and the path's details cannot be retrieved by the session.
+ (instancetype) selectTopic |
Use a topic selector that selects the topic path.
A session must have this permission for the path prefix of any topic selector used to subscribe or fetch.
When the subscription or fetch request completes, the resulting topics are further filtered based on the readTopic permission.
A session that has readTopic but not selectTopic for a particular topic path cannot subscribe directly to topics belonging to the path. However, the session can be independently subscribed by a control session that has modifySession (PTDiffusionGlobalPermission) permission in addition to the appropriate selectTopic permission.
+ (instancetype) sendToMessageHandler |
Send a message to a handler registered with the server.
+ (instancetype) sendToSession |
Send a message to a client session.
+ (instancetype) unknownTopicPermission |
A permission that is unsupported by the session.
+ (instancetype) updateTopic |
Update a topic.