readme.html

<h2>What´s this?</h2>

<p>A way to authenticate users using Durandal and token authentication with the new ASP.NET Identity membership.</p>

<p>The included features are:</p>

<ul>
<li><p>Authentication and authorization using ASP.NET Identity 2 system and token authentication</p></li>
<li><p>Authorization in Durandal views</p></li>
<li><p>Model validation both client (knockout validation) and server (data attributes)</p></li>
<li><p>UnitOfWork and Repository patterns both client and server</p></li>
<li><p>Using Breeze JS in the client for better data management</p></li>
<li><p>pushState enabled</p></li>
<li><p>Styled with Bootstrap 3</p></li>
<li><p>Optionally, the site is ready for SEO using <a href="http://github.com/yagopv/azurecrawler">AzureCrawler</a></p></li>
<li><p>Dynamic Sitemap generation</p></li>
</ul>

<h2>Check it out!! ...</h2>

<p>... the <a href="https://durandalauth.azurewebsites.net">sample site</a> and play with it</p>

<h2>Weyland config</h2>

<p>When you make changes over this project you are going to need to optimize the Durandal files, so remember, you have to install <strong>node</strong> and <strong>weyland</strong></p>

<p><code><br/>
//install node and run this in your command line<br/>
npm install -g weyland<br/>
weyland build<br/>
</code></p>

<p>Or you can follow this links:</p>

<p><a href="https://github.com/BlueSpire/Weyland">Building with weyland</a></p>

<p><a href="http://durandaljs.com/documentation/Automating-Builds-with-Visual-Studio.html">Automating builds with Visual Studio</a></p>

<h2>About SEO Optimization</h2>

<p>The template is ready to be SEO crawlable. DurandalAuth implements the <a href="https://developers.google.com/webmasters/ajax-crawling/docs/getting-started">google ajax crawling scheme</a> for pages without hash fragments. You need the default pushstate option enabled.</p>

<p>I created a interface (Helpers/ISnapshot.cs) that needs to be implemented in order to work.</p>

<p>The default implementation uses <a href="https://github.com/yagopv/azurecrawler">a new project I created called AzureCrawler</a></p>

<p>This new project is a Worker Role ready to be deployed to Windows Azure and serving a REST Web API via OWIN. The Web API executes a phantomjs process when receiving requests and returns html snapshots. Moreover, AzureCrawler can save the snapshot to Azure Storage and keep it there with the expiration date you choose, so next time the page is requested for any bot, the stored snapshot will be served.</p>

<p>I created AzureCrawler like a separate project but it´s easy to bring all the concepts from AzureCrawler to your own project if you want to keep it in the same solution. Another option is creating your own implementation of ISnapshot.cs.</p>

<p>Check durandalauth site at google:</p>

<p><code><br/>
site:durandalauth.azurewebsites.net<br/>
</code></p>

<p>Another included feature, very useful for SEO, is the dynamic generation of sitemaps. If you browse to <strong>localhost:port/sitemap</strong> url an XML Sitemap will be rendered.</p>

<p>Include your own urls in the SitemapController and change the <strong>robots.txt</strong> for pointing to your own domain.</p>

<h2>Looking for the old version code</h2>

<p>Check <a href="https://github.com/yagopv/DurandalAuth/tree/DurandalAuth-MVC4-SimpleMembership">this branch</a> if you are looking for the MVC 4 with SimpleMembership code.</p>