Skip to main content

Save Password to Keychain (script step reference)

By April 20, 2023April 25th, 2023Online Help, Troi Encryptor Plug-in
Troi Encryptor Plug-in > Script steps reference > Save Password to Keychain
Troi Encryptor Plug-in for FileMaker Pro

Save Password to Keychain

Saves a password into the keychain (for this account and/or yourID).

SyntaxScript step badge

Save Password to Keychain [ Select ; Result (error) ; Password ; Account ;
                            YourID ; Overwrite existing ]

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 (error) an error code
Password the password to save
Account the name of the account (or user) associated with this password
YourID (optional) an extra ID for this password, store for example the solution name here
Overwrite existing overwrite an existing password (with the same Account and YourID)

Returned Result

Data type returned

Error code

Result

The returned result is an error code. An error always starts with 2 dollars, followed by the error code. You should always check for errors. Returned error codes can be:

0 no error the password was saved in the keychain
$$-25299 errKCDuplicateItem the password already exists (for this account and yourID combination)

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 later retrieved from the keychain without the user needing to enter the (keychain) password. The keychain is unlocked when the user logs in to the operating system.
Be careful when using Overwrite Existing, after overwriting the previous password can no longer be retrieved.

Example

Save Password to Keychain [ Select ; $Result ; "secret" ; "John Deere" ]

This will save the password for the user “John Deere” into the keychain.

Example 2

Save Password to Keychain [ Select ; $ErrorCode ;
					"secret234G" ; "Sales" ; "Invoices|Notes|REC1001"  ]

This will store the password “secret234G” into the keychain for the account “Sales”. The yourID parameter adds extra info which helps you distinguish between different passwords for the same account. Here the name of the database, the field Notes and even the recordID is stored. This shows the possibility of a very fine grained approach of giving access to a field on a per record basis.
You can later retrieve the password with this exact combination of account and yourID .

Note that this may be a too detailed approach, you can of course also save a password on a per database level (or even on a solution level). In this case the yourID parameter might be “Invoices” (or “MySolution”).

Used in example file

EncryptAES.fmp12

Related script stepsScript step badge

Delete Password from Keychain
Get Password from Keychain

Related functionsFunction badge

Encr_GeneratePassword
Encr_SavePasswordToKeychain

Related topics

Troi Encryptor Plug-in online help (overview)


Online Help Page for Troi Encryptor Plug-in for 16 to 2023 –> Save Password to Keychain (encrp7323) 2023-0425 16:04:51