Platforms to show: All Mac Windows Linux Cross-Platform
Back to KeychainManagerMBS module.
KeychainManagerMBS.kSecUseOperationPrompt as string
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 18.5 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
The application is responsible for the text localization.
KeychainManagerMBS.kSecValueData as string
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 13.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Data attribute key. A persistent reference to a credential can be stored on disk for later use or passed to other processes.
The corresponding value is of type memoryblock. For keys and password items, the data is secret (encrypted) and may require the user to enter a password for access.
Available in OS X v10.6 and later.
You can specify zero or more of these types depending on the function you are calling.
Some examples using this method:
KeychainManagerMBS.kSecValuePersistentRef as string
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 13.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Persistent reference attribute key.
The corresponding value is of type CFDataRef. The bytes in this memoryblock can be stored by the caller and used on a subsequent invocation of the application (or even a different application) to retrieve the item referenced by it.
Available in OS X v10.6 and later.
You can specify zero or more of these types depending on the function you are calling.
KeychainManagerMBS.kSecValueRef as string
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 13.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Reference attribute key.
The corresponding value, depending on the item class requested, is of type KeychainItemMBS, SecKeyRef, SecCertificateRef, or SecIdentityRef.
Available in OS X v10.6 and later.
You can specify zero or more of these types depending on the function you are calling.
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 13.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
Your application should not call this function unless you are responding to a user's request to lock a keychain. In general, you should leave the keychain unlocked so that the user does not have to unlock it again in another application.
Lasterror is set.
KeychainManagerMBS.Open(file as folderitem) as KeychainMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 13.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
You may use this function to retrieve a pointer to a keychain object given the path of the keychain. You do not need to close the keychain, but you should release the memory that the pointer occupies when you are finished with it.
Lasterror is set.
See also:
KeychainManagerMBS.Open(path as string) as KeychainMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 13.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
You may use this function to retrieve a pointer to a keychain object given the path of the keychain. You do not need to close the keychain, but you should release the memory that the pointer occupies when you are finished with it.
Lasterror is set.
See also:
KeychainManagerMBS.PreferenceDomain as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 13.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
A preference domain is a set of security-related preferences, such as the default keychain and the current keychain search list. The default preference domain for system daemons (that is, for daemons running in the root session) is the system domain. The default preference domain for all other programs is the user domain. Use the PreferenceDomain function to change the preference domain.
This function changes the preference domain for all subsequent function calls; for example, if you change from the system domain to the user domain and then call Lock specifying nil for the keychain, the function locks the default system keychain rather than the default user keychain. You might want to use this function, for example, when launching a system daemon from a user session so that the daemon uses system preferences rather than user
(Read and Write computed property)
KeychainManagerMBS.SearchCreateFromAttributes(keychain as KeychainMBS, itemClass as string, AttributeKeys() as string, AttributeValues() as string) as KeychainSearchMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 13.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
keychains: An array of keychains to search, a single keychain, or nil to search the user's current keychain search list. Use the function SearchList to retrieve the user's default search list.
itemClass: The keychain item class. See "Keychain Item Class Constants" for valid constants.
AttributeKeys: List of zero or more keychain attribute keys to match.
AttributeValues: List of zero or more keychain attribute values to match.
Returns the current search object.
Lasterror is set.
Each item stored in the keychain contains data (such as a certificate), which is indexed by the item's attributes. You look up an item in a keychain by its attributes. If you find a match, you can then retrieve the item's data. Use the search object created by this function as input to the SecKeychainSearchCopyNext function to find a a keychain item.
To find and obtain data from a password keychain item, use the FindInternetPassword or FindGenericPassword function.
See also:
KeychainManagerMBS.SearchCreateFromAttributes(keychains() as KeychainMBS, itemClass as string, AttributeKeys() as string, AttributeValues() as string) as KeychainSearchMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 13.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
keychains: An array of keychains to search, a single keychain, or nil to search the user's current keychain search list. Use the function SearchList to retrieve the user's default search list.
itemClass: The keychain item class. See "Keychain Item Class Constants" for valid constants.
AttributeKeys: List of zero or more keychain attribute keys to match.
AttributeValues: List of zero or more keychain attribute values to match.
Returns the current search object.
Lasterror is set.
Each item stored in the keychain contains data (such as a certificate), which is indexed by the item's attributes. You look up an item in a keychain by its attributes. If you find a match, you can then retrieve the item's data. Use the search object created by this function as input to the SecKeychainSearchCopyNext function to find a a keychain item.
To find and obtain data from a password keychain item, use the FindInternetPassword or FindGenericPassword function.
See also:
KeychainManagerMBS.SearchList as KeychainMBS()
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 13.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
Returns keychain search list.
Lasterror is set.
KeychainManagerMBS.SetDomainDefault(domain as Integer, keychain as KeychainMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 13.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
domain: The preference domain for which you wish to set the default keychain.
keychain: A reference to the keychain you wish to set as default in the specified preference domain.
Lasterror is set.
A preference domain is a set of security-related preferences, such as the default keychain and the current keychain search list. Use this function if you want to set the default keychain for a specific preference domain. Use the SetDefault function if you want to set the default keychain for the current preference domain. See the PreferenceDomain function for a discussion of current and default preference domains.
KeychainManagerMBS.SetDomainSearchList(domain as Integer, list() as KeychainMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 13.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
domain: The preference domain for which you wish to set the default keychain search list. See "Keychain Preference Domain Constants"for possible domain values.
searchList: A keychain search list to set in the preference domain.
Lasterror is set.
A preference domain is a set of security-related preferences, such as the default keychain and the current keychain search list. Use this function if you want to set the keychain search list for a specific preference domain. Use the SetSearchList function if you want to set the keychain search list for the current preference domain. See the PreferenceDomain function for a discussion of current and default preference domains.
KeychainManagerMBS.SetSearchList(list() as KeychainMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 13.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
searchList: An array of keychain references specifying the list of keychains to use in the default keychain search list. Passing an empty array clears the search list.
Lasterror is set.
The default keychain search list is used by several functions; see for example SearchCreateFromAttributes, FindInternetPassword, or FindGenericPassword. To obtain the current default keychain search list, use the SearchList function.
The default keychain search list is displayed as the keychain list in the Keychain Access utility. If you use SetSearchList to change the keychain search list, the list displayed in Keychain Access changes accordingly.
KeychainManagerMBS.UpdateItem(Query as Dictionary, attributesToUpdate as dictionary) as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 13.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
query: A dictionary containing an item class specification and optional attributes for controlling the search. Specify the items whose values you wish to change. See "Search Keys" for a description of currently defined search attributes.
attributesToUpdate: A dictionary containing the attributes whose values should be changed, along with the new values. Only real keychain attributes are permitted in this dictionary (no "meta" attributes are allowed.) See "Attribute Item Keys and Values" for a description of currently defined value attributes.
Lasterror is set.
See the discussion section of the CopyMatching function for information about how to construct a search dictionary.
Available in OS X v10.6 and later.
Some examples using this method:
KeychainManagerMBS.UserInteractionAllowed as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 13.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
Lasterror is set.
A Boolean value indicating whether user interaction is permitted. If true, user interaction is allowed, and Keychain Services functions that display a user interface can do so as appropriate.
(Read and Write computed property)
Some examples using this method:
KeychainManagerMBS.Version as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Keychain | MBS MacClassic Plugin | 13.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
Your application can call the Version function to find out which version of Keychain Services is installed on the user's system.
Lasterror is set.
The items on this page are in the following plugins: MBS MacClassic Plugin.