# 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:([^:)]*)" )

_FT_HTML5_bannerTitle.htm