{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Iru Provider Configuration Guide","siteUrl":"https://docs.synqly.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"introduction","__idx":0},"children":["Introduction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide walks you through creating an Iru integration for use with Synqly's EDR Connector."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you begin, ensure that you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to the Iru web app for your organization"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Permissions to create and manage API tokens"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"required-user-permissions","__idx":2},"children":["Required User Permissions"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Permissions"},"children":["Permissions"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Devices -> Device list"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Querying endpoints"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Devices -> Device details"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieving endpoint details"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"creating-an-api-token","__idx":3},"children":["Creating an API Token"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in and click on your username (bottom left)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Access"]}," and then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API tokens"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Token"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}," for the API token."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Iru displays a modal with the API token. Click the visibility control to reveal it, or use ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Copy Token"]}," to copy it to your clipboard and store it in a safe place. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["You will not be able to see the token details again."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configure"]}," to set API permissions for this token now, or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Skip"]}," to change them later."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After you finish your changes, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After you create your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["first"]}," token, Iru shows your tenant-specific ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API URL"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"inspect-or-modify-a-token","__idx":4},"children":["Inspect or modify a token"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click on the token."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["View"]}," to see token details, including permissions. From there you can:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Permissions"]}," tab to edit permissions for the token."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Activity"]}," tab to see events such as: token created, token name changed, and token permissions edited."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configuring-the-integration","__idx":5},"children":["Configuring the Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To configure a new Iru integration, provide each of the values as defined below:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Integration Parameter"},"children":["Integration Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Secret"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The API token you created and copied in the previous steps"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Base URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your tenant-specific API URL from Iru (shown after you create your first token)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"additional-resources","__idx":6},"children":["Additional Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://support.kandji.io/kb/kandji-api#generate-an-api-token"},"children":["Generate an API Token"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://support.kandji.io/kb/kandji-api"},"children":["Iru API"]}]}]}]},"headings":[{"value":"Introduction","id":"introduction","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Required User Permissions","id":"required-user-permissions","depth":2},{"value":"Creating an API Token","id":"creating-an-api-token","depth":2},{"value":"Inspect or modify a token","id":"inspect-or-modify-a-token","depth":3},{"value":"Configuring the Integration","id":"configuring-the-integration","depth":2},{"value":"Additional Resources","id":"additional-resources","depth":2}],"frontmatter":{"slug":"guides/provider-configuration/iru-setup","seo":{"title":"Iru Provider Configuration Guide"}},"lastModified":"2026-04-09T22:41:52.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/provider-configuration/iru-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}