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.idpExperimental-
Indicates the domain name of the identity provider (IdP) that validated the identity.
RTCIdentityAssertion.nameExperimental-
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> |