8 PubSub Security Key Service model ToC Previous Next

8.6 PubSubKeyPushTargetType ToC Previous Next

8.6.3 ConnectSecurityGroups ToC Previous Next

This Method connects instances of SecurityGroupType to this PubSubKeyPushTarget. This indicates that the SKS shall use the push model to distribute the keys of the SecurityGroup to the PubSubKeyPushTarget.

The SKS shall push keys following this assignment. If an assignment does already exist, the entry is ignored.

If the assignment for a SecurityGroup already exists, a Good_EntryReplaced should be returned for that SecurityGroup and a new push of the existing keys shall be triggered to the push target.

The Client shall be authorized to modify the configuration for the SKS functionality and shall use at least a signed communication channel when invoking this Method on the Server.

Signature

ConnectSecurityGroups (
[in]	NodeId[]		SecurityGroupIds,
[out]	StatusCode[]	ConnectResults
);

Argument Description
SecurityGroupIds The NodeIds of the SecurityGroups to connect to the PushTarget.
ConnectResults The result codes for the SecurityGroups to connect.

Method Result Codes

ResultCode Description
Bad_UserAccessDenied The Session user is not allowed to connect SecurityGroups to the push target.
Bad_SecurityModeInsufficient The communication channel is not using signing.

Operation Result Codes

ResultCode Description
Good_EntryReplaced The PushTarget was already assigned to the SecurityGroup, a new push was triggered
Bad_NodeIdUnknown A SecurityGroupNodeId is unknown.
Bad_NodeIdInvalid A SecurityGroupNodeId is not a NodeId of a SecurityGroupType Object.

Previous Next