Xojo Conferences
XDCMay2019MiamiUSA

Platforms to show: All Mac Windows Linux Cross-Platform

Previous items Next items

KeychainManagerMBS.GetPassword(Query as dictionary, byref result as Memoryblock) as boolean
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: Returns one keychain item that match a search query.
Example:
// build query
dim query as new Dictionary

dim ServiceName as string = "mytest"
dim Username as string = "myusername"

query.value( KeychainManagerMBS.kSecAttrAccount ) = Username
query.value( KeychainManagerMBS.kSecAttrService ) = ServiceName
query.value( KeychainManagerMBS.kSecClass ) = KeychainManagerMBS.kSecClassGenericPassword

// query password
dim passwordData as MemoryBlock
if KeychainManagerMBS.GetPassword(query, passwordData) then
// and show it
dim password as string = DefineEncoding(passwordData, Encodings.utf8)
MsgBox "OK: "+password
else
MsgBox "Failed."
end if
Notes:
This is a variant of CopyMatching which uses kSecReturnData to query the data of one keychain item.
Returns password of first item found in result parameter. If you expect text, be sure to use DefineEncoding to define as encodings.UTF8.

Feedback, Comments & Corrections

KeychainManagerMBS.ItemFromPersistentReference(data as memoryblock) as KeychainItemMBS
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: Provides a keychain item reference, given a persistent reference.
Notes:
Returns a keychain item reference for the item for which you provided a persistent reference.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAccess 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: One of the keychain item attribute keys.
Notes:
A SecAccessRef object describing the access control settings for this item.
Available in OS X v10.7 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAccessControl as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 15.0 Yes No No Yes, macOS only No
Function: Specifies a dictionary key whose value is KeychainAccessControlMBS instance which contains access control conditions for item.
Notes:
Available on Mac OS X 10.10 and newer.
IMPORTANT: This attribute is mutually exclusive with kSecAttrAccess attribute.

See KeychainAccessControlMBS class.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAccessGroup as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 15.0 Yes No No Yes, macOS only No
Function: Specifies a dictionary key whose value is a CFStringRef indicating which access group a item is in.
Notes:
Available on Mac OS X 10.9 and newer.
The access groups that a particular application has membership in are determined by two entitlements for that application. The application-identifier entitlement contains the application's single access group, unless there is a keychain-access-groups entitlement present. The latter has as its value a list of access groups; the first item in this list is the default access group. Unless a specific access group is provided as the value of kSecAttrAccessGroup when SecItemAdd is called, new items are created in the application's default access group. Specifying this attribute in SecItemCopyMatching, SecItemUpdate, or SecItemDelete calls limits the search to the specified access group (of which the calling application must be a member to obtain matching results.) To share keychain items between multiple applications, each application must have a common group listed in its keychain-access-groups entitlement, and each must specify this shared access group name as the value for the kSecAttrAccessGroup key in the dictionary passed to SecItem functions.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAccessible as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 15.0 Yes No No Yes, macOS only No
Function: Specifies a dictionary key whose value indicates when your application needs access to an item's data.
Notes:
You should choose the most restrictive option that meets your application's needs to allow the system to protect that item in the best way possible. See the kSecAttrAccessible* methods for a list of values which can be specified.

