MDN self-hosted library · e01.org

RTCIdentityAssertion

WebRTC

WebRTC

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

  • RTCIdentityAssertion.idp
  • : Indicates the domain name of the identity provider (IdP) that validated the identity.
  • RTCIdentityAssertion.name
  • : 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 RTCPeerConnection.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

  • RTCPeerConnection.peerIdentity
  • RTCPeerConnection.getIdentityAssertion()
  • WebRTC API