RTCIdentityAssertion

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

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 Experimental

Indicates the domain name of the identity provider (IdP) that validated the identity.

RTCIdentityAssertion.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 RTCPeerConnection.peerIdentity, then logs the identity provider domain and the peer's identity name.

js
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

Specification
Identity for WebRTC 1.0
# rtcidentityassertion-interface

Browser compatibility

See also