 |
Get Password from Keychain |
Gets a password from the keychain (for this account and/or yourID).
Syntax
GetPassword from Keychain [ Select ; Result ; Account ; YourID ]
Options
| Select entire contents | replaces the entire contents of a field with the result. If not checked the result replaces the currently selected portion of the field |
| Result | the password |
| Account | the 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:
| $$-25300 | errKCItemNotFound | the password could not be found in the keychain |
| $$-50 | paramErr | parameter error |
Originated in
Troi Encryptor Plug-in 4.0
Compatibility
FileMaker Pro 16 to FileMaker Pro 2023
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
Get Password from Keychain [ $Password ; "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
Get Password from Keychain [ $Password ; "Sales" ; "Invoices|Notes|REC1001" ]This will get the password from the keychain which was previously stored with the Save Password to Keychain step 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.
Used in example file
EncryptAES.fmp12
Related script steps
| Delete Password from Keychain |
| Save Password to Keychain |
Related functions
| Encr_DecryptAES |
| Encr_GetPasswordFromKeychain |
Related topics
Troi Encryptor Plug-in online help (overview)
