adauthentication.html 45 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197
  1. <!doctype html>
  2. <html lang="en" class="no-js">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width,initial-scale=1">
  6. <meta name="description" content="ESP8266/ESP32 WLAN configuration at run time with web interface">
  7. <link rel="canonical" href="https://Hieromon.github.io/AutoConnect/adauthentication.html">
  8. <meta name="author" content="Hieromon Ikasamo">
  9. <link rel="shortcut icon" href="assets/images/favicon.png">
  10. <meta name="generator" content="mkdocs-1.1.2, mkdocs-material-6.1.6">
  11. <title>Authentication settings - AutoConnect for ESP8266/ESP32</title>
  12. <link rel="stylesheet" href="assets/stylesheets/main.6910b76c.min.css">
  13. <link rel="stylesheet" href="assets/stylesheets/palette.196e0c26.min.css">
  14. <meta name="theme-color" content="#4051b5">
  15. <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
  16. <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700%7CRoboto+Mono&display=fallback">
  17. <style>body,input{font-family:"Roboto",-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono",SFMono-Regular,Consolas,Menlo,monospace}</style>
  18. <link rel="stylesheet" href="css/paragraph.css">
  19. <link rel="stylesheet" href="css/extra.css">
  20. <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.3/css/all.css">
  21. <script>window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)},ga.l=+new Date,ga("create","UA-116150854-1","auto"),ga("set","anonymizeIp",!0),ga("send","pageview"),document.addEventListener("DOMContentLoaded",function(){document.forms.search&&document.forms.search.query.addEventListener("blur",function(){if(this.value){var e=document.location.pathname;ga("send","pageview",e+"?q="+this.value)}})}),document.addEventListener("DOMContentSwitch",function(){ga("send","pageview",document.location.pathname)})</script>
  22. <script async src="https://www.google-analytics.com/analytics.js"></script>
  23. </head>
  24. <body dir="ltr" data-md-color-scheme="" data-md-color-primary="indigo" data-md-color-accent="indigo">
  25. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
  26. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
  27. <label class="md-overlay" for="__drawer"></label>
  28. <div data-md-component="skip">
  29. <a href="#applying-http-authentication" class="md-skip">
  30. Skip to content
  31. </a>
  32. </div>
  33. <div data-md-component="announce">
  34. </div>
  35. <header class="md-header" data-md-component="header">
  36. <nav class="md-header-nav md-grid" aria-label="Header">
  37. <a href="https://Hieromon.github.io/AutoConnect/" title="AutoConnect for ESP8266/ESP32" class="md-header-nav__button md-logo" aria-label="AutoConnect for ESP8266/ESP32">
  38. <img src="images/arduino-logo.svg" alt="logo">
  39. </a>
  40. <label class="md-header-nav__button md-icon" for="__drawer">
  41. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg>
  42. </label>
  43. <div class="md-header-nav__title" data-md-component="header-title">
  44. <div class="md-header-nav__ellipsis">
  45. <span class="md-header-nav__topic md-ellipsis">
  46. AutoConnect for ESP8266/ESP32
  47. </span>
  48. <span class="md-header-nav__topic md-ellipsis">
  49. Authentication settings
  50. </span>
  51. </div>
  52. </div>
  53. <label class="md-header-nav__button md-icon" for="__search">
  54. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0116 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 019.5 16 6.5 6.5 0 013 9.5 6.5 6.5 0 019.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
  55. </label>
  56. <div class="md-search" data-md-component="search" role="dialog">
  57. <label class="md-search__overlay" for="__search"></label>
  58. <div class="md-search__inner" role="search">
  59. <form class="md-search__form" name="search">
  60. <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" data-md-state="active" required>
  61. <label class="md-search__icon md-icon" for="__search">
  62. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0116 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 019.5 16 6.5 6.5 0 013 9.5 6.5 6.5 0 019.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
  63. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
  64. </label>
  65. <button type="reset" class="md-search__icon md-icon" aria-label="Clear" data-md-component="search-reset" tabindex="-1">
  66. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"/></svg>
  67. </button>
  68. </form>
  69. <div class="md-search__output">
  70. <div class="md-search__scrollwrap" data-md-scrollfix>
  71. <div class="md-search-result" data-md-component="search-result">
  72. <div class="md-search-result__meta">
  73. Initializing search
  74. </div>
  75. <ol class="md-search-result__list"></ol>
  76. </div>
  77. </div>
  78. </div>
  79. </div>
  80. </div>
  81. <div class="md-header-nav__source">
  82. <a href="https://github.com/Hieromon/AutoConnect" title="Go to repository" class="md-source">
  83. <div class="md-source__icon md-icon">
  84. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M439.55 236.05L244 40.45a28.87 28.87 0 00-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 01-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 000 40.81l195.61 195.6a28.86 28.86 0 0040.8 0l194.69-194.69a28.86 28.86 0 000-40.81z"/></svg>
  85. </div>
  86. <div class="md-source__repository">
  87. Hieromon/AutoConnect
  88. </div>
  89. </a>
  90. </div>
  91. </nav>
  92. </header>
  93. <div class="md-container" data-md-component="container">
  94. <main class="md-main" data-md-component="main">
  95. <div class="md-main__inner md-grid">
  96. <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
  97. <div class="md-sidebar__scrollwrap">
  98. <div class="md-sidebar__inner">
  99. <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
  100. <label class="md-nav__title" for="__drawer">
  101. <a href="https://Hieromon.github.io/AutoConnect/" title="AutoConnect for ESP8266/ESP32" class="md-nav__button md-logo" aria-label="AutoConnect for ESP8266/ESP32">
  102. <img src="images/arduino-logo.svg" alt="logo">
  103. </a>
  104. AutoConnect for ESP8266/ESP32
  105. </label>
  106. <div class="md-nav__source">
  107. <a href="https://github.com/Hieromon/AutoConnect" title="Go to repository" class="md-source">
  108. <div class="md-source__icon md-icon">
  109. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M439.55 236.05L244 40.45a28.87 28.87 0 00-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 01-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 000 40.81l195.61 195.6a28.86 28.86 0 0040.8 0l194.69-194.69a28.86 28.86 0 000-40.81z"/></svg>
  110. </div>
  111. <div class="md-source__repository">
  112. Hieromon/AutoConnect
  113. </div>
  114. </a>
  115. </div>
  116. <ul class="md-nav__list" data-md-scrollfix>
  117. <li class="md-nav__item">
  118. <a href="index.html" class="md-nav__link">
  119. Overview
  120. </a>
  121. </li>
  122. <li class="md-nav__item">
  123. <a href="gettingstarted.html" class="md-nav__link">
  124. Getting started
  125. </a>
  126. </li>
  127. <li class="md-nav__item">
  128. <a href="menu.html" class="md-nav__link">
  129. AutoConnect menu
  130. </a>
  131. </li>
  132. <li class="md-nav__item">
  133. <a href="basicusage.html" class="md-nav__link">
  134. Basic usage
  135. </a>
  136. </li>
  137. <li class="md-nav__item md-nav__item--active md-nav__item--nested">
  138. <input class="md-nav__toggle md-toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5" checked>
  139. <label class="md-nav__link" for="nav-5">
  140. Advanced usage
  141. <span class="md-nav__icon md-icon"></span>
  142. </label>
  143. <nav class="md-nav" aria-label="Advanced usage" data-md-level="1">
  144. <label class="md-nav__title" for="nav-5">
  145. <span class="md-nav__icon md-icon"></span>
  146. Advanced usage
  147. </label>
  148. <ul class="md-nav__list" data-md-scrollfix>
  149. <li class="md-nav__item">
  150. <a href="advancedusage.html" class="md-nav__link">
  151. Advanced usage
  152. </a>
  153. </li>
  154. <li class="md-nav__item">
  155. <a href="adconnection.html" class="md-nav__link">
  156. AutoConnect WiFi connection control
  157. </a>
  158. </li>
  159. <li class="md-nav__item">
  160. <a href="adcpcontrol.html" class="md-nav__link">
  161. Captive portal control
  162. </a>
  163. </li>
  164. <li class="md-nav__item">
  165. <a href="adnetwork.html" class="md-nav__link">
  166. Settings and controls for network and WiFi
  167. </a>
  168. </li>
  169. <li class="md-nav__item md-nav__item--active">
  170. <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc">
  171. <label class="md-nav__link md-nav__link--active" for="__toc">
  172. Authentication settings
  173. <span class="md-nav__icon md-icon"></span>
  174. </label>
  175. <a href="adauthentication.html" class="md-nav__link md-nav__link--active">
  176. Authentication settings
  177. </a>
  178. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  179. <label class="md-nav__title" for="__toc">
  180. <span class="md-nav__icon md-icon"></span>
  181. Table of contents
  182. </label>
  183. <ul class="md-nav__list" data-md-scrollfix>
  184. <li class="md-nav__item">
  185. <a href="#applying-http-authentication" class="md-nav__link">
  186. Applying HTTP authentication
  187. </a>
  188. </li>
  189. <li class="md-nav__item">
  190. <a href="#applying-http-authentication-for-built-in-ota" class="md-nav__link">
  191. Applying HTTP authentication for Built-in OTA
  192. </a>
  193. </li>
  194. <li class="md-nav__item">
  195. <a href="#authentication-within-the-captive-portal-state" class="md-nav__link">
  196. Authentication within the captive portal state
  197. </a>
  198. </li>
  199. </ul>
  200. </nav>
  201. </li>
  202. <li class="md-nav__item">
  203. <a href="adcredential.html" class="md-nav__link">
  204. Credential accesses
  205. </a>
  206. </li>
  207. <li class="md-nav__item">
  208. <a href="adexterior.html" class="md-nav__link">
  209. Customizing page appearance
  210. </a>
  211. </li>
  212. <li class="md-nav__item">
  213. <a href="adothers.html" class="md-nav__link">
  214. Other operation settings and controls
  215. </a>
  216. </li>
  217. </ul>
  218. </nav>
  219. </li>
  220. <li class="md-nav__item md-nav__item--nested">
  221. <input class="md-nav__toggle md-toggle" data-md-toggle="nav-6" type="checkbox" id="nav-6" >
  222. <label class="md-nav__link" for="nav-6">
  223. Custom Web pages
  224. <span class="md-nav__icon md-icon"></span>
  225. </label>
  226. <nav class="md-nav" aria-label="Custom Web pages" data-md-level="1">
  227. <label class="md-nav__title" for="nav-6">
  228. <span class="md-nav__icon md-icon"></span>
  229. Custom Web pages
  230. </label>
  231. <ul class="md-nav__list" data-md-scrollfix>
  232. <li class="md-nav__item">
  233. <a href="acintro.html" class="md-nav__link">
  234. Custom Web pages with AutoConnect
  235. </a>
  236. </li>
  237. <li class="md-nav__item">
  238. <a href="acelements.html" class="md-nav__link">
  239. AutoConnectElements
  240. </a>
  241. </li>
  242. <li class="md-nav__item">
  243. <a href="acjson.html" class="md-nav__link">
  244. Custom Web pages with JSON
  245. </a>
  246. </li>
  247. <li class="md-nav__item">
  248. <a href="achandling.html" class="md-nav__link">
  249. Handling the custom Web pages
  250. </a>
  251. </li>
  252. </ul>
  253. </nav>
  254. </li>
  255. <li class="md-nav__item md-nav__item--nested">
  256. <input class="md-nav__toggle md-toggle" data-md-toggle="nav-7" type="checkbox" id="nav-7" >
  257. <label class="md-nav__link" for="nav-7">
  258. OTA Updates
  259. <span class="md-nav__icon md-icon"></span>
  260. </label>
  261. <nav class="md-nav" aria-label="OTA Updates" data-md-level="1">
  262. <label class="md-nav__title" for="nav-7">
  263. <span class="md-nav__icon md-icon"></span>
  264. OTA Updates
  265. </label>
  266. <ul class="md-nav__list" data-md-scrollfix>
  267. <li class="md-nav__item">
  268. <a href="otaupdate.html" class="md-nav__link">
  269. OTA Updates
  270. </a>
  271. </li>
  272. <li class="md-nav__item">
  273. <a href="otabrowser.html" class="md-nav__link">
  274. Using Web Browser
  275. </a>
  276. </li>
  277. <li class="md-nav__item">
  278. <a href="otaserver.html" class="md-nav__link">
  279. Using Update Server
  280. </a>
  281. </li>
  282. </ul>
  283. </nav>
  284. </li>
  285. <li class="md-nav__item md-nav__item--nested">
  286. <input class="md-nav__toggle md-toggle" data-md-toggle="nav-8" type="checkbox" id="nav-8" >
  287. <label class="md-nav__link" for="nav-8">
  288. Library APIs
  289. <span class="md-nav__icon md-icon"></span>
  290. </label>
  291. <nav class="md-nav" aria-label="Library APIs" data-md-level="1">
  292. <label class="md-nav__title" for="nav-8">
  293. <span class="md-nav__icon md-icon"></span>
  294. Library APIs
  295. </label>
  296. <ul class="md-nav__list" data-md-scrollfix>
  297. <li class="md-nav__item">
  298. <a href="api.html" class="md-nav__link">
  299. AutoConnect API
  300. </a>
  301. </li>
  302. <li class="md-nav__item">
  303. <a href="apiaux.html" class="md-nav__link">
  304. AutoConnectAux API
  305. </a>
  306. </li>
  307. <li class="md-nav__item">
  308. <a href="apiconfig.html" class="md-nav__link">
  309. AutoConnectConfig API
  310. </a>
  311. </li>
  312. <li class="md-nav__item">
  313. <a href="apielements.html" class="md-nav__link">
  314. AutoConnectElements API
  315. </a>
  316. </li>
  317. <li class="md-nav__item">
  318. <a href="apiupdate.html" class="md-nav__link">
  319. AutoConnectUpdate API
  320. </a>
  321. </li>
  322. <li class="md-nav__item">
  323. <a href="apiextra.html" class="md-nav__link">
  324. Something extra
  325. </a>
  326. </li>
  327. </ul>
  328. </nav>
  329. </li>
  330. <li class="md-nav__item md-nav__item--nested">
  331. <input class="md-nav__toggle md-toggle" data-md-toggle="nav-9" type="checkbox" id="nav-9" >
  332. <label class="md-nav__link" for="nav-9">
  333. Examples
  334. <span class="md-nav__icon md-icon"></span>
  335. </label>
  336. <nav class="md-nav" aria-label="Examples" data-md-level="1">
  337. <label class="md-nav__title" for="nav-9">
  338. <span class="md-nav__icon md-icon"></span>
  339. Examples
  340. </label>
  341. <ul class="md-nav__list" data-md-scrollfix>
  342. <li class="md-nav__item">
  343. <a href="howtoembed.html" class="md-nav__link">
  344. How to embed
  345. </a>
  346. </li>
  347. <li class="md-nav__item">
  348. <a href="datatips.html" class="md-nav__link">
  349. Tips for data conversion
  350. </a>
  351. </li>
  352. <li class="md-nav__item">
  353. <a href="menuize.html" class="md-nav__link">
  354. Attach the menus
  355. </a>
  356. </li>
  357. <li class="md-nav__item">
  358. <a href="wojson.html" class="md-nav__link">
  359. Custom Web pages w/o JSON
  360. </a>
  361. </li>
  362. </ul>
  363. </nav>
  364. </li>
  365. <li class="md-nav__item md-nav__item--nested">
  366. <input class="md-nav__toggle md-toggle" data-md-toggle="nav-10" type="checkbox" id="nav-10" >
  367. <label class="md-nav__link" for="nav-10">
  368. Appendix
  369. <span class="md-nav__icon md-icon"></span>
  370. </label>
  371. <nav class="md-nav" aria-label="Appendix" data-md-level="1">
  372. <label class="md-nav__title" for="nav-10">
  373. <span class="md-nav__icon md-icon"></span>
  374. Appendix
  375. </label>
  376. <ul class="md-nav__list" data-md-scrollfix>
  377. <li class="md-nav__item">
  378. <a href="lsbegin.html" class="md-nav__link">
  379. Inside AutoConnect::begin
  380. </a>
  381. </li>
  382. <li class="md-nav__item">
  383. <a href="credit.html" class="md-nav__link">
  384. Saved credentials access
  385. </a>
  386. </li>
  387. <li class="md-nav__item">
  388. <a href="acupload.html" class="md-nav__link">
  389. File upload handler
  390. </a>
  391. </li>
  392. <li class="md-nav__item">
  393. <a href="colorized.html" class="md-nav__link">
  394. Custom colorized
  395. </a>
  396. </li>
  397. <li class="md-nav__item">
  398. <a href="changelabel.html" class="md-nav__link">
  399. Change label text
  400. </a>
  401. </li>
  402. </ul>
  403. </nav>
  404. </li>
  405. <li class="md-nav__item">
  406. <a href="faq.html" class="md-nav__link">
  407. FAQ
  408. </a>
  409. </li>
  410. <li class="md-nav__item">
  411. <a href="changelog.html" class="md-nav__link">
  412. Change log
  413. </a>
  414. </li>
  415. <li class="md-nav__item">
  416. <a href="license.html" class="md-nav__link">
  417. License
  418. </a>
  419. </li>
  420. </ul>
  421. </nav>
  422. </div>
  423. </div>
  424. </div>
  425. <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
  426. <div class="md-sidebar__scrollwrap">
  427. <div class="md-sidebar__inner">
  428. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  429. <label class="md-nav__title" for="__toc">
  430. <span class="md-nav__icon md-icon"></span>
  431. Table of contents
  432. </label>
  433. <ul class="md-nav__list" data-md-scrollfix>
  434. <li class="md-nav__item">
  435. <a href="#applying-http-authentication" class="md-nav__link">
  436. Applying HTTP authentication
  437. </a>
  438. </li>
  439. <li class="md-nav__item">
  440. <a href="#applying-http-authentication-for-built-in-ota" class="md-nav__link">
  441. Applying HTTP authentication for Built-in OTA
  442. </a>
  443. </li>
  444. <li class="md-nav__item">
  445. <a href="#authentication-within-the-captive-portal-state" class="md-nav__link">
  446. Authentication within the captive portal state
  447. </a>
  448. </li>
  449. </ul>
  450. </nav>
  451. </div>
  452. </div>
  453. </div>
  454. <div class="md-content">
  455. <article class="md-content__inner md-typeset">
  456. <h1>Authentication settings</h1>
  457. <p>The Sketch may use authentication to protect custom Web pages and prevent unauthorized access. AutoConnect has implemented HTTP authentication feature that can be applied to multiple scopes using the <a href="https://github.com/esp8266/Arduino/tree/master/libraries/ESP8266WebServer#authentication">authentication methods</a> provided by the platform's WebServer library for ESP8266 or ESP32.<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup></p>
  458. <ul>
  459. <li><a href="#applying-http-authentication">Applying HTTP authentication</a></li>
  460. <li><a href="#applying-http-authentication-for-built-in-ota">Applying HTTP authentication for Built-in OTA</a></li>
  461. <li><a href="#authentication-within-the-captive-portal-state">Authentication within the captive portal state</a></li>
  462. </ul>
  463. <h2 id="applying-http-authentication">Applying HTTP authentication<a class="headerlink" href="#applying-http-authentication" title="Permanent link">&para;</a></h2>
  464. <p><a href="apiconfig.html#auth"><em>AutoConnectConfig::auth</em></a> setting allows the Sketch to HTTP authenticate with "<a href="https://tools.ietf.org/html/rfc2617#section-2"><strong>BASIC</strong></a>" or "<a href="https://tools.ietf.org/html/rfc2617#section-3"><strong>DIGEST</strong></a>" scheme. <a href="apiconfig.html#authscope"><em>AutoConnectConfig::authScope</em></a> specifies the scope covered by authentication which is the whole range for all pages of the Sketch, custom web pages, or AutoConnect pages. <a href="apiconfig.html#username"><em>AutoConnectConfig::username</em></a> and <a href="apiconfig.html#password"><em>AutoConnectConfig::password</em></a> specifies credential as user-id/password pairs.</p>
  465. <p>The Sketch enables HTTP authentication with the <a href="apiconfig.html#auth"><em>AutoConnectConfig::auth</em></a> setting, also specifies the authentication scheme:</p>
  466. <ul>
  467. <li><strong>AC_AUTH_NONE</strong><br />
  468. AutoConnect pages and custom Web pages do not require authentication. Not protected from all HTTP access. This is the default.</li>
  469. <li><strong>AC_AUTH_DIGEST</strong><br />
  470. Protect AutoConnect pages and custom Web pages with DIGEST authentication.</li>
  471. <li><strong>AC_AUTH_BASIC</strong><br />
  472. Protect AutoConnect pages and custom Web pages with BASIC authentication.</li>
  473. </ul>
  474. <p>Note that the authentication scope specified in <a href="apiconfig.html#authscope"><em>AutoConnectConfig::authScope</em></a> is different from the protection space shown by <a href="https://tools.ietf.org/html/rfc7235#section-2.2"><strong>Realm</strong></a> for HTTP authentication. AutoConnect assumes only one Realm and defines it as <a href="https://github.com/Hieromon/AutoConnect/blob/master/src/AutoConnectDefs.h#L268"><strong>AUTOCONNECT_AUTH_REALM</strong></a> in <a href="https://github.com/Hieromon/AutoConnect/blob/master/src/AutoConnectDefs.h"><code>AutoConnectDefs.h</code></a> header file. Instead, the Sketch will be able to expand or narrow the range of authentication by <a href="apiconfig.html#authscope"><em>AutoConnectConfig::authScope</em></a> setting, which can be either as follows:</p>
  475. <ul>
  476. <li><strong>AC_AUTHSCOPE_PORTAL</strong><br />
  477. Require authentication to access for all AutoConnect pages, including custom Web pages.</li>
  478. <li><strong>AC_AUTHSCOPE_AUX</strong><br />
  479. Require authentication to access for all custom Web pages, excepting AutoConnect pages. This is the Default.</li>
  480. <li><strong>AC_AUTHSCOPE_PARTIAL</strong><br />
  481. Authenticate only specific custom Web pages which are specified by <a href="apiaux.html#authentication"><em>AutoConnectAux::authentication</em></a> function or <a href="acjson.html#auth">JSON</a>.</li>
  482. </ul>
  483. <p>Also, a credential used for authentication is specified in the Sketch using the <a href="apiconfig.html#username"><em>AutoConnectConfig::username</em></a> and <a href="apiconfig.html#password"><em>AutoConnectConfig::password</em></a> settings.<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup></p>
  484. <p>Here's a minimal Sketch with HTTP authentication for the custom Web page:</p>
  485. <div class="highlight" style="background: #272822"><pre style="line-height: 125%; margin: 0;"><span></span><code><span style="color: #75715e">#include</span> <span style="color: #75715e">&lt;ESP8266WiFi.h&gt;</span>
  486. <span style="color: #75715e">#include</span> <span style="color: #75715e">&lt;ESP8266WebServer.h&gt;</span>
  487. <span style="color: #75715e">#include</span> <span style="color: #75715e">&lt;AutoConnect.h&gt;</span>
  488. <span style="color: #66d9ef">static</span> <span style="color: #66d9ef">const</span> <span style="color: #66d9ef">char</span> <span style="color: #f8f8f2">PAGE_AUTH[]</span> <span style="color: #f8f8f2">PROGMEM</span> <span style="color: #f92672">=</span> <span style="color: #e6db74">R&quot;(</span>
  489. <span style="color: #e6db74">{</span>
  490. <span style="color: #e6db74"> &quot;uri&quot;: &quot;/auth&quot;,</span>
  491. <span style="color: #e6db74"> &quot;title&quot;: &quot;Auth&quot;,</span>
  492. <span style="color: #e6db74"> &quot;menu&quot;: true,</span>
  493. <span style="color: #e6db74"> &quot;element&quot;: [</span>
  494. <span style="color: #e6db74"> {</span>
  495. <span style="color: #e6db74"> &quot;name&quot;: &quot;text&quot;,</span>
  496. <span style="color: #e6db74"> &quot;type&quot;: &quot;ACText&quot;,</span>
  497. <span style="color: #e6db74"> &quot;value&quot;: &quot;AutoConnect has authorized&quot;,</span>
  498. <span style="color: #e6db74"> &quot;style&quot;: &quot;font-family:Arial;font-size:18px;font-weight:400;color:#191970&quot;</span>
  499. <span style="color: #e6db74"> }</span>
  500. <span style="color: #e6db74"> ]</span>
  501. <span style="color: #e6db74">}</span>
  502. <span style="color: #e6db74">)&quot;</span><span style="color: #f8f8f2">;</span>
  503. <span style="color: #f8f8f2">WebServerClass</span> <span style="color: #f8f8f2">server;</span>
  504. <span style="color: #f8f8f2">AutoConnect</span> <span style="color: #a6e22e">portal</span><span style="color: #f8f8f2">(server);</span>
  505. <span style="color: #f8f8f2">AutoConnectConfig</span> <span style="color: #f8f8f2">config;</span>
  506. <span style="color: #66d9ef">void</span> <span style="color: #a6e22e">setup</span><span style="color: #f8f8f2">()</span> <span style="color: #f8f8f2">{</span>
  507. <span style="background-color: #49483e"> <span style="color: #f8f8f2">config.auth</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">AC_AUTH_DIGEST;</span>
  508. </span><span style="background-color: #49483e"> <span style="color: #f8f8f2">config.authScope</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">AC_AUTHSCOPE_AUX;</span>
  509. </span><span style="background-color: #49483e"> <span style="color: #f8f8f2">config.username</span> <span style="color: #f92672">=</span> <span style="color: #e6db74">&quot;user&quot;</span><span style="color: #f8f8f2">;</span>
  510. </span><span style="background-color: #49483e"> <span style="color: #f8f8f2">config.password</span> <span style="color: #f92672">=</span> <span style="color: #e6db74">&quot;password&quot;</span><span style="color: #f8f8f2">;</span>
  511. </span> <span style="color: #f8f8f2">portal.config(config);</span>
  512. <span style="color: #f8f8f2">portal.load(FPSTR(PAGE_AUTH));</span>
  513. <span style="color: #f8f8f2">portal.begin();</span>
  514. <span style="color: #f8f8f2">}</span>
  515. <span style="color: #66d9ef">void</span> <span style="color: #a6e22e">loop</span><span style="color: #f8f8f2">()</span> <span style="color: #f8f8f2">{</span>
  516. <span style="color: #f8f8f2">portal.handleClient();</span>
  517. <span style="color: #f8f8f2">}</span>
  518. </code></pre></div>
  519. <p>If you want to authenticate only specific pages in a Sketch that handles multiple custom Web pages, set <strong>AC_AUTHSCOPE_PARTIAL</strong> to <a href="apiconfig.html#authscope"><em>AutoConnectConfig::authScope</em></a>. Then, it specifies the authentication scheme with the <a href="acjson.html#auth"><strong>auth</strong></a> key in the JSON description of the page should be authenticated. </p>
  520. <p>AutoConnect determines which authentication method to use for custom Web pages (such as AutoConnectAux) based on its association with <a href="apiconfig.html#authscope"><em>AutoConnectConfig::authScope</em></a> setting. The table below shows which authentication scheme will be finally adopted. As shown in this table, the final authentication scheme depends on the <a href="apiconfig.html#authscope"><em>AutoConnectConfig::authScope</em></a> setting, and if <strong>AC_AUTHSCOPE_PARTIAL</strong> is specified it, <a href="apiaux.html#authentication">AutoConnectAux's authentication</a> setting takes precedence over the <a href="apiconfig.html#auth"><em>AutoConnectConfig::auth</em></a> setting.</p>
  521. <table>
  522. <thead>
  523. <tr>
  524. <th>AutoConnectConfig::authScope</th>
  525. <th>Authentication scheme for the custom Web page</th>
  526. </tr>
  527. </thead>
  528. <tbody>
  529. <tr>
  530. <td>AC_AUTHSCOPE_PORTAL</td>
  531. <td>Specified by AutoConnectConfig::auth</td>
  532. </tr>
  533. <tr>
  534. <td>AC_AUTHSCOPE_AUX</td>
  535. <td>Specified by AutoConnectConfig::auth</td>
  536. </tr>
  537. <tr>
  538. <td>AC_AUTHSCOPE_PARTIAL</td>
  539. <td>Specified by <a href="apiaux.html#authentication">AutoConnectAux::authentication</a>, The default values is <strong>AC_AUTH_NONE</strong>.</td>
  540. </tr>
  541. </tbody>
  542. </table>
  543. <p>Authentication designation for AutoConnectAux can also be specified by giving the following value to the <strong>auth</strong> key by the JSON description:</p>
  544. <ul>
  545. <li>"auth" : "basic"</li>
  546. <li>"auth" : "digest"</li>
  547. <li>"auth" : "none"</li>
  548. </ul>
  549. <p>The following example Sketch has two custom Web pages, <code>Hello</code> and <code>Auth</code>. It applies authentication only to the <code>Auth</code> page by setting AC_AUTHSCOPE_PARTIAL to AutoConnectConfig::authScope.</p>
  550. <div class="highlight" style="background: #272822"><pre style="line-height: 125%; margin: 0;"><span></span><code><span style="color: #75715e">#include</span> <span style="color: #75715e">&lt;ESP8266WiFi.h&gt;</span>
  551. <span style="color: #75715e">#include</span> <span style="color: #75715e">&lt;ESP8266WebServer.h&gt;</span>
  552. <span style="color: #75715e">#include</span> <span style="color: #75715e">&lt;AutoConnect.h&gt;</span>
  553. <span style="color: #66d9ef">static</span> <span style="color: #66d9ef">const</span> <span style="color: #66d9ef">char</span> <span style="color: #f8f8f2">PAGE_HELLO[]</span> <span style="color: #f8f8f2">PROGMEM</span> <span style="color: #f92672">=</span> <span style="color: #e6db74">R&quot;(</span>
  554. <span style="color: #e6db74">{</span>
  555. <span style="color: #e6db74"> &quot;uri&quot;: &quot;/hello&quot;,</span>
  556. <span style="color: #e6db74"> &quot;title&quot;: &quot;Hello&quot;,</span>
  557. <span style="color: #e6db74"> &quot;menu&quot;: true,</span>
  558. <span style="color: #e6db74"> &quot;element&quot;: [</span>
  559. <span style="color: #e6db74"> {</span>
  560. <span style="color: #e6db74"> &quot;name&quot;: &quot;text&quot;,</span>
  561. <span style="color: #e6db74"> &quot;type&quot;: &quot;ACText&quot;,</span>
  562. <span style="color: #e6db74"> &quot;value&quot;: &quot;Hello, word&quot;,</span>
  563. <span style="color: #e6db74"> &quot;style&quot;: &quot;font-family:Arial;font-size:18px;font-weight:400;color:#191970&quot;</span>
  564. <span style="color: #e6db74"> }</span>
  565. <span style="color: #e6db74"> ]</span>
  566. <span style="color: #e6db74">}</span>
  567. <span style="color: #e6db74">)&quot;</span><span style="color: #f8f8f2">;</span>
  568. <span style="color: #66d9ef">static</span> <span style="color: #66d9ef">const</span> <span style="color: #66d9ef">char</span> <span style="color: #f8f8f2">PAGE_AUTH[]</span> <span style="color: #f8f8f2">PROGMEM</span> <span style="color: #f92672">=</span> <span style="color: #e6db74">R&quot;(</span>
  569. <span style="color: #e6db74">{</span>
  570. <span style="color: #e6db74"> &quot;uri&quot;: &quot;/auth&quot;,</span>
  571. <span style="color: #e6db74"> &quot;title&quot;: &quot;Auth&quot;,</span>
  572. <span style="color: #e6db74"> &quot;menu&quot;: true,</span>
  573. <span style="background-color: #49483e"><span style="color: #e6db74"> &quot;auth&quot;: &quot;digest&quot;,</span>
  574. </span><span style="color: #e6db74"> &quot;element&quot;: [</span>
  575. <span style="color: #e6db74"> {</span>
  576. <span style="color: #e6db74"> &quot;name&quot;: &quot;text&quot;,</span>
  577. <span style="color: #e6db74"> &quot;type&quot;: &quot;ACText&quot;,</span>
  578. <span style="color: #e6db74"> &quot;value&quot;: &quot;AutoConnect has authorized&quot;,</span>
  579. <span style="color: #e6db74"> &quot;style&quot;: &quot;font-family:Arial;font-size:18px;font-weight:400;color:#191970&quot;</span>
  580. <span style="color: #e6db74"> }</span>
  581. <span style="color: #e6db74"> ]</span>
  582. <span style="color: #e6db74">}</span>
  583. <span style="color: #e6db74">)&quot;</span><span style="color: #f8f8f2">;</span>
  584. <span style="color: #f8f8f2">WebServerClass</span> <span style="color: #f8f8f2">server;</span>
  585. <span style="color: #f8f8f2">AutoConnect</span> <span style="color: #a6e22e">portal</span><span style="color: #f8f8f2">(server);</span>
  586. <span style="color: #f8f8f2">AutoConnectConfig</span> <span style="color: #f8f8f2">config;</span>
  587. <span style="color: #66d9ef">void</span> <span style="color: #a6e22e">setup</span><span style="color: #f8f8f2">()</span> <span style="color: #f8f8f2">{</span>
  588. <span style="color: #75715e">// It&#39;s a default value but has no meaning in the AC_AUTHSCOPE_PARTIAL setting.</span>
  589. <span style="color: #75715e">// config.auth = AC_AUTH_NONE;</span>
  590. <span style="background-color: #49483e"> <span style="color: #f8f8f2">config.authScope</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">AC_AUTHSCOPE_PARTIAL;</span>
  591. </span> <span style="color: #f8f8f2">config.username</span> <span style="color: #f92672">=</span> <span style="color: #e6db74">&quot;user&quot;</span><span style="color: #f8f8f2">;</span>
  592. <span style="color: #f8f8f2">config.password</span> <span style="color: #f92672">=</span> <span style="color: #e6db74">&quot;password&quot;</span><span style="color: #f8f8f2">;</span>
  593. <span style="color: #f8f8f2">portal.config(config);</span>
  594. <span style="color: #f8f8f2">portal.load(FPSTR(PAGE_HELLO));</span>
  595. <span style="color: #f8f8f2">portal.load(FPSTR(PAGE_AUTH));</span>
  596. <span style="color: #f8f8f2">portal.begin();</span>
  597. <span style="color: #f8f8f2">}</span>
  598. <span style="color: #66d9ef">void</span> <span style="color: #a6e22e">loop</span><span style="color: #f8f8f2">()</span> <span style="color: #f8f8f2">{</span>
  599. <span style="color: #f8f8f2">portal.handleClient();</span>
  600. <span style="color: #f8f8f2">}</span>
  601. </code></pre></div>
  602. <div class="admonition info">
  603. <p class="admonition-title">PageBuilder v1.4.0 or later needed</p>
  604. <p><a href="https://github.com/Hieromon/PageBuilder">PageBuilder</a> v1.4.0 or later is required to use HTTP authentication with AutoConnect. Also, v1.4.2 or later is required to eliminate SPIFFS, which is deprecated as a file system for ESP8266 module.</p>
  605. </div>
  606. <div class="admonition warning">
  607. <p class="admonition-title">Can not use DIGEST authentication for ESP32 arduino core 1.0.4 stable release</p>
  608. <p>For ESP32, Arduino core 1.0.4 stable has a bug for DIGEST authentication. The upstream of the master is recommended. (or use BASIC authentication)</p>
  609. </div>
  610. <h2 id="applying-http-authentication-for-built-in-ota">Applying HTTP authentication for Built-in OTA<a class="headerlink" href="#applying-http-authentication-for-built-in-ota" title="Permanent link">&para;</a></h2>
  611. <p><a href="apiconfig.html#auth"><em>AutoConnectConfig::auth</em></a> setting also affects the <a href="otaupdate.html">built-in OTA</a> feature. <strong>AC_AUTH_BASIC</strong> or <strong>AC_AUTH_DIGEST</strong> setting allows Built-in OTA to authenticate with the <a href="otabrowser.html#updates-with-the-web-browserupdated-wv115">UPDATE</a> page. This setting is valid even if <a href="apiconfig.html#authscope"><em>AutoConnectConfig::authScope</em></a> is <strong>AC_AUTHSCOPE_PARTIAL</strong>. That is if the AutoConnectConfig::auth setting is BASIC or DIGEST, authentication will be required for Built-in OTA.</p>
  612. <h2 id="authentication-within-the-captive-portal-state">Authentication within the captive portal state<a class="headerlink" href="#authentication-within-the-captive-portal-state" title="Permanent link">&para;</a></h2>
  613. <p>When accessing the ESP module from an iOS or Android device in the captive portal state, the HTTP authentication framework is disabled in the OS of the client device. Even if the ESP module responds with a <code>401 unauthorized</code> with <code>WWW-Authenticate</code>, those client device OSs under the captive portal do not display the login dialog and deprive the user of the opportunity to enter their credentials. There will always be an unauthorized error.</p>
  614. <p>AutoConnect's authentication operation based on HTTP (not HTTPS) depends on the OS of the client device, so in the captive portal state, most devices will unconditionally result in an authentication error. Therefore, the default authentication behavior of AutoConnect does not apply authentication in the captive portal state. (It will be ignored even if the AutoConnect setting is not AC_AUTH_NONE)</p>
  615. <p>However, if you want to deny unauthorized access to the protected page even in the captive portal state, you can use the extension bit of <a href="apiconfig.html#authScope"><em>AutoConnectConfig::authScope</em></a>. The <strong>AC_AUTHSCOPE_WITHCP</strong> flag allows AutoConnect to authentication in the captive portal state. It is set using a logical OR operator for the <a href="apiconfig.html#authScope"><em>AutoConnectConfig::authScope</em></a> setting and AutoConnect will enable authentication at the captive portal if the <strong>AC_AUTHSCOPE_WITHCP</strong> is ON.</p>
  616. <div class="highlight" style="background: #272822"><pre style="line-height: 125%; margin: 0;"><span></span><code><span style="color: #f8f8f2">AutoConnectConfig</span> <span style="color: #f8f8f2">config;</span>
  617. <span style="color: #f8f8f2">...</span>
  618. <span style="color: #f8f8f2">config.auth</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">AC_AUTH_DIGEST;</span>
  619. <span style="background-color: #49483e"><span style="color: #f8f8f2">config.authScope</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">AC_AUTHSCOPE_AUX</span> <span style="color: #f92672">|</span> <span style="color: #f8f8f2">AC_AUTHSCOPE_WITHCP;</span>
  620. </span><span style="color: #f8f8f2">...</span>
  621. </code></pre></div>
  622. <div class="footnote">
  623. <hr />
  624. <ol>
  625. <li id="fn:1">
  626. <p>ESP32 Arduino core has the authenticate method provided by the WebServer library, similar to that of the ESP8266.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
  627. </li>
  628. <li id="fn:2">
  629. <p>The default user name and password for authentication inherits the setting of <a href="apiconfig.html#apid">AutoConnectConfig::apid</a> and <a href="apiconfig.html#psk">AutoConnectConfig::psk</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
  630. </li>
  631. </ol>
  632. </div>
  633. </article>
  634. </div>
  635. </div>
  636. </main>
  637. <footer class="md-footer">
  638. <div class="md-footer-nav">
  639. <nav class="md-footer-nav__inner md-grid" aria-label="Footer">
  640. <a href="adnetwork.html" class="md-footer-nav__link md-footer-nav__link--prev" rel="prev">
  641. <div class="md-footer-nav__button md-icon">
  642. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
  643. </div>
  644. <div class="md-footer-nav__title">
  645. <div class="md-ellipsis">
  646. <span class="md-footer-nav__direction">
  647. Previous
  648. </span>
  649. Settings and controls for network and WiFi
  650. </div>
  651. </div>
  652. </a>
  653. <a href="adcredential.html" class="md-footer-nav__link md-footer-nav__link--next" rel="next">
  654. <div class="md-footer-nav__title">
  655. <div class="md-ellipsis">
  656. <span class="md-footer-nav__direction">
  657. Next
  658. </span>
  659. Credential accesses
  660. </div>
  661. </div>
  662. <div class="md-footer-nav__button md-icon">
  663. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4z"/></svg>
  664. </div>
  665. </a>
  666. </nav>
  667. </div>
  668. <div class="md-footer-meta md-typeset">
  669. <div class="md-footer-meta__inner md-grid">
  670. <div class="md-footer-copyright">
  671. <div class="md-footer-copyright__highlight">
  672. Copyright &copy; 2018-2020 Hieromon Ikasamo
  673. </div>
  674. Made with
  675. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  676. Material for MkDocs
  677. </a>
  678. </div>
  679. <div class="md-footer-social">
  680. <a href="https://github.com/Hieromon" target="_blank" rel="noopener" title="github.com" class="md-footer-social__link">
  681. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
  682. </a>
  683. <a href="https://twitter.com/hieromon" target="_blank" rel="noopener" title="twitter.com" class="md-footer-social__link">
  684. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"/></svg>
  685. </a>
  686. </div>
  687. </div>
  688. </div>
  689. </footer>
  690. </div>
  691. <script src="assets/javascripts/vendor.fd16492e.min.js"></script>
  692. <script src="assets/javascripts/bundle.7836ba4d.min.js"></script><script id="__lang" type="application/json">{"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.placeholder": "Search", "search.result.placeholder": "Type to start searching", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing"}</script>
  693. <script>
  694. app = initialize({
  695. base: ".",
  696. features: [],
  697. search: Object.assign({
  698. worker: "assets/javascripts/worker/search.4ac00218.min.js"
  699. }, typeof search !== "undefined" && search)
  700. })
  701. </script>
  702. <script src="js/gifffer.min.js"></script>
  703. </body>
  704. </html>