909 lines
24 KiB
HTML
909 lines
24 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="en"><head>
|
||
<link rel="preload" href="../static/fonts/comfortaa-v30-subset-regular.woff2" as="font" type="font/woff2" crossorigin>
|
||
<link rel="preload" href="../static/fonts/ubuntu-v15-latin-regular.woff2" as="font" type="font/woff2" crossorigin>
|
||
<link rel="preload" href="../static/fonts/ubuntu-v15-subset-500.woff2" as="font" type="font/woff2" crossorigin>
|
||
<link rel="preload" href="../static/img/libera-color.svg" as="image" type="image/svg+xml">
|
||
<meta charset="utf-8">
|
||
<meta content="IE=edge" http-equiv="X-UA-Compatible">
|
||
<meta content="width=device-width, initial-scale=1" name="viewport"><!-- Begin Jekyll SEO tag v2.8.0 -->
|
||
<title>Configuring SASL for Epic5 | Libera Chat</title>
|
||
<meta name="generator" content="Jekyll v3.9.2" />
|
||
<meta property="og:title" content="Configuring SASL for Epic5" />
|
||
<meta property="og:locale" content="en_GB" />
|
||
<meta name="description" content="EPIC5 has the sasl_auth and sasl_nistp256 scripts built-in. Mikhail contributed this explanation of how to use it." />
|
||
<meta property="og:description" content="EPIC5 has the sasl_auth and sasl_nistp256 scripts built-in. Mikhail contributed this explanation of how to use it." />
|
||
<link rel="canonical" href="epic5.html" />
|
||
<meta property="og:url" content="https://libera.chat/guides/epic5" />
|
||
<meta property="og:site_name" content="Libera Chat" />
|
||
<meta property="og:type" content="article" />
|
||
<meta property="article:published_time" content="2022-10-03T18:36:48+00:00" />
|
||
<meta name="twitter:card" content="summary" />
|
||
<meta property="twitter:title" content="Configuring SASL for Epic5" />
|
||
<meta name="twitter:site" content="@liberachat" />
|
||
<meta property="article:publisher" content="liberachat" />
|
||
<script type="application/ld+json">
|
||
{"@context":"https://schema.org","@type":"TechArticle","dateModified":"2022-10-03T18:36:48+00:00","datePublished":"2022-10-03T18:36:48+00:00","description":"EPIC5 has the sasl_auth and sasl_nistp256 scripts built-in. Mikhail contributed this explanation of how to use it.","headline":"Configuring SASL for Epic5","url":"https://libera.chat/guides/epic5"}</script>
|
||
<!-- End Jekyll SEO tag -->
|
||
<link rel="icon" type="image/svg+xml" href="../static/img/libera-color.svg">
|
||
<link rel="alternate icon" href="../favicon.ico">
|
||
<!-- Stylesheets -->
|
||
<style>/*! modern-normalize v1.0.0 | MIT License | https://github.com/sindresorhus/modern-normalize */
|
||
*,::after,::before{box-sizing:border-box}:root{-moz-tab-size:4;tab-size:4}html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}body{font-family:system-ui,-apple-system,'Segoe UI',Roboto,Helvetica,Arial,sans-serif,'Apple Color Emoji','Segoe UI Emoji'}hr{height:0;color:inherit}abbr[title]{text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,pre,samp{font-family:ui-monospace,SFMono-Regular,Consolas,'Liberation Mono',Menlo,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,select{text-transform:none}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button}::-moz-focus-inner{border-style:none;padding:0}:-moz-focusring{outline:1px dotted ButtonText}:-moz-ui-invalid{box-shadow:none}legend{padding:0}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}</style>
|
||
<style>@font-face {
|
||
/* comfortaa-regular - subset */
|
||
font-family: 'Comfortaa';
|
||
src: url('../static/fonts/comfortaa-v30-subset-regular.woff2') format('woff2'), url('../static/fonts/comfortaa-v30-subset-regular.woff') format('woff'), url('../static/fonts/comfortaa-v30-subset-regular.ttf') format('truetype');
|
||
font-style: normal;
|
||
font-weight: 400;
|
||
font-display: swap;
|
||
/* . C L a b e h i r t */
|
||
unicode-range: U+002E, U+0043, U+004C, U+0061-0062, U+0065, U+0068-0069, U+0072, U+0074;
|
||
}
|
||
|
||
@font-face {
|
||
/* ubuntu-regular - latin */
|
||
font-family: 'Ubuntu';
|
||
src: local(''), url('../static/fonts/ubuntu-v15-latin-regular.woff2') format('woff2'), url('../static/fonts/ubuntu-v15-latin-regular.woff') format('woff'), url('../static/fonts/ubuntu-v15-latin-regular.ttf') format('truetype');
|
||
font-style: normal;
|
||
font-weight: 400;
|
||
font-display: swap;
|
||
}
|
||
|
||
@font-face {
|
||
/* ubuntu-500 - subset */
|
||
font-family: 'Ubuntu';
|
||
src: local(''), url('../static/fonts/ubuntu-v15-subset-500.woff2') format('woff2'), url('../static/fonts/ubuntu-v15-subset-500.woff') format('woff'), url('../static/fonts/ubuntu-v15-subset-500.ttf') format('truetype');
|
||
font-style: normal;
|
||
font-weight: 500;
|
||
font-display: swap;
|
||
/* C c e n o t */
|
||
unicode-range: U+0043 U+0063 U+0065 U+006E U+006F U+0074;
|
||
}
|
||
|
||
:root {
|
||
--header-height: 4rem;
|
||
--content-inline-padding: 1.3rem;
|
||
--content-max-width: 80ch;
|
||
/* define our palette for all themes */
|
||
--white: #fff;
|
||
--gray-100: #f3f4f6;
|
||
--gray-200: #e5e7eb;
|
||
--gray-300: #d1d5db;
|
||
--gray-400: #9ca3af;
|
||
--gray-800: #1f2937;
|
||
--gray-900: #111827;
|
||
--brand-purple: #5555ff;
|
||
--brand-pink: #ff55dd;
|
||
/* light-theme vars */
|
||
--c-bg: var(--gray-100);
|
||
--c-bg-secondary: var(--white);
|
||
--c-text: var(--gray-800);
|
||
--c-border: var(--gray-300);
|
||
--c-hl: var(--brand-pink);
|
||
--c-hl-secondary: var(--brand-purple);
|
||
--c-text-on-hl: var(--gray-800);
|
||
--c-text-on-hl-secondary: var(--white);
|
||
}
|
||
|
||
@media (prefers-color-scheme: dark) {
|
||
:root {
|
||
--c-bg: var(--gray-800);
|
||
--c-bg-secondary: var(--gray-900);
|
||
--c-text: var(--gray-200);
|
||
--c-border: var(--gray-400);
|
||
}
|
||
}
|
||
|
||
* {
|
||
color: var(--c-text);
|
||
box-sizing: border-box;
|
||
font-family: Ubuntu, sans-serif;
|
||
letter-spacing: .1ch;
|
||
}
|
||
|
||
main *, .hero * {
|
||
line-height: 1.5;
|
||
}
|
||
|
||
body {
|
||
background-color: var(--c-bg);
|
||
min-height: 100vh;
|
||
display: grid;
|
||
grid-template-rows: var(--header-height) min-content auto auto min-content;
|
||
grid-template-columns: 1fr;
|
||
grid-template-areas: "header" "hero" "main" "aside" "footer";
|
||
}
|
||
|
||
a {
|
||
text-decoration: underline;
|
||
text-underline-offset: .05rem;
|
||
}
|
||
|
||
a:hover {
|
||
text-underline-offset: .25rem;
|
||
color: var(--c-hl);
|
||
}
|
||
|
||
h1, h2, h3, h4, h5, h6, p {
|
||
word-break: break-word;
|
||
scroll-margin-block-start: 4.5rem;
|
||
}
|
||
|
||
h1, h2, h3, h4, h5, h6, strong {
|
||
font-weight: 500;
|
||
}
|
||
|
||
em {
|
||
font-style: italic;
|
||
}
|
||
|
||
h1, h2, h3, h4, h5, h6 {
|
||
margin-block-end: 0;
|
||
}
|
||
|
||
h1+*, h2+*, h3+*, h4+*, h5+*, h6+* {
|
||
margin-block-start: 0;
|
||
}
|
||
|
||
main h1 {
|
||
font-size: 2.25rem;
|
||
}
|
||
|
||
main h2 {
|
||
font-size: 1.5rem;
|
||
}
|
||
|
||
main h3 {
|
||
font-size: 1.25rem;
|
||
}
|
||
|
||
main :is(h2, h3, h4, h5, h6) a {
|
||
text-decoration: none;
|
||
position: relative;
|
||
}
|
||
|
||
main :is(h2, h3, h4, h5, h6) a:hover::before {
|
||
content: '#';
|
||
position: absolute;
|
||
left: -1.5ch;
|
||
bottom: 0;
|
||
font-weight: normal;
|
||
font-size: 1rem;
|
||
}
|
||
|
||
@media screen and (min-width: 800px) {
|
||
body {
|
||
grid-template-columns: min-content 8fr;
|
||
grid-template-rows: 4rem min-content auto min-content;
|
||
grid-template-areas: "header header" "hero hero" "aside main" "footer footer";
|
||
}
|
||
}
|
||
|
||
.skiplink {
|
||
z-index: 9999;
|
||
transform: translateY(calc(-100% - 1rem));
|
||
display: block;
|
||
position: absolute;
|
||
height: 4rem;
|
||
padding: var(--content-inline-padding);
|
||
background-color: var(--c-bg);
|
||
border-inline-end: 1px solid var(--c-border);
|
||
border-block-end: 1px solid var(--c-border);
|
||
}
|
||
|
||
.skiplink:focus {
|
||
z-index: 9999;
|
||
transform: translateY(0);
|
||
}
|
||
|
||
header {
|
||
grid-area: header;
|
||
height: var(--header-height);
|
||
border-block-end: 1px solid var(--c-border);
|
||
background-color: var(--c-bg-secondary);
|
||
position: sticky;
|
||
top: 0;
|
||
z-index: 1000;
|
||
display: flex;
|
||
flex-direction: row;
|
||
flex-wrap: nowrap;
|
||
justify-content: space-between;
|
||
}
|
||
|
||
header a {
|
||
text-decoration: none;
|
||
}
|
||
|
||
header .logo {
|
||
display: flex;
|
||
flex-wrap: nowrap;
|
||
align-items: center;
|
||
height: 100%;
|
||
padding-inline-start: var(--content-inline-padding);
|
||
}
|
||
|
||
header .logo img {
|
||
padding-block-end: .3rem;
|
||
}
|
||
|
||
header .logo h1 {
|
||
margin: 0;
|
||
margin-bottom: -.4rem;
|
||
font-size: 1.7rem;
|
||
line-height: 1;
|
||
font-family: Comfortaa, Ubuntu, sans-serif;
|
||
font-weight: bold;
|
||
}
|
||
|
||
header .nav-toggle {
|
||
display: block;
|
||
border-inline-start: 1px solid var(--c-border);
|
||
padding: 0 1rem;
|
||
display: flex;
|
||
align-items: center;
|
||
cursor: pointer;
|
||
}
|
||
|
||
header nav details summary, header nav a {
|
||
border-block-end: 1px solid var(--c-border);
|
||
padding: 1rem;
|
||
display: flex;
|
||
align-items: center;
|
||
cursor: pointer;
|
||
white-space: nowrap;
|
||
}
|
||
|
||
header nav details summary::before {
|
||
content: "►";
|
||
padding-inline-end: .3rem;
|
||
}
|
||
|
||
header nav details[open] summary::before {
|
||
content: "▼";
|
||
}
|
||
|
||
header nav .nav-close {
|
||
display: none;
|
||
}
|
||
|
||
header nav.show .nav-close {
|
||
display: flex;
|
||
}
|
||
|
||
header nav {
|
||
transform: translateY(calc(-100% - 1rem));
|
||
display: flex;
|
||
flex-direction: column;
|
||
justify-content: flex-start;
|
||
position: fixed;
|
||
right: 0;
|
||
top: 0;
|
||
bottom: 0;
|
||
background-color: var(--c-bg-secondary);
|
||
min-width: 20rem;
|
||
max-width: 30rem;
|
||
border-inline-start: 1px solid var(--c-border);
|
||
z-index: 10000;
|
||
}
|
||
|
||
header nav.show, header nav:focus-within {
|
||
transform: translateY(0);
|
||
}
|
||
|
||
header nav details summary.highlight, header nav a.highlight {
|
||
background-color: var(--c-hl);
|
||
color: var(--c-text-on-hl);
|
||
font-weight: 500;
|
||
}
|
||
|
||
header nav details summary:hover, header nav a:hover {
|
||
background-color: var(--c-bg);
|
||
}
|
||
|
||
header nav details summary.highlight:hover, header nav a.highlight:hover {
|
||
background-color: var(--c-hl-secondary);
|
||
color: var(--c-text-on-hl-secondary);
|
||
}
|
||
|
||
header nav details {
|
||
display: flex;
|
||
flex-direction: column;
|
||
position: relative;
|
||
}
|
||
|
||
header nav details a {
|
||
padding-inline-start: 2.5rem;
|
||
}
|
||
|
||
@media screen and (min-width: 950px) {
|
||
header .nav-toggle, header .nav-close, header nav.show .nav-close {
|
||
display: none;
|
||
}
|
||
header nav {
|
||
transform: initial;
|
||
display: flex;
|
||
flex-direction: row;
|
||
justify-content: flex-end;
|
||
position: initial;
|
||
background-color: initial;
|
||
min-width: unset;
|
||
max-width: unset;
|
||
border-inline-start: none;
|
||
}
|
||
header nav.show, header nav:focus-within {
|
||
transform: initial;
|
||
}
|
||
header nav details summary, header nav a {
|
||
border-block-end: none;
|
||
border-inline-start: 1px solid var(--c-border);
|
||
border-inline-end: 1px solid var(--c-border);
|
||
padding: 0 1rem;
|
||
display: flex;
|
||
margin-inline-start: -1px;
|
||
align-items: center;
|
||
height: 100%;
|
||
}
|
||
header nav details:last-of-type summary {
|
||
border-inline-end: none;
|
||
}
|
||
header nav details[open] summary {
|
||
border-block-end: 1px solid var(--c-border);
|
||
height: calc(100% + 1px);
|
||
}
|
||
header nav details div {
|
||
position: absolute;
|
||
right: 0;
|
||
}
|
||
header nav details div a {
|
||
background-color: var(--c-bg-secondary);
|
||
border-block-end: 1px solid var(--c-border);
|
||
padding: 1rem;
|
||
}
|
||
}
|
||
|
||
main {
|
||
grid-area: main;
|
||
padding: 0 var(--content-inline-padding);
|
||
max-width: var(--content-max-width);
|
||
min-width: 0;
|
||
width: 100%;
|
||
margin: 2rem auto;
|
||
}
|
||
|
||
nav.article-nav {
|
||
display: flex;
|
||
flex-direction: row;
|
||
justify-content: center;
|
||
}
|
||
|
||
nav.article-nav div {
|
||
width: 33%;
|
||
text-align: center;
|
||
}
|
||
|
||
footer {
|
||
grid-area: footer;
|
||
align-self: end;
|
||
background-color: var(--c-bg-secondary);
|
||
border-block-start: 1px solid var(--c-border);
|
||
padding: .5rem var(--content-inline-padding);
|
||
display: flex;
|
||
flex-direction: row;
|
||
flex-wrap: wrap;
|
||
justify-content: space-between;
|
||
}
|
||
|
||
footer div {
|
||
line-height: 2;
|
||
}
|
||
|
||
footer div .mobile-hide {
|
||
display: none;
|
||
}
|
||
|
||
footer div a {
|
||
white-space: nowrap;
|
||
}
|
||
|
||
footer div a:not([rel*=license]), footer div .copyright {
|
||
display: block;
|
||
}
|
||
|
||
@media screen and (min-width: 800px) {
|
||
footer div {
|
||
line-height: 1.5;
|
||
}
|
||
|
||
footer div:last-of-type {
|
||
padding-inline-start: 1rem;
|
||
}
|
||
|
||
footer div .mobile-hide {
|
||
display: inline;
|
||
}
|
||
|
||
footer div a:not([rel*=license]), footer div .copyright {
|
||
display: initial;
|
||
}
|
||
}
|
||
</style>
|
||
|
||
|
||
<style>aside {
|
||
grid-area: aside;
|
||
background-color: var(--c-bg-secondary);
|
||
/* padding: var(--content-inline-padding); */
|
||
border-block-start: 1px solid var(--c-border);
|
||
width: 100%;
|
||
height: min-content;
|
||
align-self: end;
|
||
display: flex;
|
||
flex-direction: column;
|
||
justify-content: flex-start;
|
||
min-width: 30ch;
|
||
overflow-y: auto;
|
||
}
|
||
|
||
aside .title {
|
||
margin-block-end: 0;
|
||
margin-inline: var(--content-inline-padding);
|
||
margin-block-start: 1rem;
|
||
margin-block-end: .5rem;
|
||
font-size: 2rem;
|
||
font-weight: 500;
|
||
}
|
||
|
||
aside details:not(:last-child) {
|
||
border-block-end: 1px solid var(--c-border);
|
||
}
|
||
|
||
aside details summary, aside a {
|
||
padding: 1rem;
|
||
display: flex;
|
||
align-items: center;
|
||
cursor: pointer;
|
||
white-space: nowrap;
|
||
}
|
||
|
||
aside a {
|
||
text-decoration: none;
|
||
}
|
||
|
||
aside details summary::before {
|
||
content: "►";
|
||
padding-inline-end: .3rem;
|
||
}
|
||
|
||
aside details[open] summary::before {
|
||
content: "▼";
|
||
}
|
||
|
||
aside details summary:hover, aside a:hover, aside a.active {
|
||
background-color: var(--c-bg);
|
||
}
|
||
|
||
aside details {
|
||
display: flex;
|
||
flex-direction: column;
|
||
position: relative;
|
||
}
|
||
|
||
aside details a {
|
||
padding-inline-start: 2.5rem;
|
||
}
|
||
|
||
@media screen and (min-width: 800px) {
|
||
aside {
|
||
border-block-start: none;
|
||
border-inline-end: 1px solid var(--c-border);
|
||
width: max-content;
|
||
height: 100%;
|
||
}
|
||
}
|
||
</style>
|
||
|
||
<link rel="stylesheet" href="../static/css/additional-styles.css">
|
||
<script src="../static/js/header-links.js" defer></script>
|
||
</head>
|
||
<body><a class="skiplink" href="epic5.html#main">Skip to content</a>
|
||
<header>
|
||
<a class="logo" href="../index.html" aria-label="Libera Chat, back to start page">
|
||
<img alt="" src="../static/img/libera-color.svg" height="48px" data-proofer-ignore>
|
||
<h1>Libera.​Chat</h1>
|
||
</a>
|
||
|
||
<a id="nav-toggle" class="nav-toggle hidden" aria-controls="main-nav"><span>Navigation</span></a>
|
||
|
||
<nav class="" id="main-nav" aria-labelledby="nav-toggle" role="menubar">
|
||
<a id="nav-close" class="nav-close hidden" aria-controls="main-nav"><span>Close</span></a>
|
||
|
||
|
||
<details>
|
||
<summary
|
||
|
||
>About</summary>
|
||
|
||
<div>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../policies.html"
|
||
|
||
><span>Network Policies</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../guidelines.html"
|
||
|
||
><span>Channel Guidelines</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../news.html"
|
||
|
||
><span>Blog & News</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../about.html"
|
||
|
||
><span>About Libera Chat</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../bylaws.html"
|
||
|
||
><span>Bylaws</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../minutes.html"
|
||
|
||
><span>Meeting Minutes</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../annual-reports.html"
|
||
|
||
><span>Annual Reports</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../sponsors.html"
|
||
|
||
><span>Sponsors</span></a>
|
||
|
||
</div>
|
||
</details>
|
||
|
||
|
||
|
||
<details>
|
||
<summary
|
||
|
||
>Contribute</summary>
|
||
|
||
<div>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../contributing/donate.html"
|
||
|
||
><span>Donate</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../contributing/sponsor.html"
|
||
|
||
><span>Sponsor Us</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../contributing/development.html"
|
||
|
||
><span>Development</span></a>
|
||
|
||
</div>
|
||
</details>
|
||
|
||
|
||
|
||
<a role="menuitem" href="../chanreg.html"><span>Channel Namespaces</span></a>
|
||
|
||
|
||
|
||
<a role="menuitem" href="../guides.html"><span>Guides</span></a>
|
||
|
||
|
||
|
||
<a role="menuitem" href="faq.html"><span>FAQ</span></a>
|
||
|
||
|
||
|
||
<details>
|
||
<summary
|
||
class="highlight"
|
||
>Connect</summary>
|
||
|
||
<div>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="https://web.libera.chat"
|
||
rel="noopener noreferrer"
|
||
><span>Webchat</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="ircs://irc.libera.chat:6697"
|
||
|
||
><span>irc.libera.chat:6697 (TLS)</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="connect.html"
|
||
|
||
><span>How to Connect</span></a>
|
||
|
||
</div>
|
||
</details>
|
||
|
||
|
||
</nav>
|
||
</header>
|
||
<script async>
|
||
const navToggle = document.querySelector('#nav-toggle')
|
||
const navClose = document.querySelector('#nav-close')
|
||
const mainNav = document.querySelector('#main-nav')
|
||
|
||
// progressive enhancement!
|
||
navToggle.classList.remove('hidden')
|
||
navClose.classList.remove('hidden')
|
||
|
||
navToggle.addEventListener('click', event => {
|
||
event.preventDefault()
|
||
mainNav.classList.toggle('show')
|
||
})
|
||
navClose.addEventListener('click', event => {
|
||
event.preventDefault()
|
||
mainNav.classList.remove('show')
|
||
})
|
||
</script>
|
||
<aside role="menu">
|
||
<span class="title">Guides</span>
|
||
|
||
|
||
<details open>
|
||
<summary>About IRC</summary>
|
||
|
||
<div>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="basics.html"
|
||
><span>Basics of IRC</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="faq.html"
|
||
><span>Frequently Asked Questions</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="clients.html"
|
||
><span>Choosing an IRC client</span></a>
|
||
|
||
</div>
|
||
</details>
|
||
|
||
|
||
<details open>
|
||
<summary>Helping you connect</summary>
|
||
|
||
<div>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="connect.html"
|
||
><span>Connecting to Libera.Chat</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="webchat.html"
|
||
><span>Using Our Webchat</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="sasl.html"
|
||
><span>Using SASL</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="https://libera.chat/guides/certfp"
|
||
><span>Using CertFP</span></a>
|
||
|
||
</div>
|
||
</details>
|
||
|
||
|
||
<details open>
|
||
<summary>Using the network</summary>
|
||
|
||
<div>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="registration.html"
|
||
><span>Nickname Registration</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="sendpass.html"
|
||
><span>Resetting your Password</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="cloaks.html"
|
||
><span>Cloaks</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="findingchannels.html"
|
||
><span>Finding Channels</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="channels.html"
|
||
><span>Using Channels</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="usermodes.html"
|
||
><span>User Modes</span></a>
|
||
|
||
</div>
|
||
</details>
|
||
|
||
|
||
<details open>
|
||
<summary>Running a channel</summary>
|
||
|
||
<div>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="creatingchannels.html"
|
||
><span>Creating Channels</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="channelmodes.html"
|
||
><span>Channel Modes</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="bots.html"
|
||
><span>Network bots</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="catalyst.html"
|
||
><span>Catalysing and De-escalation</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="helpers.html"
|
||
><span>Advice for Helpers</span></a>
|
||
|
||
</div>
|
||
</details>
|
||
|
||
</aside>
|
||
<main id="main">
|
||
|
||
<h1>Configuring SASL for Epic5</h1>
|
||
|
||
<p>EPIC5 has the sasl_auth and sasl_nistp256 scripts built-in. Mikhail
|
||
contributed this explanation of how to use it.</p>
|
||
|
||
<p>For SASL authentication with PLAIN method open your EPIC5 configuration
|
||
file, <code class="language-plaintext highlighter-rouge">~/.epicrc</code> or <code class="language-plaintext highlighter-rouge">~/.ircrc</code>, in your preferred editor. Add the
|
||
following lines:</p>
|
||
|
||
<ul>
|
||
<li><code class="language-plaintext highlighter-rouge">load global</code></li>
|
||
<li><code class="language-plaintext highlighter-rouge">load sasl_auth</code></li>
|
||
<li><code class="language-plaintext highlighter-rouge">sasl_auth *.libera.chat plain username password</code></li>
|
||
</ul>
|
||
|
||
<p>Replace username with your primary nick. The password may be replaced with
|
||
your password or omitted, in which case EPIC5 will prompt for the password
|
||
when it connects. You may change <code class="language-plaintext highlighter-rouge">*.libera.chat</code> to something more specific
|
||
if desired, but the <code class="language-plaintext highlighter-rouge">*</code> means SASL authentication will be attempted for any
|
||
<code class="language-plaintext highlighter-rouge">irc.libera.chat</code> server.</p>
|
||
|
||
<p>The script supports only <code class="language-plaintext highlighter-rouge">plain</code> authentication mechanism, you must use SSL
|
||
to protect your password.</p>
|
||
|
||
<p>Preferred method of connecting to Libera.Chat on EPIC5 is configuring your
|
||
ircII.servers file with proper connection line. This file is located in
|
||
<code class="language-plaintext highlighter-rouge">$IRCLIB</code> directory (you must set this environment variable in your shell
|
||
configuration file like .bashrc or .zshrc). The format is described in
|
||
<a href="http://help.epicsol.org/server_description">this documentation</a>, as an
|
||
example you can use following line:</p>
|
||
|
||
<p><code class="language-plaintext highlighter-rouge">irc.libera.chat:7000:password=MYPASSWORD:nick=MYNICK:type=IRC-SSL</code></p>
|
||
|
||
<p>If you prefer more secure NISTP256 authentication (it is mandatory if you
|
||
want to connect to the network via Tor) place following in your <code class="language-plaintext highlighter-rouge">~/.epicrc</code>
|
||
or <code class="language-plaintext highlighter-rouge">~/.ircrc</code> files:</p>
|
||
|
||
<ul>
|
||
<li><code class="language-plaintext highlighter-rouge">load global</code></li>
|
||
<li><code class="language-plaintext highlighter-rouge">load sasl_nistp256</code></li>
|
||
<li><code class="language-plaintext highlighter-rouge">set sasl_nistp256_ecdsatool ~/bin/ecdsatool</code></li>
|
||
<li><code class="language-plaintext highlighter-rouge">sasl_nistp256 *.libera.chat myaccount ~/.epic/libera.pem</code></li>
|
||
</ul>
|
||
|
||
<p><code class="language-plaintext highlighter-rouge">sasl_nistp256_ecdsatool</code> setting must point to ecdsatool binary, you must
|
||
compile your own, source code is available on
|
||
<a href="https://github.com/kaniini/ecdsatool">GitHub</a>.</p>
|
||
|
||
<p><code class="language-plaintext highlighter-rouge">sasl_nistp256</code> command has three arguments - server mask where to attempt
|
||
the authentication, account name and PEM file, generated with ecdsatool.
|
||
Take serious consideration regarding PEM file - you should place it only on
|
||
trusted machines and with 0600 permissions, because everyone who can get
|
||
the file can access your IRC account.</p>
|
||
|
||
<p>For more details look comments in <code class="language-plaintext highlighter-rouge">sasl_auth</code> or <code class="language-plaintext highlighter-rouge">sasl_nistp256</code> scripts.</p>
|
||
|
||
<p>If everything has been configured correctly, the next time you connect you
|
||
should see the message: <code class="language-plaintext highlighter-rouge">SASL authentication successful</code></p>
|
||
|
||
|
||
|
||
<hr>
|
||
<p>Based on content © 2016-2021 <a href="https://github.com/freenode/web-7.0/graphs/contributors">freenode/web7.0’s contributors</a>
|
||
under <a href="https://creativecommons.org/licenses/by-nc-sa/4.0/">Creative Commons BY-NC-SA</a></p>
|
||
|
||
|
||
|
||
</main><footer>
|
||
<div>
|
||
<span class="copyright">© Libera Chat's contributors 2021</span>
|
||
(<a rel="license noopener noreferrer" href="../LICENSE-content.txt">Content CC BY-NC-SA</a>,
|
||
<a rel="license noopener noreferrer" href="../LICENSE-code.txt">Code MIT</a>)
|
||
<span class="mobile-hide">/</span>
|
||
<a href="../atom.xml">Feed (atom)</a>
|
||
<span class="mobile-hide">/</span>
|
||
<a href="../privacy.html">Privacy</a>
|
||
</div>
|
||
<div>
|
||
<a rel="me noopener noreferrer" href="https://fosstodon.org/@liberachat">Mastodon</a>
|
||
<span class="mobile-hide">/</span>
|
||
<a href="https://github.com/Libera-Chat/libera-chat.github.io" rel="noopener noreferrer">GitHub</a>
|
||
<span class="mobile-hide">/</span>
|
||
<a href="https://twitter.com/liberachat" rel="noopener noreferrer">Twitter</a>
|
||
<span class="mobile-hide">/</span>
|
||
<a href="https://facebook.com/liberachat" rel="noopener noreferrer">Facebook</a>
|
||
</div>
|
||
</footer>
|