{"datePublished":"2018-11-01T14:14:16-07:00","url":"https://docs.blockstack.org/browser/ids-introduction.html","dateModified":"2018-11-01T14:14:16-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://docs.blockstack.org/browser/ids-introduction.html"},"author":{"@type":"Person","name":"Blockstack"},"description":"Get and use a Blockstack ID","@type":"BlogPosting","headline":"Get and use a Blockstack ID","@context":"http://schema.org"}</script>
<li><ahref="#create-an-initial-blockstack-id"id="markdown-toc-create-an-initial-blockstack-id">Create an initial Blockstack ID</a></li>
<li><ahref="#restore-a-blockstack-id"id="markdown-toc-restore-a-blockstack-id">Restore a Blockstack ID</a><ul>
<li><ahref="#restore-with-a-recovery-key"id="markdown-toc-restore-with-a-recovery-key">Restore with a recovery key</a></li>
<li><ahref="#restore-with-a-recovery-code-and-original-password"id="markdown-toc-restore-with-a-recovery-code-and-original-password">Restore with a recovery code and original password</a></li>
is a digital identity that is registered With Blockstack. Think of the ID as a
form of identification, like a drivers license, but this license identifies you
on the virtual internet highway.</p>
<p>Your personal data storage is linked to this ID. You use this ID to
identify yourself to other users and to sign into applications. When you add a
picture to a Dapp, the picture appears in the Dapp but the picture’s bits and bytes
are stored in your personal storage.</p>
<p>When you log into another application with your ID, that application can ask for access to that storage and then use that picture. The application must ask you, it knows you by your ID, and</p>
<p>Decentralized applications that want to access your data need your
<p>The <em><codeclass="highlighter-rouge">USERNAME</code></em> portion must be unique. You enter an email and password to
create the initial identity. Blockstack uses the password to:</p>
<ul>
<li>seed a <em>recovery code</em> an encrypted string, for example <codeclass="highlighter-rouge">36mWivFdy0YPH2z31EflpQz/Y0UMrOrJ++lH=0EI7c3mop2JuRBm5W1P0BwXxSTazJsUjOAmC55rFUWINqDqGccLio0iwzGclAhaHGZQ5M52</code></li>
<li>seed a <em>recovery key</em> which is a squence of words <codeclass="highlighter-rouge">applied binge crisp pictorial fiery dancing agreeable frogs light finish ping apple</code></li>
</ul>
<p>The email is provided to allow either Blockstack or a decentralized application
to communicate information to you. In Blockstacks’ case, the email is used to
send you reovery information.</p>
<p>While Blockstack registers your human readable ID and the recovery key. <em>You</em> must
record the:</p>
<ul>
<li>recovery key</li>
<li>recovery code (in the order the words apepar)</li>
<li>initial password</li>
</ul>
<p>Blockstack does not store them, so it can’t give them to you later if they are
lost.</p>
<p>Your initial ID is created in the <codeclass="highlighter-rouge">id.blockstack</code> domain. The initial identity
remains primary, and you need this primary ID and its associated information
(recovery code, recovery key, and password) to use the browser again.</p>
<p>Finally, the <codeclass="highlighter-rouge">id.blockstack</code> domain is sponsored by the Blockstack registrar and
identities on it are free. Once you are using the Blockstack Browser, you can
create additional identities outside of this domain and controlled by other
registrars. Coin is required to purchase identities on other domains.</p>
<h2id="create-an-initial-blockstack-id">Create an initial Blockstack ID</h2>
<p>To create an inititial Blockstack ID, do the following:</p>
<ol>
<li>
<p>Open the <ahref="https://browser.blockstack.org/sign-up?redirect=%2F">Blockstack web application in your browser</a>.</p>
<p>The application prompts you for an email address.</p>
<p><imgsrc="images/create-id-0.png"alt=""/></p>
<p>Blockstack uses this email address to send you recovery information.</p>
</li>
<li>
<p>Enter an email address and press <strong>Next</strong>.</p>
<p>The application prompts you to enter a password. Blockstack users this
password to encrypt your recovery code. You must record and save this
initial password.</p>
<p><strong>NOTE</strong>:The Blockstack team cannot restore your password for you.</p>
</li>
<li>
<p>Enter a password, confirm it, and press <strong>Next</strong>.</p>
<p><imgsrc="images/create-id-1.png"alt=""/></p>
<p>The browser prompts you to register a unique username in the <codeclass="highlighter-rouge">id.blockstack</code>
domain. This is your identity in the decentralized internet. The format of the id
<ahref="https://twitter.com/intent/tweet?text=Get and use a Blockstack ID&url=https://docs.blockstack.org/browser/ids-introduction.html&via=&related="rel="nofollow"target="_blank"title="Share on Twitter"onclick="window.open(this.href, 'twitter', 'width=550,height=235');return false;"><spandata-uk-icon="icon: twitter; ratio: 1.2"></span></a>
/* A CSS selector that points to your search box */
searchBox: {
selector: '#searchBox'
},
results: {
embedConfig: undefined, // {'url':undefined,'contentBlock':'.page-content-body'}, // if url is given the page will change to that URL and look for the content block there to insert the results
fullScreenConfig: undefined, // {trigger: '#ss360-search-trigger', caption: 'Search this site'}, trigger is the CSS selector to the element that starts the search full screen overlay and searchCaption the caption on the full screen search page
caption: 'Found #COUNT# search results for \"#QUERY#\"', // the caption of the search results
group: true, // whether results should be grouped if content groups are available
filters: undefined,
num: 96, // the maximum number of search results to be shown
highlightQueryTerms: true, // whether to highlight the query terms in search results
moreResultsButton: "Show more results", // HTML for the more results button, all results will be shown if this is null
noResultsText: 'Sorry, we have not found any matches for your query.', // the text to show when there are no results
queryCorrectionText: 'Did you mean "#CORRECTION#"?',
searchQueryParamName: 'ss360Query', // the name of the search query parameter
linksOpenNewTab: false, // should clicking on the result links open a new tab/window?
showSearchBoxLayover: true, //whether to show search box in search result layover
moreResultsPagingSize: 12, // the number of new results to show each time the more results button is pressed (max: 24)
orderByRelevanceText: "Relevance" // the text to be shown in order select box to describe 'order by relevance' option
},
suggestions: {
show: true, // whether to show search suggestions
maxQuerySuggestions: 3, // the maximum number of query suggestions
querySuggestionHeadline: undefined, // the headline of the query suggestions, leave blank if no headline should be shown
emptyQuerySuggestions: undefined,
showImages: false, // show images in search suggestions
num: 6, // the maximum number of search suggestions to be shown
minChars: 3, // minimum number of characters before the suggestions shows, default: 3,
maxWidth: 'auto', // the maximum width of the suggest box, default: as wide as the input box, at least 275px
throttleTime: 300, // the number of milliseconds before the suggest is triggered after finished input, default: 300ms
extraHtml: undefined, // extra HTML code that is shown in each search suggest, you can even show values of datapoints here,
highlight: true, // whether matched words should be highlighted, default: true
},
smart404: { /* The caption of the search results. */
caption: 'These links might be useful', /* The string in the title that identifies the page as a 404 page. */
identifier: 'Page not found', /* A CSS selector that points to the area in which the alternative links should be shown. */