IMPORTANT: This attribute is currently not supported for OS X keychain items, unless the kSecAttrSynchronizable attribute is also present. If both attributes are specified on either OS X or iOS, the value for the kSecAttrAccessible key may only be one whose name does not end with "ThisDeviceOnly", as those cannot sync to another device.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAccessibleAfterFirstUnlock as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 15.0 Yes No No Yes, macOS only No
Function: One of the values for kSecAttrAccessible key.
Notes: Item data can only be accessed once the device has been unlocked after a restart. This is recommended for items that need to be accesible by background applications. Items with this attribute will migrate to a new device when using encrypted backups.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 15.0 Yes No No Yes, macOS only No
Function: One of the values for kSecAttrAccessible key.
Notes:
Item data can only be accessed once the device has been unlocked after a restart.
This is recommended for items that need to be accessible by background applications. Items with this attribute will never migrate to a new device, so after a backup is restored to a new device these items will be missing.
Available on Mac OS X 10.9 and newer.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAccessibleAlways as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 15.0 Yes No No Yes, macOS only No
Function: One of the values for kSecAttrAccessible key.
Notes:
Item data can always be accessed regardless of the lock state of the device. This is not recommended for anything except system use. Items with this attribute will migrate to a new device when using encrypted backups.
Available on Mac OS X 10.9 and newer.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAccessibleAlwaysThisDeviceOnly as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 15.0 Yes No No Yes, macOS only No
Function: One of the values for kSecAttrAccessible key.
Notes:
Item data can always be accessed regardless of the lock state of the device. This option is not recommended for anything except system use. Items with this attribute will never migrate to a new device, so after a backup is restored to a new device, these items will be missing.
Available on Mac OS X 10.9 and newer.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAccessibleWhenPasscodeSetThisDeviceOnly as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 15.0 Yes No No Yes, macOS only No
Function: One of the values for kSecAttrAccessible key.
Notes:
Item data can only be accessed while the device is unlocked. This is recommended for items that only need to be accessible while the application is in the foreground and requires a passcode to be set on the device. Items with this attribute will never migrate to a new device, so after a backup is restored to a new device, these items will be missing. This attribute will not be available on devices without a passcode. Disabling the device passcode will cause all previously protected items to be deleted.
Available on Mac OS X 10.9 and newer.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAccessibleWhenUnlocked as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 15.0 Yes No No Yes, macOS only No
Function: One of the values for kSecAttrAccessible key.
Notes:
Item data can only be accessed while the device is unlocked. This is recommended for items that only need be accesible while the application is in the foreground. Items with this attribute will migrate to a new device when using encrypted backups.
Available on Mac OS X 10.9 and newer.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAccessibleWhenUnlockedThisDeviceOnly as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Keychain MBS MacClassic Plugin 15.0 Yes No No Yes, macOS only No
Function: One of the values for kSecAttrAccessible key.
Notes:
Item data can only be accessed while the device is unlocked. This is recommended for items that only need be accesible while the application is in the foreground. Items with this attribute will never migrate to a new device, so after a backup is restored to a new device, these items will be missing.
Available on Mac OS X 10.9 and newer.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAccount 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: One of the keychain item attribute keys.
Notes:
Account attribute key.
The corresponding value is of type String and contains an account name. Items of class kSecClassGenericPassword and kSecClassInternetPassword have this attribute.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrApplicationLabel 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: One of the keychain item attribute keys.
Notes:
Application label attribute key.
The corresponding value is of type String and contains a label for this item. This attribute is different from the kSecAttrLabel attribute, which is intended to be human-readable. This attribute is used to look up a key programmatically; in particular, for keys of class kSecAttrKeyClassPublic and kSecAttrKeyClassPrivate, the value of this attribute is the hash of the public key.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrApplicationTag 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: One of the keychain item attribute keys.
Notes:
Private tag attribute key.
The corresponding value is of type Memoryblock and contains private tag data.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAuthenticationType 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: One of the keychain item attribute keys.
Notes:
Authentication type attribute key.
The corresponding value is of type integer and denotes the authentication scheme for this item (see "Authentication Type Values").
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAuthenticationTypeDefault 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: Values that can be used with the kSecAttrAuthenticationType attribute key.
Notes:
The default authentication type.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAuthenticationTypeDPA 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: Values that can be used with the kSecAttrAuthenticationType attribute key.
Notes:
Distributed Password authentication.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAuthenticationTypeHTMLForm 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: Values that can be used with the kSecAttrAuthenticationType attribute key.
Notes:
HTML form based authentication.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAuthenticationTypeHTTPBasic 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: Values that can be used with the kSecAttrAuthenticationType attribute key.
Notes:
HTTP Basic authentication.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAuthenticationTypeHTTPDigest 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: Values that can be used with the kSecAttrAuthenticationType attribute key.
Notes:
HTTP Digest Access authentication.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAuthenticationTypeMSN 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: Values that can be used with the kSecAttrAuthenticationType attribute key.
Notes:
Microsoft Network default authentication.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAuthenticationTypeNTLM 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: Values that can be used with the kSecAttrAuthenticationType attribute key.
Notes:
Windows NT LAN Manager authentication.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrAuthenticationTypeRPA 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: Values that can be used with the kSecAttrAuthenticationType attribute key.
Notes:
Remote Password authentication.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrCanDecrypt 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: One of the keychain item attribute keys.
Notes:
Decryption attribute key.
The corresponding value is of type Boolean and indicates whether this cryptographic key can be used to decrypt data.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrCanDerive 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: One of the keychain item attribute keys.
Notes:
Derivation attribute key.
The corresponding value is of type Boolean and indicates whether this cryptographic key can be used to derive another key.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrCanEncrypt 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: One of the keychain item attribute keys.
Notes:
Encryption attribute key.
The corresponding value is of type Boolean and indicates whether this cryptographic key can be used to encrypt data.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrCanSign 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: One of the keychain item attribute keys.
Notes:
Signature attribute key.
The corresponding value is of type Boolean and indicates whether this cryptographic key can be used to create a digital signature.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

KeychainManagerMBS.kSecAttrCanUnwrap 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: One of the keychain item attribute keys.
Notes:
Unwrap attribute key.
The corresponding value is of type Boolean and indicates whether this cryptographic key can be used to unwrap another key.
Available in OS X v10.6 and later.

Feedback, Comments & Corrections

Previous items Next items

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




Links
MBS Xojo Plugins