Skip to main content
Skip table of contents

GitHub

GitHub is a cloud-based platform that allows developers to store, track, and collaborate on software projects. GitHub is based on Git, an open-source version control tool that allows multiple people to make changes to source files at the same time.

Creating an API Token for GitHub

Before configuring the GitHub connector in Lucidum, you must first create an API Token. The Lucidum connector uses the API token to access the GitHub API.

For details, see https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic

  1. From GitHub, Go to Settings -> Developer Settings -> Personal access token.

  2. Generate a new token and then give the following read-only permissions:

    • read:packages

    • read:org

    • read:public_key

    • read:user

    • user:email

    • read:enterprise

  3. To use a personal access token with an organization that uses SAML single sign-on (SSO), you must first authorize the token. For details, https://docs.github.com/en/free-pro-team@latest/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on.

  4. To get the GitHub user email, the users must set their email addresses as “public”. In the user profile, select a primary email address to be “public”. If you do not set a public email address, then it will have a value of null.

Configuring the Connector for GitHub

To configure Lucidum to ingest data from GitHub:

  1. Log in to Lucidum.

  2. In the left pane, click Connector.

  3. In the Connector page, click Add Connector.

  4. Scroll until you find the Connector you want to configure. Click Connect. The Settings page appears.

  5. In the Settings page, enter the following:

  6. To test the configuration, click Test.

    • If the connector is configured correctly, Lucidum displays a list of services that are accessible with the connector.

    • If the connector is not configured correctly, Lucidum displays an error message.

API Documentation

https://docs.github.com/en/rest?apiVersion=2022-11-28

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.