From f6f3bbc2709bff3f886f1bb3e71c19b786d51336 Mon Sep 17 00:00:00 2001 From: fastapi-users-ci Date: Mon, 16 Jan 2023 10:52:07 +0000 Subject: [PATCH] Deployed 0e975c9 to 10.3 with MkDocs 1.4.2 and mike 1.1.2 --- 10.3/404.html | 1137 +++ 10.3/assets/images/favicon.png | Bin 0 -> 1870 bytes .../assets/javascripts/bundle.51d95adb.min.js | 29 + .../javascripts/bundle.51d95adb.min.js.map | 8 + .../javascripts/lunr/min/lunr.ar.min.js | 1 + .../javascripts/lunr/min/lunr.da.min.js | 18 + .../javascripts/lunr/min/lunr.de.min.js | 18 + .../javascripts/lunr/min/lunr.du.min.js | 18 + .../javascripts/lunr/min/lunr.es.min.js | 18 + .../javascripts/lunr/min/lunr.fi.min.js | 18 + .../javascripts/lunr/min/lunr.fr.min.js | 18 + .../javascripts/lunr/min/lunr.hi.min.js | 1 + .../javascripts/lunr/min/lunr.hu.min.js | 18 + .../javascripts/lunr/min/lunr.it.min.js | 18 + .../javascripts/lunr/min/lunr.ja.min.js | 1 + .../javascripts/lunr/min/lunr.jp.min.js | 1 + .../javascripts/lunr/min/lunr.ko.min.js | 1 + .../javascripts/lunr/min/lunr.multi.min.js | 1 + .../javascripts/lunr/min/lunr.nl.min.js | 18 + .../javascripts/lunr/min/lunr.no.min.js | 18 + .../javascripts/lunr/min/lunr.pt.min.js | 18 + .../javascripts/lunr/min/lunr.ro.min.js | 18 + .../javascripts/lunr/min/lunr.ru.min.js | 18 + .../lunr/min/lunr.stemmer.support.min.js | 1 + .../javascripts/lunr/min/lunr.sv.min.js | 18 + .../javascripts/lunr/min/lunr.ta.min.js | 1 + .../javascripts/lunr/min/lunr.th.min.js | 1 + .../javascripts/lunr/min/lunr.tr.min.js | 18 + .../javascripts/lunr/min/lunr.vi.min.js | 1 + .../javascripts/lunr/min/lunr.zh.min.js | 1 + 10.3/assets/javascripts/lunr/tinyseg.js | 206 + 10.3/assets/javascripts/lunr/wordcut.js | 6708 +++++++++++++++++ .../workers/search.e5c33ebb.min.js | 42 + .../workers/search.e5c33ebb.min.js.map | 8 + 10.3/assets/stylesheets/main.558e4712.min.css | 1 + .../stylesheets/main.558e4712.min.css.map | 1 + .../stylesheets/palette.2505c338.min.css | 1 + .../stylesheets/palette.2505c338.min.css.map | 1 + .../authentication/backend/index.html | 1242 +++ 10.3/configuration/authentication/index.html | 1431 ++++ .../strategies/database/index.html | 1457 ++++ .../authentication/strategies/jwt/index.html | 1290 ++++ .../strategies/redis/index.html | 1273 ++++ .../transports/bearer/index.html | 1290 ++++ .../transports/cookie/index.html | 1295 ++++ .../configuration/databases/beanie/index.html | 1363 ++++ .../databases/sqlalchemy/index.html | 1394 ++++ 10.3/configuration/full-example/index.html | 1590 ++++ 10.3/configuration/oauth/index.html | 1955 +++++ 10.3/configuration/overview/index.html | 1345 ++++ 10.3/configuration/password-hash/index.html | 1272 ++++ 10.3/configuration/routers/auth/index.html | 1273 ++++ 10.3/configuration/routers/index.html | 1270 ++++ .../configuration/routers/register/index.html | 1240 +++ 10.3/configuration/routers/reset/index.html | 1239 +++ 10.3/configuration/routers/users/index.html | 1273 ++++ 10.3/configuration/routers/verify/index.html | 1243 +++ 10.3/configuration/schemas/index.html | 1305 ++++ 10.3/configuration/user-manager/index.html | 1781 +++++ .../create-user-programmatically/index.html | 1318 ++++ 10.3/favicon.png | Bin 0 -> 1648 bytes 10.3/index.html | 1520 ++++ 10.3/installation/index.html | 1268 ++++ 10.3/migration/08_to_1x/index.html | 1572 ++++ 10.3/migration/1x_to_2x/index.html | 1229 +++ 10.3/migration/2x_to_3x/index.html | 1222 +++ 10.3/migration/3x_to_4x/index.html | 1218 +++ 10.3/migration/4x_to_5x/index.html | 1218 +++ 10.3/migration/6x_to_7x/index.html | 1180 +++ 10.3/migration/7x_to_8x/index.html | 1330 ++++ 10.3/migration/8x_to_9x/index.html | 1427 ++++ 10.3/migration/9x_to_10x/index.html | 1644 ++++ 10.3/search/search_index.json | 1 + 10.3/sitemap.xml | 183 + 10.3/sitemap.xml.gz | Bin 0 -> 218 bytes .../cookbook_create_user_programmatically.py | 25 + 10.3/src/db_beanie.py | 17 + 10.3/src/db_beanie_access_tokens.py | 29 + 10.3/src/db_beanie_oauth.py | 24 + 10.3/src/db_sqlalchemy.py | 31 + 10.3/src/db_sqlalchemy_access_tokens.py | 45 + 10.3/src/db_sqlalchemy_oauth.py | 39 + 10.3/src/user_manager.py | 31 + 10.3/usage/current-user/index.html | 1428 ++++ 10.3/usage/flow/index.html | 2116 ++++++ 10.3/usage/routes/index.html | 2080 +++++ latest/404.html | 6 +- .../authentication/backend/index.html | 6 +- .../configuration/authentication/index.html | 6 +- .../strategies/database/index.html | 6 +- .../authentication/strategies/jwt/index.html | 6 +- .../strategies/redis/index.html | 6 +- .../transports/bearer/index.html | 6 +- .../transports/cookie/index.html | 6 +- .../configuration/databases/beanie/index.html | 6 +- .../databases/sqlalchemy/index.html | 6 +- latest/configuration/full-example/index.html | 6 +- latest/configuration/oauth/index.html | 6 +- latest/configuration/overview/index.html | 6 +- latest/configuration/password-hash/index.html | 6 +- latest/configuration/routers/auth/index.html | 6 +- latest/configuration/routers/index.html | 6 +- .../configuration/routers/register/index.html | 6 +- latest/configuration/routers/reset/index.html | 6 +- latest/configuration/routers/users/index.html | 6 +- .../configuration/routers/verify/index.html | 6 +- latest/configuration/schemas/index.html | 6 +- latest/configuration/user-manager/index.html | 6 +- .../create-user-programmatically/index.html | 6 +- latest/index.html | 6 +- latest/installation/index.html | 6 +- latest/migration/08_to_1x/index.html | 6 +- latest/migration/1x_to_2x/index.html | 6 +- latest/migration/2x_to_3x/index.html | 6 +- latest/migration/3x_to_4x/index.html | 6 +- latest/migration/4x_to_5x/index.html | 6 +- latest/migration/6x_to_7x/index.html | 6 +- latest/migration/7x_to_8x/index.html | 6 +- latest/migration/8x_to_9x/index.html | 6 +- latest/migration/9x_to_10x/index.html | 6 +- latest/usage/current-user/index.html | 6 +- latest/usage/flow/index.html | 6 +- latest/usage/routes/index.html | 6 +- versions.json | 2 +- 124 files changed, 59551 insertions(+), 112 deletions(-) create mode 100644 10.3/404.html create mode 100644 10.3/assets/images/favicon.png create mode 100644 10.3/assets/javascripts/bundle.51d95adb.min.js create mode 100644 10.3/assets/javascripts/bundle.51d95adb.min.js.map create mode 100644 10.3/assets/javascripts/lunr/min/lunr.ar.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.da.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.de.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.du.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.es.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.fi.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.fr.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.hi.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.hu.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.it.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.ja.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.jp.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.ko.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.multi.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.nl.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.no.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.pt.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.ro.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.ru.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.stemmer.support.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.sv.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.ta.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.th.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.tr.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.vi.min.js create mode 100644 10.3/assets/javascripts/lunr/min/lunr.zh.min.js create mode 100644 10.3/assets/javascripts/lunr/tinyseg.js create mode 100644 10.3/assets/javascripts/lunr/wordcut.js create mode 100644 10.3/assets/javascripts/workers/search.e5c33ebb.min.js create mode 100644 10.3/assets/javascripts/workers/search.e5c33ebb.min.js.map create mode 100644 10.3/assets/stylesheets/main.558e4712.min.css create mode 100644 10.3/assets/stylesheets/main.558e4712.min.css.map create mode 100644 10.3/assets/stylesheets/palette.2505c338.min.css create mode 100644 10.3/assets/stylesheets/palette.2505c338.min.css.map create mode 100644 10.3/configuration/authentication/backend/index.html create mode 100644 10.3/configuration/authentication/index.html create mode 100644 10.3/configuration/authentication/strategies/database/index.html create mode 100644 10.3/configuration/authentication/strategies/jwt/index.html create mode 100644 10.3/configuration/authentication/strategies/redis/index.html create mode 100644 10.3/configuration/authentication/transports/bearer/index.html create mode 100644 10.3/configuration/authentication/transports/cookie/index.html create mode 100644 10.3/configuration/databases/beanie/index.html create mode 100644 10.3/configuration/databases/sqlalchemy/index.html create mode 100644 10.3/configuration/full-example/index.html create mode 100644 10.3/configuration/oauth/index.html create mode 100644 10.3/configuration/overview/index.html create mode 100644 10.3/configuration/password-hash/index.html create mode 100644 10.3/configuration/routers/auth/index.html create mode 100644 10.3/configuration/routers/index.html create mode 100644 10.3/configuration/routers/register/index.html create mode 100644 10.3/configuration/routers/reset/index.html create mode 100644 10.3/configuration/routers/users/index.html create mode 100644 10.3/configuration/routers/verify/index.html create mode 100644 10.3/configuration/schemas/index.html create mode 100644 10.3/configuration/user-manager/index.html create mode 100644 10.3/cookbook/create-user-programmatically/index.html create mode 100644 10.3/favicon.png create mode 100644 10.3/index.html create mode 100644 10.3/installation/index.html create mode 100644 10.3/migration/08_to_1x/index.html create mode 100644 10.3/migration/1x_to_2x/index.html create mode 100644 10.3/migration/2x_to_3x/index.html create mode 100644 10.3/migration/3x_to_4x/index.html create mode 100644 10.3/migration/4x_to_5x/index.html create mode 100644 10.3/migration/6x_to_7x/index.html create mode 100644 10.3/migration/7x_to_8x/index.html create mode 100644 10.3/migration/8x_to_9x/index.html create mode 100644 10.3/migration/9x_to_10x/index.html create mode 100644 10.3/search/search_index.json create mode 100644 10.3/sitemap.xml create mode 100644 10.3/sitemap.xml.gz create mode 100644 10.3/src/cookbook_create_user_programmatically.py create mode 100644 10.3/src/db_beanie.py create mode 100644 10.3/src/db_beanie_access_tokens.py create mode 100644 10.3/src/db_beanie_oauth.py create mode 100644 10.3/src/db_sqlalchemy.py create mode 100644 10.3/src/db_sqlalchemy_access_tokens.py create mode 100644 10.3/src/db_sqlalchemy_oauth.py create mode 100644 10.3/src/user_manager.py create mode 100644 10.3/usage/current-user/index.html create mode 100644 10.3/usage/flow/index.html create mode 100644 10.3/usage/routes/index.html diff --git a/10.3/404.html b/10.3/404.html new file mode 100644 index 00000000..1afe7819 --- /dev/null +++ b/10.3/404.html @@ -0,0 +1,1137 @@ + + + + + + + + + + + + + + + + + + + + FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ +

404 - Not found

+ +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/assets/images/favicon.png b/10.3/assets/images/favicon.png new file mode 100644 index 0000000000000000000000000000000000000000..1cf13b9f9d978896599290a74f77d5dbe7d1655c GIT binary patch literal 1870 zcmV-U2eJ5xP)Gc)JR9QMau)O=X#!i9;T z37kk-upj^(fsR36MHs_+1RCI)NNu9}lD0S{B^g8PN?Ww(5|~L#Ng*g{WsqleV}|#l zz8@ri&cTzw_h33bHI+12+kK6WN$h#n5cD8OQt`5kw6p~9H3()bUQ8OS4Q4HTQ=1Ol z_JAocz`fLbT2^{`8n~UAo=#AUOf=SOq4pYkt;XbC&f#7lb$*7=$na!mWCQ`dBQsO0 zLFBSPj*N?#u5&pf2t4XjEGH|=pPQ8xh7tpx;US5Cx_Ju;!O`ya-yF`)b%TEt5>eP1ZX~}sjjA%FJF?h7cX8=b!DZl<6%Cv z*G0uvvU+vmnpLZ2paivG-(cd*y3$hCIcsZcYOGh{$&)A6*XX&kXZd3G8m)G$Zz-LV z^GF3VAW^Mdv!)4OM8EgqRiz~*Cji;uzl2uC9^=8I84vNp;ltJ|q-*uQwGp2ma6cY7 z;`%`!9UXO@fr&Ebapfs34OmS9^u6$)bJxrucutf>`dKPKT%%*d3XlFVKunp9 zasduxjrjs>f8V=D|J=XNZp;_Zy^WgQ$9WDjgY=z@stwiEBm9u5*|34&1Na8BMjjgf3+SHcr`5~>oz1Y?SW^=K z^bTyO6>Gar#P_W2gEMwq)ot3; zREHn~U&Dp0l6YT0&k-wLwYjb?5zGK`W6S2v+K>AM(95m2C20L|3m~rN8dprPr@t)5lsk9Hu*W z?pS990s;Ez=+Rj{x7p``4>+c0G5^pYnB1^!TL=(?HLHZ+HicG{~4F1d^5Awl_2!1jICM-!9eoLhbbT^;yHcefyTAaqRcY zmuctDopPT!%k+}x%lZRKnzykr2}}XfG_ne?nRQO~?%hkzo;@RN{P6o`&mMUWBYMTe z6i8ChtjX&gXl`nvrU>jah)2iNM%JdjqoaeaU%yVn!^70x-flljp6Q5tK}5}&X8&&G zX3fpb3E(!rH=zVI_9Gjl45w@{(ITqngWFe7@9{mX;tO25Z_8 zQHEpI+FkTU#4xu>RkN>b3Tnc3UpWzPXWm#o55GKF09j^Mh~)K7{QqbO_~(@CVq! zS<8954|P8mXN2MRs86xZ&Q4EfM@JB94b=(YGuk)s&^jiSF=t3*oNK3`rD{H`yQ?d; ztE=laAUoZx5?RC8*WKOj`%LXEkgDd>&^Q4M^z`%u0rg-It=hLCVsq!Z%^6eB-OvOT zFZ28TN&cRmgU}Elrnk43)!>Z1FCPL2K$7}gwzIc48NX}#!A1BpJP?#v5wkNprhV** z?Cpalt1oH&{r!o3eSKc&ap)iz2BTn_VV`4>9M^b3;(YY}4>#ML6{~(4mH+?%07*qo IM6N<$f(jP3KmY&$ literal 0 HcmV?d00001 diff --git a/10.3/assets/javascripts/bundle.51d95adb.min.js b/10.3/assets/javascripts/bundle.51d95adb.min.js new file mode 100644 index 00000000..b20ec683 --- /dev/null +++ b/10.3/assets/javascripts/bundle.51d95adb.min.js @@ -0,0 +1,29 @@ +"use strict";(()=>{var Hi=Object.create;var xr=Object.defineProperty;var Pi=Object.getOwnPropertyDescriptor;var $i=Object.getOwnPropertyNames,kt=Object.getOwnPropertySymbols,Ii=Object.getPrototypeOf,Er=Object.prototype.hasOwnProperty,an=Object.prototype.propertyIsEnumerable;var on=(e,t,r)=>t in e?xr(e,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[t]=r,P=(e,t)=>{for(var r in t||(t={}))Er.call(t,r)&&on(e,r,t[r]);if(kt)for(var r of kt(t))an.call(t,r)&&on(e,r,t[r]);return e};var sn=(e,t)=>{var r={};for(var n in e)Er.call(e,n)&&t.indexOf(n)<0&&(r[n]=e[n]);if(e!=null&&kt)for(var n of kt(e))t.indexOf(n)<0&&an.call(e,n)&&(r[n]=e[n]);return r};var Ht=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports);var Fi=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of $i(t))!Er.call(e,o)&&o!==r&&xr(e,o,{get:()=>t[o],enumerable:!(n=Pi(t,o))||n.enumerable});return e};var yt=(e,t,r)=>(r=e!=null?Hi(Ii(e)):{},Fi(t||!e||!e.__esModule?xr(r,"default",{value:e,enumerable:!0}):r,e));var fn=Ht((wr,cn)=>{(function(e,t){typeof wr=="object"&&typeof cn!="undefined"?t():typeof define=="function"&&define.amd?define(t):t()})(wr,function(){"use strict";function e(r){var n=!0,o=!1,i=null,a={text:!0,search:!0,url:!0,tel:!0,email:!0,password:!0,number:!0,date:!0,month:!0,week:!0,time:!0,datetime:!0,"datetime-local":!0};function s(T){return!!(T&&T!==document&&T.nodeName!=="HTML"&&T.nodeName!=="BODY"&&"classList"in T&&"contains"in T.classList)}function f(T){var Ke=T.type,We=T.tagName;return!!(We==="INPUT"&&a[Ke]&&!T.readOnly||We==="TEXTAREA"&&!T.readOnly||T.isContentEditable)}function c(T){T.classList.contains("focus-visible")||(T.classList.add("focus-visible"),T.setAttribute("data-focus-visible-added",""))}function u(T){T.hasAttribute("data-focus-visible-added")&&(T.classList.remove("focus-visible"),T.removeAttribute("data-focus-visible-added"))}function p(T){T.metaKey||T.altKey||T.ctrlKey||(s(r.activeElement)&&c(r.activeElement),n=!0)}function m(T){n=!1}function d(T){s(T.target)&&(n||f(T.target))&&c(T.target)}function h(T){s(T.target)&&(T.target.classList.contains("focus-visible")||T.target.hasAttribute("data-focus-visible-added"))&&(o=!0,window.clearTimeout(i),i=window.setTimeout(function(){o=!1},100),u(T.target))}function v(T){document.visibilityState==="hidden"&&(o&&(n=!0),B())}function B(){document.addEventListener("mousemove",z),document.addEventListener("mousedown",z),document.addEventListener("mouseup",z),document.addEventListener("pointermove",z),document.addEventListener("pointerdown",z),document.addEventListener("pointerup",z),document.addEventListener("touchmove",z),document.addEventListener("touchstart",z),document.addEventListener("touchend",z)}function re(){document.removeEventListener("mousemove",z),document.removeEventListener("mousedown",z),document.removeEventListener("mouseup",z),document.removeEventListener("pointermove",z),document.removeEventListener("pointerdown",z),document.removeEventListener("pointerup",z),document.removeEventListener("touchmove",z),document.removeEventListener("touchstart",z),document.removeEventListener("touchend",z)}function z(T){T.target.nodeName&&T.target.nodeName.toLowerCase()==="html"||(n=!1,re())}document.addEventListener("keydown",p,!0),document.addEventListener("mousedown",m,!0),document.addEventListener("pointerdown",m,!0),document.addEventListener("touchstart",m,!0),document.addEventListener("visibilitychange",v,!0),B(),r.addEventListener("focus",d,!0),r.addEventListener("blur",h,!0),r.nodeType===Node.DOCUMENT_FRAGMENT_NODE&&r.host?r.host.setAttribute("data-js-focus-visible",""):r.nodeType===Node.DOCUMENT_NODE&&(document.documentElement.classList.add("js-focus-visible"),document.documentElement.setAttribute("data-js-focus-visible",""))}if(typeof window!="undefined"&&typeof document!="undefined"){window.applyFocusVisiblePolyfill=e;var t;try{t=new CustomEvent("focus-visible-polyfill-ready")}catch(r){t=document.createEvent("CustomEvent"),t.initCustomEvent("focus-visible-polyfill-ready",!1,!1,{})}window.dispatchEvent(t)}typeof document!="undefined"&&e(document)})});var un=Ht(Sr=>{(function(e){var t=function(){try{return!!Symbol.iterator}catch(c){return!1}},r=t(),n=function(c){var u={next:function(){var p=c.shift();return{done:p===void 0,value:p}}};return r&&(u[Symbol.iterator]=function(){return u}),u},o=function(c){return encodeURIComponent(c).replace(/%20/g,"+")},i=function(c){return decodeURIComponent(String(c).replace(/\+/g," "))},a=function(){var c=function(p){Object.defineProperty(this,"_entries",{writable:!0,value:{}});var m=typeof p;if(m!=="undefined")if(m==="string")p!==""&&this._fromString(p);else if(p instanceof c){var d=this;p.forEach(function(re,z){d.append(z,re)})}else if(p!==null&&m==="object")if(Object.prototype.toString.call(p)==="[object Array]")for(var h=0;hd[0]?1:0}),c._entries&&(c._entries={});for(var p=0;p1?i(d[1]):"")}})})(typeof global!="undefined"?global:typeof window!="undefined"?window:typeof self!="undefined"?self:Sr);(function(e){var t=function(){try{var o=new e.URL("b","http://a");return o.pathname="c d",o.href==="http://a/c%20d"&&o.searchParams}catch(i){return!1}},r=function(){var o=e.URL,i=function(f,c){typeof f!="string"&&(f=String(f)),c&&typeof c!="string"&&(c=String(c));var u=document,p;if(c&&(e.location===void 0||c!==e.location.href)){c=c.toLowerCase(),u=document.implementation.createHTMLDocument(""),p=u.createElement("base"),p.href=c,u.head.appendChild(p);try{if(p.href.indexOf(c)!==0)throw new Error(p.href)}catch(T){throw new Error("URL unable to set base "+c+" due to "+T)}}var m=u.createElement("a");m.href=f,p&&(u.body.appendChild(m),m.href=m.href);var d=u.createElement("input");if(d.type="url",d.value=f,m.protocol===":"||!/:/.test(m.href)||!d.checkValidity()&&!c)throw new TypeError("Invalid URL");Object.defineProperty(this,"_anchorElement",{value:m});var h=new e.URLSearchParams(this.search),v=!0,B=!0,re=this;["append","delete","set"].forEach(function(T){var Ke=h[T];h[T]=function(){Ke.apply(h,arguments),v&&(B=!1,re.search=h.toString(),B=!0)}}),Object.defineProperty(this,"searchParams",{value:h,enumerable:!0});var z=void 0;Object.defineProperty(this,"_updateSearchParams",{enumerable:!1,configurable:!1,writable:!1,value:function(){this.search!==z&&(z=this.search,B&&(v=!1,this.searchParams._fromString(this.search),v=!0))}})},a=i.prototype,s=function(f){Object.defineProperty(a,f,{get:function(){return this._anchorElement[f]},set:function(c){this._anchorElement[f]=c},enumerable:!0})};["hash","host","hostname","port","protocol"].forEach(function(f){s(f)}),Object.defineProperty(a,"search",{get:function(){return this._anchorElement.search},set:function(f){this._anchorElement.search=f,this._updateSearchParams()},enumerable:!0}),Object.defineProperties(a,{toString:{get:function(){var f=this;return function(){return f.href}}},href:{get:function(){return this._anchorElement.href.replace(/\?$/,"")},set:function(f){this._anchorElement.href=f,this._updateSearchParams()},enumerable:!0},pathname:{get:function(){return this._anchorElement.pathname.replace(/(^\/?)/,"/")},set:function(f){this._anchorElement.pathname=f},enumerable:!0},origin:{get:function(){var f={"http:":80,"https:":443,"ftp:":21}[this._anchorElement.protocol],c=this._anchorElement.port!=f&&this._anchorElement.port!=="";return this._anchorElement.protocol+"//"+this._anchorElement.hostname+(c?":"+this._anchorElement.port:"")},enumerable:!0},password:{get:function(){return""},set:function(f){},enumerable:!0},username:{get:function(){return""},set:function(f){},enumerable:!0}}),i.createObjectURL=function(f){return o.createObjectURL.apply(o,arguments)},i.revokeObjectURL=function(f){return o.revokeObjectURL.apply(o,arguments)},e.URL=i};if(t()||r(),e.location!==void 0&&!("origin"in e.location)){var n=function(){return e.location.protocol+"//"+e.location.hostname+(e.location.port?":"+e.location.port:"")};try{Object.defineProperty(e.location,"origin",{get:n,enumerable:!0})}catch(o){setInterval(function(){e.location.origin=n()},100)}}})(typeof global!="undefined"?global:typeof window!="undefined"?window:typeof self!="undefined"?self:Sr)});var Qr=Ht((Lt,Kr)=>{/*! + * clipboard.js v2.0.11 + * https://clipboardjs.com/ + * + * Licensed MIT © Zeno Rocha + */(function(t,r){typeof Lt=="object"&&typeof Kr=="object"?Kr.exports=r():typeof define=="function"&&define.amd?define([],r):typeof Lt=="object"?Lt.ClipboardJS=r():t.ClipboardJS=r()})(Lt,function(){return function(){var e={686:function(n,o,i){"use strict";i.d(o,{default:function(){return ki}});var a=i(279),s=i.n(a),f=i(370),c=i.n(f),u=i(817),p=i.n(u);function m(j){try{return document.execCommand(j)}catch(O){return!1}}var d=function(O){var w=p()(O);return m("cut"),w},h=d;function v(j){var O=document.documentElement.getAttribute("dir")==="rtl",w=document.createElement("textarea");w.style.fontSize="12pt",w.style.border="0",w.style.padding="0",w.style.margin="0",w.style.position="absolute",w.style[O?"right":"left"]="-9999px";var k=window.pageYOffset||document.documentElement.scrollTop;return w.style.top="".concat(k,"px"),w.setAttribute("readonly",""),w.value=j,w}var B=function(O,w){var k=v(O);w.container.appendChild(k);var F=p()(k);return m("copy"),k.remove(),F},re=function(O){var w=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body},k="";return typeof O=="string"?k=B(O,w):O instanceof HTMLInputElement&&!["text","search","url","tel","password"].includes(O==null?void 0:O.type)?k=B(O.value,w):(k=p()(O),m("copy")),k},z=re;function T(j){return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?T=function(w){return typeof w}:T=function(w){return w&&typeof Symbol=="function"&&w.constructor===Symbol&&w!==Symbol.prototype?"symbol":typeof w},T(j)}var Ke=function(){var O=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{},w=O.action,k=w===void 0?"copy":w,F=O.container,q=O.target,Le=O.text;if(k!=="copy"&&k!=="cut")throw new Error('Invalid "action" value, use either "copy" or "cut"');if(q!==void 0)if(q&&T(q)==="object"&&q.nodeType===1){if(k==="copy"&&q.hasAttribute("disabled"))throw new Error('Invalid "target" attribute. Please use "readonly" instead of "disabled" attribute');if(k==="cut"&&(q.hasAttribute("readonly")||q.hasAttribute("disabled")))throw new Error(`Invalid "target" attribute. You can't cut text from elements with "readonly" or "disabled" attributes`)}else throw new Error('Invalid "target" value, use a valid Element');if(Le)return z(Le,{container:F});if(q)return k==="cut"?h(q):z(q,{container:F})},We=Ke;function Ie(j){return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?Ie=function(w){return typeof w}:Ie=function(w){return w&&typeof Symbol=="function"&&w.constructor===Symbol&&w!==Symbol.prototype?"symbol":typeof w},Ie(j)}function Ti(j,O){if(!(j instanceof O))throw new TypeError("Cannot call a class as a function")}function nn(j,O){for(var w=0;w0&&arguments[0]!==void 0?arguments[0]:{};this.action=typeof F.action=="function"?F.action:this.defaultAction,this.target=typeof F.target=="function"?F.target:this.defaultTarget,this.text=typeof F.text=="function"?F.text:this.defaultText,this.container=Ie(F.container)==="object"?F.container:document.body}},{key:"listenClick",value:function(F){var q=this;this.listener=c()(F,"click",function(Le){return q.onClick(Le)})}},{key:"onClick",value:function(F){var q=F.delegateTarget||F.currentTarget,Le=this.action(q)||"copy",Rt=We({action:Le,container:this.container,target:this.target(q),text:this.text(q)});this.emit(Rt?"success":"error",{action:Le,text:Rt,trigger:q,clearSelection:function(){q&&q.focus(),window.getSelection().removeAllRanges()}})}},{key:"defaultAction",value:function(F){return yr("action",F)}},{key:"defaultTarget",value:function(F){var q=yr("target",F);if(q)return document.querySelector(q)}},{key:"defaultText",value:function(F){return yr("text",F)}},{key:"destroy",value:function(){this.listener.destroy()}}],[{key:"copy",value:function(F){var q=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body};return z(F,q)}},{key:"cut",value:function(F){return h(F)}},{key:"isSupported",value:function(){var F=arguments.length>0&&arguments[0]!==void 0?arguments[0]:["copy","cut"],q=typeof F=="string"?[F]:F,Le=!!document.queryCommandSupported;return q.forEach(function(Rt){Le=Le&&!!document.queryCommandSupported(Rt)}),Le}}]),w}(s()),ki=Ri},828:function(n){var o=9;if(typeof Element!="undefined"&&!Element.prototype.matches){var i=Element.prototype;i.matches=i.matchesSelector||i.mozMatchesSelector||i.msMatchesSelector||i.oMatchesSelector||i.webkitMatchesSelector}function a(s,f){for(;s&&s.nodeType!==o;){if(typeof s.matches=="function"&&s.matches(f))return s;s=s.parentNode}}n.exports=a},438:function(n,o,i){var a=i(828);function s(u,p,m,d,h){var v=c.apply(this,arguments);return u.addEventListener(m,v,h),{destroy:function(){u.removeEventListener(m,v,h)}}}function f(u,p,m,d,h){return typeof u.addEventListener=="function"?s.apply(null,arguments):typeof m=="function"?s.bind(null,document).apply(null,arguments):(typeof u=="string"&&(u=document.querySelectorAll(u)),Array.prototype.map.call(u,function(v){return s(v,p,m,d,h)}))}function c(u,p,m,d){return function(h){h.delegateTarget=a(h.target,p),h.delegateTarget&&d.call(u,h)}}n.exports=f},879:function(n,o){o.node=function(i){return i!==void 0&&i instanceof HTMLElement&&i.nodeType===1},o.nodeList=function(i){var a=Object.prototype.toString.call(i);return i!==void 0&&(a==="[object NodeList]"||a==="[object HTMLCollection]")&&"length"in i&&(i.length===0||o.node(i[0]))},o.string=function(i){return typeof i=="string"||i instanceof String},o.fn=function(i){var a=Object.prototype.toString.call(i);return a==="[object Function]"}},370:function(n,o,i){var a=i(879),s=i(438);function f(m,d,h){if(!m&&!d&&!h)throw new Error("Missing required arguments");if(!a.string(d))throw new TypeError("Second argument must be a String");if(!a.fn(h))throw new TypeError("Third argument must be a Function");if(a.node(m))return c(m,d,h);if(a.nodeList(m))return u(m,d,h);if(a.string(m))return p(m,d,h);throw new TypeError("First argument must be a String, HTMLElement, HTMLCollection, or NodeList")}function c(m,d,h){return m.addEventListener(d,h),{destroy:function(){m.removeEventListener(d,h)}}}function u(m,d,h){return Array.prototype.forEach.call(m,function(v){v.addEventListener(d,h)}),{destroy:function(){Array.prototype.forEach.call(m,function(v){v.removeEventListener(d,h)})}}}function p(m,d,h){return s(document.body,m,d,h)}n.exports=f},817:function(n){function o(i){var a;if(i.nodeName==="SELECT")i.focus(),a=i.value;else if(i.nodeName==="INPUT"||i.nodeName==="TEXTAREA"){var s=i.hasAttribute("readonly");s||i.setAttribute("readonly",""),i.select(),i.setSelectionRange(0,i.value.length),s||i.removeAttribute("readonly"),a=i.value}else{i.hasAttribute("contenteditable")&&i.focus();var f=window.getSelection(),c=document.createRange();c.selectNodeContents(i),f.removeAllRanges(),f.addRange(c),a=f.toString()}return a}n.exports=o},279:function(n){function o(){}o.prototype={on:function(i,a,s){var f=this.e||(this.e={});return(f[i]||(f[i]=[])).push({fn:a,ctx:s}),this},once:function(i,a,s){var f=this;function c(){f.off(i,c),a.apply(s,arguments)}return c._=a,this.on(i,c,s)},emit:function(i){var a=[].slice.call(arguments,1),s=((this.e||(this.e={}))[i]||[]).slice(),f=0,c=s.length;for(f;f{"use strict";/*! + * escape-html + * Copyright(c) 2012-2013 TJ Holowaychuk + * Copyright(c) 2015 Andreas Lubbe + * Copyright(c) 2015 Tiancheng "Timothy" Gu + * MIT Licensed + */var is=/["'&<>]/;Jo.exports=as;function as(e){var t=""+e,r=is.exec(t);if(!r)return t;var n,o="",i=0,a=0;for(i=r.index;i0&&i[i.length-1])&&(c[0]===6||c[0]===2)){r=0;continue}if(c[0]===3&&(!i||c[1]>i[0]&&c[1]=e.length&&(e=void 0),{value:e&&e[n++],done:!e}}};throw new TypeError(t?"Object is not iterable.":"Symbol.iterator is not defined.")}function W(e,t){var r=typeof Symbol=="function"&&e[Symbol.iterator];if(!r)return e;var n=r.call(e),o,i=[],a;try{for(;(t===void 0||t-- >0)&&!(o=n.next()).done;)i.push(o.value)}catch(s){a={error:s}}finally{try{o&&!o.done&&(r=n.return)&&r.call(n)}finally{if(a)throw a.error}}return i}function D(e,t,r){if(r||arguments.length===2)for(var n=0,o=t.length,i;n1||s(m,d)})})}function s(m,d){try{f(n[m](d))}catch(h){p(i[0][3],h)}}function f(m){m.value instanceof Xe?Promise.resolve(m.value.v).then(c,u):p(i[0][2],m)}function c(m){s("next",m)}function u(m){s("throw",m)}function p(m,d){m(d),i.shift(),i.length&&s(i[0][0],i[0][1])}}function mn(e){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var t=e[Symbol.asyncIterator],r;return t?t.call(e):(e=typeof xe=="function"?xe(e):e[Symbol.iterator](),r={},n("next"),n("throw"),n("return"),r[Symbol.asyncIterator]=function(){return this},r);function n(i){r[i]=e[i]&&function(a){return new Promise(function(s,f){a=e[i](a),o(s,f,a.done,a.value)})}}function o(i,a,s,f){Promise.resolve(f).then(function(c){i({value:c,done:s})},a)}}function A(e){return typeof e=="function"}function at(e){var t=function(n){Error.call(n),n.stack=new Error().stack},r=e(t);return r.prototype=Object.create(Error.prototype),r.prototype.constructor=r,r}var $t=at(function(e){return function(r){e(this),this.message=r?r.length+` errors occurred during unsubscription: +`+r.map(function(n,o){return o+1+") "+n.toString()}).join(` + `):"",this.name="UnsubscriptionError",this.errors=r}});function De(e,t){if(e){var r=e.indexOf(t);0<=r&&e.splice(r,1)}}var Fe=function(){function e(t){this.initialTeardown=t,this.closed=!1,this._parentage=null,this._finalizers=null}return e.prototype.unsubscribe=function(){var t,r,n,o,i;if(!this.closed){this.closed=!0;var a=this._parentage;if(a)if(this._parentage=null,Array.isArray(a))try{for(var s=xe(a),f=s.next();!f.done;f=s.next()){var c=f.value;c.remove(this)}}catch(v){t={error:v}}finally{try{f&&!f.done&&(r=s.return)&&r.call(s)}finally{if(t)throw t.error}}else a.remove(this);var u=this.initialTeardown;if(A(u))try{u()}catch(v){i=v instanceof $t?v.errors:[v]}var p=this._finalizers;if(p){this._finalizers=null;try{for(var m=xe(p),d=m.next();!d.done;d=m.next()){var h=d.value;try{dn(h)}catch(v){i=i!=null?i:[],v instanceof $t?i=D(D([],W(i)),W(v.errors)):i.push(v)}}}catch(v){n={error:v}}finally{try{d&&!d.done&&(o=m.return)&&o.call(m)}finally{if(n)throw n.error}}}if(i)throw new $t(i)}},e.prototype.add=function(t){var r;if(t&&t!==this)if(this.closed)dn(t);else{if(t instanceof e){if(t.closed||t._hasParent(this))return;t._addParent(this)}(this._finalizers=(r=this._finalizers)!==null&&r!==void 0?r:[]).push(t)}},e.prototype._hasParent=function(t){var r=this._parentage;return r===t||Array.isArray(r)&&r.includes(t)},e.prototype._addParent=function(t){var r=this._parentage;this._parentage=Array.isArray(r)?(r.push(t),r):r?[r,t]:t},e.prototype._removeParent=function(t){var r=this._parentage;r===t?this._parentage=null:Array.isArray(r)&&De(r,t)},e.prototype.remove=function(t){var r=this._finalizers;r&&De(r,t),t instanceof e&&t._removeParent(this)},e.EMPTY=function(){var t=new e;return t.closed=!0,t}(),e}();var Or=Fe.EMPTY;function It(e){return e instanceof Fe||e&&"closed"in e&&A(e.remove)&&A(e.add)&&A(e.unsubscribe)}function dn(e){A(e)?e():e.unsubscribe()}var Ae={onUnhandledError:null,onStoppedNotification:null,Promise:void 0,useDeprecatedSynchronousErrorHandling:!1,useDeprecatedNextContext:!1};var st={setTimeout:function(e,t){for(var r=[],n=2;n0},enumerable:!1,configurable:!0}),t.prototype._trySubscribe=function(r){return this._throwIfClosed(),e.prototype._trySubscribe.call(this,r)},t.prototype._subscribe=function(r){return this._throwIfClosed(),this._checkFinalizedStatuses(r),this._innerSubscribe(r)},t.prototype._innerSubscribe=function(r){var n=this,o=this,i=o.hasError,a=o.isStopped,s=o.observers;return i||a?Or:(this.currentObservers=null,s.push(r),new Fe(function(){n.currentObservers=null,De(s,r)}))},t.prototype._checkFinalizedStatuses=function(r){var n=this,o=n.hasError,i=n.thrownError,a=n.isStopped;o?r.error(i):a&&r.complete()},t.prototype.asObservable=function(){var r=new U;return r.source=this,r},t.create=function(r,n){return new wn(r,n)},t}(U);var wn=function(e){ne(t,e);function t(r,n){var o=e.call(this)||this;return o.destination=r,o.source=n,o}return t.prototype.next=function(r){var n,o;(o=(n=this.destination)===null||n===void 0?void 0:n.next)===null||o===void 0||o.call(n,r)},t.prototype.error=function(r){var n,o;(o=(n=this.destination)===null||n===void 0?void 0:n.error)===null||o===void 0||o.call(n,r)},t.prototype.complete=function(){var r,n;(n=(r=this.destination)===null||r===void 0?void 0:r.complete)===null||n===void 0||n.call(r)},t.prototype._subscribe=function(r){var n,o;return(o=(n=this.source)===null||n===void 0?void 0:n.subscribe(r))!==null&&o!==void 0?o:Or},t}(E);var Et={now:function(){return(Et.delegate||Date).now()},delegate:void 0};var wt=function(e){ne(t,e);function t(r,n,o){r===void 0&&(r=1/0),n===void 0&&(n=1/0),o===void 0&&(o=Et);var i=e.call(this)||this;return i._bufferSize=r,i._windowTime=n,i._timestampProvider=o,i._buffer=[],i._infiniteTimeWindow=!0,i._infiniteTimeWindow=n===1/0,i._bufferSize=Math.max(1,r),i._windowTime=Math.max(1,n),i}return t.prototype.next=function(r){var n=this,o=n.isStopped,i=n._buffer,a=n._infiniteTimeWindow,s=n._timestampProvider,f=n._windowTime;o||(i.push(r),!a&&i.push(s.now()+f)),this._trimBuffer(),e.prototype.next.call(this,r)},t.prototype._subscribe=function(r){this._throwIfClosed(),this._trimBuffer();for(var n=this._innerSubscribe(r),o=this,i=o._infiniteTimeWindow,a=o._buffer,s=a.slice(),f=0;f0?e.prototype.requestAsyncId.call(this,r,n,o):(r.actions.push(this),r._scheduled||(r._scheduled=ut.requestAnimationFrame(function(){return r.flush(void 0)})))},t.prototype.recycleAsyncId=function(r,n,o){var i;if(o===void 0&&(o=0),o!=null?o>0:this.delay>0)return e.prototype.recycleAsyncId.call(this,r,n,o);var a=r.actions;n!=null&&((i=a[a.length-1])===null||i===void 0?void 0:i.id)!==n&&(ut.cancelAnimationFrame(n),r._scheduled=void 0)},t}(Ut);var On=function(e){ne(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t.prototype.flush=function(r){this._active=!0;var n=this._scheduled;this._scheduled=void 0;var o=this.actions,i;r=r||o.shift();do if(i=r.execute(r.state,r.delay))break;while((r=o[0])&&r.id===n&&o.shift());if(this._active=!1,i){for(;(r=o[0])&&r.id===n&&o.shift();)r.unsubscribe();throw i}},t}(Wt);var we=new On(Tn);var R=new U(function(e){return e.complete()});function Dt(e){return e&&A(e.schedule)}function kr(e){return e[e.length-1]}function Qe(e){return A(kr(e))?e.pop():void 0}function Se(e){return Dt(kr(e))?e.pop():void 0}function Vt(e,t){return typeof kr(e)=="number"?e.pop():t}var pt=function(e){return e&&typeof e.length=="number"&&typeof e!="function"};function zt(e){return A(e==null?void 0:e.then)}function Nt(e){return A(e[ft])}function qt(e){return Symbol.asyncIterator&&A(e==null?void 0:e[Symbol.asyncIterator])}function Kt(e){return new TypeError("You provided "+(e!==null&&typeof e=="object"?"an invalid object":"'"+e+"'")+" where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.")}function Ki(){return typeof Symbol!="function"||!Symbol.iterator?"@@iterator":Symbol.iterator}var Qt=Ki();function Yt(e){return A(e==null?void 0:e[Qt])}function Gt(e){return ln(this,arguments,function(){var r,n,o,i;return Pt(this,function(a){switch(a.label){case 0:r=e.getReader(),a.label=1;case 1:a.trys.push([1,,9,10]),a.label=2;case 2:return[4,Xe(r.read())];case 3:return n=a.sent(),o=n.value,i=n.done,i?[4,Xe(void 0)]:[3,5];case 4:return[2,a.sent()];case 5:return[4,Xe(o)];case 6:return[4,a.sent()];case 7:return a.sent(),[3,2];case 8:return[3,10];case 9:return r.releaseLock(),[7];case 10:return[2]}})})}function Bt(e){return A(e==null?void 0:e.getReader)}function $(e){if(e instanceof U)return e;if(e!=null){if(Nt(e))return Qi(e);if(pt(e))return Yi(e);if(zt(e))return Gi(e);if(qt(e))return _n(e);if(Yt(e))return Bi(e);if(Bt(e))return Ji(e)}throw Kt(e)}function Qi(e){return new U(function(t){var r=e[ft]();if(A(r.subscribe))return r.subscribe(t);throw new TypeError("Provided object does not correctly implement Symbol.observable")})}function Yi(e){return new U(function(t){for(var r=0;r=2;return function(n){return n.pipe(e?_(function(o,i){return e(o,i,n)}):me,Oe(1),r?He(t):zn(function(){return new Xt}))}}function Nn(){for(var e=[],t=0;t=2,!0))}function fe(e){e===void 0&&(e={});var t=e.connector,r=t===void 0?function(){return new E}:t,n=e.resetOnError,o=n===void 0?!0:n,i=e.resetOnComplete,a=i===void 0?!0:i,s=e.resetOnRefCountZero,f=s===void 0?!0:s;return function(c){var u,p,m,d=0,h=!1,v=!1,B=function(){p==null||p.unsubscribe(),p=void 0},re=function(){B(),u=m=void 0,h=v=!1},z=function(){var T=u;re(),T==null||T.unsubscribe()};return g(function(T,Ke){d++,!v&&!h&&B();var We=m=m!=null?m:r();Ke.add(function(){d--,d===0&&!v&&!h&&(p=jr(z,f))}),We.subscribe(Ke),!u&&d>0&&(u=new et({next:function(Ie){return We.next(Ie)},error:function(Ie){v=!0,B(),p=jr(re,o,Ie),We.error(Ie)},complete:function(){h=!0,B(),p=jr(re,a),We.complete()}}),$(T).subscribe(u))})(c)}}function jr(e,t){for(var r=[],n=2;ne.next(document)),e}function K(e,t=document){return Array.from(t.querySelectorAll(e))}function V(e,t=document){let r=se(e,t);if(typeof r=="undefined")throw new ReferenceError(`Missing element: expected "${e}" to be present`);return r}function se(e,t=document){return t.querySelector(e)||void 0}function _e(){return document.activeElement instanceof HTMLElement&&document.activeElement||void 0}function tr(e){return L(b(document.body,"focusin"),b(document.body,"focusout")).pipe(ke(1),l(()=>{let t=_e();return typeof t!="undefined"?e.contains(t):!1}),N(e===_e()),Y())}function Be(e){return{x:e.offsetLeft,y:e.offsetTop}}function Yn(e){return L(b(window,"load"),b(window,"resize")).pipe(Ce(0,we),l(()=>Be(e)),N(Be(e)))}function rr(e){return{x:e.scrollLeft,y:e.scrollTop}}function dt(e){return L(b(e,"scroll"),b(window,"resize")).pipe(Ce(0,we),l(()=>rr(e)),N(rr(e)))}var Bn=function(){if(typeof Map!="undefined")return Map;function e(t,r){var n=-1;return t.some(function(o,i){return o[0]===r?(n=i,!0):!1}),n}return function(){function t(){this.__entries__=[]}return Object.defineProperty(t.prototype,"size",{get:function(){return this.__entries__.length},enumerable:!0,configurable:!0}),t.prototype.get=function(r){var n=e(this.__entries__,r),o=this.__entries__[n];return o&&o[1]},t.prototype.set=function(r,n){var o=e(this.__entries__,r);~o?this.__entries__[o][1]=n:this.__entries__.push([r,n])},t.prototype.delete=function(r){var n=this.__entries__,o=e(n,r);~o&&n.splice(o,1)},t.prototype.has=function(r){return!!~e(this.__entries__,r)},t.prototype.clear=function(){this.__entries__.splice(0)},t.prototype.forEach=function(r,n){n===void 0&&(n=null);for(var o=0,i=this.__entries__;o0},e.prototype.connect_=function(){!zr||this.connected_||(document.addEventListener("transitionend",this.onTransitionEnd_),window.addEventListener("resize",this.refresh),xa?(this.mutationsObserver_=new MutationObserver(this.refresh),this.mutationsObserver_.observe(document,{attributes:!0,childList:!0,characterData:!0,subtree:!0})):(document.addEventListener("DOMSubtreeModified",this.refresh),this.mutationEventsAdded_=!0),this.connected_=!0)},e.prototype.disconnect_=function(){!zr||!this.connected_||(document.removeEventListener("transitionend",this.onTransitionEnd_),window.removeEventListener("resize",this.refresh),this.mutationsObserver_&&this.mutationsObserver_.disconnect(),this.mutationEventsAdded_&&document.removeEventListener("DOMSubtreeModified",this.refresh),this.mutationsObserver_=null,this.mutationEventsAdded_=!1,this.connected_=!1)},e.prototype.onTransitionEnd_=function(t){var r=t.propertyName,n=r===void 0?"":r,o=ya.some(function(i){return!!~n.indexOf(i)});o&&this.refresh()},e.getInstance=function(){return this.instance_||(this.instance_=new e),this.instance_},e.instance_=null,e}(),Jn=function(e,t){for(var r=0,n=Object.keys(t);r0},e}(),Zn=typeof WeakMap!="undefined"?new WeakMap:new Bn,eo=function(){function e(t){if(!(this instanceof e))throw new TypeError("Cannot call a class as a function.");if(!arguments.length)throw new TypeError("1 argument required, but only 0 present.");var r=Ea.getInstance(),n=new Ra(t,r,this);Zn.set(this,n)}return e}();["observe","unobserve","disconnect"].forEach(function(e){eo.prototype[e]=function(){var t;return(t=Zn.get(this))[e].apply(t,arguments)}});var ka=function(){return typeof nr.ResizeObserver!="undefined"?nr.ResizeObserver:eo}(),to=ka;var ro=new E,Ha=I(()=>H(new to(e=>{for(let t of e)ro.next(t)}))).pipe(x(e=>L(Te,H(e)).pipe(C(()=>e.disconnect()))),J(1));function de(e){return{width:e.offsetWidth,height:e.offsetHeight}}function ge(e){return Ha.pipe(S(t=>t.observe(e)),x(t=>ro.pipe(_(({target:r})=>r===e),C(()=>t.unobserve(e)),l(()=>de(e)))),N(de(e)))}function bt(e){return{width:e.scrollWidth,height:e.scrollHeight}}function ar(e){let t=e.parentElement;for(;t&&(e.scrollWidth<=t.scrollWidth&&e.scrollHeight<=t.scrollHeight);)t=(e=t).parentElement;return t?e:void 0}var no=new E,Pa=I(()=>H(new IntersectionObserver(e=>{for(let t of e)no.next(t)},{threshold:0}))).pipe(x(e=>L(Te,H(e)).pipe(C(()=>e.disconnect()))),J(1));function sr(e){return Pa.pipe(S(t=>t.observe(e)),x(t=>no.pipe(_(({target:r})=>r===e),C(()=>t.unobserve(e)),l(({isIntersecting:r})=>r))))}function oo(e,t=16){return dt(e).pipe(l(({y:r})=>{let n=de(e),o=bt(e);return r>=o.height-n.height-t}),Y())}var cr={drawer:V("[data-md-toggle=drawer]"),search:V("[data-md-toggle=search]")};function io(e){return cr[e].checked}function qe(e,t){cr[e].checked!==t&&cr[e].click()}function je(e){let t=cr[e];return b(t,"change").pipe(l(()=>t.checked),N(t.checked))}function $a(e,t){switch(e.constructor){case HTMLInputElement:return e.type==="radio"?/^Arrow/.test(t):!0;case HTMLSelectElement:case HTMLTextAreaElement:return!0;default:return e.isContentEditable}}function Ia(){return L(b(window,"compositionstart").pipe(l(()=>!0)),b(window,"compositionend").pipe(l(()=>!1))).pipe(N(!1))}function ao(){let e=b(window,"keydown").pipe(_(t=>!(t.metaKey||t.ctrlKey)),l(t=>({mode:io("search")?"search":"global",type:t.key,claim(){t.preventDefault(),t.stopPropagation()}})),_(({mode:t,type:r})=>{if(t==="global"){let n=_e();if(typeof n!="undefined")return!$a(n,r)}return!0}),fe());return Ia().pipe(x(t=>t?R:e))}function Me(){return new URL(location.href)}function ot(e){location.href=e.href}function so(){return new E}function co(e,t){if(typeof t=="string"||typeof t=="number")e.innerHTML+=t.toString();else if(t instanceof Node)e.appendChild(t);else if(Array.isArray(t))for(let r of t)co(e,r)}function M(e,t,...r){let n=document.createElement(e);if(t)for(let o of Object.keys(t))typeof t[o]!="undefined"&&(typeof t[o]!="boolean"?n.setAttribute(o,t[o]):n.setAttribute(o,""));for(let o of r)co(n,o);return n}function fr(e){if(e>999){let t=+((e-950)%1e3>99);return`${((e+1e-6)/1e3).toFixed(t)}k`}else return e.toString()}function fo(){return location.hash.substring(1)}function uo(e){let t=M("a",{href:e});t.addEventListener("click",r=>r.stopPropagation()),t.click()}function Fa(){return b(window,"hashchange").pipe(l(fo),N(fo()),_(e=>e.length>0),J(1))}function po(){return Fa().pipe(l(e=>se(`[id="${e}"]`)),_(e=>typeof e!="undefined"))}function Nr(e){let t=matchMedia(e);return Zt(r=>t.addListener(()=>r(t.matches))).pipe(N(t.matches))}function lo(){let e=matchMedia("print");return L(b(window,"beforeprint").pipe(l(()=>!0)),b(window,"afterprint").pipe(l(()=>!1))).pipe(N(e.matches))}function qr(e,t){return e.pipe(x(r=>r?t():R))}function ur(e,t={credentials:"same-origin"}){return ve(fetch(`${e}`,t)).pipe(ce(()=>R),x(r=>r.status!==200?Tt(()=>new Error(r.statusText)):H(r)))}function Ue(e,t){return ur(e,t).pipe(x(r=>r.json()),J(1))}function mo(e,t){let r=new DOMParser;return ur(e,t).pipe(x(n=>n.text()),l(n=>r.parseFromString(n,"text/xml")),J(1))}function pr(e){let t=M("script",{src:e});return I(()=>(document.head.appendChild(t),L(b(t,"load"),b(t,"error").pipe(x(()=>Tt(()=>new ReferenceError(`Invalid script: ${e}`))))).pipe(l(()=>{}),C(()=>document.head.removeChild(t)),Oe(1))))}function ho(){return{x:Math.max(0,scrollX),y:Math.max(0,scrollY)}}function bo(){return L(b(window,"scroll",{passive:!0}),b(window,"resize",{passive:!0})).pipe(l(ho),N(ho()))}function vo(){return{width:innerWidth,height:innerHeight}}function go(){return b(window,"resize",{passive:!0}).pipe(l(vo),N(vo()))}function yo(){return Q([bo(),go()]).pipe(l(([e,t])=>({offset:e,size:t})),J(1))}function lr(e,{viewport$:t,header$:r}){let n=t.pipe(X("size")),o=Q([n,r]).pipe(l(()=>Be(e)));return Q([r,t,o]).pipe(l(([{height:i},{offset:a,size:s},{x:f,y:c}])=>({offset:{x:a.x-f,y:a.y-c+i},size:s})))}(()=>{function e(n,o){parent.postMessage(n,o||"*")}function t(...n){return n.reduce((o,i)=>o.then(()=>new Promise(a=>{let s=document.createElement("script");s.src=i,s.onload=a,document.body.appendChild(s)})),Promise.resolve())}var r=class{constructor(n){this.url=n,this.onerror=null,this.onmessage=null,this.onmessageerror=null,this.m=a=>{a.source===this.w&&(a.stopImmediatePropagation(),this.dispatchEvent(new MessageEvent("message",{data:a.data})),this.onmessage&&this.onmessage(a))},this.e=(a,s,f,c,u)=>{if(s===this.url.toString()){let p=new ErrorEvent("error",{message:a,filename:s,lineno:f,colno:c,error:u});this.dispatchEvent(p),this.onerror&&this.onerror(p)}};let o=new EventTarget;this.addEventListener=o.addEventListener.bind(o),this.removeEventListener=o.removeEventListener.bind(o),this.dispatchEvent=o.dispatchEvent.bind(o);let i=document.createElement("iframe");i.width=i.height=i.frameBorder="0",document.body.appendChild(this.iframe=i),this.w.document.open(),this.w.document.write(` + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Create a backend

+

As we said, a backend is the combination of a transport and a strategy. That way, you can create a complete strategy exactly fitting your needs.

+

For this, you have to use the AuthenticationBackend class.

+
from fastapi_users.authentication import AuthenticationBackend, BearerTransport, JWTStrategy
+
+SECRET = "SECRET"
+
+bearer_transport = BearerTransport(tokenUrl="auth/jwt/login")
+
+def get_jwt_strategy() -> JWTStrategy:
+    return JWTStrategy(secret=SECRET, lifetime_seconds=3600)
+
+auth_backend = AuthenticationBackend(
+    name="jwt",
+    transport=bearer_transport,
+    get_strategy=get_jwt_strategy,
+)
+
+

As you can see, instantiation is quite simple. It accepts the following arguments:

+
    +
  • name (str): Name of the backend. Each backend should have a unique name.
    • +
  • transport (Transport): An instance of a Transport class.
    • +
  • get_strategy (Callable[..., Strategy]): A dependency callable returning an instance of a Strategy class.
    • +
+

Next steps

+

You can have as many authentication backends as you wish. You'll then have to pass those backends to your FastAPIUsers instance and generate an auth router for each one of them.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/authentication/index.html b/10.3/configuration/authentication/index.html new file mode 100644 index 00000000..ade567e1 --- /dev/null +++ b/10.3/configuration/authentication/index.html @@ -0,0 +1,1431 @@ + + + + + + + + + + + + + + + + + + + + + + + + Introduction - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Authentication

+

FastAPI Users allows you to plug in several authentication methods.

+

How it works?

+

You can have several authentication methods, e.g. a cookie authentication for browser-based queries and a JWT token authentication for pure API queries.

+

When checking authentication, each method is run one after the other. The first method yielding a user wins. If no method yields a user, an HTTPException is raised.

+

For each backend, you'll be able to add a router with the corresponding /login and /logout. More on this in the routers documentation.

+

Transport + Strategy = Authentication backend

+

An authentication backend is composed of two parts:

+

Transport

+

It manages how the token will be carried over the request. We currently provide two methods:

+

Bearer

+

The token will be sent through an Authorization: Bearer header.

+
+

Pros and cons

+
    +
  • ✅ Easy to read and set in every requests.
    • +
  • ❌ Needs to be stored manually somewhere in the client.
    • +
+

➡️ Use it if you want to implement a mobile application or a pure REST API.

+
+ +

The token will be sent through a cookie.

+
+

Pros and cons

+
    +
  • ✅ Automatically stored and sent securely by web browsers in every requests.
    • +
  • ✅ Automatically removed at expiration by web browsers.
    • +
  • ❌ Needs a CSRF protection for maximum security.
    • +
  • ❌ Harder to work with outside a browser, like a mobile app or a server.
    • +
+

➡️ Use it if you want to implement a web frontend.

+
+

Strategy

+

It manages how the token is generated and secured. We currently provide three methods:

+

JWT

+

The token is self-contained in a JSON Web Token.

+
+

Pros and cons

+
    +
  • ✅ Self-contained: it doesn't need to be stored in a database.
    • +
  • ❌ Can't be invalidated on the server-side: it's valid until it expires.
    • +
+

➡️ Use it if you want to get up-and-running quickly.

+
+

Database

+

The token is stored in a table (or collection) in your database.

+
+

Pros and cons

+
    +
  • ✅ Secure and performant.
    • +
  • ✅ Tokens can be invalidated server-side by removing them from the database.
    • +
  • ✅ Highly customizable: add your own fields, create an API to retrieve the active sessions of your users, etc.
    • +
  • ❌ Configuration is a bit more complex.
    • +
+

➡️ Use it if you want maximum flexibility in your token management.

+
+

Redis

+

The token is stored in a Redis key-store.

+
+

Pros and cons

+
    +
  • ✅ Secure and performant.
    • +
  • ✅ Tokens can be invalidated server-side by removing them from Redis.
    • +
  • ❌ A Redis server is needed.
    • +
+

➡️ Use it if you want maximum performance while being able to invalidate tokens.

+
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/authentication/strategies/database/index.html b/10.3/configuration/authentication/strategies/database/index.html new file mode 100644 index 00000000..7cee0af2 --- /dev/null +++ b/10.3/configuration/authentication/strategies/database/index.html @@ -0,0 +1,1457 @@ + + + + + + + + + + + + + + + + + + + + + + + + Database - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Database

+

The most natural way for storing tokens is of course the very same database you're using for your application. In this strategy, we set up a table (or collection) for storing those tokens with the associated user id. On each request, we try to retrive this token from the database to get the corresponding user id.

+

Configuration

+

The configuration of this strategy is a bit more complex than the others as it requires you to configure models and a database adapter, exactly like we did for users.

+

Database adapters

+

An access token will be structured like this in your database:

+
    +
  • token (str) – Unique identifier of the token. It's generated automatically upon login by the strategy.
    • +
  • user_id (ID) – User id. of the user associated to this token.
    • +
  • created_at (datetime) – Date and time of creation of the token. It's used to determine if the token is expired or not.
    • +
+

We are providing a base model with those fields for each database we are supporting.

+

SQLAlchemy

+

We'll expand from the basic SQLAlchemy configuration.

+
from typing import AsyncGenerator
+
+from fastapi import Depends
+from fastapi_users.db import SQLAlchemyBaseUserTableUUID, SQLAlchemyUserDatabase
+from fastapi_users_db_sqlalchemy.access_token import (
+    SQLAlchemyAccessTokenDatabase,
+    SQLAlchemyBaseAccessTokenTableUUID,
+)
+from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine
+from sqlalchemy.orm import DeclarativeMeta, declarative_base, sessionmaker
+
+DATABASE_URL = "sqlite+aiosqlite:///./test.db"
+Base: DeclarativeMeta = declarative_base()
+
+
+class User(SQLAlchemyBaseUserTableUUID, Base):
+    pass
+
+
+class AccessToken(SQLAlchemyBaseAccessTokenTableUUID, Base):  # (1)!
+    pass
+
+
+engine = create_async_engine(DATABASE_URL)
+async_session_maker = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)
+
+
+async def create_db_and_tables():
+    async with engine.begin() as conn:
+        await conn.run_sync(Base.metadata.create_all)
+
+
+async def get_async_session() -> AsyncGenerator[AsyncSession, None]:
+    async with async_session_maker() as session:
+        yield session
+
+
+async def get_user_db(session: AsyncSession = Depends(get_async_session)):
+    yield SQLAlchemyUserDatabase(session, User)
+
+
+async def get_access_token_db(
+    session: AsyncSession = Depends(get_async_session),
+):  # (2)!
+    yield SQLAlchemyAccessTokenDatabase(session, AccessToken)
+
+
    +
  1. +

    We define an AccessToken ORM model inheriting from SQLAlchemyBaseAccessTokenTableUUID.

    +
    2. +
  2. +

    We define a dependency to instantiate the SQLAlchemyAccessTokenDatabase class. Just like the user database adapter, it expects a fresh SQLAlchemy session and the AccessToken model class we defined above.

    +
    3. +
+
+

user_id foreign key is defined as UUID

+

By default, we use UUID as a primary key ID for your user, so we follow the same convention to define the foreign key pointing to the user.

+

If you want to use another type, like an auto-incremented integer, you can use SQLAlchemyBaseAccessTokenTable as base class and define your own user_id column.

+
class AccessToken(SQLAlchemyBaseAccessTokenTable[int], Base):
+    @declared_attr
+    def user_id(cls):
+        return Column(Integer, ForeignKey("user.id", ondelete="cascade"), nullable=False)
+
+

Notice that SQLAlchemyBaseAccessTokenTable expects a generic type to define the actual type of ID you use.

+
+

Beanie

+

We'll expand from the basic Beanie configuration.

+
import motor.motor_asyncio
+from beanie import PydanticObjectId
+from fastapi_users.db import BeanieBaseUser, BeanieUserDatabase
+from fastapi_users_db_beanie.access_token import (
+    BeanieAccessTokenDatabase,
+    BeanieBaseAccessToken,
+)
+
+DATABASE_URL = "mongodb://localhost:27017"
+client = motor.motor_asyncio.AsyncIOMotorClient(
+    DATABASE_URL, uuidRepresentation="standard"
+)
+db = client["database_name"]
+
+
+class User(BeanieBaseUser):
+    pass
+
+
+class AccessToken(BeanieBaseAccessToken[PydanticObjectId]):  # (1)!
+    pass
+
+
+async def get_user_db():
+    yield BeanieUserDatabase(User)
+
+
+async def get_access_token_db():  # (2)!
+    yield BeanieAccessTokenDatabase(AccessToken)
+
+
    +
  1. +

    We define an AccessToken ODM model inheriting from BeanieBaseAccessToken. Notice that we set a generic type to define the type of the user_id reference. By default, it's a standard MongoDB ObjectID.

    +
    2. +
  2. +

    We define a dependency to instantiate the BeanieAccessTokenDatabase class. Just like the user database adapter, it expects the AccessToken model class we defined above.

    +
    3. +
+

Strategy

+
import uuid
+
+from fastapi import Depends
+from fastapi_users.authentication.strategy.db import AccessTokenDatabase, DatabaseStrategy
+
+from .db import AccessToken, User
+
+
+def get_database_strategy(
+    access_token_db: AccessTokenDatabase[AccessToken] = Depends(get_access_token_db),
+) -> DatabaseStrategy:
+    return DatabaseStrategy(access_token_db, lifetime_seconds=3600)
+
+

As you can see, instantiation is quite simple. It accepts the following arguments:

+
    +
  • database (AccessTokenDatabase): A database adapter instance for AccessToken table, like we defined above.
    • +
  • lifetime_seconds (int): The lifetime of the token in seconds.
    • +
+
+

Why it's inside a function?

+

To allow strategies to be instantiated dynamically with other dependencies, they have to be provided as a callable to the authentication backend.

+

As you can see here, this pattern allows us to dynamically inject a connection to the database.

+
+

Logout

+

On logout, this strategy will delete the token from the database.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/authentication/strategies/jwt/index.html b/10.3/configuration/authentication/strategies/jwt/index.html new file mode 100644 index 00000000..8275b3b1 --- /dev/null +++ b/10.3/configuration/authentication/strategies/jwt/index.html @@ -0,0 +1,1290 @@ + + + + + + + + + + + + + + + + + + + + + + + + JWT - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

JWT

+

JSON Web Token (JWT) is an internet standard for creating access tokens based on JSON. They don't need to be stored in a database: the data is self-contained inside and cryptographically signed.

+

Configuration

+
from fastapi_users.authentication import JWTStrategy
+
+SECRET = "SECRET"
+
+def get_jwt_strategy() -> JWTStrategy:
+    return JWTStrategy(secret=SECRET, lifetime_seconds=3600)
+
+

As you can see, instantiation is quite simple. It accepts the following arguments:

+
    +
  • secret (Union[str, pydantic.SecretStr]): A constant secret which is used to encode the token. Use a strong passphrase and keep it secure.
    • +
  • lifetime_seconds (Optional[int]): The lifetime of the token in seconds. Can be set to None but in this case the token will be valid forever; which may raise serious security concerns.
    • +
  • token_audience (Optional[List[str]]): A list of valid audiences for the JWT token. Defaults to ["fastapi-users:auth"].
    • +
  • algorithm (Optional[str]): The JWT encryption algorithm. See RFC 7519, section 8. Defaults to "HS256".
    • +
  • public_key (Optional[Union[str, pydantic.SecretStr]]): If the JWT encryption algorithm requires a key pair instead of a simple secret, the key to decrypt the JWT may be provided here. The secret parameter will always be used to encrypt the JWT.
    • +
+
+

Why it's inside a function?

+

To allow strategies to be instantiated dynamically with other dependencies, they have to be provided as a callable to the authentication backend.

+

For JWTStrategy, since it doesn't require dependencies, it can be as simple as the function above.

+
+

RS256 example

+
from fastapi_users.authentication import JWTStrategy
+
+PUBLIC_KEY = """-----BEGIN PUBLIC KEY-----
+# Your RSA public key in PEM format goes here
+-----END PUBLIC KEY-----"""
+
+PRIVATE_KEY = """-----BEGIN RSA PRIVATE KEY-----
+# Your RSA private key in PEM format goes here
+-----END RSA PRIVATE KEY-----"""
+
+def get_jwt_strategy() -> JWTStrategy:
+    return JWTStrategy(
+        secret=PRIVATE_KEY, 
+        lifetime_seconds=3600,
+        algorithm="RS256",
+        public_key=PUBLIC_KEY,
+    )
+
+

Logout

+

On logout, this strategy won't do anything. Indeed, a JWT can't be invalidated on the server-side: it's valid until it expires.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/authentication/strategies/redis/index.html b/10.3/configuration/authentication/strategies/redis/index.html new file mode 100644 index 00000000..8b7a084e --- /dev/null +++ b/10.3/configuration/authentication/strategies/redis/index.html @@ -0,0 +1,1273 @@ + + + + + + + + + + + + + + + + + + + + + + + + Redis - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Redis

+

Redis is an ultra-fast key-store database. As such, it's a good candidate for token management. In this strategy, a token is generated and associated with the user id. in the database. On each request, we try to retrieve this token from Redis to get the corresponding user id.

+

Installation

+

You should install the library with the optional dependencies for Redis:

+
pip install 'fastapi-users[redis]'
+
+

Configuration

+
import redis.asyncio
+from fastapi_users.authentication import RedisStrategy
+
+redis = redis.asyncio.from_url("redis://localhost:6379", decode_responses=True)
+
+def get_redis_strategy() -> RedisStrategy:
+    return RedisStrategy(redis, lifetime_seconds=3600)
+
+

As you can see, instantiation is quite simple. It accepts the following arguments:

+
    +
  • redis (redis.asyncio.Redis): An instance of redis.asyncio.Redis. Note that the decode_responses flag set to True is necessary.
    • +
  • lifetime_seconds (Optional[int]): The lifetime of the token in seconds. Defaults to None, which means the token doesn't expire.
    • +
  • key_prefix (str): The prefix used to set the key in the Redis stored. Defaults to fastapi_users_token:.
    • +
+
+

Why it's inside a function?

+

To allow strategies to be instantiated dynamically with other dependencies, they have to be provided as a callable to the authentication backend.

+
+

Logout

+

On logout, this strategy will delete the token from the Redis store.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/authentication/transports/bearer/index.html b/10.3/configuration/authentication/transports/bearer/index.html new file mode 100644 index 00000000..66b3d441 --- /dev/null +++ b/10.3/configuration/authentication/transports/bearer/index.html @@ -0,0 +1,1290 @@ + + + + + + + + + + + + + + + + + + + + + + + + Bearer - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Bearer

+

With this transport, the token is expected inside the Authorization header of the HTTP request with the Bearer scheme. It's particularly suited for pure API interaction or mobile apps.

+

Configuration

+
from fastapi_users.authentication import BearerTransport
+
+bearer_transport = BearerTransport(tokenUrl="auth/jwt/login")
+
+

As you can see, instantiation is quite simple. It accepts the following arguments:

+
    +
  • tokenUrl (str): The exact path of your login endpoint. It'll allow the interactive documentation to automatically discover it and get a working Authorize button. In most cases, you'll probably need a relative path, not absolute. You can read more details about this in the FastAPI documentation.
    • +
+

Login

+

This method will return the in the following form upon successful login:

+
+

200 OK

+
{
+    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiOTIyMWZmYzktNjQwZi00MzcyLTg2ZDMtY2U2NDJjYmE1NjAzIiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTcxNTA0MTkzfQ.M10bjOe45I5Ncu_uXvOmVV8QxnL-nZfcH96U90JaocI",
+    "token_type": "bearer"
+}
+
+
+
+

Check documentation about login route.

+
+

Logout

+

The logout method with this transport returns nothing.

+

Authentication

+

This method expects that you provide a Bearer authentication with a valid token corresponding to your strategy.

+
curl http://localhost:9000/protected-route -H'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiOTIyMWZmYzktNjQwZi00MzcyLTg2ZDMtY2U2NDJjYmE1NjAzIiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTcxNTA0MTkzfQ.M10bjOe45I5Ncu_uXvOmVV8QxnL-nZfcH96U90JaocI'
+
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/authentication/transports/cookie/index.html b/10.3/configuration/authentication/transports/cookie/index.html new file mode 100644 index 00000000..868f7751 --- /dev/null +++ b/10.3/configuration/authentication/transports/cookie/index.html @@ -0,0 +1,1295 @@ + + + + + + + + + + + + + + + + + + + + + + + + Cookie - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Cookie

+

Cookies are an easy way to store stateful information into the user browser. Thus, it is more useful for browser-based navigation (e.g. a front-end app making API requests) rather than pure API interaction.

+

Configuration

+
from fastapi_users.authentication import CookieTransport
+
+cookie_transport = CookieTransport(cookie_max_age=3600)
+
+

As you can see, instantiation is quite simple. It accepts the following arguments:

+
    +
  • cookie_name (fastapiusersauth): Name of the cookie.
    • +
  • cookie_max_age (Optional[int]): The lifetime of the cookie in seconds. None by default, which means it's a session cookie.
    • +
  • cookie_path (/): Cookie path.
    • +
  • cookie_domain (None): Cookie domain.
    • +
  • cookie_secure (True): Whether to only send the cookie to the server via SSL request.
    • +
  • cookie_httponly (True): Whether to prevent access to the cookie via JavaScript.
    • +
  • cookie_samesite (lax): A string that specifies the samesite strategy for the cookie. Valid values are lax, strict and none. Defaults to lax.
    • +
+

Login

+

This method will return a response with a valid set-cookie header upon successful login:

+
+

200 OK

+
+
+

Check documentation about login route.

+
+

Logout

+

This method will remove the authentication cookie:

+
+

200 OK

+
+
+

Check documentation about logout route.

+
+

Authentication

+

This method expects that you provide a valid cookie in the headers.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/databases/beanie/index.html b/10.3/configuration/databases/beanie/index.html new file mode 100644 index 00000000..29029bcd --- /dev/null +++ b/10.3/configuration/databases/beanie/index.html @@ -0,0 +1,1363 @@ + + + + + + + + + + + + + + + + + + + + + + + + Beanie - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Beanie

+

FastAPI Users provides the necessary tools to work with MongoDB databases using the Beanie ODM.

+

Setup database connection and collection

+

The first thing to do is to create a MongoDB connection using mongodb/motor (automatically installed with Beanie).

+
import motor.motor_asyncio
+from beanie import PydanticObjectId
+from fastapi_users.db import BeanieBaseUser, BeanieUserDatabase
+
+DATABASE_URL = "mongodb://localhost:27017"
+client = motor.motor_asyncio.AsyncIOMotorClient(
+    DATABASE_URL, uuidRepresentation="standard"
+)
+db = client["database_name"]
+
+
+class User(BeanieBaseUser[PydanticObjectId]):
+    pass
+
+
+async def get_user_db():
+    yield BeanieUserDatabase(User)
+
+

You can choose any name for the database.

+

Create the User model

+

As for any Beanie ODM model, we'll create a User model.

+
import motor.motor_asyncio
+from beanie import PydanticObjectId
+from fastapi_users.db import BeanieBaseUser, BeanieUserDatabase
+
+DATABASE_URL = "mongodb://localhost:27017"
+client = motor.motor_asyncio.AsyncIOMotorClient(
+    DATABASE_URL, uuidRepresentation="standard"
+)
+db = client["database_name"]
+
+
+class User(BeanieBaseUser[PydanticObjectId]):
+    pass
+
+
+async def get_user_db():
+    yield BeanieUserDatabase(User)
+
+

As you can see, FastAPI Users provides a base class that will include base fields for our User table. You can of course add you own fields there to fit to your needs!

+
+

Document ID is a MongoDB ObjectID

+

Beanie automatically manages document ID by encoding/decoding MongoDB ObjectID.

+

If you want to use another type, like UUID, you can override the id field:

+
import uuid
+
+from pydantic import Field
+
+
+class User(BeanieBaseUser[uuid.UUID]):
+    id: uuid.UUID = Field(default_factory=uuid.uuid4)
+
+

Notice that BeanieBaseUser expects a generic type to define the actual type of ID you use.

+
+
+

Info

+

The base class is configured to automatically create a unique index on id and email.

+
+

Create the database adapter

+

The database adapter of FastAPI Users makes the link between your database configuration and the users logic. It should be generated by a FastAPI dependency.

+
import motor.motor_asyncio
+from beanie import PydanticObjectId
+from fastapi_users.db import BeanieBaseUser, BeanieUserDatabase
+
+DATABASE_URL = "mongodb://localhost:27017"
+client = motor.motor_asyncio.AsyncIOMotorClient(
+    DATABASE_URL, uuidRepresentation="standard"
+)
+db = client["database_name"]
+
+
+class User(BeanieBaseUser[PydanticObjectId]):
+    pass
+
+
+async def get_user_db():
+    yield BeanieUserDatabase(User)
+
+

Notice that we pass a reference to the User model we defined above.

+

Initialize Beanie

+

When initializing your FastAPI app, it's important that you initialize Beanie so it can discover your models. We can achieve this using a startup event handler on the FastAPI app:

+
from beanie import init_beanie
+
+
+@app.on_event("startup")
+async def on_startup():
+    await init_beanie(
+        database=db,  # (1)!
+        document_models=[
+            User,  # (2)!
+        ],
+    )
+
+
    +
  1. +

    This is the db Motor database instance we defined above.

    +
    2. +
  2. +

    This is the Beanie User model we defined above. Don't forget to also add your very own models!

    +
    3. +
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/databases/sqlalchemy/index.html b/10.3/configuration/databases/sqlalchemy/index.html new file mode 100644 index 00000000..52e22942 --- /dev/null +++ b/10.3/configuration/databases/sqlalchemy/index.html @@ -0,0 +1,1394 @@ + + + + + + + + + + + + + + + + + + + + + + + + SQLAlchemy - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

SQLAlchemy

+

FastAPI Users provides the necessary tools to work with SQL databases thanks to SQLAlchemy ORM with asyncio.

+

Asynchronous driver

+

To work with your DBMS, you'll need to install the corresponding asyncio driver. The common choices are:

+
    +
  • For PostgreSQL: pip install asyncpg
    • +
  • For SQLite: pip install aiosqlite
    • +
+

Examples of DB_URLs are:

+
    +
  • PostgreSQL: engine = create_engine('postgresql+asyncpg://user:password@host:port/name')
    • +
  • SQLite: engine = create_engine('sqlite+aiosqlite:///name.db')
    • +
+

For the sake of this tutorial from now on, we'll use a simple SQLite database.

+

Create the User model

+

As for any SQLAlchemy ORM model, we'll create a User model.

+
from typing import AsyncGenerator
+
+from fastapi import Depends
+from fastapi_users.db import SQLAlchemyBaseUserTableUUID, SQLAlchemyUserDatabase
+from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine
+from sqlalchemy.orm import DeclarativeMeta, declarative_base, sessionmaker
+
+DATABASE_URL = "sqlite+aiosqlite:///./test.db"
+Base: DeclarativeMeta = declarative_base()
+
+
+class User(SQLAlchemyBaseUserTableUUID, Base):
+    pass
+
+
+engine = create_async_engine(DATABASE_URL)
+async_session_maker = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)
+
+
+async def create_db_and_tables():
+    async with engine.begin() as conn:
+        await conn.run_sync(Base.metadata.create_all)
+
+
+async def get_async_session() -> AsyncGenerator[AsyncSession, None]:
+    async with async_session_maker() as session:
+        yield session
+
+
+async def get_user_db(session: AsyncSession = Depends(get_async_session)):
+    yield SQLAlchemyUserDatabase(session, User)
+
+

As you can see, FastAPI Users provides a base class that will include base fields for our User table. You can of course add you own fields there to fit to your needs!

+
+

Primary key is defined as UUID

+

By default, we use UUID as a primary key ID for your user. If you want to use another type, like an auto-incremented integer, you can use SQLAlchemyBaseUserTable as base class and define your own id column.

+
class User(SQLAlchemyBaseUserTable[int], Base):
+    id = Column(Integer, primary_key=True)
+
+

Notice that SQLAlchemyBaseUserTable expects a generic type to define the actual type of ID you use.

+
+

Implement a function to create the tables

+

We'll now create an utility function to create all the defined tables.

+
from typing import AsyncGenerator
+
+from fastapi import Depends
+from fastapi_users.db import SQLAlchemyBaseUserTableUUID, SQLAlchemyUserDatabase
+from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine
+from sqlalchemy.orm import DeclarativeMeta, declarative_base, sessionmaker
+
+DATABASE_URL = "sqlite+aiosqlite:///./test.db"
+Base: DeclarativeMeta = declarative_base()
+
+
+class User(SQLAlchemyBaseUserTableUUID, Base):
+    pass
+
+
+engine = create_async_engine(DATABASE_URL)
+async_session_maker = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)
+
+
+async def create_db_and_tables():
+    async with engine.begin() as conn:
+        await conn.run_sync(Base.metadata.create_all)
+
+
+async def get_async_session() -> AsyncGenerator[AsyncSession, None]:
+    async with async_session_maker() as session:
+        yield session
+
+
+async def get_user_db(session: AsyncSession = Depends(get_async_session)):
+    yield SQLAlchemyUserDatabase(session, User)
+
+

This function can be called, for example, during the initialization of your FastAPI app.

+
+

Warning

+

In production, it's strongly recommended to setup a migration system to update your SQL schemas. See Alembic.

+
+

Create the database adapter dependency

+

The database adapter of FastAPI Users makes the link between your database configuration and the users logic. It should be generated by a FastAPI dependency.

+
from typing import AsyncGenerator
+
+from fastapi import Depends
+from fastapi_users.db import SQLAlchemyBaseUserTableUUID, SQLAlchemyUserDatabase
+from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine
+from sqlalchemy.orm import DeclarativeMeta, declarative_base, sessionmaker
+
+DATABASE_URL = "sqlite+aiosqlite:///./test.db"
+Base: DeclarativeMeta = declarative_base()
+
+
+class User(SQLAlchemyBaseUserTableUUID, Base):
+    pass
+
+
+engine = create_async_engine(DATABASE_URL)
+async_session_maker = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)
+
+
+async def create_db_and_tables():
+    async with engine.begin() as conn:
+        await conn.run_sync(Base.metadata.create_all)
+
+
+async def get_async_session() -> AsyncGenerator[AsyncSession, None]:
+    async with async_session_maker() as session:
+        yield session
+
+
+async def get_user_db(session: AsyncSession = Depends(get_async_session)):
+    yield SQLAlchemyUserDatabase(session, User)
+
+

Notice that we define first a get_async_session dependency returning us a fresh SQLAlchemy session to interact with the database.

+

It's then used inside the get_user_db dependency to generate our adapter. Notice that we pass it two things:

+
    +
  • The session instance we just injected.
    • +
  • The User class, which is the actual SQLAlchemy model.
    • +
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/full-example/index.html b/10.3/configuration/full-example/index.html new file mode 100644 index 00000000..72d8271f --- /dev/null +++ b/10.3/configuration/full-example/index.html @@ -0,0 +1,1590 @@ + + + + + + + + + + + + + + + + + + + + + + + + Full example - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Full example

+

Here is a full working example with JWT authentication to help get you started.

+
+

Warning

+

Notice that SECRET should be changed to a strong passphrase. +Insecure passwords may give attackers full access to your database.

+
+

SQLAlchemy

+

Open

+
+
+
+
fastapi
+fastapi-users[sqlalchemy]
+uvicorn[standard]
+aiosqlite
+
+
+
+
import uvicorn
+
+if __name__ == "__main__":
+    uvicorn.run("app.app:app", host="0.0.0.0", log_level="info")
+
+
+
+
from fastapi import Depends, FastAPI
+
+from app.db import User, create_db_and_tables
+from app.schemas import UserCreate, UserRead, UserUpdate
+from app.users import auth_backend, current_active_user, fastapi_users
+
+app = FastAPI()
+
+app.include_router(
+    fastapi_users.get_auth_router(auth_backend), prefix="/auth/jwt", tags=["auth"]
+)
+app.include_router(
+    fastapi_users.get_register_router(UserRead, UserCreate),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(
+    fastapi_users.get_reset_password_router(),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(
+    fastapi_users.get_verify_router(UserRead),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(
+    fastapi_users.get_users_router(UserRead, UserUpdate),
+    prefix="/users",
+    tags=["users"],
+)
+
+
+@app.get("/authenticated-route")
+async def authenticated_route(user: User = Depends(current_active_user)):
+    return {"message": f"Hello {user.email}!"}
+
+
+@app.on_event("startup")
+async def on_startup():
+    # Not needed if you setup a migration system like Alembic
+    await create_db_and_tables()
+
+
+
+
from typing import AsyncGenerator
+
+from fastapi import Depends
+from fastapi_users.db import SQLAlchemyBaseUserTableUUID, SQLAlchemyUserDatabase
+from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine
+from sqlalchemy.orm import DeclarativeMeta, declarative_base, sessionmaker
+
+DATABASE_URL = "sqlite+aiosqlite:///./test.db"
+Base: DeclarativeMeta = declarative_base()
+
+
+class User(SQLAlchemyBaseUserTableUUID, Base):
+    pass
+
+
+engine = create_async_engine(DATABASE_URL)
+async_session_maker = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)
+
+
+async def create_db_and_tables():
+    async with engine.begin() as conn:
+        await conn.run_sync(Base.metadata.create_all)
+
+
+async def get_async_session() -> AsyncGenerator[AsyncSession, None]:
+    async with async_session_maker() as session:
+        yield session
+
+
+async def get_user_db(session: AsyncSession = Depends(get_async_session)):
+    yield SQLAlchemyUserDatabase(session, User)
+
+
+
+
import uuid
+
+from fastapi_users import schemas
+
+
+class UserRead(schemas.BaseUser[uuid.UUID]):
+    pass
+
+
+class UserCreate(schemas.BaseUserCreate):
+    pass
+
+
+class UserUpdate(schemas.BaseUserUpdate):
+    pass
+
+
+
+
import uuid
+from typing import Optional
+
+from fastapi import Depends, Request
+from fastapi_users import BaseUserManager, FastAPIUsers, UUIDIDMixin
+from fastapi_users.authentication import (
+    AuthenticationBackend,
+    BearerTransport,
+    JWTStrategy,
+)
+from fastapi_users.db import SQLAlchemyUserDatabase
+
+from app.db import User, get_user_db
+
+SECRET = "SECRET"
+
+
+class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):
+    reset_password_token_secret = SECRET
+    verification_token_secret = SECRET
+
+    async def on_after_register(self, user: User, request: Optional[Request] = None):
+        print(f"User {user.id} has registered.")
+
+    async def on_after_forgot_password(
+        self, user: User, token: str, request: Optional[Request] = None
+    ):
+        print(f"User {user.id} has forgot their password. Reset token: {token}")
+
+    async def on_after_request_verify(
+        self, user: User, token: str, request: Optional[Request] = None
+    ):
+        print(f"Verification requested for user {user.id}. Verification token: {token}")
+
+
+async def get_user_manager(user_db: SQLAlchemyUserDatabase = Depends(get_user_db)):
+    yield UserManager(user_db)
+
+
+bearer_transport = BearerTransport(tokenUrl="auth/jwt/login")
+
+
+def get_jwt_strategy() -> JWTStrategy:
+    return JWTStrategy(secret=SECRET, lifetime_seconds=3600)
+
+
+auth_backend = AuthenticationBackend(
+    name="jwt",
+    transport=bearer_transport,
+    get_strategy=get_jwt_strategy,
+)
+
+fastapi_users = FastAPIUsers[User, uuid.UUID](get_user_manager, [auth_backend])
+
+current_active_user = fastapi_users.current_user(active=True)
+
+
+
+
+

Beanie

+

Open

+
+
+
+
fastapi
+fastapi-users[beanie]
+uvicorn[standard]
+
+
+
+
import uvicorn
+
+if __name__ == "__main__":
+    uvicorn.run("app.app:app", host="0.0.0.0", log_level="info")
+
+
+
+
from beanie import init_beanie
+from fastapi import Depends, FastAPI
+
+from app.db import User, db
+from app.schemas import UserCreate, UserRead, UserUpdate
+from app.users import auth_backend, current_active_user, fastapi_users
+
+app = FastAPI()
+
+app.include_router(
+    fastapi_users.get_auth_router(auth_backend), prefix="/auth/jwt", tags=["auth"]
+)
+app.include_router(
+    fastapi_users.get_register_router(UserRead, UserCreate),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(
+    fastapi_users.get_reset_password_router(),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(
+    fastapi_users.get_verify_router(UserRead),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(
+    fastapi_users.get_users_router(UserRead, UserUpdate),
+    prefix="/users",
+    tags=["users"],
+)
+
+
+@app.get("/authenticated-route")
+async def authenticated_route(user: User = Depends(current_active_user)):
+    return {"message": f"Hello {user.email}!"}
+
+
+@app.on_event("startup")
+async def on_startup():
+    await init_beanie(
+        database=db,
+        document_models=[
+            User,
+        ],
+    )
+
+
+
+
import motor.motor_asyncio
+from beanie import PydanticObjectId
+from fastapi_users.db import BeanieBaseUser, BeanieUserDatabase
+
+DATABASE_URL = "mongodb://localhost:27017"
+client = motor.motor_asyncio.AsyncIOMotorClient(
+    DATABASE_URL, uuidRepresentation="standard"
+)
+db = client["database_name"]
+
+
+class User(BeanieBaseUser[PydanticObjectId]):
+    pass
+
+
+async def get_user_db():
+    yield BeanieUserDatabase(User)
+
+
+
+
from beanie import PydanticObjectId
+from fastapi_users import schemas
+
+
+class UserRead(schemas.BaseUser[PydanticObjectId]):
+    pass
+
+
+class UserCreate(schemas.BaseUserCreate):
+    pass
+
+
+class UserUpdate(schemas.BaseUserUpdate):
+    pass
+
+
+
+
from typing import Optional
+
+from beanie import PydanticObjectId
+from fastapi import Depends, Request
+from fastapi_users import BaseUserManager, FastAPIUsers
+from fastapi_users.authentication import (
+    AuthenticationBackend,
+    BearerTransport,
+    JWTStrategy,
+)
+from fastapi_users.db import BeanieUserDatabase, ObjectIDIDMixin
+
+from app.db import User, get_user_db
+
+SECRET = "SECRET"
+
+
+class UserManager(ObjectIDIDMixin, BaseUserManager[User, PydanticObjectId]):
+    reset_password_token_secret = SECRET
+    verification_token_secret = SECRET
+
+    async def on_after_register(self, user: User, request: Optional[Request] = None):
+        print(f"User {user.id} has registered.")
+
+    async def on_after_forgot_password(
+        self, user: User, token: str, request: Optional[Request] = None
+    ):
+        print(f"User {user.id} has forgot their password. Reset token: {token}")
+
+    async def on_after_request_verify(
+        self, user: User, token: str, request: Optional[Request] = None
+    ):
+        print(f"Verification requested for user {user.id}. Verification token: {token}")
+
+
+async def get_user_manager(user_db: BeanieUserDatabase = Depends(get_user_db)):
+    yield UserManager(user_db)
+
+
+bearer_transport = BearerTransport(tokenUrl="auth/jwt/login")
+
+
+def get_jwt_strategy() -> JWTStrategy:
+    return JWTStrategy(secret=SECRET, lifetime_seconds=3600)
+
+
+auth_backend = AuthenticationBackend(
+    name="jwt",
+    transport=bearer_transport,
+    get_strategy=get_jwt_strategy,
+)
+
+fastapi_users = FastAPIUsers[User, PydanticObjectId](get_user_manager, [auth_backend])
+
+current_active_user = fastapi_users.current_user(active=True)
+
+
+
+
+

What now?

+

You're ready to go! Be sure to check the Usage section to understand how to work with FastAPI Users.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/oauth/index.html b/10.3/configuration/oauth/index.html new file mode 100644 index 00000000..54496df1 --- /dev/null +++ b/10.3/configuration/oauth/index.html @@ -0,0 +1,1955 @@ + + + + + + + + + + + + + + + + + + + + + + + + OAuth2 - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

OAuth2

+

FastAPI Users provides an optional OAuth2 authentication support. It relies on HTTPX OAuth library, which is a pure-async implementation of OAuth2.

+

Installation

+

You should install the library with the optional dependencies for OAuth:

+
pip install 'fastapi-users[sqlalchemy,oauth]'
+
+
pip install 'fastapi-users[beanie,oauth]'
+
+

Configuration

+

Instantiate an OAuth2 client

+

You first need to get an HTTPX OAuth client instance. Read the documentation for more information.

+
from httpx_oauth.clients.google import GoogleOAuth2
+
+google_oauth_client = GoogleOAuth2("CLIENT_ID", "CLIENT_SECRET")
+
+

Setup the database adapter

+

SQLAlchemy

+

You'll need to define the SQLAlchemy model for storing OAuth accounts. We provide a base one for this:

+
from typing import AsyncGenerator, List
+
+from fastapi import Depends
+from fastapi_users.db import (
+    SQLAlchemyBaseOAuthAccountTableUUID,
+    SQLAlchemyBaseUserTableUUID,
+    SQLAlchemyUserDatabase,
+)
+from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine
+from sqlalchemy.orm import DeclarativeMeta, declarative_base, relationship, sessionmaker
+
+DATABASE_URL = "sqlite+aiosqlite:///./test.db"
+Base: DeclarativeMeta = declarative_base()
+
+
+class OAuthAccount(SQLAlchemyBaseOAuthAccountTableUUID, Base):
+    pass
+
+
+class User(SQLAlchemyBaseUserTableUUID, Base):
+    oauth_accounts: List[OAuthAccount] = relationship("OAuthAccount", lazy="joined")
+
+
+engine = create_async_engine(DATABASE_URL)
+async_session_maker = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)
+
+
+async def create_db_and_tables():
+    async with engine.begin() as conn:
+        await conn.run_sync(Base.metadata.create_all)
+
+
+async def get_async_session() -> AsyncGenerator[AsyncSession, None]:
+    async with async_session_maker() as session:
+        yield session
+
+
+async def get_user_db(session: AsyncSession = Depends(get_async_session)):
+    yield SQLAlchemyUserDatabase(session, User, OAuthAccount)
+
+

Notice that we also manually added a relationship on the UserTable so that SQLAlchemy can properly retrieve the OAuth accounts of the user.

+

Besides, when instantiating the database adapter, we need pass this SQLAlchemy model as third argument.

+
+

Primary key is defined as UUID

+

By default, we use UUID as a primary key ID for your user. If you want to use another type, like an auto-incremented integer, you can use SQLAlchemyBaseOAuthAccountTable as base class and define your own id and user_id column.

+
class OAuthAccount(SQLAlchemyBaseOAuthAccountTable[int], Base):
+    id = Column(Integer, primary_key=True)
+
+    @declared_attr
+    def user_id(cls):
+        return Column(Integer, ForeignKey("user.id", ondelete="cascade"), nullable=False)
+
+

Notice that SQLAlchemyBaseOAuthAccountTable expects a generic type to define the actual type of ID you use.

+
+

Beanie

+

The advantage of MongoDB is that you can easily embed sub-objects in a single document. That's why the configuration for Beanie is quite simple. All we need to do is to define another class to structure an OAuth account object.

+
from typing import List
+
+import motor.motor_asyncio
+from beanie import PydanticObjectId
+from fastapi_users.db import BaseOAuthAccount, BeanieBaseUser, BeanieUserDatabase
+from pydantic import Field
+
+DATABASE_URL = "mongodb://localhost:27017"
+client = motor.motor_asyncio.AsyncIOMotorClient(
+    DATABASE_URL, uuidRepresentation="standard"
+)
+db = client["database_name"]
+
+
+class OAuthAccount(BaseOAuthAccount):
+    pass
+
+
+class User(BeanieBaseUser[PydanticObjectId]):
+    oauth_accounts: List[OAuthAccount] = Field(default_factory=list)
+
+
+async def get_user_db():
+    yield BeanieUserDatabase(User, OAuthAccount)
+
+

It's worth to note that OAuthAccount is not a Beanie document but a Pydantic model that we'll embed inside the User document, through the oauth_accounts array.

+

Generate routers

+

Once you have a FastAPIUsers instance, you can make it generate a single OAuth router for a given client and authentication backend.

+
app.include_router(
+    fastapi_users.get_oauth_router(google_oauth_client, auth_backend, "SECRET"),
+    prefix="/auth/google",
+    tags=["auth"],
+)
+
+
+

Tip

+

If you have several OAuth clients and/or several authentication backends, you'll need to create a router for each pair you want to support.

+
+

Existing account association

+

If a user with the same e-mail address already exists, an HTTP 400 error will be raised by default.

+

You can however choose to automatically link this OAuth account to the existing user account by setting the associate_by_email flag:

+
app.include_router(
+    fastapi_users.get_oauth_router(
+        google_oauth_client,
+        auth_backend,
+        "SECRET",
+        associate_by_email=True,
+    ),
+    prefix="/auth/google",
+    tags=["auth"],
+)
+
+

Bear in mind though that it can lead to security breaches if the OAuth provider does not validate e-mail addresses. How?

+
    +
  • Let's say your app support an OAuth provider, Merlinbook, which does not validate e-mail addresses.
    • +
  • Imagine a user registers to your app with the e-mail address lancelot@camelot.bt.
    • +
  • Now, a malicious user creates an account on Merlinbook with the same e-mail address. Without e-mail validation, the malicious user can use this account without limitation.
    • +
  • The malicious user authenticates using Merlinbook OAuth on your app, which automatically associates to the existing lancelot@camelot.bt.
    • +
  • Now, the malicious user has full access to the user account on your app 😞
    • +
+

Association router for authenticated users

+

We also provide a router to associate an already authenticated user with an OAuth account. After this association, the user will be able to authenticate with this OAuth provider.

+
app.include_router(
+    fastapi_users.get_oauth_associate_router(google_oauth_client, UserRead, "SECRET"),
+    prefix="/auth/associate/google",
+    tags=["auth"],
+)
+
+

Notice that, just like for the Users router, you have to pass the UserRead Pydantic schema.

+

Full example

+
+

Warning

+

Notice that SECRET should be changed to a strong passphrase. +Insecure passwords may give attackers full access to your database.

+
+

SQLAlchemy

+

Open

+
+
+
+
fastapi
+fastapi-users[sqlalchemy]
+uvicorn[standard]
+aiosqlite
+
+
+
+
import uvicorn
+
+if __name__ == "__main__":
+    uvicorn.run("app.app:app", host="0.0.0.0", log_level="info")
+
+
+
+
from fastapi import Depends, FastAPI
+
+from app.db import User, create_db_and_tables
+from app.schemas import UserCreate, UserRead, UserUpdate
+from app.users import (
+    SECRET,
+    auth_backend,
+    current_active_user,
+    fastapi_users,
+    google_oauth_client,
+)
+
+app = FastAPI()
+
+app.include_router(
+    fastapi_users.get_auth_router(auth_backend), prefix="/auth/jwt", tags=["auth"]
+)
+app.include_router(
+    fastapi_users.get_register_router(UserRead, UserCreate),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(
+    fastapi_users.get_reset_password_router(),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(
+    fastapi_users.get_verify_router(UserRead),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(
+    fastapi_users.get_users_router(UserRead, UserUpdate),
+    prefix="/users",
+    tags=["users"],
+)
+app.include_router(
+    fastapi_users.get_oauth_router(google_oauth_client, auth_backend, SECRET),
+    prefix="/auth/google",
+    tags=["auth"],
+)
+
+
+@app.get("/authenticated-route")
+async def authenticated_route(user: User = Depends(current_active_user)):
+    return {"message": f"Hello {user.email}!"}
+
+
+@app.on_event("startup")
+async def on_startup():
+    # Not needed if you setup a migration system like Alembic
+    await create_db_and_tables()
+
+
+
+
from typing import AsyncGenerator, List
+
+from fastapi import Depends
+from fastapi_users.db import (
+    SQLAlchemyBaseOAuthAccountTableUUID,
+    SQLAlchemyBaseUserTableUUID,
+    SQLAlchemyUserDatabase,
+)
+from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine
+from sqlalchemy.orm import DeclarativeMeta, declarative_base, relationship, sessionmaker
+
+DATABASE_URL = "sqlite+aiosqlite:///./test.db"
+Base: DeclarativeMeta = declarative_base()
+
+
+class OAuthAccount(SQLAlchemyBaseOAuthAccountTableUUID, Base):
+    pass
+
+
+class User(SQLAlchemyBaseUserTableUUID, Base):
+    oauth_accounts: List[OAuthAccount] = relationship("OAuthAccount", lazy="joined")
+
+
+engine = create_async_engine(DATABASE_URL)
+async_session_maker = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)
+
+
+async def create_db_and_tables():
+    async with engine.begin() as conn:
+        await conn.run_sync(Base.metadata.create_all)
+
+
+async def get_async_session() -> AsyncGenerator[AsyncSession, None]:
+    async with async_session_maker() as session:
+        yield session
+
+
+async def get_user_db(session: AsyncSession = Depends(get_async_session)):
+    yield SQLAlchemyUserDatabase(session, User, OAuthAccount)
+
+
+
+
import uuid
+
+from fastapi_users import schemas
+
+
+class UserRead(schemas.BaseUser[uuid.UUID]):
+    pass
+
+
+class UserCreate(schemas.BaseUserCreate):
+    pass
+
+
+class UserUpdate(schemas.BaseUserUpdate):
+    pass
+
+
+
+
import os
+import uuid
+from typing import Optional
+
+from fastapi import Depends, Request
+from fastapi_users import BaseUserManager, FastAPIUsers, UUIDIDMixin
+from fastapi_users.authentication import (
+    AuthenticationBackend,
+    BearerTransport,
+    JWTStrategy,
+)
+from fastapi_users.db import SQLAlchemyUserDatabase
+from httpx_oauth.clients.google import GoogleOAuth2
+
+from app.db import User, get_user_db
+
+SECRET = "SECRET"
+
+google_oauth_client = GoogleOAuth2(
+    os.getenv("GOOGLE_OAUTH_CLIENT_ID", ""),
+    os.getenv("GOOGLE_OAUTH_CLIENT_SECRET", ""),
+)
+
+
+class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):
+    reset_password_token_secret = SECRET
+    verification_token_secret = SECRET
+
+    async def on_after_register(self, user: User, request: Optional[Request] = None):
+        print(f"User {user.id} has registered.")
+
+    async def on_after_forgot_password(
+        self, user: User, token: str, request: Optional[Request] = None
+    ):
+        print(f"User {user.id} has forgot their password. Reset token: {token}")
+
+    async def on_after_request_verify(
+        self, user: User, token: str, request: Optional[Request] = None
+    ):
+        print(f"Verification requested for user {user.id}. Verification token: {token}")
+
+
+async def get_user_manager(user_db: SQLAlchemyUserDatabase = Depends(get_user_db)):
+    yield UserManager(user_db)
+
+
+bearer_transport = BearerTransport(tokenUrl="auth/jwt/login")
+
+
+def get_jwt_strategy() -> JWTStrategy:
+    return JWTStrategy(secret=SECRET, lifetime_seconds=3600)
+
+
+auth_backend = AuthenticationBackend(
+    name="jwt",
+    transport=bearer_transport,
+    get_strategy=get_jwt_strategy,
+)
+
+fastapi_users = FastAPIUsers[User, uuid.UUID](get_user_manager, [auth_backend])
+
+current_active_user = fastapi_users.current_user(active=True)
+
+
+
+
+

Beanie

+

Open

+
+
+
+
fastapi
+fastapi-users[beanie]
+uvicorn[standard]
+
+
+
+
import uvicorn
+
+if __name__ == "__main__":
+    uvicorn.run("app.app:app", host="0.0.0.0", log_level="info")
+
+
+
+
from beanie import init_beanie
+from fastapi import Depends, FastAPI
+
+from app.db import User, db
+from app.schemas import UserCreate, UserRead, UserUpdate
+from app.users import (
+    SECRET,
+    auth_backend,
+    current_active_user,
+    fastapi_users,
+    google_oauth_client,
+)
+
+app = FastAPI()
+
+app.include_router(
+    fastapi_users.get_auth_router(auth_backend), prefix="/auth/jwt", tags=["auth"]
+)
+app.include_router(
+    fastapi_users.get_register_router(UserRead, UserCreate),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(
+    fastapi_users.get_reset_password_router(),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(
+    fastapi_users.get_verify_router(UserRead),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(
+    fastapi_users.get_users_router(UserRead, UserUpdate),
+    prefix="/users",
+    tags=["users"],
+)
+app.include_router(
+    fastapi_users.get_oauth_router(google_oauth_client, auth_backend, SECRET),
+    prefix="/auth/google",
+    tags=["auth"],
+)
+
+
+@app.get("/authenticated-route")
+async def authenticated_route(user: User = Depends(current_active_user)):
+    return {"message": f"Hello {user.email}!"}
+
+
+@app.on_event("startup")
+async def on_startup():
+    await init_beanie(
+        database=db,
+        document_models=[
+            User,
+        ],
+    )
+
+
+
+
from typing import List
+
+import motor.motor_asyncio
+from beanie import PydanticObjectId
+from fastapi_users.db import BaseOAuthAccount, BeanieBaseUser, BeanieUserDatabase
+from pydantic import Field
+
+DATABASE_URL = "mongodb://localhost:27017"
+client = motor.motor_asyncio.AsyncIOMotorClient(
+    DATABASE_URL, uuidRepresentation="standard"
+)
+db = client["database_name"]
+
+
+class OAuthAccount(BaseOAuthAccount):
+    pass
+
+
+class User(BeanieBaseUser[PydanticObjectId]):
+    oauth_accounts: List[OAuthAccount] = Field(default_factory=list)
+
+
+async def get_user_db():
+    yield BeanieUserDatabase(User, OAuthAccount)
+
+
+
+
from beanie import PydanticObjectId
+from fastapi_users import schemas
+
+
+class UserRead(schemas.BaseUser[PydanticObjectId]):
+    pass
+
+
+class UserCreate(schemas.BaseUserCreate):
+    pass
+
+
+class UserUpdate(schemas.BaseUserUpdate):
+    pass
+
+
+
+
import os
+from typing import Optional
+
+from beanie import PydanticObjectId
+from fastapi import Depends, Request
+from fastapi_users import BaseUserManager, FastAPIUsers
+from fastapi_users.authentication import (
+    AuthenticationBackend,
+    BearerTransport,
+    JWTStrategy,
+)
+from fastapi_users.db import BeanieUserDatabase, ObjectIDIDMixin
+from httpx_oauth.clients.google import GoogleOAuth2
+
+from app.db import User, get_user_db
+
+SECRET = "SECRET"
+
+google_oauth_client = GoogleOAuth2(
+    os.getenv("GOOGLE_OAUTH_CLIENT_ID", ""),
+    os.getenv("GOOGLE_OAUTH_CLIENT_SECRET", ""),
+)
+
+
+class UserManager(ObjectIDIDMixin, BaseUserManager[User, PydanticObjectId]):
+    reset_password_token_secret = SECRET
+    verification_token_secret = SECRET
+
+    async def on_after_register(self, user: User, request: Optional[Request] = None):
+        print(f"User {user.id} has registered.")
+
+    async def on_after_forgot_password(
+        self, user: User, token: str, request: Optional[Request] = None
+    ):
+        print(f"User {user.id} has forgot their password. Reset token: {token}")
+
+    async def on_after_request_verify(
+        self, user: User, token: str, request: Optional[Request] = None
+    ):
+        print(f"Verification requested for user {user.id}. Verification token: {token}")
+
+
+async def get_user_manager(user_db: BeanieUserDatabase = Depends(get_user_db)):
+    yield UserManager(user_db)
+
+
+bearer_transport = BearerTransport(tokenUrl="auth/jwt/login")
+
+
+def get_jwt_strategy() -> JWTStrategy:
+    return JWTStrategy(secret=SECRET, lifetime_seconds=3600)
+
+
+auth_backend = AuthenticationBackend(
+    name="jwt",
+    transport=bearer_transport,
+    get_strategy=get_jwt_strategy,
+)
+
+fastapi_users = FastAPIUsers[User, PydanticObjectId](get_user_manager, [auth_backend])
+
+current_active_user = fastapi_users.current_user(active=True)
+
+
+
+
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/overview/index.html b/10.3/configuration/overview/index.html new file mode 100644 index 00000000..06e12227 --- /dev/null +++ b/10.3/configuration/overview/index.html @@ -0,0 +1,1345 @@ + + + + + + + + + + + + + + + + + + + + + + + + Overview - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Overview

+

The schema below shows you how the library is structured and how each part fit together.

+
flowchart TB
+    FASTAPI_USERS{FastAPIUsers}
+    USER_MANAGER{UserManager}
+    USER_MODEL{User model}
+    DATABASE_DEPENDENCY[[get_user_db]]
+    USER_MANAGER_DEPENDENCY[[get_user_manager]]
+    CURRENT_USER[[current_user]]
+    subgraph SCHEMAS[Schemas]
+        USER[User]
+        USER_CREATE[UserCreate]
+        USER_UPDATE[UserUpdate]
+    end
+    subgraph DATABASE[Database adapters]
+        SQLALCHEMY[SQLAlchemy]
+        BEANIE[Beanie]
+    end
+    subgraph ROUTERS[Routers]
+        AUTH[[get_auth_router]]
+        OAUTH[[get_oauth_router]]
+        OAUTH_ASSOCIATE[[get_oauth_associate_router]]
+        REGISTER[[get_register_router]]
+        VERIFY[[get_verify_router]]
+        RESET[[get_reset_password_router]]
+        USERS[[get_users_router]]
+    end
+    subgraph AUTH_BACKENDS[Authentication]
+        subgraph TRANSPORTS[Transports]
+            COOKIE[CookieTransport]
+            BEARER[BearerTransport]
+        end
+        subgraph STRATEGIES[Strategies]
+            DB[DatabaseStrategy]
+            JWT[JWTStrategy]
+            REDIS[RedisStrategy]
+        end
+        AUTH_BACKEND{AuthenticationBackend}
+    end
+    DATABASE --> DATABASE_DEPENDENCY
+    USER_MODEL --> DATABASE_DEPENDENCY
+    DATABASE_DEPENDENCY --> USER_MANAGER
+
+    USER_MANAGER --> USER_MANAGER_DEPENDENCY
+    USER_MANAGER_DEPENDENCY --> FASTAPI_USERS
+
+    FASTAPI_USERS --> ROUTERS
+
+    TRANSPORTS --> AUTH_BACKEND
+    STRATEGIES --> AUTH_BACKEND
+
+    AUTH_BACKEND --> ROUTERS
+    AUTH_BACKEND --> FASTAPI_USERS
+
+    FASTAPI_USERS --> CURRENT_USER
+
+    SCHEMAS --> ROUTERS
+

User model and database adapters

+

FastAPI Users is compatible with various databases and ORM. To build the interface between those database tools and the library, we provide database adapters classes that you need to instantiate and configure.

+

➡️ I'm using SQLAlchemy

+

➡️ I'm using Beanie

+

Authentication backends

+

Authentication backends define the way users sessions are managed in your app, like access tokens or cookies.

+

They are composed of two parts: a transport, which is how the token will be carried over the requests (e.g. cookies, headers...) and a strategy, which is how the token will be generated and secured (e.g. a JWT, a token in database...).

+

➡️ Configure the authentication backends

+

UserManager

+

The UserManager object bears most of the logic of FastAPI Users: registration, verification, password reset... We provide a BaseUserManager with this common logic; which you should overload to define how to validate passwords or handle events.

+

This UserManager object should be provided through a FastAPI dependency, get_user_manager.

+

➡️ Configure UserManager

+

Schemas

+

FastAPI is heavily using Pydantic models to validate request payloads and serialize responses. FastAPI Users is no exception and will expect you to provide Pydantic schemas representing a user when it's read, created and updated.

+

➡️ Configure schemas

+

FastAPIUsers and routers

+

Finally, FastAPIUsers object is the main class from which you'll be able to generate routers for classic routes like registration or login, but also get the current_user dependency factory to inject the authenticated user in your own routes.

+

➡️ Configure FastAPIUsers and routers

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/password-hash/index.html b/10.3/configuration/password-hash/index.html new file mode 100644 index 00000000..1e62ccfe --- /dev/null +++ b/10.3/configuration/password-hash/index.html @@ -0,0 +1,1272 @@ + + + + + + + + + + + + + + + + + + + + + + + + Password hash - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Password hash

+

By default, FastAPI Users will use the BCrypt algorithm to hash and salt passwords before storing them in the database.

+

The implementation is provided by Passlib, a battle-tested Python library for password hashing.

+

Customize CryptContext

+

If you need to support other hashing algorithms, you can customize the CryptContext object of Passlib.

+

For this, you'll need to instantiate the PasswordHelper class and pass it your CryptContext. The example below shows you how you can create a CryptContext to add support for the Argon2 algorithm while deprecating BCrypt.

+
from fastapi_users.password import PasswordHelper
+from passlib.context import CryptContext
+
+context = CryptContext(schemes=["argon2", "bcrypt"], deprecated="auto")
+password_helper = PasswordHelper(context)
+
+

Finally, pass the password_helper variable while instantiating your UserManager:

+
async def get_user_manager(user_db=Depends(get_user_db)):
+    yield UserManager(user_db, password_helper)
+
+
+

Password hashes are automatically upgraded

+

FastAPI Users takes care of upgrading the password hash to a more recent algorithm when needed.

+

Typically, when a user logs in, we'll check if the password hash algorithm is deprecated.

+

If it is, we take the opportunity of having the password in plain-text at hand (since the user just logged in!) to hash it with a better algorithm and update it in database.

+
+
+

Dependencies for alternative algorithms are not included by default

+

FastAPI Users won't install required dependencies to make other algorithms like Argon2 work. It's up to you to install them.

+
+

Full customization

+

If you don't wist to use Passlib at all – which we don't recommend unless you're absolutely sure of what you're doing — you can implement your own PasswordHelper class as long as it implements the PasswordHelperProtocol and its methods.

+
from typing import Tuple
+
+from fastapi_users.password import PasswordHelperProtocol
+
+class PasswordHelper(PasswordHelperProtocol):
+    def verify_and_update(
+        self, plain_password: str, hashed_password: str
+    ) -> Tuple[bool, str]:
+        ...
+
+    def hash(self, password: str) -> str:
+        ...
+
+    def generate(self) -> str:
+        ...
+
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/routers/auth/index.html b/10.3/configuration/routers/auth/index.html new file mode 100644 index 00000000..00cad36d --- /dev/null +++ b/10.3/configuration/routers/auth/index.html @@ -0,0 +1,1273 @@ + + + + + + + + + + + + + + + + + + + + + + + + Auth router - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Auth router

+

The auth router will generate /login and /logout routes for a given authentication backend.

+

Check the routes usage to learn how to use them.

+

Setup

+
import uuid
+
+from fastapi import FastAPI
+from fastapi_users import FastAPIUsers
+
+from .db import User
+
+fastapi_users = FastAPIUsers[User, uuid.UUID](
+    get_user_manager,
+    [auth_backend],
+)
+
+app = FastAPI()
+app.include_router(
+    fastapi_users.get_auth_router(auth_backend),
+    prefix="/auth/jwt",
+    tags=["auth"],
+)
+
+

Optional: user verification

+

You can require the user to be verified (i.e. is_verified property set to True) to allow login. You have to set the requires_verification parameter to True on the router instantiation method:

+
app.include_router(
+    fastapi_users.get_auth_router(auth_backend, requires_verification=True),
+    prefix="/auth/jwt",
+    tags=["auth"],
+)
+
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/routers/index.html b/10.3/configuration/routers/index.html new file mode 100644 index 00000000..5bc7188a --- /dev/null +++ b/10.3/configuration/routers/index.html @@ -0,0 +1,1270 @@ + + + + + + + + + + + + + + + + + + + + + + + + Introduction - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Routers

+

We're almost there! The last step is to configure the FastAPIUsers object that will wire the user manager, the authentication classes and let us generate the actual API routes.

+

Configure FastAPIUsers

+

Configure FastAPIUsers object with the elements we defined before. More precisely:

+
    +
  • get_user_manager: Dependency callable getter to inject the + user manager class instance. See UserManager.
    • +
  • auth_backends: List of authentication backends. See Authentication.
    • +
+
import uuid
+
+from fastapi_users import FastAPIUsers
+
+from .db import User
+
+fastapi_users = FastAPIUsers[User, uuid.UUID](
+    get_user_manager,
+    [auth_backend],
+)
+
+
+

Typing: User and ID generic types are expected

+

You can see that we define two generic types when instantiating:

+
    +
  • User, which is the user model we defined in the database part
    • +
  • The ID, which should correspond to the type of ID you use on your model. Here, we chose UUID, but it can be anything, like an integer or a MongoDB ObjectID.
    • +
+

It'll help you to have good type-checking and auto-completion.

+
+

Available routers

+

This helper class will let you generate useful routers to setup the authentication system. Each of them is optional, so you can pick only the one that you are interested in! Here are the routers provided:

+
    +
  • Auth router: Provides /login and /logout routes for a given authentication backend.
    • +
  • Register router: Provides /register routes to allow a user to create a new account.
    • +
  • Reset password router: Provides /forgot-password and /reset-password routes to allow a user to reset its password.
    • +
  • Verify router: Provides /request-verify-token and /verify routes to manage user e-mail verification.
    • +
  • Users router: Provides routes to manage users.
    • +
  • OAuth router: Provides routes to perform an OAuth authentication against a service provider (like Google or Facebook).
    • +
+

You should check out each of them to understand how to use them.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/routers/register/index.html b/10.3/configuration/routers/register/index.html new file mode 100644 index 00000000..8ded0ed9 --- /dev/null +++ b/10.3/configuration/routers/register/index.html @@ -0,0 +1,1240 @@ + + + + + + + + + + + + + + + + + + + + + + + + Register routes - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Register routes

+

The register router will generate a /register route to allow a user to create a new account.

+

Check the routes usage to learn how to use them.

+

Setup

+
import uuid
+
+from fastapi import FastAPI
+from fastapi_users import FastAPIUsers
+
+from .db import User
+from .schemas import UserCreate, UserRead
+
+fastapi_users = FastAPIUsers[User, uuid.UUID](
+    get_user_manager,
+    [auth_backend],
+)
+
+app = FastAPI()
+app.include_router(
+    fastapi_users.get_register_router(UserRead, UserCreate),
+    prefix="/auth",
+    tags=["auth"],
+)
+
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/routers/reset/index.html b/10.3/configuration/routers/reset/index.html new file mode 100644 index 00000000..9a125f01 --- /dev/null +++ b/10.3/configuration/routers/reset/index.html @@ -0,0 +1,1239 @@ + + + + + + + + + + + + + + + + + + + + + + + + Reset password router - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Reset password router

+

The reset password router will generate /forgot-password (the user asks for a token to reset its password) and /reset-password (the user changes its password given the token) routes.

+

Check the routes usage to learn how to use them.

+

Setup

+
import uuid
+
+from fastapi import FastAPI
+from fastapi_users import FastAPIUsers
+
+from .db import User
+
+fastapi_users = FastAPIUsers[User, uuid.UUID](
+    get_user_manager,
+    [auth_backend],
+)
+
+app = FastAPI()
+app.include_router(
+    fastapi_users.get_reset_password_router(),
+    prefix="/auth",
+    tags=["auth"],
+)
+
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/routers/users/index.html b/10.3/configuration/routers/users/index.html new file mode 100644 index 00000000..816f87fd --- /dev/null +++ b/10.3/configuration/routers/users/index.html @@ -0,0 +1,1273 @@ + + + + + + + + + + + + + + + + + + + + + + + + Users router - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Users router

+

This router provides routes to manage users. Check the routes usage to learn how to use them.

+

Setup

+
import uuid
+
+from fastapi import FastAPI
+from fastapi_users import FastAPIUsers
+
+from .db import User
+from .schemas import UserRead, UserUpdate
+
+fastapi_users = FastAPIUsers[User, uuid.UUID](
+    get_user_manager,
+    [auth_backend],
+)
+
+app = FastAPI()
+app.include_router(
+    fastapi_users.get_users_router(UserRead, UserUpdate),
+    prefix="/users",
+    tags=["users"],
+)
+
+

Optional: user verification

+

You can require the user to be verified (i.e. is_verified property set to True) to access those routes. You have to set the requires_verification parameter to True on the router instantiation method:

+
app.include_router(
+    fastapi_users.get_users_router(UserRead, UserUpdate, requires_verification=True),
+    prefix="/users",
+    tags=["users"],
+)
+
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/routers/verify/index.html b/10.3/configuration/routers/verify/index.html new file mode 100644 index 00000000..c71c28ba --- /dev/null +++ b/10.3/configuration/routers/verify/index.html @@ -0,0 +1,1243 @@ + + + + + + + + + + + + + + + + + + + + + + + + Verify router - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Verify router

+

This router provides routes to manage user email verification. Check the routes usage to learn how to use them.

+
+

👏👏👏

+

A big thank you to Edd Salkield and Mark Todd who worked hard on this feature!

+
+

Setup

+
import uuid
+
+from fastapi import FastAPI
+from fastapi_users import FastAPIUsers
+
+from .db import User
+from .schemas import UserRead
+
+fastapi_users = FastAPIUsers[User, uuid.UUID](
+    get_user_manager,
+    [auth_backend],
+)
+
+app = FastAPI()
+app.include_router(
+    fastapi_users.get_verify_router(UserRead),
+    prefix="/auth",
+    tags=["auth"],
+)
+
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/schemas/index.html b/10.3/configuration/schemas/index.html new file mode 100644 index 00000000..002972f6 --- /dev/null +++ b/10.3/configuration/schemas/index.html @@ -0,0 +1,1305 @@ + + + + + + + + + + + + + + + + + + + + + + + + Schemas - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Schemas

+

FastAPI is heavily using Pydantic models to validate request payloads and serialize responses. FastAPI Users is no exception and will expect you to provide Pydantic schemas representing a user when it's read, created and updated.

+

It's different from your User model, which is an object that actually interacts with the database. Those schemas on the other hand are here to validate data and serialize correct it in the API.

+

FastAPI Users provides a base structure to cover its needs. It is structured like this:

+
    +
  • id (ID) – Unique identifier of the user. It matches the type of your ID, like UUID or integer.
    • +
  • email (str) – Email of the user. Validated by email-validator.
    • +
  • is_active (bool) – Whether or not the user is active. If not, login and forgot password requests will be denied. Defaults to True.
    • +
  • is_verified (bool) – Whether or not the user is verified. Optional but helpful with the verify router logic. Defaults to False.
    • +
  • is_superuser (bool) – Whether or not the user is a superuser. Useful to implement administration logic. Defaults to False.
    • +
+

Define your schemas

+

There are four Pydantic models variations provided as mixins:

+
    +
  • BaseUser, which provides the basic fields and validation;
    • +
  • BaseCreateUser, dedicated to user registration, which consists of compulsory email and password fields;
    • +
  • BaseUpdateUser, dedicated to user profile update, which adds an optional password field;
    • +
+

You should define each of those variations, inheriting from each mixin:

+
import uuid
+
+from fastapi_users import schemas
+
+
+class UserRead(schemas.BaseUser[uuid.UUID]):
+    pass
+
+
+class UserCreate(schemas.BaseUserCreate):
+    pass
+
+
+class UserUpdate(schemas.BaseUserUpdate):
+    pass
+
+
+

Typing: ID generic type is expected

+

You can see that we define a generic type when extending the BaseUser class. It should correspond to the type of ID you use on your model. Here, we chose UUID, but it can be anything, like an integer or a MongoDB ObjectID.

+
+

Adding your own fields

+

You can of course add your own properties there to fit to your needs. In the example below, we add a required string property, first_name, and an optional date property, birthdate.

+
import datetime
+import uuid
+
+from fastapi_users import schemas
+
+
+class UserRead(schemas.BaseUser[uuid.UUID]):
+    first_name: str
+    birthdate: Optional[datetime.date]
+
+
+class UserCreate(schemas.BaseUserCreate):
+    first_name: str
+    birthdate: Optional[datetime.date]
+
+
+class UserUpdate(schemas.BaseUserUpdate):
+    first_name: Optional[str]
+    birthdate: Optional[datetime.date]
+
+
+

Make sure to mirror this in your database model

+

The User model you defined earlier for your specific database will be the central object that will actually store the data. Therefore, you need to define the very same fields in it so the data can be actually stored.

+
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/configuration/user-manager/index.html b/10.3/configuration/user-manager/index.html new file mode 100644 index 00000000..f39fe007 --- /dev/null +++ b/10.3/configuration/user-manager/index.html @@ -0,0 +1,1781 @@ + + + + + + + + + + + + + + + + + + + + + + + + UserManager - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

UserManager

+

The UserManager class is the core logic of FastAPI Users. We provide the BaseUserManager class which you should extend to set some parameters and define logic, for example when a user just registered or forgot its password.

+

It's designed to be easily extensible and customizable so that you can integrate your very own logic.

+

Create your UserManager class

+

You should define your own version of the UserManager class to set various parameters.

+
import uuid
+from typing import Optional
+
+from fastapi import Depends, Request
+from fastapi_users import BaseUserManager, UUIDIDMixin
+
+from .db import User, get_user_db
+
+SECRET = "SECRET"
+
+
+class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):
+    reset_password_token_secret = SECRET
+    verification_token_secret = SECRET
+
+    async def on_after_register(self, user: User, request: Optional[Request] = None):
+        print(f"User {user.id} has registered.")
+
+    async def on_after_forgot_password(
+        self, user: User, token: str, request: Optional[Request] = None
+    ):
+        print(f"User {user.id} has forgot their password. Reset token: {token}")
+
+    async def on_after_request_verify(
+        self, user: User, token: str, request: Optional[Request] = None
+    ):
+        print(f"Verification requested for user {user.id}. Verification token: {token}")
+
+
+async def get_user_manager(user_db=Depends(get_user_db)):
+    yield UserManager(user_db)
+
+

As you can see, you have to define here various attributes and methods. You can find the complete list of those below.

+
+

Typing: User and ID generic types are expected

+

You can see that we define two generic types when extending the base class:

+
    +
  • User, which is the user model we defined in the database part
    • +
  • The ID, which should correspond to the type of ID you use on your model. Here, we chose UUID, but it can be anything, like an integer or a MongoDB ObjectID.
    • +
+

It'll help you to have good type-checking and auto-completion when implementing the custom methods.

+
+

The ID parser mixin

+

Since the user ID is fully generic, we need a way to parse it reliably when it'll come from API requests, typically as URL path attributes.

+

That's why we added the UUIDIDMixin in the example above. It implements the parse_id method, ensuring UUID are valid and correctly parsed.

+

Of course, it's important that this logic matches the type of your ID. To help you with this, we provide mixins for the most common cases:

+
    +
  • UUIDIDMixin, for UUID ID.
    • +
  • IntegerIDMixin, for integer ID.
    • +
  • ObjectIDIDMixin (provided by fastapi_users_db_beanie), for MongoDB ObjectID.
    • +
+
+

Inheritance order matters

+

Notice in your example that the mixin comes first in our UserManager inheritance. Because of the Method-Resolution-Order (MRO) of Python, the left-most element takes precedence.

+
+

If you need another type of ID, you can simply overload the parse_id method on your UserManager class:

+
from fastapi_users import BaseUserManager, InvalidID
+
+
+class UserManager(BaseUserManager[User, MyCustomID]):
+    def parse_id(self, value: Any) -> MyCustomID:
+        try:
+            return MyCustomID(value)
+        except ValueError as e:
+            raise InvalidID() from e  # (1)!
+
+
    +
  1. If the ID can't be parsed into the desired type, you'll need to raise an InvalidID exception.
    2. +
+

Create get_user_manager dependency

+

The UserManager class will be injected at runtime using a FastAPI dependency. This way, you can run it in a database session or swap it with a mock during testing.

+
import uuid
+from typing import Optional
+
+from fastapi import Depends, Request
+from fastapi_users import BaseUserManager, UUIDIDMixin
+
+from .db import User, get_user_db
+
+SECRET = "SECRET"
+
+
+class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):
+    reset_password_token_secret = SECRET
+    verification_token_secret = SECRET
+
+    async def on_after_register(self, user: User, request: Optional[Request] = None):
+        print(f"User {user.id} has registered.")
+
+    async def on_after_forgot_password(
+        self, user: User, token: str, request: Optional[Request] = None
+    ):
+        print(f"User {user.id} has forgot their password. Reset token: {token}")
+
+    async def on_after_request_verify(
+        self, user: User, token: str, request: Optional[Request] = None
+    ):
+        print(f"Verification requested for user {user.id}. Verification token: {token}")
+
+
+async def get_user_manager(user_db=Depends(get_user_db)):
+    yield UserManager(user_db)
+
+

Notice that we use the get_user_db dependency we defined earlier to inject the database instance.

+

Customize attributes and methods

+

Attributes

+
    +
  • reset_password_token_secret: Secret to encode reset password token. Use a strong passphrase and keep it secure.
    • +
  • reset_password_token_lifetime_seconds: Lifetime of reset password token. Defaults to 3600.
    • +
  • reset_password_token_audience: JWT audience of reset password token. Defaults to fastapi-users:reset.
    • +
  • verification_token_secret: Secret to encode verification token. Use a strong passphrase and keep it secure.
    • +
  • verification_token_lifetime_seconds: Lifetime of verification token. Defaults to 3600.
    • +
  • verification_token_audience: JWT audience of verification token. Defaults to fastapi-users:verify.
    • +
+

Methods

+

validate_password

+

Validate a password.

+

Arguments

+
    +
  • password (str): the password to validate.
    • +
  • user (Union[UserCreate, User]): user model which we are currently validating the password. Useful if you want to check that the password doesn't contain the name or the birthdate of the user for example.
    • +
+

Output

+

This function should return None if the password is valid or raise InvalidPasswordException if not. This exception expects an argument reason telling why the password is invalid. It'll be part of the error response.

+

Example

+
from fastapi_users import BaseUserManager, InvalidPasswordException, UUIDIDMixin
+
+
+class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):
+    # ...
+    async def validate_password(
+        self,
+        password: str,
+        user: Union[UserCreate, User],
+    ) -> None:
+        if len(password) < 8:
+            raise InvalidPasswordException(
+                reason="Password should be at least 8 characters"
+            )
+        if user.email in password:
+            raise InvalidPasswordException(
+                reason="Password should not contain e-mail"
+            )
+
+

on_after_register

+

Perform logic after successful user registration.

+

Typically, you'll want to send a welcome e-mail or add it to your marketing analytics pipeline.

+

Arguments

+
    +
  • user (User): the registered user.
    • +
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.
    • +
+

Example

+
from fastapi_users import BaseUserManager, UUIDIDMixin
+
+
+class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):
+    # ...
+    async def on_after_register(self, user: User, request: Optional[Request] = None):
+        print(f"User {user.id} has registered.")
+
+

on_after_update

+

Perform logic after successful user update.

+

It may be useful, for example, if you wish to update your user in a data analytics or customer success platform.

+

Arguments

+
    +
  • user (User): the updated user.
    • +
  • update_dict (Dict[str, Any]): dictionary with the updated user fields.
    • +
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.
    • +
+

Example

+
from fastapi_users import BaseUserManager, UUIDIDMixin
+
+
+class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):
+    # ...
+    async def on_after_update(
+        self,
+        user: User,
+        update_dict: Dict[str, Any],
+        request: Optional[Request] = None,
+    ):
+        print(f"User {user.id} has been updated with {update_dict}.")
+
+

on_after_login

+

Perform logic after a successful user login.

+

It may be useful for custom logic or processes triggered by new logins, for example a daily login reward or for analytics.

+

Arguments

+
    +
  • user (User): the updated user.
    • +
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.
    • +
+

Example

+
from fastapi_users import BaseUserManager, UUIDIDMixin
+
+
+class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):
+    # ...
+    async def on_after_login(
+        self,
+        user: User,
+        request: Optional[Request] = None,
+    ):
+        print(f"User {user.id} logged in.")
+
+

on_after_request_verify

+

Perform logic after successful verification request.

+

Typically, you'll want to send an e-mail with the link (and the token) that allows the user to verify their e-mail.

+

Arguments

+
    +
  • user (User): the user to verify.
    • +
  • token (str): the verification token.
    • +
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.
    • +
+

Example

+
from fastapi_users import BaseUserManager, UUIDIDMixin
+
+
+class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):
+    # ...
+    async def on_after_request_verify(
+        self, user: User, token: str, request: Optional[Request] = None
+    ):
+        print(f"Verification requested for user {user.id}. Verification token: {token}")
+
+

on_after_verify

+

Perform logic after successful user verification.

+

This may be useful if you wish to send another e-mail or store this information in a data analytics or customer success platform.

+

Arguments

+
    +
  • user (User): the verified user.
    • +
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.
    • +
+

Example

+
from fastapi_users import BaseUserManager, UUIDIDMixin
+
+
+class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):
+    # ...
+    async def on_after_verify(
+        self, user: User, request: Optional[Request] = None
+    ):
+        print(f"User {user.id} has been verified")
+
+

on_after_forgot_password

+

Perform logic after successful forgot password request.

+

Typically, you'll want to send an e-mail with the link (and the token) that allows the user to reset their password.

+

Arguments

+
    +
  • user (User): the user that forgot its password.
    • +
  • token (str): the forgot password token
    • +
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.
    • +
+

Example

+
from fastapi_users import BaseUserManager, UUIDIDMixin
+
+
+class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):
+    # ...
+    async def on_after_forgot_password(
+        self, user: User, token: str, request: Optional[Request] = None
+    ):
+        print(f"User {user.id} has forgot their password. Reset token: {token}")
+
+

on_after_reset_password

+

Perform logic after successful password reset.

+

For example, you may want to send an e-mail to the concerned user to warn him that their password has been changed and that they should take action if they think they have been hacked.

+

Arguments

+
    +
  • user (User): the user that reset its password.
    • +
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.
    • +
+

Example

+
from fastapi_users import BaseUserManager, UUIDIDMixin
+
+
+class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):
+    # ...
+    async def on_after_reset_password(self, user: User, request: Optional[Request] = None):
+        print(f"User {user.id} has reset their password.")
+
+

on_before_delete

+

Perform logic before user delete.

+

For example, you may want to valide user resource integrity to see if any related user resource need to be marked inactive, or delete +them recursively.

+

Arguments

+
    +
  • user (User): the user to be deleted.
    • +
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.
    • +
+

Example

+
from fastapi_users import BaseUserManager, UUIDIDMixin
+
+
+class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):
+    # ...
+    async def on_before_delete(self, user: User, request: Optional[Request] = None):
+        print(f"User {user.id} is going to be deleted")
+
+

on_after_delete

+

Perform logic after user delete.

+

For example, you may want to send an email to the administrator about the event.

+

Arguments

+
    +
  • user (User): the user to be deleted.
    • +
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.
    • +
+

Example

+
from fastapi_users import BaseUserManager, UUIDIDMixin
+
+
+class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):
+    # ...
+    async def on_after_delete(self, user: User, request: Optional[Request] = None):
+        print(f"User {user.id} is successfully deleted")
+
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/cookbook/create-user-programmatically/index.html b/10.3/cookbook/create-user-programmatically/index.html new file mode 100644 index 00000000..3766738b --- /dev/null +++ b/10.3/cookbook/create-user-programmatically/index.html @@ -0,0 +1,1318 @@ + + + + + + + + + + + + + + + + + + + + + + + + Create a user programmatically - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Create a user programmatically

+

Sometimes, you'll need to create a user programmatically in the code rather than passing by the REST API endpoint. To do this, we'll create a function that you can call from your code.

+

In this context, we are outside the dependency injection mechanism of FastAPI, so we have to take care of instantiating the UserManager class and all other dependent objects manually.

+

For this cookbook, we'll consider you are starting from the SQLAlchemy full example, but it'll be rather similar for other DBMS.

+

1. Define dependencies as context managers

+

Generally, FastAPI dependencies are defined as generators, using the yield keyword. FastAPI knows very well to handle them inside its dependency injection system. For example, here is the definition of the get_user_manager dependency:

+
async def get_user_manager(user_db: SQLAlchemyUserDatabase = Depends(get_user_db)):
+  yield UserManager(user_db)
+
+

In Python, when we want to use a generator, we have to use a for loop, which would be a bit unnatural in this context since we have only one value to get, the user manager instance. To avoid this, we'll transform them into context managers, so we can call them using the with..as syntax. Fortunately, the standard library provides tools to automatically transform generators into context managers.

+

In the following sample, we import our dependencies and create a context manager version using contextlib.asynccontextmanager:

+
import contextlib
+
+from app.db import get_async_session, get_user_db
+from app.schemas import UserCreate
+from app.users import get_user_manager
+from fastapi_users.exceptions import UserAlreadyExists
+
+get_async_session_context = contextlib.asynccontextmanager(get_async_session)
+get_user_db_context = contextlib.asynccontextmanager(get_user_db)
+get_user_manager_context = contextlib.asynccontextmanager(get_user_manager)
+
+
+async def create_user(email: str, password: str, is_superuser: bool = False):
+    try:
+        async with get_async_session_context() as session:
+            async with get_user_db_context(session) as user_db:
+                async with get_user_manager_context(user_db) as user_manager:
+                    user = await user_manager.create(
+                        UserCreate(
+                            email=email, password=password, is_superuser=is_superuser
+                        )
+                    )
+                    print(f"User created {user}")
+    except UserAlreadyExists:
+        print(f"User {email} already exists")
+
+
+

I have other dependencies

+

Since FastAPI Users fully embraces dependency injection, you may have more arguments passed to your database or user manager dependencies. It's important then to not forget anyone. Once again, outside the dependency injection system, you are responsible of instantiating everything yourself.

+
+

2. Write a function

+

We are now ready to write a function. The example below shows you a basic example but you can of course adapt it to your own needs. The key part here is once again to take care of opening every context managers and pass them every required arguments, as the dependency manager would do.

+
import contextlib
+
+from app.db import get_async_session, get_user_db
+from app.schemas import UserCreate
+from app.users import get_user_manager
+from fastapi_users.exceptions import UserAlreadyExists
+
+get_async_session_context = contextlib.asynccontextmanager(get_async_session)
+get_user_db_context = contextlib.asynccontextmanager(get_user_db)
+get_user_manager_context = contextlib.asynccontextmanager(get_user_manager)
+
+
+async def create_user(email: str, password: str, is_superuser: bool = False):
+    try:
+        async with get_async_session_context() as session:
+            async with get_user_db_context(session) as user_db:
+                async with get_user_manager_context(user_db) as user_manager:
+                    user = await user_manager.create(
+                        UserCreate(
+                            email=email, password=password, is_superuser=is_superuser
+                        )
+                    )
+                    print(f"User created {user}")
+    except UserAlreadyExists:
+        print(f"User {email} already exists")
+
+

3. Use it

+

You can now easily use it in a script. For example:

+
import asyncio
+
+if __name__ == "__main__":
+  asyncio.run(create_user("king.arthur@camelot.bt", "guinevere"))
+
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/favicon.png b/10.3/favicon.png new file mode 100644 index 0000000000000000000000000000000000000000..29ac488cb13eeb76e977513687f031056452a98c GIT binary patch literal 1648 zcmV-$29NoPP)002t}1^@s6I8J)%00004b3#c}2nYxW zdhK~#90?VM?BR81ME={SBk^JF@{ zd*8dun>UT`mz)r0`p!A`KX>ljckaCpGBPqUGBW<}RHYcZ2AB$*3bX*tz|p`M;0WLV zFbE6)KLOi-ZwvqC%b#xfIRUs6cnj!98f|KQz-r(&;JEUppFH)z^}t3Thn+wwI|Qr) z79c%!)Y1Sf0e;4>Kq}h~+>LyNM-_9Cai$z1mD=|}TjDMBz=^Aq z0d|wVNX6CzT$yB}O{oHw0e_ReIAJynv?tbj18RT{(ibF-JpoiFBSSQ`$heTU2qw0Q z6ei+T!1E4Cr)f_mpof-+Jtdx&E%h%+IJ2qT!91?zfXjRfQ%Vz+H$AYmUBD#2@{HvD z3TUKHd)2Qzhq=}9#UF91y}@pXqjssSZk5%2u{L&0=nKI?naH@ zP3UXyw;<(a(|m`3V{}PH-GyI+{f%e8<#ixED~#`uDrk@9+Lgfl7BTCQsf>~+v1V8V z4bXl{5i}}ZZ%3BKqIeSc+9Iy?El?dYk+dBH`tUnu?J2w$mv)Pscj_GKdR8ki&LFu` z8iAP>*UconS8heBo^i41S(A}*IuxB)Q!Rp(@(3~(#HFEdO&BIZ+5CNgvfW9Gbq4TU zM4aMWo&}~U-k*Zmk4=lg-xg!l?p64k@V$+`9CAGHZVW#c8RY+gWv-7I#Q2vtErY3S z5a~JdIb3y^UwAEU)nOCyZlC5k*U zWHZQ^qI^#W9tZw%^u10ch;H7pU-Mqtv?4tq2lN6*F;X}elBmQm| z@JYe8Ae+|ukgxPuWG~i4;7s5g;9TT~!1RNQ+wKw65?yt8n&?LAI1T-rXg9C|xDdO# zS`$*+`ZA&&foZD_QM{*cngecjag2Q8pDFzJ19#zXIskA1(PihCTmmfBI6m9OF;ayM z^V@}N0Z)P|V7Vf09=OTHc{A$m*qttp3BULJl;n3CuMLTtCq@lE4yvwu0Jn`5KZN+a z*eTO!rlDSdabDd4{kma?gWsVLf4UoFAG{J0GcYgfhPoB$9QI>Zn7<^Mfx1_1!{Z5! zdlW%}amHq2MLES9hs?}XZMe~Aup`m$cUW%Wvz%hBRK&|83n3<}MzL6+37A8wo+gw_ ztlJf_0=qn+xNOh_-H+L?Svka7i2fv6Vmtpp&gSgV1Rns-kLfFEv1SqeiyPPu^c(EF z(1w1q$U&rH5k-<>EkR#i9>#5Jf)UF!i3DTV1Lz0NB*bb!R%dj%<$?P=#EMPa6Be71 zl1Ui8#kv$(vX9EC>?bTB{@I`p)}@z3!5iHLSq;aV55 zs*o+&Yly$}wSsh?HUNbL9>i>i;8%**bu=P#xkr&rZE<4_*{7g29Si$e!e zoy`^gKLPprwqU+71mHK|I^ZLRoD!pn$~m&KnhHK6T};}i?`I|6LeJC#H()ltxY&=3 z(&su9Q-?e;WCJqT`V{C8vWzzBpBNIxWZ({@{;s>n)LAd^8gMIR9+T3XcT^Mpl%uhX ue9F;YWc=$!YEQw}IwK<^BO@cD?EC{^lg{JyRuqK*0000 literal 0 HcmV?d00001 diff --git a/10.3/index.html b/10.3/index.html new file mode 100644 index 00000000..1e45b135 --- /dev/null +++ b/10.3/index.html @@ -0,0 +1,1520 @@ + + + + + + + + + + + + + + + + + + + + + + FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

FastAPI Users

+

+ FastAPI Users +

+ +

+ Ready-to-use and customizable users management for FastAPI +

+ +

build +codecov +PyPI version +Downloads

+ +

All Contributors

+ + +

+ +

+ +
+

Documentation: https://fastapi-users.github.io/fastapi-users/

+

Source Code: https://github.com/fastapi-users/fastapi-users

+
+

Add quickly a registration and authentication system to your FastAPI project. FastAPI Users is designed to be as customizable and adaptable as possible.

+

Features

+
    +
  • Extensible base user model
    • +
  • Ready-to-use register, login, reset password and verify e-mail routes
    • +
  • Ready-to-use social OAuth2 login flow
    • +
  • Dependency callables to inject current user in route
    • +
  • Pluggable password validation
    • +
  • Customizable database backend +
    • +
  • Multiple customizable authentication backends
      +
    • Transports: Authorization header, Cookie
      • +
    • Strategies: JWT, Database, Redis
      • +
    +
    • +
  • Full OpenAPI schema support, even with several authentication backends
    • +
+

In a hurry? Discover Fief, the open-source authentication platform

+

+ Fief +

+ +

Fief

+

Implementing registration, login, social auth is hard and painful. We know it. With our highly secure and open-source users management platform, you can focus on your app while staying in control of your users data.

+
    +
  • Based on FastAPI Users!
    • +
  • Open-source: self-host it for free or use our hosted version
    • +
  • Bring your own database: host your database anywhere, we'll take care of the rest
    • +
  • Pre-built login and registration pages: clean and fast authentication so you don't have to do it yourself
    • +
  • Official Python client with built-in FastAPI integration
    • +
+


+

+ +

+

It's free!

+ +

Contributors and sponsors ✨☕️

+

Thanks goes to these wonderful people (emoji key):

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
François Voron
François Voron
🚧		Paolo Dina
Paolo Dina
💵 💻		Dmytro Ohorodnik
Dmytro Ohorodnik
🐛		Matthew D. Scholefield
Matthew D. Scholefield
🐛		roywes
roywes
🐛 💻		Satwik Kansal
Satwik Kansal
📖		Edd Salkield
Edd Salkield
💻 📖
mark-todd
mark-todd
💻 📖		lill74
lill74
🐛 💻 📖		SelfhostedPro
SelfhostedPro
🛡️ 💻		Oskar Gmerek
Oskar Gmerek
📖		Martin Collado
Martin Collado
🐛 💻		Eric Lopes
Eric Lopes
📖 🛡️		Beau Breon
Beau Breon
💻
Niyas Mohammed
Niyas Mohammed
📖		prostomarkeloff
prostomarkeloff
📖 💻		Marius Mézerette
Marius Mézerette
🐛 🤔		Nickolas Grigoriadis
Nickolas Grigoriadis
🐛		Open Data Coder
Open Data Coder
🤔		Mohammed Alshehri
Mohammed Alshehri
🤔		Tyler Renelle
Tyler Renelle
🤔
collerek
collerek
💻		Robert Bracco
Robert Bracco
💵		Augusto Herrmann
Augusto Herrmann
📖		Smithybrewer
Smithybrewer
🐛		silllli
silllli
📖		alexferrari88
alexferrari88
💵		sandalwoodbox
sandalwoodbox
🐛 📖
Vlad Hoi
Vlad Hoi
📖		Joe Nudell
Joe Nudell
🐛		Ben
Ben
💻		BoYanZh
BoYanZh
📖		David Brochart
David Brochart
📖 💻		Daan Beverdam
Daan Beverdam
💻		Stéphane Raimbault
Stéphane Raimbault
⚠️ 🐛
Sondre Lillebø Gundersen
Sondre Lillebø Gundersen
📖		Maxim
Maxim
📖 🐛		scottdavort
scottdavort
💵		John Dukewich
John Dukewich
📖		Yasser Tahiri
Yasser Tahiri
💻		Brandon H. Goding
Brandon H. Goding
💻		PovilasK
PovilasK
💻
Just van den Broecke
Just van den Broecke
💵		jakemanger
jakemanger
🐛 💻		Ikko Ashimine
Ikko Ashimine
💻		Matyáš Richter
Matyáš Richter
💻		Hazedd
Hazedd
🐛 📖		Luis Roel
Luis Roel
💵		Alexandr Makurin
Alexandr Makurin
💻 🐛
Leon Thurner
Leon Thurner
📖		Goran Mekić
Goran Mekić
📦		Gaganpreet
Gaganpreet
💻		Joe Taylor
Joe Taylor
💻		Richard Friberg
Richard Friberg
🐛		Kenton Parton
Kenton Parton
💵		Adrian Ciołek
Adrian Ciołek
🐛
⭕Alexander Rymdeko-Harvey
⭕Alexander Rymdeko-Harvey
📖		schwannden
schwannden
🚧 💻		Jimmy Angel Pérez Díaz
Jimmy Angel Pérez Díaz
🛡️		Austin Orr
Austin Orr
🚧		Carlo Eugster
Carlo Eugster
🛡️		Vittorio Zamboni
Vittorio Zamboni
💻		Andrey
Andrey
📖
Can H. Tartanoglu
Can H. Tartanoglu
🐛		Filipe Nascimento
Filipe Nascimento
🛡️		dudulu
dudulu
💵		Toni Alatalo
Toni Alatalo
💻 📖
+ + + + + + +

This project follows the all-contributors specification. Contributions of any kind welcome!

+

Development

+

Setup environment

+

We use Hatch to manage the development environment and production build. Ensure it's installed on your system.

+

Run unit tests

+

You can run all the tests with:

+
hatch run test
+
+

Format the code

+

Execute the following command to apply isort and black formatting:

+
hatch run lint
+
+

Serve the documentation

+

You can serve the documentation locally with the following command:

+
hatch run docs
+
+

The documentation will be available on http://localhost:8000.

+

License

+

This project is licensed under the terms of the MIT license.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/installation/index.html b/10.3/installation/index.html new file mode 100644 index 00000000..c6ee8280 --- /dev/null +++ b/10.3/installation/index.html @@ -0,0 +1,1268 @@ + + + + + + + + + + + + + + + + + + + + + + + + Installation - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Installation

+

You can add FastAPI Users to your FastAPI project in a few easy steps. First of all, install the dependency:

+

With SQLAlchemy support

+
pip install 'fastapi-users[sqlalchemy]'
+
+

With Beanie support

+
pip install 'fastapi-users[beanie]'
+
+

With Redis authentication backend support

+

Information on installing with proper database support can be found in the Redis section.

+

With OAuth2 support

+

Information on installing with proper database support can be found in the OAuth2 section.

+
+

That's it! In the next section, we'll have an overview of how things work.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/migration/08_to_1x/index.html b/10.3/migration/08_to_1x/index.html new file mode 100644 index 00000000..b7ee08e5 --- /dev/null +++ b/10.3/migration/08_to_1x/index.html @@ -0,0 +1,1572 @@ + + + + + + + + + + + + + + + + + + + + + + + + 0.8.x ➡️ 1.x.x - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

0.8.x ➡️ 1.x.x

+

1.0 version introduces major breaking changes that need you to update some of your code and migrate your data.

+

Id. are UUID

+

Users and OAuth accounts id. are now represented as real UUID objects instead of plain strings. This change was introduced to leverage efficient storage and indexing for DBMS that supports UUID (especially PostgreSQL and Mongo).

+

In Python code

+

If you were doing comparison betwen a user id. and a string (in unit tests for example), you should now cast the id. to string:

+
# Before
+assert "d35d213e-f3d8-4f08-954a-7e0d1bea286f" == user.id
+
+# Now
+assert "d35d213e-f3d8-4f08-954a-7e0d1bea286f" == str(user.id)
+
+

If you were refering to user id. in your Pydantic models, the field should now be of UUID4 type instead of str:

+
from pydantic import BaseModel, UUID4
+
+# Before
+class Model(BaseModel):
+    user_id: str
+
+# After
+class Model(BaseModel):
+    user_id: UUID4
+
+

MongoDB

+

To avoid any issues, it's recommended to use the standard UUID representation when instantiating the MongoDB client:

+
DATABASE_URL = "mongodb://localhost:27017"
+client = motor.motor_asyncio.AsyncIOMotorClient(
+    DATABASE_URL, uuidRepresentation="standard"
+)
+
+

This parameter controls how the UUID values will be encoded in the database. By default, it's set to pythonLegacy but new applications should consider setting this to standard for cross language compatibility. Read more about this.

+

In database

+

Id. were before stored as strings in the database. You should make a migration to convert string data to UUID data.

+
+

Danger

+

Scripts below are provided as guidelines. Please review them carefully, adapt them and check that they are working on a test database before applying them to production. BE CAREFUL. THEY CAN DESTROY YOUR DATA..

+
+

PostgreSQL

+

PostgreSQL supports UUID type. If not already, you should enable the uuid-ossp extension:

+
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
+
+

To convert the existing id. string column, we can:

+
    +
  1. Create a new column with UUID type.
    2. +
  2. Fill it with the id. converted to UUID.
    3. +
  3. Drop the original id. column.
    4. +
  4. Make the new column a primary key and rename it.
    5. +
+
ALTER TABLE "user" ADD uuid_id UUID;
+UPDATE "user" SET uuid_id = uuid(id);
+ALTER TABLE "user" DROP id;
+ALTER TABLE "user" ADD PRIMARY KEY (uuid_id);
+ALTER TABLE "user" RENAME COLUMN uuid_id TO id;
+
+

MySQL

+

MySQL doesn't support UUID type. We'll just convert the column to CHAR(36) type:

+
ALTER TABLE "user" MODIFY id CHAR(36);
+
+

MongoDB

+
Mongo shell
+

For MongoDB, we can use a forEach iterator to convert the id. for each document:

+
db.getCollection('users').find().forEach(function(user) {
+  var uuid = UUID(user.id);
+  db.getCollection('users').update({_id: user._id}, [{$set: {id: uuid}}]);
+});
+
+
Python
+
import uuid
+
+import motor.motor_asyncio
+
+
+async def migrate_uuid():
+    client = motor.motor_asyncio.AsyncIOMotorClient(
+        DATABASE_URL, uuidRepresentation="standard"
+    )
+    db = client["database_name"]
+    users = db["users"]
+
+    async for user in users.find({}):
+        await users.update_one(
+            {"_id": user["_id"]},
+            {"$set": {"id": uuid.UUID(user["id"])}},
+        )
+
+

Splitted routers

+

You now have the responsibility to wire the routers. FastAPI Users doesn't give a bloated users router anymore.

+

Event handlers are also removed. You have to provide your "after-" logic as a parameter of the router generator.

+

Before

+
jwt_authentication = JWTAuthentication(secret=SECRET, lifetime_seconds=3600)
+
+app = FastAPI()
+fastapi_users = FastAPIUsers(
+    user_db, [jwt_authentication], User, UserCreate, UserUpdate, UserDB,
+)
+app.include_router(fastapi_users.router, prefix="/users", tags=["users"])
+
+
+@fastapi_users.on_after_register()
+def on_after_register(user: User, request: Request):
+    print(f"User {user.id} has registered.")
+
+
+@fastapi_users.on_after_forgot_password()
+def on_after_forgot_password(user: User, token: str, request: Request):
+    print(f"User {user.id} has forgot their password. Reset token: {token}")
+
+

After

+
def on_after_register(user: UserDB, request: Request):
+    print(f"User {user.id} has registered.")
+
+
+def on_after_forgot_password(user: UserDB, token: str, request: Request):
+    print(f"User {user.id} has forgot their password. Reset token: {token}")
+
+
+jwt_authentication = JWTAuthentication(secret=SECRET, lifetime_seconds=3600)
+
+app = FastAPI()
+fastapi_users = FastAPIUsers(
+    user_db, [jwt_authentication], User, UserCreate, UserUpdate, UserDB,
+)
+app.include_router(
+    fastapi_users.get_auth_router(jwt_authentication), prefix="/auth/jwt", tags=["auth"]
+)
+app.include_router(
+    fastapi_users.get_register_router(on_after_register), prefix="/auth", tags=["auth"]
+)
+app.include_router(
+    fastapi_users.get_reset_password_router(
+        SECRET, after_forgot_password=on_after_forgot_password
+    ),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(fastapi_users.get_users_router(), prefix="/users", tags=["users"])
+
+

Important things to notice:

+
    +
  • FastAPIUsers takes two arguments less (reset_password_token_secret and reset_password_token_lifetime_seconds).
    • +
  • You have more flexibility to choose the prefix and tags of the routers.
    • +
  • The /login//logout are now your responsibility to include for each backend. The path will change (before /login/jwt, after /jwt/login).
    • +
  • If you don't care about some of those routers, you can discard them.
    • +
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/migration/1x_to_2x/index.html b/10.3/migration/1x_to_2x/index.html new file mode 100644 index 00000000..6da0df23 --- /dev/null +++ b/10.3/migration/1x_to_2x/index.html @@ -0,0 +1,1229 @@ + + + + + + + + + + + + + + + + + + + + + + + + 1.x.x ➡️ 2.x.x - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

1.x.x ➡️ 2.x.x

+

JWT authentication backend

+

To be fully compatible with Swagger authentication, the output of a successful login operation with the JWT authentication backend has changed:

+

Before

+
{
+    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiOTIyMWZmYzktNjQwZi00MzcyLTg2ZDMtY2U2NDJjYmE1NjAzIiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTcxNTA0MTkzfQ.M10bjOe45I5Ncu_uXvOmVV8QxnL-nZfcH96U90JaocI"
+}
+
+

After

+
{
+    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiOTIyMWZmYzktNjQwZi00MzcyLTg2ZDMtY2U2NDJjYmE1NjAzIiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTcxNTA0MTkzfQ.M10bjOe45I5Ncu_uXvOmVV8QxnL-nZfcH96U90JaocI",
+    "token_type": "bearer"
+}
+
+

Make sure to update your clients to read the token in the right property.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/migration/2x_to_3x/index.html b/10.3/migration/2x_to_3x/index.html new file mode 100644 index 00000000..f6e6f0b8 --- /dev/null +++ b/10.3/migration/2x_to_3x/index.html @@ -0,0 +1,1222 @@ + + + + + + + + + + + + + + + + + + + + + + + + 2.x.x ➡️ 3.x.x - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

2.x.x ➡️ 3.x.x

+

Emails are now case-insensitive

+

Before 3.x.x, the local part (before the @) of the email address was case-sensitive. Therefore, king.arthur@camelot.bt and King.Arthur@camelot.bt were considered as two different users. This behaviour was a bit confusing and not consistent with 99% of web services out there.

+

After 3.x.x, users are fetched from the database with a case-insensitive email search. Bear in mind though that if the user registers with the email King.Arthur@camelot.bt, it will be stored exactly like this in the database (with casing) ; but he will be able to login as king.arthur@camelot.bt.

+
+

Danger

+

It's super important then, before you upgrade to 3.x.x that you check if there are several users with the same email with different cases ; and that you merge or delete those accounts.

+
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/migration/3x_to_4x/index.html b/10.3/migration/3x_to_4x/index.html new file mode 100644 index 00000000..4e7ab0e8 --- /dev/null +++ b/10.3/migration/3x_to_4x/index.html @@ -0,0 +1,1218 @@ + + + + + + + + + + + + + + + + + + + + + + + + 3.x.x ➡️ 4.x.x - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

3.x.x ➡️ 4.x.x

+

expires_at property in OAuthAccount is now optional

+

Before 4.x.x, the expires_at property in OAuthAccount model was mandatory. It was causing issues with some services that don't have such expiration property.

+

If you use SQLAlchemy or Tortoise databases adapters, you'll have to make a migration to update your database schema.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/migration/4x_to_5x/index.html b/10.3/migration/4x_to_5x/index.html new file mode 100644 index 00000000..85355171 --- /dev/null +++ b/10.3/migration/4x_to_5x/index.html @@ -0,0 +1,1218 @@ + + + + + + + + + + + + + + + + + + + + + + + + 4.x.x ➡️ 5.x.x - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

4.x.x ➡️ 5.x.x

+

New property is_verified in User model.

+

Starting 5.x.x., there is a new e-mail verification feature. Even if optional, the is_verified property has been added to the User model.

+

If you use SQLAlchemy or Tortoise databases adapters, you'll have to make a migration to update your database schema.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/migration/6x_to_7x/index.html b/10.3/migration/6x_to_7x/index.html new file mode 100644 index 00000000..c1cfe1ee --- /dev/null +++ b/10.3/migration/6x_to_7x/index.html @@ -0,0 +1,1180 @@ + + + + + + + + + + + + + + + + + + + + + + + + 6.x.x ➡️ 7.x.x - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

6.x.x ➡️ 7.x.x

+
    +
  • The deprecated dependencies to retrieve current user have been removed. Use the current_user factory instead. [Documentation]
    • +
  • When trying to authenticate a not verified user, a status code 403 is raised instead of status code 401. Thanks @daanbeverdam 🎉 [Documentation]
    • +
  • Your UserUpdate model shouldn't inherit from the base User class. If you have custom fields, you should repeat them in this model. [Documentation]
    • +
+
+
    +
  • Database adapters now live in their own repositories and packages.
    • +
  • When upgrading to v7.0.0, the dependency for your database adapter should automatically be installed.
    • +
  • The import statements remain unchanged.
    • +
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/migration/7x_to_8x/index.html b/10.3/migration/7x_to_8x/index.html new file mode 100644 index 00000000..f76c670d --- /dev/null +++ b/10.3/migration/7x_to_8x/index.html @@ -0,0 +1,1330 @@ + + + + + + + + + + + + + + + + + + + + + + + + 7.x.x ➡️ 8.x.x - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

7.x.x ➡️ 8.x.x

+

Version 8 includes the biggest code changes since version 1. We reorganized lot of parts of the code to make it even more modular and integrate more into the dependency injection system of FastAPI.

+

Most importantly, you need now to implement a UserManager class and a associated dependency to create an instance of this class.

+

Event handlers should live in the UserManager

+

Before, event handlers like on_after_register or on_after_forgot_password were defined in their own functions that were passed as arguments of router generators.

+

Now, they should be methods of the UserManager class.

+

You can read more in the UserManager documentation.

+

Password validation should live in the UserManager

+

Before, password validation was defined in its own function that was passed as argument of FastAPIUsers.

+

Now, it should be a method of the UserManager class.

+

You can read more in the UserManager documentation.

+

Verify token secret and lifetime parameters are attributes of UserManager

+

Before, verify token and lifetime parameters were passed as argument of get_verify_router.

+

Now, they should be defined as attributes of the UserManager class.

+

You can read more in the UserManager documentation.

+

Reset password token secret and lifetime parameters are attributes of UserManager

+

Before, reset password token and lifetime parameters were passed as argument of get_verify_router.

+

Now, they should be defined as attributes of the UserManager class.

+

You can read more in the UserManager documentation.

+

Database adapter should be provided in a dependency

+

Before, we advised to directly instantiate the database adapter class.

+

Now, it should be instantiated inside a dependency that you define yourself. The benefit of this is that it lives in the dependency injection system of FastAPI, allowing you to have more dynamic logic to create your instance.

+

➡️ I'm using SQLAlchemy

+

➡️ I'm using MongoDB

+

➡️ I'm using Tortoise ORM

+

➡️ I'm using ormar

+

FastAPIUsers now expect a get_user_manager dependency

+

Before, the database adapter instance was passed as argument of FastAPIUsers.

+

Now, you should define a get_user_manager dependency returning an instance of your UserManager class. This dependency will be dependent of the database adapter dependency.

+

You can read more in the UserManager documentation and FastAPIUsers documentation

+

Lost?

+

If you're unsure or a bit lost, make sure to check the full working examples.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/migration/8x_to_9x/index.html b/10.3/migration/8x_to_9x/index.html new file mode 100644 index 00000000..27a641ec --- /dev/null +++ b/10.3/migration/8x_to_9x/index.html @@ -0,0 +1,1427 @@ + + + + + + + + + + + + + + + + + + + + + + + + 8.x.x ➡️ 9.x.x - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

8.x.x ➡️ 9.x.x

+

Version 9 revamps the authentication backends: we splitted the logic of a backend into two: the transport, which is how the token will be carried over the request and the strategy, which is how the token is generated and secured.

+

The benefit of this is that we'll soon be able to propose new strategies, like database session tokens, without having to repeat the transport logic which remains the same.

+

Convert the authentication backend

+

You now have to generate an authentication backend with a transport and a strategy.

+

I used JWTAuthentication

+
+
+
+
from fastapi_users.authentication import JWTAuthentication
+
+jwt_authentication = JWTAuthentication(
+    secret=SECRET, lifetime_seconds=3600, tokenUrl="auth/jwt/login"
+)
+
+
+
+
from fastapi_users.authentication import AuthenticationBackend, BearerTransport, JWTStrategy
+
+SECRET = "SECRET"
+
+bearer_transport = BearerTransport(tokenUrl="auth/jwt/login")
+
+def get_jwt_strategy() -> JWTStrategy:
+    return JWTStrategy(secret=SECRET, lifetime_seconds=3600)
+
+auth_backend = AuthenticationBackend(
+    name="jwt",
+    transport=bearer_transport,
+    get_strategy=get_jwt_strategy,
+)
+
+
+
+
+
+

Warning

+

There is no default name anymore: you need to provide it yourself for each of your backends.

+
+

I used CookieAuthentication

+
+
+
+
from fastapi_users.authentication import CookieAuthentication
+
+cookie_authentication = CookieAuthentication(secret=SECRET, lifetime_seconds=3600)
+
+
+
+
from fastapi_users.authentication import AuthenticationBackend, CookieTransport, JWTStrategy
+
+SECRET = "SECRET"
+
+cookie_transport = CookieTransport(cookie_max_age=3600)
+
+def get_jwt_strategy() -> JWTStrategy:
+    return JWTStrategy(secret=SECRET, lifetime_seconds=3600)
+
+auth_backend = AuthenticationBackend(
+    name="cookie",
+    transport=cookie_transport,
+    get_strategy=get_jwt_strategy,
+)
+
+
+
+
+
+

Warning

+

There is no default name anymore: you need to provide it yourself for each of your backends.

+
+
+

Tip

+

Notice that the strategy is the same for both authentication backends. That's the beauty of this approach: the token generation is decoupled from its transport.

+
+

OAuth: one router for each backend

+

Before, a single OAuth router was enough to login with any of your authentication backend. Now, you need to generate a router for each of your backends.

+
+
+
+
app.include_router(
+    fastapi_users.get_oauth_router(google_oauth_client, "SECRET"),
+    prefix="/auth/google",
+    tags=["auth"],
+)
+
+
+
+
app.include_router(
+    fastapi_users.get_oauth_router(google_oauth_client, auth_backend, "SECRET"),
+    prefix="/auth/google",
+    tags=["auth"],
+)
+
+
+
+
+

authentication_backend is not needed on /authorize

+

The consequence of this is that you don't need to specify the authentication backend when making a request to /authorize.

+
+
+
+
curl \
+-H "Content-Type: application/json" \
+-X GET \
+http://localhost:8000/auth/google/authorize?authentication_backend=jwt
+
+
+
+
curl \
+-H "Content-Type: application/json" \
+-X GET \
+http://localhost:8000/auth/google/authorize
+
+
+
+
+

Lost?

+

If you're unsure or a bit lost, make sure to check the full working examples.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/migration/9x_to_10x/index.html b/10.3/migration/9x_to_10x/index.html new file mode 100644 index 00000000..46193749 --- /dev/null +++ b/10.3/migration/9x_to_10x/index.html @@ -0,0 +1,1644 @@ + + + + + + + + + + + + + + + + + + + + + + 9.x.x ➡️ 10.x.x - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

9.x.x ➡️ 10.x.x

+

Version 10 marks important changes in how we manage User models and their ID.

+

Before, we were relying only on Pydantic models to work with users. In particular the current_user dependency would return you an instance of UserDB, a Pydantic model. This proved to be quite problematic with some ORM if you ever needed to retrieve relationship data or make specific requests.

+

Now, FastAPI Users is designed to always return you a native object for your ORM model, whether it's an SQLAlchemy model or a Beanie document. Pydantic models are now only used for validation and serialization inside the API.

+

Before, we were forcing the use of UUID as primary key ID; a consequence of the design above. This proved to be quite problematic on some databases, like MongoDB which uses a special ObjectID format by default. Some SQL folks also prefer to use traditional auto-increment integers.

+

Now, FastAPI Users is designed to use generic ID type. It means that you can use any type you want for your user's ID. By default, SQLAlchemy adapter still use UUID; but you can quite easily switch to another thing, like an integer. Beanie adapter for MongoDB will use native ObjectID by default, but it also can be overriden.

+

As you may have guessed, those changes imply quite a lot of breaking changes.

+

User models and database adapter

+

SQLAlchemy ORM

+

We've removed the old SQLAlchemy dependency support, so the dependency is now fastapi-users[sqlalchemy].

+
+
+
+
fastapi
+fastapi-users[sqlalchemy2]
+uvicorn[standard]
+aiosqlite
+
+
+
+
fastapi
+fastapi-users[sqlalchemy]
+uvicorn[standard]
+aiosqlite
+
+
+
+
+

The User model base class for SQLAlchemy slightly changed to support UUID by default.

+

We changed the name of the class from UserTable to User: it's not a compulsory change, but since there is no risk of confusion with Pydantic models anymore, it's probably a more idiomatic naming.

+
+
+
+
class UserTable(Base, SQLAlchemyBaseUserTable):
+    pass
+
+
+
+
class User(SQLAlchemyBaseUserTableUUID, Base):
+    pass
+
+
+
+
+

Instantiating the SQLAlchemyUserDatabase adapter now only expects this User model. UserDB is removed.

+
+
+
+
async def get_user_db(session: AsyncSession = Depends(get_async_session)):
+    yield SQLAlchemyUserDatabase(UserDB, session, UserTable)
+
+
+
+
async def get_user_db(session: AsyncSession = Depends(get_async_session)):
+    yield SQLAlchemyUserDatabase(session, User)
+
+
+
+
+

MongoDB

+

MongoDB support is now only provided through Beanie ODM. Even if you don't use it for the rest of your project, it's a very light addition that shouldn't interfere much.

+
+
+
+
fastapi
+fastapi-users[mongodb]
+uvicorn[standard]
+aiosqlite
+
+
+
+
fastapi
+fastapi-users[beanie]
+uvicorn[standard]
+aiosqlite
+
+
+
+
+

You now need to define a proper User model using Beanie.

+
+
+
+
import os
+
+import motor.motor_asyncio
+from fastapi_users.db import MongoDBUserDatabase
+
+from app.models import UserDB
+
+DATABASE_URL = os.environ["DATABASE_URL"]
+client = motor.motor_asyncio.AsyncIOMotorClient(
+    DATABASE_URL, uuidRepresentation="standard"
+)
+db = client["database_name"]
+collection = db["users"]
+
+
+async def get_user_db():
+    yield MongoDBUserDatabase(UserDB, collection)
+
+
+
+
import motor.motor_asyncio
+from beanie import PydanticObjectId
+from fastapi_users.db import BeanieBaseUser, BeanieUserDatabase
+
+DATABASE_URL = "mongodb://localhost:27017"
+client = motor.motor_asyncio.AsyncIOMotorClient(
+    DATABASE_URL, uuidRepresentation="standard"
+)
+db = client["database_name"]
+
+
+class User(BeanieBaseUser[PydanticObjectId]):
+    pass
+
+
+async def get_user_db():
+    yield BeanieUserDatabase(User)
+
+
+
+
+
+

ID are now ObjectID by default

+

By default, User ID will now be native MongoDB ObjectID. If you don't want to make the transition and keep UUID you can do so by overriding the id field:

+
import uuid
+
+from pydantic import Field
+
+
+class User(BeanieBaseUser[uuid.UUID]):
+    id: uuid.UUID = Field(default_factory=uuid.uuid4)
+
+
+

Beanie also needs to be initialized in a startup event handler of your FastAPI app:

+
from beanie import init_beanie
+
+
+@app.on_event("startup")
+async def on_startup():
+    await init_beanie(
+        database=db,
+        document_models=[
+            User,
+        ],
+    )
+
+

Tortoise ORM and ormar

+

Unfortunately, we sometimes need to make difficult choices to keep things sustainable. That's why we decided to not support Tortoise ORM and ormar anymore. It appeared they were not widely used.

+

You can still add support for those ORM yourself by implementing the necessary adapter. You can take inspiration from the SQLAlchemy one.

+

UserManager

+

There is some slight changes on the UserManager class. In particular, it now needs a parse_id method that can be provided through built-in mixins.

+

Generic typing now expects your native User model class and the type of ID.

+

The user_db_model class property is removed.

+
+
+
+
class UserManager(BaseUserManager[UserCreate, UserDB]):
+    user_db_model = UserDB
+    reset_password_token_secret = SECRET
+    verification_token_secret = SECRET
+
+    async def on_after_register(self, user: UserDB, request: Optional[Request] = None):
+        print(f"User {user.id} has registered.")
+
+    async def on_after_forgot_password(
+        self, user: UserDB, token: str, request: Optional[Request] = None
+    ):
+        print(f"User {user.id} has forgot their password. Reset token: {token}")
+
+    async def on_after_request_verify(
+        self, user: UserDB, token: str, request: Optional[Request] = None
+    ):
+        print(f"Verification requested for user {user.id}. Verification token: {token}")
+
+
+
+
class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):
+    reset_password_token_secret = SECRET
+    verification_token_secret = SECRET
+
+    async def on_after_register(self, user: User, request: Optional[Request] = None):
+        print(f"User {user.id} has registered.")
+
+    async def on_after_forgot_password(
+        self, user: User, token: str, request: Optional[Request] = None
+    ):
+        print(f"User {user.id} has forgot their password. Reset token: {token}")
+
+    async def on_after_request_verify(
+        self, user: User, token: str, request: Optional[Request] = None
+    ):
+        print(f"Verification requested for user {user.id}. Verification token: {token}")
+
+
+
+
+

If you need to support other types of ID, you can read more about it in the dedicated section.

+

Pydantic models

+

To better distinguish them from the ORM models, Pydantic models are now called schemas.

+

UserDB has been removed in favor of native models.

+

We changed the name of User to UserRead: it's not a compulsory change, but since there is a risk of confusion with the native model, it's highly recommended.

+

Besides, the BaseUser schema now accepts a generic type to specify the type of ID you use.

+
+
+
+
from fastapi_users import models
+
+
+class User(models.BaseUser):
+    pass
+
+
+class UserCreate(models.BaseUserCreate):
+    pass
+
+
+class UserUpdate(models.BaseUserUpdate):
+    pass
+
+
+class UserDB(User, models.BaseUserDB):
+    pass
+
+
+
+
import uuid
+
+from fastapi_users import schemas
+
+
+class UserRead(schemas.BaseUser[uuid.UUID]):
+    pass
+
+
+class UserCreate(schemas.BaseUserCreate):
+    pass
+
+
+class UserUpdate(schemas.BaseUserUpdate):
+    pass
+
+
+
+
+

FastAPI Users and routers

+

Pydantic schemas are now way less important in this new design. As such, you don't need to pass them when initializing the FastAPIUsers class:

+
+
+
+
fastapi_users = FastAPIUsers(
+    get_user_manager,
+    [auth_backend],
+    User,
+    UserCreate,
+    UserUpdate,
+    UserDB,
+)
+
+
+
+
fastapi_users = FastAPIUsers[User, uuid.UUID](
+    get_user_manager,
+    [auth_backend],
+)
+
+
+
+
+

As a consequence, those schemas need to be passed when initializing the router that needs them: get_register_router, get_verify_router and get_users_router.

+
+
+
+
app.include_router(
+    fastapi_users.get_auth_router(auth_backend), prefix="/auth/jwt", tags=["auth"]
+)
+app.include_router(fastapi_users.get_register_router(), prefix="/auth", tags=["auth"])
+app.include_router(
+    fastapi_users.get_reset_password_router(),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(
+    fastapi_users.get_verify_router(),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(fastapi_users.get_users_router(), prefix="/users", tags=["users"])
+
+
+
+
app.include_router(
+    fastapi_users.get_auth_router(auth_backend), prefix="/auth/jwt", tags=["auth"]
+)
+app.include_router(
+    fastapi_users.get_register_router(UserRead, UserCreate),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(
+    fastapi_users.get_reset_password_router(),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(
+    fastapi_users.get_verify_router(UserRead),
+    prefix="/auth",
+    tags=["auth"],
+)
+app.include_router(
+    fastapi_users.get_users_router(UserRead, UserUpdate),
+    prefix="/users",
+    tags=["users"],
+)
+
+
+
+
+

Lost?

+

If you're unsure or a bit lost, make sure to check the full working examples.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/search/search_index.json b/10.3/search/search_index.json new file mode 100644 index 00000000..035a4023 --- /dev/null +++ b/10.3/search/search_index.json @@ -0,0 +1 @@ +{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"FastAPI Users","text":"

Ready-to-use and customizable users management for FastAPI

Documentation: https://fastapi-users.github.io/fastapi-users/

Source Code: https://github.com/fastapi-users/fastapi-users

Add quickly a registration and authentication system to your FastAPI project. FastAPI Users is designed to be as customizable and adaptable as possible.

"},{"location":"#features","title":"Features","text":"
  • Extensible base user model
  • Ready-to-use register, login, reset password and verify e-mail routes
  • Ready-to-use social OAuth2 login flow
  • Dependency callables to inject current user in route
  • Pluggable password validation
  • Customizable database backend
    • SQLAlchemy ORM async included
    • MongoDB with Beanie ODM included
  • Multiple customizable authentication backends
    • Transports: Authorization header, Cookie
    • Strategies: JWT, Database, Redis
  • Full OpenAPI schema support, even with several authentication backends
"},{"location":"#in-a-hurry-discover-fief-the-open-source-authentication-platform","title":"In a hurry? Discover Fief, the open-source authentication platform","text":"

Implementing registration, login, social auth is hard and painful. We know it. With our highly secure and open-source users management platform, you can focus on your app while staying in control of your users data.

  • Based on FastAPI Users!
  • Open-source: self-host it for free or use our hosted version
  • Bring your own database: host your database anywhere, we'll take care of the rest
  • Pre-built login and registration pages: clean and fast authentication so you don't have to do it yourself
  • Official Python client with built-in FastAPI integration

It's free!

"},{"location":"#contributors-and-sponsors","title":"Contributors and sponsors \u2728\u2615\ufe0f","text":"

Thanks goes to these wonderful people (emoji key):

Fran\u00e7ois Voron\ud83d\udea7 Paolo Dina\ud83d\udcb5 \ud83d\udcbb Dmytro Ohorodnik\ud83d\udc1b Matthew D. Scholefield\ud83d\udc1b roywes\ud83d\udc1b \ud83d\udcbb Satwik Kansal\ud83d\udcd6 Edd Salkield\ud83d\udcbb \ud83d\udcd6 mark-todd\ud83d\udcbb \ud83d\udcd6 lill74\ud83d\udc1b \ud83d\udcbb \ud83d\udcd6 SelfhostedPro\ud83d\udee1\ufe0f \ud83d\udcbb Oskar Gmerek\ud83d\udcd6 Martin Collado\ud83d\udc1b \ud83d\udcbb Eric Lopes\ud83d\udcd6 \ud83d\udee1\ufe0f Beau Breon\ud83d\udcbb Niyas Mohammed\ud83d\udcd6 prostomarkeloff\ud83d\udcd6 \ud83d\udcbb Marius M\u00e9zerette\ud83d\udc1b \ud83e\udd14 Nickolas Grigoriadis\ud83d\udc1b Open Data Coder\ud83e\udd14 Mohammed Alshehri\ud83e\udd14 Tyler Renelle\ud83e\udd14 collerek\ud83d\udcbb Robert Bracco\ud83d\udcb5 Augusto Herrmann\ud83d\udcd6 Smithybrewer\ud83d\udc1b silllli\ud83d\udcd6 alexferrari88\ud83d\udcb5 sandalwoodbox\ud83d\udc1b \ud83d\udcd6 Vlad Hoi\ud83d\udcd6 Joe Nudell\ud83d\udc1b Ben\ud83d\udcbb BoYanZh\ud83d\udcd6 David Brochart\ud83d\udcd6 \ud83d\udcbb Daan Beverdam\ud83d\udcbb St\u00e9phane Raimbault\u26a0\ufe0f \ud83d\udc1b Sondre Lilleb\u00f8 Gundersen\ud83d\udcd6 Maxim\ud83d\udcd6 \ud83d\udc1b scottdavort\ud83d\udcb5 John Dukewich\ud83d\udcd6 Yasser Tahiri\ud83d\udcbb Brandon H. Goding\ud83d\udcbb PovilasK\ud83d\udcbb Just van den Broecke\ud83d\udcb5 jakemanger\ud83d\udc1b \ud83d\udcbb Ikko Ashimine\ud83d\udcbb Maty\u00e1\u0161 Richter\ud83d\udcbb Hazedd\ud83d\udc1b \ud83d\udcd6 Luis Roel\ud83d\udcb5 Alexandr Makurin\ud83d\udcbb \ud83d\udc1b Leon Thurner\ud83d\udcd6 Goran Meki\u0107\ud83d\udce6 Gaganpreet\ud83d\udcbb Joe Taylor\ud83d\udcbb Richard Friberg\ud83d\udc1b Kenton Parton\ud83d\udcb5 Adrian Cio\u0142ek\ud83d\udc1b \u2b55Alexander Rymdeko-Harvey\ud83d\udcd6 schwannden\ud83d\udea7 \ud83d\udcbb Jimmy Angel P\u00e9rez D\u00edaz\ud83d\udee1\ufe0f Austin Orr\ud83d\udea7 Carlo Eugster\ud83d\udee1\ufe0f Vittorio Zamboni\ud83d\udcbb Andrey\ud83d\udcd6 Can H. Tartanoglu\ud83d\udc1b Filipe Nascimento\ud83d\udee1\ufe0f dudulu\ud83d\udcb5 Toni Alatalo\ud83d\udcbb \ud83d\udcd6

This project follows the all-contributors specification. Contributions of any kind welcome!

"},{"location":"#development","title":"Development","text":""},{"location":"#setup-environment","title":"Setup environment","text":"

We use Hatch to manage the development environment and production build. Ensure it's installed on your system.

"},{"location":"#run-unit-tests","title":"Run unit tests","text":"

You can run all the tests with:

hatch run test\n
"},{"location":"#format-the-code","title":"Format the code","text":"

Execute the following command to apply isort and black formatting:

hatch run lint\n
"},{"location":"#serve-the-documentation","title":"Serve the documentation","text":"

You can serve the documentation locally with the following command:

hatch run docs\n

The documentation will be available on http://localhost:8000.

"},{"location":"#license","title":"License","text":"

This project is licensed under the terms of the MIT license.

"},{"location":"installation/","title":"Installation","text":"

You can add FastAPI Users to your FastAPI project in a few easy steps. First of all, install the dependency:

"},{"location":"installation/#with-sqlalchemy-support","title":"With SQLAlchemy support","text":"
pip install 'fastapi-users[sqlalchemy]'\n
"},{"location":"installation/#with-beanie-support","title":"With Beanie support","text":"
pip install 'fastapi-users[beanie]'\n
"},{"location":"installation/#with-redis-authentication-backend-support","title":"With Redis authentication backend support","text":"

Information on installing with proper database support can be found in the Redis section.

"},{"location":"installation/#with-oauth2-support","title":"With OAuth2 support","text":"

Information on installing with proper database support can be found in the OAuth2 section.

That's it! In the next section, we'll have an overview of how things work.

"},{"location":"configuration/full-example/","title":"Full example","text":"

Here is a full working example with JWT authentication to help get you started.

Warning

Notice that SECRET should be changed to a strong passphrase. Insecure passwords may give attackers full access to your database.

"},{"location":"configuration/full-example/#sqlalchemy","title":"SQLAlchemy","text":"

Open

requirements.txtmain.pyapp/app.pyapp/db.pyapp/schemas.pyapp/users.py 
fastapi\nfastapi-users[sqlalchemy]\nuvicorn[standard]\naiosqlite\n
import uvicorn\nif __name__ == \"__main__\":\nuvicorn.run(\"app.app:app\", host=\"0.0.0.0\", log_level=\"info\")\n
from fastapi import Depends, FastAPI\nfrom app.db import User, create_db_and_tables\nfrom app.schemas import UserCreate, UserRead, UserUpdate\nfrom app.users import auth_backend, current_active_user, fastapi_users\napp = FastAPI()\napp.include_router(\nfastapi_users.get_auth_router(auth_backend), prefix=\"/auth/jwt\", tags=[\"auth\"]\n)\napp.include_router(\nfastapi_users.get_register_router(UserRead, UserCreate),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(\nfastapi_users.get_reset_password_router(),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(\nfastapi_users.get_verify_router(UserRead),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(\nfastapi_users.get_users_router(UserRead, UserUpdate),\nprefix=\"/users\",\ntags=[\"users\"],\n)\n@app.get(\"/authenticated-route\")\nasync def authenticated_route(user: User = Depends(current_active_user)):\nreturn {\"message\": f\"Hello {user.email}!\"}\n@app.on_event(\"startup\")\nasync def on_startup():\n# Not needed if you setup a migration system like Alembic\nawait create_db_and_tables()\n
from typing import AsyncGenerator\nfrom fastapi import Depends\nfrom fastapi_users.db import SQLAlchemyBaseUserTableUUID, SQLAlchemyUserDatabase\nfrom sqlalchemy.ext.asyncio import AsyncSession, create_async_engine\nfrom sqlalchemy.orm import DeclarativeMeta, declarative_base, sessionmaker\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nBase: DeclarativeMeta = declarative_base()\nclass User(SQLAlchemyBaseUserTableUUID, Base):\npass\nengine = create_async_engine(DATABASE_URL)\nasync_session_maker = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\nasync def create_db_and_tables():\nasync with engine.begin() as conn:\nawait conn.run_sync(Base.metadata.create_all)\nasync def get_async_session() -> AsyncGenerator[AsyncSession, None]:\nasync with async_session_maker() as session:\nyield session\nasync def get_user_db(session: AsyncSession = Depends(get_async_session)):\nyield SQLAlchemyUserDatabase(session, User)\n
import uuid\nfrom fastapi_users import schemas\nclass UserRead(schemas.BaseUser[uuid.UUID]):\npass\nclass UserCreate(schemas.BaseUserCreate):\npass\nclass UserUpdate(schemas.BaseUserUpdate):\npass\n
import uuid\nfrom typing import Optional\nfrom fastapi import Depends, Request\nfrom fastapi_users import BaseUserManager, FastAPIUsers, UUIDIDMixin\nfrom fastapi_users.authentication import (\nAuthenticationBackend,\nBearerTransport,\nJWTStrategy,\n)\nfrom fastapi_users.db import SQLAlchemyUserDatabase\nfrom app.db import User, get_user_db\nSECRET = \"SECRET\"\nclass UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):\nreset_password_token_secret = SECRET\nverification_token_secret = SECRET\nasync def on_after_register(self, user: User, request: Optional[Request] = None):\nprint(f\"User {user.id} has registered.\")\nasync def on_after_forgot_password(\nself, user: User, token: str, request: Optional[Request] = None\n):\nprint(f\"User {user.id} has forgot their password. Reset token: {token}\")\nasync def on_after_request_verify(\nself, user: User, token: str, request: Optional[Request] = None\n):\nprint(f\"Verification requested for user {user.id}. Verification token: {token}\")\nasync def get_user_manager(user_db: SQLAlchemyUserDatabase = Depends(get_user_db)):\nyield UserManager(user_db)\nbearer_transport = BearerTransport(tokenUrl=\"auth/jwt/login\")\ndef get_jwt_strategy() -> JWTStrategy:\nreturn JWTStrategy(secret=SECRET, lifetime_seconds=3600)\nauth_backend = AuthenticationBackend(\nname=\"jwt\",\ntransport=bearer_transport,\nget_strategy=get_jwt_strategy,\n)\nfastapi_users = FastAPIUsers[User, uuid.UUID](get_user_manager, [auth_backend])\ncurrent_active_user = fastapi_users.current_user(active=True)\n
"},{"location":"configuration/full-example/#beanie","title":"Beanie","text":"

Open

requirements.txtmain.pyapp/app.pyapp/db.pyapp/schemas.pyapp/users.py 
fastapi\nfastapi-users[beanie]\nuvicorn[standard]\n
import uvicorn\nif __name__ == \"__main__\":\nuvicorn.run(\"app.app:app\", host=\"0.0.0.0\", log_level=\"info\")\n
from beanie import init_beanie\nfrom fastapi import Depends, FastAPI\nfrom app.db import User, db\nfrom app.schemas import UserCreate, UserRead, UserUpdate\nfrom app.users import auth_backend, current_active_user, fastapi_users\napp = FastAPI()\napp.include_router(\nfastapi_users.get_auth_router(auth_backend), prefix=\"/auth/jwt\", tags=[\"auth\"]\n)\napp.include_router(\nfastapi_users.get_register_router(UserRead, UserCreate),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(\nfastapi_users.get_reset_password_router(),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(\nfastapi_users.get_verify_router(UserRead),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(\nfastapi_users.get_users_router(UserRead, UserUpdate),\nprefix=\"/users\",\ntags=[\"users\"],\n)\n@app.get(\"/authenticated-route\")\nasync def authenticated_route(user: User = Depends(current_active_user)):\nreturn {\"message\": f\"Hello {user.email}!\"}\n@app.on_event(\"startup\")\nasync def on_startup():\nawait init_beanie(\ndatabase=db,\ndocument_models=[\nUser,\n],\n)\n
import motor.motor_asyncio\nfrom beanie import PydanticObjectId\nfrom fastapi_users.db import BeanieBaseUser, BeanieUserDatabase\nDATABASE_URL = \"mongodb://localhost:27017\"\nclient = motor.motor_asyncio.AsyncIOMotorClient(\nDATABASE_URL, uuidRepresentation=\"standard\"\n)\ndb = client[\"database_name\"]\nclass User(BeanieBaseUser[PydanticObjectId]):\npass\nasync def get_user_db():\nyield BeanieUserDatabase(User)\n
from beanie import PydanticObjectId\nfrom fastapi_users import schemas\nclass UserRead(schemas.BaseUser[PydanticObjectId]):\npass\nclass UserCreate(schemas.BaseUserCreate):\npass\nclass UserUpdate(schemas.BaseUserUpdate):\npass\n
from typing import Optional\nfrom beanie import PydanticObjectId\nfrom fastapi import Depends, Request\nfrom fastapi_users import BaseUserManager, FastAPIUsers\nfrom fastapi_users.authentication import (\nAuthenticationBackend,\nBearerTransport,\nJWTStrategy,\n)\nfrom fastapi_users.db import BeanieUserDatabase, ObjectIDIDMixin\nfrom app.db import User, get_user_db\nSECRET = \"SECRET\"\nclass UserManager(ObjectIDIDMixin, BaseUserManager[User, PydanticObjectId]):\nreset_password_token_secret = SECRET\nverification_token_secret = SECRET\nasync def on_after_register(self, user: User, request: Optional[Request] = None):\nprint(f\"User {user.id} has registered.\")\nasync def on_after_forgot_password(\nself, user: User, token: str, request: Optional[Request] = None\n):\nprint(f\"User {user.id} has forgot their password. Reset token: {token}\")\nasync def on_after_request_verify(\nself, user: User, token: str, request: Optional[Request] = None\n):\nprint(f\"Verification requested for user {user.id}. Verification token: {token}\")\nasync def get_user_manager(user_db: BeanieUserDatabase = Depends(get_user_db)):\nyield UserManager(user_db)\nbearer_transport = BearerTransport(tokenUrl=\"auth/jwt/login\")\ndef get_jwt_strategy() -> JWTStrategy:\nreturn JWTStrategy(secret=SECRET, lifetime_seconds=3600)\nauth_backend = AuthenticationBackend(\nname=\"jwt\",\ntransport=bearer_transport,\nget_strategy=get_jwt_strategy,\n)\nfastapi_users = FastAPIUsers[User, PydanticObjectId](get_user_manager, [auth_backend])\ncurrent_active_user = fastapi_users.current_user(active=True)\n
"},{"location":"configuration/full-example/#what-now","title":"What now?","text":"

You're ready to go! Be sure to check the Usage section to understand how to work with FastAPI Users.

"},{"location":"configuration/oauth/","title":"OAuth2","text":"

FastAPI Users provides an optional OAuth2 authentication support. It relies on HTTPX OAuth library, which is a pure-async implementation of OAuth2.

"},{"location":"configuration/oauth/#installation","title":"Installation","text":"

You should install the library with the optional dependencies for OAuth:

pip install 'fastapi-users[sqlalchemy,oauth]'\n
pip install 'fastapi-users[beanie,oauth]'\n
"},{"location":"configuration/oauth/#configuration","title":"Configuration","text":""},{"location":"configuration/oauth/#instantiate-an-oauth2-client","title":"Instantiate an OAuth2 client","text":"

You first need to get an HTTPX OAuth client instance. Read the documentation for more information.

from httpx_oauth.clients.google import GoogleOAuth2\ngoogle_oauth_client = GoogleOAuth2(\"CLIENT_ID\", \"CLIENT_SECRET\")\n
"},{"location":"configuration/oauth/#setup-the-database-adapter","title":"Setup the database adapter","text":""},{"location":"configuration/oauth/#sqlalchemy","title":"SQLAlchemy","text":"

You'll need to define the SQLAlchemy model for storing OAuth accounts. We provide a base one for this:

from typing import AsyncGenerator, List\nfrom fastapi import Depends\nfrom fastapi_users.db import (\nSQLAlchemyBaseOAuthAccountTableUUID,\nSQLAlchemyBaseUserTableUUID,\nSQLAlchemyUserDatabase,\n)\nfrom sqlalchemy.ext.asyncio import AsyncSession, create_async_engine\nfrom sqlalchemy.orm import DeclarativeMeta, declarative_base, relationship, sessionmaker\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nBase: DeclarativeMeta = declarative_base()\nclass OAuthAccount(SQLAlchemyBaseOAuthAccountTableUUID, Base):\npass\nclass User(SQLAlchemyBaseUserTableUUID, Base):\noauth_accounts: List[OAuthAccount] = relationship(\"OAuthAccount\", lazy=\"joined\")\nengine = create_async_engine(DATABASE_URL)\nasync_session_maker = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\nasync def create_db_and_tables():\nasync with engine.begin() as conn:\nawait conn.run_sync(Base.metadata.create_all)\nasync def get_async_session() -> AsyncGenerator[AsyncSession, None]:\nasync with async_session_maker() as session:\nyield session\nasync def get_user_db(session: AsyncSession = Depends(get_async_session)):\nyield SQLAlchemyUserDatabase(session, User, OAuthAccount)\n

Notice that we also manually added a relationship on the UserTable so that SQLAlchemy can properly retrieve the OAuth accounts of the user.

Besides, when instantiating the database adapter, we need pass this SQLAlchemy model as third argument.

Primary key is defined as UUID

By default, we use UUID as a primary key ID for your user. If you want to use another type, like an auto-incremented integer, you can use SQLAlchemyBaseOAuthAccountTable as base class and define your own id and user_id column.

class OAuthAccount(SQLAlchemyBaseOAuthAccountTable[int], Base):\nid = Column(Integer, primary_key=True)\n@declared_attr\ndef user_id(cls):\nreturn Column(Integer, ForeignKey(\"user.id\", ondelete=\"cascade\"), nullable=False)\n

Notice that SQLAlchemyBaseOAuthAccountTable expects a generic type to define the actual type of ID you use.

"},{"location":"configuration/oauth/#beanie","title":"Beanie","text":"

The advantage of MongoDB is that you can easily embed sub-objects in a single document. That's why the configuration for Beanie is quite simple. All we need to do is to define another class to structure an OAuth account object.

from typing import List\nimport motor.motor_asyncio\nfrom beanie import PydanticObjectId\nfrom fastapi_users.db import BaseOAuthAccount, BeanieBaseUser, BeanieUserDatabase\nfrom pydantic import Field\nDATABASE_URL = \"mongodb://localhost:27017\"\nclient = motor.motor_asyncio.AsyncIOMotorClient(\nDATABASE_URL, uuidRepresentation=\"standard\"\n)\ndb = client[\"database_name\"]\nclass OAuthAccount(BaseOAuthAccount):\npass\nclass User(BeanieBaseUser[PydanticObjectId]):\noauth_accounts: List[OAuthAccount] = Field(default_factory=list)\nasync def get_user_db():\nyield BeanieUserDatabase(User, OAuthAccount)\n

It's worth to note that OAuthAccount is not a Beanie document but a Pydantic model that we'll embed inside the User document, through the oauth_accounts array.

"},{"location":"configuration/oauth/#generate-routers","title":"Generate routers","text":"

Once you have a FastAPIUsers instance, you can make it generate a single OAuth router for a given client and authentication backend.

app.include_router(\nfastapi_users.get_oauth_router(google_oauth_client, auth_backend, \"SECRET\"),\nprefix=\"/auth/google\",\ntags=[\"auth\"],\n)\n

Tip

If you have several OAuth clients and/or several authentication backends, you'll need to create a router for each pair you want to support.

"},{"location":"configuration/oauth/#existing-account-association","title":"Existing account association","text":"

If a user with the same e-mail address already exists, an HTTP 400 error will be raised by default.

You can however choose to automatically link this OAuth account to the existing user account by setting the associate_by_email flag:

app.include_router(\nfastapi_users.get_oauth_router(\ngoogle_oauth_client,\nauth_backend,\n\"SECRET\",\nassociate_by_email=True,\n),\nprefix=\"/auth/google\",\ntags=[\"auth\"],\n)\n

Bear in mind though that it can lead to security breaches if the OAuth provider does not validate e-mail addresses. How?

  • Let's say your app support an OAuth provider, Merlinbook, which does not validate e-mail addresses.
  • Imagine a user registers to your app with the e-mail address lancelot@camelot.bt.
  • Now, a malicious user creates an account on Merlinbook with the same e-mail address. Without e-mail validation, the malicious user can use this account without limitation.
  • The malicious user authenticates using Merlinbook OAuth on your app, which automatically associates to the existing lancelot@camelot.bt.
  • Now, the malicious user has full access to the user account on your app \ud83d\ude1e
"},{"location":"configuration/oauth/#association-router-for-authenticated-users","title":"Association router for authenticated users","text":"

We also provide a router to associate an already authenticated user with an OAuth account. After this association, the user will be able to authenticate with this OAuth provider.

app.include_router(\nfastapi_users.get_oauth_associate_router(google_oauth_client, UserRead, \"SECRET\"),\nprefix=\"/auth/associate/google\",\ntags=[\"auth\"],\n)\n

Notice that, just like for the Users router, you have to pass the UserRead Pydantic schema.

"},{"location":"configuration/oauth/#full-example","title":"Full example","text":"

Warning

Notice that SECRET should be changed to a strong passphrase. Insecure passwords may give attackers full access to your database.

"},{"location":"configuration/oauth/#sqlalchemy_1","title":"SQLAlchemy","text":"

Open

requirements.txtmain.pyapp/app.pyapp/db.pyapp/schemas.pyapp/users.py 
fastapi\nfastapi-users[sqlalchemy]\nuvicorn[standard]\naiosqlite\n
import uvicorn\nif __name__ == \"__main__\":\nuvicorn.run(\"app.app:app\", host=\"0.0.0.0\", log_level=\"info\")\n
from fastapi import Depends, FastAPI\nfrom app.db import User, create_db_and_tables\nfrom app.schemas import UserCreate, UserRead, UserUpdate\nfrom app.users import (\nSECRET,\nauth_backend,\ncurrent_active_user,\nfastapi_users,\ngoogle_oauth_client,\n)\napp = FastAPI()\napp.include_router(\nfastapi_users.get_auth_router(auth_backend), prefix=\"/auth/jwt\", tags=[\"auth\"]\n)\napp.include_router(\nfastapi_users.get_register_router(UserRead, UserCreate),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(\nfastapi_users.get_reset_password_router(),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(\nfastapi_users.get_verify_router(UserRead),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(\nfastapi_users.get_users_router(UserRead, UserUpdate),\nprefix=\"/users\",\ntags=[\"users\"],\n)\napp.include_router(\nfastapi_users.get_oauth_router(google_oauth_client, auth_backend, SECRET),\nprefix=\"/auth/google\",\ntags=[\"auth\"],\n)\n@app.get(\"/authenticated-route\")\nasync def authenticated_route(user: User = Depends(current_active_user)):\nreturn {\"message\": f\"Hello {user.email}!\"}\n@app.on_event(\"startup\")\nasync def on_startup():\n# Not needed if you setup a migration system like Alembic\nawait create_db_and_tables()\n
from typing import AsyncGenerator, List\nfrom fastapi import Depends\nfrom fastapi_users.db import (\nSQLAlchemyBaseOAuthAccountTableUUID,\nSQLAlchemyBaseUserTableUUID,\nSQLAlchemyUserDatabase,\n)\nfrom sqlalchemy.ext.asyncio import AsyncSession, create_async_engine\nfrom sqlalchemy.orm import DeclarativeMeta, declarative_base, relationship, sessionmaker\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nBase: DeclarativeMeta = declarative_base()\nclass OAuthAccount(SQLAlchemyBaseOAuthAccountTableUUID, Base):\npass\nclass User(SQLAlchemyBaseUserTableUUID, Base):\noauth_accounts: List[OAuthAccount] = relationship(\"OAuthAccount\", lazy=\"joined\")\nengine = create_async_engine(DATABASE_URL)\nasync_session_maker = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\nasync def create_db_and_tables():\nasync with engine.begin() as conn:\nawait conn.run_sync(Base.metadata.create_all)\nasync def get_async_session() -> AsyncGenerator[AsyncSession, None]:\nasync with async_session_maker() as session:\nyield session\nasync def get_user_db(session: AsyncSession = Depends(get_async_session)):\nyield SQLAlchemyUserDatabase(session, User, OAuthAccount)\n
import uuid\nfrom fastapi_users import schemas\nclass UserRead(schemas.BaseUser[uuid.UUID]):\npass\nclass UserCreate(schemas.BaseUserCreate):\npass\nclass UserUpdate(schemas.BaseUserUpdate):\npass\n
import os\nimport uuid\nfrom typing import Optional\nfrom fastapi import Depends, Request\nfrom fastapi_users import BaseUserManager, FastAPIUsers, UUIDIDMixin\nfrom fastapi_users.authentication import (\nAuthenticationBackend,\nBearerTransport,\nJWTStrategy,\n)\nfrom fastapi_users.db import SQLAlchemyUserDatabase\nfrom httpx_oauth.clients.google import GoogleOAuth2\nfrom app.db import User, get_user_db\nSECRET = \"SECRET\"\ngoogle_oauth_client = GoogleOAuth2(\nos.getenv(\"GOOGLE_OAUTH_CLIENT_ID\", \"\"),\nos.getenv(\"GOOGLE_OAUTH_CLIENT_SECRET\", \"\"),\n)\nclass UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):\nreset_password_token_secret = SECRET\nverification_token_secret = SECRET\nasync def on_after_register(self, user: User, request: Optional[Request] = None):\nprint(f\"User {user.id} has registered.\")\nasync def on_after_forgot_password(\nself, user: User, token: str, request: Optional[Request] = None\n):\nprint(f\"User {user.id} has forgot their password. Reset token: {token}\")\nasync def on_after_request_verify(\nself, user: User, token: str, request: Optional[Request] = None\n):\nprint(f\"Verification requested for user {user.id}. Verification token: {token}\")\nasync def get_user_manager(user_db: SQLAlchemyUserDatabase = Depends(get_user_db)):\nyield UserManager(user_db)\nbearer_transport = BearerTransport(tokenUrl=\"auth/jwt/login\")\ndef get_jwt_strategy() -> JWTStrategy:\nreturn JWTStrategy(secret=SECRET, lifetime_seconds=3600)\nauth_backend = AuthenticationBackend(\nname=\"jwt\",\ntransport=bearer_transport,\nget_strategy=get_jwt_strategy,\n)\nfastapi_users = FastAPIUsers[User, uuid.UUID](get_user_manager, [auth_backend])\ncurrent_active_user = fastapi_users.current_user(active=True)\n
"},{"location":"configuration/oauth/#beanie_1","title":"Beanie","text":"

Open

requirements.txtmain.pyapp/app.pyapp/db.pyapp/schemas.pyapp/users.py 
fastapi\nfastapi-users[beanie]\nuvicorn[standard]\n
import uvicorn\nif __name__ == \"__main__\":\nuvicorn.run(\"app.app:app\", host=\"0.0.0.0\", log_level=\"info\")\n
from beanie import init_beanie\nfrom fastapi import Depends, FastAPI\nfrom app.db import User, db\nfrom app.schemas import UserCreate, UserRead, UserUpdate\nfrom app.users import (\nSECRET,\nauth_backend,\ncurrent_active_user,\nfastapi_users,\ngoogle_oauth_client,\n)\napp = FastAPI()\napp.include_router(\nfastapi_users.get_auth_router(auth_backend), prefix=\"/auth/jwt\", tags=[\"auth\"]\n)\napp.include_router(\nfastapi_users.get_register_router(UserRead, UserCreate),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(\nfastapi_users.get_reset_password_router(),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(\nfastapi_users.get_verify_router(UserRead),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(\nfastapi_users.get_users_router(UserRead, UserUpdate),\nprefix=\"/users\",\ntags=[\"users\"],\n)\napp.include_router(\nfastapi_users.get_oauth_router(google_oauth_client, auth_backend, SECRET),\nprefix=\"/auth/google\",\ntags=[\"auth\"],\n)\n@app.get(\"/authenticated-route\")\nasync def authenticated_route(user: User = Depends(current_active_user)):\nreturn {\"message\": f\"Hello {user.email}!\"}\n@app.on_event(\"startup\")\nasync def on_startup():\nawait init_beanie(\ndatabase=db,\ndocument_models=[\nUser,\n],\n)\n
from typing import List\nimport motor.motor_asyncio\nfrom beanie import PydanticObjectId\nfrom fastapi_users.db import BaseOAuthAccount, BeanieBaseUser, BeanieUserDatabase\nfrom pydantic import Field\nDATABASE_URL = \"mongodb://localhost:27017\"\nclient = motor.motor_asyncio.AsyncIOMotorClient(\nDATABASE_URL, uuidRepresentation=\"standard\"\n)\ndb = client[\"database_name\"]\nclass OAuthAccount(BaseOAuthAccount):\npass\nclass User(BeanieBaseUser[PydanticObjectId]):\noauth_accounts: List[OAuthAccount] = Field(default_factory=list)\nasync def get_user_db():\nyield BeanieUserDatabase(User, OAuthAccount)\n
from beanie import PydanticObjectId\nfrom fastapi_users import schemas\nclass UserRead(schemas.BaseUser[PydanticObjectId]):\npass\nclass UserCreate(schemas.BaseUserCreate):\npass\nclass UserUpdate(schemas.BaseUserUpdate):\npass\n
import os\nfrom typing import Optional\nfrom beanie import PydanticObjectId\nfrom fastapi import Depends, Request\nfrom fastapi_users import BaseUserManager, FastAPIUsers\nfrom fastapi_users.authentication import (\nAuthenticationBackend,\nBearerTransport,\nJWTStrategy,\n)\nfrom fastapi_users.db import BeanieUserDatabase, ObjectIDIDMixin\nfrom httpx_oauth.clients.google import GoogleOAuth2\nfrom app.db import User, get_user_db\nSECRET = \"SECRET\"\ngoogle_oauth_client = GoogleOAuth2(\nos.getenv(\"GOOGLE_OAUTH_CLIENT_ID\", \"\"),\nos.getenv(\"GOOGLE_OAUTH_CLIENT_SECRET\", \"\"),\n)\nclass UserManager(ObjectIDIDMixin, BaseUserManager[User, PydanticObjectId]):\nreset_password_token_secret = SECRET\nverification_token_secret = SECRET\nasync def on_after_register(self, user: User, request: Optional[Request] = None):\nprint(f\"User {user.id} has registered.\")\nasync def on_after_forgot_password(\nself, user: User, token: str, request: Optional[Request] = None\n):\nprint(f\"User {user.id} has forgot their password. Reset token: {token}\")\nasync def on_after_request_verify(\nself, user: User, token: str, request: Optional[Request] = None\n):\nprint(f\"Verification requested for user {user.id}. Verification token: {token}\")\nasync def get_user_manager(user_db: BeanieUserDatabase = Depends(get_user_db)):\nyield UserManager(user_db)\nbearer_transport = BearerTransport(tokenUrl=\"auth/jwt/login\")\ndef get_jwt_strategy() -> JWTStrategy:\nreturn JWTStrategy(secret=SECRET, lifetime_seconds=3600)\nauth_backend = AuthenticationBackend(\nname=\"jwt\",\ntransport=bearer_transport,\nget_strategy=get_jwt_strategy,\n)\nfastapi_users = FastAPIUsers[User, PydanticObjectId](get_user_manager, [auth_backend])\ncurrent_active_user = fastapi_users.current_user(active=True)\n
"},{"location":"configuration/overview/","title":"Overview","text":"

The schema below shows you how the library is structured and how each part fit together.

flowchart TB\n    FASTAPI_USERS{FastAPIUsers}\n    USER_MANAGER{UserManager}\n    USER_MODEL{User model}\n    DATABASE_DEPENDENCY[[get_user_db]]\n    USER_MANAGER_DEPENDENCY[[get_user_manager]]\n    CURRENT_USER[[current_user]]\n    subgraph SCHEMAS[Schemas]\n        USER[User]\n        USER_CREATE[UserCreate]\n        USER_UPDATE[UserUpdate]\n    end\n    subgraph DATABASE[Database adapters]\n        SQLALCHEMY[SQLAlchemy]\n        BEANIE[Beanie]\n    end\n    subgraph ROUTERS[Routers]\n        AUTH[[get_auth_router]]\n        OAUTH[[get_oauth_router]]\n        OAUTH_ASSOCIATE[[get_oauth_associate_router]]\n        REGISTER[[get_register_router]]\n        VERIFY[[get_verify_router]]\n        RESET[[get_reset_password_router]]\n        USERS[[get_users_router]]\n    end\n    subgraph AUTH_BACKENDS[Authentication]\n        subgraph TRANSPORTS[Transports]\n            COOKIE[CookieTransport]\n            BEARER[BearerTransport]\n        end\n        subgraph STRATEGIES[Strategies]\n            DB[DatabaseStrategy]\n            JWT[JWTStrategy]\n            REDIS[RedisStrategy]\n        end\n        AUTH_BACKEND{AuthenticationBackend}\n    end\n    DATABASE --> DATABASE_DEPENDENCY\n    USER_MODEL --> DATABASE_DEPENDENCY\n    DATABASE_DEPENDENCY --> USER_MANAGER\n\n    USER_MANAGER --> USER_MANAGER_DEPENDENCY\n    USER_MANAGER_DEPENDENCY --> FASTAPI_USERS\n\n    FASTAPI_USERS --> ROUTERS\n\n    TRANSPORTS --> AUTH_BACKEND\n    STRATEGIES --> AUTH_BACKEND\n\n    AUTH_BACKEND --> ROUTERS\n    AUTH_BACKEND --> FASTAPI_USERS\n\n    FASTAPI_USERS --> CURRENT_USER\n\n    SCHEMAS --> ROUTERS
"},{"location":"configuration/overview/#user-model-and-database-adapters","title":"User model and database adapters","text":"

FastAPI Users is compatible with various databases and ORM. To build the interface between those database tools and the library, we provide database adapters classes that you need to instantiate and configure.

\u27a1\ufe0f I'm using SQLAlchemy

\u27a1\ufe0f I'm using Beanie

"},{"location":"configuration/overview/#authentication-backends","title":"Authentication backends","text":"

Authentication backends define the way users sessions are managed in your app, like access tokens or cookies.

They are composed of two parts: a transport, which is how the token will be carried over the requests (e.g. cookies, headers...) and a strategy, which is how the token will be generated and secured (e.g. a JWT, a token in database...).

\u27a1\ufe0f Configure the authentication backends

"},{"location":"configuration/overview/#usermanager","title":"UserManager","text":"

The UserManager object bears most of the logic of FastAPI Users: registration, verification, password reset... We provide a BaseUserManager with this common logic; which you should overload to define how to validate passwords or handle events.

This UserManager object should be provided through a FastAPI dependency, get_user_manager.

\u27a1\ufe0f Configure UserManager

"},{"location":"configuration/overview/#schemas","title":"Schemas","text":"

FastAPI is heavily using Pydantic models to validate request payloads and serialize responses. FastAPI Users is no exception and will expect you to provide Pydantic schemas representing a user when it's read, created and updated.

\u27a1\ufe0f Configure schemas

"},{"location":"configuration/overview/#fastapiusers-and-routers","title":"FastAPIUsers and routers","text":"

Finally, FastAPIUsers object is the main class from which you'll be able to generate routers for classic routes like registration or login, but also get the current_user dependency factory to inject the authenticated user in your own routes.

\u27a1\ufe0f Configure FastAPIUsers and routers

"},{"location":"configuration/password-hash/","title":"Password hash","text":"

By default, FastAPI Users will use the BCrypt algorithm to hash and salt passwords before storing them in the database.

The implementation is provided by Passlib, a battle-tested Python library for password hashing.

"},{"location":"configuration/password-hash/#customize-cryptcontext","title":"Customize CryptContext","text":"

If you need to support other hashing algorithms, you can customize the CryptContext object of Passlib.

For this, you'll need to instantiate the PasswordHelper class and pass it your CryptContext. The example below shows you how you can create a CryptContext to add support for the Argon2 algorithm while deprecating BCrypt.

from fastapi_users.password import PasswordHelper\nfrom passlib.context import CryptContext\ncontext = CryptContext(schemes=[\"argon2\", \"bcrypt\"], deprecated=\"auto\")\npassword_helper = PasswordHelper(context)\n

Finally, pass the password_helper variable while instantiating your UserManager:

async def get_user_manager(user_db=Depends(get_user_db)):\nyield UserManager(user_db, password_helper)\n

Password hashes are automatically upgraded

FastAPI Users takes care of upgrading the password hash to a more recent algorithm when needed.

Typically, when a user logs in, we'll check if the password hash algorithm is deprecated.

If it is, we take the opportunity of having the password in plain-text at hand (since the user just logged in!) to hash it with a better algorithm and update it in database.

Dependencies for alternative algorithms are not included by default

FastAPI Users won't install required dependencies to make other algorithms like Argon2 work. It's up to you to install them.

"},{"location":"configuration/password-hash/#full-customization","title":"Full customization","text":"

If you don't wist to use Passlib at all \u2013 which we don't recommend unless you're absolutely sure of what you're doing \u2014 you can implement your own PasswordHelper class as long as it implements the PasswordHelperProtocol and its methods.

from typing import Tuple\nfrom fastapi_users.password import PasswordHelperProtocol\nclass PasswordHelper(PasswordHelperProtocol):\ndef verify_and_update(\nself, plain_password: str, hashed_password: str\n) -> Tuple[bool, str]:\n...\ndef hash(self, password: str) -> str:\n...\ndef generate(self) -> str:\n...\n
"},{"location":"configuration/schemas/","title":"Schemas","text":"

FastAPI is heavily using Pydantic models to validate request payloads and serialize responses. FastAPI Users is no exception and will expect you to provide Pydantic schemas representing a user when it's read, created and updated.

It's different from your User model, which is an object that actually interacts with the database. Those schemas on the other hand are here to validate data and serialize correct it in the API.

FastAPI Users provides a base structure to cover its needs. It is structured like this:

  • id (ID) \u2013 Unique identifier of the user. It matches the type of your ID, like UUID or integer.
  • email (str) \u2013 Email of the user. Validated by email-validator.
  • is_active (bool) \u2013 Whether or not the user is active. If not, login and forgot password requests will be denied. Defaults to True.
  • is_verified (bool) \u2013 Whether or not the user is verified. Optional but helpful with the verify router logic. Defaults to False.
  • is_superuser (bool) \u2013 Whether or not the user is a superuser. Useful to implement administration logic. Defaults to False.
"},{"location":"configuration/schemas/#define-your-schemas","title":"Define your schemas","text":"

There are four Pydantic models variations provided as mixins:

  • BaseUser, which provides the basic fields and validation;
  • BaseCreateUser, dedicated to user registration, which consists of compulsory email and password fields;
  • BaseUpdateUser, dedicated to user profile update, which adds an optional password field;

You should define each of those variations, inheriting from each mixin:

import uuid\nfrom fastapi_users import schemas\nclass UserRead(schemas.BaseUser[uuid.UUID]):\npass\nclass UserCreate(schemas.BaseUserCreate):\npass\nclass UserUpdate(schemas.BaseUserUpdate):\npass\n

Typing: ID generic type is expected

You can see that we define a generic type when extending the BaseUser class. It should correspond to the type of ID you use on your model. Here, we chose UUID, but it can be anything, like an integer or a MongoDB ObjectID.

"},{"location":"configuration/schemas/#adding-your-own-fields","title":"Adding your own fields","text":"

You can of course add your own properties there to fit to your needs. In the example below, we add a required string property, first_name, and an optional date property, birthdate.

import datetime\nimport uuid\nfrom fastapi_users import schemas\nclass UserRead(schemas.BaseUser[uuid.UUID]):\nfirst_name: str\nbirthdate: Optional[datetime.date]\nclass UserCreate(schemas.BaseUserCreate):\nfirst_name: str\nbirthdate: Optional[datetime.date]\nclass UserUpdate(schemas.BaseUserUpdate):\nfirst_name: Optional[str]\nbirthdate: Optional[datetime.date]\n

Make sure to mirror this in your database model

The User model you defined earlier for your specific database will be the central object that will actually store the data. Therefore, you need to define the very same fields in it so the data can be actually stored.

"},{"location":"configuration/user-manager/","title":"UserManager","text":"

The UserManager class is the core logic of FastAPI Users. We provide the BaseUserManager class which you should extend to set some parameters and define logic, for example when a user just registered or forgot its password.

It's designed to be easily extensible and customizable so that you can integrate your very own logic.

"},{"location":"configuration/user-manager/#create-your-usermanager-class","title":"Create your UserManager class","text":"

You should define your own version of the UserManager class to set various parameters.

import uuid\nfrom typing import Optional\nfrom fastapi import Depends, Request\nfrom fastapi_users import BaseUserManager, UUIDIDMixin\nfrom .db import User, get_user_db\nSECRET = \"SECRET\"\nclass UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):\nreset_password_token_secret = SECRET\nverification_token_secret = SECRET\nasync def on_after_register(self, user: User, request: Optional[Request] = None):\nprint(f\"User {user.id} has registered.\")\nasync def on_after_forgot_password(\nself, user: User, token: str, request: Optional[Request] = None\n):\nprint(f\"User {user.id} has forgot their password. Reset token: {token}\")\nasync def on_after_request_verify(\nself, user: User, token: str, request: Optional[Request] = None\n):\nprint(f\"Verification requested for user {user.id}. Verification token: {token}\")\nasync def get_user_manager(user_db=Depends(get_user_db)):\nyield UserManager(user_db)\n

As you can see, you have to define here various attributes and methods. You can find the complete list of those below.

Typing: User and ID generic types are expected

You can see that we define two generic types when extending the base class:

  • User, which is the user model we defined in the database part
  • The ID, which should correspond to the type of ID you use on your model. Here, we chose UUID, but it can be anything, like an integer or a MongoDB ObjectID.

It'll help you to have good type-checking and auto-completion when implementing the custom methods.

"},{"location":"configuration/user-manager/#the-id-parser-mixin","title":"The ID parser mixin","text":"

Since the user ID is fully generic, we need a way to parse it reliably when it'll come from API requests, typically as URL path attributes.

That's why we added the UUIDIDMixin in the example above. It implements the parse_id method, ensuring UUID are valid and correctly parsed.

Of course, it's important that this logic matches the type of your ID. To help you with this, we provide mixins for the most common cases:

  • UUIDIDMixin, for UUID ID.
  • IntegerIDMixin, for integer ID.
  • ObjectIDIDMixin (provided by fastapi_users_db_beanie), for MongoDB ObjectID.

Inheritance order matters

Notice in your example that the mixin comes first in our UserManager inheritance. Because of the Method-Resolution-Order (MRO) of Python, the left-most element takes precedence.

If you need another type of ID, you can simply overload the parse_id method on your UserManager class:

from fastapi_users import BaseUserManager, InvalidID\nclass UserManager(BaseUserManager[User, MyCustomID]):\ndef parse_id(self, value: Any) -> MyCustomID:\ntry:\nreturn MyCustomID(value)\nexcept ValueError as e:\nraise InvalidID() from e  # (1)!\n
  1. If the ID can't be parsed into the desired type, you'll need to raise an InvalidID exception.
"},{"location":"configuration/user-manager/#create-get_user_manager-dependency","title":"Create get_user_manager dependency","text":"

The UserManager class will be injected at runtime using a FastAPI dependency. This way, you can run it in a database session or swap it with a mock during testing.

import uuid\nfrom typing import Optional\nfrom fastapi import Depends, Request\nfrom fastapi_users import BaseUserManager, UUIDIDMixin\nfrom .db import User, get_user_db\nSECRET = \"SECRET\"\nclass UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):\nreset_password_token_secret = SECRET\nverification_token_secret = SECRET\nasync def on_after_register(self, user: User, request: Optional[Request] = None):\nprint(f\"User {user.id} has registered.\")\nasync def on_after_forgot_password(\nself, user: User, token: str, request: Optional[Request] = None\n):\nprint(f\"User {user.id} has forgot their password. Reset token: {token}\")\nasync def on_after_request_verify(\nself, user: User, token: str, request: Optional[Request] = None\n):\nprint(f\"Verification requested for user {user.id}. Verification token: {token}\")\nasync def get_user_manager(user_db=Depends(get_user_db)):\nyield UserManager(user_db)\n

Notice that we use the get_user_db dependency we defined earlier to inject the database instance.

"},{"location":"configuration/user-manager/#customize-attributes-and-methods","title":"Customize attributes and methods","text":""},{"location":"configuration/user-manager/#attributes","title":"Attributes","text":"
  • reset_password_token_secret: Secret to encode reset password token. Use a strong passphrase and keep it secure.
  • reset_password_token_lifetime_seconds: Lifetime of reset password token. Defaults to 3600.
  • reset_password_token_audience: JWT audience of reset password token. Defaults to fastapi-users:reset.
  • verification_token_secret: Secret to encode verification token. Use a strong passphrase and keep it secure.
  • verification_token_lifetime_seconds: Lifetime of verification token. Defaults to 3600.
  • verification_token_audience: JWT audience of verification token. Defaults to fastapi-users:verify.
"},{"location":"configuration/user-manager/#methods","title":"Methods","text":""},{"location":"configuration/user-manager/#validate_password","title":"validate_password","text":"

Validate a password.

Arguments

  • password (str): the password to validate.
  • user (Union[UserCreate, User]): user model which we are currently validating the password. Useful if you want to check that the password doesn't contain the name or the birthdate of the user for example.

Output

This function should return None if the password is valid or raise InvalidPasswordException if not. This exception expects an argument reason telling why the password is invalid. It'll be part of the error response.

Example

from fastapi_users import BaseUserManager, InvalidPasswordException, UUIDIDMixin\nclass UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):\n# ...\nasync def validate_password(\nself,\npassword: str,\nuser: Union[UserCreate, User],\n) -> None:\nif len(password) < 8:\nraise InvalidPasswordException(\nreason=\"Password should be at least 8 characters\"\n)\nif user.email in password:\nraise InvalidPasswordException(\nreason=\"Password should not contain e-mail\"\n)\n
"},{"location":"configuration/user-manager/#on_after_register","title":"on_after_register","text":"

Perform logic after successful user registration.

Typically, you'll want to send a welcome e-mail or add it to your marketing analytics pipeline.

Arguments

  • user (User): the registered user.
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.

Example

from fastapi_users import BaseUserManager, UUIDIDMixin\nclass UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):\n# ...\nasync def on_after_register(self, user: User, request: Optional[Request] = None):\nprint(f\"User {user.id} has registered.\")\n
"},{"location":"configuration/user-manager/#on_after_update","title":"on_after_update","text":"

Perform logic after successful user update.

It may be useful, for example, if you wish to update your user in a data analytics or customer success platform.

Arguments

  • user (User): the updated user.
  • update_dict (Dict[str, Any]): dictionary with the updated user fields.
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.

Example

from fastapi_users import BaseUserManager, UUIDIDMixin\nclass UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):\n# ...\nasync def on_after_update(\nself,\nuser: User,\nupdate_dict: Dict[str, Any],\nrequest: Optional[Request] = None,\n):\nprint(f\"User {user.id} has been updated with {update_dict}.\")\n
"},{"location":"configuration/user-manager/#on_after_login","title":"on_after_login","text":"

Perform logic after a successful user login.

It may be useful for custom logic or processes triggered by new logins, for example a daily login reward or for analytics.

Arguments

  • user (User): the updated user.
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.

Example

from fastapi_users import BaseUserManager, UUIDIDMixin\nclass UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):\n# ...\nasync def on_after_login(\nself,\nuser: User,\nrequest: Optional[Request] = None,\n):\nprint(f\"User {user.id} logged in.\")\n
"},{"location":"configuration/user-manager/#on_after_request_verify","title":"on_after_request_verify","text":"

Perform logic after successful verification request.

Typically, you'll want to send an e-mail with the link (and the token) that allows the user to verify their e-mail.

Arguments

  • user (User): the user to verify.
  • token (str): the verification token.
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.

Example

from fastapi_users import BaseUserManager, UUIDIDMixin\nclass UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):\n# ...\nasync def on_after_request_verify(\nself, user: User, token: str, request: Optional[Request] = None\n):\nprint(f\"Verification requested for user {user.id}. Verification token: {token}\")\n
"},{"location":"configuration/user-manager/#on_after_verify","title":"on_after_verify","text":"

Perform logic after successful user verification.

This may be useful if you wish to send another e-mail or store this information in a data analytics or customer success platform.

Arguments

  • user (User): the verified user.
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.

Example

from fastapi_users import BaseUserManager, UUIDIDMixin\nclass UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):\n# ...\nasync def on_after_verify(\nself, user: User, request: Optional[Request] = None\n):\nprint(f\"User {user.id} has been verified\")\n
"},{"location":"configuration/user-manager/#on_after_forgot_password","title":"on_after_forgot_password","text":"

Perform logic after successful forgot password request.

Typically, you'll want to send an e-mail with the link (and the token) that allows the user to reset their password.

Arguments

  • user (User): the user that forgot its password.
  • token (str): the forgot password token
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.

Example

from fastapi_users import BaseUserManager, UUIDIDMixin\nclass UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):\n# ...\nasync def on_after_forgot_password(\nself, user: User, token: str, request: Optional[Request] = None\n):\nprint(f\"User {user.id} has forgot their password. Reset token: {token}\")\n
"},{"location":"configuration/user-manager/#on_after_reset_password","title":"on_after_reset_password","text":"

Perform logic after successful password reset.

For example, you may want to send an e-mail to the concerned user to warn him that their password has been changed and that they should take action if they think they have been hacked.

Arguments

  • user (User): the user that reset its password.
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.

Example

from fastapi_users import BaseUserManager, UUIDIDMixin\nclass UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):\n# ...\nasync def on_after_reset_password(self, user: User, request: Optional[Request] = None):\nprint(f\"User {user.id} has reset their password.\")\n
"},{"location":"configuration/user-manager/#on_before_delete","title":"on_before_delete","text":"

Perform logic before user delete.

For example, you may want to valide user resource integrity to see if any related user resource need to be marked inactive, or delete them recursively.

Arguments

  • user (User): the user to be deleted.
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.

Example

from fastapi_users import BaseUserManager, UUIDIDMixin\nclass UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):\n# ...\nasync def on_before_delete(self, user: User, request: Optional[Request] = None):\nprint(f\"User {user.id} is going to be deleted\")\n
"},{"location":"configuration/user-manager/#on_after_delete","title":"on_after_delete","text":"

Perform logic after user delete.

For example, you may want to send an email to the administrator about the event.

Arguments

  • user (User): the user to be deleted.
  • request (Optional[Request]): optional FastAPI request object that triggered the operation. Defaults to None.

Example

from fastapi_users import BaseUserManager, UUIDIDMixin\nclass UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):\n# ...\nasync def on_after_delete(self, user: User, request: Optional[Request] = None):\nprint(f\"User {user.id} is successfully deleted\")\n
"},{"location":"configuration/authentication/","title":"Authentication","text":"

FastAPI Users allows you to plug in several authentication methods.

"},{"location":"configuration/authentication/#how-it-works","title":"How it works?","text":"

You can have several authentication methods, e.g. a cookie authentication for browser-based queries and a JWT token authentication for pure API queries.

When checking authentication, each method is run one after the other. The first method yielding a user wins. If no method yields a user, an HTTPException is raised.

For each backend, you'll be able to add a router with the corresponding /login and /logout. More on this in the routers documentation.

"},{"location":"configuration/authentication/#transport-strategy-authentication-backend","title":"Transport + Strategy = Authentication backend","text":"

An authentication backend is composed of two parts:

"},{"location":"configuration/authentication/#transport","title":"Transport","text":"

It manages how the token will be carried over the request. We currently provide two methods:

"},{"location":"configuration/authentication/#bearer","title":"Bearer","text":"

The token will be sent through an Authorization: Bearer header.

Pros and cons

  • \u2705 Easy to read and set in every requests.
  • \u274c Needs to be stored manually somewhere in the client.

\u27a1\ufe0f Use it if you want to implement a mobile application or a pure REST API.

"},{"location":"configuration/authentication/#cookie","title":"Cookie","text":"

The token will be sent through a cookie.

Pros and cons

  • \u2705 Automatically stored and sent securely by web browsers in every requests.
  • \u2705 Automatically removed at expiration by web browsers.
  • \u274c Needs a CSRF protection for maximum security.
  • \u274c Harder to work with outside a browser, like a mobile app or a server.

\u27a1\ufe0f Use it if you want to implement a web frontend.

"},{"location":"configuration/authentication/#strategy","title":"Strategy","text":"

It manages how the token is generated and secured. We currently provide three methods:

"},{"location":"configuration/authentication/#jwt","title":"JWT","text":"

The token is self-contained in a JSON Web Token.

Pros and cons

  • \u2705 Self-contained: it doesn't need to be stored in a database.
  • \u274c Can't be invalidated on the server-side: it's valid until it expires.

\u27a1\ufe0f Use it if you want to get up-and-running quickly.

"},{"location":"configuration/authentication/#database","title":"Database","text":"

The token is stored in a table (or collection) in your database.

Pros and cons

  • \u2705 Secure and performant.
  • \u2705 Tokens can be invalidated server-side by removing them from the database.
  • \u2705 Highly customizable: add your own fields, create an API to retrieve the active sessions of your users, etc.
  • \u274c Configuration is a bit more complex.

\u27a1\ufe0f Use it if you want maximum flexibility in your token management.

"},{"location":"configuration/authentication/#redis","title":"Redis","text":"

The token is stored in a Redis key-store.

Pros and cons

  • \u2705 Secure and performant.
  • \u2705 Tokens can be invalidated server-side by removing them from Redis.
  • \u274c A Redis server is needed.

\u27a1\ufe0f Use it if you want maximum performance while being able to invalidate tokens.

"},{"location":"configuration/authentication/backend/","title":"Create a backend","text":"

As we said, a backend is the combination of a transport and a strategy. That way, you can create a complete strategy exactly fitting your needs.

For this, you have to use the AuthenticationBackend class.

from fastapi_users.authentication import AuthenticationBackend, BearerTransport, JWTStrategy\nSECRET = \"SECRET\"\nbearer_transport = BearerTransport(tokenUrl=\"auth/jwt/login\")\ndef get_jwt_strategy() -> JWTStrategy:\nreturn JWTStrategy(secret=SECRET, lifetime_seconds=3600)\nauth_backend = AuthenticationBackend(\nname=\"jwt\",\ntransport=bearer_transport,\nget_strategy=get_jwt_strategy,\n)\n

As you can see, instantiation is quite simple. It accepts the following arguments:

  • name (str): Name of the backend. Each backend should have a unique name.
  • transport (Transport): An instance of a Transport class.
  • get_strategy (Callable[..., Strategy]): A dependency callable returning an instance of a Strategy class.
"},{"location":"configuration/authentication/backend/#next-steps","title":"Next steps","text":"

You can have as many authentication backends as you wish. You'll then have to pass those backends to your FastAPIUsers instance and generate an auth router for each one of them.

"},{"location":"configuration/authentication/strategies/database/","title":"Database","text":"

The most natural way for storing tokens is of course the very same database you're using for your application. In this strategy, we set up a table (or collection) for storing those tokens with the associated user id. On each request, we try to retrive this token from the database to get the corresponding user id.

"},{"location":"configuration/authentication/strategies/database/#configuration","title":"Configuration","text":"

The configuration of this strategy is a bit more complex than the others as it requires you to configure models and a database adapter, exactly like we did for users.

"},{"location":"configuration/authentication/strategies/database/#database-adapters","title":"Database adapters","text":"

An access token will be structured like this in your database:

  • token (str) \u2013 Unique identifier of the token. It's generated automatically upon login by the strategy.
  • user_id (ID) \u2013 User id. of the user associated to this token.
  • created_at (datetime) \u2013 Date and time of creation of the token. It's used to determine if the token is expired or not.

We are providing a base model with those fields for each database we are supporting.

"},{"location":"configuration/authentication/strategies/database/#sqlalchemy","title":"SQLAlchemy","text":"

We'll expand from the basic SQLAlchemy configuration.

from typing import AsyncGenerator\nfrom fastapi import Depends\nfrom fastapi_users.db import SQLAlchemyBaseUserTableUUID, SQLAlchemyUserDatabase\nfrom fastapi_users_db_sqlalchemy.access_token import (\nSQLAlchemyAccessTokenDatabase,\nSQLAlchemyBaseAccessTokenTableUUID,\n)\nfrom sqlalchemy.ext.asyncio import AsyncSession, create_async_engine\nfrom sqlalchemy.orm import DeclarativeMeta, declarative_base, sessionmaker\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nBase: DeclarativeMeta = declarative_base()\nclass User(SQLAlchemyBaseUserTableUUID, Base):\npass\nclass AccessToken(SQLAlchemyBaseAccessTokenTableUUID, Base):  # (1)!\npass\nengine = create_async_engine(DATABASE_URL)\nasync_session_maker = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\nasync def create_db_and_tables():\nasync with engine.begin() as conn:\nawait conn.run_sync(Base.metadata.create_all)\nasync def get_async_session() -> AsyncGenerator[AsyncSession, None]:\nasync with async_session_maker() as session:\nyield session\nasync def get_user_db(session: AsyncSession = Depends(get_async_session)):\nyield SQLAlchemyUserDatabase(session, User)\nasync def get_access_token_db(\nsession: AsyncSession = Depends(get_async_session),\n):  # (2)!\nyield SQLAlchemyAccessTokenDatabase(session, AccessToken)\n

  1. We define an AccessToken ORM model inheriting from SQLAlchemyBaseAccessTokenTableUUID.

  2. We define a dependency to instantiate the SQLAlchemyAccessTokenDatabase class. Just like the user database adapter, it expects a fresh SQLAlchemy session and the AccessToken model class we defined above.

user_id foreign key is defined as UUID

By default, we use UUID as a primary key ID for your user, so we follow the same convention to define the foreign key pointing to the user.

If you want to use another type, like an auto-incremented integer, you can use SQLAlchemyBaseAccessTokenTable as base class and define your own user_id column.

class AccessToken(SQLAlchemyBaseAccessTokenTable[int], Base):\n@declared_attr\ndef user_id(cls):\nreturn Column(Integer, ForeignKey(\"user.id\", ondelete=\"cascade\"), nullable=False)\n

Notice that SQLAlchemyBaseAccessTokenTable expects a generic type to define the actual type of ID you use.

"},{"location":"configuration/authentication/strategies/database/#beanie","title":"Beanie","text":"

We'll expand from the basic Beanie configuration.

import motor.motor_asyncio\nfrom beanie import PydanticObjectId\nfrom fastapi_users.db import BeanieBaseUser, BeanieUserDatabase\nfrom fastapi_users_db_beanie.access_token import (\nBeanieAccessTokenDatabase,\nBeanieBaseAccessToken,\n)\nDATABASE_URL = \"mongodb://localhost:27017\"\nclient = motor.motor_asyncio.AsyncIOMotorClient(\nDATABASE_URL, uuidRepresentation=\"standard\"\n)\ndb = client[\"database_name\"]\nclass User(BeanieBaseUser):\npass\nclass AccessToken(BeanieBaseAccessToken[PydanticObjectId]):  # (1)!\npass\nasync def get_user_db():\nyield BeanieUserDatabase(User)\nasync def get_access_token_db():  # (2)!\nyield BeanieAccessTokenDatabase(AccessToken)\n

  1. We define an AccessToken ODM model inheriting from BeanieBaseAccessToken. Notice that we set a generic type to define the type of the user_id reference. By default, it's a standard MongoDB ObjectID.

  2. We define a dependency to instantiate the BeanieAccessTokenDatabase class. Just like the user database adapter, it expects the AccessToken model class we defined above.

"},{"location":"configuration/authentication/strategies/database/#strategy","title":"Strategy","text":"
import uuid\nfrom fastapi import Depends\nfrom fastapi_users.authentication.strategy.db import AccessTokenDatabase, DatabaseStrategy\nfrom .db import AccessToken, User\ndef get_database_strategy(\naccess_token_db: AccessTokenDatabase[AccessToken] = Depends(get_access_token_db),\n) -> DatabaseStrategy:\nreturn DatabaseStrategy(access_token_db, lifetime_seconds=3600)\n

As you can see, instantiation is quite simple. It accepts the following arguments:

  • database (AccessTokenDatabase): A database adapter instance for AccessToken table, like we defined above.
  • lifetime_seconds (int): The lifetime of the token in seconds.

Why it's inside a function?

To allow strategies to be instantiated dynamically with other dependencies, they have to be provided as a callable to the authentication backend.

As you can see here, this pattern allows us to dynamically inject a connection to the database.

"},{"location":"configuration/authentication/strategies/database/#logout","title":"Logout","text":"

On logout, this strategy will delete the token from the database.

"},{"location":"configuration/authentication/strategies/jwt/","title":"JWT","text":"

JSON Web Token (JWT) is an internet standard for creating access tokens based on JSON. They don't need to be stored in a database: the data is self-contained inside and cryptographically signed.

"},{"location":"configuration/authentication/strategies/jwt/#configuration","title":"Configuration","text":"
from fastapi_users.authentication import JWTStrategy\nSECRET = \"SECRET\"\ndef get_jwt_strategy() -> JWTStrategy:\nreturn JWTStrategy(secret=SECRET, lifetime_seconds=3600)\n

As you can see, instantiation is quite simple. It accepts the following arguments:

  • secret (Union[str, pydantic.SecretStr]): A constant secret which is used to encode the token. Use a strong passphrase and keep it secure.
  • lifetime_seconds (Optional[int]): The lifetime of the token in seconds. Can be set to None but in this case the token will be valid forever; which may raise serious security concerns.
  • token_audience (Optional[List[str]]): A list of valid audiences for the JWT token. Defaults to [\"fastapi-users:auth\"].
  • algorithm (Optional[str]): The JWT encryption algorithm. See RFC 7519, section 8. Defaults to \"HS256\".
  • public_key (Optional[Union[str, pydantic.SecretStr]]): If the JWT encryption algorithm requires a key pair instead of a simple secret, the key to decrypt the JWT may be provided here. The secret parameter will always be used to encrypt the JWT.

Why it's inside a function?

To allow strategies to be instantiated dynamically with other dependencies, they have to be provided as a callable to the authentication backend.

For JWTStrategy, since it doesn't require dependencies, it can be as simple as the function above.

"},{"location":"configuration/authentication/strategies/jwt/#rs256-example","title":"RS256 example","text":"
from fastapi_users.authentication import JWTStrategy\nPUBLIC_KEY = \"\"\"-----BEGIN PUBLIC KEY-----\n# Your RSA public key in PEM format goes here\n-----END PUBLIC KEY-----\"\"\"\nPRIVATE_KEY = \"\"\"-----BEGIN RSA PRIVATE KEY-----\n# Your RSA private key in PEM format goes here\n-----END RSA PRIVATE KEY-----\"\"\"\ndef get_jwt_strategy() -> JWTStrategy:\nreturn JWTStrategy(\nsecret=PRIVATE_KEY, \nlifetime_seconds=3600,\nalgorithm=\"RS256\",\npublic_key=PUBLIC_KEY,\n)\n
"},{"location":"configuration/authentication/strategies/jwt/#logout","title":"Logout","text":"

On logout, this strategy won't do anything. Indeed, a JWT can't be invalidated on the server-side: it's valid until it expires.

"},{"location":"configuration/authentication/strategies/redis/","title":"Redis","text":"

Redis is an ultra-fast key-store database. As such, it's a good candidate for token management. In this strategy, a token is generated and associated with the user id. in the database. On each request, we try to retrieve this token from Redis to get the corresponding user id.

"},{"location":"configuration/authentication/strategies/redis/#installation","title":"Installation","text":"

You should install the library with the optional dependencies for Redis:

pip install 'fastapi-users[redis]'\n
"},{"location":"configuration/authentication/strategies/redis/#configuration","title":"Configuration","text":"
import redis.asyncio\nfrom fastapi_users.authentication import RedisStrategy\nredis = redis.asyncio.from_url(\"redis://localhost:6379\", decode_responses=True)\ndef get_redis_strategy() -> RedisStrategy:\nreturn RedisStrategy(redis, lifetime_seconds=3600)\n

As you can see, instantiation is quite simple. It accepts the following arguments:

  • redis (redis.asyncio.Redis): An instance of redis.asyncio.Redis. Note that the decode_responses flag set to True is necessary.
  • lifetime_seconds (Optional[int]): The lifetime of the token in seconds. Defaults to None, which means the token doesn't expire.
  • key_prefix (str): The prefix used to set the key in the Redis stored. Defaults to fastapi_users_token:.

Why it's inside a function?

To allow strategies to be instantiated dynamically with other dependencies, they have to be provided as a callable to the authentication backend.

"},{"location":"configuration/authentication/strategies/redis/#logout","title":"Logout","text":"

On logout, this strategy will delete the token from the Redis store.

"},{"location":"configuration/authentication/transports/bearer/","title":"Bearer","text":"

With this transport, the token is expected inside the Authorization header of the HTTP request with the Bearer scheme. It's particularly suited for pure API interaction or mobile apps.

"},{"location":"configuration/authentication/transports/bearer/#configuration","title":"Configuration","text":"
from fastapi_users.authentication import BearerTransport\nbearer_transport = BearerTransport(tokenUrl=\"auth/jwt/login\")\n

As you can see, instantiation is quite simple. It accepts the following arguments:

  • tokenUrl (str): The exact path of your login endpoint. It'll allow the interactive documentation to automatically discover it and get a working Authorize button. In most cases, you'll probably need a relative path, not absolute. You can read more details about this in the FastAPI documentation.
"},{"location":"configuration/authentication/transports/bearer/#login","title":"Login","text":"

This method will return the in the following form upon successful login:

200 OK

{\n\"access_token\": \"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiOTIyMWZmYzktNjQwZi00MzcyLTg2ZDMtY2U2NDJjYmE1NjAzIiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTcxNTA0MTkzfQ.M10bjOe45I5Ncu_uXvOmVV8QxnL-nZfcH96U90JaocI\",\n\"token_type\": \"bearer\"\n}\n

Check documentation about login route.

"},{"location":"configuration/authentication/transports/bearer/#logout","title":"Logout","text":"

The logout method with this transport returns nothing.

"},{"location":"configuration/authentication/transports/bearer/#authentication","title":"Authentication","text":"

This method expects that you provide a Bearer authentication with a valid token corresponding to your strategy.

curl http://localhost:9000/protected-route -H'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiOTIyMWZmYzktNjQwZi00MzcyLTg2ZDMtY2U2NDJjYmE1NjAzIiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTcxNTA0MTkzfQ.M10bjOe45I5Ncu_uXvOmVV8QxnL-nZfcH96U90JaocI'\n
"},{"location":"configuration/authentication/transports/cookie/","title":"Cookie","text":"

Cookies are an easy way to store stateful information into the user browser. Thus, it is more useful for browser-based navigation (e.g. a front-end app making API requests) rather than pure API interaction.

"},{"location":"configuration/authentication/transports/cookie/#configuration","title":"Configuration","text":"
from fastapi_users.authentication import CookieTransport\ncookie_transport = CookieTransport(cookie_max_age=3600)\n

As you can see, instantiation is quite simple. It accepts the following arguments:

  • cookie_name (fastapiusersauth): Name of the cookie.
  • cookie_max_age (Optional[int]): The lifetime of the cookie in seconds. None by default, which means it's a session cookie.
  • cookie_path (/): Cookie path.
  • cookie_domain (None): Cookie domain.
  • cookie_secure (True): Whether to only send the cookie to the server via SSL request.
  • cookie_httponly (True): Whether to prevent access to the cookie via JavaScript.
  • cookie_samesite (lax): A string that specifies the samesite strategy for the cookie. Valid values are lax, strict and none. Defaults to lax.
"},{"location":"configuration/authentication/transports/cookie/#login","title":"Login","text":"

This method will return a response with a valid set-cookie header upon successful login:

200 OK

Check documentation about login route.

"},{"location":"configuration/authentication/transports/cookie/#logout","title":"Logout","text":"

This method will remove the authentication cookie:

200 OK

Check documentation about logout route.

"},{"location":"configuration/authentication/transports/cookie/#authentication","title":"Authentication","text":"

This method expects that you provide a valid cookie in the headers.

"},{"location":"configuration/databases/beanie/","title":"Beanie","text":"

FastAPI Users provides the necessary tools to work with MongoDB databases using the Beanie ODM.

"},{"location":"configuration/databases/beanie/#setup-database-connection-and-collection","title":"Setup database connection and collection","text":"

The first thing to do is to create a MongoDB connection using mongodb/motor (automatically installed with Beanie).

import motor.motor_asyncio\nfrom beanie import PydanticObjectId\nfrom fastapi_users.db import BeanieBaseUser, BeanieUserDatabase\nDATABASE_URL = \"mongodb://localhost:27017\"\nclient = motor.motor_asyncio.AsyncIOMotorClient(\nDATABASE_URL, uuidRepresentation=\"standard\"\n)\ndb = client[\"database_name\"]\nclass User(BeanieBaseUser[PydanticObjectId]):\npass\nasync def get_user_db():\nyield BeanieUserDatabase(User)\n

You can choose any name for the database.

"},{"location":"configuration/databases/beanie/#create-the-user-model","title":"Create the User model","text":"

As for any Beanie ODM model, we'll create a User model.

import motor.motor_asyncio\nfrom beanie import PydanticObjectId\nfrom fastapi_users.db import BeanieBaseUser, BeanieUserDatabase\nDATABASE_URL = \"mongodb://localhost:27017\"\nclient = motor.motor_asyncio.AsyncIOMotorClient(\nDATABASE_URL, uuidRepresentation=\"standard\"\n)\ndb = client[\"database_name\"]\nclass User(BeanieBaseUser[PydanticObjectId]):\npass\nasync def get_user_db():\nyield BeanieUserDatabase(User)\n

As you can see, FastAPI Users provides a base class that will include base fields for our User table. You can of course add you own fields there to fit to your needs!

Document ID is a MongoDB ObjectID

Beanie automatically manages document ID by encoding/decoding MongoDB ObjectID.

If you want to use another type, like UUID, you can override the id field:

import uuid\nfrom pydantic import Field\nclass User(BeanieBaseUser[uuid.UUID]):\nid: uuid.UUID = Field(default_factory=uuid.uuid4)\n

Notice that BeanieBaseUser expects a generic type to define the actual type of ID you use.

Info

The base class is configured to automatically create a unique index on id and email.

"},{"location":"configuration/databases/beanie/#create-the-database-adapter","title":"Create the database adapter","text":"

The database adapter of FastAPI Users makes the link between your database configuration and the users logic. It should be generated by a FastAPI dependency.

import motor.motor_asyncio\nfrom beanie import PydanticObjectId\nfrom fastapi_users.db import BeanieBaseUser, BeanieUserDatabase\nDATABASE_URL = \"mongodb://localhost:27017\"\nclient = motor.motor_asyncio.AsyncIOMotorClient(\nDATABASE_URL, uuidRepresentation=\"standard\"\n)\ndb = client[\"database_name\"]\nclass User(BeanieBaseUser[PydanticObjectId]):\npass\nasync def get_user_db():\nyield BeanieUserDatabase(User)\n

Notice that we pass a reference to the User model we defined above.

"},{"location":"configuration/databases/beanie/#initialize-beanie","title":"Initialize Beanie","text":"

When initializing your FastAPI app, it's important that you initialize Beanie so it can discover your models. We can achieve this using a startup event handler on the FastAPI app:

from beanie import init_beanie\n@app.on_event(\"startup\")\nasync def on_startup():\nawait init_beanie(\ndatabase=db,  # (1)!\ndocument_models=[\nUser,  # (2)!\n],\n)\n

  1. This is the db Motor database instance we defined above.

  2. This is the Beanie User model we defined above. Don't forget to also add your very own models!

"},{"location":"configuration/databases/sqlalchemy/","title":"SQLAlchemy","text":"

FastAPI Users provides the necessary tools to work with SQL databases thanks to SQLAlchemy ORM with asyncio.

"},{"location":"configuration/databases/sqlalchemy/#asynchronous-driver","title":"Asynchronous driver","text":"

To work with your DBMS, you'll need to install the corresponding asyncio driver. The common choices are:

  • For PostgreSQL: pip install asyncpg
  • For SQLite: pip install aiosqlite

Examples of DB_URLs are:

  • PostgreSQL: engine = create_engine('postgresql+asyncpg://user:password@host:port/name')
  • SQLite: engine = create_engine('sqlite+aiosqlite:///name.db')

For the sake of this tutorial from now on, we'll use a simple SQLite database.

"},{"location":"configuration/databases/sqlalchemy/#create-the-user-model","title":"Create the User model","text":"

As for any SQLAlchemy ORM model, we'll create a User model.

from typing import AsyncGenerator\nfrom fastapi import Depends\nfrom fastapi_users.db import SQLAlchemyBaseUserTableUUID, SQLAlchemyUserDatabase\nfrom sqlalchemy.ext.asyncio import AsyncSession, create_async_engine\nfrom sqlalchemy.orm import DeclarativeMeta, declarative_base, sessionmaker\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nBase: DeclarativeMeta = declarative_base()\nclass User(SQLAlchemyBaseUserTableUUID, Base):\npass\nengine = create_async_engine(DATABASE_URL)\nasync_session_maker = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\nasync def create_db_and_tables():\nasync with engine.begin() as conn:\nawait conn.run_sync(Base.metadata.create_all)\nasync def get_async_session() -> AsyncGenerator[AsyncSession, None]:\nasync with async_session_maker() as session:\nyield session\nasync def get_user_db(session: AsyncSession = Depends(get_async_session)):\nyield SQLAlchemyUserDatabase(session, User)\n

As you can see, FastAPI Users provides a base class that will include base fields for our User table. You can of course add you own fields there to fit to your needs!

Primary key is defined as UUID

By default, we use UUID as a primary key ID for your user. If you want to use another type, like an auto-incremented integer, you can use SQLAlchemyBaseUserTable as base class and define your own id column.

class User(SQLAlchemyBaseUserTable[int], Base):\nid = Column(Integer, primary_key=True)\n

Notice that SQLAlchemyBaseUserTable expects a generic type to define the actual type of ID you use.

"},{"location":"configuration/databases/sqlalchemy/#implement-a-function-to-create-the-tables","title":"Implement a function to create the tables","text":"

We'll now create an utility function to create all the defined tables.

from typing import AsyncGenerator\nfrom fastapi import Depends\nfrom fastapi_users.db import SQLAlchemyBaseUserTableUUID, SQLAlchemyUserDatabase\nfrom sqlalchemy.ext.asyncio import AsyncSession, create_async_engine\nfrom sqlalchemy.orm import DeclarativeMeta, declarative_base, sessionmaker\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nBase: DeclarativeMeta = declarative_base()\nclass User(SQLAlchemyBaseUserTableUUID, Base):\npass\nengine = create_async_engine(DATABASE_URL)\nasync_session_maker = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\nasync def create_db_and_tables():\nasync with engine.begin() as conn:\nawait conn.run_sync(Base.metadata.create_all)\nasync def get_async_session() -> AsyncGenerator[AsyncSession, None]:\nasync with async_session_maker() as session:\nyield session\nasync def get_user_db(session: AsyncSession = Depends(get_async_session)):\nyield SQLAlchemyUserDatabase(session, User)\n

This function can be called, for example, during the initialization of your FastAPI app.

Warning

In production, it's strongly recommended to setup a migration system to update your SQL schemas. See Alembic.

"},{"location":"configuration/databases/sqlalchemy/#create-the-database-adapter-dependency","title":"Create the database adapter dependency","text":"

The database adapter of FastAPI Users makes the link between your database configuration and the users logic. It should be generated by a FastAPI dependency.

from typing import AsyncGenerator\nfrom fastapi import Depends\nfrom fastapi_users.db import SQLAlchemyBaseUserTableUUID, SQLAlchemyUserDatabase\nfrom sqlalchemy.ext.asyncio import AsyncSession, create_async_engine\nfrom sqlalchemy.orm import DeclarativeMeta, declarative_base, sessionmaker\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nBase: DeclarativeMeta = declarative_base()\nclass User(SQLAlchemyBaseUserTableUUID, Base):\npass\nengine = create_async_engine(DATABASE_URL)\nasync_session_maker = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\nasync def create_db_and_tables():\nasync with engine.begin() as conn:\nawait conn.run_sync(Base.metadata.create_all)\nasync def get_async_session() -> AsyncGenerator[AsyncSession, None]:\nasync with async_session_maker() as session:\nyield session\nasync def get_user_db(session: AsyncSession = Depends(get_async_session)):\nyield SQLAlchemyUserDatabase(session, User)\n

Notice that we define first a get_async_session dependency returning us a fresh SQLAlchemy session to interact with the database.

It's then used inside the get_user_db dependency to generate our adapter. Notice that we pass it two things:

  • The session instance we just injected.
  • The User class, which is the actual SQLAlchemy model.
"},{"location":"configuration/routers/","title":"Routers","text":"

We're almost there! The last step is to configure the FastAPIUsers object that will wire the user manager, the authentication classes and let us generate the actual API routes.

"},{"location":"configuration/routers/#configure-fastapiusers","title":"Configure FastAPIUsers","text":"

Configure FastAPIUsers object with the elements we defined before. More precisely:

  • get_user_manager: Dependency callable getter to inject the user manager class instance. See UserManager.
  • auth_backends: List of authentication backends. See Authentication.
import uuid\nfrom fastapi_users import FastAPIUsers\nfrom .db import User\nfastapi_users = FastAPIUsers[User, uuid.UUID](\nget_user_manager,\n[auth_backend],\n)\n

Typing: User and ID generic types are expected

You can see that we define two generic types when instantiating:

  • User, which is the user model we defined in the database part
  • The ID, which should correspond to the type of ID you use on your model. Here, we chose UUID, but it can be anything, like an integer or a MongoDB ObjectID.

It'll help you to have good type-checking and auto-completion.

"},{"location":"configuration/routers/#available-routers","title":"Available routers","text":"

This helper class will let you generate useful routers to setup the authentication system. Each of them is optional, so you can pick only the one that you are interested in! Here are the routers provided:

  • Auth router: Provides /login and /logout routes for a given authentication backend.
  • Register router: Provides /register routes to allow a user to create a new account.
  • Reset password router: Provides /forgot-password and /reset-password routes to allow a user to reset its password.
  • Verify router: Provides /request-verify-token and /verify routes to manage user e-mail verification.
  • Users router: Provides routes to manage users.
  • OAuth router: Provides routes to perform an OAuth authentication against a service provider (like Google or Facebook).

You should check out each of them to understand how to use them.

"},{"location":"configuration/routers/auth/","title":"Auth router","text":"

The auth router will generate /login and /logout routes for a given authentication backend.

Check the routes usage to learn how to use them.

"},{"location":"configuration/routers/auth/#setup","title":"Setup","text":"
import uuid\nfrom fastapi import FastAPI\nfrom fastapi_users import FastAPIUsers\nfrom .db import User\nfastapi_users = FastAPIUsers[User, uuid.UUID](\nget_user_manager,\n[auth_backend],\n)\napp = FastAPI()\napp.include_router(\nfastapi_users.get_auth_router(auth_backend),\nprefix=\"/auth/jwt\",\ntags=[\"auth\"],\n)\n
"},{"location":"configuration/routers/auth/#optional-user-verification","title":"Optional: user verification","text":"

You can require the user to be verified (i.e. is_verified property set to True) to allow login. You have to set the requires_verification parameter to True on the router instantiation method:

app.include_router(\nfastapi_users.get_auth_router(auth_backend, requires_verification=True),\nprefix=\"/auth/jwt\",\ntags=[\"auth\"],\n)\n
"},{"location":"configuration/routers/register/","title":"Register routes","text":"

The register router will generate a /register route to allow a user to create a new account.

Check the routes usage to learn how to use them.

"},{"location":"configuration/routers/register/#setup","title":"Setup","text":"
import uuid\nfrom fastapi import FastAPI\nfrom fastapi_users import FastAPIUsers\nfrom .db import User\nfrom .schemas import UserCreate, UserRead\nfastapi_users = FastAPIUsers[User, uuid.UUID](\nget_user_manager,\n[auth_backend],\n)\napp = FastAPI()\napp.include_router(\nfastapi_users.get_register_router(UserRead, UserCreate),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\n
"},{"location":"configuration/routers/reset/","title":"Reset password router","text":"

The reset password router will generate /forgot-password (the user asks for a token to reset its password) and /reset-password (the user changes its password given the token) routes.

Check the routes usage to learn how to use them.

"},{"location":"configuration/routers/reset/#setup","title":"Setup","text":"
import uuid\nfrom fastapi import FastAPI\nfrom fastapi_users import FastAPIUsers\nfrom .db import User\nfastapi_users = FastAPIUsers[User, uuid.UUID](\nget_user_manager,\n[auth_backend],\n)\napp = FastAPI()\napp.include_router(\nfastapi_users.get_reset_password_router(),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\n
"},{"location":"configuration/routers/users/","title":"Users router","text":"

This router provides routes to manage users. Check the routes usage to learn how to use them.

"},{"location":"configuration/routers/users/#setup","title":"Setup","text":"
import uuid\nfrom fastapi import FastAPI\nfrom fastapi_users import FastAPIUsers\nfrom .db import User\nfrom .schemas import UserRead, UserUpdate\nfastapi_users = FastAPIUsers[User, uuid.UUID](\nget_user_manager,\n[auth_backend],\n)\napp = FastAPI()\napp.include_router(\nfastapi_users.get_users_router(UserRead, UserUpdate),\nprefix=\"/users\",\ntags=[\"users\"],\n)\n
"},{"location":"configuration/routers/users/#optional-user-verification","title":"Optional: user verification","text":"

You can require the user to be verified (i.e. is_verified property set to True) to access those routes. You have to set the requires_verification parameter to True on the router instantiation method:

app.include_router(\nfastapi_users.get_users_router(UserRead, UserUpdate, requires_verification=True),\nprefix=\"/users\",\ntags=[\"users\"],\n)\n
"},{"location":"configuration/routers/verify/","title":"Verify router","text":"

This router provides routes to manage user email verification. Check the routes usage to learn how to use them.

\ud83d\udc4f\ud83d\udc4f\ud83d\udc4f

A big thank you to Edd Salkield and Mark Todd who worked hard on this feature!

"},{"location":"configuration/routers/verify/#setup","title":"Setup","text":"
import uuid\nfrom fastapi import FastAPI\nfrom fastapi_users import FastAPIUsers\nfrom .db import User\nfrom .schemas import UserRead\nfastapi_users = FastAPIUsers[User, uuid.UUID](\nget_user_manager,\n[auth_backend],\n)\napp = FastAPI()\napp.include_router(\nfastapi_users.get_verify_router(UserRead),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\n
"},{"location":"cookbook/create-user-programmatically/","title":"Create a user programmatically","text":"

Sometimes, you'll need to create a user programmatically in the code rather than passing by the REST API endpoint. To do this, we'll create a function that you can call from your code.

In this context, we are outside the dependency injection mechanism of FastAPI, so we have to take care of instantiating the UserManager class and all other dependent objects manually.

For this cookbook, we'll consider you are starting from the SQLAlchemy full example, but it'll be rather similar for other DBMS.

"},{"location":"cookbook/create-user-programmatically/#1-define-dependencies-as-context-managers","title":"1. Define dependencies as context managers","text":"

Generally, FastAPI dependencies are defined as generators, using the yield keyword. FastAPI knows very well to handle them inside its dependency injection system. For example, here is the definition of the get_user_manager dependency:

async def get_user_manager(user_db: SQLAlchemyUserDatabase = Depends(get_user_db)):\nyield UserManager(user_db)\n

In Python, when we want to use a generator, we have to use a for loop, which would be a bit unnatural in this context since we have only one value to get, the user manager instance. To avoid this, we'll transform them into context managers, so we can call them using the with..as syntax. Fortunately, the standard library provides tools to automatically transform generators into context managers.

In the following sample, we import our dependencies and create a context manager version using contextlib.asynccontextmanager:

import contextlib\nfrom app.db import get_async_session, get_user_db\nfrom app.schemas import UserCreate\nfrom app.users import get_user_manager\nfrom fastapi_users.exceptions import UserAlreadyExists\nget_async_session_context = contextlib.asynccontextmanager(get_async_session)\nget_user_db_context = contextlib.asynccontextmanager(get_user_db)\nget_user_manager_context = contextlib.asynccontextmanager(get_user_manager)\nasync def create_user(email: str, password: str, is_superuser: bool = False):\ntry:\nasync with get_async_session_context() as session:\nasync with get_user_db_context(session) as user_db:\nasync with get_user_manager_context(user_db) as user_manager:\nuser = await user_manager.create(\nUserCreate(\nemail=email, password=password, is_superuser=is_superuser\n)\n)\nprint(f\"User created {user}\")\nexcept UserAlreadyExists:\nprint(f\"User {email} already exists\")\n

I have other dependencies

Since FastAPI Users fully embraces dependency injection, you may have more arguments passed to your database or user manager dependencies. It's important then to not forget anyone. Once again, outside the dependency injection system, you are responsible of instantiating everything yourself.

"},{"location":"cookbook/create-user-programmatically/#2-write-a-function","title":"2. Write a function","text":"

We are now ready to write a function. The example below shows you a basic example but you can of course adapt it to your own needs. The key part here is once again to take care of opening every context managers and pass them every required arguments, as the dependency manager would do.

import contextlib\nfrom app.db import get_async_session, get_user_db\nfrom app.schemas import UserCreate\nfrom app.users import get_user_manager\nfrom fastapi_users.exceptions import UserAlreadyExists\nget_async_session_context = contextlib.asynccontextmanager(get_async_session)\nget_user_db_context = contextlib.asynccontextmanager(get_user_db)\nget_user_manager_context = contextlib.asynccontextmanager(get_user_manager)\nasync def create_user(email: str, password: str, is_superuser: bool = False):\ntry:\nasync with get_async_session_context() as session:\nasync with get_user_db_context(session) as user_db:\nasync with get_user_manager_context(user_db) as user_manager:\nuser = await user_manager.create(\nUserCreate(\nemail=email, password=password, is_superuser=is_superuser\n)\n)\nprint(f\"User created {user}\")\nexcept UserAlreadyExists:\nprint(f\"User {email} already exists\")\n
"},{"location":"cookbook/create-user-programmatically/#3-use-it","title":"3. Use it","text":"

You can now easily use it in a script. For example:

import asyncio\nif __name__ == \"__main__\":\nasyncio.run(create_user(\"king.arthur@camelot.bt\", \"guinevere\"))\n
"},{"location":"migration/08_to_1x/","title":"0.8.x \u27a1\ufe0f 1.x.x","text":"

1.0 version introduces major breaking changes that need you to update some of your code and migrate your data.

"},{"location":"migration/08_to_1x/#id-are-uuid","title":"Id. are UUID","text":"

Users and OAuth accounts id. are now represented as real UUID objects instead of plain strings. This change was introduced to leverage efficient storage and indexing for DBMS that supports UUID (especially PostgreSQL and Mongo).

"},{"location":"migration/08_to_1x/#in-python-code","title":"In Python code","text":"

If you were doing comparison betwen a user id. and a string (in unit tests for example), you should now cast the id. to string:

# Before\nassert \"d35d213e-f3d8-4f08-954a-7e0d1bea286f\" == user.id\n# Now\nassert \"d35d213e-f3d8-4f08-954a-7e0d1bea286f\" == str(user.id)\n

If you were refering to user id. in your Pydantic models, the field should now be of UUID4 type instead of str:

from pydantic import BaseModel, UUID4\n# Before\nclass Model(BaseModel):\nuser_id: str\n# After\nclass Model(BaseModel):\nuser_id: UUID4\n
"},{"location":"migration/08_to_1x/#mongodb","title":"MongoDB","text":"

To avoid any issues, it's recommended to use the standard UUID representation when instantiating the MongoDB client:

DATABASE_URL = \"mongodb://localhost:27017\"\nclient = motor.motor_asyncio.AsyncIOMotorClient(\nDATABASE_URL, uuidRepresentation=\"standard\"\n)\n

This parameter controls how the UUID values will be encoded in the database. By default, it's set to pythonLegacy but new applications should consider setting this to standard for cross language compatibility. Read more about this.

"},{"location":"migration/08_to_1x/#in-database","title":"In database","text":"

Id. were before stored as strings in the database. You should make a migration to convert string data to UUID data.

Danger

Scripts below are provided as guidelines. Please review them carefully, adapt them and check that they are working on a test database before applying them to production. BE CAREFUL. THEY CAN DESTROY YOUR DATA..

"},{"location":"migration/08_to_1x/#postgresql","title":"PostgreSQL","text":"

PostgreSQL supports UUID type. If not already, you should enable the uuid-ossp extension:

CREATE EXTENSION IF NOT EXISTS \"uuid-ossp\";\n

To convert the existing id. string column, we can:

  1. Create a new column with UUID type.
  2. Fill it with the id. converted to UUID.
  3. Drop the original id. column.
  4. Make the new column a primary key and rename it.
ALTER TABLE \"user\" ADD uuid_id UUID;\nUPDATE \"user\" SET uuid_id = uuid(id);\nALTER TABLE \"user\" DROP id;\nALTER TABLE \"user\" ADD PRIMARY KEY (uuid_id);\nALTER TABLE \"user\" RENAME COLUMN uuid_id TO id;\n
"},{"location":"migration/08_to_1x/#mysql","title":"MySQL","text":"

MySQL doesn't support UUID type. We'll just convert the column to CHAR(36) type:

ALTER TABLE \"user\" MODIFY id CHAR(36);\n
"},{"location":"migration/08_to_1x/#mongodb_1","title":"MongoDB","text":""},{"location":"migration/08_to_1x/#mongo-shell","title":"Mongo shell","text":"

For MongoDB, we can use a forEach iterator to convert the id. for each document:

db.getCollection('users').find().forEach(function(user) {\nvar uuid = UUID(user.id);\ndb.getCollection('users').update({_id: user._id}, [{$set: {id: uuid}}]);\n});\n
"},{"location":"migration/08_to_1x/#python","title":"Python","text":"
import uuid\nimport motor.motor_asyncio\nasync def migrate_uuid():\nclient = motor.motor_asyncio.AsyncIOMotorClient(\nDATABASE_URL, uuidRepresentation=\"standard\"\n)\ndb = client[\"database_name\"]\nusers = db[\"users\"]\nasync for user in users.find({}):\nawait users.update_one(\n{\"_id\": user[\"_id\"]},\n{\"$set\": {\"id\": uuid.UUID(user[\"id\"])}},\n)\n
"},{"location":"migration/08_to_1x/#splitted-routers","title":"Splitted routers","text":"

You now have the responsibility to wire the routers. FastAPI Users doesn't give a bloated users router anymore.

Event handlers are also removed. You have to provide your \"after-\" logic as a parameter of the router generator.

"},{"location":"migration/08_to_1x/#before","title":"Before","text":"
jwt_authentication = JWTAuthentication(secret=SECRET, lifetime_seconds=3600)\napp = FastAPI()\nfastapi_users = FastAPIUsers(\nuser_db, [jwt_authentication], User, UserCreate, UserUpdate, UserDB,\n)\napp.include_router(fastapi_users.router, prefix=\"/users\", tags=[\"users\"])\n@fastapi_users.on_after_register()\ndef on_after_register(user: User, request: Request):\nprint(f\"User {user.id} has registered.\")\n@fastapi_users.on_after_forgot_password()\ndef on_after_forgot_password(user: User, token: str, request: Request):\nprint(f\"User {user.id} has forgot their password. Reset token: {token}\")\n
"},{"location":"migration/08_to_1x/#after","title":"After","text":"
def on_after_register(user: UserDB, request: Request):\nprint(f\"User {user.id} has registered.\")\ndef on_after_forgot_password(user: UserDB, token: str, request: Request):\nprint(f\"User {user.id} has forgot their password. Reset token: {token}\")\njwt_authentication = JWTAuthentication(secret=SECRET, lifetime_seconds=3600)\napp = FastAPI()\nfastapi_users = FastAPIUsers(\nuser_db, [jwt_authentication], User, UserCreate, UserUpdate, UserDB,\n)\napp.include_router(\nfastapi_users.get_auth_router(jwt_authentication), prefix=\"/auth/jwt\", tags=[\"auth\"]\n)\napp.include_router(\nfastapi_users.get_register_router(on_after_register), prefix=\"/auth\", tags=[\"auth\"]\n)\napp.include_router(\nfastapi_users.get_reset_password_router(\nSECRET, after_forgot_password=on_after_forgot_password\n),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(fastapi_users.get_users_router(), prefix=\"/users\", tags=[\"users\"])\n

Important things to notice:

  • FastAPIUsers takes two arguments less (reset_password_token_secret and reset_password_token_lifetime_seconds).
  • You have more flexibility to choose the prefix and tags of the routers.
  • The /login//logout are now your responsibility to include for each backend. The path will change (before /login/jwt, after /jwt/login).
  • If you don't care about some of those routers, you can discard them.
"},{"location":"migration/1x_to_2x/","title":"1.x.x \u27a1\ufe0f 2.x.x","text":""},{"location":"migration/1x_to_2x/#jwt-authentication-backend","title":"JWT authentication backend","text":"

To be fully compatible with Swagger authentication, the output of a successful login operation with the JWT authentication backend has changed:

Before

{\n\"token\": \"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiOTIyMWZmYzktNjQwZi00MzcyLTg2ZDMtY2U2NDJjYmE1NjAzIiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTcxNTA0MTkzfQ.M10bjOe45I5Ncu_uXvOmVV8QxnL-nZfcH96U90JaocI\"\n}\n

After

{\n\"access_token\": \"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiOTIyMWZmYzktNjQwZi00MzcyLTg2ZDMtY2U2NDJjYmE1NjAzIiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTcxNTA0MTkzfQ.M10bjOe45I5Ncu_uXvOmVV8QxnL-nZfcH96U90JaocI\",\n\"token_type\": \"bearer\"\n}\n

Make sure to update your clients to read the token in the right property.

"},{"location":"migration/2x_to_3x/","title":"2.x.x \u27a1\ufe0f 3.x.x","text":""},{"location":"migration/2x_to_3x/#emails-are-now-case-insensitive","title":"Emails are now case-insensitive","text":"

Before 3.x.x, the local part (before the @) of the email address was case-sensitive. Therefore, king.arthur@camelot.bt and King.Arthur@camelot.bt were considered as two different users. This behaviour was a bit confusing and not consistent with 99% of web services out there.

After 3.x.x, users are fetched from the database with a case-insensitive email search. Bear in mind though that if the user registers with the email King.Arthur@camelot.bt, it will be stored exactly like this in the database (with casing) ; but he will be able to login as king.arthur@camelot.bt.

Danger

It's super important then, before you upgrade to 3.x.x that you check if there are several users with the same email with different cases ; and that you merge or delete those accounts.

"},{"location":"migration/3x_to_4x/","title":"3.x.x \u27a1\ufe0f 4.x.x","text":""},{"location":"migration/3x_to_4x/#expires_at-property-in-oauthaccount-is-now-optional","title":"expires_at property in OAuthAccount is now optional","text":"

Before 4.x.x, the expires_at property in OAuthAccount model was mandatory. It was causing issues with some services that don't have such expiration property.

If you use SQLAlchemy or Tortoise databases adapters, you'll have to make a migration to update your database schema.

"},{"location":"migration/4x_to_5x/","title":"4.x.x \u27a1\ufe0f 5.x.x","text":""},{"location":"migration/4x_to_5x/#new-property-is_verified-in-user-model","title":"New property is_verified in User model.","text":"

Starting 5.x.x., there is a new e-mail verification feature. Even if optional, the is_verified property has been added to the User model.

If you use SQLAlchemy or Tortoise databases adapters, you'll have to make a migration to update your database schema.

"},{"location":"migration/6x_to_7x/","title":"6.x.x \u27a1\ufe0f 7.x.x","text":"
  • The deprecated dependencies to retrieve current user have been removed. Use the current_user factory instead. [Documentation]
  • When trying to authenticate a not verified user, a status code 403 is raised instead of status code 401. Thanks @daanbeverdam \ud83c\udf89 [Documentation]
  • Your UserUpdate model shouldn't inherit from the base User class. If you have custom fields, you should repeat them in this model. [Documentation]
  • Database adapters now live in their own repositories and packages.
  • When upgrading to v7.0.0, the dependency for your database adapter should automatically be installed.
  • The import statements remain unchanged.
"},{"location":"migration/7x_to_8x/","title":"7.x.x \u27a1\ufe0f 8.x.x","text":"

Version 8 includes the biggest code changes since version 1. We reorganized lot of parts of the code to make it even more modular and integrate more into the dependency injection system of FastAPI.

Most importantly, you need now to implement a UserManager class and a associated dependency to create an instance of this class.

"},{"location":"migration/7x_to_8x/#event-handlers-should-live-in-the-usermanager","title":"Event handlers should live in the UserManager","text":"

Before, event handlers like on_after_register or on_after_forgot_password were defined in their own functions that were passed as arguments of router generators.

Now, they should be methods of the UserManager class.

You can read more in the UserManager documentation.

"},{"location":"migration/7x_to_8x/#password-validation-should-live-in-the-usermanager","title":"Password validation should live in the UserManager","text":"

Before, password validation was defined in its own function that was passed as argument of FastAPIUsers.

Now, it should be a method of the UserManager class.

You can read more in the UserManager documentation.

"},{"location":"migration/7x_to_8x/#verify-token-secret-and-lifetime-parameters-are-attributes-of-usermanager","title":"Verify token secret and lifetime parameters are attributes of UserManager","text":"

Before, verify token and lifetime parameters were passed as argument of get_verify_router.

Now, they should be defined as attributes of the UserManager class.

You can read more in the UserManager documentation.

"},{"location":"migration/7x_to_8x/#reset-password-token-secret-and-lifetime-parameters-are-attributes-of-usermanager","title":"Reset password token secret and lifetime parameters are attributes of UserManager","text":"

Before, reset password token and lifetime parameters were passed as argument of get_verify_router.

Now, they should be defined as attributes of the UserManager class.

You can read more in the UserManager documentation.

"},{"location":"migration/7x_to_8x/#database-adapter-should-be-provided-in-a-dependency","title":"Database adapter should be provided in a dependency","text":"

Before, we advised to directly instantiate the database adapter class.

Now, it should be instantiated inside a dependency that you define yourself. The benefit of this is that it lives in the dependency injection system of FastAPI, allowing you to have more dynamic logic to create your instance.

\u27a1\ufe0f I'm using SQLAlchemy

\u27a1\ufe0f I'm using MongoDB

\u27a1\ufe0f I'm using Tortoise ORM

\u27a1\ufe0f I'm using ormar

"},{"location":"migration/7x_to_8x/#fastapiusers-now-expect-a-get_user_manager-dependency","title":"FastAPIUsers now expect a get_user_manager dependency","text":"

Before, the database adapter instance was passed as argument of FastAPIUsers.

Now, you should define a get_user_manager dependency returning an instance of your UserManager class. This dependency will be dependent of the database adapter dependency.

You can read more in the UserManager documentation and FastAPIUsers documentation

"},{"location":"migration/7x_to_8x/#lost","title":"Lost?","text":"

If you're unsure or a bit lost, make sure to check the full working examples.

"},{"location":"migration/8x_to_9x/","title":"8.x.x \u27a1\ufe0f 9.x.x","text":"

Version 9 revamps the authentication backends: we splitted the logic of a backend into two: the transport, which is how the token will be carried over the request and the strategy, which is how the token is generated and secured.

The benefit of this is that we'll soon be able to propose new strategies, like database session tokens, without having to repeat the transport logic which remains the same.

"},{"location":"migration/8x_to_9x/#convert-the-authentication-backend","title":"Convert the authentication backend","text":"

You now have to generate an authentication backend with a transport and a strategy.

"},{"location":"migration/8x_to_9x/#i-used-jwtauthentication","title":"I used JWTAuthentication","text":"BeforeAfter 
from fastapi_users.authentication import JWTAuthentication\njwt_authentication = JWTAuthentication(\nsecret=SECRET, lifetime_seconds=3600, tokenUrl=\"auth/jwt/login\"\n)\n
from fastapi_users.authentication import AuthenticationBackend, BearerTransport, JWTStrategy\nSECRET = \"SECRET\"\nbearer_transport = BearerTransport(tokenUrl=\"auth/jwt/login\")\ndef get_jwt_strategy() -> JWTStrategy:\nreturn JWTStrategy(secret=SECRET, lifetime_seconds=3600)\nauth_backend = AuthenticationBackend(\nname=\"jwt\",\ntransport=bearer_transport,\nget_strategy=get_jwt_strategy,\n)\n

Warning

There is no default name anymore: you need to provide it yourself for each of your backends.

"},{"location":"migration/8x_to_9x/#i-used-cookieauthentication","title":"I used CookieAuthentication","text":"BeforeAfter 
from fastapi_users.authentication import CookieAuthentication\ncookie_authentication = CookieAuthentication(secret=SECRET, lifetime_seconds=3600)\n
from fastapi_users.authentication import AuthenticationBackend, CookieTransport, JWTStrategy\nSECRET = \"SECRET\"\ncookie_transport = CookieTransport(cookie_max_age=3600)\ndef get_jwt_strategy() -> JWTStrategy:\nreturn JWTStrategy(secret=SECRET, lifetime_seconds=3600)\nauth_backend = AuthenticationBackend(\nname=\"cookie\",\ntransport=cookie_transport,\nget_strategy=get_jwt_strategy,\n)\n

Warning

There is no default name anymore: you need to provide it yourself for each of your backends.

Tip

Notice that the strategy is the same for both authentication backends. That's the beauty of this approach: the token generation is decoupled from its transport.

"},{"location":"migration/8x_to_9x/#oauth-one-router-for-each-backend","title":"OAuth: one router for each backend","text":"

Before, a single OAuth router was enough to login with any of your authentication backend. Now, you need to generate a router for each of your backends.

BeforeAfter 
app.include_router(\nfastapi_users.get_oauth_router(google_oauth_client, \"SECRET\"),\nprefix=\"/auth/google\",\ntags=[\"auth\"],\n)\n
app.include_router(\nfastapi_users.get_oauth_router(google_oauth_client, auth_backend, \"SECRET\"),\nprefix=\"/auth/google\",\ntags=[\"auth\"],\n)\n
"},{"location":"migration/8x_to_9x/#authentication_backend-is-not-needed-on-authorize","title":"authentication_backend is not needed on /authorize","text":"

The consequence of this is that you don't need to specify the authentication backend when making a request to /authorize.

BeforeAfter 
curl \\\n-H \"Content-Type: application/json\" \\\n-X GET \\\nhttp://localhost:8000/auth/google/authorize?authentication_backend=jwt\n
curl \\\n-H \"Content-Type: application/json\" \\\n-X GET \\\nhttp://localhost:8000/auth/google/authorize\n
"},{"location":"migration/8x_to_9x/#lost","title":"Lost?","text":"

If you're unsure or a bit lost, make sure to check the full working examples.

"},{"location":"migration/9x_to_10x/","title":"9.x.x \u27a1\ufe0f 10.x.x","text":"

Version 10 marks important changes in how we manage User models and their ID.

Before, we were relying only on Pydantic models to work with users. In particular the current_user dependency would return you an instance of UserDB, a Pydantic model. This proved to be quite problematic with some ORM if you ever needed to retrieve relationship data or make specific requests.

Now, FastAPI Users is designed to always return you a native object for your ORM model, whether it's an SQLAlchemy model or a Beanie document. Pydantic models are now only used for validation and serialization inside the API.

Before, we were forcing the use of UUID as primary key ID; a consequence of the design above. This proved to be quite problematic on some databases, like MongoDB which uses a special ObjectID format by default. Some SQL folks also prefer to use traditional auto-increment integers.

Now, FastAPI Users is designed to use generic ID type. It means that you can use any type you want for your user's ID. By default, SQLAlchemy adapter still use UUID; but you can quite easily switch to another thing, like an integer. Beanie adapter for MongoDB will use native ObjectID by default, but it also can be overriden.

As you may have guessed, those changes imply quite a lot of breaking changes.

"},{"location":"migration/9x_to_10x/#user-models-and-database-adapter","title":"User models and database adapter","text":""},{"location":"migration/9x_to_10x/#sqlalchemy-orm","title":"SQLAlchemy ORM","text":"

We've removed the old SQLAlchemy dependency support, so the dependency is now fastapi-users[sqlalchemy].

BeforeAfter 
fastapi\nfastapi-users[sqlalchemy2]\nuvicorn[standard]\naiosqlite\n
fastapi\nfastapi-users[sqlalchemy]\nuvicorn[standard]\naiosqlite\n

The User model base class for SQLAlchemy slightly changed to support UUID by default.

We changed the name of the class from UserTable to User: it's not a compulsory change, but since there is no risk of confusion with Pydantic models anymore, it's probably a more idiomatic naming.

BeforeAfter 
class UserTable(Base, SQLAlchemyBaseUserTable):\npass\n
class User(SQLAlchemyBaseUserTableUUID, Base):\npass\n

Instantiating the SQLAlchemyUserDatabase adapter now only expects this User model. UserDB is removed.

BeforeAfter 
async def get_user_db(session: AsyncSession = Depends(get_async_session)):\nyield SQLAlchemyUserDatabase(UserDB, session, UserTable)\n
async def get_user_db(session: AsyncSession = Depends(get_async_session)):\nyield SQLAlchemyUserDatabase(session, User)\n
"},{"location":"migration/9x_to_10x/#mongodb","title":"MongoDB","text":"

MongoDB support is now only provided through Beanie ODM. Even if you don't use it for the rest of your project, it's a very light addition that shouldn't interfere much.

BeforeAfter 
fastapi\nfastapi-users[mongodb]\nuvicorn[standard]\naiosqlite\n
fastapi\nfastapi-users[beanie]\nuvicorn[standard]\naiosqlite\n

You now need to define a proper User model using Beanie.

BeforeAfter 
import os\nimport motor.motor_asyncio\nfrom fastapi_users.db import MongoDBUserDatabase\nfrom app.models import UserDB\nDATABASE_URL = os.environ[\"DATABASE_URL\"]\nclient = motor.motor_asyncio.AsyncIOMotorClient(\nDATABASE_URL, uuidRepresentation=\"standard\"\n)\ndb = client[\"database_name\"]\ncollection = db[\"users\"]\nasync def get_user_db():\nyield MongoDBUserDatabase(UserDB, collection)\n
import motor.motor_asyncio\nfrom beanie import PydanticObjectId\nfrom fastapi_users.db import BeanieBaseUser, BeanieUserDatabase\nDATABASE_URL = \"mongodb://localhost:27017\"\nclient = motor.motor_asyncio.AsyncIOMotorClient(\nDATABASE_URL, uuidRepresentation=\"standard\"\n)\ndb = client[\"database_name\"]\nclass User(BeanieBaseUser[PydanticObjectId]):\npass\nasync def get_user_db():\nyield BeanieUserDatabase(User)\n

ID are now ObjectID by default

By default, User ID will now be native MongoDB ObjectID. If you don't want to make the transition and keep UUID you can do so by overriding the id field:

import uuid\nfrom pydantic import Field\nclass User(BeanieBaseUser[uuid.UUID]):\nid: uuid.UUID = Field(default_factory=uuid.uuid4)\n

Beanie also needs to be initialized in a startup event handler of your FastAPI app:

from beanie import init_beanie\n@app.on_event(\"startup\")\nasync def on_startup():\nawait init_beanie(\ndatabase=db,\ndocument_models=[\nUser,\n],\n)\n
"},{"location":"migration/9x_to_10x/#tortoise-orm-and-ormar","title":"Tortoise ORM and ormar","text":"

Unfortunately, we sometimes need to make difficult choices to keep things sustainable. That's why we decided to not support Tortoise ORM and ormar anymore. It appeared they were not widely used.

You can still add support for those ORM yourself by implementing the necessary adapter. You can take inspiration from the SQLAlchemy one.

"},{"location":"migration/9x_to_10x/#usermanager","title":"UserManager","text":"

There is some slight changes on the UserManager class. In particular, it now needs a parse_id method that can be provided through built-in mixins.

Generic typing now expects your native User model class and the type of ID.

The user_db_model class property is removed.

BeforeAfter 
class UserManager(BaseUserManager[UserCreate, UserDB]):\nuser_db_model = UserDB\nreset_password_token_secret = SECRET\nverification_token_secret = SECRET\nasync def on_after_register(self, user: UserDB, request: Optional[Request] = None):\nprint(f\"User {user.id} has registered.\")\nasync def on_after_forgot_password(\nself, user: UserDB, token: str, request: Optional[Request] = None\n):\nprint(f\"User {user.id} has forgot their password. Reset token: {token}\")\nasync def on_after_request_verify(\nself, user: UserDB, token: str, request: Optional[Request] = None\n):\nprint(f\"Verification requested for user {user.id}. Verification token: {token}\")\n
class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]):\nreset_password_token_secret = SECRET\nverification_token_secret = SECRET\nasync def on_after_register(self, user: User, request: Optional[Request] = None):\nprint(f\"User {user.id} has registered.\")\nasync def on_after_forgot_password(\nself, user: User, token: str, request: Optional[Request] = None\n):\nprint(f\"User {user.id} has forgot their password. Reset token: {token}\")\nasync def on_after_request_verify(\nself, user: User, token: str, request: Optional[Request] = None\n):\nprint(f\"Verification requested for user {user.id}. Verification token: {token}\")\n

If you need to support other types of ID, you can read more about it in the dedicated section.

"},{"location":"migration/9x_to_10x/#pydantic-models","title":"Pydantic models","text":"

To better distinguish them from the ORM models, Pydantic models are now called schemas.

UserDB has been removed in favor of native models.

We changed the name of User to UserRead: it's not a compulsory change, but since there is a risk of confusion with the native model, it's highly recommended.

Besides, the BaseUser schema now accepts a generic type to specify the type of ID you use.

BeforeAfter 
from fastapi_users import models\nclass User(models.BaseUser):\npass\nclass UserCreate(models.BaseUserCreate):\npass\nclass UserUpdate(models.BaseUserUpdate):\npass\nclass UserDB(User, models.BaseUserDB):\npass\n
import uuid\nfrom fastapi_users import schemas\nclass UserRead(schemas.BaseUser[uuid.UUID]):\npass\nclass UserCreate(schemas.BaseUserCreate):\npass\nclass UserUpdate(schemas.BaseUserUpdate):\npass\n
"},{"location":"migration/9x_to_10x/#fastapi-users-and-routers","title":"FastAPI Users and routers","text":"

Pydantic schemas are now way less important in this new design. As such, you don't need to pass them when initializing the FastAPIUsers class:

BeforeAfter 
fastapi_users = FastAPIUsers(\nget_user_manager,\n[auth_backend],\nUser,\nUserCreate,\nUserUpdate,\nUserDB,\n)\n
fastapi_users = FastAPIUsers[User, uuid.UUID](\nget_user_manager,\n[auth_backend],\n)\n

As a consequence, those schemas need to be passed when initializing the router that needs them: get_register_router, get_verify_router and get_users_router.

BeforeAfter 
app.include_router(\nfastapi_users.get_auth_router(auth_backend), prefix=\"/auth/jwt\", tags=[\"auth\"]\n)\napp.include_router(fastapi_users.get_register_router(), prefix=\"/auth\", tags=[\"auth\"])\napp.include_router(\nfastapi_users.get_reset_password_router(),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(\nfastapi_users.get_verify_router(),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(fastapi_users.get_users_router(), prefix=\"/users\", tags=[\"users\"])\n
app.include_router(\nfastapi_users.get_auth_router(auth_backend), prefix=\"/auth/jwt\", tags=[\"auth\"]\n)\napp.include_router(\nfastapi_users.get_register_router(UserRead, UserCreate),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(\nfastapi_users.get_reset_password_router(),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(\nfastapi_users.get_verify_router(UserRead),\nprefix=\"/auth\",\ntags=[\"auth\"],\n)\napp.include_router(\nfastapi_users.get_users_router(UserRead, UserUpdate),\nprefix=\"/users\",\ntags=[\"users\"],\n)\n
"},{"location":"migration/9x_to_10x/#lost","title":"Lost?","text":"

If you're unsure or a bit lost, make sure to check the full working examples.

"},{"location":"usage/current-user/","title":"Get current user","text":"

FastAPI Users provides a dependency callable to easily inject authenticated user in your routes. They are available from your FastAPIUsers instance.

Tip

For more information about how to make an authenticated request to your API, check the documentation of your Authentication method.

"},{"location":"usage/current-user/#current_user","title":"current_user","text":"

Return a dependency callable to retrieve currently authenticated user, passing the following parameters:

  • optional: If True, None is returned if there is no authenticated user or if it doesn't pass the other requirements. Otherwise, throw 401 Unauthorized. Defaults to False.
  • active: If True, throw 401 Unauthorized if the authenticated user is inactive. Defaults to False.
  • verified: If True, throw 403 Forbidden if the authenticated user is not verified. Defaults to False.
  • superuser: If True, throw 403 Forbidden if the authenticated user is not a superuser. Defaults to False.
  • get_enabled_backends: Optional dependency callable returning a list of enabled authentication backends. Useful if you want to dynamically enable some authentication backends based on external logic, like a configuration in database. By default, all specified authentication backends are enabled. Please not however that every backends will appear in the OpenAPI documentation, as FastAPI resolves it statically.

Create it once and reuse it

This function is a factory, a function returning another function \ud83e\udd2f

It's this returned function that will be the dependency called by FastAPI in your API routes.

To avoid having to generate it on each route and avoid issues when unit testing, it's strongly recommended that you assign the result in a variable and reuse it at will in your routes. The examples below demonstrate this pattern.

"},{"location":"usage/current-user/#examples","title":"Examples","text":""},{"location":"usage/current-user/#get-the-current-user-active-or-not","title":"Get the current user (active or not)","text":"
current_user = fastapi_users.current_user()\n@app.get(\"/protected-route\")\ndef protected_route(user: User = Depends(current_user)):\nreturn f\"Hello, {user.email}\"\n
"},{"location":"usage/current-user/#get-the-current-active-user","title":"Get the current active user","text":"
current_active_user = fastapi_users.current_user(active=True)\n@app.get(\"/protected-route\")\ndef protected_route(user: User = Depends(current_active_user)):\nreturn f\"Hello, {user.email}\"\n
"},{"location":"usage/current-user/#get-the-current-active-and-verified-user","title":"Get the current active and verified user","text":"
current_active_verified_user = fastapi_users.current_user(active=True, verified=True)\n@app.get(\"/protected-route\")\ndef protected_route(user: User = Depends(current_active_verified_user)):\nreturn f\"Hello, {user.email}\"\n
"},{"location":"usage/current-user/#get-the-current-active-superuser","title":"Get the current active superuser","text":"
current_superuser = fastapi_users.current_user(active=True, superuser=True)\n@app.get(\"/protected-route\")\ndef protected_route(user: User = Depends(current_superuser)):\nreturn f\"Hello, {user.email}\"\n
"},{"location":"usage/current-user/#dynamically-enable-authentication-backends","title":"Dynamically enable authentication backends","text":"

Warning

This is an advanced feature for cases where you have several authentication backends that are enabled conditionally. In most cases, you won't need this option.

from fastapi import Request\nfrom fastapi_users.authentication import AuthenticationBackend, BearerTransport, CookieTransport, JWTStrategy\nSECRET = \"SECRET\"\nbearer_transport = BearerTransport(tokenUrl=\"auth/jwt/login\")\ncookie_transport = CookieTransport(cookie_max_age=3600)\ndef get_jwt_strategy() -> JWTStrategy:\nreturn JWTStrategy(secret=SECRET, lifetime_seconds=3600)\njwt_backend = AuthenticationBackend(\nname=\"jwt\",\ntransport=bearer_transport,\nget_strategy=get_jwt_strategy,\n)\ncookie_backend = AuthenticationBackend(\nname=\"jwt\",\ntransport=cookie_transport,\nget_strategy=get_jwt_strategy,\n)\nasync def get_enabled_backends(request: Request):\n\"\"\"Return the enabled dependencies following custom logic.\"\"\"\nif request.url.path == \"/protected-route-only-jwt\":\nreturn [jwt_backend]\nelse:\nreturn [cookie_backend, jwt_backend]\ncurrent_active_user = fastapi_users.current_user(active=True, get_enabled_backends=get_enabled_backends)\n@app.get(\"/protected-route\")\ndef protected_route(user: User = Depends(current_active_user)):\nreturn f\"Hello, {user.email}. You are authenticated with a cookie or a JWT.\"\n@app.get(\"/protected-route-only-jwt\")\ndef protected_route(user: User = Depends(current_active_user)):\nreturn f\"Hello, {user.email}. You are authenticated with a JWT.\"\n
"},{"location":"usage/current-user/#in-a-path-operation","title":"In a path operation","text":"

If you don't need the user in the route logic, you can use this syntax:

@app.get(\"/protected-route\", dependencies=[Depends(current_superuser)])\ndef protected_route():\nreturn \"Hello, some user.\"\n

You can read more about this in FastAPI docs.

"},{"location":"usage/flow/","title":"Flow","text":"

This page will present you a complete registration and authentication flow once you've setup FastAPI Users. Each example will be presented with a cURL and an axios example.

"},{"location":"usage/flow/#1-registration","title":"1. Registration","text":"

First step, of course, is to register as a user.

"},{"location":"usage/flow/#request","title":"Request","text":"cURLaxios 
curl \\\n-H \"Content-Type: application/json\" \\\n-X POST \\\n-d \"{\\\"email\\\": \\\"king.arthur@camelot.bt\\\",\\\"password\\\": \\\"guinevere\\\"}\" \\\nhttp://localhost:8000/auth/register\n
axios.post('http://localhost:8000/auth/register', {\nemail: 'king.arthur@camelot.bt',\npassword: 'guinevere',\n})\n.then((response) => console.log(response))\n.catch((error) => console.log(error));\n
"},{"location":"usage/flow/#response","title":"Response","text":"

You'll get a JSON response looking like this:

{\n\"id\": \"4fd3477b-eccf-4ee3-8f7d-68ad72261476\",\n\"email\": \"king.arthur@camelot.bt\",\n\"is_active\": true,\n\"is_superuser\": false\n}\n

Info

Several things to bear in mind:

  • If you have defined other required fields in your User model (like a first name or a birthdate), you'll have to provide them in the payload.
  • The user is active by default.
  • The user cannot set is_active or is_superuser itself at registration. Only a superuser can do it by PATCHing the user.
"},{"location":"usage/flow/#2-login","title":"2. Login","text":"

Now, you can login as this new user.

You can generate a login route for each authentication backend. Each backend will have a different response.

"},{"location":"usage/flow/#bearer-jwt","title":"Bearer + JWT","text":""},{"location":"usage/flow/#request_1","title":"Request","text":"cURLaxios 
curl \\\n-H \"Content-Type: multipart/form-data\" \\\n-X POST \\\n-F \"username=king.arthur@camelot.bt\" \\\n-F \"password=guinevere\" \\\nhttp://localhost:8000/auth/jwt/login\n
const formData = new FormData();\nformData.set('username', 'king.arthur@camelot.bt');\nformData.set('password', 'guinevere');\naxios.post(\n'http://localhost:8000/auth/jwt/login',\nformData,\n{\nheaders: {\n'Content-Type': 'multipart/form-data',\n},\n},\n)\n.then((response) => console.log(response))\n.catch((error) => console.log(error));\n

Warning

Notice that we don't send it as a JSON payload here but with form data instead. Also, the email is provided by a field named username.

"},{"location":"usage/flow/#response_1","title":"Response","text":"

You'll get a JSON response looking like this:

{\n\"access_token\":\"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNGZkMzQ3N2ItZWNjZi00ZWUzLThmN2QtNjhhZDcyMjYxNDc2IiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTg3ODE4NDI5fQ.anO3JR8-WYCozZ4_2-PQ2Ov9O38RaLP2RAzQIiZhteM\",\n\"token_type\": \"bearer\"\n}\n

You can use this token to make authenticated requests as the user king.arthur@camelot.bt. We'll see how in the next section.

"},{"location":"usage/flow/#cookie-jwt","title":"Cookie + JWT","text":""},{"location":"usage/flow/#request_2","title":"Request","text":"cURLaxios 
curl \\\n-v \\\n-H \"Content-Type: multipart/form-data\" \\\n-X POST \\\n-F \"username=king.arthur@camelot.bt\" \\\n-F \"password=guinevere\" \\\nhttp://localhost:8000/auth/cookie/login\n
const formData = new FormData();\nformData.set('username', 'king.arthur@camelot.bt');\nformData.set('password', 'guinevere');\naxios.post(\n'http://localhost:8000/auth/cookie/login',\nformData,\n{\nheaders: {\n'Content-Type': 'multipart/form-data',\n},\n},\n)\n.then((response) => console.log(response))\n.catch((error) => console.log(error));\n

Warning

Notice that we don't send it as a JSON payload here but with form data instead. Also, the email is provided by a field named username.

"},{"location":"usage/flow/#response_2","title":"Response","text":"

You'll get an empty response. However, the response will come with a Set-Cookie header (that's why we added the -v option in cURL to see them).

set-cookie: fastapiusersauth=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiYzYwNjBmMTEtNTM0OS00YTI0LThiNGEtYTJhODc1ZGM1Mzk1IiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTg3ODE4OTQ3fQ.qNA4oPVYhoqrJIk-zvAyEfEVoEnP156G30H_SWEU0sU; HttpOnly; Max-Age=3600; Path=/; Secure\n

You can make authenticated requests as the user king.arthur@camelot.bt by setting a Cookie header with this cookie.

Tip

The cookie backend is more suited for browsers, as they handle them automatically. This means that if you make a login request in the browser, it will automatically store the cookie and automatically send it in subsequent requests.

"},{"location":"usage/flow/#3-get-my-profile","title":"3. Get my profile","text":"

Now that we can authenticate, we can get our own profile data. Depending on your authentication backend, the method to authenticate the request will vary. We'll stick with JWT from now on.

"},{"location":"usage/flow/#request_3","title":"Request","text":"cURLaxios 
export TOKEN=\"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNGZkMzQ3N2ItZWNjZi00ZWUzLThmN2QtNjhhZDcyMjYxNDc2IiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTg3ODE4NDI5fQ.anO3JR8-WYCozZ4_2-PQ2Ov9O38RaLP2RAzQIiZhteM\";\ncurl \\\n-H \"Content-Type: application/json\" \\\n-H \"Authorization: Bearer $TOKEN\" \\\n-X GET \\\nhttp://localhost:8000/users/me\n
const TOKEN = 'eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNGZkMzQ3N2ItZWNjZi00ZWUzLThmN2QtNjhhZDcyMjYxNDc2IiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTg3ODE4NDI5fQ.anO3JR8-WYCozZ4_2-PQ2Ov9O38RaLP2RAzQIiZhteM';\naxios.get(\n'http://localhost:8000/users/me', {\nheaders: {\n'Authorization': `Bearer ${TOKEN}`,\n},\n})\n.then((response) => console.log(response))\n.catch((error) => console.log(error));\n
"},{"location":"usage/flow/#response_3","title":"Response","text":"

You'll get a JSON response looking like this:

{\n\"id\": \"4fd3477b-eccf-4ee3-8f7d-68ad72261476\",\n\"email\": \"king.arthur@camelot.bt\",\n\"is_active\": true,\n\"is_superuser\": false\n}\n

Tip

If you use one of the dependency callable to protect one of your own endpoint, you'll have to authenticate exactly in the same way.

"},{"location":"usage/flow/#4-update-my-profile","title":"4. Update my profile","text":"

We can also update our own profile. For example, we can change our password like this.

"},{"location":"usage/flow/#request_4","title":"Request","text":"cURLaxios 
curl \\\n-H \"Content-Type: application/json\" \\\n-H \"Authorization: Bearer $TOKEN\" \\\n-X PATCH \\\n-d \"{\\\"password\\\": \\\"lancelot\\\"}\" \\\nhttp://localhost:8000/users/me\n
axios.patch(\n'http://localhost:8000/users/me',\n{\npassword: 'lancelot',\n},\n{\nheaders: {\n'Authorization': `Bearer ${TOKEN}`,\n},\n},\n)\n.then((response) => console.log(response))\n.catch((error) => console.log(error));\n
"},{"location":"usage/flow/#response_4","title":"Response","text":"

You'll get a JSON response looking like this:

{\n\"id\": \"4fd3477b-eccf-4ee3-8f7d-68ad72261476\",\n\"email\": \"king.arthur@camelot.bt\",\n\"is_active\": true,\n\"is_superuser\": false\n}\n

Info

Once again, the user cannot set is_active or is_superuser itself. Only a superuser can do it by PATCHing the user.

"},{"location":"usage/flow/#5-become-a-superuser","title":"5. Become a superuser \ud83e\uddb8\ud83c\udffb\u200d\u2642\ufe0f","text":"

If you want to manage the users of your application, you'll have to become a superuser.

The very first superuser can only be set at database level: open it through a CLI or a GUI, find your user and set the is_superuser column/property to true.

"},{"location":"usage/flow/#51-get-the-profile-of-any-user","title":"5.1. Get the profile of any user","text":"

Now that you are a superuser, you can leverage the power of superuser routes. You can for example get the profile of any user in the database given its id.

"},{"location":"usage/flow/#request_5","title":"Request","text":"cURLaxios 
curl \\\n-H \"Content-Type: application/json\" \\\n-H \"Authorization: Bearer $TOKEN\" \\\n-X GET \\\nhttp://localhost:8000/users/4fd3477b-eccf-4ee3-8f7d-68ad72261476\n
axios.get(\n'http://localhost:8000/users/4fd3477b-eccf-4ee3-8f7d-68ad72261476', {\nheaders: {\n'Authorization': `Bearer ${TOKEN}`,\n},\n})\n.then((response) => console.log(response))\n.catch((error) => console.log(error));\n
"},{"location":"usage/flow/#response_5","title":"Response","text":"

You'll get a JSON response looking like this:

{\n\"id\": \"4fd3477b-eccf-4ee3-8f7d-68ad72261476\",\n\"email\": \"king.arthur@camelot.bt\",\n\"is_active\": true,\n\"is_superuser\": false\n}\n
"},{"location":"usage/flow/#51-update-any-user","title":"5.1. Update any user","text":"

We can now update the profile of any user. For example, we can promote it as superuser.

"},{"location":"usage/flow/#request_6","title":"Request","text":"cURLaxios 
curl \\\n-H \"Content-Type: application/json\" \\\n-H \"Authorization: Bearer $TOKEN\" \\\n-X PATCH \\\n-d \"{\\\"is_superuser\\\": true}\" \\\nhttp://localhost:8000/users/4fd3477b-eccf-4ee3-8f7d-68ad72261476\n
axios.patch(\n'http://localhost:8000/users/4fd3477b-eccf-4ee3-8f7d-68ad72261476',\n{\nis_superuser: true,\n},\n{\nheaders: {\n'Authorization': `Bearer ${TOKEN}`,\n},\n},\n)\n.then((response) => console.log(response))\n.catch((error) => console.log(error));\n
"},{"location":"usage/flow/#response_6","title":"Response","text":"

You'll get a JSON response looking like this:

{\n\"id\": \"4fd3477b-eccf-4ee3-8f7d-68ad72261476\",\n\"email\": \"king.arthur@camelot.bt\",\n\"is_active\": true,\n\"is_superuser\": true\n}\n
"},{"location":"usage/flow/#52-delete-any-user","title":"5.2. Delete any user","text":"

Finally, we can delete a user.

"},{"location":"usage/flow/#request_7","title":"Request","text":"cURLaxios 
curl \\\n-H \"Content-Type: application/json\" \\\n-H \"Authorization: Bearer $TOKEN\" \\\n-X DELETE \\\nhttp://localhost:8000/users/4fd3477b-eccf-4ee3-8f7d-68ad72261476\n
axios.delete(\n'http://localhost:8000/users/4fd3477b-eccf-4ee3-8f7d-68ad72261476',\n{\nheaders: {\n'Authorization': `Bearer ${TOKEN}`,\n},\n},\n)\n.then((response) => console.log(response))\n.catch((error) => console.log(error));\n
"},{"location":"usage/flow/#response_7","title":"Response","text":"

You'll get an empty response.

"},{"location":"usage/flow/#6-logout","title":"6. Logout","text":"

We can also end the session.

"},{"location":"usage/flow/#request_8","title":"Request","text":"cURLaxios 
curl \\\n-H \"Content-Type: application/json\" \\\n-H \"Cookie: fastapiusersauth=$TOKEN\" \\\n-X POST \\\nhttp://localhost:8000/auth/cookie/logout\n
axios.post('http://localhost:8000/auth/cookie/logout',\nnull,\n{\nheaders: {\n'Cookie': `fastapiusersauth=${TOKEN}`,\n},\n}\n)\n.then((response) => console.log(response))\n.catch((error) => console.log(error));\n
"},{"location":"usage/flow/#response_8","title":"Response","text":"

You'll get an empty response.

"},{"location":"usage/flow/#conclusion","title":"Conclusion","text":"

That's it! You now have a good overview of how you can manage the users through the API. Be sure to check the Routes page to have all the details about each endpoints.

"},{"location":"usage/routes/","title":"Routes","text":"

You'll find here the routes exposed by FastAPI Users. Note that you can also review them through the interactive API docs.

"},{"location":"usage/routes/#auth-router","title":"Auth router","text":"

Each authentication backend you generate a router for will produce the following routes. Take care about the prefix you gave it, especially if you have several backends.

"},{"location":"usage/routes/#post-login","title":"POST /login","text":"

Login a user against the method named name. Check the corresponding authentication method to view the success response.

Payload (application/x-www-form-urlencoded)

username=king.arthur@camelot.bt&password=guinevere\n

422 Validation Error

400 Bad Request

Bad credentials or the user is inactive.

{\n\"detail\": \"LOGIN_BAD_CREDENTIALS\"\n}\n

400 Bad Request

The user is not verified.

{\n\"detail\": \"LOGIN_USER_NOT_VERIFIED\"\n}\n
"},{"location":"usage/routes/#post-logout","title":"POST /logout","text":"

Logout the authenticated user against the method named name. Check the corresponding authentication method to view the success response.

401 Unauthorized

Missing token or inactive user.

200 OK

The logout process was successful.

"},{"location":"usage/routes/#register-router","title":"Register router","text":""},{"location":"usage/routes/#post-register","title":"POST /register","text":"

Register a new user. Will call the on_after_register handler on successful registration.

Payload

{\n\"email\": \"king.arthur@camelot.bt\",\n\"password\": \"guinevere\"\n}\n

201 Created

{\n\"id\": \"57cbb51a-ab71-4009-8802-3f54b4f2e23\",\n\"email\": \"king.arthur@camelot.bt\",\n\"is_active\": true,\n\"is_superuser\": false\n}\n

422 Validation Error

400 Bad Request

A user already exists with this email.

{\n\"detail\": \"REGISTER_USER_ALREADY_EXISTS\"\n}\n

400 Bad Request

Password validation failed.

{\n\"detail\": {\n\"code\": \"REGISTER_INVALID_PASSWORD\",\n\"reason\": \"Password should be at least 3 characters\"\n}\n}\n
"},{"location":"usage/routes/#reset-password-router","title":"Reset password router","text":""},{"location":"usage/routes/#post-forgot-password","title":"POST /forgot-password","text":"

Request a reset password procedure. Will generate a temporary token and call the on_after_forgot_password handler if the user exists.

To prevent malicious users from guessing existing users in your database, the route will always return a 202 Accepted response, even if the user requested does not exist.

Payload

{\n\"email\": \"king.arthur@camelot.bt\"\n}\n

202 Accepted

"},{"location":"usage/routes/#post-reset-password","title":"POST /reset-password","text":"

Reset a password. Requires the token generated by the /forgot-password route.

Payload

{\n\"token\": \"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiOTIyMWZmYzktNjQwZi00MzcyLTg2ZDMtY2U2NDJjYmE1NjAzIiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTcxNTA0MTkzfQ.M10bjOe45I5Ncu_uXvOmVV8QxnL-nZfcH96U90JaocI\",\n\"password\": \"merlin\"\n}\n

200 OK

422 Validation Error

400 Bad Request

Bad or expired token.

{\n\"detail\": \"RESET_PASSWORD_BAD_TOKEN\"\n}\n

400 Bad Request

Password validation failed.

{\n\"detail\": {\n\"code\": \"RESET_PASSWORD_INVALID_PASSWORD\",\n\"reason\": \"Password should be at least 3 characters\"\n}\n}\n
"},{"location":"usage/routes/#verify-router","title":"Verify router","text":""},{"location":"usage/routes/#post-request-verify-token","title":"POST /request-verify-token","text":"

Request a user to verify their e-mail. Will generate a temporary token and call the on_after_request_verify handler if the user exists, active and not already verified.

To prevent malicious users from guessing existing users in your database, the route will always return a 202 Accepted response, even if the user requested does not exist, not active or already verified.

Payload

{\n\"email\": \"king.arthur@camelot.bt\"\n}\n

202 Accepted

"},{"location":"usage/routes/#post-verify","title":"POST /verify","text":"

Verify a user. Requires the token generated by the /request-verify-token route. Will call the call the on_after_verify handler on success.

Payload

{\n\"token\": \"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiOTIyMWZmYzktNjQwZi00MzcyLTg2ZDMtY2U2NDJjYmE1NjAzIiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTcxNTA0MTkzfQ.M10bjOe45I5Ncu_uXvOmVV8QxnL-nZfcH96U90JaocI\"\n}\n

200 OK

422 Validation Error

400 Bad Request

Bad token, not existing user or not the e-mail currently set for the user.

{\n\"detail\": \"VERIFY_USER_BAD_TOKEN\"\n}\n

400 Bad Request

The user is already verified.

{\n\"detail\": \"VERIFY_USER_ALREADY_VERIFIED\"\n}\n
"},{"location":"usage/routes/#oauth-router","title":"OAuth router","text":"

Each OAuth router you define will expose the two following routes.

"},{"location":"usage/routes/#get-authorize","title":"GET /authorize","text":"

Return the authorization URL for the OAuth service where you should redirect your user.

Query parameters

  • scopes: Optional list of scopes to ask for. Expected format: scopes=a&scopes=b.

200 OK

{\n\"authorization_url\": \"https://www.tintagel.bt/oauth/authorize?client_id=CLIENT_ID&scopes=a+b&redirect_uri=https://www.camelot.bt/oauth/callback\"\n}\n
"},{"location":"usage/routes/#get-callback","title":"GET /callback","text":"

Handle the OAuth callback.

Query parameters

  • code: OAuth callback code.
  • state: State token.
  • error: OAuth error.

Depending on the situation, several things can happen:

  • The OAuth account exists in database and is linked to a user:
    • OAuth account is updated in database with fresh access token.
    • The user is authenticated following the chosen authentication method.
  • The OAuth account doesn't exist in database but a user with the same email address exists:
    • By default, an HTTP 400 error is raised.
    • If the associate_by_email flag is set to True on the router declaration, OAuth account is linked to the user. The user is authenticated following the chosen authentication method.
  • The OAuth account doesn't exist in database and no user with the email address exists:
    • A new user is created and linked to the OAuth account.
    • The user is authenticated following the chosen authentication method.

400 Bad Request

Invalid token.

400 Bad Request

The OAuth provider didn't return an e-mail address. Make sure this provider return e-mail address through their API and you have asked for the required scope.

{\n\"detail\": \"OAUTH_NOT_AVAILABLE_EMAIL\"\n}\n

400 Bad Request

Another user with the same e-mail address already exists.

{\n\"detail\": \"OAUTH_USER_ALREADY_EXISTS\"\n}\n

400 Bad Request

User is inactive.

{\n\"detail\": \"LOGIN_BAD_CREDENTIALS\"\n}\n
"},{"location":"usage/routes/#oauth-association-router","title":"OAuth association router","text":"

Each OAuth association router you define will expose the two following routes.

"},{"location":"usage/routes/#get-authorize_1","title":"GET /authorize","text":"

Return the authorization URL for the OAuth service where you should redirect your user.

Query parameters

  • scopes: Optional list of scopes to ask for. Expected format: scopes=a&scopes=b.

401 Unauthorized

Missing token or inactive user.

200 OK

{\n\"authorization_url\": \"https://www.tintagel.bt/oauth/authorize?client_id=CLIENT_ID&scopes=a+b&redirect_uri=https://www.camelot.bt/oauth/callback\"\n}\n
"},{"location":"usage/routes/#get-callback_1","title":"GET /callback","text":"

Handle the OAuth callback and add the OAuth account to the current authenticated active user.

Query parameters

  • code: OAuth callback code.
  • state: State token.
  • error: OAuth error.

401 Unauthorized

Missing token or inactive user.

400 Bad Request

Invalid token.

400 Bad Request

The OAuth provider didn't return an e-mail address. Make sure this provider return e-mail address through their API and you have asked for the required scope.

{\n\"detail\": \"OAUTH_NOT_AVAILABLE_EMAIL\"\n}\n

200 OK

{\n\"id\": \"57cbb51a-ab71-4009-8802-3f54b4f2e23\",\n\"email\": \"king.arthur@tintagel.bt\",\n\"is_active\": true,\n\"is_superuser\": false,\n\"oauth_accounts\": [\n{\n\"id\": \"6c98caf5-9bc5-4c4f-8a45-a0ae0c40cd77\",\n\"oauth_name\": \"TINTAGEL\",\n\"access_token\": \"ACCESS_TOKEN\",\n\"expires_at\": \"1641040620\",\n\"account_id\": \"king_arthur_tintagel\",\n\"account_email\": \"king.arthur@tintagel.bt\"\n}\n]\n}\n
"},{"location":"usage/routes/#users-router","title":"Users router","text":""},{"location":"usage/routes/#get-me","title":"GET /me","text":"

Return the current authenticated active user.

200 OK

{\n\"id\": \"57cbb51a-ab71-4009-8802-3f54b4f2e23\",\n\"email\": \"king.arthur@camelot.bt\",\n\"is_active\": true,\n\"is_superuser\": false\n}\n

401 Unauthorized

Missing token or inactive user.

"},{"location":"usage/routes/#patch-me","title":"PATCH /me","text":"

Update the current authenticated active user.

Payload

{\n\"email\": \"king.arthur@tintagel.bt\",\n\"password\": \"merlin\"\n}\n

200 OK

{\n\"id\": \"57cbb51a-ab71-4009-8802-3f54b4f2e23\",\n\"email\": \"king.arthur@tintagel.bt\",\n\"is_active\": true,\n\"is_superuser\": false\n}\n

401 Unauthorized

Missing token or inactive user.

400 Bad Request

Password validation failed.

{\n\"detail\": {\n\"code\": \"UPDATE_USER_INVALID_PASSWORD\",\n\"reason\": \"Password should be at least 3 characters\"\n}\n}\n

400 Bad Request

A user with this email already exists. 

{\n\"detail\": \"UPDATE_USER_EMAIL_ALREADY_EXISTS\"\n}\n

422 Validation Error

"},{"location":"usage/routes/#get-user_id","title":"GET /{user_id}","text":"

Return the user with id user_id.

200 OK

{\n\"id\": \"57cbb51a-ab71-4009-8802-3f54b4f2e23\",\n\"email\": \"king.arthur@camelot.bt\",\n\"is_active\": true,\n\"is_superuser\": false\n}\n

401 Unauthorized

Missing token or inactive user.

403 Forbidden

Not a superuser.

404 Not found

The user does not exist.

"},{"location":"usage/routes/#patch-user_id","title":"PATCH /{user_id}","text":"

Update the user with id user_id.

Payload

{\n\"email\": \"king.arthur@tintagel.bt\",\n\"password\": \"merlin\",\n\"is_active\": false,\n\"is_superuser\": true\n}\n

200 OK

{\n\"id\": \"57cbb51a-ab71-4009-8802-3f54b4f2e23\",\n\"email\": \"king.arthur@camelot.bt\",\n\"is_active\": false,\n\"is_superuser\": true\n}\n

401 Unauthorized

Missing token or inactive user.

403 Forbidden

Not a superuser.

404 Not found

The user does not exist.

400 Bad Request

Password validation failed.

{\n\"detail\": {\n\"code\": \"UPDATE_USER_INVALID_PASSWORD\",\n\"reason\": \"Password should be at least 3 characters\"\n}\n}\n

400 Bad Request

A user with this email already exists. 

{\n\"detail\": \"UPDATE_USER_EMAIL_ALREADY_EXISTS\"\n}\n

"},{"location":"usage/routes/#delete-user_id","title":"DELETE /{user_id}","text":"

Delete the user with id user_id.

204 No content

401 Unauthorized

Missing token or inactive user.

403 Forbidden

Not a superuser.

404 Not found

The user does not exist.

"}]} \ No newline at end of file diff --git a/10.3/sitemap.xml b/10.3/sitemap.xml new file mode 100644 index 00000000..ae648a17 --- /dev/null +++ b/10.3/sitemap.xml @@ -0,0 +1,183 @@ + + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + + None + 2023-01-16 + daily + + \ No newline at end of file diff --git a/10.3/sitemap.xml.gz b/10.3/sitemap.xml.gz new file mode 100644 index 0000000000000000000000000000000000000000..fca527f445e11f8064f96bd6572b4b87a55afd11 GIT binary patch literal 218 zcmb2|=HLj^IhxG$zc{lbH8-(9uOc^x;q6&pz9s_!)(5uBGj=U!_34=vRHhgEl2K}f z1Cwsqsuyo{?G5i7oawuKz5ZX9kMFEMUE+(%E}FHeMJU%Rdh4=tFW*-6@o$+hv0@kB z7WIWW3d?)HAMX5IC?mNg?t2zPTI|_{Ifqz(NPTLNUD@L?<7IQ|Z1<9FQ^d2kJh;5A zHsC>Z^huqQWrdTDy|fFtmJ_Tkotjl!{!3B&YMJ~&^OH)S AsyncGenerator[AsyncSession, None]: + async with async_session_maker() as session: + yield session + + +async def get_user_db(session: AsyncSession = Depends(get_async_session)): + yield SQLAlchemyUserDatabase(session, User) diff --git a/10.3/src/db_sqlalchemy_access_tokens.py b/10.3/src/db_sqlalchemy_access_tokens.py new file mode 100644 index 00000000..ab2e7049 --- /dev/null +++ b/10.3/src/db_sqlalchemy_access_tokens.py @@ -0,0 +1,45 @@ +from typing import AsyncGenerator + +from fastapi import Depends +from fastapi_users.db import SQLAlchemyBaseUserTableUUID, SQLAlchemyUserDatabase +from fastapi_users_db_sqlalchemy.access_token import ( + SQLAlchemyAccessTokenDatabase, + SQLAlchemyBaseAccessTokenTableUUID, +) +from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine +from sqlalchemy.orm import DeclarativeMeta, declarative_base, sessionmaker + +DATABASE_URL = "sqlite+aiosqlite:///./test.db" +Base: DeclarativeMeta = declarative_base() + + +class User(SQLAlchemyBaseUserTableUUID, Base): + pass + + +class AccessToken(SQLAlchemyBaseAccessTokenTableUUID, Base): # (1)! + pass + + +engine = create_async_engine(DATABASE_URL) +async_session_maker = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False) + + +async def create_db_and_tables(): + async with engine.begin() as conn: + await conn.run_sync(Base.metadata.create_all) + + +async def get_async_session() -> AsyncGenerator[AsyncSession, None]: + async with async_session_maker() as session: + yield session + + +async def get_user_db(session: AsyncSession = Depends(get_async_session)): + yield SQLAlchemyUserDatabase(session, User) + + +async def get_access_token_db( + session: AsyncSession = Depends(get_async_session), +): # (2)! + yield SQLAlchemyAccessTokenDatabase(session, AccessToken) diff --git a/10.3/src/db_sqlalchemy_oauth.py b/10.3/src/db_sqlalchemy_oauth.py new file mode 100644 index 00000000..d130064a --- /dev/null +++ b/10.3/src/db_sqlalchemy_oauth.py @@ -0,0 +1,39 @@ +from typing import AsyncGenerator, List + +from fastapi import Depends +from fastapi_users.db import ( + SQLAlchemyBaseOAuthAccountTableUUID, + SQLAlchemyBaseUserTableUUID, + SQLAlchemyUserDatabase, +) +from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine +from sqlalchemy.orm import DeclarativeMeta, declarative_base, relationship, sessionmaker + +DATABASE_URL = "sqlite+aiosqlite:///./test.db" +Base: DeclarativeMeta = declarative_base() + + +class OAuthAccount(SQLAlchemyBaseOAuthAccountTableUUID, Base): + pass + + +class User(SQLAlchemyBaseUserTableUUID, Base): + oauth_accounts: List[OAuthAccount] = relationship("OAuthAccount", lazy="joined") + + +engine = create_async_engine(DATABASE_URL) +async_session_maker = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False) + + +async def create_db_and_tables(): + async with engine.begin() as conn: + await conn.run_sync(Base.metadata.create_all) + + +async def get_async_session() -> AsyncGenerator[AsyncSession, None]: + async with async_session_maker() as session: + yield session + + +async def get_user_db(session: AsyncSession = Depends(get_async_session)): + yield SQLAlchemyUserDatabase(session, User, OAuthAccount) diff --git a/10.3/src/user_manager.py b/10.3/src/user_manager.py new file mode 100644 index 00000000..55f435fd --- /dev/null +++ b/10.3/src/user_manager.py @@ -0,0 +1,31 @@ +import uuid +from typing import Optional + +from fastapi import Depends, Request +from fastapi_users import BaseUserManager, UUIDIDMixin + +from .db import User, get_user_db + +SECRET = "SECRET" + + +class UserManager(UUIDIDMixin, BaseUserManager[User, uuid.UUID]): + reset_password_token_secret = SECRET + verification_token_secret = SECRET + + async def on_after_register(self, user: User, request: Optional[Request] = None): + print(f"User {user.id} has registered.") + + async def on_after_forgot_password( + self, user: User, token: str, request: Optional[Request] = None + ): + print(f"User {user.id} has forgot their password. Reset token: {token}") + + async def on_after_request_verify( + self, user: User, token: str, request: Optional[Request] = None + ): + print(f"Verification requested for user {user.id}. Verification token: {token}") + + +async def get_user_manager(user_db=Depends(get_user_db)): + yield UserManager(user_db) diff --git a/10.3/usage/current-user/index.html b/10.3/usage/current-user/index.html new file mode 100644 index 00000000..bd3d09ea --- /dev/null +++ b/10.3/usage/current-user/index.html @@ -0,0 +1,1428 @@ + + + + + + + + + + + + + + + + + + + + + + + + Get current user - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Get current user

+

FastAPI Users provides a dependency callable to easily inject authenticated user in your routes. They are available from your FastAPIUsers instance.

+
+

Tip

+

For more information about how to make an authenticated request to your API, check the documentation of your Authentication method.

+
+

current_user

+

Return a dependency callable to retrieve currently authenticated user, passing the following parameters:

+
    +
  • optional: If True, None is returned if there is no authenticated user or if it doesn't pass the other requirements. Otherwise, throw 401 Unauthorized. Defaults to False.
    • +
  • active: If True, throw 401 Unauthorized if the authenticated user is inactive. Defaults to False.
    • +
  • verified: If True, throw 403 Forbidden if the authenticated user is not verified. Defaults to False.
    • +
  • superuser: If True, throw 403 Forbidden if the authenticated user is not a superuser. Defaults to False.
    • +
  • get_enabled_backends: Optional dependency callable returning a list of enabled authentication backends. Useful if you want to dynamically enable some authentication backends based on external logic, like a configuration in database. By default, all specified authentication backends are enabled. Please not however that every backends will appear in the OpenAPI documentation, as FastAPI resolves it statically.
    • +
+
+

Create it once and reuse it

+

This function is a factory, a function returning another function 🤯

+

It's this returned function that will be the dependency called by FastAPI in your API routes.

+

To avoid having to generate it on each route and avoid issues when unit testing, it's strongly recommended that you assign the result in a variable and reuse it at will in your routes. The examples below demonstrate this pattern.

+
+

Examples

+

Get the current user (active or not)

+
current_user = fastapi_users.current_user()
+
+@app.get("/protected-route")
+def protected_route(user: User = Depends(current_user)):
+    return f"Hello, {user.email}"
+
+

Get the current active user

+
current_active_user = fastapi_users.current_user(active=True)
+
+@app.get("/protected-route")
+def protected_route(user: User = Depends(current_active_user)):
+    return f"Hello, {user.email}"
+
+

Get the current active and verified user

+
current_active_verified_user = fastapi_users.current_user(active=True, verified=True)
+
+@app.get("/protected-route")
+def protected_route(user: User = Depends(current_active_verified_user)):
+    return f"Hello, {user.email}"
+
+

Get the current active superuser

+
current_superuser = fastapi_users.current_user(active=True, superuser=True)
+
+@app.get("/protected-route")
+def protected_route(user: User = Depends(current_superuser)):
+    return f"Hello, {user.email}"
+
+

Dynamically enable authentication backends

+
+

Warning

+

This is an advanced feature for cases where you have several authentication backends that are enabled conditionally. In most cases, you won't need this option.

+
+
from fastapi import Request
+from fastapi_users.authentication import AuthenticationBackend, BearerTransport, CookieTransport, JWTStrategy
+
+SECRET = "SECRET"
+
+bearer_transport = BearerTransport(tokenUrl="auth/jwt/login")
+cookie_transport = CookieTransport(cookie_max_age=3600)
+
+def get_jwt_strategy() -> JWTStrategy:
+    return JWTStrategy(secret=SECRET, lifetime_seconds=3600)
+
+jwt_backend = AuthenticationBackend(
+    name="jwt",
+    transport=bearer_transport,
+    get_strategy=get_jwt_strategy,
+)
+cookie_backend = AuthenticationBackend(
+    name="jwt",
+    transport=cookie_transport,
+    get_strategy=get_jwt_strategy,
+)
+
+async def get_enabled_backends(request: Request):
+    """Return the enabled dependencies following custom logic."""
+    if request.url.path == "/protected-route-only-jwt":
+        return [jwt_backend]
+    else:
+        return [cookie_backend, jwt_backend]
+
+
+current_active_user = fastapi_users.current_user(active=True, get_enabled_backends=get_enabled_backends)
+
+
+@app.get("/protected-route")
+def protected_route(user: User = Depends(current_active_user)):
+    return f"Hello, {user.email}. You are authenticated with a cookie or a JWT."
+
+
+@app.get("/protected-route-only-jwt")
+def protected_route(user: User = Depends(current_active_user)):
+    return f"Hello, {user.email}. You are authenticated with a JWT."
+
+

In a path operation

+

If you don't need the user in the route logic, you can use this syntax:

+
@app.get("/protected-route", dependencies=[Depends(current_superuser)])
+def protected_route():
+    return "Hello, some user."
+
+

You can read more about this in FastAPI docs.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/usage/flow/index.html b/10.3/usage/flow/index.html new file mode 100644 index 00000000..513a12ea --- /dev/null +++ b/10.3/usage/flow/index.html @@ -0,0 +1,2116 @@ + + + + + + + + + + + + + + + + + + + + + + + + Flow - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Flow

+

This page will present you a complete registration and authentication flow once you've setup FastAPI Users. Each example will be presented with a cURL and an axios example.

+

1. Registration

+

First step, of course, is to register as a user.

+

Request

+
+
+
+
curl \
+-H "Content-Type: application/json" \
+-X POST \
+-d "{\"email\": \"king.arthur@camelot.bt\",\"password\": \"guinevere\"}" \
+http://localhost:8000/auth/register
+
+
+
+
axios.post('http://localhost:8000/auth/register', {
+    email: 'king.arthur@camelot.bt',
+    password: 'guinevere',
+})
+.then((response) => console.log(response))
+.catch((error) => console.log(error));
+
+
+
+
+

Response

+

You'll get a JSON response looking like this:

+
{
+    "id": "4fd3477b-eccf-4ee3-8f7d-68ad72261476",
+    "email": "king.arthur@camelot.bt",
+    "is_active": true,
+    "is_superuser": false
+}
+
+
+

Info

+

Several things to bear in mind:

+
    +
  • If you have defined other required fields in your User model (like a first name or a birthdate), you'll have to provide them in the payload.
    • +
  • The user is active by default.
    • +
  • The user cannot set is_active or is_superuser itself at registration. Only a superuser can do it by PATCHing the user.
    • +
+
+

2. Login

+

Now, you can login as this new user.

+

You can generate a login route for each authentication backend. Each backend will have a different response.

+

Bearer + JWT

+

Request

+
+
+
+
curl \
+-H "Content-Type: multipart/form-data" \
+-X POST \
+-F "username=king.arthur@camelot.bt" \
+-F "password=guinevere" \
+http://localhost:8000/auth/jwt/login
+
+
+
+
const formData = new FormData();
+formData.set('username', 'king.arthur@camelot.bt');
+formData.set('password', 'guinevere');
+axios.post(
+    'http://localhost:8000/auth/jwt/login',
+    formData,
+    {
+        headers: {
+            'Content-Type': 'multipart/form-data',
+        },
+    },
+)
+.then((response) => console.log(response))
+.catch((error) => console.log(error));
+
+
+
+
+
+

Warning

+

Notice that we don't send it as a JSON payload here but with form data instead. Also, the email is provided by a field named username.

+
+

Response

+

You'll get a JSON response looking like this:

+
{
+    "access_token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNGZkMzQ3N2ItZWNjZi00ZWUzLThmN2QtNjhhZDcyMjYxNDc2IiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTg3ODE4NDI5fQ.anO3JR8-WYCozZ4_2-PQ2Ov9O38RaLP2RAzQIiZhteM",
+    "token_type": "bearer"
+}
+
+

You can use this token to make authenticated requests as the user king.arthur@camelot.bt. We'll see how in the next section.

+ +

Request

+
+
+
+
curl \
+-v \
+-H "Content-Type: multipart/form-data" \
+-X POST \
+-F "username=king.arthur@camelot.bt" \
+-F "password=guinevere" \
+http://localhost:8000/auth/cookie/login
+
+
+
+
const formData = new FormData();
+formData.set('username', 'king.arthur@camelot.bt');
+formData.set('password', 'guinevere');
+axios.post(
+    'http://localhost:8000/auth/cookie/login',
+    formData,
+    {
+        headers: {
+            'Content-Type': 'multipart/form-data',
+        },
+    },
+)
+.then((response) => console.log(response))
+.catch((error) => console.log(error));
+
+
+
+
+
+

Warning

+

Notice that we don't send it as a JSON payload here but with form data instead. Also, the email is provided by a field named username.

+
+

Response

+

You'll get an empty response. However, the response will come with a Set-Cookie header (that's why we added the -v option in cURL to see them).

+
set-cookie: fastapiusersauth=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiYzYwNjBmMTEtNTM0OS00YTI0LThiNGEtYTJhODc1ZGM1Mzk1IiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTg3ODE4OTQ3fQ.qNA4oPVYhoqrJIk-zvAyEfEVoEnP156G30H_SWEU0sU; HttpOnly; Max-Age=3600; Path=/; Secure
+
+

You can make authenticated requests as the user king.arthur@camelot.bt by setting a Cookie header with this cookie.

+
+

Tip

+

The cookie backend is more suited for browsers, as they handle them automatically. This means that if you make a login request in the browser, it will automatically store the cookie and automatically send it in subsequent requests.

+
+

3. Get my profile

+

Now that we can authenticate, we can get our own profile data. Depending on your authentication backend, the method to authenticate the request will vary. We'll stick with JWT from now on.

+

Request

+
+
+
+
export TOKEN="eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNGZkMzQ3N2ItZWNjZi00ZWUzLThmN2QtNjhhZDcyMjYxNDc2IiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTg3ODE4NDI5fQ.anO3JR8-WYCozZ4_2-PQ2Ov9O38RaLP2RAzQIiZhteM";
+curl \
+-H "Content-Type: application/json" \
+-H "Authorization: Bearer $TOKEN" \
+-X GET \
+http://localhost:8000/users/me
+
+
+
+
const TOKEN = 'eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNGZkMzQ3N2ItZWNjZi00ZWUzLThmN2QtNjhhZDcyMjYxNDc2IiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTg3ODE4NDI5fQ.anO3JR8-WYCozZ4_2-PQ2Ov9O38RaLP2RAzQIiZhteM';
+axios.get(
+    'http://localhost:8000/users/me', {
+    headers: {
+        'Authorization': `Bearer ${TOKEN}`,
+    },
+})
+.then((response) => console.log(response))
+.catch((error) => console.log(error));
+
+
+
+
+

Response

+

You'll get a JSON response looking like this:

+
{
+    "id": "4fd3477b-eccf-4ee3-8f7d-68ad72261476",
+    "email": "king.arthur@camelot.bt",
+    "is_active": true,
+    "is_superuser": false
+}
+
+
+

Tip

+

If you use one of the dependency callable to protect one of your own endpoint, you'll have to authenticate exactly in the same way.

+
+

4. Update my profile

+

We can also update our own profile. For example, we can change our password like this.

+

Request

+
+
+
+
curl \
+-H "Content-Type: application/json" \
+-H "Authorization: Bearer $TOKEN" \
+-X PATCH \
+-d "{\"password\": \"lancelot\"}" \
+http://localhost:8000/users/me
+
+
+
+
axios.patch(
+    'http://localhost:8000/users/me',
+    {
+        password: 'lancelot',
+    },
+    {
+        headers: {
+            'Authorization': `Bearer ${TOKEN}`,
+        },
+    },
+)
+.then((response) => console.log(response))
+.catch((error) => console.log(error));
+
+
+
+
+

Response

+

You'll get a JSON response looking like this:

+
{
+    "id": "4fd3477b-eccf-4ee3-8f7d-68ad72261476",
+    "email": "king.arthur@camelot.bt",
+    "is_active": true,
+    "is_superuser": false
+}
+
+
+

Info

+

Once again, the user cannot set is_active or is_superuser itself. Only a superuser can do it by PATCHing the user.

+
+

5. Become a superuser 🦸🏻‍♂️

+

If you want to manage the users of your application, you'll have to become a superuser.

+

The very first superuser can only be set at database level: open it through a CLI or a GUI, find your user and set the is_superuser column/property to true.

+

5.1. Get the profile of any user

+

Now that you are a superuser, you can leverage the power of superuser routes. You can for example get the profile of any user in the database given its id.

+

Request

+
+
+
+
curl \
+-H "Content-Type: application/json" \
+-H "Authorization: Bearer $TOKEN" \
+-X GET \
+http://localhost:8000/users/4fd3477b-eccf-4ee3-8f7d-68ad72261476
+
+
+
+
axios.get(
+    'http://localhost:8000/users/4fd3477b-eccf-4ee3-8f7d-68ad72261476', {
+    headers: {
+        'Authorization': `Bearer ${TOKEN}`,
+    },
+})
+.then((response) => console.log(response))
+.catch((error) => console.log(error));
+
+
+
+
+

Response

+

You'll get a JSON response looking like this:

+
{
+    "id": "4fd3477b-eccf-4ee3-8f7d-68ad72261476",
+    "email": "king.arthur@camelot.bt",
+    "is_active": true,
+    "is_superuser": false
+}
+
+

5.1. Update any user

+

We can now update the profile of any user. For example, we can promote it as superuser.

+

Request

+
+
+
+
curl \
+-H "Content-Type: application/json" \
+-H "Authorization: Bearer $TOKEN" \
+-X PATCH \
+ -d "{\"is_superuser\": true}" \
+http://localhost:8000/users/4fd3477b-eccf-4ee3-8f7d-68ad72261476
+
+
+
+
axios.patch(
+    'http://localhost:8000/users/4fd3477b-eccf-4ee3-8f7d-68ad72261476',
+    {
+        is_superuser: true,
+    },
+    {
+        headers: {
+            'Authorization': `Bearer ${TOKEN}`,
+        },
+    },
+)
+.then((response) => console.log(response))
+.catch((error) => console.log(error));
+
+
+
+
+

Response

+

You'll get a JSON response looking like this:

+
{
+    "id": "4fd3477b-eccf-4ee3-8f7d-68ad72261476",
+    "email": "king.arthur@camelot.bt",
+    "is_active": true,
+    "is_superuser": true
+}
+
+

5.2. Delete any user

+

Finally, we can delete a user.

+

Request

+
+
+
+
curl \
+-H "Content-Type: application/json" \
+-H "Authorization: Bearer $TOKEN" \
+-X DELETE \
+http://localhost:8000/users/4fd3477b-eccf-4ee3-8f7d-68ad72261476
+
+
+
+
axios.delete(
+    'http://localhost:8000/users/4fd3477b-eccf-4ee3-8f7d-68ad72261476',
+    {
+        headers: {
+            'Authorization': `Bearer ${TOKEN}`,
+        },
+    },
+)
+.then((response) => console.log(response))
+.catch((error) => console.log(error));
+
+
+
+
+

Response

+

You'll get an empty response.

+

6. Logout

+

We can also end the session.

+

Request

+
+
+
+
curl \
+-H "Content-Type: application/json" \
+-H "Cookie: fastapiusersauth=$TOKEN" \
+-X POST \
+http://localhost:8000/auth/cookie/logout
+
+
+
+
axios.post('http://localhost:8000/auth/cookie/logout',
+    null,
+    {
+        headers: {
+            'Cookie': `fastapiusersauth=${TOKEN}`,
+        },
+    }
+)
+.then((response) => console.log(response))
+.catch((error) => console.log(error));
+
+
+
+
+

Response

+

You'll get an empty response.

+

Conclusion

+

That's it! You now have a good overview of how you can manage the users through the API. Be sure to check the Routes page to have all the details about each endpoints.

+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/10.3/usage/routes/index.html b/10.3/usage/routes/index.html new file mode 100644 index 00000000..9c965390 --- /dev/null +++ b/10.3/usage/routes/index.html @@ -0,0 +1,2080 @@ + + + + + + + + + + + + + + + + + + + + + + + + Routes - FastAPI Users + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ + + + + +

Routes

+

You'll find here the routes exposed by FastAPI Users. Note that you can also review them through the interactive API docs.

+

Auth router

+

Each authentication backend you generate a router for will produce the following routes. Take care about the prefix you gave it, especially if you have several backends.

+

POST /login

+

Login a user against the method named name. Check the corresponding authentication method to view the success response.

+
+

Payload (application/x-www-form-urlencoded)

+
username=king.arthur@camelot.bt&password=guinevere
+
+
+
+

422 Validation Error

+
+
+

400 Bad Request

+

Bad credentials or the user is inactive.

+
{
+    "detail": "LOGIN_BAD_CREDENTIALS"
+}
+
+
+
+

400 Bad Request

+

The user is not verified.

+
{
+    "detail": "LOGIN_USER_NOT_VERIFIED"
+}
+
+
+

POST /logout

+

Logout the authenticated user against the method named name. Check the corresponding authentication method to view the success response.

+
+

401 Unauthorized

+

Missing token or inactive user.

+
+
+

200 OK

+

The logout process was successful.

+
+

Register router

+

POST /register

+

Register a new user. Will call the on_after_register handler on successful registration.

+
+

Payload

+
{
+    "email": "king.arthur@camelot.bt",
+    "password": "guinevere"
+}
+
+
+
+

201 Created

+
{
+    "id": "57cbb51a-ab71-4009-8802-3f54b4f2e23",
+    "email": "king.arthur@camelot.bt",
+    "is_active": true,
+    "is_superuser": false
+}
+
+
+
+

422 Validation Error

+
+
+

400 Bad Request

+

A user already exists with this email.

+
{
+    "detail": "REGISTER_USER_ALREADY_EXISTS"
+}
+
+
+
+

400 Bad Request

+

Password validation failed.

+
{
+    "detail": {
+        "code": "REGISTER_INVALID_PASSWORD",
+        "reason": "Password should be at least 3 characters"
+    }
+}
+
+
+

Reset password router

+

POST /forgot-password

+

Request a reset password procedure. Will generate a temporary token and call the on_after_forgot_password handler if the user exists.

+

To prevent malicious users from guessing existing users in your database, the route will always return a 202 Accepted response, even if the user requested does not exist.

+
+

Payload

+
{
+    "email": "king.arthur@camelot.bt"
+}
+
+
+
+

202 Accepted

+
+

POST /reset-password

+

Reset a password. Requires the token generated by the /forgot-password route.

+
+

Payload

+
{
+    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiOTIyMWZmYzktNjQwZi00MzcyLTg2ZDMtY2U2NDJjYmE1NjAzIiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTcxNTA0MTkzfQ.M10bjOe45I5Ncu_uXvOmVV8QxnL-nZfcH96U90JaocI",
+    "password": "merlin"
+}
+
+
+
+

200 OK

+
+
+

422 Validation Error

+
+
+

400 Bad Request

+

Bad or expired token.

+
{
+    "detail": "RESET_PASSWORD_BAD_TOKEN"
+}
+
+
+
+

400 Bad Request

+

Password validation failed.

+
{
+    "detail": {
+        "code": "RESET_PASSWORD_INVALID_PASSWORD",
+        "reason": "Password should be at least 3 characters"
+    }
+}
+
+
+

Verify router

+

POST /request-verify-token

+

Request a user to verify their e-mail. Will generate a temporary token and call the on_after_request_verify handler if the user exists, active and not already verified.

+

To prevent malicious users from guessing existing users in your database, the route will always return a 202 Accepted response, even if the user requested does not exist, not active or already verified.

+
+

Payload

+
{
+    "email": "king.arthur@camelot.bt"
+}
+
+
+
+

202 Accepted

+
+

POST /verify

+

Verify a user. Requires the token generated by the /request-verify-token route. Will call the call the on_after_verify handler on success.

+
+

Payload

+
{
+    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiOTIyMWZmYzktNjQwZi00MzcyLTg2ZDMtY2U2NDJjYmE1NjAzIiwiYXVkIjoiZmFzdGFwaS11c2VyczphdXRoIiwiZXhwIjoxNTcxNTA0MTkzfQ.M10bjOe45I5Ncu_uXvOmVV8QxnL-nZfcH96U90JaocI"
+}
+
+
+
+

200 OK

+
+
+

422 Validation Error

+
+
+

400 Bad Request

+

Bad token, not existing user or not the e-mail currently set for the user.

+
{
+    "detail": "VERIFY_USER_BAD_TOKEN"
+}
+
+
+
+

400 Bad Request

+

The user is already verified.

+
{
+    "detail": "VERIFY_USER_ALREADY_VERIFIED"
+}
+
+
+

OAuth router

+

Each OAuth router you define will expose the two following routes.

+

GET /authorize

+

Return the authorization URL for the OAuth service where you should redirect your user.

+
+

Query parameters

+
    +
  • scopes: Optional list of scopes to ask for. Expected format: scopes=a&scopes=b.
    • +
+
+
+

200 OK

+
{
+    "authorization_url": "https://www.tintagel.bt/oauth/authorize?client_id=CLIENT_ID&scopes=a+b&redirect_uri=https://www.camelot.bt/oauth/callback"
+}
+
+
+

GET /callback

+

Handle the OAuth callback.

+
+

Query parameters

+
    +
  • code: OAuth callback code.
    • +
  • state: State token.
    • +
  • error: OAuth error.
    • +
+
+

Depending on the situation, several things can happen:

+
    +
  • The OAuth account exists in database and is linked to a user:
      +
    • OAuth account is updated in database with fresh access token.
      • +
    • The user is authenticated following the chosen authentication method.
      • +
    +
    • +
  • The OAuth account doesn't exist in database but a user with the same email address exists: +
    • +
  • The OAuth account doesn't exist in database and no user with the email address exists:
      +
    • A new user is created and linked to the OAuth account.
      • +
    • The user is authenticated following the chosen authentication method.
      • +
    +
    • +
+
+

400 Bad Request

+

Invalid token.

+
+
+

400 Bad Request

+

The OAuth provider didn't return an e-mail address. Make sure this provider return e-mail address through their API and you have asked for the required scope.

+
{
+    "detail": "OAUTH_NOT_AVAILABLE_EMAIL"
+}
+
+
+
+

400 Bad Request

+

Another user with the same e-mail address already exists.

+
{
+    "detail": "OAUTH_USER_ALREADY_EXISTS"
+}
+
+
+
+

400 Bad Request

+

User is inactive.

+
{
+    "detail": "LOGIN_BAD_CREDENTIALS"
+}
+
+
+

OAuth association router

+

Each OAuth association router you define will expose the two following routes.

+

GET /authorize

+

Return the authorization URL for the OAuth service where you should redirect your user.

+
+

Query parameters

+
    +
  • scopes: Optional list of scopes to ask for. Expected format: scopes=a&scopes=b.
    • +
+
+
+

401 Unauthorized

+

Missing token or inactive user.

+
+
+

200 OK

+
{
+    "authorization_url": "https://www.tintagel.bt/oauth/authorize?client_id=CLIENT_ID&scopes=a+b&redirect_uri=https://www.camelot.bt/oauth/callback"
+}
+
+
+

GET /callback

+

Handle the OAuth callback and add the OAuth account to the current authenticated active user.

+
+

Query parameters

+
    +
  • code: OAuth callback code.
    • +
  • state: State token.
    • +
  • error: OAuth error.
    • +
+
+
+

401 Unauthorized

+

Missing token or inactive user.

+
+
+

400 Bad Request

+

Invalid token.

+
+
+

400 Bad Request

+

The OAuth provider didn't return an e-mail address. Make sure this provider return e-mail address through their API and you have asked for the required scope.

+
{
+    "detail": "OAUTH_NOT_AVAILABLE_EMAIL"
+}
+
+
+
+

200 OK

+
{
+    "id": "57cbb51a-ab71-4009-8802-3f54b4f2e23",
+    "email": "king.arthur@tintagel.bt",
+    "is_active": true,
+    "is_superuser": false,
+    "oauth_accounts": [
+        {
+            "id": "6c98caf5-9bc5-4c4f-8a45-a0ae0c40cd77",
+            "oauth_name": "TINTAGEL",
+            "access_token": "ACCESS_TOKEN",
+            "expires_at": "1641040620",
+            "account_id": "king_arthur_tintagel",
+            "account_email": "king.arthur@tintagel.bt"
+        }
+    ]
+}
+
+
+

Users router

+

GET /me

+

Return the current authenticated active user.

+
+

200 OK

+
{
+    "id": "57cbb51a-ab71-4009-8802-3f54b4f2e23",
+    "email": "king.arthur@camelot.bt",
+    "is_active": true,
+    "is_superuser": false
+}
+
+
+
+

401 Unauthorized

+

Missing token or inactive user.

+
+

PATCH /me

+

Update the current authenticated active user.

+
+

Payload

+
{
+    "email": "king.arthur@tintagel.bt",
+    "password": "merlin"
+}
+
+
+
+

200 OK

+
{
+    "id": "57cbb51a-ab71-4009-8802-3f54b4f2e23",
+    "email": "king.arthur@tintagel.bt",
+    "is_active": true,
+    "is_superuser": false
+}
+
+
+
+

401 Unauthorized

+

Missing token or inactive user.

+
+
+

400 Bad Request

+

Password validation failed.

+
{
+    "detail": {
+        "code": "UPDATE_USER_INVALID_PASSWORD",
+        "reason": "Password should be at least 3 characters"
+    }
+}
+
+
+
+

400 Bad Request

+

A user with this email already exists. +

{
+    "detail": "UPDATE_USER_EMAIL_ALREADY_EXISTS"
+}
+

+
+
+

422 Validation Error

+
+

GET /{user_id}

+

Return the user with id user_id.

+
+

200 OK

+
{
+    "id": "57cbb51a-ab71-4009-8802-3f54b4f2e23",
+    "email": "king.arthur@camelot.bt",
+    "is_active": true,
+    "is_superuser": false
+}
+
+
+
+

401 Unauthorized

+

Missing token or inactive user.

+
+
+

403 Forbidden

+

Not a superuser.

+
+
+

404 Not found

+

The user does not exist.

+
+

PATCH /{user_id}

+

Update the user with id user_id.

+
+

Payload

+
{
+    "email": "king.arthur@tintagel.bt",
+    "password": "merlin",
+    "is_active": false,
+    "is_superuser": true
+}
+
+
+
+

200 OK

+
{
+    "id": "57cbb51a-ab71-4009-8802-3f54b4f2e23",
+    "email": "king.arthur@camelot.bt",
+    "is_active": false,
+    "is_superuser": true
+}
+
+
+
+

401 Unauthorized

+

Missing token or inactive user.

+
+
+

403 Forbidden

+

Not a superuser.

+
+
+

404 Not found

+

The user does not exist.

+
+
+

400 Bad Request

+

Password validation failed.

+
{
+    "detail": {
+        "code": "UPDATE_USER_INVALID_PASSWORD",
+        "reason": "Password should be at least 3 characters"
+    }
+}
+
+
+
+

400 Bad Request

+

A user with this email already exists. +

{
+    "detail": "UPDATE_USER_EMAIL_ALREADY_EXISTS"
+}
+

+
+

DELETE /{user_id}

+

Delete the user with id user_id.

+
+

204 No content

+
+
+

401 Unauthorized

+

Missing token or inactive user.

+
+
+

403 Forbidden

+

Not a superuser.

+
+
+

404 Not found

+

The user does not exist.

+
+ + + + + + +
+
+ + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/latest/404.html b/latest/404.html index d90cd9f6..14686e13 100644 --- a/latest/404.html +++ b/latest/404.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../10.2/404.html... + Redirecting to ../10.3/404.html... \ No newline at end of file diff --git a/latest/configuration/authentication/backend/index.html b/latest/configuration/authentication/backend/index.html index 47d51d47..58c05676 100644 --- a/latest/configuration/authentication/backend/index.html +++ b/latest/configuration/authentication/backend/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../../10.2/configuration/authentication/backend/... + Redirecting to ../../../../10.3/configuration/authentication/backend/... \ No newline at end of file diff --git a/latest/configuration/authentication/index.html b/latest/configuration/authentication/index.html index f7a62521..c8100adf 100644 --- a/latest/configuration/authentication/index.html +++ b/latest/configuration/authentication/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/configuration/authentication/... + Redirecting to ../../../10.3/configuration/authentication/... \ No newline at end of file diff --git a/latest/configuration/authentication/strategies/database/index.html b/latest/configuration/authentication/strategies/database/index.html index 254314e2..1005bfd6 100644 --- a/latest/configuration/authentication/strategies/database/index.html +++ b/latest/configuration/authentication/strategies/database/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../../../10.2/configuration/authentication/strategies/database/... + Redirecting to ../../../../../10.3/configuration/authentication/strategies/database/... \ No newline at end of file diff --git a/latest/configuration/authentication/strategies/jwt/index.html b/latest/configuration/authentication/strategies/jwt/index.html index 57e3123d..5a86bb1b 100644 --- a/latest/configuration/authentication/strategies/jwt/index.html +++ b/latest/configuration/authentication/strategies/jwt/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../../../10.2/configuration/authentication/strategies/jwt/... + Redirecting to ../../../../../10.3/configuration/authentication/strategies/jwt/... \ No newline at end of file diff --git a/latest/configuration/authentication/strategies/redis/index.html b/latest/configuration/authentication/strategies/redis/index.html index ce6511a8..ea357b39 100644 --- a/latest/configuration/authentication/strategies/redis/index.html +++ b/latest/configuration/authentication/strategies/redis/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../../../10.2/configuration/authentication/strategies/redis/... + Redirecting to ../../../../../10.3/configuration/authentication/strategies/redis/... \ No newline at end of file diff --git a/latest/configuration/authentication/transports/bearer/index.html b/latest/configuration/authentication/transports/bearer/index.html index 35dd4b6d..52f31c89 100644 --- a/latest/configuration/authentication/transports/bearer/index.html +++ b/latest/configuration/authentication/transports/bearer/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../../../10.2/configuration/authentication/transports/bearer/... + Redirecting to ../../../../../10.3/configuration/authentication/transports/bearer/... \ No newline at end of file diff --git a/latest/configuration/authentication/transports/cookie/index.html b/latest/configuration/authentication/transports/cookie/index.html index e401a29e..ff57adbc 100644 --- a/latest/configuration/authentication/transports/cookie/index.html +++ b/latest/configuration/authentication/transports/cookie/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../../../10.2/configuration/authentication/transports/cookie/... + Redirecting to ../../../../../10.3/configuration/authentication/transports/cookie/... \ No newline at end of file diff --git a/latest/configuration/databases/beanie/index.html b/latest/configuration/databases/beanie/index.html index 494516a8..fe4160b0 100644 --- a/latest/configuration/databases/beanie/index.html +++ b/latest/configuration/databases/beanie/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../../10.2/configuration/databases/beanie/... + Redirecting to ../../../../10.3/configuration/databases/beanie/... \ No newline at end of file diff --git a/latest/configuration/databases/sqlalchemy/index.html b/latest/configuration/databases/sqlalchemy/index.html index 41c6c0b3..9af0651c 100644 --- a/latest/configuration/databases/sqlalchemy/index.html +++ b/latest/configuration/databases/sqlalchemy/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../../10.2/configuration/databases/sqlalchemy/... + Redirecting to ../../../../10.3/configuration/databases/sqlalchemy/... \ No newline at end of file diff --git a/latest/configuration/full-example/index.html b/latest/configuration/full-example/index.html index 8765fb8a..c028284b 100644 --- a/latest/configuration/full-example/index.html +++ b/latest/configuration/full-example/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/configuration/full-example/... + Redirecting to ../../../10.3/configuration/full-example/... \ No newline at end of file diff --git a/latest/configuration/oauth/index.html b/latest/configuration/oauth/index.html index c2c59dcd..d9111528 100644 --- a/latest/configuration/oauth/index.html +++ b/latest/configuration/oauth/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/configuration/oauth/... + Redirecting to ../../../10.3/configuration/oauth/... \ No newline at end of file diff --git a/latest/configuration/overview/index.html b/latest/configuration/overview/index.html index 2175dcd1..afb3f85e 100644 --- a/latest/configuration/overview/index.html +++ b/latest/configuration/overview/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/configuration/overview/... + Redirecting to ../../../10.3/configuration/overview/... \ No newline at end of file diff --git a/latest/configuration/password-hash/index.html b/latest/configuration/password-hash/index.html index bad98bf0..b85f2c90 100644 --- a/latest/configuration/password-hash/index.html +++ b/latest/configuration/password-hash/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/configuration/password-hash/... + Redirecting to ../../../10.3/configuration/password-hash/... \ No newline at end of file diff --git a/latest/configuration/routers/auth/index.html b/latest/configuration/routers/auth/index.html index 447e4f8b..182913dd 100644 --- a/latest/configuration/routers/auth/index.html +++ b/latest/configuration/routers/auth/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../../10.2/configuration/routers/auth/... + Redirecting to ../../../../10.3/configuration/routers/auth/... \ No newline at end of file diff --git a/latest/configuration/routers/index.html b/latest/configuration/routers/index.html index 12a109af..00604666 100644 --- a/latest/configuration/routers/index.html +++ b/latest/configuration/routers/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/configuration/routers/... + Redirecting to ../../../10.3/configuration/routers/... \ No newline at end of file diff --git a/latest/configuration/routers/register/index.html b/latest/configuration/routers/register/index.html index c5c84115..eb8d1a57 100644 --- a/latest/configuration/routers/register/index.html +++ b/latest/configuration/routers/register/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../../10.2/configuration/routers/register/... + Redirecting to ../../../../10.3/configuration/routers/register/... \ No newline at end of file diff --git a/latest/configuration/routers/reset/index.html b/latest/configuration/routers/reset/index.html index e3912ad6..62ae38ef 100644 --- a/latest/configuration/routers/reset/index.html +++ b/latest/configuration/routers/reset/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../../10.2/configuration/routers/reset/... + Redirecting to ../../../../10.3/configuration/routers/reset/... \ No newline at end of file diff --git a/latest/configuration/routers/users/index.html b/latest/configuration/routers/users/index.html index 0fcb00c4..e13805b4 100644 --- a/latest/configuration/routers/users/index.html +++ b/latest/configuration/routers/users/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../../10.2/configuration/routers/users/... + Redirecting to ../../../../10.3/configuration/routers/users/... \ No newline at end of file diff --git a/latest/configuration/routers/verify/index.html b/latest/configuration/routers/verify/index.html index 5d8a2651..17edcb42 100644 --- a/latest/configuration/routers/verify/index.html +++ b/latest/configuration/routers/verify/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../../10.2/configuration/routers/verify/... + Redirecting to ../../../../10.3/configuration/routers/verify/... \ No newline at end of file diff --git a/latest/configuration/schemas/index.html b/latest/configuration/schemas/index.html index c76ad676..9b9c1c36 100644 --- a/latest/configuration/schemas/index.html +++ b/latest/configuration/schemas/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/configuration/schemas/... + Redirecting to ../../../10.3/configuration/schemas/... \ No newline at end of file diff --git a/latest/configuration/user-manager/index.html b/latest/configuration/user-manager/index.html index c6e8bc12..5e71937b 100644 --- a/latest/configuration/user-manager/index.html +++ b/latest/configuration/user-manager/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/configuration/user-manager/... + Redirecting to ../../../10.3/configuration/user-manager/... \ No newline at end of file diff --git a/latest/cookbook/create-user-programmatically/index.html b/latest/cookbook/create-user-programmatically/index.html index 44f92175..fe7d7fba 100644 --- a/latest/cookbook/create-user-programmatically/index.html +++ b/latest/cookbook/create-user-programmatically/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/cookbook/create-user-programmatically/... + Redirecting to ../../../10.3/cookbook/create-user-programmatically/... \ No newline at end of file diff --git a/latest/index.html b/latest/index.html index 89b73d85..0ffa5ed9 100644 --- a/latest/index.html +++ b/latest/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../10.2/... + Redirecting to ../10.3/... \ No newline at end of file diff --git a/latest/installation/index.html b/latest/installation/index.html index d8674f9f..6bcf2cbf 100644 --- a/latest/installation/index.html +++ b/latest/installation/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../10.2/installation/... + Redirecting to ../../10.3/installation/... \ No newline at end of file diff --git a/latest/migration/08_to_1x/index.html b/latest/migration/08_to_1x/index.html index f42a1df0..561861e9 100644 --- a/latest/migration/08_to_1x/index.html +++ b/latest/migration/08_to_1x/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/migration/08_to_1x/... + Redirecting to ../../../10.3/migration/08_to_1x/... \ No newline at end of file diff --git a/latest/migration/1x_to_2x/index.html b/latest/migration/1x_to_2x/index.html index c361b8d9..d227191c 100644 --- a/latest/migration/1x_to_2x/index.html +++ b/latest/migration/1x_to_2x/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/migration/1x_to_2x/... + Redirecting to ../../../10.3/migration/1x_to_2x/... \ No newline at end of file diff --git a/latest/migration/2x_to_3x/index.html b/latest/migration/2x_to_3x/index.html index 2ed4ffdd..9db14da9 100644 --- a/latest/migration/2x_to_3x/index.html +++ b/latest/migration/2x_to_3x/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/migration/2x_to_3x/... + Redirecting to ../../../10.3/migration/2x_to_3x/... \ No newline at end of file diff --git a/latest/migration/3x_to_4x/index.html b/latest/migration/3x_to_4x/index.html index a4e71da7..10294750 100644 --- a/latest/migration/3x_to_4x/index.html +++ b/latest/migration/3x_to_4x/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/migration/3x_to_4x/... + Redirecting to ../../../10.3/migration/3x_to_4x/... \ No newline at end of file diff --git a/latest/migration/4x_to_5x/index.html b/latest/migration/4x_to_5x/index.html index 6b523258..bbe0d2e0 100644 --- a/latest/migration/4x_to_5x/index.html +++ b/latest/migration/4x_to_5x/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/migration/4x_to_5x/... + Redirecting to ../../../10.3/migration/4x_to_5x/... \ No newline at end of file diff --git a/latest/migration/6x_to_7x/index.html b/latest/migration/6x_to_7x/index.html index b2aa8da4..a5cec107 100644 --- a/latest/migration/6x_to_7x/index.html +++ b/latest/migration/6x_to_7x/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/migration/6x_to_7x/... + Redirecting to ../../../10.3/migration/6x_to_7x/... \ No newline at end of file diff --git a/latest/migration/7x_to_8x/index.html b/latest/migration/7x_to_8x/index.html index a331f344..b493d7a8 100644 --- a/latest/migration/7x_to_8x/index.html +++ b/latest/migration/7x_to_8x/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/migration/7x_to_8x/... + Redirecting to ../../../10.3/migration/7x_to_8x/... \ No newline at end of file diff --git a/latest/migration/8x_to_9x/index.html b/latest/migration/8x_to_9x/index.html index 4a23ce5d..9be2d522 100644 --- a/latest/migration/8x_to_9x/index.html +++ b/latest/migration/8x_to_9x/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/migration/8x_to_9x/... + Redirecting to ../../../10.3/migration/8x_to_9x/... \ No newline at end of file diff --git a/latest/migration/9x_to_10x/index.html b/latest/migration/9x_to_10x/index.html index 0c0d9eac..a50a3570 100644 --- a/latest/migration/9x_to_10x/index.html +++ b/latest/migration/9x_to_10x/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/migration/9x_to_10x/... + Redirecting to ../../../10.3/migration/9x_to_10x/... \ No newline at end of file diff --git a/latest/usage/current-user/index.html b/latest/usage/current-user/index.html index 7a8516a8..b3eb7614 100644 --- a/latest/usage/current-user/index.html +++ b/latest/usage/current-user/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/usage/current-user/... + Redirecting to ../../../10.3/usage/current-user/... \ No newline at end of file diff --git a/latest/usage/flow/index.html b/latest/usage/flow/index.html index bb7b17a8..6ccf48ce 100644 --- a/latest/usage/flow/index.html +++ b/latest/usage/flow/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/usage/flow/... + Redirecting to ../../../10.3/usage/flow/... \ No newline at end of file diff --git a/latest/usage/routes/index.html b/latest/usage/routes/index.html index 650f054d..321e5b54 100644 --- a/latest/usage/routes/index.html +++ b/latest/usage/routes/index.html @@ -4,13 +4,13 @@ Redirecting - Redirecting to ../../../10.2/usage/routes/... + Redirecting to ../../../10.3/usage/routes/... \ No newline at end of file diff --git a/versions.json b/versions.json index 7992ede0..9e1e6c1c 100644 --- a/versions.json +++ b/versions.json @@ -1 +1 @@ -[{"version": "10.2", "title": "10.2", "aliases": ["latest"]}, {"version": "10.1", "title": "10.1", "aliases": []}, {"version": "10.0", "title": "10.0", "aliases": []}, {"version": "9.3", "title": "9.3", "aliases": []}, {"version": "dev", "title": "dev", "aliases": []}] \ No newline at end of file +[{"version": "10.3", "title": "10.3", "aliases": ["latest"]}, {"version": "10.2", "title": "10.2", "aliases": []}, {"version": "10.1", "title": "10.1", "aliases": []}, {"version": "10.0", "title": "10.0", "aliases": []}, {"version": "9.3", "title": "9.3", "aliases": []}, {"version": "dev", "title": "dev", "aliases": []}] \ No newline at end of file