IDOL Server 24.4
IDOL Server Help

# 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 2024 Open Text
Version 24.4 | Last updated September 2024

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 MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: IDOL Server 24.4

Topic Title: decrypt_security_field