Connector Framework Server 12.12

# decrypt_security_field

The `decrypt_security_field` function decrypts a supplied ACL string.

This function is similar to the decrypt function, but is intended for use with Access Control Lists (ACLs) which usually contain multiple encrypted strings with delimiters such as `:U:`,`:NU:`, and commas.

## Syntax

    decrypt_security_field( acl [, regex [, regex]] )

## Arguments

Argument | Description
--- | ---
`acl` | (string) An encrypted Access Control List string.
`regex` | (string) Any additional arguments that you pass to the function are taken as a list of regular expressions. The capturing groups in these regular expressions specify the parts of the string to decrypt. If you supply your own regular expression(s) the default ones listed below are not used:
    (?:^|\\()S:([^:)]*)
    :U:([^:)]*)
    :G:([^:)]*)
    :NU:([^:)]*)
    :NG:([^:)]*)
    :USERS:([^:)]*)
    :GROUPS:([^:)]*)
    :NOUSERS:([^:)]*)
    :NOGROUPS:([^:)]*)
    :RG:([^:)]*)
    :R1G:([^:)]*)

## Returns

(String). The decrypted string.

## Examples

The following example shows how to decrypt the standard `AUTONOMYMETADATA` document field:

    local decrypted = decrypt_security_field(document:getFieldValue("AUTONOMYMETADATA"))

The following example shows how to specify custom regular expressions for decrypting parts of the input string:

    local decrypted = decrypt_security_field(document:getFieldValue("AUTONOMYMETADATA"),
                                                   ":U:([^:)]*)", ":G:([^:)]*)" )

© Copyright 2022 Micro Focus or one of its affiliates
Version 12.12 | Last updated June 2022

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL Connector Framework Server 12.12

Topic Title: decrypt_security_field