RTCPeerConnection.peerIdentity

The read-only property RTCPeerConnection.peerIdentity returns an RTCIdentityAssertion, containing a DOMString once set and verified. If no peer has yet been set and verified, this property will return null. Once set, via the appropriate method, it can't be changed.

Syntax

 var identity = peerConnection.peerIdentity;

Value

identity

Is a RTCIdentityAssertion, a dictionary of two values:

• "idp", a DOMString representing the domain name of the Identity Provider who produced the assertion.
• "name", a DOMString containing the verified assertion.

Example

var pc = new RTCPeerConnection();
…
var identity = pc.peerIdentity;
if (identity) {
  alert("Identity of the peer: idp='" +         
        identity.idp + "'; assertion='" +
        identity.name + "'");
}
else {
  alert("Identity of the peer has not been verified");
}

Specifications

Specification	Status	Comment
WebRTC 1.0: Real-time Communication Between Browser The definition of 'RTCPeerConnection.peerIdentity' in that specification.	Working Draft	Initial specification.

Browser compatibility

[1] Though this property is not prefixed, the interface it belongs to is.

See also

• WebRTC