---
title: IdentityManager
slug: Web/API/IdentityManager
tags:
  - API
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>