[{"data":1,"prerenderedAt":407},["ShallowReactive",2],{"navigation":3,"\u002Fusing-cirrus-reader-studio\u002Fintegrations":105,"\u002Fusing-cirrus-reader-studio\u002Fintegrations-surround":404},[4,8,26,39,84],{"title":5,"path":6,"stem":7},"About this manual","\u002Fabout-this-manual","01.about-this-manual",{"title":9,"icon":10,"path":11,"stem":12,"children":13,"page":10},"Part 1: Understanding Cirrus Reader Studio",false,"\u002Funderstanding-cirrus-reader-studio","02.understanding-cirrus-reader-studio",[14,18,22],{"title":15,"path":16,"stem":17},"1. What Cirrus Reader Studio does","\u002Funderstanding-cirrus-reader-studio\u002Fwhat-cirrus-reader-studio-does","02.understanding-cirrus-reader-studio\u002F01.what-cirrus-reader-studio-does",{"title":19,"path":20,"stem":21},"2. Key concepts","\u002Funderstanding-cirrus-reader-studio\u002Fkey-concepts","02.understanding-cirrus-reader-studio\u002F02.key-concepts",{"title":23,"path":24,"stem":25},"3. Finding your way around","\u002Funderstanding-cirrus-reader-studio\u002Ffinding-your-way-around","02.understanding-cirrus-reader-studio\u002F03.finding-your-way-around",{"title":27,"icon":10,"path":28,"stem":29,"children":30,"page":10},"Part 2: Getting started","\u002Fgetting-started","03.getting-started",[31,35],{"title":32,"path":33,"stem":34},"4. Signing in and setting up","\u002Fgetting-started\u002Fsigning-in-and-setting-up","03.getting-started\u002F01.signing-in-and-setting-up",{"title":36,"path":37,"stem":38},"5. Quick start: your first publication on your website","\u002Fgetting-started\u002Fquick-start-your-first-publication-on-your-website","03.getting-started\u002F02.quick-start-your-first-publication-on-your-website",{"title":40,"icon":10,"path":41,"stem":42,"children":43,"page":10},"Part 3: Using Cirrus Reader Studio","\u002Fusing-cirrus-reader-studio","04.using-cirrus-reader-studio",[44,48,52,56,60,64,68,72,76,80],{"title":45,"path":46,"stem":47},"6. Dashboard","\u002Fusing-cirrus-reader-studio\u002Fdashboard","04.using-cirrus-reader-studio\u002F01.dashboard",{"title":49,"path":50,"stem":51},"7. Catalogue: publications","\u002Fusing-cirrus-reader-studio\u002Fcatalogue-publications","04.using-cirrus-reader-studio\u002F02.catalogue-publications",{"title":53,"path":54,"stem":55},"8. Catalogue: collections","\u002Fusing-cirrus-reader-studio\u002Fcatalogue-collections","04.using-cirrus-reader-studio\u002F03.catalogue-collections",{"title":57,"path":58,"stem":59},"9. Reader Instances","\u002Fusing-cirrus-reader-studio\u002Freader-instances","04.using-cirrus-reader-studio\u002F04.reader-instances",{"title":61,"path":62,"stem":63},"10. Putting a Reader Instance on your website","\u002Fusing-cirrus-reader-studio\u002Fputting-a-reader-instance-on-your-website","04.using-cirrus-reader-studio\u002F05.putting-a-reader-instance-on-your-website",{"title":65,"path":66,"stem":67},"11. Domains","\u002Fusing-cirrus-reader-studio\u002Fdomains","04.using-cirrus-reader-studio\u002F06.domains",{"title":69,"path":70,"stem":71},"12. Resource Manager","\u002Fusing-cirrus-reader-studio\u002Fresource-manager","04.using-cirrus-reader-studio\u002F07.resource-manager",{"title":73,"path":74,"stem":75},"13. Reader Users","\u002Fusing-cirrus-reader-studio\u002Freader-users","04.using-cirrus-reader-studio\u002F08.reader-users",{"title":77,"path":78,"stem":79},"14. Integrations","\u002Fusing-cirrus-reader-studio\u002Fintegrations","04.using-cirrus-reader-studio\u002F09.integrations",{"title":81,"path":82,"stem":83},"15. Settings","\u002Fusing-cirrus-reader-studio\u002Fsettings","04.using-cirrus-reader-studio\u002F10.settings",{"title":85,"icon":10,"path":86,"stem":87,"children":88,"page":10},"Part 4: Reference","\u002Freference","05.reference",[89,93,97,101],{"title":90,"path":91,"stem":92},"16. Troubleshooting and common questions","\u002Freference\u002Ftroubleshooting-and-common-questions","05.reference\u002F01.troubleshooting-and-common-questions",{"title":94,"path":95,"stem":96},"17. Limits and file types at a glance","\u002Freference\u002Flimits-and-file-types-at-a-glance","05.reference\u002F02.limits-and-file-types-at-a-glance",{"title":98,"path":99,"stem":100},"18. Glossary","\u002Freference\u002Fglossary","05.reference\u002F03.glossary",{"title":102,"path":103,"stem":104},"19. Getting help","\u002Freference\u002Fgetting-help","05.reference\u002F04.getting-help",{"id":106,"title":77,"body":107,"description":387,"extension":398,"meta":399,"navigation":400,"path":78,"seo":401,"stem":79,"__hash__":403},"docs\u002F04.using-cirrus-reader-studio\u002F09.integrations.md",{"type":108,"value":109,"toc":386},"minimark",[110,130,135,148,155,185,190,244,257,267,270,273,277,284,353,357,371,375,380],[111,112,113,114,118,119,121,122,125,126,129],"p",{},"The ",[115,116,117],"strong",{},"Integrations"," page is where you create API keys and connect Cirrus to other services. Click ",[115,120,117],{}," in the menu. It has two tabs: ",[115,123,124],{},"API Keys"," and ",[115,127,128],{},"Third-Party Apps",".",[131,132,134],"h2",{"id":133},"_141-api-keys","14.1 API keys",[111,136,137,138,143,144,147],{},"An ",[139,140,142],"a",{"href":141},"\u002Funderstanding-cirrus-reader-studio\u002Fkey-concepts#api-key","API key"," lets another system, such as your website's server or an online shop, talk to Cirrus automatically. You need one if a Reader Instance uses ",[115,145,146],{},"Pre Authentication",", or if your web team builds something with the Cirrus API.",[111,149,150],{},[151,152],"img",{"alt":153,"src":154},"The API Keys tab","\u002Fimages\u002F28-api-keys.png",[111,156,157,158,161,162,165,166,125,169,172,173,176,177,180,181,184],{},"The list shows each key's ",[115,159,160],{},"Name",", a shortened version of the ",[115,163,164],{},"API Key",", when it was ",[115,167,168],{},"Created",[115,170,171],{},"Last Used",", and its ",[115,174,175],{},"Status"," (",[115,178,179],{},"Active"," or ",[115,182,183],{},"Inactive",").",[186,187,189],"h3",{"id":188},"create-an-api-key","Create an API key",[191,192,193,207,213],"ol",{},[194,195,196,197,129,200,203],"li",{},"Click ",[115,198,199],{},"Create API Key",[201,202],"br",{},[151,204],{"alt":205,"src":206},"The Create New API Key dialog","\u002Fimages\u002F29-create-api-key.png",[194,208,209,210,212],{},"Give the key a ",[115,211,160],{}," that indicates  what it is for, such as \"Website server\" or \"Shop integration\".",[194,214,215,216,219,220,241,243],{},"Under ",[115,217,218],{},"Permissions",", tick only what the key needs:",[221,222,223,229,235],"ul",{},[194,224,225,228],{},[115,226,227],{},"Read access",": look up information.",[194,230,231,234],{},[115,232,233],{},"Write access",": add or change information.",[194,236,237,240],{},[115,238,239],{},"Delete access",": delete information.",[201,242],{},"If you are not sure, ask your web team.",[245,246,247],"warning",{},[111,248,249,252,253,256],{},[115,250,251],{},"Important:"," The full key is shown ",[115,254,255],{},"only once",", straight after you create it. As soon as you leave or reload the page, or edit or revoke the key, only the shortened version is shown and the full key cannot be seen again. Be ready to copy it.",[191,258,260,264],{"start":259},4,[194,261,196,262,129],{},[115,263,199],{},[194,265,266],{},"Click the copy button next to the new key and store it somewhere safe, such as a password manager.",[111,268,269],{},"If you lose a key, create a new one and delete the old one.",[111,271,272],{},"Treat API keys like passwords: send them securely and never put them on a public web page.",[186,274,276],{"id":275},"turn-a-key-off-change-it-or-delete-it","Turn a key off, change it or delete it",[111,278,279,280,283],{},"Open the key's ",[115,281,282],{},"⋮"," menu:",[285,286,287,300],"table",{},[288,289,290],"thead",{},[291,292,293,297],"tr",{},[294,295,296],"th",{},"Action",[294,298,299],{},"What it does",[301,302,303,320,329,343],"tbody",{},[291,304,305,311],{},[306,307,308],"td",{},[115,309,310],{},"Revoke API Key",[306,312,313,314,316,317,129],{},"Turns the key off (its status becomes ",[115,315,183],{},"). Anything using it stops working. This can be undone: the menu item changes to ",[115,318,319],{},"Enable API Key",[291,321,322,326],{},[306,323,324],{},[115,325,319],{},[306,327,328],{},"Turns an inactive key back on.",[291,330,331,336],{},[306,332,333],{},[115,334,335],{},"Edit API Key",[306,337,338,339,342],{},"Changes the key's name or permissions. Click ",[115,340,341],{},"Save API Key"," to save.",[291,344,345,350],{},[306,346,347],{},[115,348,349],{},"Delete API Key",[306,351,352],{},"Deletes the key permanently, after you confirm. This cannot be undone.",[186,354,356],{"id":355},"api-documentation","API documentation",[111,358,113,359,362,363,366,367,370],{},[115,360,361],{},"API Documentation"," box on this tab has a ",[115,364,365],{},"View API Documentation"," button. It opens ",[115,368,369],{},"docs.cirrusreader.com",", the technical guide for developers. Share this link with your web team.",[131,372,374],{"id":373},"_142-third-party-apps","14.2 Third-party apps",[111,376,113,377,379],{},[115,378,128],{}," tab shows services that can be connected to Cirrus.",[111,381,382],{},[151,383],{"alt":384,"src":385},"The Third-Party Apps tab","\u002Fimages\u002F30-third-party-apps.png",{"title":387,"searchDepth":388,"depth":389,"links":390},"",1,2,[391,397],{"id":133,"depth":389,"text":134,"children":392},[393,395,396],{"id":188,"depth":394,"text":189},3,{"id":275,"depth":394,"text":276},{"id":355,"depth":394,"text":356},{"id":373,"depth":389,"text":374},"md",{},true,{"description":402,"title":77},"The Integrations page is where you create API keys and connect Cirrus to other services. Click Integrations in the menu. It has two tabs: API Keys and…","ZwVAwiWKXbgF-bfMZURX0AagtwajlR8RYiEGHHtmKbU",[405,406],{"title":73,"path":74,"stem":75,"description":387,"children":-1},{"title":81,"path":82,"stem":83,"description":387,"children":-1},1792515139026]