Persona

  • Revision slug: Persona
  • Revision title: Persona
  • Revision id: 375281
  • Created:
  • Creator: ksikora
  • Is current revision? No
  • Comment

Revision Content

Stay in touch or get help!

Follow our blog, join our mailing list, or find us in #identity on IRC.

Mozilla Persona is a cross-browser login system for the Web that's easy to use and easy to deploy. It works on all major browsers, and you can get started today.

Why should you use Persona on your website?

  1. Persona completely eliminates site-specific passwords, freeing users and websites from the burden of creating, managing, and securely storing passwords.
  2. Persona is easy to use. With just two clicks a Persona user can sign into a new site like Voost or The Times Crossword, bypassing the friction associated with account creation.
  3. Persona is easy to implement. Developers can add Persona to a site in a single afternoon.
  4. Best of all, there's no lock-in. Developers get a verified email address for all of their users, and users can use any email address with Persona.

Plus, Persona is only going to get better: it's built on an open, decentralized protocol that's designed to allow direct integration into browsers and native support by email providers. Sites that implement Persona today will automatically experience those improvements, without having to change any code.

Note: Persona is in active development. Follow our blog to learn about new features, or join our mailing list and offer your feedback!

Using Persona on your site

Getting started

Why Persona?
Learn about reasons to support Persona on your site, and how it compares to other identity and authentication systems.
Quick setup
A quick walkthrough showing how to add Persona to your website.

Persona API reference

The navigator.id API reference
Reference for the navigator.id object, which web developers can use to integrate Persona into sites.
Verification API reference
Reference for the remote verification API hosted at https://verifier.login.persona.org/verify.

Guides

Security considerations
Practices and techniques to make sure your Persona deployment is secure.
Browser compatibility
Learn exactly which browsers support Persona.
Internationalization
Learn how Persona handles different languages.
The implementor's guide
Tips from sites that have added support for Persona.

Resources

Libraries and plugins
Find a drop-in library for your favorite programming language, web framework, blog, or content management system.
The Persona cookbook
Example source code for Persona sites. Includes snippets in C# (MVC3), PHP, Node.JS, and more.
Branding resources
Sign in buttons and other graphics to help present Persona to your users.

Information for Identity Providers

If you're an email provider or another identity-providing service, check out the links below to learn about becoming a Persona Identity Provider.

IdP Overview
A high level view of Persona Identity Providers.
Implementing an IdP
A detailed guide to the technical details of becoming an IdP.
.well-known/browserid
An overview of the structure and purpose of the .well-known/browserid file, which IdPs use to advertise their support for the protocol.

The Persona Project

Glossary
BrowserID and Persona terminology defined.
FAQ
Answers to common questions.
Protocol overview
A mid-level technical overview of the underlying BrowserID protocol.
Crypto
A look at the cryptographic concepts behind Persona and BrowserID.
The Spec
Deep technical details live here.
The Persona Website
To get Persona going, we're hosting three services at https://login.persona.org: a fallback Identity Provider, a portable implementation of the {{domxref("navigator.id")}} APIs, and an identity assertion verification service.
The Persona Source Code
The code behind the Persona website lives in a repository on GitHub. Pull requests welcome!

 

Revision Source

<div class="callout-box">
  <p><strong>Stay in touch or get help!</strong></p>
  <p>Follow <a class="external" href="http://identity.mozilla.com/">our blog</a>, join <a class="link-https" href="https://lists.mozilla.org/listinfo/dev-identity">our mailing list</a>, or find us in <a class="link-irc" href="irc://irc.mozilla.org/identity">#identity</a> on <a class="link-https" href="https://wiki.mozilla.org/IRC">IRC</a>.</p>
</div>
<p><a href="https://login.persona.org/">Mozilla Persona</a> is a cross-browser login system for the Web that's easy to use and easy to deploy. It works on <a href="/en-US/docs/persona/Browser_compatibility">all major browsers</a>, and you can <a href="/en-US/docs/Persona/Quick_Setup">get started today</a>.</p>
<p>Why should you use Persona on your website?</p>
<ol>
  <li><strong>Persona completely eliminates site-specific passwords</strong>, freeing users and websites from the burden of creating, managing, and securely storing passwords.</li>
  <li><strong>Persona is easy to use.</strong> With just two clicks a Persona user can sign into a new site like <a href="http://voo.st">Voost</a> or <a href="http://crossword.thetimes.co.uk/">The Times Crossword</a>, bypassing the friction associated with account creation.</li>
  <li><strong>Persona is easy to implement</strong><strong>. </strong>Developers can add Persona to a site in a single afternoon.</li>
  <li>Best of all, there's <strong>no lock-in</strong>. Developers get a verified email address for all of their users, and users can use any email address with Persona.</li>
</ol>
<p>Plus, Persona is only going to get better: it's built on an <strong>open, decentralized protocol</strong> that's designed to allow <strong>direct integration into browsers</strong> and <strong>native support by email providers</strong><strong>. </strong>Sites that implement Persona today will automatically experience those improvements, without having to change any code.</p>
<div class="note">
  <strong>Note:</strong> Persona is in active development. Follow <a class="external" href="http://identity.mozilla.com/">our blog</a> to learn about new features, or join <a class="link-https" href="https://lists.mozilla.org/listinfo/dev-identity">our mailing list</a> and offer your feedback!</div>
