blob: 35dab1a6c2d8861769c41bf523ef531eaa8ba65f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
|
---
title: IdentityManager
slug: Web/API/IdentityManager
translation_of: Archive/IdentityManager
---
<p>{{APIRef("Persona")}}{{non-standard_header}}</p>
<p>The <strong><code>IdentityManager</code></strong> of the <a href="/en-US/docs/Persona" title="BrowserID">BrowserID protocol</a> exposes the BrowserID API, via {{domxref("navigator.id")}}. This API has gone through several significant revisions. Each generation is listed separately below.</p>
<h2 id="ObserverMethods" name="ObserverMethods">The "Observer" API (Current)</h2>
<p>The Observer API introduces much-requested features, such as an improved post-verification experience for first-time users, automatic persistent logins, and easier integration with native applications.</p>
<dl>
<dt>{{ domxref("IdentityManager.watch()")}}</dt>
<dd>Registers callbacks to be invoked when a user logs into or out of a website.</dd>
<dt>{{ domxref("IdentityManager.request()")}}</dt>
<dd>Requests a signed identity assertion from the user.</dd>
<dt>{{ domxref("IdentityManager.logout()")}}</dt>
<dd>Logs the user out of a website and prevents the <code>onlogin</code> action from automatically firing on their next visit.</dd>
</dl>
<div class="note">
<p>Users with third-party cookies disabled may experience problems logging in using the Observer API as detailed in <a href="https://github.com/mozilla/browserid/issues/2999" title="https://github.com/mozilla/browserid/issues/2999">issue 2999</a>.</p>
</div>
<h2 id="CallbackMethods" name="CallbackMethods">The "Callback" API (Current)</h2>
<p>The Callback API was introduced in November 2011. It improved upon the initial API by allowing options to be passed to <code>navigator.id.get()</code> and offering experimental support for BrowserID-managed persistent sessions.</p>
<dl>
<dt>{{ domxref("IdentityManager.get()")}}</dt>
<dd>Gets the user's BrowserID in a signed assertion.</dd>
</dl>
<h2 id="VerifiedEmailMethods" name="VerifiedEmailMethods">The "VerifiedEmail" API (Deprecated)</h2>
<p>The VerifiedEmail API was BrowserID's first API. It was deprecated at the end of 2011.</p>
<dl>
<dt>{{ domxref("IdentityManager.getVerifiedEmail()")}} {{ deprecated_inline() }}</dt>
<dd>Gets the user's BrowserID in a signed assertion. This method is deprecated; {{ domxref("navigator.id.get()")}} is backwards compatible and can be used instead.</dd>
</dl>
|
