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-
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
| Specification |
|---|
| Identity for WebRTC 1.0 # rtcidentityassertion-interface |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
RTCIdentityAssertion
|
|
|
|
|
|
|
|
|
|
|
|
|
idp
|
|
|
|
|
|
|
|
|
|
|
|
|
name
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Partial support
- Partial support
- No support
- No support
- Experimental. Expect behavior to change in the future.