[{"data":1,"prerenderedAt":748},["ShallowReactive",2],{"navigation_docs_de":3,"-de-integration-api-authentication":427,"-de-integration-api-authentication-surround":743},[4,31,117,188,238,271,310,369,378],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":30},"Erste Schritte","i-hugeicons-rocket-01","\u002Fde\u002Fgetting-started","de\u002F01.getting-started",[10,15,20,25],{"title":11,"path":12,"stem":13,"icon":14},"Was ist DDM?","\u002Fde\u002Fgetting-started\u002Fwhat-is-ddm","de\u002F01.getting-started\u002F01.what-is-ddm","i-hugeicons-information-circle",{"title":16,"path":17,"stem":18,"icon":19},"Konto und Anmeldung","\u002Fde\u002Fgetting-started\u002Fsign-in","de\u002F01.getting-started\u002F02.sign-in","i-hugeicons-key-01",{"title":21,"path":22,"stem":23,"icon":24},"KI in DDM","\u002Fde\u002Fgetting-started\u002Fai-in-ddm","de\u002F01.getting-started\u002F03.ai-in-ddm","i-hugeicons-ai-magic",{"title":26,"path":27,"stem":28,"icon":29},"Systemstatus","\u002Fde\u002Fgetting-started\u002Fsystem-status","de\u002F01.getting-started\u002F04.system-status","i-hugeicons-activity-03",false,{"title":32,"icon":33,"path":34,"stem":35,"children":36,"page":30},"CMS","i-hugeicons-dashboard-square-01","\u002Fde\u002Fcms","de\u002F02.cms",[37,42,47,52,57,62,67,72,77,82,87,92,97,102,107,112],{"title":38,"path":39,"stem":40,"icon":41},"Das CMS im Überblick","\u002Fde\u002Fcms\u002Foverview","de\u002F02.cms\u002F01.overview","i-hugeicons-compass-01",{"title":43,"path":44,"stem":45,"icon":46},"Dokumente hochladen","\u002Fde\u002Fcms\u002Fupload","de\u002F02.cms\u002F02.upload","i-hugeicons-upload-01",{"title":48,"path":49,"stem":50,"icon":51},"Kategorien","\u002Fde\u002Fcms\u002Fcategories","de\u002F02.cms\u002F03.categories","i-hugeicons-folder-tree",{"title":53,"path":54,"stem":55,"icon":56},"Dokumente bearbeiten","\u002Fde\u002Fcms\u002Fdocuments","de\u002F02.cms\u002F04.documents","i-hugeicons-file-edit",{"title":58,"path":59,"stem":60,"icon":61},"Suchen und filtern","\u002Fde\u002Fcms\u002Fsearch-and-filters","de\u002F02.cms\u002F05.search-and-filters","i-hugeicons-search-01",{"title":63,"path":64,"stem":65,"icon":66},"Gruppen und Rechte","\u002Fde\u002Fcms\u002Fgroups-and-permissions","de\u002F02.cms\u002F06.groups-and-permissions","i-hugeicons-user-multiple",{"title":68,"path":69,"stem":70,"icon":71},"Benutzer","\u002Fde\u002Fcms\u002Fusers","de\u002F02.cms\u002F07.users","i-hugeicons-user-add-01",{"title":73,"path":74,"stem":75,"icon":76},"Freigaben","\u002Fde\u002Fcms\u002Fapprovals","de\u002F02.cms\u002F08.approvals","i-hugeicons-checkmark-badge-01",{"title":78,"path":79,"stem":80,"icon":81},"Märkte und Übersetzungen","\u002Fde\u002Fcms\u002Fmarkets-and-translations","de\u002F02.cms\u002F09.markets-and-translations","i-hugeicons-globe-02",{"title":83,"path":84,"stem":85,"icon":86},"Notizvorlagen","\u002Fde\u002Fcms\u002Fnote-templates","de\u002F02.cms\u002F10.note-templates","i-hugeicons-layout-01",{"title":88,"path":89,"stem":90,"icon":91},"Nutzung und Audit-Log","\u002Fde\u002Fcms\u002Fusage-and-audit","de\u002F02.cms\u002F11.usage-and-audit","i-hugeicons-chart-column",{"title":93,"path":94,"stem":95,"icon":96},"KI-Assistent","\u002Fde\u002Fcms\u002Fassistant","de\u002F02.cms\u002F12.assistant","i-hugeicons-sparkles",{"title":98,"path":99,"stem":100,"icon":101},"Einstellungen","\u002Fde\u002Fcms\u002Fsettings","de\u002F02.cms\u002F13.settings","i-hugeicons-settings-02",{"title":103,"path":104,"stem":105,"icon":106},"Tarife","\u002Fde\u002Fcms\u002Fplans","de\u002F02.cms\u002F14.plans","i-hugeicons-package",{"title":108,"path":109,"stem":110,"icon":111},"Feature-Wünsche","\u002Fde\u002Fcms\u002Ffeature-requests","de\u002F02.cms\u002F15.feature-requests","i-hugeicons-idea-01",{"title":113,"path":114,"stem":115,"icon":116},"Fehler melden","\u002Fde\u002Fcms\u002Fbug-reports","de\u002F02.cms\u002F16.bug-reports","i-hugeicons-bug-01",{"title":118,"icon":119,"path":120,"stem":121,"children":122,"page":30},"App","i-hugeicons-smart-phone-01","\u002Fde\u002Fapp","de\u002F03.app",[123,128,133,138,143,147,152,157,162,167,170,173,176,179,184],{"title":124,"path":125,"stem":126,"icon":127},"Anmelden und zurechtfinden","\u002Fde\u002Fapp\u002Foverview","de\u002F03.app\u002F01.overview","i-hugeicons-login-03",{"title":129,"path":130,"stem":131,"icon":132},"Tabs und geteilte Ansicht","\u002Fde\u002Fapp\u002Ftabs","de\u002F03.app\u002F02.tabs","i-hugeicons-layout-2-column",{"title":134,"path":135,"stem":136,"icon":137},"Dokumente finden und lesen","\u002Fde\u002Fapp\u002Fdocuments","de\u002F03.app\u002F03.documents","i-hugeicons-file-01",{"title":139,"path":140,"stem":141,"icon":142},"Favoriten","\u002Fde\u002Fapp\u002Ffavorites","de\u002F03.app\u002F04.favorites","i-hugeicons-favourite",{"title":144,"path":145,"stem":146,"icon":61},"Suchen","\u002Fde\u002Fapp\u002Fsearch","de\u002F03.app\u002F05.search",{"title":148,"path":149,"stem":150,"icon":151},"Notizen","\u002Fde\u002Fapp\u002Fnotes","de\u002F03.app\u002F06.notes","i-hugeicons-note-edit",{"title":153,"path":154,"stem":155,"icon":156},"Kalender und Termine","\u002Fde\u002Fapp\u002Fcalendar","de\u002F03.app\u002F07.calendar","i-hugeicons-calendar-03",{"title":158,"path":159,"stem":160,"icon":161},"An Kunden senden","\u002Fde\u002Fapp\u002Foutbox","de\u002F03.app\u002F08.outbox","i-hugeicons-sent",{"title":163,"path":164,"stem":165,"icon":166},"Offline arbeiten","\u002Fde\u002Fapp\u002Foffline","de\u002F03.app\u002F09.offline","i-hugeicons-wifi-off-01",{"title":93,"path":168,"stem":169,"icon":96},"\u002Fde\u002Fapp\u002Fassistant","de\u002F03.app\u002F10.assistant",{"title":98,"path":171,"stem":172,"icon":101},"\u002Fde\u002Fapp\u002Fsettings","de\u002F03.app\u002F11.settings",{"title":108,"path":174,"stem":175,"icon":111},"\u002Fde\u002Fapp\u002Ffeature-requests","de\u002F03.app\u002F12.feature-requests",{"title":113,"path":177,"stem":178,"icon":116},"\u002Fde\u002Fapp\u002Fbug-reports","de\u002F03.app\u002F13.bug-reports",{"title":180,"path":181,"stem":182,"icon":183},"Desktop-App","\u002Fde\u002Fapp\u002Fdesktop-app","de\u002F03.app\u002F14.desktop-app","i-hugeicons-computer",{"title":185,"path":186,"stem":187,"icon":119},"Mobile App","\u002Fde\u002Fapp\u002Fmobile-app","de\u002F03.app\u002F15.mobile-app",{"title":189,"icon":190,"path":191,"stem":192,"children":193,"page":30},"Anmeldung & Verzeichnisse","i-hugeicons-security-check","\u002Fde\u002Fsign-in-and-directories","de\u002F04.sign-in-and-directories",[194,198,202,207,212,217,222,226,230,234],{"title":195,"path":196,"stem":197,"icon":19},"Anmeldeverfahren","\u002Fde\u002Fsign-in-and-directories\u002Fsign-in-methods","de\u002F04.sign-in-and-directories\u002F01.sign-in-methods",{"title":199,"path":200,"stem":201,"icon":190},"Single Sign-on","\u002Fde\u002Fsign-in-and-directories\u002Fsingle-sign-on","de\u002F04.sign-in-and-directories\u002F02.single-sign-on",{"title":203,"path":204,"stem":205,"icon":206},"Verzeichnisdienste (LDAP)","\u002Fde\u002Fsign-in-and-directories\u002Fdirectory-services","de\u002F04.sign-in-and-directories\u002F03.directory-services","i-hugeicons-hierarchy",{"title":208,"path":209,"stem":210,"icon":211},"Abgleich und Anmeldung","\u002Fde\u002Fsign-in-and-directories\u002Fdirectory-sync","de\u002F04.sign-in-and-directories\u002F04.directory-sync","i-hugeicons-refresh",{"title":213,"path":214,"stem":215,"icon":216},"Microsoft Entra ID","\u002Fde\u002Fsign-in-and-directories\u002Fmicrosoft-entra-id","de\u002F04.sign-in-and-directories\u002F05.microsoft-entra-id","i-hugeicons-building-03",{"title":218,"path":219,"stem":220,"icon":221},"Okta","\u002Fde\u002Fsign-in-and-directories\u002Fokta","de\u002F04.sign-in-and-directories\u002F06.okta","i-hugeicons-finger-print",{"title":223,"path":224,"stem":225,"icon":81},"Google Workspace","\u002Fde\u002Fsign-in-and-directories\u002Fgoogle-workspace","de\u002F04.sign-in-and-directories\u002F07.google-workspace",{"title":227,"path":228,"stem":229,"icon":119},"Zwei-Faktor-Authentifizierung","\u002Fde\u002Fsign-in-and-directories\u002Ftwo-factor-authentication","de\u002F04.sign-in-and-directories\u002F08.two-factor-authentication",{"title":231,"path":232,"stem":233,"icon":221},"Passkeys","\u002Fde\u002Fsign-in-and-directories\u002Fpasskeys","de\u002F04.sign-in-and-directories\u002F09.passkeys",{"title":235,"path":236,"stem":237,"icon":156},"Kalender-Freigabe","\u002Fde\u002Fsign-in-and-directories\u002Fcalendar-access","de\u002F04.sign-in-and-directories\u002F10.calendar-access",{"title":239,"icon":240,"path":241,"stem":242,"children":243,"page":30},"MCP-Server","i-hugeicons-ai-network","\u002Fde\u002Fmcp-server","de\u002F05.mcp-server",[244,248,253,257,262,266],{"title":245,"path":246,"stem":247,"icon":240},"Überblick","\u002Fde\u002Fmcp-server\u002Foverview","de\u002F05.mcp-server\u002F01.overview",{"title":249,"path":250,"stem":251,"icon":252},"Einrichten","\u002Fde\u002Fmcp-server\u002Fsetup","de\u002F05.mcp-server\u002F02.setup","i-hugeicons-plug-socket",{"title":254,"path":255,"stem":256,"icon":111},"Was Sie damit tun können","\u002Fde\u002Fmcp-server\u002Fuse-cases","de\u002F05.mcp-server\u002F03.use-cases",{"title":258,"path":259,"stem":260,"icon":261},"Werkzeuge","\u002Fde\u002Fmcp-server\u002Ftools","de\u002F05.mcp-server\u002F04.tools","i-hugeicons-wrench-01",{"title":263,"path":264,"stem":265,"icon":76},"Änderungen freigeben","\u002Fde\u002Fmcp-server\u002Fapproving-changes","de\u002F05.mcp-server\u002F05.approving-changes",{"title":267,"path":268,"stem":269,"icon":270},"Verwaltung & Sicherheit","\u002Fde\u002Fmcp-server\u002Fadmin-and-security","de\u002F05.mcp-server\u002F06.admin-and-security","i-hugeicons-shield-key",{"title":272,"icon":273,"path":274,"stem":275,"children":276,"page":30},"Externe Quellen","i-hugeicons-database-sync","\u002Fde\u002Fexternal-sources","de\u002F06.external-sources",[277,280,285,290,295,300,305],{"title":245,"path":278,"stem":279,"icon":273},"\u002Fde\u002Fexternal-sources\u002Foverview","de\u002F06.external-sources\u002F01.overview",{"title":281,"path":282,"stem":283,"icon":284},"SharePoint","\u002Fde\u002Fexternal-sources\u002Fsharepoint","de\u002F06.external-sources\u002F02.sharepoint","i-hugeicons-microsoft",{"title":286,"path":287,"stem":288,"icon":289},"OneDrive","\u002Fde\u002Fexternal-sources\u002Fonedrive","de\u002F06.external-sources\u002F03.onedrive","i-hugeicons-folder-cloud",{"title":291,"path":292,"stem":293,"icon":294},"Google Drive","\u002Fde\u002Fexternal-sources\u002Fgoogle-drive","de\u002F06.external-sources\u002F04.google-drive","i-hugeicons-google-drive",{"title":296,"path":297,"stem":298,"icon":299},"FTP \u002F SFTP","\u002Fde\u002Fexternal-sources\u002Fftp-sftp","de\u002F06.external-sources\u002F05.ftp-sftp","i-hugeicons-server-stack-01",{"title":301,"path":302,"stem":303,"icon":304},"REST-Schnittstelle","\u002Fde\u002Fexternal-sources\u002Frest","de\u002F06.external-sources\u002F06.rest","i-hugeicons-api",{"title":306,"path":307,"stem":308,"icon":309},"SOAP-Schnittstelle","\u002Fde\u002Fexternal-sources\u002Fsoap","de\u002F06.external-sources\u002F07.soap","i-hugeicons-source-code",{"title":311,"icon":304,"path":312,"stem":313,"children":314,"page":30},"Integrations-API","\u002Fde\u002Fintegration-api","de\u002F07.integration-api",[315,318,322,327,332,337,341,346,350,354,359,364],{"title":245,"path":316,"stem":317,"icon":14},"\u002Fde\u002Fintegration-api\u002Foverview","de\u002F07.integration-api\u002F01.overview",{"title":319,"path":320,"stem":321,"icon":19},"Authentifizierung","\u002Fde\u002Fintegration-api\u002Fauthentication","de\u002F07.integration-api\u002F02.authentication",{"title":323,"path":324,"stem":325,"icon":326},"Konventionen","\u002Fde\u002Fintegration-api\u002Fconventions","de\u002F07.integration-api\u002F03.conventions","i-hugeicons-book-open-01",{"title":328,"path":329,"stem":330,"icon":331},"Dokumente einspielen","\u002Fde\u002Fintegration-api\u002Fpushing-documents","de\u002F07.integration-api\u002F04.pushing-documents","i-hugeicons-upload-02",{"title":333,"path":334,"stem":335,"icon":336},"Inhalte abrufen","\u002Fde\u002Fintegration-api\u002Fconsuming-content","de\u002F07.integration-api\u002F05.consuming-content","i-hugeicons-download-02",{"title":338,"path":339,"stem":340,"icon":137},"Referenz: Dokumente","\u002Fde\u002Fintegration-api\u002Freference-documents","de\u002F07.integration-api\u002F06.reference-documents",{"title":342,"path":343,"stem":344,"icon":345},"Referenz: Kategorien, Schlagwörter, Märkte","\u002Fde\u002Fintegration-api\u002Freference-categories-tags","de\u002F07.integration-api\u002F07.reference-categories-tags","i-hugeicons-folder-01",{"title":347,"path":348,"stem":349,"icon":211},"Referenz: Abgleich-Manifest","\u002Fde\u002Fintegration-api\u002Freference-sync","de\u002F07.integration-api\u002F08.reference-sync",{"title":351,"path":352,"stem":353,"icon":309},"OpenAPI","\u002Fde\u002Fintegration-api\u002Fopenapi","de\u002F07.integration-api\u002F09.openapi",{"title":355,"path":356,"stem":357,"icon":358},"Änderungsprotokoll","\u002Fde\u002Fintegration-api\u002Fchangelog","de\u002F07.integration-api\u002F10.changelog","i-hugeicons-time-schedule",{"title":360,"path":361,"stem":362,"icon":363},"Referenz: Gruppen, Märkte, Zugriff","\u002Fde\u002Fintegration-api\u002Freference-groups-access","de\u002F07.integration-api\u002F11.reference-groups-access","i-hugeicons-user-lock-01",{"title":365,"path":366,"stem":367,"icon":368},"Umstieg von CMWS","\u002Fde\u002Fintegration-api\u002Fcmws","de\u002F07.integration-api\u002F12.cmws","i-hugeicons-arrow-reload-horizontal",{"title":370,"icon":371,"path":372,"stem":373,"children":374,"page":30},"Neuigkeiten","i-hugeicons-gift","\u002Fde\u002Fwhats-new","de\u002F08.whats-new",[375],{"title":355,"path":376,"stem":377,"icon":358},"\u002Fde\u002Fwhats-new\u002Fchangelog","de\u002F08.whats-new\u002F01.changelog",{"title":379,"icon":299,"path":380,"stem":381,"children":382,"page":30},"Selbst betreiben","\u002Fde\u002Fself-hosting","de\u002F09.self-hosting",[383,386,390,395,399,404,408,413,418,422],{"title":245,"path":384,"stem":385,"icon":14},"\u002Fde\u002Fself-hosting\u002Foverview","de\u002F09.self-hosting\u002F01.overview",{"title":387,"path":388,"stem":389,"icon":106},"Docker Compose","\u002Fde\u002Fself-hosting\u002Fdocker-compose","de\u002F09.self-hosting\u002F02.docker-compose",{"title":391,"path":392,"stem":393,"icon":394},"Kubernetes","\u002Fde\u002Fself-hosting\u002Fkubernetes","de\u002F09.self-hosting\u002F03.kubernetes","i-hugeicons-cloud",{"title":396,"path":397,"stem":398,"icon":101},"Konfiguration","\u002Fde\u002Fself-hosting\u002Fconfiguration","de\u002F09.self-hosting\u002F04.configuration",{"title":400,"path":401,"stem":402,"icon":403},"Lizenz","\u002Fde\u002Fself-hosting\u002Flicence","de\u002F09.self-hosting\u002F05.licence","i-hugeicons-license",{"title":405,"path":406,"stem":407,"icon":211},"Updates","\u002Fde\u002Fself-hosting\u002Fupdates","de\u002F09.self-hosting\u002F06.updates",{"title":409,"path":410,"stem":411,"icon":412},"Postgres","\u002Fde\u002Fself-hosting\u002Fpostgres","de\u002F09.self-hosting\u002F07.postgres","i-hugeicons-database",{"title":414,"path":415,"stem":416,"icon":417},"Sicherung","\u002Fde\u002Fself-hosting\u002Fbackups","de\u002F09.self-hosting\u002F08.backups","i-hugeicons-database-restore",{"title":419,"path":420,"stem":421,"icon":261},"Fehlerbehebung","\u002Fde\u002Fself-hosting\u002Ftroubleshooting","de\u002F09.self-hosting\u002F09.troubleshooting",{"title":423,"path":424,"stem":425,"icon":426},"Firewall","\u002Fde\u002Fself-hosting\u002Ffirewall","de\u002F09.self-hosting\u002F10.firewall","i-hugeicons-firewall",{"id":428,"title":319,"body":429,"description":736,"extension":737,"links":738,"meta":739,"navigation":740,"path":320,"seo":741,"stem":321,"__hash__":742},"docs_de\u002Fde\u002F07.integration-api\u002F02.authentication.md",{"type":430,"value":431,"toc":719},"minimark",[432,446,462,473,478,589,593,608,614,633,637,654,658,673,677,708,715],[433,434,435,436,440,441,445],"p",{},"Jede Anfrage trägt einen ",[437,438,439],"strong",{},"API-Schlüssel"," im Header ",[442,443,444],"code",{},"Authorization",":",[447,448,453],"pre",{"className":449,"code":450,"language":451,"meta":452,"style":452},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","Authorization: Bearer ddm_3f9a1c2b7d4e8f60_Qm9vZ2xlLUtleS1FeGFtcGxlLU5vdC1SZWFsLTEyMzQ1\n","http","",[442,454,455],{"__ignoreMap":452},[456,457,460],"span",{"class":458,"line":459},"line",1,[456,461,450],{},[433,463,464,465,468,469,472],{},"Schlüssel legt eine ",[437,466,467],{},"Administratorin oder ein Administrator"," im CMS unter ",[437,470,471],{},"Einstellungen › API-Zugang"," an.",[474,475,477],"h2",{"id":476},"einen-schlüssel-anlegen","Einen Schlüssel anlegen",[479,480,482,487,494,498,505,509,533,537,560,564,571,575,578,582],"steps",{"level":481},"3",[483,484,486],"h3",{"id":485},"einstellungen-api-zugang-öffnen","Einstellungen › API-Zugang öffnen",[433,488,489,490,493],{},"und auf ",[437,491,492],{},"Neuer Schlüssel"," klicken.",[483,495,497],{"id":496},"einen-namen-geben","Einen Namen geben",[433,499,500,501,504],{},"der sagt, welches System ihn benutzt, z. B. ",[442,502,503],{},"PIM-Export",". Der Name steht in der Schlüsselliste und im Protokoll.",[483,506,508],{"id":507},"wählen-was-er-darf","Wählen, was er darf",[510,511,512,519],"ul",{},[513,514,515,518],"li",{},[437,516,517],{},"Lesen"," – Dokumente, Kategorien und Dateien abrufen. Jeder Schlüssel darf lesen.",[513,520,521,524,525,528,529,532],{},[437,522,523],{},"Schreiben"," – Dokumente einspielen, Dokumente und Kategorien ändern und löschen. Ein schreibender Schlüssel braucht eine ",[437,526,527],{},"Push-Quelle"," (siehe ",[530,531,328],"a",{"href":329},").",[483,534,536],{"id":535},"wählen-was-er-sieht","Wählen, was er sieht",[510,538,539,554],{},[513,540,541,544,545,549,550,553],{},[437,542,543],{},"Nur freigegebene Inhalte"," – was Leser in der App sehen: keine archivierten Dokumente, und mit eingeschalteter ",[546,547,548],"em",{},"Verteilung erst nach Freigabe"," keine unfreigegebenen. Dateien lassen sich nur herunterladen, wenn sie die App verlassen dürfen (",[546,551,552],{},"Weitergabe erlaubt","). Das ist die richtige Wahl für einen Export auf eine Website oder in einen Shop.",[513,555,556,559],{},[437,557,558],{},"Alles in Dokumente"," – was die Person im CMS sieht, auch Entwürfe. Ein Schlüssel, der schreibt, sieht immer alles.",[483,561,563],{"id":562},"wählen-als-wer-er-handelt","Wählen, als wer er handelt",[433,565,566,567,570],{},"Der Schlüssel hat ",[437,568,569],{},"die Rechte dieser Person",": Der Schlüssel einer Administratorin sieht alles, der Schlüssel eines Redakteurs nur die Kategorien, die dieser Redakteur sehen darf. Standardmäßig handelt der Schlüssel als Sie. Für eine Integration ist es oft besser, einen eigenen Benutzer anzulegen, ihm genau die Kategorien zu geben, die die Integration braucht, und den Schlüssel als diesen Benutzer handeln zu lassen.",[483,572,574],{"id":573},"bei-bedarf-ein-ablaufdatum-setzen","Bei Bedarf ein Ablaufdatum setzen",[433,576,577],{},"Danach funktioniert der Schlüssel nicht mehr.",[483,579,581],{"id":580},"den-schlüssel-kopieren","Den Schlüssel kopieren",[433,583,584,585,588],{},"Er wird ",[437,586,587],{},"einmal"," angezeigt. DDM speichert nur einen Fingerabdruck (einen Hash) davon. Niemand kann ihn Ihnen noch einmal zeigen, auch keine Administratorin. Ist er verloren, legen Sie einen neuen an und widerrufen den alten.",[474,590,592],{"id":591},"wann-ein-schlüssel-nicht-mehr-funktioniert","Wann ein Schlüssel nicht mehr funktioniert",[433,594,595,596,599,600,603,604,607],{},"Eine Anfrage wird mit ",[442,597,598],{},"401 unauthorized"," abgewiesen, wenn der Schlüssel fehlt, ungültig oder unbekannt ist, ",[437,601,602],{},"widerrufen"," oder ",[437,605,606],{},"abgelaufen"," ist, oder wenn die Organisation abgeschaltet wurde. All das ergibt dieselbe Antwort, damit ein geratener Schlüssel nichts verrät.",[433,609,595,610,613],{},[442,611,612],{},"403 forbidden"," abgewiesen, wenn:",[510,615,616,619,630],{},[513,617,618],{},"dem Schlüssel die Berechtigung fehlt (z. B. ein Nur-Lesen-Schlüssel versucht einzuspielen), oder",[513,620,621,622,625,626,629],{},"die Person, als die er handelt, ",[437,623,624],{},"gesperrt"," wurde oder die Organisation ",[437,627,628],{},"verlassen"," hat – der Schlüssel endet mit ihr, oder",[513,631,632],{},"der Tarif der Organisation die API nicht mehr enthält.",[474,634,636],{"id":635},"alte-cmws-schlüssel","Alte CMWS-Schlüssel",[433,638,639,640,643,644,647,648,650,651,472],{},"Eine Organisation, die aus dem alten Document Distribution Manager umgezogen ist, behält die Schlüssel ihrer CMWS-Schnittstelle. Sie stehen als ",[437,641,642],{},"Alter CMWS-Schlüssel"," in der Liste, handeln als die beim Umzug genannte Person, schreiben über eine eigene Push-Quelle und gelten nur unter ",[442,645,646],{},"\u002Fapi\u002Fcmws\u002Fv1"," – siehe ",[530,649,365],{"href":366},". Sie stehen in der Adresse und damit in vielen Protokollen: Ersetzen Sie einen durch einen neuen Schlüssel, sobald die Anbindung es erlaubt – auch einen neuen nimmt CMWS in ",[442,652,653],{},"?apikey=",[474,655,657],{"id":656},"anfragelimit","Anfragelimit",[433,659,660,661,664,665,668,669,672],{},"Ein Schlüssel kann ",[437,662,663],{},"600 Anfragen pro Minute"," stellen. Weitere werden mit ",[442,666,667],{},"429 rate_limited"," abgewiesen. Der Header ",[442,670,671],{},"Retry-After"," sagt, wie viele Sekunden zu warten ist.",[474,674,676],{"id":675},"schlüssel-sicher-aufbewahren","Schlüssel sicher aufbewahren",[510,678,679,682,689,692,699],{},[513,680,681],{},"Behandeln Sie einen Schlüssel wie ein Passwort. Er gehört in den Geheimnisspeicher des anderen Systems oder in eine Umgebungsvariable, nie in den Quellcode oder eine URL.",[513,683,684,685,688],{},"Nehmen Sie ",[437,686,687],{},"einen Schlüssel pro System",", damit das Widerrufen des einen die anderen nicht stoppt.",[513,690,691],{},"Geben Sie einem Schlüssel nicht mehr, als er braucht: Nur-Lesen für einen Export, und eine handelnde Person mit nur den nötigen Kategorien.",[513,693,694,695,698],{},"Schlüssel beginnen mit ",[442,696,697],{},"ddm_",". So erkennen Secret-Scanner (etwa der von GitHub) einen veröffentlichten Schlüssel.",[513,700,701,704,705,707],{},[437,702,703],{},"Wechseln"," Sie einen Schlüssel so: einen neuen anlegen, das System umstellen, dann den alten unter ",[437,706,471],{}," widerrufen. Das Widerrufen wirkt ab der nächsten Anfrage.",[433,709,710,711,714],{},"Jede Änderung über einen Schlüssel steht im ",[530,712,713],{"href":89},"Protokoll",", unter der Person, als die der Schlüssel handelt. Auch das Anlegen und Widerrufen von Schlüsseln wird protokolliert.",[716,717,718],"style",{},"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":452,"searchDepth":720,"depth":720,"links":721},2,[722,732,733,734,735],{"id":476,"depth":720,"text":477,"children":723},[724,726,727,728,729,730,731],{"id":485,"depth":725,"text":486},3,{"id":496,"depth":725,"text":497},{"id":507,"depth":725,"text":508},{"id":535,"depth":725,"text":536},{"id":562,"depth":725,"text":563},{"id":573,"depth":725,"text":574},{"id":580,"depth":725,"text":581},{"id":591,"depth":720,"text":592},{"id":635,"depth":720,"text":636},{"id":656,"depth":720,"text":657},{"id":675,"depth":720,"text":676},"API-Schlüssel – anlegen, was sie dürfen, als wer sie handeln, und wie man sie sicher aufbewahrt.","md",null,{},{"icon":19},{"title":319,"description":736},"iwSBYtRWwrGspSJ314RvL0X8eJ7ZW4AMzmehatkIfBU",[744,746],{"title":245,"path":316,"stem":317,"description":745,"icon":14,"children":-1},"Die externe API verbindet DDM mit Systemen, für die es keinen Konnektor gibt – um Dokumente einzuspielen und Inhalte abzurufen.",{"title":323,"path":324,"stem":325,"description":747,"icon":326,"children":-1},"Formate, Referenzen, Seiten, Änderungsfeed, Dateien, Grenzen und Fehler – was alle Endpunkte gemeinsam haben.",1793617729717]