Persona

  • Revision slug: Persona
  • Revision title: Persona
  • Revision id: 297468
  • Created:
  • Creator: wbamberg
  • 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 an identity system for the web. The foundation of Persona is the BrowserID protocol, which enables users to sign into websites using their email address.

This page collects resources for people who are interested in adding Persona support to their website, in helping develop the BrowserID protocol, or in becoming a BrowserID Identity Provider.

Persona works on all modern browsers, only requires an hour or two to implement, and makes for a more frictionless experience by eliminating the "email confirmation" step when a user first signs into a site. Website operators still get a verified email address for their users, and users only have to remember a single password. Persona is intuitive, since email addresses are commonly understood to be associated with identities.

You can try Persona right now by going to Voo.st and signing in, or read more about it from the user perspective at support.mozilla.org.

Read on to get started!

Note: Persona is in active development. It's ready to use today, but we're still refining the API. A formal "Beta" release is expected before the end of September. Follow our blog to learn about new developments, 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.

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 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.
Development tips
A set of tips and tricks useful while developing a new Identity Provider.
.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 BrowserID protocol.
Crypto
A look at the BrowserID Cryptographic concepts.
The Spec
Deep technical details live here.
https://login.persona.org
To get Persona going, we're hosting three services at https://login.persona.org: our own identity provider, a portable implementation of the BrowserID APIs, and a remote verification service. Learn here about why they're needed, and when we expect to remove them.

 

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/" title="http://identity.mozilla.com/">our blog</a>, join <a class="link-https" href="https://lists.mozilla.org/listinfo/dev-identity" title="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" title="irc://irc.mozilla.org/identity">#identity</a> on <a class="link-https" href="https://wiki.mozilla.org/IRC" title="https://wiki.mozilla.org/IRC"> IRC</a>.</p>
</div>
<p><a class="link-https" href="https://www.mozilla.org/en-US/persona/" title="https://www.mozilla.org/en-US/persona/">Mozilla Persona</a> is an identity system for the web. The foundation of Persona is the BrowserID protocol, which enables users to sign into websites using their email address.</p>
<p>This page collects resources for people who are interested in adding Persona support to their website, in helping develop the BrowserID protocol, or in becoming a BrowserID Identity Provider.</p>
<p>Persona works on all modern browsers, only requires an hour or two to implement, and makes for a more frictionless experience by eliminating the "email confirmation" step when a user first signs into a site. Website operators still get a verified email address for their users, and users only have to remember a single password. Persona is intuitive, since email addresses are commonly understood to be associated with identities.</p>
<p>You can try Persona right now by going to <a href="http://voo.st" title="http://voo.st">Voo.st</a> and signing in, or read more about it from the user perspective at <a class="link-https" href="https://support.mozilla.org/en-US/kb/what-browserid-and-how-does-it-work" title="https://support.mozilla.org/en-US/kb/what-browserid-and-how-does-it-work">support.mozilla.org</a>.</p>
<p>Read on to get started!</p>
<div class="note">
  <strong>Note:</strong> Persona is in active development. It's ready to use today, but we're still refining the API. A formal "Beta" release is expected before the end of September. Follow <a class="external" href="http://identity.mozilla.com/" title="http://identity.mozilla.com/">our blog</a> to learn about new developments, or join <a class="link-https" href="https://lists.mozilla.org/listinfo/dev-identity" title="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>
<table class="topicpage-table">
  <tbody>
    <tr>
      <td>
        <h3 id="Getting_started">Getting started</h3>
        <dl>
          <dt>
            <a href="/en/Persona/Why_Persona_" title="en/BrowserID/Why_BrowserID">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/Persona/Quick_Setup" title="BrowserID/Quick setup">Quick setup</a></dt>
          <dd>
            A quick walkthrough showing how to add Persona to your website.</dd>
        </dl>
      </td>
      <td>
        <h3 id="Persona_API_reference">Persona API reference</h3>
        <dl>
          <dt>
            <a href="/en/DOM/navigator.id" title="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/Persona/Remote_Verification_API" title="en/BrowserID/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>
      </td>
    </tr>
    <tr>
      <td>
        <h3 id="Guides">Guides</h3>
        <dl>
          <dt>
            <a href="/en/Persona/Security_Considerations" title="BrowserID/Security considerations">Security considerations</a></dt>
          <dd>
            Practices and techniques to make sure your Persona deployment is secure.</dd>
          <dt>
            <a href="/en/Persona/Browser_compatibility" title="/Browser_compatibility">Browser compatibility</a></dt>
          <dd>
            Learn exactly which browsers support Persona.</dd>
          <dt>
            <a href="/en/Persona/Internationalization" title="/Internationalization">Internationalization</a></dt>
          <dd>
            Learn how Persona handles different languages.</dd>
        </dl>
      </td>
      <td>
        <h3 id="Resources">Resources</h3>
        <dl>
          <dt>
            <a class="link-https" href="https://github.com/mozilla/browserid/wiki/BrowserID-Libraries" title="https://github.com/mozilla/browserid/wiki/BrowserID-Libraries">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" title="https://github.com/mozilla/browserid-cookbook">The Persona cookbook</a></dt>
          <dd>
            Example source code for Persona sites. Includes snippets in PHP, Node.JS, and more.</dd>
          <dt>
            <a href="/en-US/docs/persona/branding" title="/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>
      </td>
    </tr>
  </tbody>
</table>
<p>&nbsp;</p>
<table class="topicpage-table">
  <tbody>
    <tr>
      <td>
        <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" title="IdP">IdP Overview</a></dt>
          <dd>
            A high level view of Persona Identity Providers.</dd>
          <dt>
            <a href="/en/Persona/Implementing_a_Persona_IdP" title="Guide to 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/Persona/IdP_Development_tips" title="Developer tips">Development tips</a></dt>
          <dd>
            A set of tips and tricks useful while developing a new Identity Provider.</dd>
          <dt>
            <a href="/en-US/docs/Persona/.well-known-browserid" title="https://developer.mozilla.org/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>
      </td>
      <td>
        <h2 id="The_BrowserID_Project">The Persona Project</h2>
        <dl>
          <dt>
            <a href="/en/Persona/Glossary" title="navigator.id">Glossary</a></dt>
          <dd>
            BrowserID and Persona terminology defined.</dd>
          <dt>
            <a href="/en/Persona/FAQ" title="en/BrowserID/FAQ">FAQ</a></dt>
          <dd>
            Answers to common questions.</dd>
          <dt>
            <a href="/en/Persona/Protocol_Overview" title="BrowserID/Protocol overview">Protocol overview</a></dt>
          <dd>
            A mid-level technical overview of the BrowserID protocol.</dd>
          <dt>
            <a href="/en/persona/Crypto" title="MDN">Crypto</a></dt>
          <dd>
            A look at the BrowserID Cryptographic concepts.</dd>
          <dt>
            <a class="link-https" href="https://github.com/mozilla/id-specs/blob/master/browserid/index.md" title="https://github.com/mozilla/id-specs/blob/master/browserid/index.md">The Spec</a></dt>
          <dd>
            Deep technical details live here.</dd>
          <dt>
            <a href="/en/Persona/Bootstrapping_Persona" title="en/BrowserID/Bootstrapping_BrowserID">https://login.persona.org</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>: our own identity provider, a portable implementation of the BrowserID APIs, and a remote verification service. Learn here about why they're needed, and when we expect to remove them.</dd>
        </dl>
      </td>
    </tr>
  </tbody>
</table>
<p>&nbsp;</p>
Revert to this revision