GitHub - Create Issue creates an issue on GitHub for:
- Assets returned by the selected query or assets selected on the relevant asset page.
See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.
- Not all asset types are supported for all Enforcement Actions.
- See Actions supported for Activity Logs, Adapters Fetch History, and Asset Investigation modules.
- See Actions supported for Vulnerabilities.
- See Actions supported for Software.
Required Fields
These fields must be configured to run the Enforcement Set.
- Action name - The name of this Enforcement Action. The system sets a default name. You can change the name.
- Configure Dynamic Values - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.
-
Use stored credentials from the GitHub adapter - Select this option to use credentials from the adapter connection. By default, the first connection is selected.
- When you select this option, the Select Adapter Connection drop-down becomes available. Select the adapter connection to use for this Enforcement Action.
Note:To use this option, you must successfully configure a GitHub adapter connection. -
Organization - The GitHub organization name.
-
Repository - The GitHub repository name.
-
Issue Title - A title for the issue.
-
Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Connecting Additional Axonius Nodes.
The action opens a new issue on the relevant organization or repository on GitHub with the provided title and issue body (see Additional Fields) in the following format:
This issue was opened automatically via Axonius for the following {asset type}:
- {list of assets from the query - e.g. a list of CVEs}
{optional body text}
Additional Fields
These fields are optional.
Connection and Credentials
When Use stored credentials from the adapter is toggled off, some of the connection fields below are required to create the connection, while other fields are optional.
For a detailed explanation on GitHub connection parameters, refer to GitHub Parameters.
- Issue Body - Optional body text for the issue, for example, a justification for why it was opened.
- Gateway Name - Select the Gateway through which to connect to perform the action.
APIs
Axonius uses the GitHub API.
Required Permissions
The stored credentials, or those provided in Connection and Credentials, must have the following permission(s) to perform this Enforcement Action:
- 'Issues' repository permissions (read)
For more details about other Enforcement Actions available, see Action Library.