[{"data":1,"prerenderedAt":504},["ShallowReactive",2],{"navigation_docs":3,"-docs-api-error-codes":86,"-docs-api-error-codes-surround":499},[4,22,31,48,65],{"title":5,"path":6,"stem":7,"children":8,"page":21},"Api","\u002Fdocs\u002Fapi","docs\u002Fapi",[9,13,17],{"title":10,"path":11,"stem":12},"CLI Reference","\u002Fdocs\u002Fapi\u002Fcli-reference","docs\u002Fapi\u002F1.cli-reference",{"title":14,"path":15,"stem":16},"ZMQ Protocol Reference","\u002Fdocs\u002Fapi\u002Fzmq-protocol","docs\u002Fapi\u002F2.zmq-protocol",{"title":18,"path":19,"stem":20},"Error Codes","\u002Fdocs\u002Fapi\u002Ferror-codes","docs\u002Fapi\u002F3.error-codes",false,{"title":23,"path":24,"stem":25,"children":26,"page":21},"Community","\u002Fdocs\u002Fcommunity","docs\u002Fcommunity",[27],{"title":28,"path":29,"stem":30},"Contributing","\u002Fdocs\u002Fcommunity\u002Fcontributing","docs\u002Fcommunity\u002F1.contributing",{"title":32,"path":33,"stem":34,"children":35,"page":21},"Concepts","\u002Fdocs\u002Fconcepts","docs\u002Fconcepts",[36,40,44],{"title":37,"path":38,"stem":39},"Architecture","\u002Fdocs\u002Fconcepts\u002Farchitecture","docs\u002Fconcepts\u002F1.architecture",{"title":41,"path":42,"stem":43},"Certificate Lifecycle","\u002Fdocs\u002Fconcepts\u002Fcertificate-lifecycle","docs\u002Fconcepts\u002F2.certificate-lifecycle",{"title":45,"path":46,"stem":47},"Security Model","\u002Fdocs\u002Fconcepts\u002Fsecurity-model","docs\u002Fconcepts\u002F3.security-model",{"title":49,"path":50,"stem":51,"children":52,"page":21},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002Fgetting-started",[53,57,61],{"title":54,"path":55,"stem":56},"Introduction","\u002Fdocs\u002Fgetting-started\u002Fintroduction","docs\u002Fgetting-started\u002F1.introduction",{"title":58,"path":59,"stem":60},"Installation","\u002Fdocs\u002Fgetting-started\u002Finstallation","docs\u002Fgetting-started\u002F2.installation",{"title":62,"path":63,"stem":64},"Quick Start","\u002Fdocs\u002Fgetting-started\u002Fquick-start","docs\u002Fgetting-started\u002F3.quick-start",{"title":66,"path":67,"stem":68,"children":69,"page":21},"Guides","\u002Fdocs\u002Fguides","docs\u002Fguides",[70,74,78,82],{"title":71,"path":72,"stem":73},"Configuration","\u002Fdocs\u002Fguides\u002Fconfiguration","docs\u002Fguides\u002F1.configuration",{"title":75,"path":76,"stem":77},"Certificate Profiles","\u002Fdocs\u002Fguides\u002Fcertificate-profiles","docs\u002Fguides\u002F2.certificate-profiles",{"title":79,"path":80,"stem":81},"Docker Deployment","\u002Fdocs\u002Fguides\u002Fdocker-deployment","docs\u002Fguides\u002F3.docker-deployment",{"title":83,"path":84,"stem":85},"Importing an Existing CA","\u002Fdocs\u002Fguides\u002Fimporting-existing-ca","docs\u002Fguides\u002F4.importing-existing-ca",{"id":87,"title":18,"body":88,"description":492,"extension":493,"links":494,"meta":495,"navigation":496,"path":19,"seo":497,"stem":20,"__hash__":498},"docs\u002Fdocs\u002Fapi\u002F3.error-codes.md",{"type":89,"value":90,"toc":486},"minimark",[91,95,100,104,177,181,352,356,359,431,435,438,460,463,482],[92,93,18],"h1",{"id":94},"error-codes",[96,97,99],"h2",{"id":98},"zmq-error-format","ZMQ error format",[101,102,103],"p",{},"All errors are returned as:",[105,106,111],"pre",{"className":107,"code":108,"language":109,"meta":110,"style":110},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"EVENT\": \"UPKI ERROR\",\n  \"MSG\": \"\u003Chuman-readable error message>\"\n}\n","json","",[112,113,114,123,151,171],"code",{"__ignoreMap":110},[115,116,119],"span",{"class":117,"line":118},"line",1,[115,120,122],{"class":121},"sMK4o","{\n",[115,124,126,129,133,136,139,142,146,148],{"class":117,"line":125},2,[115,127,128],{"class":121},"  \"",[115,130,132],{"class":131},"spNyl","EVENT",[115,134,135],{"class":121},"\"",[115,137,138],{"class":121},":",[115,140,141],{"class":121}," \"",[115,143,145],{"class":144},"sfazB","UPKI ERROR",[115,147,135],{"class":121},[115,149,150],{"class":121},",\n",[115,152,154,156,159,161,163,165,168],{"class":117,"line":153},3,[115,155,128],{"class":121},[115,157,158],{"class":131},"MSG",[115,160,135],{"class":121},[115,162,138],{"class":121},[115,164,141],{"class":121},[115,166,167],{"class":144},"\u003Chuman-readable error message>",[115,169,170],{"class":121},"\"\n",[115,172,174],{"class":117,"line":173},4,[115,175,176],{"class":121},"}\n",[96,178,180],{"id":179},"common-errors","Common errors",[182,183,184,200],"table",{},[185,186,187],"thead",{},[188,189,190,194,197],"tr",{},[191,192,193],"th",{},"Message pattern",[191,195,196],{},"Cause",[191,198,199],{},"Resolution",[201,202,203,221,238,254,274,290,307,323,339],"tbody",{},[188,204,205,211,218],{},[206,207,208],"td",{},[112,209,210],{},"Unknown task: \u003Ctask>",[206,212,213,214,217],{},"The ",[112,215,216],{},"TASK"," field contains an unrecognised value",[206,219,220],{},"Check the task name against the ZMQ protocol reference",[188,222,223,228,231],{},[206,224,225],{},[112,226,227],{},"Profile \u003Cname> not found",[206,229,230],{},"The requested certificate profile does not exist",[206,232,233,234,237],{},"Run ",[112,235,236],{},"list_profiles"," to see available profiles",[188,239,240,245,248],{},[206,241,242],{},[112,243,244],{},"Certificate not found: \u003Cdn>",[206,246,247],{},"No certificate exists with the given DN",[206,249,250,251],{},"Verify the DN with ",[112,252,253],{},"list_nodes",[188,255,256,261,264],{},[206,257,258],{},[112,259,260],{},"Invalid seed",[206,262,263],{},"The registration seed does not match",[206,265,266,267,270,271],{},"Check ",[112,268,269],{},"UPKI_CA_SEED"," matches the seed printed at ",[112,272,273],{},"init",[188,275,276,281,284],{},[206,277,278],{},[112,279,280],{},"Certificate already exists: \u003Cdn>",[206,282,283],{},"A certificate for this CN is already active",[206,285,286,287],{},"Renew the existing certificate with ",[112,288,289],{},"renew",[188,291,292,297,300],{},[206,293,294],{},[112,295,296],{},"Node is revoked: \u003Cdn>",[206,298,299],{},"The target certificate has been revoked",[206,301,302,303,306],{},"Unrevoke with ",[112,304,305],{},"unrevoke"," or delete and reissue",[188,308,309,314,317],{},[206,310,311],{},[112,312,313],{},"Storage error: \u003Cdetail>",[206,315,316],{},"Filesystem or TinyDB error",[206,318,319,320],{},"Check disk space and permissions on ",[112,321,322],{},"UPKI_DATA_DIR",[188,324,325,330,333],{},[206,326,327],{},[112,328,329],{},"Key generation failed",[206,331,332],{},"Cryptographic error during key creation",[206,334,335,336],{},"Check key type and length in ",[112,337,338],{},"ca.config.yml",[188,340,341,346,349],{},[206,342,343],{},[112,344,345],{},"CSR parse error",[206,347,348],{},"The provided CSR is malformed",[206,350,351],{},"Ensure the CSR is in valid PEM format",[96,353,355],{"id":354},"http-level-errors-from-ra-proxying-to-ca","HTTP-level errors (from RA proxying to CA)",[101,357,358],{},"When the RA forwards a request to the CA and the CA returns an error, the RA translates it:",[182,360,361,374],{},[185,362,363],{},[188,364,365,368,371],{},[191,366,367],{},"ZMQ error",[191,369,370],{},"ACME error type",[191,372,373],{},"HTTP status",[201,375,376,390,405,418],{},[188,377,378,382,387],{},[206,379,380],{},[112,381,260],{},[206,383,384],{},[112,385,386],{},"urn:ietf:params:acme:error:unauthorized",[206,388,389],{},"403",[188,391,392,397,402],{},[206,393,394],{},[112,395,396],{},"Certificate not found",[206,398,399],{},[112,400,401],{},"urn:ietf:params:acme:error:malformed",[206,403,404],{},"400",[188,406,407,412,416],{},[206,408,409],{},[112,410,411],{},"Profile not found",[206,413,414],{},[112,415,401],{},[206,417,404],{},[188,419,420,423,428],{},[206,421,422],{},"Generic CA error",[206,424,425],{},[112,426,427],{},"urn:ietf:params:acme:error:serverInternal",[206,429,430],{},"500",[96,432,434],{"id":433},"debugging-tips","Debugging tips",[101,436,437],{},"Enable debug output on the CA:",[105,439,443],{"className":440,"code":441,"language":442,"meta":110,"style":110},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","python ca_server.py start --debug\n","bash",[112,444,445],{"__ignoreMap":110},[115,446,447,451,454,457],{"class":117,"line":118},[115,448,450],{"class":449},"sBMFI","python",[115,452,453],{"class":144}," ca_server.py",[115,455,456],{"class":144}," start",[115,458,459],{"class":144}," --debug\n",[101,461,462],{},"Or check the RA logs — the RA logs every ZMQ request and response it sends to the CA:",[105,464,466],{"className":440,"code":465,"language":442,"meta":110,"style":110},"docker logs upki-ra --follow\n",[112,467,468],{"__ignoreMap":110},[115,469,470,473,476,479],{"class":117,"line":118},[115,471,472],{"class":449},"docker",[115,474,475],{"class":144}," logs",[115,477,478],{"class":144}," upki-ra",[115,480,481],{"class":144}," --follow\n",[483,484,485],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}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);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":110,"searchDepth":125,"depth":125,"links":487},[488,489,490,491],{"id":98,"depth":125,"text":99},{"id":179,"depth":125,"text":180},{"id":354,"depth":125,"text":355},{"id":433,"depth":125,"text":434},"ZMQ error responses from uPKI CA.","md",null,{},true,{"title":18,"description":492},"zHCs6B5uSpdiuofBp_lmOfm-dPinGFgoqquIxy0SwvI",[500,502],{"title":14,"path":15,"stem":16,"description":501,"children":-1},"Complete reference for the ZMQ REQ\u002FREP protocol between uPKI CA and RA\u002FCLI.",{"title":28,"path":29,"stem":30,"description":503,"children":-1},"How to contribute to uPKI CA.",1775569478524]