Skip to content

Commit

Permalink
Merge pull request #2920 from shawnthompson/issue1916-accessible-auth…
Browse files Browse the repository at this point in the history
…entication

add email and password technique for 3.3.7
  • Loading branch information
alastc authored Feb 1, 2023
2 parents e6d6a29 + 8e572a0 commit 87040ae
Show file tree
Hide file tree
Showing 2 changed files with 74 additions and 1 deletion.
73 changes: 73 additions & 0 deletions techniques/html/authentication.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">

<head>
<title>Providing properly marked up email and password inputs</title>
<link rel="stylesheet" type="text/css" href="../../css/editors.css" />
</head>

<body>
<h1>Providing properly marked up email and password inputs</h1>
<section id="meta">
<h2>Metadata</h2>
<p id="sc">3.3.7 Accessible Authentication</p>
<p id="type">Sufficient</p>
</section>
<section id="applicability">
<h2>Applicability</h2>
<p class="instructions">Technologies that support authentication.</p>
</section>
<section id="description">
<h2>Description</h2>
<p>The objective of this technique is to provide examples of properly marked up email and password inputs. This technique involves providing form mechanism where the user can enter their email address and password to log into the website.</p>
<p>Browsers and password managers generally use the accessible name of the input to determine how to fill it in.</p>
</section>
<section id="examples">
<h2>Examples</h2>
<section class="example">
<h3>properly marked up email and password inputs</h3>
<p>A secure website has an email and password based login form. </p>
<pre>
<code class="language-html">
&lt;form method=&quot;post&quot; action=&quot;login&quot;&gt;
&lt;div&gt;
&lt;label for=&quot;email&quot;&gt;Email&lt;/label&gt;
&lt;input id=&quot;email&quot; type=&quot;email&quot; autocomplete=&quot;email&quot; ... &gt;
&lt;/div&gt;
&lt;div&gt;
&lt;label for=&quot;password&quot;&gt;Password&lt;/label&gt;
&lt;input id=&quot;password&quot; type=&quot;password&quot; autocomplete=&quot;current-password&quot; ... &gt;
&lt;/div&gt;
&lt;input type=&quot;submit&quot; value=&quot;Login&quot &gt;
&lt;/div&gt;
&lt;/form&gt;
</code>
</pre>
</section>
</section>
<section id="tests">
<h2>Tests</h2>
<section class="test-procedure">
<h3>Procedure</h3>
<p>For websites which require users to login with an email and password only:</p>
<ol>
<li>Check that each input for authentication includes an appropriate accessible-name.</li>
<li>Check that each input for authentication allows pasting.</li>
</ol>
</section>
<section class="test-results">
<h3>Expected Results</h3>
<ul>
<li>#1 and #2 are true.</li>
</ul>
</section>
</section>
<section id="resources">
<h2>Resources</h2>
<ul>
<li><a href="https://www.boia.org/blog/is-your-sites-authentication-process-accessible">Bureau of Internet Accessibility: How To Make Your Website's Authentication Process Accessible</a></li>
</ul>
</section>
</body>

</html>
2 changes: 1 addition & 1 deletion understanding/22/accessible-authentication.html
Original file line number Diff line number Diff line change
Expand Up @@ -126,7 +126,7 @@ <h3>Sufficient Techniques for Accessible Authentication</h3>
<a href="../../techniques/general/G218.html" class="general">Email link authentication</a>
</li>
<li>
Providing a properly marked up email and password inputs (Potential future technique)
<a href="../../techniques/html/authentication.html" class="html">Providing properly marked up email and password inputs</a>
</li>
<li>
Providing WebAuthn as an alternative to username/password (Potential future technique)
Expand Down

0 comments on commit 87040ae

Please sign in to comment.