[{"data":1,"prerenderedAt":405},["ShallowReactive",2],{"navigation":3,"\u002Fdocs\u002Fbancwr\u002Fapproval-before-signing":148,"\u002Fdocs\u002Fbancwr\u002Fapproval-before-signing-surround":402},[4,19,62,93],{"title":5,"path":6,"stem":7,"children":8,"icon":10},"Getting Started","\u002Fdocs\u002Fgetting-started","1.docs\u002F1.getting-started\u002F1.index",[9,11,15],{"title":5,"path":6,"stem":7,"icon":10},"i-lucide-rocket",{"title":12,"path":13,"stem":14},"Installation","\u002Fdocs\u002Fgetting-started\u002Finstallation","1.docs\u002F1.getting-started\u002F2.installation",{"title":16,"path":17,"stem":18},"Using Diogel","\u002Fdocs\u002Fgetting-started\u002Fusage","1.docs\u002F1.getting-started\u002F3.usage",{"title":20,"path":21,"stem":22,"children":23,"icon":61},"Porwr","\u002Fdocs\u002Fporwr","1.docs\u002F2.porwr\u002F01.index",[24,26,29,33,37,41,45,49,53,57],{"title":25,"path":21,"stem":22,"icon":10},"What is Porwr",{"title":12,"path":27,"stem":28},"\u002Fdocs\u002Fporwr\u002Finstallation","1.docs\u002F2.porwr\u002F02.installation",{"title":30,"path":31,"stem":32},"Dashboard","\u002Fdocs\u002Fporwr\u002Fdashboard","1.docs\u002F2.porwr\u002F03.dashboard",{"title":34,"path":35,"stem":36},"Key Management","\u002Fdocs\u002Fporwr\u002Fkeys","1.docs\u002F2.porwr\u002F04.keys",{"title":38,"path":39,"stem":40},"Profile Management","\u002Fdocs\u002Fporwr\u002Fprofile","1.docs\u002F2.porwr\u002F05.profile",{"title":42,"path":43,"stem":44},"Relay Management","\u002Fdocs\u002Fporwr\u002Frelay","1.docs\u002F2.porwr\u002F06.relay",{"title":46,"path":47,"stem":48},"Messaging","\u002Fdocs\u002Fporwr\u002Fmessaging","1.docs\u002F2.porwr\u002F07.messaging",{"title":50,"path":51,"stem":52},"Media Management","\u002Fdocs\u002Fporwr\u002Fmedia","1.docs\u002F2.porwr\u002F08.media",{"title":54,"path":55,"stem":56},"Wallet Management","\u002Fdocs\u002Fporwr\u002Fwallet","1.docs\u002F2.porwr\u002F09.wallet",{"title":58,"path":59,"stem":60},"Extension Settings","\u002Fdocs\u002Fporwr\u002Fsettings","1.docs\u002F2.porwr\u002F10.settings","i-lucide-puzzle",{"title":63,"path":64,"stem":65,"children":66,"icon":92},"Symudol","\u002Fdocs\u002Fsymudol","1.docs\u002F3.symudol\u002F1.index",[67,69,72,76,80,84,88],{"title":68,"path":64,"stem":65,"icon":10},"What is Symudol",{"title":12,"path":70,"stem":71},"\u002Fdocs\u002Fsymudol\u002Finstallation","1.docs\u002F3.symudol\u002F2.installation",{"title":73,"path":74,"stem":75},"Your vault","\u002Fdocs\u002Fsymudol\u002Fvault","1.docs\u002F3.symudol\u002F3.vault",{"title":77,"path":78,"stem":79},"Accounts and profile","\u002Fdocs\u002Fsymudol\u002Faccounts","1.docs\u002F3.symudol\u002F4.accounts",{"title":81,"path":82,"stem":83},"Approving requests","\u002Fdocs\u002Fsymudol\u002Fapproving-requests","1.docs\u002F3.symudol\u002F5.approving-requests",{"title":85,"path":86,"stem":87},"Remote apps (NIP-46)","\u002Fdocs\u002Fsymudol\u002Fremote-apps","1.docs\u002F3.symudol\u002F6.remote-apps",{"title":89,"path":90,"stem":91},"Settings","\u002Fdocs\u002Fsymudol\u002Fsettings","1.docs\u002F3.symudol\u002F7.settings","i-lucide-smartphone",{"title":94,"path":95,"stem":96,"children":97,"icon":147},"Bancwr","\u002Fdocs\u002Fbancwr","1.docs\u002F4.bancwr\u002F01.index",[98,100,103,107,111,115,119,123,127,131,135,139,143],{"title":99,"path":95,"stem":96,"icon":10},"What is Bancwr",{"title":12,"path":101,"stem":102},"\u002Fdocs\u002Fbancwr\u002Finstallation","1.docs\u002F4.bancwr\u002F02.installation",{"title":104,"path":105,"stem":106},"Configuring the URLs","\u002Fdocs\u002Fbancwr\u002Furls","1.docs\u002F4.bancwr\u002F03.urls",{"title":108,"path":109,"stem":110},"First administrator and signing in","\u002Fdocs\u002Fbancwr\u002Ffirst-administrator","1.docs\u002F4.bancwr\u002F04.first-administrator",{"title":112,"path":113,"stem":114},"Protecting the bunker key","\u002Fdocs\u002Fbancwr\u002Fprotecting-the-key","1.docs\u002F4.bancwr\u002F05.protecting-the-key",{"title":116,"path":117,"stem":118},"Team and roles","\u002Fdocs\u002Fbancwr\u002Fteam","1.docs\u002F4.bancwr\u002F06.team",{"title":120,"path":121,"stem":122},"Signing identities","\u002Fdocs\u002Fbancwr\u002Fsigning-identities","1.docs\u002F4.bancwr\u002F07.signing-identities",{"title":124,"path":125,"stem":126},"Connecting apps","\u002Fdocs\u002Fbancwr\u002Fconnecting-apps","1.docs\u002F4.bancwr\u002F08.connecting-apps",{"title":128,"path":129,"stem":130},"Approval before signing","\u002Fdocs\u002Fbancwr\u002Fapproval-before-signing","1.docs\u002F4.bancwr\u002F09.approval-before-signing",{"title":132,"path":133,"stem":134},"Profile, follows and relays","\u002Fdocs\u002Fbancwr\u002Fprofile-follows-relays","1.docs\u002F4.bancwr\u002F10.profile-follows-relays",{"title":136,"path":137,"stem":138},"Health, versions and logs","\u002Fdocs\u002Fbancwr\u002Fhealth-and-logs","1.docs\u002F4.bancwr\u002F11.health-and-logs",{"title":140,"path":141,"stem":142},"Backup and restore","\u002Fdocs\u002Fbancwr\u002Fbackup-and-restore","1.docs\u002F4.bancwr\u002F12.backup-and-restore",{"title":144,"path":145,"stem":146},"Updating","\u002Fdocs\u002Fbancwr\u002Fupdating","1.docs\u002F4.bancwr\u002F13.updating","i-lucide-server",{"id":149,"title":128,"body":150,"description":328,"extension":396,"meta":397,"navigation":398,"path":129,"seo":399,"stem":130,"__hash__":401},"docs\u002F1.docs\u002F4.bancwr\u002F09.approval-before-signing.md",{"type":151,"value":152,"toc":382},"minimark",[153,158,162,170,174,208,211,214,218,227,230,245,248,262,269,272,277,288,292,304,308,311,322,350,354,357,360,364,378],[154,155,157],"h2",{"id":156},"what-approval-does","What approval does",[159,160,161],"p",{},"A brand often wants a person to check what a bot, or a member's app, posts before it goes out. When you issue a connection token, you can mark some of its kinds as needing approval.",[159,163,164,165,169],{},"A request to sign one of those kinds is not signed straight away. It waits under ",[166,167,168],"strong",{},"Approvals"," until an administrator approves or rejects it. Other kinds sign as before, and so do connections made without any kinds needing approval.",[154,171,173],{"id":172},"choosing-which-kinds-are-held","Choosing which kinds are held",[175,176,177,194,201],"ol",{},[178,179,180,181,184,185,188,189,193],"li",{},"Open ",[166,182,183],{},"Connections"," and fill in ",[166,186,187],{},"Issue a connection token",", as ",[190,191,124],"a",{"href":192},"\u002Fdocs\u002Fbancwr\u002Fconnecting-apps#issuing-a-connection-token"," shows.",[178,195,196,197,200],{},"Under ",[166,198,199],{},"Needs approval",", tick the kinds an administrator must approve. You can only choose from the kinds the token may sign.",[178,202,203,204,207],{},"Click ",[166,205,206],{},"Issue token",".",[159,209,210],{},"For example, a token for a social media bot might sign kind 1 (a note) and kind 7 (a reaction), with only kind 1 needing approval.",[159,212,213],{},"Which kinds need approval cannot be changed on an existing connection. To change them, issue a new token.",[154,215,217],{"id":216},"approving-or-rejecting-a-request","Approving or rejecting a request",[159,219,180,220,222,223,226],{},[166,221,168],{}," in the sidebar. The dashboard's ",[166,224,225],{},"Waiting for approval"," count shows how many requests are waiting.",[159,228,229],{},"Each request shows:",[231,232,233,236,239,242],"ul",{},[178,234,235],{},"the note or event exactly as it will be signed,",[178,237,238],{},"the member it is for,",[178,240,241],{},"which app asked, by the name it gave itself,",[178,243,244],{},"when it was asked, and when it times out.",[159,246,247],{},"Then:",[231,249,250,256],{},[178,251,203,252,255],{},[166,253,254],{},"Approve and sign"," to sign it. The bunker sends the signed event to the app, which publishes it.",[178,257,203,258,261],{},[166,259,260],{},"Reject"," to sign nothing. The app is told it was rejected by an administrator.",[159,263,264,265,268],{},"You can add a ",[166,266,267],{},"Note (optional)",", one line of up to 280 characters. It is recorded in the audit log, and on a rejection the app is told it too.",[159,270,271],{},"Either decision is recorded in the audit log, with who decided.",[273,274,276],"h3",{"id":275},"who-decides","Who decides",[231,278,279,282,285],{},[178,280,281],{},"Any administrator can approve or reject, including for their own apps' requests.",[178,283,284],{},"Signers see their own requests waiting, and cannot decide them.",[178,286,287],{},"Viewers do not have this page.",[273,289,291],{"id":290},"what-the-app-sees","What the app sees",[159,293,294,295,299,300,207],{},"While a request waits, the bunker tells the app it needs approval, with a link to the request in the console, at ",[296,297,298],"code",{},"NUXT_SITE_ORIGIN\u002Fapprovals\u002F\u003Cid>",". The app gets the real answer when an administrator decides. See ",[190,301,303],{"href":302},"\u002Fdocs\u002Fbancwr\u002Furls#the-consoles-public-address","The console's public address",[154,305,307],{"id":306},"the-timeout","The timeout",[159,309,310],{},"A request nobody decides times out after 30 minutes, and nothing is signed. The app is told it timed out.",[159,312,313,314,317,318,321],{},"To change the time, set ",[296,315,316],{},"BANCWR_APPROVAL_TIMEOUT_MINUTES"," in ",[296,319,320],{},".env",", from 1 to 1440 minutes, and recreate the bunker:",[323,324,329],"pre",{"className":325,"code":326,"language":327,"meta":328,"style":328},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","podman compose up -d\n","bash","",[296,330,331],{"__ignoreMap":328},[332,333,336,340,344,347],"span",{"class":334,"line":335},"line",1,[332,337,339],{"class":338},"sBMFI","podman",[332,341,343],{"class":342},"sfazB"," compose",[332,345,346],{"class":342}," up",[332,348,349],{"class":342}," -d\n",[273,351,353],{"id":352},"apps-that-give-up-sooner","Apps that give up sooner",[159,355,356],{},"Apps differ in how long they wait. An app that gives up before you decide never receives the signed event, even if you approve it later. The signature is still in the signing log, but the event is not published.",[159,358,359],{},"Approve promptly, or set the app's own timeout longer if it has one.",[154,361,363],{"id":362},"things-to-know","Things to know",[231,365,366,369,372,375],{},[178,367,368],{},"Requests waiting are kept only in the bunker's memory, so their content is never written to disk or into a backup. They are lost when the bunker restarts, and their apps get no answer.",[178,370,371],{},"If the connection ends while a request waits, because it is revoked, its time runs out, or its member is removed or made a viewer, the request is cancelled and nothing is signed.",[178,373,374],{},"Held requests count against the connection's rate limit.",[178,376,377],{},"At most 20 requests can wait for one connection, and 200 for the whole bunker. Past that, the app is refused.",[379,380,381],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":328,"searchDepth":383,"depth":383,"links":384},2,[385,386,387,392,395],{"id":156,"depth":383,"text":157},{"id":172,"depth":383,"text":173},{"id":216,"depth":383,"text":217,"children":388},[389,391],{"id":275,"depth":390,"text":276},3,{"id":290,"depth":390,"text":291},{"id":306,"depth":383,"text":307,"children":393},[394],{"id":352,"depth":390,"text":353},{"id":362,"depth":383,"text":363},"md",{},true,{"description":400,"title":128},"Hold the event kinds you choose for an administrator's approval before Bancwr signs them: choosing the kinds, approving or rejecting each request, and the timeout.","5YdpRRinvLUPtFs2pTBbF8G-VZzDtklrGpkl45DDO2E",[403,404],{"title":124,"path":125,"stem":126,"description":328,"children":-1},{"title":132,"path":133,"stem":134,"description":328,"children":-1},1795083910335]