Live webinar ยท Sept 24, 2 PM EST: Build a single, live source of IT asset truth.

AssetSonar

Documentation

GitHub Integration: Track Software Licenses

AssetSonar directly integrates with GitHub to provide a streamlined way to track GitHub entitlements, ensure compliance, and optimize seat usage without any manual intervention. 

This integration is a stepping stone in AssetSonarโ€™s commitment to being the single source of truth for all software and hardware asset data. By importing GitHub data directly into AssetSonar, IT teams can eliminate the hassle of managing software licenses and gain a unified view of their license seats and entitlements.

Benefits of GitHub integration

 The following are a few key benefits of this integration: 

  • Automated license tracking: Importing GitHub data into AssetSonar allows you to track user licenses and entitlements automatically, eliminating the need for manual reconciliation. 
  • Cost control: With accurate, up-to-date data from GitHub, AssetSonar ensures you are optimally utilizing your license seats. This helps organizations stay compliant with licensing agreements and avoid unnecessary costs.
  • Simplified renewals: With GitHubโ€™s license data directly within AssetSonar, renewals become a breeze. You can set up alerts and notifications to renew your licenses on time. 

Now letโ€™s dig deeper into this integrationโ€™s functionality. 

Enabling GitHub integration

Go to Settings -> Integrations -> Cloud Software -> Direct SaaS integrations. There will be a โ€˜Connectโ€™ button under the GitHub Logo. Click it. 

A new overlay will open up where youโ€™ll be required to enter the GitHub Token and Organization. Here is a snapshot of the overlay: 

Youโ€™ll need to access your GitHub account to extract the Token details. Follow these steps to retrieve this information: 

  1. Log in to your GitHub account and click the profile picture in the top right corner. Now select โ€˜Settingsโ€™ from the dropdown menu as shown below: 
  1. A new page will open up. Scroll down and go to the Developer settings. 
  1. From the Developer settings panel, go to โ€˜Personalized access tokensโ€™ and click โ€˜Fine-grained tokensโ€™. 
  1. Now, click the โ€˜Generate new tokenโ€™ option and fill out the following mandatory fields: 
  • Token name
  • Resource owner: Select your organization
  • Repository access: Public repositories 
  • Permissions: Only select read-only access to Members and Plan
  1. Now, click the โ€˜Generate Tokenโ€™ button. 
  1. Once the Token is generated, make sure to copy it now, as you wonโ€™t be able to view it again. 

Now, paste this Token and your organizationโ€™s name into the AssetSonar GitHub overlay and hit โ€˜Addโ€™. 

Once you have successfully integrated your AssetSonar account with GitHub, youโ€™ll be redirected to an Imported Licenses overlay in the Software Licenses module. Choose the license you want to bring to AssetSonar and click โ€˜Nextโ€™. 

Now, enter the following details regarding your license: 

  • Total Cost Per Payment
  • Total Seats
  • Payment Frequency 
  • Start Date
  • End Date

Please note that you can also merge this imported license with an existing one in AssetSonar. 

Once you have added all the relevant information, click โ€˜Doneโ€™. 

Now youโ€™ll see an Import Licenses Summary so you can double-check the details you entered. 

Click โ€˜Doneโ€™ and your license import process will be completed successfully. 

Note: Only users whose primary email addresses are publicly available on GitHub will be retrieved.