EXPORT-PRINCIPAL( ) method

Exports the unsealed or sealed client-principal object as a portable security token with the currently defined property and attribute settings by converting it to a RAW value. You can assign this value to a RAW variable and send it to another ABL session (such as an AppServer™ agent) or assign it to a field in a secure database. The receiving ABL session can then import the RAW value into another client-principal object using the IMPORT-PRINCIPAL( ) method. Depending on its sealed or unsealed state, you can use the imported object to assert or set the user identity it represents using the SEAL( ) method, SECURITY-POLICY:SET-CLIENT( ) method, or SET-DB-CLIENT function, as appropriate.

Return type: RAW

Applies to: Client-principal object handle

Syntax

EXPORT-PRINCIPAL( )

The client-principal object can be either sealed or unsealed.

Calling this method does not generate an audit event or an audit record.

Notes

See also

IMPORT-PRINCIPAL( ) method, SET-CLIENT( ) method, SET-DB-CLIENT function