yannstatic/static/2023/12/24/Serveur_messagerie_IMAP_SMTP.html

2403 lines
216 KiB
HTML
Raw Normal View History

2024-10-31 20:18:37 +01:00
<!DOCTYPE html><html lang="fr">
<head><meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no"><title>Serveur de messagerie IMAP SMTP - YannStatic</title>
<meta name="description" content="Maddy Mail Server met en œuvre toutes les fonctionnalités requises pour faire fonctionner un serveur de courrier électronique. Il peut envoyer des messages v...">
<link rel="canonical" href="https://static.rnmkcy.eu/2023/12/24/Serveur_messagerie_IMAP_SMTP.html"><link rel="alternate" type="application/rss+xml" title="YannStatic" href="/feed.xml">
<!-- - include head/favicon.html - -->
<link rel="shortcut icon" type="image/png" href="/assets/favicon/favicon.png"><link rel="stylesheet" href="/assets/css/main.css"><link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.0.13/css/all.css" ><!-- start custom head snippets --><link rel="stylesheet" href="/assets/css/expand.css">
<!-- end custom head snippets --><script>(function() {
window.isArray = function(val) {
return Object.prototype.toString.call(val) === '[object Array]';
};
window.isString = function(val) {
return typeof val === 'string';
};
window.hasEvent = function(event) {
return 'on'.concat(event) in window.document;
};
window.isOverallScroller = function(node) {
return node === document.documentElement || node === document.body || node === window;
};
window.isFormElement = function(node) {
var tagName = node.tagName;
return tagName === 'INPUT' || tagName === 'SELECT' || tagName === 'TEXTAREA';
};
window.pageLoad = (function () {
var loaded = false, cbs = [];
window.addEventListener('load', function () {
var i;
loaded = true;
if (cbs.length > 0) {
for (i = 0; i < cbs.length; i++) {
cbs[i]();
}
}
});
return {
then: function(cb) {
cb && (loaded ? cb() : (cbs.push(cb)));
}
};
})();
})();
(function() {
window.throttle = function(func, wait) {
var args, result, thisArg, timeoutId, lastCalled = 0;
function trailingCall() {
lastCalled = new Date;
timeoutId = null;
result = func.apply(thisArg, args);
}
return function() {
var now = new Date,
remaining = wait - (now - lastCalled);
args = arguments;
thisArg = this;
if (remaining <= 0) {
clearTimeout(timeoutId);
timeoutId = null;
lastCalled = now;
result = func.apply(thisArg, args);
} else if (!timeoutId) {
timeoutId = setTimeout(trailingCall, remaining);
}
return result;
};
};
})();
(function() {
var Set = (function() {
var add = function(item) {
var i, data = this._data;
for (i = 0; i < data.length; i++) {
if (data[i] === item) {
return;
}
}
this.size ++;
data.push(item);
return data;
};
var Set = function(data) {
this.size = 0;
this._data = [];
var i;
if (data.length > 0) {
for (i = 0; i < data.length; i++) {
add.call(this, data[i]);
}
}
};
Set.prototype.add = add;
Set.prototype.get = function(index) { return this._data[index]; };
Set.prototype.has = function(item) {
var i, data = this._data;
for (i = 0; i < data.length; i++) {
if (this.get(i) === item) {
return true;
}
}
return false;
};
Set.prototype.is = function(map) {
if (map._data.length !== this._data.length) { return false; }
var i, j, flag, tData = this._data, mData = map._data;
for (i = 0; i < tData.length; i++) {
for (flag = false, j = 0; j < mData.length; j++) {
if (tData[i] === mData[j]) {
flag = true;
break;
}
}
if (!flag) { return false; }
}
return true;
};
Set.prototype.values = function() {
return this._data;
};
return Set;
})();
window.Lazyload = (function(doc) {
var queue = {js: [], css: []}, sources = {js: {}, css: {}}, context = this;
var createNode = function(name, attrs) {
var node = doc.createElement(name), attr;
for (attr in attrs) {
if (attrs.hasOwnProperty(attr)) {
node.setAttribute(attr, attrs[attr]);
}
}
return node;
};
var end = function(type, url) {
var s, q, qi, cbs, i, j, cur, val, flag;
if (type === 'js' || type ==='css') {
s = sources[type], q = queue[type];
s[url] = true;
for (i = 0; i < q.length; i++) {
cur = q[i];
if (cur.urls.has(url)) {
qi = cur, val = qi.urls.values();
qi && (cbs = qi.callbacks);
for (flag = true, j = 0; j < val.length; j++) {
cur = val[j];
if (!s[cur]) {
flag = false;
}
}
if (flag && cbs && cbs.length > 0) {
for (j = 0; j < cbs.length; j++) {
cbs[j].call(context);
}
qi.load = true;
}
}
}
}
};
var load = function(type, urls, callback) {
var s, q, qi, node, i, cur,
_urls = typeof urls === 'string' ? new Set([urls]) : new Set(urls), val, url;
if (type === 'js' || type ==='css') {
s = sources[type], q = queue[type];
for (i = 0; i < q.length; i++) {
cur = q[i];
if (_urls.is(cur.urls)) {
qi = cur;
break;
}
}
val = _urls.values();
if (qi) {
callback && (qi.load || qi.callbacks.push(callback));
callback && (qi.load && callback());
} else {
q.push({
urls: _urls,
callbacks: callback ? [callback] : [],
load: false
});
for (i = 0; i < val.length; i++) {
node = null, url = val[i];
if (s[url] === undefined) {
(type === 'js' ) && (node = createNode('script', { src: url }));
(type === 'css') && (node = createNode('link', { rel: 'stylesheet', href: url }));
if (node) {
node.onload = (function(type, url) {
return function() {
end(type, url);
};
})(type, url);
(doc.head || doc.body).appendChild(node);
s[url] = false;
}
}
}
}
}
};
return {
js: function(url, callback) {
load('js', url, callback);
},
css: function(url, callback) {
load('css', url, callback);
}
};
})(this.document);
})();
</script><script>
(function() {
var TEXT_VARIABLES = {
version: '2.2.6',
sources: {
font_awesome: 'https://use.fontawesome.com/releases/v5.0.13/css/all.css',
jquery: '/assets/js/jquery.min.js',
leancloud_js_sdk: '//cdn.jsdelivr.net/npm/leancloud-storage@3.13.2/dist/av-min.js',
chart: 'https://cdn.bootcss.com/Chart.js/2.7.2/Chart.bundle.min.js',
gitalk: {
js: 'https://cdn.bootcss.com/gitalk/1.2.2/gitalk.min.js',
css: 'https://cdn.bootcss.com/gitalk/1.2.2/gitalk.min.css'
},
valine: 'https://unpkg.com/valine/dist/Valine.min.js'
},
site: {
toc: {
selectors: 'h1,h2,h3'
}
},
paths: {
search_js: '/assets/search.js'
}
};
window.TEXT_VARIABLES = TEXT_VARIABLES;
})();
</script>
</head>
<body>
<div class="root" data-is-touch="false">
<div class="layout--page js-page-root"><!----><div class="page__main js-page-main page__viewport hide-footer has-aside has-aside cell cell--auto">
<div class="page__main-inner"><div class="page__header d-print-none"><header class="header"><div class="main">
<div class="header__title">
<div class="header__brand"><svg id="svg" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="400" height="478.9473684210526" viewBox="0, 0, 400,478.9473684210526"><g id="svgg"><path id="path0" d="M308.400 56.805 C 306.970 56.966,303.280 57.385,300.200 57.738 C 290.906 58.803,278.299 59.676,269.200 59.887 L 260.600 60.085 259.400 61.171 C 258.010 62.428,256.198 63.600,255.645 63.600 C 255.070 63.600,252.887 65.897,252.598 66.806 C 252.460 67.243,252.206 67.600,252.034 67.600 C 251.397 67.600,247.206 71.509,247.202 72.107 C 247.201 72.275,246.390 73.190,245.400 74.138 C 243.961 75.517,243.598 76.137,243.592 77.231 C 243.579 79.293,241.785 83.966,240.470 85.364 C 239.176 86.740,238.522 88.365,237.991 91.521 C 237.631 93.665,236.114 97.200,235.554 97.200 C 234.938 97.200,232.737 102.354,232.450 104.472 C 232.158 106.625,230.879 109.226,229.535 110.400 C 228.933 110.926,228.171 113.162,226.434 119.500 C 226.178 120.435,225.795 121.200,225.584 121.200 C 225.373 121.200,225.200 121.476,225.200 121.813 C 225.200 122.149,224.885 122.541,224.500 122.683 C 223.606 123.013,223.214 123.593,223.204 124.600 C 223.183 126.555,220.763 132.911,219.410 134.562 C 218.443 135.742,217.876 136.956,217.599 138.440 C 217.041 141.424,215.177 146.434,214.532 146.681 C 214.240 146.794,214.000 147.055,214.000 147.261 C 214.000 147.467,213.550 148.086,213.000 148.636 C 212.450 149.186,212.000 149.893,212.000 150.208 C 212.000 151.386,208.441 154.450,207.597 153.998 C 206.319 153.315,204.913 150.379,204.633 147.811 C 204.365 145.357,202.848 142.147,201.759 141.729 C 200.967 141.425,199.200 137.451,199.200 135.974 C 199.200 134.629,198.435 133.224,196.660 131.311 C 195.363 129.913,194.572 128.123,193.870 125.000 C 193.623 123.900,193.236 122.793,193.010 122.540 C 190.863 120.133,190.147 118.880,188.978 115.481 C 188.100 112.928,187.151 111.003,186.254 109.955 C 185.358 108.908,184.518 107.204,183.847 105.073 C 183.280 103.273,182.497 101.329,182.108 100.753 C 181.719 100.177,180.904 98.997,180.298 98.131 C 179.693 97.265,178.939 95.576,178.624 94.378 C 178.041 92.159,177.125 90.326,175.023 87.168 C 174.375 86.196,173.619 84.539,173.342 83.486 C 172.800 81.429,171.529 79.567,170.131 78.785 C 169.654 78.517,168.697 77.511,168.006 76.549 C 167.316 75.587,166.594 74.800,166.402 74.800 C 166.210 74.800,164.869 73.633,163.421 72.206 C 160.103 68.936,161.107 69.109,146.550 69.301 C 133.437 69.474,128.581 70.162,126.618 72.124 C 126.248 72.495,125.462 72.904,124.872 73.033 C 124.282 73.163,123.088 73.536,122.219 73.863 C 121.349 74.191,119.028 74.638,117.061 74.858 C 113.514 75.254,109.970 76.350,108.782 77.419 C 107.652 78.436,100.146 80.400,97.388 80.400 C 95.775 80.400,93.167 81.360,91.200 82.679 C 90.430 83.195,89.113 83.804,88.274 84.031 C 85.875 84.681,78.799 90.910,74.400 96.243 L 73.400 97.456 73.455 106.028 C 73.526 117.055,74.527 121.238,77.820 124.263 C 78.919 125.273,80.400 127.902,80.400 128.842 C 80.400 129.202,81.075 130.256,81.900 131.186 C 83.563 133.059,85.497 136.346,86.039 138.216 C 86.233 138.886,87.203 140.207,88.196 141.153 C 89.188 142.098,90.000 143.104,90.000 143.388 C 90.000 144.337,92.129 148.594,92.869 149.123 C 93.271 149.410,93.600 149.831,93.600 150.059 C 93.600 150.286,93.932 150.771,94.337 151.136 C 94.743 151.501,95.598 153.004,96.237 154.475 C 96.877 155.947,97.760 157.351,98.200 157.596 C 98.640 157.841,99.900 159.943,101.000 162.267 C 102.207 164.817,103.327 166.644,103.825 166.876 C 104.278 167.087,105.065 168.101,105.573 169.130 C 107.658 173.348,108.097 174.093,110.006 176.647 C 111.103 178.114,112.000 179.725,112.000 180.227 C 112.000 181.048,113.425 183.163,114.678 184.200 C 115.295 184.711,117.396 188.733,117.720 190.022 C 117.855 190.562,118.603 191.633,119.381 192.402 C 120.160 193.171,121.496 195.258,122.351 197.039 C 123.206 198.820,124.167 200.378,124.487 200.501 C 124.807 200.624,125.953 202.496,127.034 204.662 C 128.114 206.828,129.676 209.299,130.505 210.153 C 131.333 211.007,132.124 212.177,132.262 212.753 C 132.618 214.239,134.291 217.048,136.288 219.5
" href="/">YannStatic</a></div><!--<button class="button button--secondary button--circle search-button js-search-toggle"><i class="fas fa-search"></i></button>--><!-- <li><button class="button button--secondary button--circle search-button js-search-toggle"><i class="fas fa-search"></i></button></li> -->
<!-- Champ de recherche -->
<div id="searchbox" class="search search--dark" style="visibility: visible">
<div class="main">
<div class="search__header"></div>
<div class="search-bar">
<div class="search-box js-search-box">
<div class="search-box__icon-search"><i class="fas fa-search"></i></div>
<input id="search-input" type="text" />
<!-- <div class="search-box__icon-clear js-icon-clear">
<a><i class="fas fa-times"></i></a>
</div> -->
</div>
</div>
</div>
</div>
<!-- Script pointing to search-script.js -->
<script>/*!
* Simple-Jekyll-Search
* Copyright 2015-2020, Christian Fei
* Licensed under the MIT License.
*/
(function(){
'use strict'
var _$Templater_7 = {
compile: compile,
setOptions: setOptions
}
const options = {}
options.pattern = /\{(.*?)\}/g
options.template = ''
options.middleware = function () {}
function setOptions (_options) {
options.pattern = _options.pattern || options.pattern
options.template = _options.template || options.template
if (typeof _options.middleware === 'function') {
options.middleware = _options.middleware
}
}
function compile (data) {
return options.template.replace(options.pattern, function (match, prop) {
const value = options.middleware(prop, data[prop], options.template)
if (typeof value !== 'undefined') {
return value
}
return data[prop] || match
})
}
'use strict';
function fuzzysearch (needle, haystack) {
var tlen = haystack.length;
var qlen = needle.length;
if (qlen > tlen) {
return false;
}
if (qlen === tlen) {
return needle === haystack;
}
outer: for (var i = 0, j = 0; i < qlen; i++) {
var nch = needle.charCodeAt(i);
while (j < tlen) {
if (haystack.charCodeAt(j++) === nch) {
continue outer;
}
}
return false;
}
return true;
}
var _$fuzzysearch_1 = fuzzysearch;
'use strict'
/* removed: const _$fuzzysearch_1 = require('fuzzysearch') */;
var _$FuzzySearchStrategy_5 = new FuzzySearchStrategy()
function FuzzySearchStrategy () {
this.matches = function (string, crit) {
return _$fuzzysearch_1(crit.toLowerCase(), string.toLowerCase())
}
}
'use strict'
var _$LiteralSearchStrategy_6 = new LiteralSearchStrategy()
function LiteralSearchStrategy () {
this.matches = function (str, crit) {
if (!str) return false
str = str.trim().toLowerCase()
crit = crit.trim().toLowerCase()
return crit.split(' ').filter(function (word) {
return str.indexOf(word) >= 0
}).length === crit.split(' ').length
}
}
'use strict'
var _$Repository_4 = {
put: put,
clear: clear,
search: search,
setOptions: __setOptions_4
}
/* removed: const _$FuzzySearchStrategy_5 = require('./SearchStrategies/FuzzySearchStrategy') */;
/* removed: const _$LiteralSearchStrategy_6 = require('./SearchStrategies/LiteralSearchStrategy') */;
function NoSort () {
return 0
}
const data = []
let opt = {}
opt.fuzzy = false
opt.limit = 10
opt.searchStrategy = opt.fuzzy ? _$FuzzySearchStrategy_5 : _$LiteralSearchStrategy_6
opt.sort = NoSort
opt.exclude = []
function put (data) {
if (isObject(data)) {
return addObject(data)
}
if (isArray(data)) {
return addArray(data)
}
return undefined
}
function clear () {
data.length = 0
return data
}
function isObject (obj) {
return Boolean(obj) && Object.prototype.toString.call(obj) === '[object Object]'
}
function isArray (obj) {
return Boolean(obj) && Object.prototype.toString.call(obj) === '[object Array]'
}
function addObject (_data) {
data.push(_data)
return data
}
function addArray (_data) {
const added = []
clear()
for (let i = 0, len = _data.length; i < len; i++) {
if (isObject(_data[i])) {
added.push(addObject(_data[i]))
}
}
return added
}
function search (crit) {
if (!crit) {
return []
}
return findMatches(data, crit, opt.searchStrategy, opt).sort(opt.sort)
}
function __setOptions_4 (_opt) {
opt = _opt || {}
opt.fuzzy = _opt.fuzzy || false
opt.limit = _opt.limit || 10
opt.searchStrategy = _opt.fuzzy ? _$FuzzySearchStrategy_5 : _$LiteralSearchStrategy_6
opt.sort = _opt.sort || NoSort
opt.exclude = _opt.exclude || []
}
function findMatches (data, crit, strategy, opt) {
const matches = []
for (let i = 0; i < data.length && matches.length < opt.limit; i++) {
const match = findMatchesInObject(data[i], crit, strategy, opt)
if (match) {
matches.push(match)
}
}
return matches
}
function findMatchesInObject (obj, crit, strategy, opt) {
for (const key in obj) {
if (!isExcluded(obj[key], opt.exclude) && strategy.matches(obj[key], crit)) {
return obj
}
}
}
function isExcluded (term, excludedTerms) {
for (let i = 0, len = excludedTerms.length; i < len; i++) {
const excludedTerm = excludedTerms[i]
if (new RegExp(excludedTerm).test(term)) {
return true
}
}
return false
}
/* globals ActiveXObject:false */
'use strict'
var _$JSONLoader_2 = {
load: load
}
function load (location, callback) {
const xhr = getXHR()
xhr.open('GET', location, true)
xhr.onreadystatechange = createStateChangeListener(xhr, callback)
xhr.send()
}
function createStateChangeListener (xhr, callback) {
return function () {
if (xhr.readyState === 4 && xhr.status === 200) {
try {
callback(null, JSON.parse(xhr.responseText))
} catch (err) {
callback(err, null)
}
}
}
}
function getXHR () {
return window.XMLHttpRequest ? new window.XMLHttpRequest() : new ActiveXObject('Microsoft.XMLHTTP')
}
'use strict'
var _$OptionsValidator_3 = function OptionsValidator (params) {
if (!validateParams(params)) {
throw new Error('-- OptionsValidator: required options missing')
}
if (!(this instanceof OptionsValidator)) {
return new OptionsValidator(params)
}
const requiredOptions = params.required
this.getRequiredOptions = function () {
return requiredOptions
}
this.validate = function (parameters) {
const errors = []
requiredOptions.forEach(function (requiredOptionName) {
if (typeof parameters[requiredOptionName] === 'undefined') {
errors.push(requiredOptionName)
}
})
return errors
}
function validateParams (params) {
if (!params) {
return false
}
return typeof params.required !== 'undefined' && params.required instanceof Array
}
}
'use strict'
var _$utils_9 = {
merge: merge,
isJSON: isJSON
}
function merge (defaultParams, mergeParams) {
const mergedOptions = {}
for (const option in defaultParams) {
mergedOptions[option] = defaultParams[option]
if (typeof mergeParams[option] !== 'undefined') {
mergedOptions[option] = mergeParams[option]
}
}
return mergedOptions
}
function isJSON (json) {
try {
if (json instanceof Object && JSON.parse(JSON.stringify(json))) {
return true
}
return false
} catch (err) {
return false
}
}
var _$src_8 = {};
(function (window) {
'use strict'
let options = {
searchInput: null,
resultsContainer: null,
json: [],
success: Function.prototype,
searchResultTemplate: '<li><a href="{url}" title="{desc}">{title}</a></li>',
templateMiddleware: Function.prototype,
sortMiddleware: function () {
return 0
},
noResultsText: 'No results found',
limit: 10,
fuzzy: false,
debounceTime: null,
exclude: []
}
let debounceTimerHandle
const debounce = function (func, delayMillis) {
if (delayMillis) {
clearTimeout(debounceTimerHandle)
debounceTimerHandle = setTimeout(func, delayMillis)
} else {
func.call()
}
}
const requiredOptions = ['searchInput', 'resultsContainer', 'json']
/* removed: const _$Templater_7 = require('./Templater') */;
/* removed: const _$Repository_4 = require('./Repository') */;
/* removed: const _$JSONLoader_2 = require('./JSONLoader') */;
const optionsValidator = _$OptionsValidator_3({
required: requiredOptions
})
/* removed: const _$utils_9 = require('./utils') */;
window.SimpleJekyllSearch = function (_options) {
const errors = optionsValidator.validate(_options)
if (errors.length > 0) {
throwError('You must specify the following required options: ' + requiredOptions)
}
options = _$utils_9.merge(options, _options)
_$Templater_7.setOptions({
template: options.searchResultTemplate,
middleware: options.templateMiddleware
})
_$Repository_4.setOptions({
fuzzy: options.fuzzy,
limit: options.limit,
sort: options.sortMiddleware,
exclude: options.exclude
})
if (_$utils_9.isJSON(options.json)) {
initWithJSON(options.json)
} else {
initWithURL(options.json)
}
const rv = {
search: search
}
typeof options.success === 'function' && options.success.call(rv)
return rv
}
function initWithJSON (json) {
_$Repository_4.put(json)
registerInput()
}
function initWithURL (url) {
_$JSONLoader_2.load(url, function (err, json) {
if (err) {
throwError('failed to get JSON (' + url + ')')
}
initWithJSON(json)
})
}
function emptyResultsContainer () {
options.resultsContainer.innerHTML = ''
}
function appendToResultsContainer (text) {
options.resultsContainer.innerHTML += text
}
function registerInput () {
options.searchInput.addEventListener('input', function (e) {
if (isWhitelistedKey(e.which)) {
emptyResultsContainer()
debounce(function () { search(e.target.value) }, options.debounceTime)
}
})
}
function search (query) {
if (isValidQuery(query)) {
emptyResultsContainer()
render(_$Repository_4.search(query), query)
}
}
function render (results, query) {
const len = results.length
if (len === 0) {
return appendToResultsContainer(options.noResultsText)
}
for (let i = 0; i < len; i++) {
results[i].query = query
appendToResultsContainer(_$Templater_7.compile(results[i]))
}
}
function isValidQuery (query) {
return query && query.length > 0
}
function isWhitelistedKey (key) {
return [13, 16, 20, 37, 38, 39, 40, 91].indexOf(key) === -1
}
function throwError (message) {
throw new Error('SimpleJekyllSearch --- ' + message)
}
})(window)
}());
</script>
<!-- Configuration -->
<script>
SimpleJekyllSearch({
searchInput: document.getElementById('search-input'),
resultsContainer: document.getElementById('results-container'),
json: '/search.json',
//searchResultTemplate: '<li><a href="https://static.rnmkcy.eu{url}">{date}&nbsp;{title}</a></li>'
searchResultTemplate: '<li><a href="{url}">{date}&nbsp;{title}</a></li>'
})
</script>
<!-- Fin déclaration champ de recherche --></div><nav class="navigation">
<ul><li class="navigation__item"><a href="/archive.html">Etiquettes</a></li><li class="navigation__item"><a href="/htmldoc.html">Documents</a></li><li class="navigation__item"><a href="/liens_ttrss.html">Liens</a></li><li class="navigation__item"><a href="/aide-jekyll-text-theme.html">Aide</a></li></ul>
</nav></div>
</header>
</div><div class="page__content"><div class ="main"><div class="grid grid--reverse">
<div class="col-main cell cell--auto"><!-- start custom main top snippet --><div id="results-container" class="search-result js-search-result"></div><!-- end custom main top snippet -->
<article itemscope itemtype="http://schema.org/Article"><div class="article__header"><header><h1 style="color:Tomato;">Serveur de messagerie IMAP SMTP</h1></header></div><meta itemprop="headline" content="Serveur de messagerie IMAP SMTP"><div class="article__info clearfix"><ul class="left-col menu"><li>
<a class="button button--secondary button--pill button--sm"
href="/archive.html?tag=messagerie">messagerie</a>
</li></ul><ul class="right-col menu"><li>
<i class="far fa-calendar-alt"></i>&nbsp;<span title="Création" style="color:#FF00FF">24&nbsp;déc.&nbsp;&nbsp;2023</span>
<span title="Modification" style="color:#00FF7F">28&nbsp;févr.&nbsp;2024</span></li></ul></div><meta itemprop="datePublished" content="2024-02-28T00:00:00+01:00">
<meta itemprop="keywords" content="messagerie"><div class="js-article-content">
<div class="layout--article"><!-- start custom article top snippet -->
<style>
#myBtn {
display: none;
position: fixed;
bottom: 10px;
right: 10px;
z-index: 99;
font-size: 12px;
font-weight: bold;
border: none;
outline: none;
background-color: white;
color: black;
cursor: pointer;
padding: 5px;
border-radius: 4px;
}
#myBtn:hover {
background-color: #555;
}
</style>
<button onclick="topFunction()" id="myBtn" title="Haut de page">&#8679;</button>
<script>
//Get the button
var mybutton = document.getElementById("myBtn");
// When the user scrolls down 20px from the top of the document, show the button
window.onscroll = function() {scrollFunction()};
function scrollFunction() {
if (document.body.scrollTop > 20 || document.documentElement.scrollTop > 20) {
mybutton.style.display = "block";
} else {
mybutton.style.display = "none";
}
}
// When the user clicks on the button, scroll to the top of the document
function topFunction() {
document.body.scrollTop = 0;
document.documentElement.scrollTop = 0;
}
</script>
<!-- end custom article top snippet -->
<div class="article__content" itemprop="articleBody"><details>
<summary><b>Afficher/cacher Sommaire</b></summary>
<!-- affichage sommaire -->
<div class="toc-aside js-toc-root"></div>
</details><p><em>Maddy Mail Server met en œuvre toutes les fonctionnalités requises pour faire fonctionner un serveur de courrier électronique. Il peut envoyer des messages via SMTP (fonctionne comme MTA), accepter des messages via SMTP (fonctionne comme MX) et stocker des messages tout en y donnant accès via IMAP. En outre, il met en œuvre des protocoles auxiliaires qui sont obligatoires pour assurer une sécurité raisonnable du courrier électronique (DKIM, SPF, DMARC, DANE, MTA-STS).<br />
Il remplace Postfix, Dovecot, OpenDKIM, OpenSPF, OpenDMARC et dautres encore par un seul démon avec une configuration uniforme et un coût de maintenance minimal.</em></p>
<h2 id="maddy-mail-server">Maddy Mail Server</h2>
<ul>
<li><a href="https://forwardemail.net/fr/blog/open-source/alpine-linux-email-server#email-server-comparison">Comparaison des serveurs de messagerie</a></li>
<li><a href="https://maddy.email/tutorials/setting-up/">Maddy mail server</a></li>
<li><a href="https://forum.inovaperf.fr/d/288-comment-installer-un-serveur-de-mails-sur-votre-offre-vps">Comment installer un serveur de mails sur votre offre VPS ?</a></li>
</ul>
<p><img src="/images/mailserver-logo.png" alt="" height="100" /></p>
<h3 id="installation">Installation</h3>
<p><em>Mise en place un serveur de messagerie utilisant maddy pour un usage personnel.</em></p>
<p>Prérequis :</p>
<ul>
<li>VPS TIME4VPS Debian 12 (Vérifier que le fournisseur ne bloque pas le trafic SMTP port TCP 25)
<ul>
<li>Protection DNS contre le transfert</li>
<li>DNSSEC activé</li>
</ul>
</li>
<li>Domaine : xoyaz.xyz</li>
<li>Adresse IPv4 : 195.181.242.156</li>
<li>Adresse IPv6 : 2a02:7b40:c3b5:f29c::1</li>
<li>Reverse DNS IPV4 IPV6</li>
</ul>
<p>Utilisation image préconstruite (Linux, amd64)</p>
<p>Disponible sur <a href="https://github.com/foxcpp/maddy/releases">GitHub</a> ou <a href="https://maddy.email/builds/">maddy.email/builds</a>.</p>
<p>Archive au format zst, installer loutil si besoin (installé par défaut sur debian 12): <code class="language-plaintext highlighter-rouge">sudo apt install zstd</code></p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"># Téléchargement</span>
wget https://github.com/foxcpp/maddy/releases/download/v0.7.0/maddy-0.7.0-x86_64-linux-musl.tar.zst
<span class="c"># décompression</span>
<span class="nb">tar</span> <span class="nt">-I</span> zstd <span class="nt">-xvf</span> maddy-0.7.0-x86_64-linux-musl.tar.zst
</code></pre></div></div>
<p>Contenu archive</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>./maddy-0.7.0-x86_64-linux-musl/
./maddy-0.7.0-x86_64-linux-musl/maddy.conf
./maddy-0.7.0-x86_64-linux-musl/maddy
./maddy-0.7.0-x86_64-linux-musl/systemd/
./maddy-0.7.0-x86_64-linux-musl/systemd/maddy.service
./maddy-0.7.0-x86_64-linux-musl/systemd/maddy@.service
</code></pre></div></div>
<p>Copier lexécutable maddy que vous pouvez copier dans /usr/local/bin</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo cp maddy-0.7.0-x86_64-linux-musl/maddy /usr/local/bin/
</code></pre></div></div>
<h3 id="configuration-du-système">Configuration du système</h3>
<p><em>distribution basée sur systemd</em></p>
<p>On a utilisé une archive préconstruite, copiez manuellement <code class="language-plaintext highlighter-rouge">systemd/*.service</code> dans <code class="language-plaintext highlighter-rouge">/etc/systemd/system</code></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo cp maddy-0.7.0-x86_64-linux-musl/systemd/*.service /etc/systemd/system/
</code></pre></div></div>
<p>Vous devez recharger la configuration du gestionnaire de service pour rendre le service disponible</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo systemctl daemon-reload
</code></pre></div></div>
<p>En outre, vous devez créer lutilisateur et le groupe maddy (maddy ne sexécute jamais en tant que root)</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo useradd -mrU -s /sbin/nologin -d /var/lib/maddy -c "maddy mail server" maddy
</code></pre></div></div>
<p>Créer le répertoire et copier le fichier de configuration</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo mkdir -p /etc/maddy
sudo cp maddy-0.7.0-x86_64-linux-musl/maddy.conf /etc/maddy/
</code></pre></div></div>
<h3 id="nom-hôte--domaine">Nom hôte + domaine</h3>
<p>Ouvrir <code class="language-plaintext highlighter-rouge">/etc/maddy/maddy.conf</code></p>
<ul>
<li>Si vous installez un très petit serveur de messagerie, vous pouvez utiliser xoyaz.xyz dans les deux champs.</li>
<li>Cependant, pour faciliter une future migration de service, il est recommandé dutiliser une entrée DNS séparée à cet effet. Il sagit généralement de mx1.xoyaz.xyz, mx2, etc. Vous pouvez bien sûr utiliser un autre sous-domaine, par exemple : smtp1.xoyaz.xyz. Un serveur de basculement de courrier électronique sera possible si vous transférez mx2.xoyaz.xyz vers un autre serveur (à condition que vous le configuriez pour gérer votre domaine).</li>
</ul>
<p>Petit serveur de messagerie</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>$(hostname) = xoyaz.xyz
$(primary_domain) = xoyaz.xyz
</code></pre></div></div>
<p>Si vous souhaitez gérer plusieurs domaines, vous devez toujours en désigner un comme “primaire”.<br />
Ajoutez tous les autres domaines à la ligne <code class="language-plaintext highlighter-rouge">local_domains</code></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>$(local_domains) = $(primary_domain) example.com other.example.com
</code></pre></div></div>
<h3 id="certificats-tls">Certificats TLS</h3>
<p>Une chose qui ne peut pas être configurée automatiquement, ce sont les certificats TLS.</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>tls file /etc/maddy/certs/$(hostname)/fullchain.pem /etc/maddy/certs/$(hostname)/privkey.pem
</code></pre></div></div>
<p>Vous devez vous assurer que maddy peut les lire lorsquil tourne en tant quutilisateur non privilégié (maddy ne tourne jamais en tant que root, même au démarrage), une façon de le faire est dutiliser les ACLs (installer acl : <code class="language-plaintext highlighter-rouge">sudo apt install acl</code>)</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo setfacl -R -m g:maddy:rwx /etc/ssl/private/
sudo setfacl -R -m u:maddy:rx /etc/ssl/private/xoyaz.xyz-fullchain.pem /etc/ssl/private/xoyaz.xyz-key.pem
</code></pre></div></div>
<p>maddy recharge les certificats TLS à partir du disque une fois par minute, de manière à ce quil remarque le renouvellement. Il est possible de forcer le rechargement via <code class="language-plaintext highlighter-rouge">systemctl reload maddy</code></p>
<p><strong>Lets Encrypt et certbot</strong><br />
Si vous utilisez <strong>certbot</strong> pour gérer vos certificats, vous pouvez simplement faire un lien symbolique entre /etc/maddy/certs et /etc/letsencrypt/live. maddy choisira le bon certificat en fonction du domaine que vous avez spécifié lors de linstallation.<br />
Vous devez toujours rendre les clés lisibles pour maddy</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo setfacl -R -m u:maddy:rX /etc/letsencrypt/{live,archive}
</code></pre></div></div>
<p><strong>ACME.sh</strong><br />
Si vous utilisez <strong>acme.sh</strong> pour gérer vos certificats, vous pouvez simplement exécuter</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mkdir -p /etc/maddy/certs/xoyaz.xyz
acme.sh --force --install-cert -d xoyaz.xyz \
--key-file /etc/maddy/certs/xoyaz.xyz/privkey.pem \
--fullchain-file /etc/maddy/certs/xoyaz.xyz/fullchain.pem
</code></pre></div></div>
<p><code class="language-plaintext warning highlighter-rouge">Problème de lecture des certificats par le daemon maddy, malgré l'utilisation des ACL !!!</code></p>
<p><code class="language-plaintext warning highlighter-rouge">+ problème de renouvellement des certificats car aucun shell ne peut être exécuté !!!</code></p>
<p>La solution, copier les certificats dans un répertoire accessible par maddy après renouvellement qui seffectue 7 jours avant léchéance<br />
Création bash <code class="language-plaintext highlighter-rouge">$HOME/expiration_certificat.sh</code></p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c">#!/bin/bash</span>
<span class="c"># Domaine</span>
<span class="nv">_domain</span><span class="o">=</span><span class="s2">"xoyaz.xyz"</span>
<span class="c"># Test expiration certificats</span>
<span class="nv">PEM</span><span class="o">=</span><span class="s2">"/etc/ssl/private/</span><span class="nv">$_domain</span><span class="s2">-fullchain.pem"</span>
<span class="c"># 7 days in seconds </span>
<span class="nv">DAYS</span><span class="o">=</span><span class="s2">"604800"</span>
<span class="c"># Email settings </span>
<span class="nv">_sub</span><span class="o">=</span><span class="s2">"</span><span class="nv">$PEM</span><span class="s2"> will expire within </span><span class="nv">$DAYS</span><span class="s2"> (7 days)."</span>
<span class="nv">_from</span><span class="o">=</span><span class="s2">"ian@</span><span class="nv">$_domain</span><span class="s2">"</span>
<span class="nv">_to</span><span class="o">=</span><span class="s2">"vps@cinay.eu"</span>
<span class="nv">_openssl</span><span class="o">=</span><span class="s2">"/usr/bin/openssl"</span>
<span class="nv">$_openssl</span> x509 <span class="nt">-enddate</span> <span class="nt">-noout</span> <span class="nt">-in</span> <span class="s2">"</span><span class="nv">$PEM</span><span class="s2">"</span> <span class="nt">-checkend</span> <span class="s2">"</span><span class="nv">$DAYS</span><span class="s2">"</span> | <span class="nb">grep</span> <span class="nt">-q</span> <span class="s1">'Certificate will expire'</span>
<span class="k">if</span> <span class="o">[</span> <span class="nv">$?</span> <span class="nt">-eq</span> 0 <span class="nt">-o</span> <span class="o">!</span> <span class="nt">-z</span> <span class="s2">"</span><span class="nv">$1</span><span class="s2">"</span> <span class="o">]</span>
<span class="k">then</span>
<span class="c"># certificat expire dans 7 jours , on renouvelle</span>
<span class="nb">echo</span> <span class="s2">"Force renouvellement des certificats Lets Encrypt"</span>
<span class="s2">"</span><span class="nv">$HOME</span><span class="s2">/.acme.sh"</span>/acme.sh <span class="nt">--force</span> <span class="nt">--cron</span> <span class="nt">--home</span> <span class="s2">"</span><span class="nv">$HOME</span><span class="s2">/.acme.sh"</span> <span class="nt">--renew-hook</span> <span class="s2">"</span><span class="nv">$HOME</span><span class="s2">/.acme.sh/acme.sh --ecc --install-cert -d '</span><span class="nv">$_domain</span><span class="s2">' --key-file /etc/ssl/private/</span><span class="nv">$_domain</span><span class="s2">-key.pem --fullchain-file /etc/ssl/private/</span><span class="nv">$_domain</span><span class="s2">-fullchain.pem"</span>
<span class="c"># </span>
<span class="nb">echo</span> <span class="s2">"Recharge service nginx"</span>
<span class="nb">sudo </span>systemctl reload nginx
<span class="c">#</span>
<span class="nb">echo</span> <span class="s2">"Mise à niveau des certificats maddy"</span>
<span class="nb">sudo cp</span> /etc/ssl/private/<span class="nv">$_domain</span><span class="nt">-fullchain</span>.pem /etc/maddy/certs/<span class="nv">$_domain</span>/fullchain.pem
<span class="nb">sudo cp</span> /etc/ssl/private/<span class="nv">$_domain</span><span class="nt">-key</span>.pem /etc/maddy/certs/<span class="nv">$_domain</span>/privkey.pem
<span class="nb">sudo chown </span>maddy:maddy <span class="nt">-R</span> /etc/maddy/certs
<span class="nb">echo</span> <span class="s2">"Recharge service maddy"</span>
<span class="nb">sudo </span>systemctl reload maddy
<span class="c">#</span>
<span class="c"># Envoi message</span>
mail <span class="nt">-s</span> <span class="s2">"Domaine </span><span class="nv">$_domain</span><span class="s2">"</span> <span class="nt">-r</span> <span class="s2">"</span><span class="nv">$_from</span><span class="s2">"</span> <span class="s2">"</span><span class="nv">$_to</span><span class="s2">"</span> <span class="o">&lt;&lt;&lt;</span> <span class="s2">"Le certificat TLS/SSL (</span><span class="nv">$PEM</span><span class="s2">) a été renouvellé sur </span><span class="nv">$_domain</span><span class="s2"> [</span><span class="si">$(</span><span class="nb">date</span><span class="si">)</span><span class="s2">]"</span>
<span class="k">else
</span><span class="nb">echo</span> <span class="s2">"Certificat Valide"</span>
<span class="k">fi</span>
</code></pre></div></div>
<p>Le rendre exécutable : <code class="language-plaintext highlighter-rouge">chmod +x$HOME/expiration_certificat.sh</code></p>
<p>Créer le job</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>crontab -e
</code></pre></div></div>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>30 0 * * * "$HOME/expiration_certificat.sh" &gt; /dev/null
</code></pre></div></div>
<h3 id="première-exécution">Première exécution</h3>
<p>Arrêter et désactiver postfix</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo systemctl stop postfix &amp;&amp; sudo systemctl disable postfix
</code></pre></div></div>
<p>lancer et activer maddy</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo systemctl enable maddy --now
</code></pre></div></div>
<p>Le démon devrait fonctionner maintenant, sauf quil est inutile car nous navons pas configuré les enregistrements DNS.</p>
<h3 id="enregistrements-dns">Enregistrements DNS</h3>
<p>La façon dont il est configuré dépend de votre fournisseur DNS (ou de votre serveur, si vous utilisez le vôtre). Voici à quoi devrait ressembler votre zone DNS</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>; Basic domain-&gt;IP records, you probably already have them.
xoyaz.xyz. A 195.181.242.156
xoyaz.xyz. AAAA 2a02:7b40:c3b5:f29c::1
; It says that "server xoyaz.xyz is handling messages for xoyaz.xyz".
xoyaz.xyz. MX 10 xoyaz.xyz.
; Use SPF to say that the servers in "MX" above are allowed to send email
; for this domain, and nobody else.
xoyaz.xyz. TXT "v=spf1 mx ~all"
</code></pre></div></div>
<h4 id="dkim">DKIM</h4>
<p><em>Lenregistrement DKIM est un enregistrement TXT modifié qui ajoute des signatures cryptographiques à vos messages électroniques. Vous ajoutez un enregistrement DKIM à votre système de nom de domaine (DNS), et il contient la cryptographie à clé publique utilisée par le serveur de messagerie récepteur pour authentifier un message.</em></p>
<p>Et la dernière, la clé DKIM, est un peu délicate. maddy a généré une clé pour vous lors du premier démarrage.<br />
Vous pouvez la trouver dans <code class="language-plaintext highlighter-rouge">/var/lib/maddy/dkim_keys/xoyaz.xyz_default.dns</code><br />
Vous devez la mettre dans un enregistrement TXT pour le domaine default._domainkey.xoyaz.xyz</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>default._domainkey IN TXT "v=DKIM1;k=rsa;p=MIIBIjANBgkqZuislR85jSpyVpe1jjvnNI8nf8GRPM0RR9uEPQIDAQAB;"
</code></pre></div></div>
<h4 id="dmarc">DMARC</h4>
<p>Une politique DMARC détermine ce quil advient dun message électronique après sa vérification par rapport aux enregistrements SPF et DKIM. Un e-mail passe ou échoue à SPF et DKIM. La politique DMARC détermine si léchec entraîne le marquage de le-mail comme spam, son blocage ou sa remise au destinataire prévu. (Les serveurs de messagerie peuvent toujours marquer les e-mails comme spam sil ny a pas denregistrement DMARC, mais DMARC fournit des instructions plus claires sur le moment de le faire).</p>
<p>La politique de domaine de xoyaz.xyz pourrait être :</p>
<p><em>Si un e-mail échoue aux tests DKIM et SPF, marquez-le comme spam.</em></p>
<p>Ces politiques ne sont pas enregistrées sous forme de phrases lisibles par lhomme, mais plutôt sous forme de commandes lisibles par la machine afin que les services de messagerie puissent les interpréter automatiquement. Cette politique DMARC ressemblerait en fait à ceci :</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>v=DMARC1; p=quarantine; adkim=s; aspf=s;
</code></pre></div></div>
<p>Quest-ce que cela signifie ?</p>
<ul>
<li><strong>v=DMARC1</strong> indique que cet enregistrement TXT contient une politique DMARC et doit être interprété comme tel par les serveurs de messagerie.</li>
<li><strong>p=quarantine</strong> indique que les serveurs de messagerie doivent « mettre en quarantaine » les e-mails qui ne répondent pas aux critères DKIM et SPF, les considérant comme des spams potentiels. Parmi les autres paramètres possibles, citons <strong>p=none</strong>, qui permet aux e-mails qui échouent de passer quand même, et <strong>p=reject</strong>, qui demande aux serveurs de messagerie de bloquer les e-mails qui échouent.</li>
<li><strong>adkim=s</strong> signifie que les vérifications DKIM sont « strictes ». Il est également possible de définir « relaxé » en remplaçant s par r, comme <strong>adkim=r</strong></li>
<li><strong>aspf=s</strong> est identique à adkim=s, mais pour SPF.</li>
</ul>
<p class="info">Notez que aspf et adkim sont des paramètres facultatifs. Lattribut p= indique ce que les serveurs de messagerie doivent faire avec les e-mails qui échouent à SPF et DKIM.</p>
<p>Si ladministrateur xoyaz.xyz voulait rendre cette politique encore plus stricte et signaler plus fortement aux serveurs de messagerie de considérer les messages non autorisés comme du spam, il ajusterait lattribut <code class="language-plaintext highlighter-rouge">p=</code> comme suit :</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>v=DMARC1; p=reject; adkim=s; aspf=s;
</code></pre></div></div>
<p>En substance, cela signifie : <em>Si un e-mail échoue aux tests DKIM et SPF, ne le remettez pas.</em></p>
<p><strong>Quest-ce quun rapport DMARC ?</strong><br />
Les politiques DMARC peuvent contenir des instructions pour lenvoi de rapports sur les e-mails qui passent ou échouent au test DKIM ou SPF. En général, les administrateurs configurent les rapports pour quils soient envoyés à un service tiers qui les réduit à une forme plus digeste, afin que les administrateurs ne soient pas submergés dinformations. Les rapports DMARC sont extrêmement importants, car ils fournissent aux administrateurs les informations dont ils ont besoin pour décider de lajustement de leurs politiques DMARC, par exemple si leurs e-mails légitimes échouent aux tests SPF et DKIM, ou si un spammeur tente denvoyer des e-mails illégitimes.</p>
<p>Ladministrateur de xoyaz.xyz ajouterait la partie <strong>rua</strong> de cette politique pour envoyer ses rapports DMARC à un service tiers (dont ladresse électronique est « exemple@third-party-example.com ») :</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>v=DMARC1; p=reject; adkim=s; aspf=s; rua=mailto:exemple@third-party-example.com;
</code></pre></div></div>
<p><strong>Quest-ce quun enregistrement DMARC ?</strong><br />
Un enregistrement DMARC stocke la politique DMARC dun domaine. Les enregistrements DMARC sont stockés dans le système de noms de domaine (DNS) sous forme denregistrements DNS TXT . Un enregistrement DNS TXT peut contenir presque tout le texte quun administrateur de domaine souhaite associer à son domaine. Lune des façons dutiliser les enregistrements DNS TXT est de stocker les politiques DMARC.</p>
<p>(Notez quun enregistrement DMARC est un enregistrement DNS TXT qui contient une politique DMARC, et non un type spécialisé d enregistrement DNS.)</p>
<p>La politique DMARC de xoyaz.xyz pourrait ressembler à ceci :</p>
<table>
<thead>
<tr>
<th>Nom</th>
<th>Type</th>
<th>Contenu</th>
<th>TTL</th>
</tr>
</thead>
<tbody>
<tr>
<td>_dmarc.xoyaz.xyz</td>
<td>TXT</td>
<td>v=DMARC1; p=quarantine; adkim=r; aspf=r; rua=mailto:example@third-party-xoyaz.xyz;</td>
<td>32600</td>
</tr>
</tbody>
</table>
<p>Dans cet enregistrement TXT, la politique DMARC est contenue dans le champ « Contenu ».</p>
<p><strong>Politique choisie pour DMARC</strong></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>; Opt-in into DMARC with permissive policy and request reports about broken
; messages.
_dmarc.xoyaz.xyz. TXT "v=DMARC1; p=quarantine; rua=mailto:postmaster@xoyaz.xyz"
</code></pre></div></div>
<h4 id="mta-sts">MTA-STS</h4>
<p>Par défaut, le protocole SMTP nest pas protégé contre les attaques actives. La politique MTA-STS indique aux expéditeurs compatibles de toujours utiliser TLS correctement authentifié lorsquils sadressent à votre serveur, offrant ainsi un moyen simple à déployer pour protéger votre serveur contre les attaques MitM sur le port 25.</p>
<p>Fondamentalement, vous devez créer un fichier avec le contenu suivant et le rendre disponible sur https://mta-sts.xoyaz.xyz/.well-known/mta-sts.txt</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mkdir -p /var/lib/caddy/.well-known
nano /var/lib/caddy/.well-known/mta-sts.txt
</code></pre></div></div>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>version : STSv1
mode : enforce
max_age : 604800
mx : xoyaz.xyz
</code></pre></div></div>
<p>Note :xoyaz.xyz dans le fichier est votre nom dhôte MX, dans une configuration simple, il sera le même que votre nom dhôte example.org. Dans une configuration plus complexe, vous aurez plusieurs serveurs MX - ajoutez-les tous une fois par ligne, comme ceci :</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mx : mx1.example.org
mx : mx2.example.org
</code></pre></div></div>
<p>Modifier le fichier du serveur caddy en ajoutant ce qui suit au fichier <code class="language-plaintext highlighter-rouge">/etc/caddy/Caddyfile</code></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mta-sts.xoyaz.xyz {
root * /var/lib/caddy
}
</code></pre></div></div>
<p><strong>Enregistrement dns MTA-STS</strong></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>; Mark domain as MTA-STS compatible (see the next section)
; and request reports about failures to be sent to postmaster@xoyaz.xyz
_mta-sts.xoyaz.xyz. TXT "v=STSv1; id=1"
_smtp._tls.xoyaz.xyz. TXT "v=TLSRPTv1;rua=mailto:postmaster@xoyaz.xyz"
</code></pre></div></div>
<h4 id="tlsa-dane">TLSA (DANE)</h4>
<p>Il est également recommandé de définir un enregistrement TLSA (DANE). Utilisez <a href="https://www.huque.com/bin/gen_tlsa">https://www.huque.com/bin/gen_tlsa</a> pour en générer un.<br />
Copier/coller le contenu du certificat /etc/maddy/certs/xoyaz.xyz/fullchain.pem, port sur 25, le protocole de transport sur “tcp” et le nom de domaine sur le nom dhôte MX.</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>_25._tcp.xoyaz.xyz. IN TLSA 3 1 1 ca0f47da273563916af7b2b8e0dced79726ab6fe5a8a873b66d22f64e598401e
</code></pre></div></div>
<p>Outils de test :</p>
<ul>
<li><a href="https://mxtoolbox.com/mta-sts.aspx">MTA-STS Lookup - Check domains for Inbound Transport Layer Security (TLS) Enforcement - MxToolbox</a></li>
<li><a href="https://www.skysnag.com/fr/mta-sts-checker/">Validateur MTA-STS gratuit</a></li>
</ul>
<h4 id="dns-complet">DNS complet</h4>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>$TTL 3600
@ IN SOA dns106.ovh.net. tech.ovh.net. (2023122600 86400 3600 3600000 300)
IN NS ns106.ovh.net.
IN NS dns106.ovh.net.
IN MX 10 xoyaz.xyz.
IN A 195.181.242.156
IN AAAA 2a02:7b40:c3b5:f29c::1
600 IN TXT "v=spf1 mx ~all"
IN CAA 128 issue "letsencrypt.org"
* IN A 195.181.242.156
* IN AAAA 2a02:7b40:c3b5:f29c::1
_25._tcp IN TLSA 3 1 1 ca0f47da273563916af7b2b8e0dced79726ab6fe5a8a873b66d22f64e598401e
_dmarc IN TXT "v=DMARC1; p=quarantine; rua=mailto:postmaster@xoyaz.xyz"
_mta-sts IN TXT "v=STSv1; id=1"
_smtp._tls IN TXT "v=TLSRPTv1;rua=mailto:postmaster@xoyaz.xyz"
default._domainkey IN TXT ( "v=DKIM1;k=rsa;p=MIIBIjAuEPQIDAQAB;" )
</code></pre></div></div>
<h3 id="comptes-utilisateurs">Comptes utilisateurs</h3>
<p>Un serveur de messagerie est inutile sans boîtes aux lettres, nest-ce pas ? Contrairement à des logiciels comme postfix et dovecot, maddy utilise par défaut des “utilisateurs virtuels”, ce qui signifie quil ne se préoccupe pas des utilisateurs du système et nen a pas connaissance.</p>
<p>Les boîtes aux lettres IMAP (“comptes”) et les identifiants dauthentification sont séparés.</p>
<p>Pour enregistrer les informations didentification dun utilisateur, utilisez la commande maddy creds create.<br />
Voici ce quil faut faire</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>maddy creds create postmaster@xoyaz.xyz
</code></pre></div></div>
<p>Notez que le nom dutilisateur est une adresse électronique. Ceci est nécessaire car le nom dutilisateur est utilisé pour autoriser laccès IMAP et SMTP (à moins que vous ne configuriez des mappings personnalisés, non décrits ici).</p>
<p>Après avoir enregistré les informations didentification de lutilisateur, vous devez également créer un compte de stockage local</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>maddy imap-acct create postmaster@xoyaz.xyz
</code></pre></div></div>
<p>Voilà, cest fait. Vous avez maintenant votre première adresse électronique.<br />
Lorsque vous vous authentifiez avec votre client de messagerie, noubliez pas que le nom dutilisateur est “postmaster@xoyaz.xyz”, et pas seulement “postmaster”.</p>
<p>Lexécution de <code class="language-plaintext highlighter-rouge">maddy creds --help</code> et <code class="language-plaintext highlighter-rouge">maddy imap-acct --help</code> peut savérer utile pour connaître les autres commandes.</p>
<p>Créer lutilisateur postmaster sans shell ni home</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo useradd postmaster
</code></pre></div></div>
<p>Notez que les comptes IMAP et les identifiants sont gérés séparément, mais que les noms dutilisateur doivent correspondre par défaut pour que les choses fonctionnent.</p>
<h3 id="parefeu">Parefeu</h3>
<p>Si un parefeu est utilisé, il faut ouvrir les ports 25,587 et 993</p>
<h3 id="webmail">Webmail</h3>
<p><a href="https://itsfoss.com/open-source-web-based-email-clients/">7 Best Open Source Web-based Email Clients</a></p>
<p>En mode su</p>
<p><a href="/2023/12/22/Caddy_serveur.html#activer-php-dans-caddy">Activer PHP dans Caddy</a></p>
<p>Installer <a href="https://www.rainloop.net/docs/installation/">rainloop</a></p>
<p>Téléchargez le paquet, extrayez-en les fichiers et téléchargez-le dans un répertoire destiné à être utilisé par lapplication, <code class="language-plaintext highlighter-rouge">/var/lib/caddy/rainloop</code></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code># lien pour la dernière version --&gt; https://www.rainloop.net/try-now/
wget https://www.rainloop.net/repository/webmail/rainloop-latest.zip
mkdir -p /var/lib/caddy/rainloop
unzip rainloop-latest.zip -d /var/lib/caddy/rainloop
rm -rf rainloop-latest.zip
</code></pre></div></div>
<p><strong>Alternative</strong><br />
Vous pouvez également déployer la dernière version de lapplication sans avoir à gérer darchive zip, en lançant simplement lune des commandes suivantes dans votre terminal</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl -sL https://repository.rainloop.net/installer.php | php
# OU
wget -qO- https://repository.rainloop.net/installer.php | php
</code></pre></div></div>
<p>Après avoir téléchargé le contenu du paquet, veillez à configurer les autorisations pour les fichiers et les répertoires.<br />
Modifiez les permissions pour que le serveur web ait accès au répertoire</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>cd /var/lib/caddy/rainloop
find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;
chown -R caddy:caddy .
</code></pre></div></div>
<p>Cest tout ce que vous avez à faire pour garantir lexécution de lapplication avec sa configuration par défaut.</p>
<p>Le produit créera tous les fichiers nécessaires lors de la première exécution et signalera une erreur si lune des conditions nest pas remplie.</p>
<p>Modifier le fichier de configuration caddy /etc/caddy/Caddyfile</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>webmail.xoyaz.xyz {
root * /var/lib/caddy/rainloop
encode gzip zstd
php_fastcgi unix//run/php/php8.2-fpm.sock
file_server
}
</code></pre></div></div>
<p>Redémarrer le service Caddy</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>systemctl reload caddy
</code></pre></div></div>
<p>Configurer rainloop https://webmail.xoyaz.xyz/?admin<br />
Par défaut les identifiants sont : admin et 12345</p>
<p>Une fois connecté à linterface dadministration, changer le mot de passe admin en cliquant sur le lien <strong>change</strong><br />
Pour changer le language ,dans le menu de gauche cliquez sur <strong>General</strong><br />
Vous devez ajouter un nouveau domaine. Dans le menu de gauche cliquez sur <strong>Domaines</strong> puis sur <strong>+</strong><br />
Ajouter un domaine. Une nouvelle fenêtre souvre et vous demande de configurer IMAP et SMTP pour ce domaine.<br />
<img src="/images/caddy-mail01.png" alt="" width="400" /><br />
Cliquer sur <strong>i test</strong> qui doit passer au vert</p>
<p>Ajouter tous les utilisateurs du domaine autorisés à se connecter dans <strong>Liste Blanche</strong> (bouton en bas), les utilisateurs sont séparés par des espaces<br />
<img src="/images/caddy-mail02.png" alt="" width="400" /></p>
<p><img src="/images/caddy-mail03.png" alt="" width="400" /><br />
Supprimer gmail.com dans Domaines</p>
<p>Connectez-vous à votre boîte mail via le formulaire principal https://webmail.xoyaz.xyz , utilisateur <strong>ian</strong></p>
<p><strong>Test en réception</strong><br />
<img src="/images/caddy-mail04.png" alt="" width="400" /></p>
<p><strong>Test en émission</strong><br />
<img src="/images/caddy-mail05.png" alt="" width="400" /></p>
<h3 id="msmtp">msmtp</h3>
<p><em>Configuration de tout ce qui est nécessaire pour envoyer des courriels depuis le terminal. Nous utiliserons <strong>msmtp</strong>, un client SMTP léger.<br />
Nous allons également voir comment stocker les identifiants pour le compte de messagerie dans le clavier système.<br />
comment configurer divers utilitaires en ligne de commande afin quils utilisent automatiquement msmtp pour envoyer des emails<br />
nous ferons de msmtp lexpéditeur de courriel par défaut, pour éviter de configurer ces utilitaires un par un.
(<a href="https://arnaudr.io/2020/08/24/send-emails-from-your-terminal-with-msmtp/">Send emails from your terminal with msmtp</a>)</em></p>
<p>Installation</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo apt install msmtp
</code></pre></div></div>
<p>Essayons denvoyer un mail. À ce stade, nous navons pas encore créé de fichier de configuration pour msmtp, nous devons donc fournir tous les détails sur la ligne de commande.</p>
<p>Ecrire un message dans un fichier texte</p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">cat</span> <span class="o">&lt;&lt;</span> <span class="no">EOF</span><span class="sh"> &gt; message.txt
From: postmaster@rnmkcy.eu
To: yack@cinay.eu
Subject: Test msmtp
Ceci est un envoi de message en ligne de commande
</span><span class="no">EOF
</span></code></pre></div></div>
<p>Envoyer le message</p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">cat </span>message.txt | msmtp <span class="se">\</span>
<span class="nt">--auth</span><span class="o">=</span>on <span class="nt">--tls</span><span class="o">=</span>on <span class="se">\</span>
<span class="nt">--host</span> rnmkcy.eu <span class="se">\</span>
<span class="nt">--port</span> 587 <span class="se">\</span>
<span class="nt">--user</span> postmaster@rnmkcy.eu <span class="se">\</span>
<span class="nt">--read-envelope-from</span> <span class="se">\</span>
<span class="nt">--read-recipients</span>
</code></pre></div></div>
<p>mot de passe pour postmaster@rnmkcy.eu à rnmkcy.eu :</p>
<p><img src="/images/msmtp01.png" alt="" width="400" /></p>
<p>Dans le fichier message.txt, nous avons fourni de: (ladresse électronique de la personne qui envoie le courriel) et à: (ladresse électronique de destination). Nous avons ensuite demandé à msmtp de réutiliser ces valeurs pour définir lenveloppe de lemail avec <code class="language-plaintext highlighter-rouge">--read-envelope-from</code> et <code class="language-plaintext highlighter-rouge">--read-cepients</code>.</p>
<p>Et les autres paramètres ?</p>
<ul>
<li><code class="language-plaintext highlighter-rouge">--auth=on</code> parce que nous voulons authentifier avec le serveur.</li>
<li><code class="language-plaintext highlighter-rouge">--tls=on</code> parce que nous voulons nous assurer que la communication avec le serveur est cryptée.</li>
<li><code class="language-plaintext highlighter-rouge">--host</code> et <code class="language-plaintext highlighter-rouge">--port</code> indique où trouver le serveur.</li>
<li><code class="language-plaintext highlighter-rouge">--user</code> est évidemment votre nom dutilisateur.</li>
</ul>
<p>Écrire un fichier de configuration</p>
<p>msmtp prend en charge deux emplacements : ~/.msmtprc et ~/.config/msmtp/config, nous utiliserons ~/.msmtprc</p>
<p>Créer la configuration</p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">cat</span> <span class="o">&lt;&lt;</span> <span class="sh">'</span><span class="no">EOF</span><span class="sh">' &gt; ~/.msmtprc
defaults
tls on
account rnmkcy
auth on
host rnmkcy.eu
port 587
user postmaster@rnmkcy.eu
from postmaster@rnmkcy.eu
account default : rnmkcy
</span><span class="no">EOF
</span></code></pre></div></div>
<p>Envoyer un message</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>msmtp -t &lt; message.txt
mot de passe pour postmaster@rnmkcy.eu à rnmkcy.eu :
</code></pre></div></div>
<p>Ajouter le mot de passe dans un fichier <code class="language-plaintext highlighter-rouge">~/.msmtprc</code></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>password xxxxxxxxxxxxxxxxxxxx
</code></pre></div></div>
<p>Modifier les droits du fichier</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>chmod 600 ~/.msmtprc
</code></pre></div></div>
<p>Nous pouvons utiliser un éditeur de texte comme nano pour introduire un nouvel alias dans le fichier /etc/aliases:</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo nano /etc/aliases
</code></pre></div></div>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code># Send root to Jane
root: vps@cinay.eu
# Send everything else to admin
default: yako@xoyize.xyz
</code></pre></div></div>
<p>Lors de lenregistrement, tout email adressé à lalias postmaster devrait maintenant aller à la racine de lutilisateur local.<br />
Cependant, cela ne se produit pas à moins que nous mettions à jour la base de données alias system=s:</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo newaliases
</code></pre></div></div>
<p>La commande newaliases lit le fichier /etc/aliases et génère une nouvelle base de données alias. Cette base de données est lendroit où le MTA recherche des alias lors du traitement des courriels entrants.</p>
<p>Test</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>echo -e "Subject: Regards\n\nSending regards from Terminal." | msmtp -a rnmkcy yanfi@yanfi.net
</code></pre></div></div>
<p>Envoi html</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>nano sample.html
</code></pre></div></div>
<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code>From: postmaster@rnmkcy.eu
To: yack@cinay.eu
Subject: This is the Subject
Mime-Version: 1.0
Content-Type: text/html
<span class="nt">&lt;html&gt;</span>
<span class="nt">&lt;head&gt;</span>This is Email Head<span class="nt">&lt;/head&gt;</span>
<span class="nt">&lt;body&gt;</span>
<span class="nt">&lt;h2&gt;</span>This is the Main Title<span class="nt">&lt;/h2&gt;</span>
<span class="nt">&lt;p&gt;</span>This is the body text<span class="nt">&lt;/p&gt;</span>
<span class="nt">&lt;/body&gt;</span>
<span class="nt">&lt;/html&gt;</span>
</code></pre></div></div>
<p>Envoi</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>cat sample.html | msmtp yack@cinay.eu
</code></pre></div></div>
<p><img src="/images/msmtp02.png" alt="" width="400" /></p>
<p>Ici, la commande <code class="language-plaintext highlighter-rouge">cat</code> affiche le contenu du fichier sample.html, puis nous sommes en train de passer le résultat à la commande <code class="language-plaintext highlighter-rouge">msmtp</code>.</p>
<p>Nous utilisons <code class="language-plaintext highlighter-rouge">Content-Type</code> comme en-tête <code class="language-plaintext highlighter-rouge">MIME</code> afin que le fichier soit traité comme un fichier HTML. Nous devons noter que nous devons spécifier les informations den-tête demail dans le fichier HTML pour le traiter avec msmtp.</p>
<h3 id="conclusion">Conclusion</h3>
<p><code class="language-plaintext success highlighter-rouge">Le serveur de messagerie IMAP/SMTP xoyaz.xyz est entièrement opérationnel</code></p>
</div>
<div class="d-print-none"><footer class="article__footer"><meta itemprop="dateModified" content="2023-12-24T00:00:00+01:00"><!-- start custom article footer snippet -->
<!-- end custom article footer snippet -->
<!--
<div align="right"><a type="application/rss+xml" href="/feed.xml" title="S'abonner"><i class="fa fa-rss fa-2x"></i></a>
&emsp;</div>
-->
</footer>
<div class="article__section-navigator clearfix"><div class="previous"><span>PRÉCÉDENT</span><a href="/2023/12/22/Caddy_serveur.html">Caddy serveur</a></div><div class="next"><span>SUIVANT</span><a href="/2024/01/09/Aide_Memoire_BorgBackup.html">Aide mémoire Borg Backup</a></div></div></div>
</div>
<script>(function() {
var SOURCES = window.TEXT_VARIABLES.sources;
window.Lazyload.js(SOURCES.jquery, function() {
$(function() {
var $this ,$scroll;
var $articleContent = $('.js-article-content');
var hasSidebar = $('.js-page-root').hasClass('layout--page--sidebar');
var scroll = hasSidebar ? '.js-page-main' : 'html, body';
$scroll = $(scroll);
$articleContent.find('.highlight').each(function() {
$this = $(this);
$this.attr('data-lang', $this.find('code').attr('data-lang'));
});
$articleContent.find('h1[id], h2[id], h3[id], h4[id], h5[id], h6[id]').each(function() {
$this = $(this);
$this.append($('<a class="anchor d-print-none" aria-hidden="true"></a>').html('<i class="fas fa-anchor"></i>'));
});
$articleContent.on('click', '.anchor', function() {
$scroll.scrollToAnchor('#' + $(this).parent().attr('id'), 400);
});
});
});
})();
</script>
</div><section class="page__comments d-print-none"></section></article><!-- start custom main bottom snippet -->
<!-- end custom main bottom snippet -->
</div>
</div></div></div></div>
</div><script>(function() {
var SOURCES = window.TEXT_VARIABLES.sources;
window.Lazyload.js(SOURCES.jquery, function() {
var $body = $('body'), $window = $(window);
var $pageRoot = $('.js-page-root'), $pageMain = $('.js-page-main');
var activeCount = 0;
function modal(options) {
var $root = this, visible, onChange, hideWhenWindowScroll = false;
var scrollTop;
function setOptions(options) {
var _options = options || {};
visible = _options.initialVisible === undefined ? false : show;
onChange = _options.onChange;
hideWhenWindowScroll = _options.hideWhenWindowScroll;
}
function init() {
setState(visible);
}
function setState(isShow) {
if (isShow === visible) {
return;
}
visible = isShow;
if (visible) {
activeCount++;
scrollTop = $(window).scrollTop() || $pageMain.scrollTop();
$root.addClass('modal--show');
$pageMain.scrollTop(scrollTop);
activeCount === 1 && ($pageRoot.addClass('show-modal'), $body.addClass('of-hidden'));
hideWhenWindowScroll && window.hasEvent('touchstart') && $window.on('scroll', hide);
$window.on('keyup', handleKeyup);
} else {
activeCount > 0 && activeCount--;
$root.removeClass('modal--show');
$window.scrollTop(scrollTop);
activeCount === 0 && ($pageRoot.removeClass('show-modal'), $body.removeClass('of-hidden'));
hideWhenWindowScroll && window.hasEvent('touchstart') && $window.off('scroll', hide);
$window.off('keyup', handleKeyup);
}
onChange && onChange(visible);
}
function show() {
setState(true);
}
function hide() {
setState(false);
}
function handleKeyup(e) {
// Char Code: 27 ESC
if (e.which === 27) {
hide();
}
}
setOptions(options);
init();
return {
show: show,
hide: hide,
$el: $root
};
}
$.fn.modal = modal;
});
})();
</script><div class="modal modal--overflow page__search-modal d-print-none js-page-search-modal"><script>
(function () {
var SOURCES = window.TEXT_VARIABLES.sources;
window.Lazyload.js(SOURCES.jquery, function() {
// search panel
var search = (window.search || (window.search = {}));
var useDefaultSearchBox = window.useDefaultSearchBox === undefined ?
true : window.useDefaultSearchBox ;
var $searchModal = $('.js-page-search-modal');
var $searchToggle = $('.js-search-toggle');
var searchModal = $searchModal.modal({ onChange: handleModalChange, hideWhenWindowScroll: true });
var modalVisible = false;
search.searchModal = searchModal;
var $searchBox = null;
var $searchInput = null;
var $searchClear = null;
function getModalVisible() {
return modalVisible;
}
search.getModalVisible = getModalVisible;
function handleModalChange(visible) {
modalVisible = visible;
if (visible) {
search.onShow && search.onShow();
useDefaultSearchBox && $searchInput[0] && $searchInput[0].focus();
} else {
search.onShow && search.onHide();
useDefaultSearchBox && $searchInput[0] && $searchInput[0].blur();
setTimeout(function() {
useDefaultSearchBox && ($searchInput.val(''), $searchBox.removeClass('not-empty'));
search.clear && search.clear();
window.pageAsideAffix && window.pageAsideAffix.refresh();
}, 400);
}
}
$searchToggle.on('click', function() {
modalVisible ? searchModal.hide() : searchModal.show();
});
// Char Code: 83 S, 191 /
$(window).on('keyup', function(e) {
if (!modalVisible && !window.isFormElement(e.target || e.srcElement) && (e.which === 83 || e.which === 191)) {
modalVisible || searchModal.show();
}
});
if (useDefaultSearchBox) {
$searchBox = $('.js-search-box');
$searchInput = $searchBox.children('input');
$searchClear = $searchBox.children('.js-icon-clear');
search.getSearchInput = function() {
return $searchInput.get(0);
};
search.getVal = function() {
return $searchInput.val();
};
search.setVal = function(val) {
$searchInput.val(val);
};
$searchInput.on('focus', function() {
$(this).addClass('focus');
});
$searchInput.on('blur', function() {
$(this).removeClass('focus');
});
$searchInput.on('input', window.throttle(function() {
var val = $(this).val();
if (val === '' || typeof val !== 'string') {
search.clear && search.clear();
} else {
$searchBox.addClass('not-empty');
search.onInputNotEmpty && search.onInputNotEmpty(val);
}
}, 400));
$searchClear.on('click', function() {
$searchInput.val(''); $searchBox.removeClass('not-empty');
search.clear && search.clear();
});
}
});
})();
</script><div class="search search--dark">
<div class="main">
<div class="search__header">Recherche</div>
<div class="search-bar">
<div class="search-box js-search-box">
<div class="search-box__icon-search"><i class="fas fa-search"></i></div>
<input id="search-input" type="text" />
<div class="search-box__icon-clear js-icon-clear">
<a><i class="fas fa-times"></i></a>
</div>
</div>
<button class="button button--theme-dark button--pill search__cancel js-search-toggle">
Annuler</button>
</div>
<div id="results-container" class="search-result js-search-result"></div>
</div>
</div>
<!-- Script pointing to search-script.js -->
<script>/*!
* Simple-Jekyll-Search
* Copyright 2015-2020, Christian Fei
* Licensed under the MIT License.
*/
(function(){
'use strict'
var _$Templater_7 = {
compile: compile,
setOptions: setOptions
}
const options = {}
options.pattern = /\{(.*?)\}/g
options.template = ''
options.middleware = function () {}
function setOptions (_options) {
options.pattern = _options.pattern || options.pattern
options.template = _options.template || options.template
if (typeof _options.middleware === 'function') {
options.middleware = _options.middleware
}
}
function compile (data) {
return options.template.replace(options.pattern, function (match, prop) {
const value = options.middleware(prop, data[prop], options.template)
if (typeof value !== 'undefined') {
return value
}
return data[prop] || match
})
}
'use strict';
function fuzzysearch (needle, haystack) {
var tlen = haystack.length;
var qlen = needle.length;
if (qlen > tlen) {
return false;
}
if (qlen === tlen) {
return needle === haystack;
}
outer: for (var i = 0, j = 0; i < qlen; i++) {
var nch = needle.charCodeAt(i);
while (j < tlen) {
if (haystack.charCodeAt(j++) === nch) {
continue outer;
}
}
return false;
}
return true;
}
var _$fuzzysearch_1 = fuzzysearch;
'use strict'
/* removed: const _$fuzzysearch_1 = require('fuzzysearch') */;
var _$FuzzySearchStrategy_5 = new FuzzySearchStrategy()
function FuzzySearchStrategy () {
this.matches = function (string, crit) {
return _$fuzzysearch_1(crit.toLowerCase(), string.toLowerCase())
}
}
'use strict'
var _$LiteralSearchStrategy_6 = new LiteralSearchStrategy()
function LiteralSearchStrategy () {
this.matches = function (str, crit) {
if (!str) return false
str = str.trim().toLowerCase()
crit = crit.trim().toLowerCase()
return crit.split(' ').filter(function (word) {
return str.indexOf(word) >= 0
}).length === crit.split(' ').length
}
}
'use strict'
var _$Repository_4 = {
put: put,
clear: clear,
search: search,
setOptions: __setOptions_4
}
/* removed: const _$FuzzySearchStrategy_5 = require('./SearchStrategies/FuzzySearchStrategy') */;
/* removed: const _$LiteralSearchStrategy_6 = require('./SearchStrategies/LiteralSearchStrategy') */;
function NoSort () {
return 0
}
const data = []
let opt = {}
opt.fuzzy = false
opt.limit = 10
opt.searchStrategy = opt.fuzzy ? _$FuzzySearchStrategy_5 : _$LiteralSearchStrategy_6
opt.sort = NoSort
opt.exclude = []
function put (data) {
if (isObject(data)) {
return addObject(data)
}
if (isArray(data)) {
return addArray(data)
}
return undefined
}
function clear () {
data.length = 0
return data
}
function isObject (obj) {
return Boolean(obj) && Object.prototype.toString.call(obj) === '[object Object]'
}
function isArray (obj) {
return Boolean(obj) && Object.prototype.toString.call(obj) === '[object Array]'
}
function addObject (_data) {
data.push(_data)
return data
}
function addArray (_data) {
const added = []
clear()
for (let i = 0, len = _data.length; i < len; i++) {
if (isObject(_data[i])) {
added.push(addObject(_data[i]))
}
}
return added
}
function search (crit) {
if (!crit) {
return []
}
return findMatches(data, crit, opt.searchStrategy, opt).sort(opt.sort)
}
function __setOptions_4 (_opt) {
opt = _opt || {}
opt.fuzzy = _opt.fuzzy || false
opt.limit = _opt.limit || 10
opt.searchStrategy = _opt.fuzzy ? _$FuzzySearchStrategy_5 : _$LiteralSearchStrategy_6
opt.sort = _opt.sort || NoSort
opt.exclude = _opt.exclude || []
}
function findMatches (data, crit, strategy, opt) {
const matches = []
for (let i = 0; i < data.length && matches.length < opt.limit; i++) {
const match = findMatchesInObject(data[i], crit, strategy, opt)
if (match) {
matches.push(match)
}
}
return matches
}
function findMatchesInObject (obj, crit, strategy, opt) {
for (const key in obj) {
if (!isExcluded(obj[key], opt.exclude) && strategy.matches(obj[key], crit)) {
return obj
}
}
}
function isExcluded (term, excludedTerms) {
for (let i = 0, len = excludedTerms.length; i < len; i++) {
const excludedTerm = excludedTerms[i]
if (new RegExp(excludedTerm).test(term)) {
return true
}
}
return false
}
/* globals ActiveXObject:false */
'use strict'
var _$JSONLoader_2 = {
load: load
}
function load (location, callback) {
const xhr = getXHR()
xhr.open('GET', location, true)
xhr.onreadystatechange = createStateChangeListener(xhr, callback)
xhr.send()
}
function createStateChangeListener (xhr, callback) {
return function () {
if (xhr.readyState === 4 && xhr.status === 200) {
try {
callback(null, JSON.parse(xhr.responseText))
} catch (err) {
callback(err, null)
}
}
}
}
function getXHR () {
return window.XMLHttpRequest ? new window.XMLHttpRequest() : new ActiveXObject('Microsoft.XMLHTTP')
}
'use strict'
var _$OptionsValidator_3 = function OptionsValidator (params) {
if (!validateParams(params)) {
throw new Error('-- OptionsValidator: required options missing')
}
if (!(this instanceof OptionsValidator)) {
return new OptionsValidator(params)
}
const requiredOptions = params.required
this.getRequiredOptions = function () {
return requiredOptions
}
this.validate = function (parameters) {
const errors = []
requiredOptions.forEach(function (requiredOptionName) {
if (typeof parameters[requiredOptionName] === 'undefined') {
errors.push(requiredOptionName)
}
})
return errors
}
function validateParams (params) {
if (!params) {
return false
}
return typeof params.required !== 'undefined' && params.required instanceof Array
}
}
'use strict'
var _$utils_9 = {
merge: merge,
isJSON: isJSON
}
function merge (defaultParams, mergeParams) {
const mergedOptions = {}
for (const option in defaultParams) {
mergedOptions[option] = defaultParams[option]
if (typeof mergeParams[option] !== 'undefined') {
mergedOptions[option] = mergeParams[option]
}
}
return mergedOptions
}
function isJSON (json) {
try {
if (json instanceof Object && JSON.parse(JSON.stringify(json))) {
return true
}
return false
} catch (err) {
return false
}
}
var _$src_8 = {};
(function (window) {
'use strict'
let options = {
searchInput: null,
resultsContainer: null,
json: [],
success: Function.prototype,
searchResultTemplate: '<li><a href="{url}" title="{desc}">{title}</a></li>',
templateMiddleware: Function.prototype,
sortMiddleware: function () {
return 0
},
noResultsText: 'No results found',
limit: 10,
fuzzy: false,
debounceTime: null,
exclude: []
}
let debounceTimerHandle
const debounce = function (func, delayMillis) {
if (delayMillis) {
clearTimeout(debounceTimerHandle)
debounceTimerHandle = setTimeout(func, delayMillis)
} else {
func.call()
}
}
const requiredOptions = ['searchInput', 'resultsContainer', 'json']
/* removed: const _$Templater_7 = require('./Templater') */;
/* removed: const _$Repository_4 = require('./Repository') */;
/* removed: const _$JSONLoader_2 = require('./JSONLoader') */;
const optionsValidator = _$OptionsValidator_3({
required: requiredOptions
})
/* removed: const _$utils_9 = require('./utils') */;
window.SimpleJekyllSearch = function (_options) {
const errors = optionsValidator.validate(_options)
if (errors.length > 0) {
throwError('You must specify the following required options: ' + requiredOptions)
}
options = _$utils_9.merge(options, _options)
_$Templater_7.setOptions({
template: options.searchResultTemplate,
middleware: options.templateMiddleware
})
_$Repository_4.setOptions({
fuzzy: options.fuzzy,
limit: options.limit,
sort: options.sortMiddleware,
exclude: options.exclude
})
if (_$utils_9.isJSON(options.json)) {
initWithJSON(options.json)
} else {
initWithURL(options.json)
}
const rv = {
search: search
}
typeof options.success === 'function' && options.success.call(rv)
return rv
}
function initWithJSON (json) {
_$Repository_4.put(json)
registerInput()
}
function initWithURL (url) {
_$JSONLoader_2.load(url, function (err, json) {
if (err) {
throwError('failed to get JSON (' + url + ')')
}
initWithJSON(json)
})
}
function emptyResultsContainer () {
options.resultsContainer.innerHTML = ''
}
function appendToResultsContainer (text) {
options.resultsContainer.innerHTML += text
}
function registerInput () {
options.searchInput.addEventListener('input', function (e) {
if (isWhitelistedKey(e.which)) {
emptyResultsContainer()
debounce(function () { search(e.target.value) }, options.debounceTime)
}
})
}
function search (query) {
if (isValidQuery(query)) {
emptyResultsContainer()
render(_$Repository_4.search(query), query)
}
}
function render (results, query) {
const len = results.length
if (len === 0) {
return appendToResultsContainer(options.noResultsText)
}
for (let i = 0; i < len; i++) {
results[i].query = query
appendToResultsContainer(_$Templater_7.compile(results[i]))
}
}
function isValidQuery (query) {
return query && query.length > 0
}
function isWhitelistedKey (key) {
return [13, 16, 20, 37, 38, 39, 40, 91].indexOf(key) === -1
}
function throwError (message) {
throw new Error('SimpleJekyllSearch --- ' + message)
}
})(window)
}());
</script>
<!-- Configuration -->
<script>
SimpleJekyllSearch({
searchInput: document.getElementById('search-input'),
resultsContainer: document.getElementById('results-container'),
noResultsText: '<p>Aucun résultat!</p>',
json: '/search.json',
searchResultTemplate: '<li><a href="{url}">{date}&nbsp;{title}</a>&nbsp;(Création {create})</li>'
})
</script>
</div></div>
<script>(function() {
var SOURCES = window.TEXT_VARIABLES.sources;
window.Lazyload.js(SOURCES.jquery, function() {
function scrollToAnchor(anchor, duration, callback) {
var $root = this;
$root.animate({ scrollTop: $(anchor).position().top }, duration, function() {
window.history.replaceState(null, '', window.location.href.split('#')[0] + anchor);
callback && callback();
});
}
$.fn.scrollToAnchor = scrollToAnchor;
});
})();
(function() {
var SOURCES = window.TEXT_VARIABLES.sources;
window.Lazyload.js(SOURCES.jquery, function() {
function affix(options) {
var $root = this, $window = $(window), $scrollTarget, $scroll,
offsetBottom = 0, scrollTarget = window, scroll = window.document, disabled = false, isOverallScroller = true,
rootTop, rootLeft, rootHeight, scrollBottom, rootBottomTop,
hasInit = false, curState;
function setOptions(options) {
var _options = options || {};
_options.offsetBottom && (offsetBottom = _options.offsetBottom);
_options.scrollTarget && (scrollTarget = _options.scrollTarget);
_options.scroll && (scroll = _options.scroll);
_options.disabled !== undefined && (disabled = _options.disabled);
$scrollTarget = $(scrollTarget);
isOverallScroller = window.isOverallScroller($scrollTarget[0]);
$scroll = $(scroll);
}
function preCalc() {
top();
rootHeight = $root.outerHeight();
rootTop = $root.offset().top + (isOverallScroller ? 0 : $scrollTarget.scrollTop());
rootLeft = $root.offset().left;
}
function calc(needPreCalc) {
needPreCalc && preCalc();
scrollBottom = $scroll.outerHeight() - offsetBottom - rootHeight;
rootBottomTop = scrollBottom - rootTop;
}
function top() {
if (curState !== 'top') {
$root.removeClass('fixed').css({
left: 0,
top: 0
});
curState = 'top';
}
}
function fixed() {
if (curState !== 'fixed') {
$root.addClass('fixed').css({
left: rootLeft + 'px',
top: 0
});
curState = 'fixed';
}
}
function bottom() {
if (curState !== 'bottom') {
$root.removeClass('fixed').css({
left: 0,
top: rootBottomTop + 'px'
});
curState = 'bottom';
}
}
function setState() {
var scrollTop = $scrollTarget.scrollTop();
if (scrollTop >= rootTop && scrollTop <= scrollBottom) {
fixed();
} else if (scrollTop < rootTop) {
top();
} else {
bottom();
}
}
function init() {
if(!hasInit) {
var interval, timeout;
calc(true); setState();
// run calc every 100 millisecond
interval = setInterval(function() {
calc();
}, 100);
timeout = setTimeout(function() {
clearInterval(interval);
}, 45000);
window.pageLoad.then(function() {
setTimeout(function() {
clearInterval(interval);
clearTimeout(timeout);
}, 3000);
});
$scrollTarget.on('scroll', function() {
disabled || setState();
});
$window.on('resize', function() {
disabled || (calc(true), setState());
});
hasInit = true;
}
}
setOptions(options);
if (!disabled) {
init();
}
$window.on('resize', window.throttle(function() {
init();
}, 200));
return {
setOptions: setOptions,
refresh: function() {
calc(true, { animation: false }); setState();
}
};
}
$.fn.affix = affix;
});
})();
(function() {
var SOURCES = window.TEXT_VARIABLES.sources;
window.Lazyload.js(SOURCES.jquery, function() {
function toc(options) {
var $root = this, $window = $(window), $scrollTarget, $scroller, $tocUl = $('<ul class="toc toc--ellipsis"></ul>'), $tocLi, $headings, $activeLast, $activeCur,
selectors = 'h1,h2,h3', container = 'body', scrollTarget = window, scroller = 'html, body', disabled = false,
headingsPos, scrolling = false, hasRendered = false, hasInit = false;
function setOptions(options) {
var _options = options || {};
_options.selectors && (selectors = _options.selectors);
_options.container && (container = _options.container);
_options.scrollTarget && (scrollTarget = _options.scrollTarget);
_options.scroller && (scroller = _options.scroller);
_options.disabled !== undefined && (disabled = _options.disabled);
$headings = $(container).find(selectors).filter('[id]');
$scrollTarget = $(scrollTarget);
$scroller = $(scroller);
}
function calc() {
headingsPos = [];
$headings.each(function() {
headingsPos.push(Math.floor($(this).position().top));
});
}
function setState(element, disabled) {
var scrollTop = $scrollTarget.scrollTop(), i;
if (disabled || !headingsPos || headingsPos.length < 1) { return; }
if (element) {
$activeCur = element;
} else {
for (i = 0; i < headingsPos.length; i++) {
if (scrollTop >= headingsPos[i]) {
$activeCur = $tocLi.eq(i);
} else {
$activeCur || ($activeCur = $tocLi.eq(i));
break;
}
}
}
$activeLast && $activeLast.removeClass('active');
($activeLast = $activeCur).addClass('active');
}
function render() {
if(!hasRendered) {
$root.append($tocUl);
$headings.each(function() {
var $this = $(this);
$tocUl.append($('<li></li>').addClass('toc-' + $this.prop('tagName').toLowerCase())
.append($('<a></a>').text($this.text()).attr('href', '#' + $this.prop('id'))));
});
$tocLi = $tocUl.children('li');
$tocUl.on('click', 'a', function(e) {
e.preventDefault();
var $this = $(this);
scrolling = true;
setState($this.parent());
$scroller.scrollToAnchor($this.attr('href'), 400, function() {
scrolling = false;
});
});
}
hasRendered = true;
}
function init() {
var interval, timeout;
if(!hasInit) {
render(); calc(); setState(null, scrolling);
// run calc every 100 millisecond
interval = setInterval(function() {
calc();
}, 100);
timeout = setTimeout(function() {
clearInterval(interval);
}, 45000);
window.pageLoad.then(function() {
setTimeout(function() {
clearInterval(interval);
clearTimeout(timeout);
}, 3000);
});
$scrollTarget.on('scroll', function() {
disabled || setState(null, scrolling);
});
$window.on('resize', window.throttle(function() {
if (!disabled) {
render(); calc(); setState(null, scrolling);
}
}, 100));
}
hasInit = true;
}
setOptions(options);
if (!disabled) {
init();
}
$window.on('resize', window.throttle(function() {
init();
}, 200));
return {
setOptions: setOptions
};
}
$.fn.toc = toc;
});
})();
/*(function () {
})();*/
</script><script>
/* toc must before affix, since affix need to konw toc' height. */(function() {
var SOURCES = window.TEXT_VARIABLES.sources;
var TOC_SELECTOR = window.TEXT_VARIABLES.site.toc.selectors;
window.Lazyload.js(SOURCES.jquery, function() {
var $window = $(window);
var $articleContent = $('.js-article-content');
var $tocRoot = $('.js-toc-root'), $col2 = $('.js-col-aside');
var toc;
var tocDisabled = false;
var hasSidebar = $('.js-page-root').hasClass('layout--page--sidebar');
var hasToc = $articleContent.find(TOC_SELECTOR).length > 0;
function disabled() {
return $col2.css('display') === 'none' || !hasToc;
}
tocDisabled = disabled();
toc = $tocRoot.toc({
selectors: TOC_SELECTOR,
container: $articleContent,
scrollTarget: hasSidebar ? '.js-page-main' : null,
scroller: hasSidebar ? '.js-page-main' : null,
disabled: tocDisabled
});
$window.on('resize', window.throttle(function() {
tocDisabled = disabled();
toc && toc.setOptions({
disabled: tocDisabled
});
}, 100));
});
})();
(function() {
var SOURCES = window.TEXT_VARIABLES.sources;
window.Lazyload.js(SOURCES.jquery, function() {
var $window = $(window), $pageFooter = $('.js-page-footer');
var $pageAside = $('.js-page-aside');
var affix;
var tocDisabled = false;
var hasSidebar = $('.js-page-root').hasClass('layout--page--sidebar');
affix = $pageAside.affix({
offsetBottom: $pageFooter.outerHeight(),
scrollTarget: hasSidebar ? '.js-page-main' : null,
scroller: hasSidebar ? '.js-page-main' : null,
scroll: hasSidebar ? $('.js-page-main').children() : null,
disabled: tocDisabled
});
$window.on('resize', window.throttle(function() {
affix && affix.setOptions({
disabled: tocDisabled
});
}, 100));
window.pageAsideAffix = affix;
});
})();
</script><!---->
</div>
<script>(function () {
var $root = document.getElementsByClassName('root')[0];
if (window.hasEvent('touchstart')) {
$root.dataset.isTouch = true;
document.addEventListener('touchstart', function(){}, false);
}
})();
</script>
</body>
</html>