<h2 id="Using_Persona_on_your_site">Using Persona on your site</h2>
<div class="topicpage-table">
  <div>
    <div class="section">
      <h3 id="Getting_started">Getting started</h3>
      <dl>
        <dt>
          <a href="/en-US/docs/Persona/Why_Persona">Why Persona?</a></dt>
        <dd>
          Learn about reasons to support Persona on your site, and how it compares to other identity and authentication systems.</dd>
        <dt>
          <a href="/en-US/docs/Persona/Quick_Setup">Quick setup</a></dt>
        <dd>
          A quick walkthrough showing how to add Persona to your website.</dd>
      </dl>
    </div>
    <div class="section">
      <h3 id="Persona_API_reference">Persona API reference</h3>
      <dl>
        <dt>
          <a href="/en-US/docs/DOM/navigator.id">The navigator.id API reference</a></dt>
        <dd>
          Reference for the <code>navigator.id</code> object, which web developers can use to integrate Persona into sites.</dd>
        <dt>
          <a href="/en-US/docs/Persona/Remote_Verification_API">Verification API reference</a></dt>
        <dd>
          Reference for the remote verification API hosted at <code>https://verifier.login.persona.org/verify</code>.</dd>
      </dl>
    </div>
  </div>
  <div>
    <div class="section">
      <h3 id="Guides">Guides</h3>
      <dl>
        <dt>
          <a href="/en-US/docs/Persona/Security_Considerations">Security considerations</a></dt>
        <dd>
          Practices and techniques to make sure your Persona deployment is secure.</dd>
        <dt>
          <a href="/en-US/docs/Persona/Browser_compatibility">Browser compatibility</a></dt>
        <dd>
          Learn exactly which browsers support Persona.</dd>
        <dt>
          <a href="/en-US/docs/Persona/Internationalization">Internationalization</a></dt>
        <dd>
          Learn how Persona handles different languages.</dd>
        <dt>
          <a href="/en-US/docs/Persona/The_implementor_s_guide">The implementor's guide</a></dt>
        <dd>
          Tips from sites that have added support for Persona.</dd>
      </dl>
    </div>
    <div class="section">
      <h3 id="Resources">Resources</h3>
      <dl>
        <dt>
          <a href="/en-US/docs/Persona/Libraries_and_plugins">Libraries and plugins</a></dt>
        <dd>
          Find a drop-in library for your favorite programming language, web framework, blog, or content management system.</dd>
        <dt>
          <a class="link-https" href="https://github.com/mozilla/browserid-cookbook">The Persona cookbook</a></dt>
        <dd>
          Example source code for Persona sites. Includes snippets in C# (MVC3), PHP, Node.JS, and more.</dd>
        <dt>
          <a href="/en-US/docs/Persona/branding">Branding resources</a></dt>
        <dd>
          Sign in buttons and other graphics to help present Persona to your users.</dd>
      </dl>
    </div>
  </div>
</div>
<div class="topicpage-table">
  <div class="section">
    <h2 id="Information_for_Identity_Providers">Information for Identity Providers</h2>
    <p>If you're an email provider or another identity-providing service, check out the links below to learn about becoming a Persona Identity Provider.</p>
    <dl>
      <dt>
        <a href="/en-US/docs/Persona/Identity_Provider_Overview">IdP Overview</a></dt>
      <dd>
        A high level view of Persona Identity Providers.</dd>
      <dt>
        <a href="/en-US/docs/Persona/Implementing_a_Persona_IdP">Implementing an IdP</a></dt>
      <dd>
        A detailed guide to the technical details of becoming an IdP.</dd>
      <dt>
        <a href="/en-US/docs/Persona/.well-known-browserid">.well-known/browserid</a></dt>
      <dd>
        An overview of the structure and purpose of the <code>.well-known/browserid</code> file, which IdPs use to advertise their support for the protocol.</dd>
    </dl>
  </div>
  <div class="section">
    <h2 id="The_Persona_Project">The Persona Project</h2>
    <dl>
      <dt>
        <a href="/en-US/docs/Persona/Glossary">Glossary</a></dt>
      <dd>
        BrowserID and Persona terminology defined.</dd>
      <dt>
        <a href="/en-US/docs/Persona/FAQ">FAQ</a></dt>
      <dd>
        Answers to common questions.</dd>
      <dt>
        <a href="/en-US/docs/Persona/Protocol_Overview">Protocol overview</a></dt>
      <dd>
        A mid-level technical overview of the underlying BrowserID protocol.</dd>
      <dt>
        <a href="/en-US/docs/persona/Crypto">Crypto</a></dt>
      <dd>
        A look at the cryptographic concepts behind Persona and BrowserID.</dd>
      <dt>
        <a class="link-https" href="https://github.com/mozilla/id-specs/blob/prod/browserid/index.md">The Spec</a></dt>
      <dd>
        Deep technical details live here.</dd>
      <dt>
        <a href="/en-US/docs/Persona/Bootstrapping_Persona">The Persona Website</a></dt>
      <dd>
        To get Persona going, we're hosting three services at <a class="link-https" href="https://login.persona.org" rel="freelink">https://login.persona.org</a>: a fallback Identity Provider, a portable implementation of the {{domxref("navigator.id")}} APIs, and an identity assertion verification service.</dd>
      <dt>
        <a href="https://github.com/mozilla/browserid">The Persona Source Code</a></dt>
      <dd>
        The code behind the Persona website lives in a repository on GitHub. Pull requests welcome!</dd>
    </dl>
  </div>
</div>
<h2>&nbsp;</h2>
Revert to this revision