Initializer

init(peer:securityIdentity:encryptionPreference:)

Creates a Multipeer Connectivity session, providing security information.

Declaration

init(peer myPeerID: MCPeerID, securityIdentity identity: [Any]?, encryptionPreference: MCEncryptionPreference)

Parameters

myPeerID

A local identifier that represents the device on which your app is currently running.

identity

An array containing information that can be used to identify the local peer to other nearby peers.

The first object in this array should be a SecIdentity object that provides the local peer’s identity.

The remainder of the array should contain zero or more additional SecCertificate objects that provide any intermediate certificates that nearby peers might require when verifying the local peer’s identity. These certificates should be sent in certificate chain order.

When you add other peers to the session, those peers receive your local peer’s certificate (extracted from the provided identity) and any additional certificates that you provided. It is the receiving peer’s responsibility to validate that certificate, if desired.

encryptionPreference

An integer value that indicates whether encryption is required, preferred, or undesirable.

Return Value

The initialized session object, or nil if an error occurs.

Discussion

All combinations of authentication (supplying an identity value or not) and encryptionPreference are legal. Using both authentication to establish a peer’s identity and encryption to secure the channel provides the most security, while using neither provides none, but the right combination depends upon the needs of your application. For example, one app might use authentication with unencrypted data if the source of the data must be established, but the data is not sensitive. Another app might use an unauthenticated but encrypted link to avoid eavesdropping among known peers.

This method throws an exception if the provided peer ID object is invalid or nil.

For more information, see Initiating a Session.

See Also

Creating a Session

init(peer: MCPeerID)

Creates a Multipeer Connectivity session.

var delegate: MCSessionDelegate?

The delegate object that handles session-related events.

var encryptionPreference: MCEncryptionPreference

A value indicating whether the connection prefers encrypted connections, unencrypted connections, or has no preference.

var myPeerID: MCPeerID

A local identifier that represents the device on which your app is currently running.

var securityIdentity: [Any]?

The security identity of the local peer.