仅使用服务名称获取存储在钥匙串中的用户名？或者：您应该在哪里存储用户名？

Question

因此，OS X 钥匙串包含三部分信息：

• ServiceName（我的应用程序的名称）
• 用户名
• 密码

我显然总是知道 ServiceName。有没有办法找到该 ServiceName 的任何已保存的用户名？ （一旦知道用户名，找到密码就很容易了。）

我更喜欢使用漂亮的 Cocoa 包装器，例如 EMKeychain 来执行此操作。但 EMKeychain 需要用户名才能获取任何钥匙串项目！

+ (EMGenericKeychainItem *)genericKeychainItemForService:(NSString *)serviceNameString withUsername:(NSString *)usernameString;

如果您需要用户名来查找凭据，您希望如何充分利用钥匙串中的保存凭据？最佳实践是将用户名保存在 .plist 文件中还是其他文件中？

Answer 1

SecKeychainFindGenericPassword 仅返回单个钥匙串项。要查找特定服务的所有通用密码，您需要在钥匙串上运行查询。根据您的目标 OS X 版本，有多种方法可以实现此目的。

如果您需要在 10.5 或更低版本上运行，则需要使用SecKeychainSearchCreateFromAttributes。这是一个相当可怕的 API。这是返回将用户名映射到密码的字典的方法的粗略版本。

- (NSDictionary *)genericPasswordsWithService:(NSString *)service {
    OSStatus status;

    // Construct a query.
    const char *utf8Service = [service UTF8String];
    SecKeychainAttribute attr = { .tag = kSecServiceItemAttr, 
                                  .length = strlen(utf8Service), 
                                  .data = (void *)utf8Service };
    SecKeychainAttribute attrList = { .count = 1, .attr = &attr };
    SecKeychainSearchRef *search = NULL;
    status = SecKeychainSearchCreateFromAttributes(NULL, kSecGenericPasswordItemClass, &attrList, &search);
    if (status) {
        report(status);
        return nil;
    }

    // Enumerate results.
    NSMutableDictionary *result = [NSMutableDictionary dictionary];
    while (1) {
        SecKeychainItemRef item = NULL;
        status = SecKeychainSearchCopyNext(search, &item);
        if (status)
            break;

        // Find 'account' attribute and password value.
        UInt32 tag = kSecAccountItemAttr;
        UInt32 format = CSSM_DB_ATTRIBUTE_FORMAT_STRING;
        SecKeychainAttributeInfo info = { .count = 1, .tag = &tag, .format = &format };
        SecKeychainAttributeList *attrList = NULL;
        UInt32 length = 0;
        void *data = NULL;
        status = SecKeychainItemCopyAttributesAndData(item, &info, NULL, &attrList, &length, &data);
        if (status) {
            CFRelease(item);
            continue;
        }

        NSAssert(attrList->count == 1 && attrList->attr[0].tag == kSecAccountItemAttr, @"SecKeychainItemCopyAttributesAndData is messing with us");
        NSString *account = [[[NSString alloc] initWithBytes:attrList->attr[0].data length:attrList->attr[0].length encoding:NSUTF8StringEncoding] autorelease];
        NSString *password = [[[NSString alloc] initWithBytes:data length:length encoding:NSUTF8StringEncoding] autorelease];
        [result setObject:password forKey:account];

        SecKeychainItemFreeAttributesAndData(attrList, data);
        CFRelease(item);
    }
    CFRelease(search);
    return result;
}

对于 10.6 及更高版本，您可以使用不太方便的 SecItemCopyMatching API：

- (NSDictionary *)genericPasswordsWithService:(NSString *)service {
    NSDictionary *query = [NSDictionary dictionaryWithObjectsAndKeys:
                           kSecClassGenericPassword, kSecClass,
                           (id)kCFBooleanTrue, kSecReturnData,
                           (id)kCFBooleanTrue, kSecReturnAttributes,
                           kSecMatchLimitAll, kSecMatchLimit,
                           service, kSecAttrService,
                           nil];
    NSArray *itemDicts = nil;
    OSStatus status = SecItemCopyMatching((CFDictionaryRef)q, (CFTypeRef *)&itemDicts);
    if (status) {
        report(status);
        return nil;
    }
    NSMutableDictionary *result = [NSMutableDictionary dictionary];
    for (NSDictionary *itemDict in itemDicts) {
        NSData *data = [itemDict objectForKey:kSecValueData];
        NSString *password = [[[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding] autorelease];
        NSString *account = [itemDict objectForKey:kSecAttrAccount];
        [result setObject:password forKey:account];
    }
    [itemDicts release];
    return result;
}

对于 10.7 或更高版本，您可以使用我精彩的 LKKeychain 框架（PLUG！）。它不支持构建基于属性的查询，但您可以简单地列出所有密码并过滤掉不需要的密码。

- (NSDictionary *)genericPasswordsWithService:(NSString *)service {
    LKKCKeychain *keychain = [LKKCKeychain defaultKeychain];
    NSMutableDictionary *result = [NSMutableDictionary dictionary];
    for (LKKCGenericPassword *item in [keychain genericPasswords]) {
        if ([service isEqualToString:item.service]) {
            [result setObject:item.password forKey:item.account];
        }
    }
    return result;
}

（我没有尝试运行，甚至没有编译任何上述代码示例；对于任何拼写错误，我深表歉意。）

Answer 2

您不需要用户名。您可以使用 EMKeychain，但这是该类强加的人为区别； 底层钥匙串服务功能不需要用户名来查找钥匙串项目。

直接使用SecKeychainFindGenericPassword时，为用户名参数传递0和NULL。它将返回该服务上存在的a钥匙串项。

但是，这只会返回一项。如果用户在同一服务上有多个钥匙串项目，您将不知道这一点，也不知道您获得了哪一个（文档说它返回“第一个”匹配项目，但没有说明什么是“第一个”）。如果您想要该服务的任何和所有项目，您应该 创建搜索并使用它。

Answer 3

通用密码具有服务名称和用户名的唯一密钥。因此，要获取单个通用钥匙串条目，您需要提供两者。但是，您可以使用 SecKeychainFindGenericPassword 函数迭代给定服务的所有通用钥匙串条目。

（免责声明：我对在 EMKeychain 中执行此操作一无所知。）