---
title: "SecRequestSharedWebCredential(_:_:_:)"
framework: security
role: symbol
role_heading: Function
path: "security/secrequestsharedwebcredential(_:_:_:)"
---

# SecRequestSharedWebCredential(_:_:_:)

Asynchronously obtains one or more shared passwords for a website.

## Declaration

```swift
func SecRequestSharedWebCredential(_ fqdn: CFString?, _ account: CFString?, _ completionHandler: @escaping (CFArray?, CFError?) -> Void)
```

## Parameters

- `fqdn`: (Optional) The fully qualified domain name of the website for which passwords are being requested. If NULL is passed in this argument, the domain name(s) listed in the calling app’s doc://com.apple.documentation/documentation/BundleResources/Entitlements/com.apple.developer.associated-domains are searched implicitly.
- `account`: (Optional) The account name for which passwords are being requested. The account may be NULL to request all of the shared credentials that are available for the site, allowing the caller to discover an existing account.
- `completionHandler`: A block that is called to deliver the requested credentials. The block takes two arguments:

## Mentioned in

Managing Shared Credentials

## Discussion

Discussion This function requests one or more shared passwords for a given website, depending on whether the optional account parameter is supplied. To obtain results, the website specified in the fqdn parameter must be one that matches an entry in the calling app’s Associated Domains Entitlement. If matching shared password items are found, the credentials provided to the completion handler will be a CFArray data type containing CFDictionary entries. Each dictionary contains the following pairs:  |   |   |   |  If the found item specifies a nonstandard port number (other than 443 for https), the following key may also be present:  |  note: Because a request involving shared web credentials may potentially require user interaction or other verification to be approved, this function is dispatched asynchronously; your code provides a completion handler that will be called as soon as the results (if any) are available.