{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"“Data Protection and Security Toolkit API” is a library for Atlassian plugins \"Data Protection and Security Toolkit for Jira\" and \"Data Protection and Security Toolkit for Confluence\" (","type":"text"},{"text":"https://marketplace.atlassian.com/apps/1218962/gdpr-dsgvo-and-security-for-jira?hosting=server&tab=overview","type":"text","marks":[{"type":"link","attrs":{"href":"https://marketplace.atlassian.com/apps/1218962/gdpr-dsgvo-and-security-for-jira?hosting=server&tab=overview"}}]},{"text":", ","type":"text"},{"text":"https://marketplace.atlassian.com/apps/1219041/gdpr-dsgvo-and-security-for-confluence?hosting=server&tab=overview)","type":"text","marks":[{"type":"link","attrs":{"href":"https://marketplace.atlassian.com/apps/1219041/gdpr-dsgvo-and-security-for-confluence?hosting=server&tab=overview"}}]},{"text":". The library provides the API for integration with 3rd party apps and plugins for Jira and Confluence. Through this integration and using the library, other plugins may extend anonymization functionality and clean-up some special content during the \"User Anonymization process\".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Anonymization architecture","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1280,"id":"28b5b13e-490f-4d47-af71-9a624b51c709","collection":"contentId-835420180","type":"file","height":390}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Steps to build an integration","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add “gdpr-api” library to pom.xml","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement ","type":"text"},{"text":"IGDPRAnonymizer","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"pom.xml example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","localId":"e7971e6a-6e0b-43a1-8dcf-42ad84cd4483"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[680.0]},"content":[{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n de.actonic\n gdpr-api\n 1.0.2\n \n\n \n...\n \n\n de.actonic.gdpr.api.*,\n\n \n...\n \n\n de.actonic.jira.gdpr.api.*;resolution:=\"optional\",\n","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Anonymization function implementation example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"d0ac5fa1-6515-453a-89ac-e008253ee71b"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[680.0]},"content":[{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"package com.other.test.testGDPRApiPlugin;\n\nimport java.util.*;\n\nimport com.atlassian.jira.component.*;\nimport de.actonic.gdpr.api.*;\nimport org.springframework.beans.factory.*;\nimport org.springframework.stereotype.*;\n\n@Component\npublic class Anonymizer implements IGDPRAnonymizer, InitializingBean, DisposableBean {\n\t...\n\t\t// class constructor and some other unnecessary parts are skipped \n\t...\n\n\t@Override\n\tpublic List search(List sourceUserKeys) {\n\t\tList anonymizeObjects = new ArrayList<>();\n\t\tfor (String sourceUserKey : sourceUserKeys) {\n\t\t\tApplicationUser applicationUser = userManager.getUserByKey(sourceUserKey);\n\t\t\tif (applicationUser != null) {\n\t\t\t\tCollection portalPages = portalPageManager.getAllOwnedPortalPages(applicationUser);\n\t\t\t\tfor (PortalPage portalPage : portalPages) {\n\t\t\t\t\tanonymizeObjects.add(new GDPRAnonymizeObject(portalPage.getName(), \"Dashboard\", \"/secure/Dashboard.jspa?selectPageId=\" + portalPage.getId()));\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn anonymizeObjects;\n\t}\n\n @Override\n public List anonymize(List sourceUserKeys, String targetUserKey) {\n\t\t// here you anonymize all data by incoming parameters and return the result\n return null;\n }\n\n @Override\n public void stop() {\n\t\t// here you interrupt the search/anonymization process\n }\n\n @Override\n public String getPluginName() {\n return \"Plugin #2\";\n }\n\n @Override\n public String getAnonymizerName() {\n return \"User actions anonymizer\";\n }\n\n @Override\n public void afterPropertiesSet() throws Exception {\n IGDPRAnonymizeService anonymizeService = ComponentAccessor.getOSGiComponentInstanceOfType(IGDPRAnonymizeService.class);\n if (anonymizeService != null) {\n anonymizeService.addAnonymizer(this);\n }\n }\n\n @Override\n public void destroy() throws Exception {\n IGDPRAnonymizeService anonymizeService = ComponentAccessor.getOSGiComponentInstanceOfType(IGDPRAnonymizeService.class);\n if (anonymizeService != null) {\n anonymizeService.removeAnonymizer(this);\n }\n }\n}","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"How to check the integration","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install the latest version of Data Protection and Security Toolkit for Jira (","type":"text"},{"text":"https://marketplace.atlassian.com/apps/1218962/gdpr-dsgvo-and-security-for-jira?hosting=server&tab=overview","type":"text","marks":[{"type":"link","attrs":{"href":"https://marketplace.atlassian.com/apps/1218962/gdpr-dsgvo-and-security-for-jira?hosting=server&tab=overview"}}]},{"text":")","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install your app to the same server","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the “Data Cleaner” module https://%your-jira-server%/jira/secure/admin/actonic-gdpr-data-cleaner.jspa","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Find your app in the “Anonymization post-functions” list","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Try to search some personal content for a user, who is working with your app (check that your post function was selected)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Look at the search results at https://%your-jira-server%/jira/secure/admin/actonic-gdpr-data-cleaner-results.jspa?templateId=-1","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In case of any difficulties, please contact us by ","type":"text"},{"text":"https://actonic.atlassian.net/servicedesk/customer/portal/8","type":"text","marks":[{"type":"link","attrs":{"href":"https://actonic.atlassian.net/servicedesk/customer/portal/8"}}]}]},{"type":"paragraph"}],"version":1}