Encr_GetPasswordFromKeychain (function reference)

By February 1, 2019 February 12th, 2019 Online Help, Troi Encryptor Plug-in
Troi Encryptor Plug-in > Functions reference > Encr_GetPasswordFromKeychain
Troi Encryptor Plug-in for FileMaker Pro

Encr_GetPasswordFromKeychain

Gets a password from the keychain (for this account and/or yourID).

SyntaxFunction badge

Encr_GetPasswordFromKeychain ( switches ; account { ; yourID } )

Parameters

switchesnot used, reserved for future use. Leave blank or put "-Unused"
accountthe name of the account (or user) that has been used when saving this password
yourID(optional) the extra ID that was used when saving this password

Returned Result

Data type returned

Text

Result

The saved password or an error code.

Returned error codes can be:

$$-25300the password could not be found in the keychain
$$-50Parameter error

Originated in

Troi Encryptor Plug-in 3.5

Compatibility

FileMaker Pro 14 to 17

Considerations

The password is safely stored in the keychain and it can be retrieved from the keychain with this function without the user needing to enter the (keychain) password. The keychain is unlocked when the user logs in to the operating system.

If you specify an account and/or yourID combination for which no password exists, the plug-in returns error code $$-25300.

Example

Set Variable [ $Password ; Encr_GetPasswordFromKeychain ( "-Unused" ; "John Deere" ) ]

This will get the password for the user “John Deere” from the keychain, and the result will be for example “secret”.

Example 2

Set Variable [ $Password ; Encr_GetPasswordFromKeychain ( "-Unused" ; 
			"Sales" ; "Invoices|Notes|REC1001" ) ]

This will get the password from the keychain which was previously stored with the Encr_SavePasswordToKeychain function and the account parameter “Sales” and the yourID parameter “Invoices|Notes|REC1001”.
You can now use this returned password to decrypt text in a field, for example with the Encr_DecryptAES function.

Related functionsFunction badge

Encr_DecryptAES
Encr_DeletePasswordFromKeychain
Encr_SavePasswordToKeychain

Related script stepScript step badge

Get Password from Keychain

Related topics

Troi Encryptor Plug-in online help (overview)


Online Help Page for Troi Encryptor Plug-in for 14 to 17 –> Encr_GetPasswordFromKeychain (encrp4324) 2019-0212 17:39:30