supernets.org

- https://supernets.org
git clone git://git.acid.vegas/supernets.org.git
Log | Files | Refs | Archive

sasl-authentication.html (6010B)

      1 <!DOCTYPE html>
      2 <html lang="en">
      3 	<head>
      4 		<title>SuperNETs</title>
      5 		<meta charset="UTF-8">
      6 		<meta name="author" content="SuperNETs">
      7 		<meta name="description" content="A secure and anonymous, censorship-free, public environment for communication.">
      8 		<meta name="keywords" content="anonymous, chat, internet, irc, ircd, network, relay, secure, super, nets, supernets, xmpp">
      9 		<meta name="viewport" content="width=device-width, initial-scale=1">
     10 		<link rel="icon" type="image/png" href="../i/favicon.png">
     11 		<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0/css/bootstrap.min.css" integrity="sha384-Gn5384xqQ1aoWXA+058RXPxPg6fy4IWvTNh0E263XmFcJlSAwiGgFAW/dAiS6JXm" crossorigin="anonymous">
     12 		<script src="https://code.jquery.com/jquery-3.3.1.slim.min.js" integrity="sha256-3edrmyuQ0w65f8gfBsqowzjJe2iM6n0nKciPUp8y+7E=" crossorigin="anonymous"></script>
     13 		<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.1/umd/popper.min.js" integrity="sha256-AoNQZpaRmemSTxMy9xcqXX5VLwI6IMPYugO7bFHOW+U=" crossorigin="anonymous"></script>
     14 		<script src="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0/js/bootstrap.min.js" integrity="sha384-JZR6Spejh4U02d8jOt6vLEHfe/JQGiRRSQQxSfFWpi1MquVdAyjUar5+76PVCmYl" crossorigin="anonymous"></script>
     15 		<link href="../inc/style.css" rel="stylesheet">
     16 	</head>
     17 	<body>
     18 		<div class="container">
     19 			<header class="header clearfix">
     20 				<nav class="navbar navbar-expand-lg navbar-light bg-white">
     21 					<a class="navbar-brand text-muted bolder" href="#">SUPERNETS</a>
     22 					<button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
     23 						<span class="navbar-toggler-icon"></span>
     24 					</button>
     25 					<div class="collapse navbar-collapse" id="navbarSupportedContent">
     26 						<ul class="navbar-nav ml-auto">
     27 							<li class="nav-item"><a class="nav-link" href="../index.html">Home</a></li>
     28 							<li class="nav-item"><a class="nav-link" href="../about.html">About</a></li>
     29 							<li class="nav-item"><a class="nav-link" href="../contact.html">Contact</a></li>
     30 							<li class="nav-item"><a class="nav-link" href="../docs.html">Docs</a></li>
     31 							<li class="nav-item dropdown">
     32 								<a class="nav-link dropdown-toggle" href="#" id="navbarDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Network</a>
     33 								<div class="dropdown-menu" aria-labelledby="navbarDropdown">
     34 									<a class="dropdown-item" href="https://git.supernets.org/">Git</a>
     35 									<a class="dropdown-item" href="../irc.html">IRC</a>
     36 								</div>
     37 							</li>
     38 						</ul>
     39 					</div>
     40 				</nav>
     41 			</header>
     42 			<main role="main">
     43 				<p><abbr title="Simple Authentication and Security Layer">SASL</abbr> is an <a href="https://ircv3.net/">IRCv3</a> feature that allows authentication to services while connecting.</p>
     44 				<p>Because this is an IRCv3 feature, not every IRC network has support for SASL authentication. The <code>CAP LS</code> command can be used to detect SASL capabilities.
     45 				<p>The PLAIN mechanism allows you to authenticate with your NickServ username and password.</p>
     46 				<p>The EXTERNAL mechanism allows you to authenticate with your <a href="ssl-client-certificate.html">SSL client certificate</a>. <i>(This mechanism requires you be connected via SSL/TLS)</i></p>
     47 				<hr>
     48 				<br>
     49 				<h4>Client Usage</h4>
     50 				<br>
     51 				<h5 class="text-muted">AndroIRC</h5>
     52 				<h6>PLAIN</h6>
     53 				<ul>
     54 					<li>Add/Edit a server and check the "Authentication" box.</li>
     55 					<li>Change the "Authentication service" to "SASL".</li>
     56 					<li>Change the "Authentication TYPE" to "PLAIN".</li>
     57 					<li>Enter your NickServ information for "Username" and "Password".</li>
     58 				</ul>
     59 				<br>
     60 				<h5 class="text-muted">HexChat / XChat</h5>
     61 				<h6>PLAIN</h6>
     62 				<ul>
     63 					<li>Add/Edit a network, change "Login method" to "SASL (username + password)" and change "Password" to your NickServ password.</li>
     64 				</ul>
     65 				<h6>EXTERNAL</h6>
     66 				<ul>
     67 					<li>Add/Edit a network, change "Login method" to "SASL EXTERNAL (cert)".</li>
     68 				</ul>
     69 				<br>
     70 				<h5 class="text-muted">irssi</h5>
     71 				<h6>PLAIN</h6>
     72 				<ul>
     73 					<li><code>/network add -sasl_username &lt;username&gt; -sasl_password &lt;password&gt; -sasl_mechanism PLAIN &lt;network_name&gt;</code></li>
     74 				</ul>
     75 				<h6>EXTERNAL</h6>
     76 				<ul>
     77 					<li><code>/network add -sasl_mechanism EXTERNAL &lt;network_name&gt;</code></li>
     78 				</ul>
     79 				<br>
     80 				<h5 class="text-muted">mIRC</h5>
     81 				<h6>PLAIN</h6>
     82 				<ul>
     83 					<li>Options Menu -> Connect -> Servers</li>
     84 					<li>Add/Edit a serverm, change "Method" to "SASL (/CAP)" and change "Password" to "&lt;username&gt;:&lt;password&gt;" using your NickServ information.</li>
     85 				</ul>
     86 				<h6>EXTERNAL</h6>
     87 				<ul>
     88 					<li>Options Menu -> Connect -> Servers</li>
     89 					<li>Add/Edit a serverm, change "Method" to "SASL EXTERNAL (/CAP)".</li>
     90 				</ul>
     91 				<br>
     92 				<h5 class="text-muted">WeeChat</h5>
     93 				<h6>PLAIN</h6>
     94 				<ul>
     95 					<li><code>/set irc.server.&lt;network_name&gt;.sasl_mechanism plain</code></li>
     96 					<li><code>/set irc.server.&lt;network_name&gt;.sasl_username &lt;username&gt;</code></li>
     97 					<li><code>/set irc.server.&lt;network_name&gt;.sasl_password &lt;password&gt;</code></li>
     98 				</ul>
     99 				<h6>EXTERNAL</h6>
    100 				<ul>
    101 					<li><code>/set irc.server.&lt;network_name&gt;.sasl_mechanism external</code></li>
    102 				</ul>
    103 				<br>
    104 				<h5 class="text-muted">ZNC</h5>
    105 				<h6>PLAIN</h6>
    106 				<ul>
    107 					<li><code>/msg *status LoadMod sasl</code></li>
    108 					<li><code>/msg *sasl Mechanism PLAIN</code></li>
    109 					<li><code>/msg *sasl Set &lt;username&gt; &lt;password&gt;</code></li>
    110 				</ul>
    111 				<h6>EXTERNAL</h6>
    112 				<ul>
    113 					<li><code>/msg *status LoadMod sasl</code></li>
    114 					<li><code>/msg *sasl Mechanism EXTERNAL</code></li>
    115 				</ul>
    116 			</main>
    117 			<footer class="footer">
    118 				<p>&copy; Supernets 2019</p>
    119 			</footer>
    120 		</div>
    121 	</body>
    122 </html>