Table of Contents

Interface ISystemAuthenticationControl

Namespace
PushTechnology.ClientInterface.Client.Features.Control.Clients
Assembly
Diffusion.Client.dll

The system authentication control feature that allows a client session to query and update the system authentication store.

public interface ISystemAuthenticationControl : ISecurityStoreFeature, IFeature
Inherited Members

Remarks

Access control

In order to query the store the session needs VIEW_SECURITY permission and in order to update the store it needs MODIFY_SECURITY permission.

Accessing the feature

This feature may be obtained from a ISession as follows 

var systemAuthenticationControl = session.SystemAuthenticationControl;

Added in version 5.2.

Properties

Script

Gets the builder that can be used to create scripts for use with UpdateStoreAsync(string).

IScriptBuilder Script { get; }

Property Value

IScriptBuilder

The default builder instance that creates an empty script.

Methods

GetSystemAuthenticationAsync()

Obtains the current contents of the store.

Task<ISystemAuthenticationConfiguration> GetSystemAuthenticationAsync()

Returns

Task<ISystemAuthenticationConfiguration>

The Task representing the current operation.

Remarks

If the operation completes successfully, the Task result will be a ISystemAuthenticationConfiguration instance.

This method is the same as calling GetSystemAuthenticationAsync(CancellationToken) with System.Threading.CancellationToken.None.

Exceptions

SessionSecurityException

The calling session does not have VIEW_SECURITY permission. Thrown by the returned Task.

SessionClosedException

The calling session is closed. Thrown by the returned Task.

GetSystemAuthenticationAsync(CancellationToken)

Obtains the current contents of the store.

Task<ISystemAuthenticationConfiguration> GetSystemAuthenticationAsync(CancellationToken cancellationToken)

Parameters

cancellationToken CancellationToken

The cancellation token used to cancel the current operation.

Returns

Task<ISystemAuthenticationConfiguration>

The Task representing the current operation.

Remarks

If the operation completes successfully, the Task result will be a ISystemAuthenticationConfiguration instance.

Exceptions

SessionSecurityException

The calling session does not have VIEW_SECURITY permission. Thrown by the returned Task.

SessionClosedException

The calling session is closed. Thrown by the returned Task.