Xojo Conferences
XDCMay2019MiamiUSA

Platforms to show: All Mac Windows Linux Cross-Platform

Previous items Next items

KeychainManagerMBS.kSecMatchCaseInsensitive as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Notes:
Case sensitivity attribute key.
The corresponding value is of type Boolean. If this value is False, or if this attribute is not provided, then case-sensitive string matching is performed.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecMatchDiacriticInsensitive as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Notes:
Case sensitivity attribute key.
The corresponding value is of type Boolean. If this value is False, or if this attribute is not provided, then diacritic-sensitive string matching is performed.
Available in OS X v10.7 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecMatchEmailAddressIfPresent as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Notes:
Email address attribute key.
The corresponding value is of type string and contains an RFC822 email address. If provided, returned certificates or identities are limited to those that either contain the address or do not contain any email address.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecMatchIssuers as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Notes:
Issuers attribute key.
The corresponding value is of type array, where the array consists of X.500 names of type Memoryblock. If provided, returned certificates or identities are limited to those whose certificate chain contains one of the issuers provided in this list.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecMatchItemList as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Notes:
Item list attribute key.
To provide your own set of items to be filtered by a search query rather than searching the keychain, specify this search key in a call to the SecItemCopyMatching function with a value that consists of an object of type array where the array contains either KeychainItemMBS, SecKeyRef, SecCertificateRef, SecIdentityRef, or memoryblock items. The objects in the provided array must all be of the same type.
To convert from persistent item references to normal item references, specify this search key in a call to the CopyMatching function with a value of type array where the array contains one or more CFDataRef elements (the persistent references), and a return-type key of kSecReturnRef whose value is True.
To delete an item identified by a transient reference, specify the kSecMatchItemList search key in a call to the SecItemDelete function with a reference returned by using the kSecReturnRef return type key in a previous call to the CopyMatching or SecItemAdd functions.
To delete an item identified by a persistent reference, specify the kSecMatchItemList search key in a call to the SecItemDelete function with a persistent reference returned by using the kSecReturnPersistentRef return type key to the CopyMatching or SecItemAdd functions.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecMatchLimit as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Notes:
Match limit attribute key.
The corresponding value is of type Integer. If provided, this value specifies the maximum number of results to return or otherwise act upon. For a single item, specify kSecMatchLimitOne. To specify all matching items, specify kSecMatchLimitAll. The default behavior is function-dependent.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecMatchLimitAll as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Notes:
An unlimited number of results may be returned; used as a value for the kSecMatchLimit attribute key.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecMatchLimitOne as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Notes:
Results are limited to the first item found; used as a value for the kSecMatchLimit attribute key.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecMatchPolicy as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Notes:
Match policy attribute key.
The corresponding value is of type SecPolicyRef. If provided, returned certificates or identities must verify with this policy.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecMatchSearchList as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Example:
// We pass a keychain for searching only in this keychain
dim keychains() as KeychainMBS = KeychainManagerMBS.SearchList
dim keychain as KeychainMBS = keychains(1) // we pick second keychain
dim keychainname as string = keychain.name

// Build query
dim query as new Dictionary

query.value( KeychainManagerMBS.kSecClass ) = KeychainManagerMBS.kSecClassGenericPassword
query.Value( KeychainManagerMBS.kSecReturnAttributes ) = true
query.Value( KeychainManagerMBS.kSecMatchLimit ) = KeychainManagerMBS.kSecMatchLimitAll
query.Value( KeychainManagerMBS.kSecMatchSearchList ) = array(keychain)

// search all items
dim dics() as Dictionary = KeychainManagerMBS.CopyMatchingDictionaries(query)

// pick first
dim dic as Dictionary = dics(0)

