---
title: "SecPKCS12Import(_:_:_:)"
framework: security
role: symbol
role_heading: Function
path: "security/secpkcs12import(_:_:_:)"
---

# SecPKCS12Import(_:_:_:)

Returns the identities and certificates in a PKCS #12-formatted blob.

## Declaration

```swift
func SecPKCS12Import(_ pkcs12_data: CFData, _ options: CFDictionary, _ items: UnsafeMutablePointer<CFArray?>) -> OSStatus
```

## Parameters

- `pkcs12_data`: The PKCS #12 data you wish to decode.
- `options`: A dictionary of key-value pairs specifying options for the function. See doc://com.apple.security/documentation/Security/keychain-import-and-export-options for a list of valid keys.
- `items`: On return, an array of CFDictionary key-value dictionaries. The function returns one dictionary for each item (identity or certificate) in the PKCS #12 blob. For a list of dictionary keys, see doc://com.apple.security/documentation/Security/pkcs-12-import-item-keys.

## Mentioned in

Importing an Identity

## Return Value

Return Value A result code. See Security Framework Result Codes. The function returns errSecSuccess if there were no errors, errSecDecode if the blob can’t be read or is malformed, and errSecAuthFailed if the password was not correct or data in the blob was damaged.

## Discussion

Discussion Your application can import a PKCS #12–formatted blob (a file with extension .p12) containing certificates and identities, where an identity is a digital certificate together with its associated private key. You can use the SecPKCS12Import function to obtain SecIdentityRef objects (including SecCertificateRef and SecKeyRef objects) for the identities in the blob, together with SecCertificateRef objects for the certificates in the blob needed to validate the identity, and SecTrustRef trust management objects needed to evaluate trust for the identities. You can then use the Keychain Services API (see Keychain services) to put the identities and associated certificates in the keychain.