[{"data":1,"prerenderedAt":309},["ShallowReactive",2],{"\u002Fnext\u002Fdodock\u002Fdeveloppeurs\u002Ffichiers-well-known-application":3,"section:\u002Fnext\u002Fdodock\u002Fdeveloppeurs\u002Ffichiers-well-known-application":308},{"id":4,"title":5,"body":6,"description":292,"extension":293,"meta":294,"navigation":300,"path":304,"seo":305,"stem":306,"__hash__":307},"docs\u002F2.next\u002F3.dodock\u002F10.developpeurs\u002Ffichiers-well-known-application.md","Fichiers \u002F.well-known d'une application",{"type":7,"value":8,"toc":281},"minimark",[9,13,22,27,37,41,68,71,78,87,91,159,163,166,196,199,203,217,241,259,263],[10,11,5],"h1",{"id":12},"fichiers-well-known-dune-application",[14,15,16,17,21],"p",{},"Une application installée peut publier des fichiers statiques sous l'adresse ",[18,19,20],"code",{},"\u002F.well-known\u002F"," du site. C'est utile pour une vérification de domaine : un service externe demande un fichier à une adresse fixe pour s'assurer que vous contrôlez le site.",[23,24,26],"h2",{"id":25},"prérequis","Prérequis",[28,29,30,34],"ul",{},[31,32,33],"li",{},"Une application installée sur le site.",[31,35,36],{},"Un accès au code de l'application.",[23,38,40],{"id":39},"publier-un-fichier","Publier un fichier",[42,43,44,55,58],"ol",{},[31,45,46,47,50,51,54],{},"Dans le dossier du module Python de l'application (celui qui contient ",[18,48,49],{},"hooks.py","), créez le dossier ",[18,52,53],{},"www\u002F.well-known\u002F",".",[31,56,57],{},"Placez-y le fichier. Vous pouvez créer des sous-dossiers.",[31,59,60,61,64,65,54],{},"Mettez à jour le code de l'application sur le serveur, puis demandez l'adresse ",[18,62,63],{},"\u002F.well-known\u002F\u003Cchemin du fichier>"," en ",[18,66,67],{},"GET",[14,69,70],{},"Le fichier est lu sur le disque à chaque requête. Aucun cache ne le conserve. Une mise à jour du code suffit : un redémarrage, une migration ou un vidage du cache ne sont pas nécessaires. De même, un fichier modifié ou supprimé est pris en compte dès la requête suivante.",[14,72,73,74,77],{},"L'application doit être installée sur le site (",[18,75,76],{},"bench --site \u003Csite> install-app \u003Capp>","). Le fichier d'une application présente sur le serveur mais pas installée sur le site n'est pas servi.",[14,79,80,81,83,84,86],{},"Le chemin demandé après ",[18,82,20],{}," est cherché dans le dossier ",[18,85,53],{}," de chaque application installée. Dodock sert le premier fichier trouvé, puis s'arrête. Si deux applications publient le même chemin, seul le fichier de la première application qui le contient est servi.",[23,88,90],{"id":89},"réponse-du-serveur","Réponse du serveur",[92,93,94,107],"table",{},[95,96,97],"thead",{},[98,99,100,104],"tr",{},[101,102,103],"th",{},"Situation",[101,105,106],{},"Réponse",[108,109,110,127,138,146],"tbody",{},[98,111,112,116],{},[113,114,115],"td",{},"Le fichier existe",[113,117,118,119,122,123,126],{},"Son contenu, avec le type de contenu déduit de l'extension (",[18,120,121],{},".json"," donne ",[18,124,125],{},"application\u002Fjson",")",[98,128,129,132],{},[113,130,131],{},"Le fichier n'a pas d'extension reconnue",[113,133,134,135],{},"Son contenu, avec le type ",[18,136,137],{},"text\u002Fplain",[98,139,140,143],{},[113,141,142],{},"Le chemin n'existe dans aucune application, ou désigne un dossier",[113,144,145],{},"Erreur 404",[98,147,148,157],{},[113,149,150,151,153,154,126],{},"Le chemin sort du dossier ",[18,152,53],{}," (par exemple ",[18,155,156],{},"\u002F.well-known\u002F..\u002Fhooks.py",[113,158,145],{},[23,160,162],{"id":161},"adresses-déjà-prises-en-charge-par-dodock","Adresses déjà prises en charge par Dodock",[14,164,165],{},"Ces adresses sont traitées avant la recherche d'un fichier d'application :",[28,167,168,174,186],{},[31,169,170,173],{},[18,171,172],{},"\u002F.well-known\u002Fsecurity.txt"," : contenu du document Paramètres de sécurité, servi uniquement en HTTPS.",[31,175,176,179,180,185],{},[18,177,178],{},"\u002F.well-known\u002Fopenid-configuration"," : configuration OpenID du site (voir ",[181,182,184],"a",{"href":183},"\u002Fnext\u002Fdodock\u002Ffonctionnalites\u002Fintegrations\u002Foauth","OAuth",").",[31,187,188,191,192,195],{},[18,189,190],{},"\u002F.well-known\u002Foauth-authorization-server"," et ",[18,193,194],{},"\u002F.well-known\u002Foauth-protected-resource"," : métadonnées OAuth, tant qu'elles sont activées sur le site.",[14,197,198],{},"Si les métadonnées OAuth ne sont pas activées, un fichier d'application peut occuper ces deux dernières adresses.",[23,200,202],{"id":201},"exemple","Exemple",[14,204,205,209,210,213,214,54],{},[206,207,208],"em",{},"Exemple fictif."," Un service tiers demande un fichier de vérification de domaine nommé ",[18,211,212],{},"openai-apps-challenge",". Votre application s'appelle ",[18,215,216],{},"mon_app",[42,218,219,232,235],{},[31,220,221,222,225,226,228,229,54],{},"Créez le fichier ",[18,223,224],{},"mon_app\u002Fwww\u002F.well-known\u002Fopenai-apps-challenge"," (dans le dossier du module ",[18,227,216],{},") avec pour seul contenu ",[18,230,231],{},"jeton-exemple-123",[31,233,234],{},"Mettez à jour le code de l'application sur le serveur. Aucun redémarrage n'est nécessaire.",[31,236,237,238,54],{},"Ouvrez ",[18,239,240],{},"https:\u002F\u002Fvotre-site.example.com\u002F.well-known\u002Fopenai-apps-challenge",[14,242,243,244,246,247,249,250,253,254,246,257,54],{},"Le navigateur affiche ",[18,245,231],{}," avec le type ",[18,248,137],{},". Un fichier ",[18,251,252],{},"mon_app\u002Fwww\u002F.well-known\u002Fmcp\u002Fserver-card.json"," serait servi à l'adresse ",[18,255,256],{},"\u002F.well-known\u002Fmcp\u002Fserver-card.json",[18,258,125],{},[23,260,262],{"id":261},"limites","Limites",[28,264,265,271,274],{},[31,266,267,268,270],{},"Seules les requêtes ",[18,269,67],{}," sont traitées.",[31,272,273],{},"Les fichiers sont publics : n'y placez aucun secret.",[31,275,276,277,280],{},"Avec la configuration nginx générée par bench, les adresses ",[18,278,279],{},"\u002F.well-known\u002Facme-challenge\u002F"," sont réservées aux certificats Let's Encrypt. Un fichier d'application placé à ce chemin n'est pas servi.",{"title":282,"searchDepth":283,"depth":284,"links":285},"",1,2,[286,287,288,289,290,291],{"id":25,"depth":284,"text":26},{"id":39,"depth":284,"text":40},{"id":89,"depth":284,"text":90},{"id":161,"depth":284,"text":162},{"id":201,"depth":284,"text":202},{"id":261,"depth":284,"text":262},"Publier un fichier statique sous \u002F.well-known\u002F depuis le dossier www\u002F.well-known d'une application, par exemple un jeton de vérification de domaine.","md",{"icon":295,"sources":296,"generated":300,"generated_at":301,"source_mrs":302,"reviewed":300},"i-mdi-file-key-outline",[297,298,299],"dodock@develop:frappe\u002Fintegrations\u002Foauth2.py","dodock@develop:frappe\u002Fapp.py","dodock@develop:frappe\u002Ftests\u002Ftest_oauth20.py",true,"2026-11-16",[303],"https:\u002F\u002Fgitlab.com\u002Fdokos\u002Fdodock\u002F-\u002Fmerge_requests\u002F13137","\u002Fnext\u002Fdodock\u002Fdeveloppeurs\u002Ffichiers-well-known-application",{"title":5,"description":292},"2.next\u002F3.dodock\u002F10.developpeurs\u002Ffichiers-well-known-application","dikVvjkZO2D8h-Jhz1wP29GaPxiEpRjtZBHmESkou1M",{},1795274548794]