// and display
MsgBox "Service: "+dic.Value(KeychainManagerMBS.kSecAttrService)+EndOfLine+_
"Account: "+dic.Value(KeychainManagerMBS.kSecAttrAccount)
Notes: Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecMatchSubjectContains as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Notes:
Subject attribute key.
The corresponding value is of type string. If provided, returned certificates or identities are limited to those whose subject contains this string.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecMatchSubjectEndsWith as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Notes:
Subject attribute key.
The corresponding value is of type String. If provided, returned certificates or identities are limited to those whose subject ends with this string.
Available in OS X v10.7 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecMatchSubjectStartsWith as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Notes:
Subject attribute key.
The corresponding value is of type String. If provided, returned certificates or identities are limited to those whose subject starts with this string.
Available in OS X v10.7 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecMatchSubjectWholeString as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Notes:
Subject attribute key.
The corresponding value is of type String. If provided, returned certificates or identities are limited to those whose subject is exactly equal to this string.
Available in OS X v10.7 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecMatchTrustedOnly as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Notes:
Trusted anchor attribute key.
The corresponding value is of type Boolean. If this attribute is provided with A value of True, only certificates that can be verified back to a trusted anchor are returned. If this value is False or the attribute is not provided, then both trusted and untrusted certificates may be returned.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecMatchValidOnDate as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Notes:
Valid-on-date attribute key.
The corresponding value is of type Date. If provided, returned keys, certificates or identities are limited to those that are valid for the given date. Pass a value of nil to indicate the current date.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecMatchWidthInsensitive as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to set search attributes in a keychain search dictionary.
Notes:
Case sensitivity attribute key.
The corresponding value is of type Boolean. If this value is False, or if this attribute is not provided, then width-sensitive string matching is performed (for example, the ASCII character a does not match the UTF-8 full-width letter a (U+FF41).
Available in OS X v10.7 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecReturnAttributes as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to specify the type of results that should be returned by the CopyMatching or AddItem function.
Notes:
Return attributes attribute key.
The corresponding value is of type Boolean. A value of True indicates that a dictionary of the (unencrypted) attributes of an item should be returned in the form of a Dictionary.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecReturnData as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to specify the type of results that should be returned by the CopyMatching or AddItem function.
Notes:
Return data attribute key.
The corresponding value is of type Boolean. A value of True indicates that the data of an item should be returned in the form of a Memoryblock. For keys and password items, data is secret (encrypted) and may require the user to enter a password for access.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecReturnPersistentRef as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to specify the type of results that should be returned by the CopyMatching or AddItem function.
Notes:
Return persistent reference 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 Boolean. A value of True indicates that a persistent reference to an item (Memoryblock) should be returned.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecReturnRef as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Keys used to specify the type of results that should be returned by the CopyMatching or AddItem function.
Notes:
Return reference attribute key.
The corresponding value is of type Boolean. A value of True indicates that a reference should be returned. Depending on the item class requested, the returned references may be of type KeychainItemMBS, SecKeyRef, SecCertificateRef, SecIdentityRef, or Memoryblock.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecUseAuthenticationContext as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 18.5 Yes No No Yes, macOS only No
Function: Specifies a dictionary key whose value is LAContextMBS to be used for keychain item authentication.
Notes:
As LAContext is 64-bit only for Mac, this will do nothing in 32-bit.

  • If the item requires authentication and this key is omitted, a new context will be created just for the purpose of the single call.
  • If the specified context has been previously authenticated, the operation will succeed without asking user for authentication.
  • If the specified context has not been previously authenticated, the new authentication will be started on this context, allowing caller to eventually reuse the sucessfully authenticated context in subsequent keychain operations.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecUseAuthenticationUI as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 18.5 Yes No No Yes, macOS only No
Function: Specifies a dictionary key whose value to define wether UI is allowed.
Notes: Value can be one of kSecUseAuthenticationUIAllow, kSecUseAuthenticationUIFail, kSecUseAuthenticationUISkip.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecUseAuthenticationUIAllow as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 18.5 Yes No No Yes, macOS only No
Function: One of the values for kSecUseAuthenticationUI to allow user interface.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecUseAuthenticationUIFail as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 18.5 Yes No No Yes, macOS only No
Function: One of the values for kSecUseAuthenticationUI to disallow user interface and fail.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecUseAuthenticationUISkip as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 18.5 Yes No No Yes, macOS only No
Function: One of the values for kSecUseAuthenticationUI to disallow user interface and skip.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecUseItemList as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Key used to specify a list of items to search or add.
Notes:
Item list key.
The corresponding value is of type CFArrayRef, where the array contains either KeychainItemMBS, SecKeyRef, SecCertificateRef, SecIdentityRef, or (for persistent item references) Memoryblock items. If provided, this array is treated as the set of all possible items to search (or to add if the function being called is AddItem). The items in the array must all be of the same type.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecUseKeychain as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 13.1 Yes No No Yes, macOS only No
Function: Key used to specify a list of items to search or add.
Notes:
Keychain reference key.
Specifies a SecKeychainRef object that references the keychain to which AddItem should add the provided items.
Available in OS X v10.7 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecUseNoAuthenticationUI as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 18.5 Yes No No Yes, macOS only No
Function: Wether to show authentication user interface.
Notes:
OS X only. Specifies a dictionary key whose value is a boolean. If provided with a value of true, the error errSecInteractionNotAllowed will be returned if the item is attempting to authenticate with UI.
Available in macOS 10.10 or newer and deprecated in 10.11 in favor of kSecUseAuthenticationUI.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecUseOperationPrompt as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 18.5 Yes No No Yes, macOS only No
Function: Specifies a dictionary key whose value is a string that represents a user-visible string describing the operation for which the application is attempting to authenticate.
Notes: The application is responsible for the text localization.

Feedback, Comments & Corrections

Previous items Next items

The items on this page are in the following plugins: MBS MacClassic Plugin.




Links
MBS FileMaker Plugins