{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"easy-heading","parameters":{"macroParams":{"linkText4":{"value":""},"linkText10":{"value":""},"linkText3":{"value":""},"linkText6":{"value":""},"linkText5":{"value":""},"relatedLinksLabels":{"value":""},"linkText2":{"value":""},"linkText1":{"value":""},"headingTags":{"value":"H1,H2,H3"},"sidebarMaxHeight":{"value":"450"},"linkType2":{"value":"Page"},"linkType3":{"value":"Page"},"linkType1":{"value":"Page"},"linkType10":{"value":"Page"},"sidebarTitle":{"value":"ON THIS PAGE"},"linkUrl3":{"value":""},"linkUrl4":{"value":""},"linkUrl1":{"value":""},"linkUrl2":{"value":""},"linkUrl10":{"value":""},"includedPageMode":{"value":"Disable_Included_Pages"},"linkText8":{"value":""},"linkText7":{"value":""},"relatedLinksOrder":{"value":"Labels_First"},"sidebarMode":{"value":"Opened"},"headingNumberingMode":{"value":"Disable_Numbering"},"linkText9":{"value":""},"sidebarMarginRight":{"value":"20"},"relatedLinksTarget":{"value":"New_Window"},"relatedLinksTitle":{"value":"RELATED LINKS"},"linkUrl9":{"value":""},"linkUrl7":{"value":""},"linkUrl8":{"value":""},"numberedHeadingTags":{"value":"H1,H2,H3"},"linkUrl5":{"value":""},"linkUrl6":{"value":""},"linkType8":{"value":"Page"},"linkType9":{"value":"Page"},"linkType6":{"value":"Page"},"headingLinkTextMode":{"value":"Wrap"},"linkType7":{"value":"Page"},"linkType4":{"value":"Page"},"linkType5":{"value":"Page"},"sidebarWidth":{"value":"240"},"sidebarTop":{"value":"160"},"headingLinkExpandMode":{"value":"Collapse_All_By_Default"},"headingLinkIndent":{"value":"10"}},"macroMetadata":{"macroId":{"value":"01f6289a-7355-40d6-b053-de47f1386cb5"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"https://easy-heading.shinetechapps.com/images/icon.png?linkText4=&linkText10=&linkText3=&linkText6=&linkText5=&relatedLinksLabels=&linkText2=&linkText1=&headingTags=H1%2CH2%2CH3&sidebarMaxHeight=450&linkType2=Page&linkType3=Page&linkType1=Page&linkType10=Page&sidebarTitle=ON+THIS+PAGE&linkUrl3=&linkUrl4=&linkUrl1=&linkUrl2=&linkUrl10=&includedPageMode=Disable_Included_Pages&linkText8=&linkText7=&relatedLinksOrder=Labels_First&sidebarMode=Opened&headingNumberingMode=Disable_Numbering&linkText9=&sidebarMarginRight=20&relatedLinksTarget=New_Window&relatedLinksTitle=RELATED+LINKS&linkUrl9=&linkUrl7=&linkUrl8=&numberedHeadingTags=H1%2CH2%2CH3&linkUrl5=&linkUrl6=&linkType8=Page&linkType9=Page&linkType6=Page&headingLinkTextMode=Wrap&linkType7=Page&linkType4=Page&linkType5=Page&sidebarWidth=240&sidebarTop=160&headingLinkExpandMode=Collapse_All_By_Default&headingLinkIndent=10"}}],"title":"Easy Heading Macro"}},"localId":"f1e90af1-4fba-49f4-9fd7-826b315c861b"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Introduction","type":"text"}]},{"type":"paragraph","content":[{"text":"The purpose of this document is to provide instructions to apply API (Application Programming Interface) connection to GYTPOL server from a third-party tools.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"Gytpol API v1.0 covers the following use cases:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Getting misconfigurations for a given computer","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Getting misconfigurations for all computers ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Getting the list of all computers that had misconfigurations","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"paragraph","content":[{"text":"These use cases are addressed accordingly by the following REST API functions:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"get_miscon_by_computer","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"get_misconfigurations_start","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" to set a filter and get a token for following calls to ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"get_misconfigurations_next","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"get_miscon_computers_start","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" to set a filter and get a token for following calls to ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"get_miscon_computers_next","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"add_to_group -","type":"text","marks":[{"type":"strong"}]},{"text":" to add computers to your custom group","type":"text"}]}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"All methods are POST.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The on-prem server API permits only 100 reads per minute. To prevent surpassing this limit, it's recommended to integrate a timeout or pause within the PS1 script between loops. ","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"# Your existing code here\n\n# Add a pause of 2 seconds (adjust as needed) between each iteration\nStart-Sleep -Seconds 2","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"API Keys","type":"text"}]},{"type":"paragraph","content":[{"text":"All HTTPS requests for REST API functions must include the ","type":"text"},{"text":"x-api-key","type":"text","marks":[{"type":"strong"}]},{"text":" parameter in the request header, as illustrated in the examples below. ","type":"text"}]},{"type":"paragraph","content":[{"text":"SaaS customers","type":"text","marks":[{"type":"strong"}]},{"text":" are advised to reach out to their customer success manager to obtain the necessary ","type":"text"},{"text":"x-api-key","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"On-Prem Customers:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"To generate an API key in the GYTPOL UI, navigate to the gear icon > Settings > GYTPOL API Keys. To create a new key, click the ","type":"text"},{"text":"+","type":"text","marks":[{"type":"strong"}]},{"text":" (Plus) icon and assign a name that corresponds to the system. The key will expire after 1 year by default.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":339,"id":"4a52c0a2-155c-42b9-ad1f-a63033153d6c","collection":"contentId-37715985","type":"file","height":239}}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"align-start","width":75.0},"content":[{"type":"media","attrs":{"width":532,"id":"188af001-93a1-4d50-8914-e5b6d0cb2e89","collection":"contentId-37715985","type":"file","height":206}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"API Port","type":"text"}]},{"type":"paragraph","content":[{"text":"For ","type":"text"},{"text":"On-Prem customers","type":"text","marks":[{"type":"strong"}]},{"text":", the default port for API access is 9191. If you wish to use a different port, you can make the adjustment by modifying the port in the file located at ","type":"text"},{"text":"c:\\gytpol\\data\\webserv_config.json","type":"text","marks":[{"type":"strong"}]},{"text":". ","type":"text"}]},{"type":"paragraph","content":[{"text":"After changing the port, be sure to restart the ","type":"text"},{"text":"gytpol Web UI service","type":"text","marks":[{"type":"strong"}]},{"text":" to apply the modifications.","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"width":441,"id":"43cdcb4e-300c-4962-a4a9-741137b8b376","collection":"contentId-37715985","type":"file","height":313}}]},{"type":"paragraph","content":[{"text":"For ","type":"text"},{"text":"SaaS customers","type":"text","marks":[{"type":"strong"}]},{"text":", there is no need to specify a port, as the URL utilizes port ","type":"text"},{"text":"443","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Base URL","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Base URL","type":"text","marks":[{"type":"strong"}]},{"text":" variable in both the scripts and the examples provided below should be set to your GYTPOL URL.","type":"text"}]},{"type":"paragraph","content":[{"text":"For ","type":"text"},{"text":"on-premises","type":"text","marks":[{"type":"strong"}]},{"text":" customers, it's necessary to append the port after the GYTPOL server URL, like so: ","type":"text"},{"text":"https://gytpol.domain.local:9191/gytpolapi/v2.0/","type":"text","marks":[{"type":"code"}]},{"text":". ","type":"text"}]},{"type":"paragraph","content":[{"text":"However, ","type":"text"},{"text":"SaaS ","type":"text","marks":[{"type":"strong"}]},{"text":"customers can simply utilize the URL of their tenant without the port: ","type":"text"},{"text":"https://gytpol.eu.cloud.gytpol.com/gytpolapi/v2.0/","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"get_miscon_by_computer","type":"text"}]},{"type":"paragraph","content":[{"text":"This REST API function returns misconfigurations given a computer name and optionally Windows domain name.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Request Structure","type":"text"}]},{"type":"paragraph","content":[{"text":"JSON string of the following structure:","type":"text"}]},{"type":"paragraph"},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c839cab7-33f5-4ec6-b5e0-09787138de0b"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"computer","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"mandatory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Computer name","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"domainName","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"For windows computers, Windows domain name","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Response Structure","type":"text"}]},{"type":"paragraph","content":[{"text":"JSON string of the following structure:","type":"text"}]},{"type":"paragraph"},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"5333dee5-fbe4-450f-b615-100b2e9c0d7e"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"computers","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"object array","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"latestHostReportingDt","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"datetime","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Latest date and time the computer reported to Gytpol","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"latestScanDt","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"datetime","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Gytpol sensor scans computers for misconfigurations and sends the report to Gytpol backend. This is the date and time of the latest misconfiguration scan reported for this computer.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"computer","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Computer name","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"computerOu","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Name of organizational unit define on this computer","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"domainName","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"For windows computers, Windows domain name","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"clientVer","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Gytpol sensor version currently installed on this computer","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"ipAddress","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Computer’s IP address","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"os","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Computer’s operating system","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"isVdi","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"bool","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Is this computer a VDI","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"isServer","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"bool","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Is this computer a server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"isDC","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"bool","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Is this computer a domain controller","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"miscon","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"object array","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Array of misconfigurations reported for this computer","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"topicCode","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"user","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Username logged into the computer when this misconfiguration had been found","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"severity","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Specifies minimal severity of returned misconfigurations. Supported values are:","type":"text"}]},{"type":"paragraph","content":[{"text":"Low","type":"text"}]},{"type":"paragraph","content":[{"text":"Medium","type":"text"}]},{"type":"paragraph","content":[{"text":"High","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"addInfo","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Additional information describing this misconfiguration (this is json string) with \\ before “ in order to prevent breaking the structure of the response json","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"param","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter providing more details for the misconfiguration","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"paramExtra","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter providing even more details for the misconfiguration","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"isRemediable","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"bool","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Is this misconfiguration remediable","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"isMuted","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"bool","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Is this misconfiguration muted by one of the mute rules","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"mutedByRuleId","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"number","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"The Id of the mute rule that muted this misconfiguration","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"hostReportingDt","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"datetime","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Datetime when computer reported this misconfiguration to Gytpol backend","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"scanTimeDt","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"datetime","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Datetime when Gytpol sensor installed on the computer found this misconfiguration","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"_Toc151990466"},"legacyAnchorId":{"value":"APIConnectionGuide-_Toc151990466"}},"macroMetadata":{"macroId":{"value":"78637641-8d7f-49cf-849e-0b91539fd676"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"a29c0f0c-eea0-477f-8e6b-850344b2c760"}},{"text":"Request Example","type":"text"}]},{"type":"paragraph","content":[{"text":"curl --location --request POST \"","type":"text"},{"text":"{BASE-URL}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]},{"text":"/gytpolapi/v2.0/get_miscon_by_computer\" --header \"","type":"text"},{"text":"x-api-key: jyUbUQNuVjClzQ5f6sXgmcgGzyoFiaYXA+OvxObvLV8=\"","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}}]},{"text":"--data-raw \"{ \\\"computer\\\": \\\"","type":"text"},{"text":"YOUR-COMPUTER-NAME","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]},{"text":"\\\"}\"","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Powershell:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"$headers = New-Object \"System.Collections.Generic.Dictionary[[String],[String]]\"\n\n$headers.Add(\"x-api-key\", \"{API KEY}\")\n\n$body = \"{`\"computer`\": `\"{PCName}`\"}\"\n\n$response = Invoke-RestMethod 'https://{BASE-URL}/gytpolapi/v2.0/get_miscon_by_computer' -Method 'POST' -Headers $headers -Body $body\n\n$response | ConvertTo-Json","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Note","type":"text","marks":[{"type":"strong"}]},{"text":": Change ","type":"text"},{"text":"BASE-URL","type":"text","marks":[{"type":"strong"}]},{"text":" to your base URL. Change ","type":"text"},{"text":"x-api-key","type":"text","marks":[{"type":"strong"}]},{"text":" to your API key.","type":"text"}]},{"type":"paragraph","content":[{"text":"For On-prem customers, please incorporate your port (i.e., 9191) into the BASE-URL as follows: ","type":"text"},{"text":"BASE-URL:PORT","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Response Example","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"0c04fafd-54ce-48b8-bd0c-a976a9afa7c1"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#DBE5F1","rowspan":1,"colwidth":[680.0]},"content":[{"type":"paragraph","content":[{"text":"{","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"computers\": [","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" {","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"latestHostReportingDt\": \"2023-01-17T18:25:05.5389826+02:00\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"latestScanTimeDt\": \"2023-01-17T18:24:47.4503679+02:00\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"computer\": \"YOUR-COMPUTER-NAME\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"computerOu\": \"COMPUTER-OU\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"domainName\": \"YOUR-DOMAIN-NAME\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"clientVer\": \"2.26.1.0\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"ipAddress\": \"10.67.137.160\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"os\": \"Win 10 Enterprise\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"isVdi\": false,","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"isServer\": false,","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"isDC\": false,","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"miscon\": [","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" {","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"topicCode\": \"gytPSVerIssue\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"user\": null,","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"severity\": \"Medium\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"addInfo\": \"{\\\"PSversions\\\":\\\"2; 5.1.19041.2364\\\",\\\"occurrences\\\":1}\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"param\": \"2; 5.1.19041.2364\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"paramExtra\": null,","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"isRemediable\": true,","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"isMuted\": false,","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"mutedByRuleId\": 0,","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"hostReportingDt\": \"2023-01-17T18:25:05.5389826+02:00\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"scanTimeDt\": \"2023-01-17T18:24:47.4503679+02:00\"","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" },","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" {","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"topicCode\": \"gytSmbAnonymous\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"user\": null,","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"severity\": \"Medium\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"addInfo\": \"{\\\"Current Value\\\":0,\\\"Expected Value\\\":\\\"1\\\",\\\"Registry Name\\\":\\\"RestrictAnonymous\\\",\\\"Registry Path\\\":\\\"HKLM:\\\\\\\\System\\\\\\\\CurrentControlSet\\\\\\\\Control\\\\\\\\Lsa\\\",\\\"Shares with Everyone\\\":\\\"N/A\\\",\\\"Shares without Everyone\\\":\\\"N/A\\\",\\\"occurrences\\\":1}\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"param\": \"No shares; The configured value is not secure\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"paramExtra\": null,","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"isRemediable\": true,","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"isMuted\": false,","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"mutedByRuleId\": 0,","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"hostReportingDt\": \"2023-01-17T18:25:05.5389826+02:00\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"scanTimeDt\": \"2023-01-17T18:24:47.4503679+02:00\"","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" }","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"\t]","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"}]","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"}","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"HTTP Return Codes","type":"text"}]},{"type":"paragraph","content":[{"text":"200 Ok","type":"text"}]},{"type":"paragraph","content":[{"text":"400 Bad Request","type":"text"}]},{"type":"paragraph","content":[{"text":"401 Unauthorized","type":"text"}]},{"type":"paragraph","content":[{"text":"429 Too Many Requests","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"get_misconfigurations_start","type":"text"}]},{"type":"paragraph","content":[{"text":"Use this function to initiate a series of calls to get misconfigurations by computer.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Request Structure","type":"text"}]},{"type":"paragraph","content":[{"text":"Request body should contain json object of the following structure:","type":"text"}]},{"type":"paragraph"},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"76f669e9-b242-44d0-a2bb-49c282b56178"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"computer","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Computer name","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"domainName","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"For windows computers, Windows domain name","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"selTarget","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Narrows down returned computers to a specified type. One of following possible values can be passed: ","type":"text"}]},{"type":"paragraph","content":[{"text":"All Windows Computers","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows Endpoints","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows Servers","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows Non-VDI","type":"text"}]},{"type":"paragraph","content":[{"text":"Endpoints Windows VDI","type":"text"}]},{"type":"paragraph","content":[{"text":"Endpoints Windows DC Servers ","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows Non-DC Servers","type":"text"}]},{"type":"paragraph","content":[{"text":"Debian Linux Computers","type":"text"}]},{"type":"paragraph","content":[{"text":"Red Hat Linux Computers","type":"text"}]},{"type":"paragraph","content":[{"text":"SUSE Linux Computers","type":"text"}]},{"type":"paragraph","content":[{"text":"Linux Unknown Computers","type":"text"}]},{"type":"paragraph","content":[{"text":"MAC Computers","type":"text"}]},{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"severity","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Specifies minimal severity of returned misconfigurations. Supported values are:","type":"text"}]},{"type":"paragraph","content":[{"text":"Low","type":"text"}]},{"type":"paragraph","content":[{"text":"Medium","type":"text"}]},{"type":"paragraph","content":[{"text":"High","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"computerOu","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Return only computers that belong to the provided Organization Unit","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"topicCodes","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string array","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Restrict returned misconfigurations only to specify misconfiguration types. The parameter has a form of: [","type":"text"}]},{"type":"paragraph","content":[{"text":" \"gytHostsFile\",","type":"text"}]},{"type":"paragraph","content":[{"text":" \"gytSmbAnonymous\",","type":"text"}]},{"type":"paragraph","content":[{"text":" \"gytTLSSSLClient\"]","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"fromHostReportingDt","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Return only computers with latest misconfigurations reported after a given date and time. Example: \"2023-01-10T19:43:46+02:00\" or just “2023-01-01”","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"toHostReportingDt","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Return only computers with latest misconfigurations reported before a given date and time. Example: \"2023-01-10T19:43:46+02:00\" or just “2023-01-01”","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"returnMutedTopics","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"bool ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Gytpol product allows to mute misconfigurations meaning that they will not visually appear in the application. ","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Default value is false meaning that muted misconfiguration will not be returned.","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Json in the request body looks like in the following example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"acc59009-7365-4bd8-9152-f252f2287d76"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#DBE5F1","rowspan":1,"colwidth":[680.0]},"content":[{"type":"paragraph","content":[{"text":"{","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"computer\": \" Optional\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"domainName\": \" Optional\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"selTarget\": \" Optional\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"severity\": \" Optional\", ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"computerOu\": \" Optional\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"topicCodes\": [\" topic code\", \" topic code\"],","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"fromHostReportingDt\": \" that contains datetime Optional\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"toHostReportingDt\": \" that contains datetime Optional\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"returnMutedTopics\": \"boolean default is false Optional\"","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"}","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Response Structure","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"83dd31d1-7e0d-4069-b22f-8d02def1f2ca"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"token","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Encrypted string to use for following calls to the ","type":"text"},{"text":"get_misconfigurations_next","type":"text","marks":[{"type":"strong"}]},{"text":" function","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Request Example","type":"text"}]},{"type":"paragraph","content":[{"text":"curl --location --request POST \"","type":"text"},{"text":"{BASE-URL}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]},{"text":"/gytpolapi/v2.0/get_misconfigurations_start\" --header \"","type":"text"},{"text":"x-api-key: jyUbUQNuVjClzQ5f6sXgmcgGzyoFiaYXA+OvxObvLV8=","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]},{"text":"\" --data-raw \"{ \\\"computer\\\": null, \\\"domainName\\\": null, \\\"selTarget\\\": null, \\\"severity\\\": \\\"Medium\\\", \\\"computerOu\\\": null, \\\"topicCodes\\\": null, \\\"fromHostReportingDt\\\": \\\"2023-01-10T19:43:46+02:00\\\", \\\"toHostReportingDt\\\": null, \\\"returnMutedTopics\\\": false}\"","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Powershell:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"$headers = New-Object \"System.Collections.Generic.Dictionary[[String],[String]]\"\n\n$headers.Add(\"x-api-key\", \"{API KEY}\")\n\n$headers.Add(\"Content-Type\", \"application/json\")\n\n$body = \"{`\"severity`\":`\"High`\"}\"\n\n$response = Invoke-RestMethod 'https://{BASE-URL}/gytpolapi/v2.0/get_misconfigurations_start' -Method 'POST' -Headers $headers -Body $body\n\n$response | ConvertTo-Json","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Note","type":"text","marks":[{"type":"strong"}]},{"text":": Change ","type":"text"},{"text":"BASE-URL","type":"text","marks":[{"type":"strong"}]},{"text":" to your base URL. Change ","type":"text"},{"text":"x-api-key","type":"text","marks":[{"type":"strong"}]},{"text":" to your API key.","type":"text"}]},{"type":"paragraph","content":[{"text":"For On-prem customers, please incorporate your port (i.e., 9191) into the BASE-URL as follows: ","type":"text"},{"text":"BASE-URL:PORT","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Response Example","type":"text"}]},{"type":"paragraph","content":[{"text":"{\"token\":\"7h5vmgiKQgvFiTb3xhrSyum52cbfh77xexcus8kGtOP03mliJxbJL99q8wfC2d8kwpNGXa0QF1VuycY6xnosSJePUkaGGUgCQ61rBmVcJI1J6RkUZMWmmGGD3R/+e9b2SrRlamRNusqUBOCphAeyDpBGb7uliNLpfn7wB2JiDGDJRu73Im6UIt3V7ITZDehfsb+JkWXVLlKNIv9+RvxrBCxVa/7StHvyW10cpGF67P9HfLZFbQOCjFsFOs8Mn6amZJrh1bkpasAblUWI0toXZVrlLHr6lfEYZMRnTadcBNTNIUBBWr6ptLUvdcWqEukmdaBublWIQBpAI++Seqc9rMF2WEex9o2n+5NyQBp8+OnuvsUcUybW/MfjG6J/06d07Tf/ks9mQJgZO2vnuJQAPA==\"}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"HTTP Return Codes","type":"text"}]},{"type":"paragraph","content":[{"text":"200 Ok","type":"text"}]},{"type":"paragraph","content":[{"text":"400 Bad Request","type":"text"}]},{"type":"paragraph","content":[{"text":"401 Unauthorized","type":"text"}]},{"type":"paragraph","content":[{"text":"429 Too Many Requests","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"get_misconfigurations_next","type":"text"}]},{"type":"paragraph","content":[{"text":"Use this function to initiate a series of calls to get misconfigurations by computer","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Request Structure","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"97fa67e7-3741-48b9-87d3-557a3ad2f15c"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"token","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Mandatory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Encrypted string to use for following calls to the ","type":"text"},{"text":"get_misconfigurations_next","type":"text","marks":[{"type":"strong"}]},{"text":" function","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Json in the request body looks like in the following example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c3c6e997-10f1-4a8a-b365-7386121d8fd1"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#DBE5F1","rowspan":1,"colwidth":[680.0]},"content":[{"type":"paragraph","content":[{"text":"{","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"token\": \" Mandatory","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"}","type":"text","marks":[{"type":"strong"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Response Structure","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"169205af-9b2c-4fd2-bc11-d2a52b317a56"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"computers","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"object array","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Same structure as presented in get_miscon_by_computer ","type":"text"},{"text":"Response Structure","type":"text","marks":[{"type":"underline"},{"type":"textColor","attrs":{"color":"#0000ff"}},{"type":"link","attrs":{"href":"#_heading=h.46r0co2"}}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Keep calling to get_misconfigurations_next each time with the new token until returned computers array is empty, e.g. []","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"token","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Encrypted string to use for following calls to the ","type":"text"},{"text":"get_misconfigurations_next","type":"text","marks":[{"type":"strong"}]},{"text":" function","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Request Example","type":"text"}]},{"type":"paragraph","content":[{"text":"curl --location --request POST \"","type":"text"},{"text":"{BASE-URL}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]},{"text":"/gytpolapi/v2.0/get_misconfigurations_next\" --header \"","type":"text"},{"text":"x-api-key: jyUbUQNuVjClzQ5f6sXgmcgGzyoFiaYXA+OvxObvLV8=","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]},{"text":"\" --data-raw \"{ \\\"token\\\": \\\"7h5vmgiKQgvFiTb3xhrSyum52cbfh77xexcus8kGtOP03mliJxbJL99q8wfC2d8kwpNGXa0QF1VuycY6xnosSJePUkaGGUgCQ61rBmVcJI1J6RkUZMWmmGGD3R/+e9b2SrRlamRNusqUBOCphAeyDpBGb7uliNLpfn7wB2JiDGDJRu73Im6UIt3V7ITZDehfsb+JkWXVLlKNIv9+RvxrBCxVa/7StHvyW10cpGF67P9HfLZFbQOCjFsFOs8Mn6amZJrh1bkpasAblUWI0toXZVrlLHr6lfEYZMRnTadcBNTNIUBBWr6ptLUvdcWqEukmdaBublWIQBpAI++Seqc9rMF2WEex9o2n+5NyQBp8+OnuvsUcUybW/MfjG6J/06d07Tf/ks9mQJgZO2vnuJQAPA==\\\"}\"","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Powershell:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"$headers = New-Object \"System.Collections.Generic.Dictionary[[String],[String]]\"\n\n$headers.Add(\"x-api-key\", \"{API KEY}\")\n\n$headers.Add(\"Content-Type\", \"application/json\")\n\n$body = \"{`\"Token`\":{TOKEN}}\"\n\n$response = Invoke-RestMethod 'https://{BASE-URL}/gytpolapi/v2.0/get_misconfigurations_next' -Method 'POST' -Headers $headers -Body $body\n\n$response | ConvertTo-Json","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Note","type":"text","marks":[{"type":"strong"}]},{"text":": Change ","type":"text"},{"text":"BASE-URL","type":"text","marks":[{"type":"strong"}]},{"text":" to your base URL. Change ","type":"text"},{"text":"x-api-key","type":"text","marks":[{"type":"strong"}]},{"text":" to your API key.","type":"text"}]},{"type":"paragraph","content":[{"text":"For On-prem customers, please incorporate your port (i.e., 9191) into the BASE-URL as follows: ","type":"text"},{"text":"BASE-URL:PORT","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Response Example","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"6e1c1dc8-beae-4a8e-aceb-ba761d1c45ac"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#DBE5F1","rowspan":1,"colwidth":[680.0]},"content":[{"type":"paragraph","content":[{"text":"{","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"computers\": “same structure as show in ","type":"text","marks":[{"type":"strong"}]},{"text":"Response Example","type":"text","marks":[{"type":"underline"},{"type":"textColor","attrs":{"color":"#0000ff"}},{"type":"strong"},{"type":"link","attrs":{"href":"#_heading=h.111kx3o"}}]},{"text":"”,","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" “token” : “new encrypted string for the following call to get_misconfigurations_next”","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"}","type":"text","marks":[{"type":"strong"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"HTTP Return Codes","type":"text"}]},{"type":"paragraph","content":[{"text":"200 Ok","type":"text"}]},{"type":"paragraph","content":[{"text":"400 Bad Request","type":"text"}]},{"type":"paragraph","content":[{"text":"401 Unauthorized","type":"text"}]},{"type":"paragraph","content":[{"text":"429 Too Many Requests","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Example script to extract a list of all reporting devices and their misconfigurations","type":"text"}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"$headers = @{\n \"x-api-key\" = \"{API KEY}\"\n \"Content-Type\" = \"application/json\"\n}\n$body = \"{}\"\n$outputData = @()\n\n$response = Invoke-RestMethod -Uri 'https://{BASE URL}/gytpolapi/v2.0/get_misconfigurations_start' -Method 'POST' -Headers $headers -Body $body\n\ndo {\n # Convert response to JSON and output\n $response | ConvertTo-Json -Depth 3\n\n # Accumulate data for each iteration\n $outputData += $response\n\n # Prepare next request body\n $body = @{ token = $response.token } | ConvertTo-Json\n \n [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12\n [System.Net.ServicePointManager]::ServerCertificateValidationCallback = {$true}\n \n # Make next request\n $response = Invoke-RestMethod -Uri 'https://{BASE URL}/gytpolapi/v2.0/get_misconfigurations_next' -Method 'POST' -Headers $headers -Body $body\n} until ($response.computers.Count -eq 0)\n\n# Export all the data to a JSON file\n$outputData | ConvertTo-Json | Set-Content -Path \"C:\\path\\to\\output_data.json\"","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"get_miscon_computers_start","type":"text"}]},{"type":"paragraph","content":[{"text":"Use this function to initiate a series of calls to get the list of computers that have misconfigurations. Computers will be returned in alphabetical order:","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Request Structure","type":"text"}]},{"type":"paragraph","content":[{"text":"Request body should contain json object of the following structure:","type":"text"}]},{"type":"paragraph"},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"652e1bc4-8450-4d21-bf51-33fad0546fbd"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"computer","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Computer name","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"domainName","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"For windows computers, Windows domain name","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"selTarget","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Narrows down returned computers to a specified type. One of following possible values can be passed: ","type":"text"}]},{"type":"paragraph","content":[{"text":"All Windows Computers","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows Endpoints","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows Servers","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows Non-VDI","type":"text"}]},{"type":"paragraph","content":[{"text":"Endpoints Windows VDI","type":"text"}]},{"type":"paragraph","content":[{"text":"Endpoints Windows DC Servers ","type":"text"}]},{"type":"paragraph","content":[{"text":"Windows Non-DC Servers","type":"text"}]},{"type":"paragraph","content":[{"text":"Debian Linux Computers","type":"text"}]},{"type":"paragraph","content":[{"text":"Red Hat Linux Computers","type":"text"}]},{"type":"paragraph","content":[{"text":"SUSE Linux Computers","type":"text"}]},{"type":"paragraph","content":[{"text":"Linux Unknown Computers","type":"text"}]},{"type":"paragraph","content":[{"text":"MAC Computers","type":"text"}]},{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"computerOu","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Return only computers that belong to the provided Organization Unit","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Json in the request body looks like in the following example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"fee09f0e-bd59-45f8-8bda-12a3fd67a7c2"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#DBE5F1","rowspan":1,"colwidth":[680.0]},"content":[{"type":"paragraph","content":[{"text":"{","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"computer\": \" Optional\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"domainName\": \" Optional\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"selTarget\": \" Optional\",","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"computerOu\": \" Optional","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"}","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Response Structure","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"314f3e31-abc5-4bcc-9f07-70e8e48fa9ba"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"token","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Encrypted string to use for following calls to the ","type":"text"},{"text":"get_misconfigurations_next","type":"text","marks":[{"type":"strong"}]},{"text":" function","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Request Example","type":"text"}]},{"type":"paragraph","content":[{"text":"curl --location --request POST \"","type":"text"},{"text":"{BASE-URL}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]},{"text":"/gytpolapi/v2.0/get_miscon_computers_start\" --header \"","type":"text"},{"text":"x-api-key: jyUbUQNuVjClzQ5f6sXgmcgGzyoFiaYXA+OvxObvLV8=","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]},{"text":"\" --data-raw \"{ \\\"computer\\\": null, \\\"domainName\\\": null, \\\"selTarget\\\": \\\"Windows Servers\\\"}\"","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Powershell:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"$headers = New-Object \"System.Collections.Generic.Dictionary[[String],[String]]\"\n\n$headers.Add(\"x-api-key\", \"{API KEY}\")\n\n$headers.Add(\"Content-Type\", \"application/json\")\n\n$body = \"{domainName: {DomainName}}\"\n\n$response = Invoke-RestMethod 'https://{BASE-URL}/gytpolapi/v2.0/get_miscon_computers_start' -Method 'POST' -Headers $headers -Body $body\n\n$response | ConvertTo-Json","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Note","type":"text","marks":[{"type":"strong"}]},{"text":": Change ","type":"text"},{"text":"BASE-URL","type":"text","marks":[{"type":"strong"}]},{"text":" to your base URL. Change ","type":"text"},{"text":"x-api-key","type":"text","marks":[{"type":"strong"}]},{"text":" to your API key.","type":"text"}]},{"type":"paragraph","content":[{"text":"For On-prem customers, please incorporate your port (i.e., 9191) into the BASE-URL as follows: ","type":"text"},{"text":"BASE-URL:PORT","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Response Example","type":"text"}]},{"type":"paragraph","content":[{"text":"{\"token\":\"7h5vmgiKQgvFiTb3xhrSyum52cbfh77xexcus8kGtOP03mliJxbJL99q8wfC2d8kwpNGXa0QF1VuycY6xnosSJePUkaGGUgCQ61rBmVcJI1J6RkUZMWmmGGD3R/+e9b2SrRlamRNusqUBOCphAeyDpBGb7uliNLpfn7wB2JiDGDJRu73Im6UIt3V7ITZDehfsb+JkWXVLlKNIv9+RvxrBCxVa/7StHvyW10cpGF67P9HfLZFbQOCjFsFOs8Mn6amZJrh1bkpasAblUWI0toXZVrlLHr6lfEYZMRnTadcBNTNIUBBWr6ptLUvdcWqEukmdaBublWIQBpAI++Seqc9rMF2WEex9o2n+5NyQBp8+OnuvsUcUybW/MfjG6J/06d07Tf/ks9mQJgZO2vnuJQAPA==\"}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"HTTP Return Codes","type":"text"}]},{"type":"paragraph","content":[{"text":"200 Ok","type":"text"}]},{"type":"paragraph","content":[{"text":"400 Bad Request","type":"text"}]},{"type":"paragraph","content":[{"text":"401 Unauthorized","type":"text"}]},{"type":"paragraph","content":[{"text":"429 Too Many Requests","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"get_miscon_computers_next","type":"text"}]},{"type":"paragraph","content":[{"text":"Use this function to continue getting results for the list of computers:","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"_Toc151990488"},"legacyAnchorId":{"value":"APIConnectionGuide-_Toc151990488"}},"macroMetadata":{"macroId":{"value":"380f8243-5e09-4162-a771-b81e95591a5d"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"03acce08-816c-4cd8-bbab-449760a2ab05"}},{"text":"Request Structure","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"06820085-3da7-434d-a354-450c8d9656f2"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"token","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Mandatory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Encrypted string to use for following calls to the ","type":"text"},{"text":"get_misconfigurations_next","type":"text","marks":[{"type":"strong"}]},{"text":" function","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Json in the request body looks like in the following example:","type":"text"}]},{"type":"paragraph"},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"8a363ab8-5d22-4b48-81a9-cd678c76a303"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#DBE5F1","rowspan":1,"colwidth":[680.0]},"content":[{"type":"paragraph","content":[{"text":"{","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"token\": \" Mandatory","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"}","type":"text","marks":[{"type":"strong"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"_Toc151990489"},"legacyAnchorId":{"value":"APIConnectionGuide-_Toc151990489"}},"macroMetadata":{"macroId":{"value":"fa51496f-6252-4b87-90a2-0f48b18a76a9"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"ba84b42a-3ce0-40c3-9832-920ae9c038b8"}},{"text":"Response Structure","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"54cd9304-8f4a-450d-be6c-9c4e6a6209ae"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"computers","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"object array","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Keep calling to get_miscon_computers_next until empty computers array is returned, e.g. computers[]","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"latestHostReportingDt","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,136.0]},"content":[{"type":"paragraph","content":[{"text":"datetime","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,140.0]},"content":[{"type":"paragraph","content":[{"text":"Latest date and time the computer reported to Gytpol","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"latestScanDt","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,136.0]},"content":[{"type":"paragraph","content":[{"text":"datetime","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,140.0]},"content":[{"type":"paragraph","content":[{"text":"Gytpol sensor scans computers for misconfigurations and sends the report to Gytpol backend. This is the date and time of the latest misconfiguration scan reported for this computer.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"computer","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,140.0]},"content":[{"type":"paragraph","content":[{"text":"Computer name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"computerOu","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,140.0]},"content":[{"type":"paragraph","content":[{"text":"Name of organizational unit define on this computer","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"domainName","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,140.0]},"content":[{"type":"paragraph","content":[{"text":"For windows computers, Windows domain name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"clientVer","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,140.0]},"content":[{"type":"paragraph","content":[{"text":"Gytpol sensor version currently installed on this computer","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"ipAddress","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,140.0]},"content":[{"type":"paragraph","content":[{"text":"Computer’s IP address","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"os","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,140.0]},"content":[{"type":"paragraph","content":[{"text":"Computer’s operating system","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"isVdi","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,136.0]},"content":[{"type":"paragraph","content":[{"text":"bool","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,140.0]},"content":[{"type":"paragraph","content":[{"text":"Is this computer a VDI","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"isServer","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,136.0]},"content":[{"type":"paragraph","content":[{"text":"bool","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,140.0]},"content":[{"type":"paragraph","content":[{"text":"Is this computer a server","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"isDC","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,136.0]},"content":[{"type":"paragraph","content":[{"text":"bool","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,140.0]},"content":[{"type":"paragraph","content":[{"text":"Is this computer a domain controller","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"token","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[136.0,136.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":3,"rowspan":1,"colwidth":[136.0,140.0,140.0]},"content":[{"type":"paragraph","content":[{"text":"Encrypted string to use for following calls to the ","type":"text"},{"text":"get_misconfigurations_next","type":"text","marks":[{"type":"strong"}]},{"text":" function","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Request Example","type":"text"}]},{"type":"paragraph","content":[{"text":"curl --location --request POST \"","type":"text"},{"text":"{BASE-URL}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]},{"text":"/gytpolapi/v2.0/get_miscon_computers_next\" --header \"","type":"text"},{"text":"x-api-key: jyUbUQNuVjClzQ5f6sXgmcgGzyoFiaYXA+OvxObvLV8=","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]},{"text":"\" --data-raw \"{ \\\"token\\\": \\\"7h5vmgiKQgvFiTb3xhrSyum52cbfh77xexcus8kGtOP03mliJxbJL99q8wfC2d8kwpNGXa0QF1VuycY6xnosSJePUkaGGUgCQ61rBmVcJI1J6RkUZMWmmGGD3R/+e9b2SrRlamRNusqUBOCphAeyDpBGb7uliNLpfn7wB2JiDGDJRu73Im6UIt3V7ITZDehfsb+JkWXVLlKNIv9+RvxrBCxVa/7StHvyW10cpGF67P9HfLZFbQOCjFsFOs8Mn6amZJrh1bkpasAblUWI0toXZVrlLHr6lfEYZMRnTadcBNTNIUBBWr6ptLUvdcWqEukmdaBublWIQBpAI++Seqc9rMF2WEex9o2n+5NyQBp8+OnuvsUcUybW/MfjG6J/06d07Tf/ks9mQJgZO2vnuJQAPA==\\\"}\"","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Powershell:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"$headers = New-Object \"System.Collections.Generic.Dictionary[[String],[String]]\"\n\n$headers.Add(\"x-api-key\", \"{API KEY}\")\n\n$headers.Add(\"Content-Type\", \"application/json\")\n\n$body = \"{token: {TOKEN}}\"\n\n$response = Invoke-RestMethod 'https://{BASE-URL}/gytpolapi/v2.0/get_miscon_computers_start' -Method 'POST' -Headers $headers -Body $body\n\n$response | ConvertTo-Json","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Note","type":"text","marks":[{"type":"strong"}]},{"text":": Change ","type":"text"},{"text":"BASE-URL","type":"text","marks":[{"type":"strong"}]},{"text":" to your base URL. Change ","type":"text"},{"text":"x-api-key","type":"text","marks":[{"type":"strong"}]},{"text":" to your API key.","type":"text"}]},{"type":"paragraph","content":[{"text":"For On-prem customers, please incorporate your port (i.e., 9191) into the BASE-URL as follows: ","type":"text"},{"text":"BASE-URL:PORT","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"HTTP Return Codes","type":"text"}]},{"type":"paragraph","content":[{"text":"200 Ok","type":"text"}]},{"type":"paragraph","content":[{"text":"400 Bad Request","type":"text"}]},{"type":"paragraph","content":[{"text":"401 Unauthorized","type":"text"}]},{"type":"paragraph","content":[{"text":"429 Too Many Requests","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"add_to_group","type":"text"}]},{"type":"paragraph","content":[{"text":"Use this function to add a computer to a computer group.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note 1: Ensure that the computer group is created in the UI with at least one device included before running the command.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Note 2: The device name should be added exactly as it appears in the UI, without the FQDN, and the device must have reported to the GYTPOL console previously. Devices that have never reported cannot be added.","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Request Structure","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"11852e53-2139-4bf0-b43e-400471462e87"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"groupName","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Mandatory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Group name","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"computerName","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Mandatory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Computer name, case-insensitive","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Json in the request body looks like in the following example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"b51bd829-1dce-4064-8443-bdb062633376"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#DBE5F1","rowspan":1,"colwidth":[680.0]},"content":[{"type":"paragraph","content":[{"text":"{","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"groupName\": “Exchange Servers”","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" \"computerName\": “WIN-A951IBBEJC2”","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"}","type":"text","marks":[{"type":"strong"}]}]}]}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"9a9ec406-54cf-4d4d-a1c5-0f2188d7cdc9"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"error","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Error string, returned only on error","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Request Example","type":"text"}]},{"type":"paragraph","content":[{"text":"curl --location --request POST \"","type":"text"},{"text":"{BASE-URL}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]},{"text":"/gytpolapi/v2.0/add_to_group\" --header \"","type":"text"},{"text":"x-api-key: jyUbUQNuVjClzQ5f6sXgmcgGzyoFiaYXA+OvxObvLV8=","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]},{"text":"\" --data-raw \"{\\\"groupName\\\":\\\"Exchange Servers\\\",\\\"computerName\\\":\\\"WIN-A951IBBEJC2\\\"}\"","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Powershell:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"$headers = New-Object \"System.Collections.Generic.Dictionary[[String],[String]]\"\n$headers.Add(\"x-api-key\", \"{x-api-key}\")\n$headers.Add(\"Content-Type\", \"application/json\")\n\n$body = \"{‘groupName’: ‘{GROUP}’, computerName: ‘{COMPUTER}’}\"\n\n[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12\n[System.Net.ServicePointManager]::ServerCertificateValidationCallback = {$true}\n\n$response = Invoke-RestMethod -uri \"https://{BASE-URL}/gytpolapi/v2.0/add_to_group\" -Method 'POST' -Headers $headers -Body $body\n$response | ConvertTo-Json","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"If you wish to use CSV for faster load of devices, please create a ","type":"text"},{"text":"CSV file","type":"text","marks":[{"type":"underline"}]},{"text":" in the below format:","type":"text"}]},{"type":"codeBlock","content":[{"text":"Computername,\nws0021,\nws0042,\nws0336,\nws0338","type":"text"}]},{"type":"paragraph","content":[{"text":"Powershell example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"$headers = New-Object \"System.Collections.Generic.Dictionary[[String],[String]]\"\n$headers.Add(\"x-api-key\", \"{x-api-key}\")\n$headers.Add(\"Content-Type\", \"application/json\")\n\n# Ensure the computer group is created in the UI with at least one device\n# Replace {GROUP} with the actual group name, i.e SERVERS\n$groupName = \"{GROUP}\"\n\n# Read computer names from CSV file without headers\n$computers = Get-Content -Path \"c:\\path\\to\\computers.csv\" | Select-Object -Skip 1\n\n# Loop through each computer and add it to the group\nforeach ($line in $computers) {\n # Split the line by commas and take the first part as the computer name\n $computerName = $line.Split(',')[0].Trim()\n\n # Create the body for the API request\n $body = @{\n groupName = $groupName\n computerName = $computerName\n } | ConvertTo-Json\n \n # Send the API request\n [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12\n [System.Net.ServicePointManager]::ServerCertificateValidationCallback = {$true}\n \n $response = Invoke-RestMethod -Uri \"https://{BASE-URL}/gytpolapi/v2.0/add_to_group\" -Method 'POST' -Headers $headers -Body $body\n $response | ConvertTo-Json\n \n # Optional: Add a 2-second pause between each iteration. Remove the comment if needed.\n # Start-Sleep -Seconds 2\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Note","type":"text","marks":[{"type":"strong"}]},{"text":": Change ","type":"text"},{"text":"BASE-URL","type":"text","marks":[{"type":"strong"}]},{"text":" to your base URL. Change ","type":"text"},{"text":"x-api-key","type":"text","marks":[{"type":"strong"}]},{"text":" to your API key.","type":"text"}]},{"type":"paragraph","content":[{"text":"For On-prem customers, please incorporate your port (i.e., 9191) into the BASE-URL as follows: ","type":"text"},{"text":"BASE-URL:PORT","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"HTTP Return Codes","type":"text"}]},{"type":"paragraph","content":[{"text":"200 Ok","type":"text"}]},{"type":"paragraph","content":[{"text":"400 Bad Request","type":"text"}]},{"type":"paragraph","content":[{"text":"401 Unauthorized","type":"text"}]},{"type":"paragraph","content":[{"text":"429 Too Many Requests","type":"text"}]}],"version":1}