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.
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.
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();