RTCIdentityAssertion

Limited availability

The RTCIdentityAssertion interface of the WebRTC API represents the identity of a remote peer of the current connection. If no peer has yet been set and verified, then this interface returns null. Once set it can’t be changed.

Instance properties

• idp Experimental
  • : Indicates the domain name of the identity provider (IdP) that validated the identity.
• name Experimental
  • : Indicates the verified peer identity as a string in an email address-like format.

Examples

Accessing the remote peer’s identity

In this example, a function asynchronously waits for the remote peer’s identity to be verified via peerIdentity, then logs the identity provider domain and the peer’s identity name.

const pc = new RTCPeerConnection();

// …

async function logPeerIdentity() {
  try {
    const identity = await pc.peerIdentity;
    console.log(`IdP domain: ${identity.idp}`);
    console.log(`Peer name: ${identity.name}`);
  } catch (err) {
    console.error("Could not verify peer identity:", err);
  }
}

logPeerIdentity();

Specifications

Browser compatibility

See also

• peerIdentity
• getIdentityAssertion()
• WebRTC API