SQ-1305: Security String Invalid

Description

This error occurs when the security string sent by the connector for an item during indexing does not conform to the required syntax, as described in the Security String Format section of the Managing Datasource Permissions article.

Possible Causes and Troubleshooting Steps

Misconfigured Property Transforms

Most connectors do not provide integrated security directly - instead, property transforms are used to set the security string. This is the most likely cause of the Security String Invalid exception.

Connector Issues

Connector Version: Ensure that you have the latest version of the connector available.
Connector: If you are on the latest version of the connector and no transforms that set the Security String property are in use in the connection configuration, this may be an indication of a bug in the connector. If the connector was developed by Seeq, you should submit a support ticket. If the connector is a third-party connector, you should contact the vendor. You can see the vendor of the connector on the datasource administration page under the datasource card:

Permission Issues

Missconfigured Datasource Permissions

Usually, the user running the connector has sufficient permissions to read the UserGroups from Seeq Directory. If the property “Provides Everyone Group Identities” was set to false on the Seeq Directory, the Agents and the user groups in the Seeq Directory will no longer be members of the Everyone group. Therefore, Agents cannot read the groups from Seeq Directory.

If the Security String uses such a user group (via transforms or via PIWorldMapping), an error will be shown in the agent log:

CODE

Invalid security string for item with Data ID ***. The following errors were encountered: identity for permission Auth/Seeq/YourGroup:rd,r does not match a known datasource

Solution:

Explicitly give read permissions for the Agents group to the Seeq Directory.
Explicitly give read permissions for the Agents group to the groups from Seeq Directory that are referenced in Security String(s).