<!--
{
  "availability" : [
    "macOS: 10.3.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SecurityInterface",
  "identifier" : "/documentation/SecurityInterface/SFChooseIdentityPanel",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Security Interface"
    ],
    "preciseIdentifier" : "c:objc(cs)SFChooseIdentityPanel"
  },
  "title" : "SFChooseIdentityPanel"
}
-->

# SFChooseIdentityPanel

A panel or sheet containing a list of identities that a user can choose from.

```
class SFChooseIdentityPanel
```

## Overview

An identity is a digital certificate together with its associated private key. This class also allows the user to display the contents of any certificate in the list.

The following figure shows an example of a choose identity panel.

![Choose identity panel](images/com.apple.securityinterface/media-1965600.jpg)

## Topics

### Returning a Shared Certificate Panel Object

[`shared()`](/documentation/SecurityInterface/SFChooseIdentityPanel/shared())

Returns a fully initialized, singleton choose identity panel object.

### Providing Help

[`setHelpAnchor(_:)`](/documentation/SecurityInterface/SFChooseIdentityPanel/setHelpAnchor(_:))

Sets the help anchor string for the sheet or modal panel.

[`setShowsHelp(_:)`](/documentation/SecurityInterface/SFChooseIdentityPanel/setShowsHelp(_:))

Displays a Help button in the sheet or panel.

[`helpAnchor()`](/documentation/SecurityInterface/SFChooseIdentityPanel/helpAnchor())

Returns the current help anchor string for the sheet or panel.

[`showsHelp()`](/documentation/SecurityInterface/SFChooseIdentityPanel/showsHelp())

Indicates whether the help button is currently set to be displayed.

### Customizing the Appearance of the Sheet or Panel

[`setAlternateButtonTitle(_:)`](/documentation/SecurityInterface/SFChooseIdentityPanel/setAlternateButtonTitle(_:))

Customizes the title of the alternate button.

[`setDefaultButtonTitle(_:)`](/documentation/SecurityInterface/SFChooseIdentityPanel/setDefaultButtonTitle(_:))

Customizes the title of the default button.

[`setPolicies(_:)`](/documentation/SecurityInterface/SFChooseIdentityPanel/setPolicies(_:))

Specifies one or more policies that apply to the displayed certificates.

[`policies()`](/documentation/SecurityInterface/SFChooseIdentityPanel/policies())

Returns an array of policies used to evaluate the status of the displayed certificates.

[`informativeText()`](/documentation/SecurityInterface/SFChooseIdentityPanel/informativeText())

Returns the informative text currently displayed in the panel.

[`setInformativeText(_:)`](/documentation/SecurityInterface/SFChooseIdentityPanel/setInformativeText(_:))

Sets the optional informative text displayed in the panel.

### Displaying a Sheet or Panel

[`beginSheet(for:modalDelegate:didEnd:contextInfo:identities:message:)`](/documentation/SecurityInterface/SFChooseIdentityPanel/beginSheet(for:modalDelegate:didEnd:contextInfo:identities:message:))

Displays a list of identities in a modal sheet from which the user can select an identity.

[`runModal(forIdentities:message:)`](/documentation/SecurityInterface/SFChooseIdentityPanel/runModal(forIdentities:message:))

Displays a list of identities in a modal panel.

### Getting Identity Information from a Sheet or Panel

[`identity()`](/documentation/SecurityInterface/SFChooseIdentityPanel/identity())

Returns the identity that the user chose in the panel or sheet.

### Working with Domains

[`domain()`](/documentation/SecurityInterface/SFChooseIdentityPanel/domain())

Returns the domain that will be associated with the chosen identity.

[`setDomain(_:)`](/documentation/SecurityInterface/SFChooseIdentityPanel/setDomain(_:))

Sets an optional domain in which the identity is to be used.

### Delegate methods for providing help

  <doc://com.apple.documentation/documentation/ObjectiveC/NSObject-swift.class/chooseIdentityPanelShowHelp(_:)>


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)